CardiacSimulationArchiver< PROBLEM_CLASS > Class Template Reference

#include <CardiacSimulationArchiver.hpp>

List of all members.

Static Public Member Functions
static void	Save (PROBLEM_CLASS &rSimulationToArchive, const std::string &rDirectory, bool clearDirectory=true)
static PROBLEM_CLASS *	Load (const std::string &rDirectory)
static PROBLEM_CLASS *	Load (const FileFinder &rDirectory)
static PROBLEM_CLASS *	Migrate (const FileFinder &rDirectory)

---

Detailed Description

template<class PROBLEM_CLASS>
class CardiacSimulationArchiver< PROBLEM_CLASS >

CardiacSimulationArchiver is a helper class for checkpointing of cardiac simulations.

The class is templated over the class defining the simulation (e.g. MonodomainProblem). It would be more natural to template over dimensions as for other classes, and just deal with pointers to AbstractCardiacProblem. However, this breaks archive backwards compatibility...

Definition at line 66 of file CardiacSimulationArchiver.hpp.

---

Member Function Documentation

template<class PROBLEM_CLASS>

void CardiacSimulationArchiver< PROBLEM_CLASS >::Save	(	PROBLEM_CLASS &	rSimulationToArchive,
		const std::string &	rDirectory,
		bool	clearDirectory = true
	)			[inline, static]

Archives a simulation in the directory specified.

Note:

Must be called collectively, i.e. by all processes.

Parameters:

	rSimulationToArchive	object defining the simulation to archive
	rDirectory	directory where the multiple files defining the checkpoint will be stored (relative to CHASTE_TEST_OUTPUT)
	clearDirectory	whether the directory needs to be cleared or not.

Todo:

#1026 get a real version number!

Definition at line 45 of file CardiacSimulationArchiver.cpp.

References PetscTools::AmMaster(), PetscTools::Barrier(), RelativeTo::ChasteTestOutput, EXCEPTION, ArchiveOpener< Archive, Stream >::GetCommonArchive(), PetscTools::GetNumProcs(), OutputFileHandler::GetOutputDirectoryFullPath(), and PetscTools::ReplicateBool().

Referenced by CardiacSimulation::CreateAndRun().

template<class PROBLEM_CLASS>

PROBLEM_CLASS * CardiacSimulationArchiver< PROBLEM_CLASS >::Load

(

const std::string &

rDirectory

)

[inline, static]

Unarchives a simulation from the directory specified.

Does a migrate if necessary (this is actually just a wrapper around the Migrate method now).

Note:

Must be called collectively, i.e. by all processes.

Parameters:

rDirectory

directory where the multiple files defining the checkpoint are located (relative to CHASTE_TEST_OUTPUT)

Definition at line 93 of file CardiacSimulationArchiver.cpp.

References RelativeTo::ChasteTestOutput, and CardiacSimulationArchiver< PROBLEM_CLASS >::Migrate().

template<class PROBLEM_CLASS>

PROBLEM_CLASS * CardiacSimulationArchiver< PROBLEM_CLASS >::Load

(

const FileFinder &

rDirectory

)

[inline, static]

Unarchives a simulation from the directory specified.

Does a migrate if necessary (this is actually just a wrapper around the Migrate method now).

Note:

Must be called collectively, i.e. by all processes.

Parameters:

rDirectory

directory where the multiple files defining the checkpoint are located

Definition at line 100 of file CardiacSimulationArchiver.cpp.

References CardiacSimulationArchiver< PROBLEM_CLASS >::Migrate().

template<class PROBLEM_CLASS>

PROBLEM_CLASS * CardiacSimulationArchiver< PROBLEM_CLASS >::Migrate

(

const FileFinder &

rDirectory

)

[inline, static]

Load a simulation, saved by any number of processes, into the correct number of processes for those currently launched.

Note:

Must be called collectively, i.e. by all processes.

Uses the DistributedVectorFactory saved in the process 0 archive to work out how many secondary archive files to read, and loads the cells and boundary conditions from these too.

Uses a dumb partition to work out how to distribute the mesh and cells over the processes. If we are loading on the same number of processes as the simulation was saved on, it uses exactly the same distribution as before.

Parameters:

rDirectory

directory where the multiple files defining the checkpoint are located

Definition at line 107 of file CardiacSimulationArchiver.cpp.

References EXCEPTION, FileFinder::Exists(), FileFinder::GetAbsolutePath(), ArchiveOpener< Archive, Stream >::GetCommonArchive(), PetscTools::GetMyRank(), DistributedVectorFactory::GetNumProcs(), PetscTools::GetNumProcs(), DistributedVectorFactory::GetOriginalFactory(), ArchiveLocationInfo::GetProcessUniqueFilePath(), FileFinder::IsDir(), and DistributedVectorFactory::SetCheckNumberOfProcessesOnLoad().

Referenced by CardiacSimulationArchiver< PROBLEM_CLASS >::Load().

---

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

• heart/src/problem/CardiacSimulationArchiver.hpp
• heart/src/problem/CardiacSimulationArchiver.cpp