Gyoto::Metric Namespace Reference

Access to metrics. More...

Classes

class  ChernSimons
class  KerrBL
 Metric around a Kerr black-hole in Boyer-Lindquist coordinates. More...
class  KerrKS
 Metric around a Kerr black-hole in Kerr-Schild coordinates Warning: this metric is seldom used and may be buggy. More...
class  Generic
 Base class for metrics. More...
class  Minkowski
 The Minkowski flat-space metric. More...
class  NumericalMetricLorene
class  RezzollaZhidenko
class  RotStar3_1
 Numerical metric around a rotating star in 3+1 formalism. More...
class  Python
 Metric coded in Python. More...

Typedefs

typedef SmartPointer
< Metric::Generic
Subcontractor_t (FactoryMessenger *, std::vector< std::string > const &)
 A function to build instances of a specific Metric::Generic sub-class.

Functions

template<typename T >
SmartPointer< Metric::GenericSubcontractor (FactoryMessenger *fmp, std::vector< std::string > const &plugins)
 Subcontractor template.
Gyoto::Metric::Subcontractor_tgetSubcontractor (std::string name, std::vector< std::string > &plugin, int errmode=0)
 Query the Metric register.
void Register (std::string kind, Gyoto::Metric::Subcontractor_t *scp)
 Make a Metric kind known to the Factory.
void initRegister ()
 Empty the Metric register.

Variables

Register::EntryRegister_
 The Metric register.

Detailed Description

Access to metrics.

Objects which describe space-time geometry must inherit from the Gyoto::Metric::Generic class.

To be usable, a Metric::Generic sub-class should register a Metric::Subcontractor_t function using the Metric::Register() function. See also Writing plug-ins for Gyoto .


Typedef Documentation

typedef SmartPointer<Metric::Generic> Gyoto::Metric::Subcontractor_t(FactoryMessenger *, std::vector< std::string > const &)

A function to build instances of a specific Metric::Generic sub-class.

This is a more specific version of the SmartPointee::Subcontractor_t type. A Metric::Subcontrator_t is called by the Gyoto::Factory to build an instance of the kind of metric specified in an XML file (see Register()). The Factory and Subcontractor_t function communicate through a Gyoto::FactoryMessenger.


Function Documentation

Gyoto::Metric::Subcontractor_t* Gyoto::Metric::getSubcontractor ( std::string  name,
std::vector< std::string > &  plugin,
int  errmode = 0 
)

Query the Metric register.

Query the Metric register to get the Metric::Subcontractor_t correspondig to a given kind name. This function is normally called only from the Factory. If plugin is specified, only a subcontractor matching both name and plugin will be returned, loading the plug-in if necessary. If plugin is the empty string, then the first subcontractor matching name will be returned, and the name of the plug-in it belongs to will be returned in plugin upon output.

Parameters:
[in] name e.g. "KerrBL"
inout] plugin e.g. "stdplug".
[in] errmode int=0. If errmode==0, failure to find a registered Metric by that name is an error. Else, simply return NULL pointer in that case.
Returns:
pointer to the corresponding subcontractor.
void Gyoto::Metric::initRegister (  ) 

Empty the Metric register.

This must be called once. It is called by Gyoto::Register::init().

void Gyoto::Metric::Register ( std::string  kind,
Gyoto::Metric::Subcontractor_t scp 
)

Make a Metric kind known to the Factory.

Register a new Metric::Generic sub-class so that the Gyoto::Factory knows it.

Parameters:
kind The kind name which identifies this object type in an XML file, as in <Metric kind="name">
scp A pointer to the subcontractor, which will communicate with the Gyoto::Factory to build an instance of the class from its XML description
template<typename T >
SmartPointer<Metric::Generic> Gyoto::Metric::Subcontractor ( FactoryMessenger *  fmp,
std::vector< std::string > const &  plugins 
) [inline]

Subcontractor template.

Instead of reimplementing the wheel, your subcontractor can simply be Gyoto::Metric::Subcontractor<MyKind>

Template Parameters:
T Sub-class of Metric::Generic

Variable Documentation

The Metric register.

Use the Metric::initRegister() once in your program to initiliaze it, the Metric::Register() function to fill it, and the Metric::getSubcontractor() function to query it.


Generated on 22 Jul 2017 for Gyoto by  doxygen 1.6.1