#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(), PottsMesh< SPACE_DIM >::load(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), VertexMesh< DIM, DIM >::load(), HeartConfig::LoadFromCheckpoint(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::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(), AbstractCardiacTissue< SPACE_DIM >::save(), ExtendedBidomainProblem< DIM >::save(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), PottsMesh< SPACE_DIM >::save(), AbstractCardiacProblem< DIM, DIM, 1 >::save(), and VertexMesh< DIM, DIM >::save().

bool ArchiveLocationInfo::GetIsDirRelativeToChasteTestOutput ( )

static

Returns: true if 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(), PottsMesh< SPACE_DIM >::load(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), VertexMesh< DIM, DIM >::load(), AbstractCardiacTissue< SPACE_DIM >::save(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), PottsMesh< SPACE_DIM >::save(), and VertexMesh< DIM, 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(), OutputFileHandler::SetArchiveDirectory(), 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< ELEMENT_DIM, SIM, SPACE_DIM >::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< ELEMENT_DIM, SIM, SPACE_DIM >::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().