Class describing a group of variables that are sampled and handled together. More...

#include <SampleTag.h>

Inheritance diagram for nidas::core::SampleTag:

Public Member Functions
	SampleTag ()
	Constructor. More...

	SampleTag (const DSMSensor *sensor)
	Constructor of a sample for a given sensor. More...

	SampleTag (const SampleTag &)
	Copy constructor. More...

virtual	~SampleTag ()

SampleTag &	operator= (const SampleTag &rhs)

void	setSampleId (unsigned int val)
	Set the sample portion of the shortId. More...

unsigned int	getSampleId () const
	Get the sample portion of the shortId. More...

void	setSensorId (unsigned int val)
	Set the sensor portion of the shortId. More...

unsigned int	getSensorId () const
	Get the sensor portion of the shortId. More...

void	setDSMId (unsigned int val)
	Set the DSM portion of the id. More...

unsigned int	getDSMId () const
	Get the DSM portion of the id. More...

dsm_sample_id_t	getId () const
	Get the 26 bit id, containing the DSM id and the sensor+sample id. More...

unsigned int	getSpSId () const
	Get the sensor+sample portion of the id. More...

const std::string &	getSuffix () const
	Suffix, which is appended to variable names. More...

void	setSuffix (const std::string &val)

const DSMConfig *	getDSMConfig () const

void	setDSMConfig (const DSMConfig *val)

const DSMSensor *	getDSMSensor () const

void	setDSMSensor (const DSMSensor *val)

int	getStation () const
	Station number, which is also known as the Site number. More...

void	setStation (int val)

const Site *	getSite () const
	Get the Site of this SampleTag, which will be non-NULL only if getDSMConfig() returns non-NULL. More...

virtual void	setRate (double val) throw (nidas::util::InvalidParameterException)
	Set sampling rate in samples/sec. More...

virtual double	getRate () const
	Get sampling rate in samples/sec. More...

virtual void	setPeriod (double val) throw (nidas::util::InvalidParameterException)
	Set sampling period (1/rate) in sec. More...

virtual double	getPeriod () const
	Get sampling period (1/rate) in sec. More...

void	setProcessed (bool val) throw (nidas::util::InvalidParameterException)
	Set if this sample is going to be post processed. More...

bool	isProcessed () const
	Test to see if this sample is to be post processed. More...

void	setScanfFormat (const std::string &val)

const std::string &	getScanfFormat () const

void	setPromptString (const std::string &val)

const std::string &	getPromptString () const

void	setPromptOffset (double val)

double	getPromptOffset () const

virtual void	addVariable (Variable *var) throw (nidas::util::InvalidParameterException)
	Add a variable to this SampleTag. More...

const std::vector< const Variable * > &	getVariables () const

const std::vector< Variable * > &	getVariables ()

void	removeVariable (const Variable *var)

Variable &	getVariable (int i)
	Provide a reference to a variable - allowing one to modify it. More...

void	addParameter (Parameter *val)
	Add a parameter to this SampleTag. More...

const std::list< const Parameter * > &	getParameters () const

const Parameter *	getParameter (const std::string &name) const

void	setEnabled (bool val)

bool	isEnabled () const

unsigned int	getDataIndex (const Variable *var) const
	What is the index of a Variable into the data of a sample from this SampleTag. More...

float	getTimetagAdjust () const
	Whether to enable TimetagAdjuster for this sample. More...

void	setTimetagAdjust (float val)

VariableIterator	getVariableIterator () const

void	fromDOMElement (const xercesc::DOMElement *) throw (nidas::util::InvalidParameterException)
	Initialize myself from a xercesc::DOMElement. More...

xercesc::DOMElement *	toDOMParent (xercesc::DOMElement *parent, bool complete) const throw (xercesc::DOMException)
	Create a DOMElement and append it to the parent. More...

xercesc::DOMElement *	toDOMElement (xercesc::DOMElement *node, bool complete) const throw (xercesc::DOMException)
	Add my content into a DOMElement. More...

Static Public Member Functions
static const XMLCh *	getNamespaceURI ()

Protected Member Functions
void	setId (dsm_sample_id_t val)
	Set the full id. More...

void	setSpSId (unsigned int val)
	Set the sensor + sample portions of the id. More...

Private Attributes
dsm_sample_id_t	_id

unsigned int	_sampleId

unsigned int	_sensorId

std::string	_suffix

int	_station

double	_rate

bool	_processed

const DSMConfig *	_dsm

const DSMSensor *	_sensor

std::vector< const Variable * >	_constVariables

std::vector< Variable * >	_variables

std::vector< std::string >	_variableNames

std::string	_scanfFormat

std::string	_promptString

double	_promptOffset

std::list< Parameter * >	_parameters
	List of pointers to Parameters. More...

std::list< const Parameter * >	_constParameters
	List of const pointers to Parameters for providing via getParameters(). More...

bool	_enabled

float	_ttAdjustVal
	If positive, enable TimetagAdjustor for these samples. More...

Detailed Description

Class describing a group of variables that are sampled and handled together.

A SampleTag has an integer ID. This is the same ID that is associated with Sample objects, allowing software to map between a data sample and the meta-data associated with it.

A SampleTag/Sample ID is a 32-bit value comprised of four parts: 6-bit type_id, 10-bit DSM_id, 16-bit sensor+sample id.

The type id specifies the data type (float, int, double, etc), The type_id is only meaningful in an actual data Sample, and is not accessible in the SampleTag class.

The 26 bits of DSM_id and sensor+sample are known simply as the Id (or full id), and is accessible with the getId() method.

The DSM_id contains the id of the data acquisition system that collected the data, and can be accessed separately from the other fields with getDSMId() and setDSMId().

The 16-bit sensor+sample id is also known as the shortId. To maintain flexibility, the shortId has not been divided further into bit fields of sensor and sample id, but is a sum of the two. This means that you cannot set the shortId without losing track of the sensor and sample ids. For this reason, methods to set the shortId and fullId are protected.

To access the portions of the shortId, use getSensorId(), setSensorId(), getSampleId() and setSampleId().

Example: a DSMSensor has an id of 200, and four associated SampleTags with sample ids of 1,2,3 and 4. Therefore one should do a setSensorId(200) on each of the SampleTags, so that their shortIds become 201,202,203, and 204. The convention is that processed samples have sample ids >= 1. Raw, unprocessed Samples from this sensor have a sample id of 0, and therefore a shortId of 200.

A SampleTag also has a rate attribute, indicating the requested sampling rate for the variables.

Constructor & Destructor Documentation

SampleTag::SampleTag ( )

Constructor.

SampleTag::SampleTag ( const DSMSensor * sensor )

Constructor of a sample for a given sensor.

References _dsm, _sensor, nidas::core::DSMConfig::getId(), nidas::core::DSMSensor::getId(), setDSMId(), and setSensorId().

SampleTag::SampleTag ( const SampleTag & x )

Copy constructor.

References addParameter(), addVariable(), nidas::core::Parameter::clone(), getParameters(), and getVariables().

SampleTag::~SampleTag ( )

virtual

References _parameters, and _variables.

Member Function Documentation

void SampleTag::addParameter ( Parameter * val )

Add a parameter to this SampleTag.

SampleTag will then own the pointer and will delete it in its destructor. If a Parameter already exists with the same name, that Parameter will be removed and deleted.

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

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

void SampleTag::addVariable	(	Variable *	var	)
throw	(	nidas::util::InvalidParameterException
	)

virtual

Add a variable to this SampleTag.

SampleTag will own the Variable, and will delete it in its destructor.

void SampleTag::fromDOMElement	(	const xercesc::DOMElement *	)
throw	(	nidas::util::InvalidParameterException
	)

virtual

Initialize myself from a xercesc::DOMElement.

Implements nidas::core::DOMable.

References nidas::core::Parameter::createParameter(), nidas::core::Project::expandString(), nidas::core::Variable::fromDOMElement(), GET_DSM_ID, GET_SPS_ID, nidas::core::XDOMElement::getAttributeValue(), nidas::core::VariableConverter::getCalFile(), nidas::core::Variable::getConverter(), nidas::core::Project::getInstance(), nidas::core::XDOMAttr::getName(), nidas::core::XDOMElement::getNodeName(), rate, nidas::core::CalFile::setDSMSensor(), nidas::core::Variable::setSampleTag(), nidas::core::Variable::setSite(), and nidas::core::Variable::setStation().

Referenced by nidas::dynld::isff::GOESOutput::fromDOMElement(), nidas::core::SampleIOProcessor::fromDOMElement(), and nidas::core::DSMSensor::fromDOMElement().

unsigned int SampleTag::getDataIndex ( const Variable * var ) const

What is the index of a Variable into the data of a sample from this SampleTag.

Returns: UINT_MAX: 'tain't here

References _constVariables.

Referenced by nidas::dynld::StatisticsCruncher::attach(), nidas::core::NearestResampler::connect(), nidas::core::SampleAverager::connect(), and nidas::core::NearestResamplerAtRate::connect().

const DSMConfig* nidas::core::SampleTag::getDSMConfig ( ) const

inline

References _dsm.

unsigned int nidas::core::SampleTag::getDSMId ( ) const

inline

Get the DSM portion of the id.

References _id, and GET_DSM_ID.

Referenced by nidas::dynld::isff::WisardMote::addMoteSampleTag(), nidas::dynld::StatisticsCruncher::attach(), nidas::dynld::psql::PSQLProcessor::connect(), nidas::core::NearestResamplerAtRate::connect(), nidas::dynld::StatisticsProcessor::connectSource(), nidas::core::NearestResamplerAtRate::ctorCommon(), nidas::core::DSMSensor::fromDOMElement(), and nidas::dynld::StatisticsCruncher::StatisticsCruncher().

const DSMSensor* nidas::core::SampleTag::getDSMSensor ( ) const

inline

References _sensor.

Referenced by nidas::core::SamplePipeline::addSampleClient(), nidas::core::SamplePipeline::connect(), SampleToDatabase::defaultMeasurementName(), nidas::core::SamplePipeline::disconnect(), nidas::core::VariableConverter::getDSMSensor(), and nidas::core::SamplePipeline::removeSampleClient().

dsm_sample_id_t nidas::core::SampleTag::getId ( ) const

inline

Get the 26 bit id, containing the DSM id and the sensor+sample id.

References _id, and GET_FULL_ID.

static const XMLCh* nidas::core::DOMable::getNamespaceURI ( )

inlinestaticinherited

References nidas::core::DOMable::namespaceURI.

const Parameter * SampleTag::getParameter ( const std::string & name ) const

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

Referenced by nidas::dynld::isff::WisardMote::unpackTsoil(), and nidas::dynld::raf::DSMAnalogSensor::validate().

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

inline

References _constParameters.

Referenced by operator=(), SampleTag(), nidas::dynld::DSC_FreqCounter::validate(), nidas::dynld::A2DSensor::validate(), and nidas::dynld::raf::A2D_Serial::validate().

virtual double nidas::core::SampleTag::getPeriod ( ) const

inlinevirtual

Get sampling period (1/rate) in sec.

A value of 0.0 means an unknown rate.

References _rate.

Referenced by nidas::dynld::isff::GOESOutput::connected(), and nidas::dynld::isff::GOESOutput::run().

double nidas::core::SampleTag::getPromptOffset ( ) const

inline

References _promptOffset.

Referenced by nidas::core::CharacterSensor::validate().

const std::string& nidas::core::SampleTag::getPromptString ( ) const

inline

References _promptString.

Referenced by nidas::core::CharacterSensor::validate().

virtual double nidas::core::SampleTag::getRate ( ) const

inlinevirtual

Get sampling rate in samples/sec.

A value of 0.0 means an unknown rate.

References _rate.

unsigned int nidas::core::SampleTag::getSampleId ( ) const

inline

Get the sample portion of the shortId.

References _sampleId.

Referenced by nidas::core::SamplePipeline::connect(), nidas::dynld::raf::CVIProcessor::connectSource(), SampleToDatabase::defaultMeasurementName(), nidas::core::SampleIOProcessor::fromDOMElement(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::raf::DSMArincSensor::init(), nidas::dynld::raf::DSMArincSensor::open(), parseAnalog(), parseOther(), PConfig::showAll(), nidas::dynld::GPS_Novatel_Serial::validate(), nidas::dynld::GPS_NMEA_Serial::validate(), nidas::dynld::raf::TwoD64_USB_v3::validate(), and nidas::dynld::raf::A2D_Serial::validate().

const std::string& nidas::core::SampleTag::getScanfFormat ( ) const

inline

References _scanfFormat.

Referenced by nidas::core::CharacterSensor::doesAsciiSscanfs(), and nidas::core::CharacterSensor::init().

unsigned int nidas::core::SampleTag::getSensorId ( ) const

inline

Get the sensor portion of the shortId.

References _sensorId.

const Site * SampleTag::getSite ( ) const

Get the Site of this SampleTag, which will be non-NULL only if getDSMConfig() returns non-NULL.

References _dsm, and nidas::core::DSMConfig::getSite().

Referenced by nidas::core::Variable::setSampleTag(), and SampleToDatabase::setSiteAndMeasurement().

unsigned int nidas::core::SampleTag::getSpSId ( ) const

inline

Get the sensor+sample portion of the id.

References _id, and GET_SPS_ID.

Referenced by nidas::dynld::isff::WisardMote::addMoteSampleTag(), nidas::dynld::StatisticsCruncher::attach(), nidas::core::NearestResamplerAtRate::connect(), nidas::dynld::StatisticsProcessor::connectSource(), nidas::core::NearestResamplerAtRate::ctorCommon(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::isff::GOESProject::GOESProject(), StatsProcess::listOutputSamples(), nidas::dynld::StatisticsProcessor::selectRequestedSampleTags(), and nidas::dynld::StatisticsCruncher::StatisticsCruncher().

int nidas::core::SampleTag::getStation ( ) const

inline

Station number, which is also known as the Site number.

A station number of 0 is the "non" station. Otherwise positive integers are used when a project consists of more than one similar station, where one can differentiate between the variables by a station number (which maps to a station dimension in a NetCDF file). Setting the station on a SampleTag will set the: the station on all its variables.

References _station.

Referenced by PConfig::loadVariables(), and nidas::core::Variable::setSampleTag().

const std::string& nidas::core::SampleTag::getSuffix ( ) const

inline

Suffix, which is appended to variable names.

References _suffix.

Referenced by SampleToDatabase::setSiteAndMeasurement().

float nidas::core::SampleTag::getTimetagAdjust ( ) const

inline

Whether to enable TimetagAdjuster for this sample.

A value of 0 means no ttadjust. The default value of -1 means don't override the value set for the sensor.

References _ttAdjustVal.

Referenced by nidas::dynld::isff::ATIK_Sonic::checkSampleTags(), nidas::dynld::isff::CSI_IRGA_Sonic::checkSampleTags(), nidas::dynld::isff::CSAT3_Sonic::checkSampleTags(), nidas::core::CharacterSensor::init(), nidas::dynld::raf::DSMArincSensor::init(), and nidas::dynld::isff::CSI_CRX_Binary::validate().

Variable& nidas::core::SampleTag::getVariable ( int i )

inline

Provide a reference to a variable - allowing one to modify it.

References _variables.

VariableIterator SampleTag::getVariableIterator ( ) const

Referenced by nidas::dynld::isff::GOESOutput::addSourceSampleTag(), nidas::dynld::StatisticsCruncher::attach(), nidas::dynld::isff::Wind3D::checkSampleTags(), nidas::core::NearestResampler::connect(), nidas::core::SampleAverager::connect(), nidas::dynld::StatisticsCruncher::connect(), nidas::core::NearestResamplerAtRate::connect(), nidas::dynld::isff::GOESOutput::connected(), nidas::dynld::StatisticsProcessor::connectSource(), nidas::dynld::StatisticsCruncher::createCombinations(), nidas::dynld::WxtSensor::init(), PConfig::loadVariables(), parseAnalog(), parseOther(), DumpClient::setSensors(), and PConfig::showAll().

const std::vector< const Variable * > & SampleTag::getVariables ( ) const

References _constVariables.

const std::vector<Variable*>& nidas::core::SampleTag::getVariables ( )

inline

References _variables.

bool nidas::core::SampleTag::isEnabled ( ) const

inline

References _enabled.

bool nidas::core::SampleTag::isProcessed ( ) const

inline

Test to see if this sample is to be post processed.

References _processed.

Referenced by nidas::dynld::psql::PSQLProcessor::connect(), nidas::dynld::raf::DSMArincSensor::init(), PConfig::loadVariables(), nidas::dynld::raf::DSMArincSensor::open(), parseAnalog(), parseOther(), nidas::dynld::raf::SyncRecordSource::selectVariablesFromSensor(), and PConfig::showAll().

SampleTag & SampleTag::operator= ( const SampleTag & rhs )

References _dsm, _enabled, _id, _processed, _promptOffset, _promptString, _rate, _sampleId, _scanfFormat, _sensor, _sensorId, _station, _suffix, addParameter(), addVariable(), nidas::core::Parameter::clone(), getParameters(), and getVariables().

void SampleTag::removeVariable ( const Variable * var )

References _constVariables, _variables, and nidas::core::Variable::getName().

void nidas::core::SampleTag::setDSMConfig ( const DSMConfig * val )

inline

References _dsm.

Referenced by nidas::core::DSMSensor::fromDOMElement().

void nidas::core::SampleTag::setDSMId ( unsigned int val )

inline

Set the DSM portion of the id.

References _id, and SET_DSM_ID.

Referenced by nidas::dynld::StatisticsProcessor::connectSource(), nidas::core::NearestResampler::ctorCommon(), nidas::core::NearestResamplerAtRate::ctorCommon(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::isff::GOESProject::GOESProject(), main(), SampleTag(), nidas::dynld::StatisticsCruncher::StatisticsCruncher(), and nidas::dynld::raf::SyncRecordSource::SyncRecordSource().

void SampleTag::setDSMSensor ( const DSMSensor * val )

References _dsm, _sensor, and nidas::core::DSMSensor::getDSMConfig().

Referenced by nidas::core::DSMSensor::fromDOMElement().

void nidas::core::SampleTag::setEnabled ( bool val )

inline

References _enabled.

void nidas::core::SampleTag::setId ( dsm_sample_id_t val )

inlineprotected

Set the full id.

We don't make this public, because when you use it you can't keep track of the sensor and sample portions of the shortID.

References _id, and SET_FULL_ID.

virtual void nidas::core::SampleTag::setPeriod	(	double	val	)
throw	(	nidas::util::InvalidParameterException
	)

inlinevirtual

Set sampling period (1/rate) in sec.

A value of 0.0 means an unknown period.

References _rate.

Referenced by nidas::dynld::isff::GOESProject::GOESProject().

void nidas::core::SampleTag::setProcessed	(	bool	val	)
throw	(	nidas::util::InvalidParameterException
	)

inline

Set if this sample is going to be post processed.

References _processed.

void nidas::core::SampleTag::setPromptOffset ( double val )

inline

References _promptOffset.

void nidas::core::SampleTag::setPromptString ( const std::string & val )

inline

References _promptString.

virtual void nidas::core::SampleTag::setRate	(	double	val	)
throw	(	nidas::util::InvalidParameterException
	)

inlinevirtual

Set sampling rate in samples/sec.

Derived SampleTags can override this method and throw an InvalidParameterException if they can't support the rate value. Sometimes a rate of 0.0 may mean don't sample the variables in the SampleTag.

References _rate.

Referenced by nidas::dynld::raf::IRIGSensor::fromDOMElement(), nidas::core::DSMSensor::fromDOMElement(), main(), DataPrep::run(), nidas::dynld::raf::SyncRecordReader::scanHeader(), nidas::core::SampleAverager::setAveragePeriodSecs(), nidas::dynld::StatisticsCruncher::StatisticsCruncher(), nidas::dynld::raf::SyncRecordSource::SyncRecordSource(), and nidas::core::CharacterSensor::validate().