ArchiveLocationInfo Class Reference

#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 50 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 76 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(), HeartConfig::load(), ExtendedBidomainProblem< DIM >::load(), AbstractCardiacProblem< ELEMENT_DIM, ELEMENT_DIM, 1 >::load(), PottsMesh< SPACE_DIM >::load(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), ExtendedBidomainProblem< DIM >::save(), AbstractCardiacProblem< ELEMENT_DIM, ELEMENT_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 103 of file ArchiveLocationInfo.cpp.

References OutputFileHandler::GetChasteTestOutputDirectory(), and mDirAbsPath.

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

bool ArchiveLocationInfo::GetIsDirRelativeToChasteTestOutput ( ) [static]

Get whether the directory provided is relative to CHASTE_TEST_OUTPUT.

Definition at line 119 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 67 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(), PottsMesh< SPACE_DIM >::load(), VertexMesh< DIM, DIM >::save(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), AbstractCardiacTissue< 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 85 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 94 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 62 of file ArchiveLocationInfo.cpp.

References mMeshFilename.

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

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 45 of file ArchiveLocationInfo.cpp.

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