nidas  v1.2-1520
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Private Attributes | List of all members
nidas::core::VariableConverter Class Referenceabstract

#include <VariableConverter.h>

Inheritance diagram for nidas::core::VariableConverter:
Inheritance graph
[legend]

Public Member Functions

 VariableConverter ()
 
 VariableConverter (const VariableConverter &x)
 Copy constructor. More...
 
VariableConverteroperator= (const VariableConverter &x)
 Assignment. More...
 
virtual ~VariableConverter ()
 
virtual VariableConverterclone () const =0
 
virtual void readCalFile (dsm_time_t) throw ()
 Before a VariableConverter can be used for a conversion, the converter's CalFile, if it exists, needs to be advanced to the right record for the current sample time. More...
 
void setCalFileHandler (CalFileHandler *)
 Set the instance of CalFileHandler which will be called and given first option to handle new CalFile records. More...
 
virtual double convert (dsm_time_t, double v)=0
 
void setUnits (const std::string &val)
 
virtual const std::string & getUnits () const
 
void setVariable (const Variable *val)
 
const VariablegetVariable () const
 
virtual void reset ()=0
 Reset the converter to invalid or default settings, such as after an error occurs parsing a CalFile. More...
 
const DSMSensorgetDSMSensor () const
 
const DSMConfiggetDSMConfig () const
 
virtual std::string toString () const =0
 Generate a string description of this VariableConverter. More...
 
virtual void fromString (const std::string &) throw (nidas::util::InvalidParameterException)
 
void addParameter (Parameter *val)
 Add a parameter to this VariableConverter. More...
 
const std::list< const
Parameter * > & 
getParameters () const
 Get list of parameters. More...
 
const ParametergetParameter (const std::string &name) const
 Fetch a parameter by name. More...
 
void fromDOMElement (const xercesc::DOMElement *) throw (nidas::util::InvalidParameterException)
 Initialize myself from a xercesc::DOMElement. More...
 
void setCalFile (CalFile *)
 
CalFilegetCalFile ()
 
const CalFilegetCalFile () const
 
virtual xercesc::DOMElement * toDOMParent (xercesc::DOMElement *parent, bool complete) const throw (xercesc::DOMException)
 Create a DOMElement and append it to the parent. More...
 
virtual xercesc::DOMElement * toDOMElement (xercesc::DOMElement *node, bool complete) const throw (xercesc::DOMException)
 Add my content into a DOMElement. More...
 

Static Public Member Functions

static VariableConvertercreateVariableConverter (XDOMElement &child)
 
static VariableConvertercreateFromString (const std::string &) throw (nidas::util::InvalidParameterException)
 
static const XMLCh * getNamespaceURI ()
 

Protected Member Functions

virtual void parseFields (CalFile *cf)=0
 Parse the fields in the current CalFile record for the particular settings and coefficients needed by this converter. More...
 
void abortCalFile (const std::string &what)
 

Protected Attributes

CalFile_calFile
 
CalFileHandler_handler
 

Private Attributes

std::string _units
 
std::map< std::string,
Parameter * > 
_parameters
 Map of parameters by name. More...
 
std::list< const Parameter * > _constParameters
 List of const pointers to Parameters for providing via getParameters(). More...
 
const Variable_variable
 

Constructor & Destructor Documentation

VariableConverter::VariableConverter ( )
VariableConverter::VariableConverter ( const VariableConverter x)
VariableConverter::~VariableConverter ( )
virtual

References _calFile, and _constParameters.

Member Function Documentation

void VariableConverter::abortCalFile ( const std::string &  what)
protected
void VariableConverter::addParameter ( Parameter val)

Add a parameter to this VariableConverter.

VariableConverter will then own the pointer and will delete it in its destructor. If a Parameter exists with the same name, it will be replaced with the new Parameter.

References _constParameters, _parameters, and nidas::core::Parameter::getName().

Referenced by operator=(), and VariableConverter().

virtual VariableConverter* nidas::core::VariableConverter::clone ( ) const
pure virtual
virtual double nidas::core::VariableConverter::convert ( dsm_time_t  ,
double  v 
)
pure virtual
VariableConverter * VariableConverter::createFromString ( const std::string &  str)
throw (nidas::util::InvalidParameterException
)
static

References fromString().

VariableConverter * VariableConverter::createVariableConverter ( XDOMElement child)
static
void VariableConverter::fromDOMElement ( const xercesc::DOMElement *  )
throw (nidas::util::InvalidParameterException
)
virtual
virtual void nidas::core::VariableConverter::fromString ( const std::string &  )
throw (nidas::util::InvalidParameterException
)
inlinevirtual
CalFile* nidas::core::VariableConverter::getCalFile ( )
inline
const CalFile* nidas::core::VariableConverter::getCalFile ( ) const
inline

References _calFile.

const DSMConfig * VariableConverter::getDSMConfig ( ) const
const DSMSensor * VariableConverter::getDSMSensor ( ) const
static const XMLCh* nidas::core::DOMable::getNamespaceURI ( )
inlinestaticinherited
const Parameter * VariableConverter::getParameter ( const std::string &  name) const

Fetch a parameter by name.

Returns a NULL pointer if no such parameter exists.

References _parameters.

const std::list<const Parameter*>& nidas::core::VariableConverter::getParameters ( ) const
inline

Get list of parameters.

References _constParameters.

Referenced by operator=(), and VariableConverter().

virtual const std::string& nidas::core::VariableConverter::getUnits ( ) const
inlinevirtual
const Variable* nidas::core::VariableConverter::getVariable ( ) const
inline

References _variable.

Referenced by getDSMSensor().

VariableConverter & VariableConverter::operator= ( const VariableConverter x)
virtual void nidas::core::VariableConverter::parseFields ( CalFile cf)
protectedpure virtual

Parse the fields in the current CalFile record for the particular settings and coefficients needed by this converter.

Implemented in nidas::core::Polynomial, nidas::core::Linear, and nidas::dynld::isff::CS_Krypton.

void VariableConverter::readCalFile ( dsm_time_t  t)
throw (
)
virtual

Before a VariableConverter can be used for a conversion, the converter's CalFile, if it exists, needs to be advanced to the right record for the current sample time.

As records are read, this method calls parseFields() so the VariableConverter subclass can extract the particular information it needs from the CalFile fields, typically coefficients.

For sensors which need to extend the kind of conversions which can be specified by a CalFile, there is a callback function available. See setCalFileHandler().

References DLOG, nidas::util::UTime::format(), and nidas::util::Exception::what().

Referenced by nidas::core::Linear::convert(), nidas::core::Polynomial::convert(), nidas::dynld::isff::NCAR_TRH::convertVariable(), and nidas::dynld::raf::SyncRecordSource::preLoadCalibrations().

virtual void nidas::core::VariableConverter::reset ( )
pure virtual

Reset the converter to invalid or default settings, such as after an error occurs parsing a CalFile.

Implemented in nidas::core::Polynomial, nidas::core::Linear, and nidas::dynld::isff::CS_Krypton.

Referenced by abortCalFile().

void VariableConverter::setCalFile ( CalFile val)
void VariableConverter::setCalFileHandler ( CalFileHandler cfh)

Set the instance of CalFileHandler which will be called and given first option to handle new CalFile records.

Pass null to disable the callbacks.

References _handler.

Referenced by nidas::dynld::isff::NCAR_TRH::validate().

void nidas::core::VariableConverter::setUnits ( const std::string &  val)
inline
void nidas::core::VariableConverter::setVariable ( const Variable val)
inline
xercesc::DOMElement * DOMable::toDOMElement ( xercesc::DOMElement *  node,
bool  complete 
) const
throw (xercesc::DOMException
)
virtualinherited
xercesc::DOMElement * DOMable::toDOMParent ( xercesc::DOMElement *  parent,
bool  complete 
) const
throw (xercesc::DOMException
)
virtualinherited
virtual std::string nidas::core::VariableConverter::toString ( ) const
pure virtual

Generate a string description of this VariableConverter.

May be used in meta-data, for example Netcdf comment.

Implemented in nidas::core::Polynomial, nidas::core::Linear, and nidas::dynld::isff::CS_Krypton.

Member Data Documentation

CalFile* nidas::core::VariableConverter::_calFile
protected
std::list<const Parameter*> nidas::core::VariableConverter::_constParameters
private

List of const pointers to Parameters for providing via getParameters().

Referenced by addParameter(), getParameters(), and ~VariableConverter().

CalFileHandler* nidas::core::VariableConverter::_handler
protected
std::map<std::string,Parameter*> nidas::core::VariableConverter::_parameters
private

Map of parameters by name.

Referenced by addParameter(), and getParameter().

std::string nidas::core::VariableConverter::_units
private

Referenced by getUnits(), operator=(), and setUnits().

const Variable* nidas::core::VariableConverter::_variable
private

Referenced by getVariable(), operator=(), and setVariable().


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