Generated CLib API for Cantera's Domain1D class. More...

Collaboration diagram for ctdomain Library:

Detailed Description

Generated CLib API for Cantera's Domain1D class.

Warning: This library is an experimental part of the Cantera API and may be changed or removed without notice.

Functions
int32_t	domain_newFlow1D (const char domainType, int32_t solution, const char id)
	Create a Flow1D object of the specified type.

int32_t	domain_newBoundary1D (const char domainType, int32_t solution, const char id)
	Create a Boundary1D object of the specified type.

int32_t	domain_type (int32_t handle, int32_t bufLen, char *buf)
	String indicating the domain implemented.

int32_t	domain_index (int32_t handle, int32_t n, int32_t j)
	Returns the index of the solution vector, which corresponds to component n at grid point j.

int32_t	domain_nComponents (int32_t handle)
	Number of components at each grid point.

int32_t	domain_nPoints (int32_t handle)
	Number of grid points in this domain.

int32_t	domain_componentName (int32_t handle, int32_t n, int32_t bufLen, char *buf)
	Name of component.

int32_t	domain_componentIndex (int32_t handle, const char *name)
	index of component with name

int32_t	domain_setBounds (int32_t handle, int32_t n, double lower, double upper)
	Set the upper and lower bounds for a solution component, n.

double	domain_lowerBound (int32_t handle, int32_t n)
	Lower bound on the nth component.

double	domain_upperBound (int32_t handle, int32_t n)
	Upper bound on the nth component.

int32_t	domain_setSteadyTolerances (int32_t handle, double rtol, double atol, int32_t n)
	Set tolerances for steady-state mode.

int32_t	domain_setTransientTolerances (int32_t handle, double rtol, double atol, int32_t n)
	Set tolerances for time-stepping mode.

double	domain_rtol (int32_t handle, int32_t n)
	Relative tolerance of the nth component.

double	domain_atol (int32_t handle, int32_t n)
	Absolute tolerance of the nth component.

int32_t	domain_setupGrid (int32_t handle, int32_t gridLen, const double *grid)
	Set up initial grid.

int32_t	domain_setupUniformGrid (int32_t handle, int32_t points, double length, double start)
	Set up uniform grid.

int32_t	domain_setID (int32_t handle, const char *s)
	Specify an identifying tag for this domain.

int32_t	domain_grid (int32_t handle, int32_t bufLen, double *buf)
	Access the array of grid coordinates [m].

int32_t	bdry_setMdot (int32_t handle, double mdot)
	Set the total mass flow rate [kg/m²/s].

int32_t	bdry_setTemperature (int32_t handle, double t)
	Set the temperature.

int32_t	bdry_setSpreadRate (int32_t handle, double V0)
	Set tangential velocity gradient [1/s] at this boundary.

int32_t	bdry_setMoleFractions (int32_t handle, const char *xin)
	Set the mole fractions by specifying a string.

double	bdry_mdot (int32_t handle)
	The total mass flow rate [kg/m2/s].

double	bdry_temperature (int32_t handle)
	Temperature [K].

double	bdry_spreadRate (int32_t handle)
	Tangential velocity gradient [1/s] at this boundary.

double	bdry_massFraction (int32_t handle, int32_t k)
	Mass fraction of species k.

int32_t	domain_setTransport (int32_t handle, int32_t trans)
	Set transport model to existing instance.

int32_t	flow_enableSoret (int32_t handle, int32_t withSoret)
	Enable thermal diffusion, also known as Soret diffusion.

int32_t	flow_setPressure (int32_t handle, double p)
	Set the pressure.

double	flow_pressure (int32_t handle)
	The current pressure [Pa].

int32_t	flow_setFixedTempProfile (int32_t handle, int32_t zfixedLen, double zfixed, int32_t tfixedLen, double tfixed)
	Sometimes it is desired to carry out the simulation using a specified temperature profile, rather than computing it by solving the energy equation.

int32_t	flow_solveEnergyEqn (int32_t handle, int32_t j)
	Specify that the energy equation should be solved at point.

int32_t	reactingsurf_enableCoverageEquations (int32_t handle, int32_t docov)
	Set whether to solve the equations for the surface species coverages.

int32_t	domain_del (int32_t handle)
	Delete Domain1D object.

int32_t	domain_cabinetSize ()
	Return size of Domain1D storage.

int32_t	domain_parentHandle (int32_t handle)
	Return handle to parent of Domain1D object.

Function Documentation

◆ domain_newFlow1D()

int32_t domain_newFlow1D	(	const char *	domainType,
		int32_t	solution,
		const char *	id
	)

Create a Flow1D object of the specified type.

Wraps C++ constructor: shared_ptr<Flow1D> newFlow1D(const string&, shared_ptr<Solution>, const string&)

Parameters

domainType	string identifying domain type.
solution	Integer handle to Solution object. Solution holding ThermoPhase, Kinetics and Transport objects.
id	string identifier describing domain. If omitted, id defaults to the domain type identifier.

Returns: Handle to stored Flow1D object or -1 for exception handling.

Definition at line 53 of file ctdomain.cpp.

◆ domain_newBoundary1D()

int32_t domain_newBoundary1D	(	const char *	domainType,
		int32_t	solution,
		const char *	id
	)

Create a Boundary1D object of the specified type.

Wraps C++ constructor: shared_ptr<Boundary1D> newBoundary1D(const string&, shared_ptr<Solution>, const string&)

Parameters

domainType	string identifying domain type.
solution	Integer handle to Solution object. Solution holding ThermoPhase, Kinetics and Transport objects.
id	string identifier describing domain. If omitted, id defaults to the domain type identifier.

Returns: Handle to stored Boundary1D object or -1 for exception handling.

Definition at line 63 of file ctdomain.cpp.

◆ domain_type()

int32_t domain_type	(	int32_t	handle,
		int32_t	bufLen,
		char *	buf
	)

String indicating the domain implemented.

Wraps C++ getter: string Domain1D::type()

Parameters

	handle	Handle to queried Domain1D object.
[in]	bufLen	Length of reserved array.
[out]	buf	Returned string value.

Returns: Actual length of string including string-terminating null byte, \0, or -1 for exception handling.

Definition at line 73 of file ctdomain.cpp.

◆ domain_index()

int32_t domain_index	(	int32_t	handle,
		int32_t	n,
		int32_t	j
	)

Returns the index of the solution vector, which corresponds to component n at grid point j.

Wraps C++ method: size_t Domain1D::index(size_t, size_t)

Parameters

handle	Handle to queried Domain1D object.
n	component index
j	grid point index

Definition at line 85 of file ctdomain.cpp.

◆ domain_nComponents()

int32_t domain_nComponents ( int32_t handle )

Number of components at each grid point.

Wraps C++ getter: size_t Domain1D::nComponents()

Parameters

handle Handle to queried Domain1D object.

Definition at line 95 of file ctdomain.cpp.

◆ domain_nPoints()

int32_t domain_nPoints ( int32_t handle )

Number of grid points in this domain.

Wraps C++ getter: size_t Domain1D::nPoints()

Parameters

handle Handle to queried Domain1D object.

Definition at line 105 of file ctdomain.cpp.

◆ domain_componentName()

int32_t domain_componentName	(	int32_t	handle,
		int32_t	n,
		int32_t	bufLen,
		char *	buf
	)

Name of component.

Wraps C++ method: virtual string Domain1D::componentName(size_t)

Parameters

	handle	Handle to queried Domain1D object.
	n	Undocumented.
[in]	bufLen	Length of reserved array.
[out]	buf	Returned string value.

Returns: Actual length of string including string-terminating null byte, \0, or -1 for exception handling.

Definition at line 115 of file ctdomain.cpp.

◆ domain_componentIndex()

int32_t domain_componentIndex	(	int32_t	handle,
		const char *	name
	)

index of component with name

Wraps C++ method: virtual size_t Domain1D::componentIndex(const string&)

Parameters

handle	Handle to queried Domain1D object.
name	Undocumented.

Definition at line 127 of file ctdomain.cpp.

◆ domain_setBounds()

int32_t domain_setBounds	(	int32_t	handle,
		int32_t	n,
		double	lower,
		double	upper
	)

Set the upper and lower bounds for a solution component, n.

Wraps C++ method: void Domain1D::setBounds(size_t, double, double)

Parameters

handle	Handle to queried Domain1D object.
n	solution component index
lower	lower bound on component n
upper	upper bound on component n

Definition at line 137 of file ctdomain.cpp.

◆ domain_lowerBound()

double domain_lowerBound	(	int32_t	handle,
		int32_t	n
	)

Lower bound on the nth component.

Wraps C++ method: double Domain1D::lowerBound(size_t)

Parameters

handle	Handle to queried Domain1D object.
n	Undocumented.

Definition at line 148 of file ctdomain.cpp.

◆ domain_upperBound()

double domain_upperBound	(	int32_t	handle,
		int32_t	n
	)

Upper bound on the nth component.

Wraps C++ method: double Domain1D::upperBound(size_t)

Parameters

handle	Handle to queried Domain1D object.
n	Undocumented.

Definition at line 158 of file ctdomain.cpp.

◆ domain_setSteadyTolerances()

int32_t domain_setSteadyTolerances	(	int32_t	handle,
		double	rtol,
		double	atol,
		int32_t	n
	)

Set tolerances for steady-state mode.

Wraps C++ method: void Domain1D::setSteadyTolerances(double, double, size_t)

Parameters

handle	Handle to queried Domain1D object.
rtol	Relative tolerance
atol	Absolute tolerance
n	component index these tolerances apply to. If set to -1 (the default), these tolerances will be applied to all solution components.

Definition at line 168 of file ctdomain.cpp.

◆ domain_setTransientTolerances()

int32_t domain_setTransientTolerances	(	int32_t	handle,
		double	rtol,
		double	atol,
		int32_t	n
	)

Set tolerances for time-stepping mode.

Wraps C++ method: void Domain1D::setTransientTolerances(double, double, size_t)

Parameters

handle	Handle to queried Domain1D object.
rtol	Relative tolerance
atol	Absolute tolerance
n	component index these tolerances apply to. If set to -1 (the default), these tolerances will be applied to all solution components.

Definition at line 179 of file ctdomain.cpp.

◆ domain_rtol()

double domain_rtol	(	int32_t	handle,
		int32_t	n
	)

Relative tolerance of the nth component.

Wraps C++ method: double Domain1D::rtol(size_t)

Parameters

handle	Handle to queried Domain1D object.
n	Undocumented.

Definition at line 190 of file ctdomain.cpp.

◆ domain_atol()

double domain_atol	(	int32_t	handle,
		int32_t	n
	)

Absolute tolerance of the nth component.

Wraps C++ method: double Domain1D::atol(size_t)

Parameters

handle	Handle to queried Domain1D object.
n	Undocumented.

Definition at line 200 of file ctdomain.cpp.

◆ domain_setupGrid()

int32_t domain_setupGrid	(	int32_t	handle,
		int32_t	gridLen,
		const double *	grid
	)

Set up initial grid.

Wraps C++ setter: void Domain1D::setupGrid(const vector<double>&)

Parameters

	handle	Handle to queried Domain1D object.
[in]	gridLen	Length of vector reserved for grid.
	grid	Undocumented.

Definition at line 210 of file ctdomain.cpp.

◆ domain_setupUniformGrid()

int32_t domain_setupUniformGrid	(	int32_t	handle,
		int32_t	points,
		double	length,
		double	start
	)

Set up uniform grid.

Wraps C++ method: void Domain1D::setupUniformGrid(size_t, double, double)

Parameters

handle	Handle to queried Domain1D object.
points	Number of grid points
length	Length of domain
start	Start position of domain (default=0.)

Definition at line 222 of file ctdomain.cpp.

◆ domain_setID()

int32_t domain_setID	(	int32_t	handle,
		const char *	s
	)

Specify an identifying tag for this domain.

Wraps C++ setter: void Domain1D::setID(const string&)

Parameters

handle	Handle to queried Domain1D object.
s	Undocumented.

Definition at line 233 of file ctdomain.cpp.

◆ domain_grid()

int32_t domain_grid	(	int32_t	handle,
		int32_t	bufLen,
		double *	buf
	)

Access the array of grid coordinates [m].

Wraps C++ getter: vector<double>& Domain1D::grid()

Parameters

	handle	Handle to queried Domain1D object.
[in]	bufLen	Length of reserved array.
[out]	buf	Returned array value.

Returns: Actual length of value array or -1 for exception handling.

Definition at line 244 of file ctdomain.cpp.

◆ bdry_setMdot()

int32_t bdry_setMdot	(	int32_t	handle,
		double	mdot
	)

Set the total mass flow rate [kg/m²/s].

Wraps C++ setter: virtual void Boundary1D::setMdot(double)

Parameters

handle	Handle to queried Boundary1D object.
mdot	Undocumented.

Definition at line 258 of file ctdomain.cpp.

◆ bdry_setTemperature()

int32_t bdry_setTemperature	(	int32_t	handle,
		double	t
	)

Set the temperature.

Wraps C++ setter: virtual void Boundary1D::setTemperature(double)

Parameters

handle	Handle to queried Boundary1D object.
t	Undocumented.

Definition at line 269 of file ctdomain.cpp.

◆ bdry_setSpreadRate()

int32_t bdry_setSpreadRate	(	int32_t	handle,
		double	V0
	)

Set tangential velocity gradient [1/s] at this boundary.

Wraps C++ setter: virtual void Boundary1D::setSpreadRate(double)

Parameters

handle	Handle to queried Boundary1D object.
V0	Undocumented.

Definition at line 280 of file ctdomain.cpp.

◆ bdry_setMoleFractions()

int32_t bdry_setMoleFractions	(	int32_t	handle,
		const char *	xin
	)

Set the mole fractions by specifying a string.

Wraps C++ setter: virtual void Boundary1D::setMoleFractions(const string&)

Parameters

handle	Handle to queried Boundary1D object.
xin	Undocumented.

Definition at line 291 of file ctdomain.cpp.

◆ bdry_mdot()

double bdry_mdot ( int32_t handle )

The total mass flow rate [kg/m2/s].

Wraps C++ getter: virtual double Boundary1D::mdot()

Parameters

handle Handle to queried Boundary1D object.

Definition at line 302 of file ctdomain.cpp.

◆ bdry_temperature()

double bdry_temperature ( int32_t handle )

Temperature [K].

Wraps C++ getter: virtual double Boundary1D::temperature()

Parameters

handle Handle to queried Boundary1D object.

Definition at line 312 of file ctdomain.cpp.

◆ bdry_spreadRate()

double bdry_spreadRate ( int32_t handle )

Tangential velocity gradient [1/s] at this boundary.

Wraps C++ getter: virtual double Boundary1D::spreadRate()

Parameters

handle Handle to queried Boundary1D object.

Definition at line 322 of file ctdomain.cpp.

◆ bdry_massFraction()

double bdry_massFraction	(	int32_t	handle,
		int32_t	k
	)

Mass fraction of species k.

Wraps C++ method: virtual double Boundary1D::massFraction(size_t)

Parameters

handle	Handle to queried Boundary1D object.
k	Undocumented.

Definition at line 332 of file ctdomain.cpp.

◆ domain_setTransport()

int32_t domain_setTransport	(	int32_t	handle,
		int32_t	trans
	)

Set transport model to existing instance.

Wraps C++ setter: virtual void Domain1D::setTransport(shared_ptr<Transport>)

Parameters

handle	Handle to queried Domain1D object.
trans	Integer handle to Transport object. Undocumented.

Definition at line 342 of file ctdomain.cpp.

◆ flow_enableSoret()

int32_t flow_enableSoret	(	int32_t	handle,
		int32_t	withSoret
	)

Enable thermal diffusion, also known as Soret diffusion.

Wraps C++ setter: void Flow1D::enableSoret(bool)

Parameters

handle	Handle to queried Flow1D object.
withSoret	Undocumented.

Definition at line 353 of file ctdomain.cpp.

◆ flow_setPressure()

int32_t flow_setPressure	(	int32_t	handle,
		double	p
	)

Set the pressure.

Wraps C++ setter: void Flow1D::setPressure(double)

Parameters

handle	Handle to queried Flow1D object.
p	Undocumented.

Definition at line 365 of file ctdomain.cpp.

◆ flow_pressure()

double flow_pressure ( int32_t handle )

The current pressure [Pa].

Wraps C++ getter: double Flow1D::pressure()

Parameters

handle Handle to queried Flow1D object.

Definition at line 376 of file ctdomain.cpp.

◆ flow_setFixedTempProfile()

int32_t flow_setFixedTempProfile	(	int32_t	handle,
		int32_t	zfixedLen,
		double *	zfixed,
		int32_t	tfixedLen,
		double *	tfixed
	)

Sometimes it is desired to carry out the simulation using a specified temperature profile, rather than computing it by solving the energy equation.

Wraps C++ method: void Flow1D::setFixedTempProfile(vector<double>&, vector<double>&)

Parameters

	handle	Handle to queried Flow1D object.
[in]	zfixedLen	Length of vector reserved for zfixed.
	zfixed	Undocumented.
[in]	tfixedLen	Length of vector reserved for tfixed.
	tfixed	Undocumented.

Definition at line 386 of file ctdomain.cpp.

◆ flow_solveEnergyEqn()

int32_t flow_solveEnergyEqn	(	int32_t	handle,
		int32_t	j
	)

Specify that the energy equation should be solved at point.

Wraps C++ setter: void Flow1D::solveEnergyEqn(size_t)

Parameters

handle	Handle to queried Flow1D object.
j	Point at which to enable the energy equation.

Definition at line 399 of file ctdomain.cpp.

◆ reactingsurf_enableCoverageEquations()

int32_t reactingsurf_enableCoverageEquations	(	int32_t	handle,
		int32_t	docov
	)

Set whether to solve the equations for the surface species coverages.

Wraps C++ setter: void ReactingSurf1D::enableCoverageEquations(bool)

Parameters

handle	Handle to queried ReactingSurf1D object.
docov	Undocumented.

Definition at line 410 of file ctdomain.cpp.

◆ domain_del()

int32_t domain_del ( int32_t handle )

Delete Domain1D object.

Wraps C++ destructor: undefined

Parameters

handle Handle to Domain1D object.

Returns: Zero for success and -1 for exception handling.

Definition at line 422 of file ctdomain.cpp.

◆ domain_cabinetSize()

int32_t domain_cabinetSize ( )

Return size of Domain1D storage.

Wraps C++ reserved CLib function: custom code

Returns: Size or -1 for exception handling.

Definition at line 433 of file ctdomain.cpp.

◆ domain_parentHandle()

int32_t domain_parentHandle ( int32_t handle )

Return handle to parent of Domain1D object.

Wraps C++ reserved CLib function: custom code

Parameters

handle Handle to queried Domain1D object.

Returns: Parent handle or -1 for exception handling.

Definition at line 445 of file ctdomain.cpp.

Detailed Description

Functions

Function Documentation

◆ domain_newFlow1D()

◆ domain_newBoundary1D()

◆ domain_type()

◆ domain_index()

◆ domain_nComponents()

◆ domain_nPoints()

◆ domain_componentName()

◆ domain_componentIndex()

◆ domain_setBounds()

◆ domain_lowerBound()

◆ domain_upperBound()

◆ domain_setSteadyTolerances()

◆ domain_setTransientTolerances()

◆ domain_rtol()

◆ domain_atol()

◆ domain_setupGrid()

◆ domain_setupUniformGrid()

◆ domain_setID()

◆ domain_grid()

◆ bdry_setMdot()

◆ bdry_setTemperature()

◆ bdry_setSpreadRate()

◆ bdry_setMoleFractions()

◆ bdry_mdot()

◆ bdry_temperature()

◆ bdry_spreadRate()

◆ bdry_massFraction()

◆ domain_setTransport()

◆ flow_enableSoret()

◆ flow_setPressure()

◆ flow_pressure()

◆ flow_setFixedTempProfile()

◆ flow_solveEnergyEqn()

◆ reactingsurf_enableCoverageEquations()

◆ domain_del()

◆ domain_cabinetSize()

◆ domain_parentHandle()