#include <ArchiveLocationInfo.hpp>

Collaboration diagram for ArchiveLocationInfo:

Static Public Member Functions
static void	SetMeshPathname (const FileFinder &rDirectory, const std::string &rFilename)
static void	SetMeshPathname (const std::string &rDirectory, const std::string &rFilename)
static void	SetMeshFilename (const std::string &rFilename)
static std::string	GetMeshFilename ()
static std::string	GetArchiveDirectory ()
static std::string	GetProcessUniqueFilePath (const std::string &rFileName, unsigned procId=PetscTools::GetMyRank())
static void	SetArchiveDirectory (const FileFinder &rDirectory)
static std::string	GetArchiveRelativePath ()
static bool	GetIsDirRelativeToChasteTestOutput ()
Static Private Attributes
static std::string	mDirAbsPath = ""
static std::string	mMeshFilename = "mesh"

Detailed Description

Mini-class to help with 'archiving' various classes that don't write their data directly to the archive file. They thus need to know information about where the archive is being written to, in order to write their own files into the same folder. The main methods are GetArchiveDirectory and SetArchiveDirectory.

This functionality is used by the meshes, LinearSystem and HeartConfig.

For the benefit of the meshes (and the cell_based code), there are also shortcut methods SetMeshPathname and GetMeshFilename, allowing you to specify the base file name for the mesh. This is needed because the cell_based code adds timestamp information to the file name.

Definition at line 57 of file ArchiveLocationInfo.hpp.

Member Function Documentation

std::string ArchiveLocationInfo::GetArchiveDirectory ( ) [static]

Get the directory that archives are being written to. Will always end in a '/'.

Returns:: full path to directory

Definition at line 83 of file ArchiveLocationInfo.cpp.

References EXCEPTION, and mDirAbsPath.

Referenced by AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::AbstractCardiacTissue(), ArchiveOpener< Archive, Stream >::ArchiveOpener(), GetProcessUniqueFilePath(), VertexMesh< DIM, DIM >::load(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), ExtendedBidomainProblem< DIM >::load(), AbstractCardiacProblem< DIM, DIM, 1 >::load(), SemMesh< SPACE_DIM >::load(), PottsMesh< SPACE_DIM >::load(), HeartConfig::LoadFromCheckpoint(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), ExtendedBidomainProblem< DIM >::save(), AbstractCardiacProblem< DIM, DIM, 1 >::save(), and HeartConfig::Write().

std::string ArchiveLocationInfo::GetArchiveRelativePath ( ) [static]

Get the directory to which the archives are being written. Remove CHASTE_TEST_OUTPUT prefix (assuming it exists); if it doesn't, returns the absolute path. Will always end in a '/'.

Returns:: relative path to directory

Definition at line 110 of file ArchiveLocationInfo.cpp.

References OutputFileHandler::GetChasteTestOutputDirectory(), and mDirAbsPath.

Referenced by ArchiveOpener< Archive, Stream >::ArchiveOpener(), ExtendedBidomainProblem< DIM >::load(), AbstractCardiacProblem< DIM, DIM, 1 >::load(), VertexMesh< DIM, DIM >::save(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), AbstractCardiacTissue< SPACE_DIM >::save(), ExtendedBidomainProblem< DIM >::save(), AbstractCardiacProblem< DIM, DIM, 1 >::save(), SemMesh< SPACE_DIM >::save(), and PottsMesh< SPACE_DIM >::save().

bool ArchiveLocationInfo::GetIsDirRelativeToChasteTestOutput ( ) [static]

Get whether the directory provided is relative to CHASTE_TEST_OUTPUT.

Definition at line 126 of file ArchiveLocationInfo.cpp.

References OutputFileHandler::GetChasteTestOutputDirectory(), and mDirAbsPath.

Referenced by ArchiveOpener< Archive, Stream >::ArchiveOpener().

std::string ArchiveLocationInfo::GetMeshFilename ( ) [static]

Get the filename that the mesh should be written to

Returns:: mesh filename

Definition at line 74 of file ArchiveLocationInfo.cpp.

References EXCEPTION, and mMeshFilename.

Referenced by AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::AbstractCardiacTissue(), VertexMesh< DIM, DIM >::load(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), SemMesh< SPACE_DIM >::load(), PottsMesh< SPACE_DIM >::load(), VertexMesh< DIM, DIM >::save(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), AbstractCardiacTissue< SPACE_DIM >::save(), SemMesh< SPACE_DIM >::save(), and PottsMesh< SPACE_DIM >::save().

std::string ArchiveLocationInfo::GetProcessUniqueFilePath	(	const std::string &	rFileName,
		unsigned	procId = `PetscTools::GetMyRank()`
	)		`[static]`

Get the full path to an output file which has a name unique to the current process. Useful for ensuring that each process writes to / reads from a separate file when running in parallel.

The path will have the form "path_to_output_dir/rFileName.process_rank"

Parameters:

rFileName	the base file name
procId	the process id number (defaults to current process)

Returns:: a full path to the file for this process

Definition at line 92 of file ArchiveLocationInfo.cpp.

References GetArchiveDirectory().

Referenced by ArchiveOpener< Archive, Stream >::ArchiveOpener(), and CardiacSimulationArchiver< PROBLEM_CLASS >::Migrate().

void ArchiveLocationInfo::SetArchiveDirectory ( const FileFinder & rDirectory ) [static]

Set the directory that archives are being written to.

Parameters:

rDirectory the directory in question.

Definition at line 101 of file ArchiveLocationInfo.cpp.

References FileFinder::GetAbsolutePath(), and mDirAbsPath.

Referenced by ArchiveOpener< Archive, Stream >::ArchiveOpener(), and SetMeshPathname().

void ArchiveLocationInfo::SetMeshFilename ( const std::string & rFilename ) [static]

Set the filename for mesh files.

Parameters:

rFilename the base name (minus extension) for the mesh files, used to put on a timestamp.

Definition at line 69 of file ArchiveLocationInfo.cpp.

References mMeshFilename.

Referenced by CellBasedSimulationArchiver< DIM, SIM >::Save().

void ArchiveLocationInfo::SetMeshPathname	(	const FileFinder &	rDirectory,
		const std::string &	rFilename
	)		`[static]`

Set the location to write mesh files.

Parameters:

rDirectory	the directory to write to.
rFilename	the base name (minus extension) for the mesh files.

Definition at line 46 of file ArchiveLocationInfo.cpp.

References mMeshFilename, and SetArchiveDirectory().

Referenced by CellBasedSimulationArchiver< DIM, SIM >::Load().

void ArchiveLocationInfo::SetMeshPathname	(	const std::string &	rDirectory,
		const std::string &	rFilename
	)		`[static]`

Set the location to write mesh files.

Parameters:

rDirectory	the directory to write to (if relative, assumes relative to CHASTE_TEST_OUTPUT).
rFilename	the base name (minus extension) for the mesh files.

Definition at line 52 of file ArchiveLocationInfo.cpp.

References RelativeTo::Absolute, RelativeTo::ChasteTestOutput, FileFinder::IsAbsolutePath(), mMeshFilename, and SetArchiveDirectory().

Member Data Documentation

std::string ArchiveLocationInfo::mDirAbsPath = "" [static, private]

Absolute path for directory that archives are being written to.

Definition at line 62 of file ArchiveLocationInfo.hpp.

Referenced by GetArchiveDirectory(), GetArchiveRelativePath(), GetIsDirRelativeToChasteTestOutput(), and SetArchiveDirectory().

std::string ArchiveLocationInfo::mMeshFilename = "mesh" [static, private]

Mesh filename (relative to mDirAbsPath).

Definition at line 65 of file ArchiveLocationInfo.hpp.

Referenced by GetMeshFilename(), SetMeshFilename(), and SetMeshPathname().

The documentation for this class was generated from the following files:

global/src/checkpointing/ArchiveLocationInfo.hpp
global/src/checkpointing/ArchiveLocationInfo.cpp

Static Public Member Functions

Static Private Attributes

Detailed Description

Member Function Documentation

Member Data Documentation