CellMLToSharedLibraryConverter Class Reference

#include <CellMLToSharedLibraryConverter.hpp>

Collaboration diagram for CellMLToSharedLibraryConverter:

Public Member Functions
	CellMLToSharedLibraryConverter (bool preserveGeneratedSources=false, std::string component="heart")
DynamicCellModelLoader *	Convert (const FileFinder &rFilePath, bool isCollective=true)
void	CreateOptionsFile (const OutputFileHandler &rHandler, const std::string &rModelName, const std::vector< std::string > &rArgs, const std::string &rExtraXml="")
Private Member Functions
void	ConvertCellmlToSo (const std::string &rCellmlFullPath, const std::string &rCellmlFolder, const std::string &rModelLeafName)
Private Attributes
bool	mPreserveGeneratedSources
std::string	mComponentName

Detailed Description

This class encapsulates all the complexity needed to generate a loadable module from a CellML file.

Definition at line 43 of file CellMLToSharedLibraryConverter.hpp.

Constructor & Destructor Documentation

CellMLToSharedLibraryConverter::CellMLToSharedLibraryConverter	(	bool	preserveGeneratedSources = `false`,
		std::string	component = `"heart"`
	)

Create a converter.

Parameters:

	preserveGeneratedSources	whether to save copies of generated C++ source files in the directory containing the .cellml file.
	component	the name of the Chaste component (or project) in which to build the loadable module (if required). Allows projects to have specialised base classes for dynamically loaded cell models.

Definition at line 44 of file CellMLToSharedLibraryConverter.cpp.

Member Function Documentation

DynamicCellModelLoader * CellMLToSharedLibraryConverter::Convert	(	const FileFinder &	rFilePath,
		bool	isCollective = `true`
	)

Get a loadable module from the given file, and return a loader for it. The file can be a .so, in which case there isn't much to do, just create the loader. The interesting case comes when it is a .cellml file. If the file has any other extension, an exception is thrown.

Parameters:

	rFilePath	the model to load
	isCollective	whether this method is being called collectively. If it is not, then we require the .so to already exist, rather than trying to avoid race conditions.

Note:: If you do not pass isCollective=false, must be called collectively.

Definition at line 51 of file CellMLToSharedLibraryConverter.cpp.

References RelativeTo::Absolute, ConvertCellmlToSo(), EXCEPTION, FileFinder::Exists(), FileFinder::GetAbsolutePath(), DynamicModelLoaderRegistry::GetLoader(), DynamicModelLoaderRegistry::Instance(), and FileFinder::IsNewerThan().

void CellMLToSharedLibraryConverter::ConvertCellmlToSo	(	const std::string &	rCellmlFullPath,
		const std::string &	rCellmlFolder,
		const std::string &	rModelLeafName
	)			`[private]`

Helper method performing the actual conversion of a .cellml file to a .so.

Note:: Must be called collectively.

Parameters:

	rCellmlFullPath	full path to the .cellml file
	rCellmlFolder	folder containing the CellML file, with trailing slash
	rModelLeafName	leaf name of the CellML file, minus extension (but including the .)

Definition at line 102 of file CellMLToSharedLibraryConverter.cpp.

References RelativeTo::Absolute, PetscTools::AmMaster(), ChasteBuildDirName(), ChasteBuildRootDir(), ChasteBuildType(), RelativeTo::ChasteSourceRoot, EXCEPT_IF_NOT, EXCEPTION, EXPECT0, FileFinder::GetAbsolutePath(), Exception::GetMessage(), IGNORE_RET, FileFinder::IsDir(), mComponentName, mPreserveGeneratedSources, and PetscTools::ReplicateException().

Referenced by Convert().

void CellMLToSharedLibraryConverter::CreateOptionsFile	(	const OutputFileHandler &	rHandler,
		const std::string &	rModelName,
		const std::vector< std::string > &	rArgs,
		const std::string &	rExtraXml = `""`
	)

Create a PyCml options file for the given model.

Parameters:

	rHandler	where to create the file
	rModelName	base name of the model file (which will be "rModelName.cellml")
	rArgs	extra command-line arguments for the model conversion
	rExtraXml	any extra XML to go in the config file (e.g. LT settings)