ctml.h File Reference

CTML ("Cantera Markup Language") is the variant of XML that Cantera uses to store data. More...

#include "ct_defs.h"
#include "xml.h"
#include "Array.h"

Include dependency graph for ctml.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces
	ctml
	The ctml namespace adds functionality to the XML object, by providing standard functions that read, write, and interpret XML files and object trees.

Functions
void	addInteger (Cantera::XML_Node &node, const std::string &titleString, const int value, const std::string &unitsString="", const std::string &typeString="")
	This function adds a child node with the name, "integer", with a value consisting of a single integer. More...
void	addFloat (Cantera::XML_Node &node, const std::string &titleString, const doublereal value, const std::string &unitsString="", const std::string &typeString="", const doublereal minval=Cantera::Undef, const doublereal maxval=Cantera::Undef)
	This function adds a child node with the name, "float", with a value consisting of a single floating point number. More...
void	addFloatArray (Cantera::XML_Node &node, const std::string &titleString, const size_t n, const doublereal *const values, const std::string &unitsString="", const std::string &typeString="", const doublereal minval=Cantera::Undef, const doublereal maxval=Cantera::Undef)
	This function adds a child node with the name, "floatArray", with a value consisting of a comma separated list of floats. More...
void	addNamedFloatArray (Cantera::XML_Node &parentNode, const std::string &name, const int n, const doublereal *const vals, const std::string units="", const std::string type="", const doublereal minval=Cantera::Undef, const doublereal maxval=Cantera::Undef)
	This function adds a child node with the name given by the first parameter with a value consisting of a comma separated list of floats. More...
void	addString (Cantera::XML_Node &node, const std::string &titleString, const std::string &valueString, const std::string &typeString="")
	This function adds a child node with the name string with a string value to the current node. More...
size_t	getFloatArray (const Cantera::XML_Node &node, std::vector< doublereal > &v, const bool convert=true, const std::string &unitsString="", const std::string &nodeName="floatArray")
	This function reads the current node or a child node of the current node with the default name, "floatArray", with a value field consisting of a comma separated list of floats. More...
void	getStringArray (const Cantera::XML_Node &node, std::vector< std::string > &v)
	This function interprets the value portion of an XML element as a string. More...
void	getMap (const Cantera::XML_Node &node, std::map< std::string, std::string > &m)
	This routine is used to interpret the value portions of XML elements that contain colon separated pairs. More...
int	getPairs (const Cantera::XML_Node &node, std::vector< std::string > &key, std::vector< std::string > &val)
	This function interprets the value portion of an XML element as a series of "Pairs" separated by white space. More...
void	getMatrixValues (const Cantera::XML_Node &node, const std::vector< std::string > &keyStringRow, const std::vector< std::string > &keyStringCol, Cantera::Array2D &returnValues, const bool convert=true, const bool matrixSymmetric=false)
	This function interprets the value portion of an XML element as a series of "Matrix ids and entries" separated by white space. More...
void	getIntegers (const Cantera::XML_Node &node, std::map< std::string, int > &v)
	Get a vector of integer values from a child element. More...
doublereal	getFloat (const Cantera::XML_Node &parent, const std::string &name, const std::string &type="")
	Get a floating-point value from a child element. More...
doublereal	getFloatCurrent (const Cantera::XML_Node &currXML, const std::string &type="")
	Get a floating-point value from the current XML element. More...
bool	getOptionalFloat (const Cantera::XML_Node &parent, const std::string &name, doublereal &fltRtn, const std::string &type="")
	Get an optional floating-point value from a child element. More...
void	getFloats (const Cantera::XML_Node &node, std::map< std::string, double > &v, const bool convert=true)
	Get a vector of floating-point values from a child element. More...
int	getInteger (const Cantera::XML_Node &parent, const std::string &name)
	Get an integer value from a child element. More...
doublereal	getFloatDefaultUnits (const Cantera::XML_Node &parent, const std::string &name, const std::string &defaultUnits, const std::string &type="toSI")
	Get a floating-point value from a child element with a defined units field. More...
bool	getOptionalModel (const Cantera::XML_Node &parent, const std::string &nodeName, std::string &modelName)
	Get an optional model name from a named child node. More...
XML_Node *	getByTitle (const Cantera::XML_Node &node, const std::string &title)
	Search the child nodes of the current node for an XML Node with a Title attribute of a given name. More...
void	getString (const Cantera::XML_Node &node, const std::string &titleString, std::string &valueString, std::string &typeString)
	This function reads a child node with the name string with a specific title attribute named titleString. More...
void	getNamedStringValue (const Cantera::XML_Node &node, const std::string &nameString, std::string &valueString, std::string &typeString)
	This function attempts to read a named child node and returns with the contents in the value string. More...
std::string	getChildValue (const Cantera::XML_Node &parent, const std::string &nameString)
	This function reads a child node with the name, nameString, and returns its xml value as the return string. More...
void	get_CTML_Tree (Cantera::XML_Node *node, const std::string &file, const int debug=0)
	Read an ctml file from a file and fill up an XML tree. More...
Cantera::XML_Node	getCtmlTree (const std::string &file)
	Read an ctml file from a file and fill up an XML tree. More...
void	ct2ctml (const char *file, const int debug=0)
	Convert a cti file into a ctml file. More...
void	ck2cti (const std::string &in_file, const std::string &thermo_file="", const std::string &transport_file="", const std::string &id_tag="gas")
	Convert a Chemkin-format mechanism into a CTI file. More...

Variables
const std::string	CTML_Version = "1.4.1"
	const Specifying the CTML version number More...

Detailed Description

CTML ("Cantera Markup Language") is the variant of XML that Cantera uses to store data.

These functions read and write it. (see Input File Handling and importCTML, ck2ctml)

Definition in file ctml.h.