te::st::STDataLoaderFromMemDS Class Reference

A class responsible for loading spatiotemporal data from a ST in-memory DataSource which contains an internal chache of in-memory DataSets indexed by space and time. More...

#include <STDataLoaderFromMemDS.h>

Inheritance diagram for te::st::STDataLoaderFromMemDS:

Public Member Functions
	STDataLoaderFromMemDS ()
	Constructor. More...
virtual	~STDataLoaderFromMemDS ()
Inhered methods
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a ObservationDataSet, that is, a DataSet that contains observations. More...
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, const te::gm::Envelope &e, te::gm::SpatialRelation r=te::gm::INTERSECTS, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations whose observed geometries satisfy a given spatial relation. More...
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation r=te::gm::INTERSECTS, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations whose observed geometries satisfy a given spatial relation. More...
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation r=te::dt::DURING, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations whose phenomenon times satisfy a given temporal relation. More...
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation tr, const te::gm::Envelope &e, te::gm::SpatialRelation sr=te::gm::INTERSECTS, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations whose observed geometries satisfy a given spatial relation and phenomenon times satisfy a given temporal relation. More...
std::auto_ptr< ObservationDataSet >	getDataSet (const ObservationDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation sr, const te::dt::DateTime &dt, te::dt::TemporalRelation tr=te::dt::DURING, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations whose observed geometries satisfy a given spatial relation and phenomenon times satisfy a given temporal relation. More...
void	getInfo (const TrajectoryDataSetInfo &input, std::vector< TrajectoryDataSetInfo > &output)
	It returns the information about all trajectories that exist in a single DataSet. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations of a trajectory. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation r, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns patches of a trajectory whose geometries satisfy a given spatial relation. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, const te::gm::Envelope &e, te::gm::SpatialRelation r, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns patches of a trajectory whose geometries satisfy a given spatial relation. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation r=te::dt::DURING, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations of trajectories whose times satisfy a given temporal relation. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation tr, const te::gm::Envelope &e, te::gm::SpatialRelation sr=te::gm::INTERSECTS, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns patches of a trajectory whose envelope satisfy a given spatial relation and times satisfy a given temporal relation. More...
std::auto_ptr< TrajectoryDataSet >	getDataSet (const TrajectoryDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation sr, const te::dt::DateTime &dt, te::dt::TemporalRelation tr, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns patches of a trajectory whose geometries satisfy a given spatial relation and times satisfy a given temporal relation. More...
void	getInfo (const TimeSeriesDataSetInfo &input, std::vector< TimeSeriesDataSetInfo > &output)
	It returns the information about all time series that exist in a single DataSet. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations of time series. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation r, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns data set with observations of time series whose geometries satisfy a given spatial relation. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, const te::gm::Envelope &e, te::gm::SpatialRelation r, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns data set with observations of time series whose geometries satisfy a given spatial relation. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation r=te::dt::DURING, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns a data set with observations of time series whose times satisfy a given temporal relation. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, const te::dt::DateTime &dt, te::dt::TemporalRelation tr, const te::gm::Envelope &e, te::gm::SpatialRelation sr=te::gm::INTERSECTS, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns data set with observations of time series whose geometries satisfy a given spatial relation and times satisfy a given temporal relation. More...
std::auto_ptr< TimeSeriesDataSet >	getDataSet (const TimeSeriesDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation sr, const te::dt::DateTime &dt, te::dt::TemporalRelation tr, te::common::TraverseType travType=te::common::FORWARDONLY)
	It returns data set with observations of time series whose geometries satisfy a given spatial relation and times satisfy a given temporal relation. More...
std::auto_ptr< te::dt::DateTimePeriod >	getTemporalExtent (const ObservationDataSetInfo &info)
	It returns the temporal extent of the data set with observations. More...
std::auto_ptr< te::dt::DateTimePeriod >	getTemporalExtent (const TrajectoryDataSetInfo &info)
	It returns the temporal extent of the data set with observations of a trajectory. More...
std::auto_ptr< te::dt::DateTimePeriod >	getTemporalExtent (const TimeSeriesDataSetInfo &info)
	It returns the temporal extent of the data set with observations of a time series. More...
te::gm::Envelope	getSpatialExtent (const ObservationDataSetInfo &info)
	It returns the temporal extent of the data set with observations of a coverage series. More...
te::gm::Envelope	getSpatialExtent (const TrajectoryDataSetInfo &info)
	It returns the spatial extent of the observations of a trajectory. More...

Protected Member Functions
std::auto_ptr< ObservationDataSet >	buildDataSet (te::stmem::DataSet *ds, const ObservationDataSetInfo &info)
	It builds an ObservationDataSet from a given DataSet. More...
std::auto_ptr< TrajectoryDataSet >	buildDataSet (te::stmem::DataSet *ds, const TrajectoryDataSetInfo &info)
	It builds an TrajectoryDataSet from a given DataSet. More...
std::auto_ptr< TimeSeriesDataSet >	buildDataSet (te::stmem::DataSet *ds, const TimeSeriesDataSetInfo &info)
	It builds an TimeSeriesDataSet from a given DataSet. More...
void	loadDataSet (const te::da::DataSourceInfo &info, const std::string dsname, const std::string &begTimePropName, const std::string &endTimePropName, const std::string &gmPropName)
	It loads DataSet from the original DataSource and put it in the In-Memory DataSource. More...

Private Attributes
te::da::DataSourcePtr	m_ds

Detailed Description

A class responsible for loading spatiotemporal data from a ST in-memory DataSource which contains an internal chache of in-memory DataSets indexed by space and time.

All infos about the DataSets that contains observations, such as ObservationDataSetInfo, TrajectoryDataSetInfo, etc, contains information about the original DataSource and DataSet.

TO DO: verificar o nome do DataSet: do jeito que está não pode ter nome repetido!

Definition at line 59 of file STDataLoaderFromMemDS.h.

Constructor & Destructor Documentation

te::st::STDataLoaderFromMemDS::STDataLoaderFromMemDS

(

)

Constructor.

virtual te::st::STDataLoaderFromMemDS::~STDataLoaderFromMemDS ( )

virtual

Member Function Documentation

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::buildDataSet ( te::stmem::DataSet *  ds, const ObservationDataSetInfo &  info  )

protected

It builds an ObservationDataSet from a given DataSet.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::buildDataSet ( te::stmem::DataSet *  ds, const TrajectoryDataSetInfo &  info  )

protected

It builds an TrajectoryDataSet from a given DataSet.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::buildDataSet ( te::stmem::DataSet *  ds, const TimeSeriesDataSetInfo &  info  )

protected

It builds an TimeSeriesDataSet from a given DataSet.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a ObservationDataSet, that is, a DataSet that contains observations.

Parameters

info	Information about the DataSource which the observation are from and the DataSet which contains the observations.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, const te::gm::Envelope &  e, te::gm::SpatialRelation  r = te::gm::INTERSECTS, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations whose observed geometries satisfy a given spatial relation.

Parameters

info	Information about the DataSource which the observation are from and the DataSet which contains the observations.
e	A given envelope.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  r = te::gm::INTERSECTS, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations whose observed geometries satisfy a given spatial relation.

The possible spatial relations implemented here are: INTERSECTS

Parameters

info	Information about the DataSource which the observation are from and the DataSet which contains the observations.
geom	A given geometry.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  r = te::dt::DURING, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations whose phenomenon times satisfy a given temporal relation.

The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;S;

Parameters

info	Information about the DataSource which the observation are from and the DataSet which contains the observations.
dt	A given datetime.
r	A given temporal relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

The caller will take the ownership of the returned pointer.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr, const te::gm::Envelope &  e, te::gm::SpatialRelation  sr = te::gm::INTERSECTS, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations whose observed geometries satisfy a given spatial relation and phenomenon times satisfy a given temporal relation.

The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observation of trajectpries are from and the DataSet which contains the observations.
dt	A given datetime.
tr	A given temporal relation.
e	A given envelope.
sr	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

Before using this method, certify that the Data Source exists in the DataSourceManager and its "id" is correct in the info parameter

The caller will take the ownership of the returned pointer.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<ObservationDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const ObservationDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  sr, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr = te::dt::DURING, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations whose observed geometries satisfy a given spatial relation and phenomenon times satisfy a given temporal relation.

The possible spatial relations are: INTERSECTS The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observation are from and the DataSet which contains the observations.
geom	A given geometry.
sr	A given spatial relation.
dt	A given datetime.
tr	A given temporal relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new ObservationDataSet.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointers.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations of a trajectory.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

Parameters

info	Information about the DataSource which the observations of a trajectory are from and the DataSet which contains these observations.
travType	The traverse type associated to the returned datasets.
rwRole	The read and write permission associated to the returned datasets.

Returns

The returned TrajectoryDataSet.

Note

The info must have the id of the desire trajectory

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  r, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns patches of a trajectory whose geometries satisfy a given spatial relation.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

The possible spatial relations implemented here are: INTERSECTS

Parameters

info	Information about the DataSource which the observations of a trajectory are from and the DataSet which contains these observations.
geom	A given geometry.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned trajectoy data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, const te::gm::Envelope &  e, te::gm::SpatialRelation  r, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns patches of a trajectory whose geometries satisfy a given spatial relation.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

Parameters

info	Information about the DataSource which the observations of a trajectory are from and the DataSet which contains the observations.
e	A given envelope.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned trajectoy data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  r = te::dt::DURING, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations of trajectories whose times satisfy a given temporal relation.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observation of trajectpries are from and the DataSet which contains the observations.
dt	A given datetime.
r	A given temporal relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new TrajectoryDataSet.

Note

The caller will take the ownership of the returned pointer.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr, const te::gm::Envelope &  e, te::gm::SpatialRelation  sr = te::gm::INTERSECTS, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns patches of a trajectory whose envelope satisfy a given spatial relation and times satisfy a given temporal relation.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observation of trajectpries are from and the DataSet which contains the observations.
dt	A given datetime.
tr	A given temporal relation.
e	A given envelope.
sr	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new TrajectoryDataSet.

Note

Before using this method, certify that the Data Source exists in the DataSourceManager and its "id" is correct in the info parameter

The caller will take the ownership of the returned pointer.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TrajectoryDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TrajectoryDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  sr, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns patches of a trajectory whose geometries satisfy a given spatial relation and times satisfy a given temporal relation.

When the DataSet contains more than one trajectory, the info parameter (TrajectoryDataSetInfo) must contain the id of the desire trajectory that must be returned as a TrajectoryDataSet.

The possible spatial relations are: INTERSECTS The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observations of trajectories are from and the DataSet which contains these observations.
geom	A given geometry.
sr	A given spatial relation.
dt	A given datetime.
tr	A given temporal relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned trajectoy data set.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointers.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations of time series.

When the DataSet contains more than one time series, the info parameter (TimeSeriesDataSetInfo) must contain the id of the desire time series that must be returned as a TimeSeriesDataSet.

Parameters

info	Information about the DataSource which the observations of a time series are from and the DataSet which contains these observations.
travType	The traverse type associated to the returned datasets.

Returns

The returned TrajectoryDataSet.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  r, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns data set with observations of time series whose geometries satisfy a given spatial relation.

Parameters

info	Information about the DataSource which the observations of a time series are from and the DataSet which contains the observations.
geom	A given geometry.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned time series data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, const te::gm::Envelope &  e, te::gm::SpatialRelation  r, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns data set with observations of time series whose geometries satisfy a given spatial relation.

Parameters

info	Information about the DataSource which the observations of a time series are from and the DataSet which contains the observations.
e	A given envelope.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned time series data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  r = te::dt::DURING, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns a data set with observations of time series whose times satisfy a given temporal relation.

When the DataSet contains more than one time series, the info parameter (TimeSeriesDataSetInfo) must contain the id of the desire time series that must be returned as a TimeSeriesDataSet.

The possible temporal relations are:

1. BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
2. MEETS; 6. OVERLAPS 7 - STARTS; 8 -FINISHES;

Parameters

info	Information about the DataSource which the observation of time series are from and the DataSet which contains the observations.
dt	A given datetime.
r	A given temporal relation.
travType	The traverse type associated to the returned dataset.

Returns

A pointer to a new TimeSeriesDataSet.

Note

The caller will take the ownership of the returned pointer.

When the temporal relation is DURING, dt must be a time period.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr, const te::gm::Envelope &  e, te::gm::SpatialRelation  sr = te::gm::INTERSECTS, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns data set with observations of time series whose geometries satisfy a given spatial relation and times satisfy a given temporal relation.

Parameters

info	Information about the DataSource which the observations of a time series are from and the DataSet which contains the observations.
dt	A given datetime.
tr	A given temporal relation.
e	A given envelope.
sr	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned time series data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<TimeSeriesDataSet> te::st::STDataLoaderFromMemDS::getDataSet ( const TimeSeriesDataSetInfo &  info, const te::gm::Geometry &  geom, te::gm::SpatialRelation  sr, const te::dt::DateTime &  dt, te::dt::TemporalRelation  tr, te::common::TraverseType  travType = te::common::FORWARDONLY  )

virtual

It returns data set with observations of time series whose geometries satisfy a given spatial relation and times satisfy a given temporal relation.

Parameters

info	Information about the DataSource which the observations of a time series are from and the DataSet which contains the observations.
e	A given envelope.
r	A given spatial relation.
travType	The traverse type associated to the returned dataset.

Returns

The returned time series data set.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

void te::st::STDataLoaderFromMemDS::getInfo ( const TrajectoryDataSetInfo &  input, std::vector< TrajectoryDataSetInfo > &  output  )

virtual

It returns the information about all trajectories that exist in a single DataSet.

The information about the DataSource and DataSet that contains trajectories is defined as a TrajectoryDataSetInfo (input parameter).

The information about each trajectory (its correct id) is returned as a TrajectoryDataSetInfo of the parameter output. These results can be used to create TrajectoryDataSetLayers.

Parameters

input	The information about the DataSource and DataSet that contains trajectories
output	The information about each trajectory (its correct id).

Note

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

void te::st::STDataLoaderFromMemDS::getInfo ( const TimeSeriesDataSetInfo &  input, std::vector< TimeSeriesDataSetInfo > &  output  )

virtual

It returns the information about all time series that exist in a single DataSet.

The information about the DataSource and DataSet that contains time series is defined as a TimeSeriesDataSetInfo (input parameter).

The information about each time series (its correct id) is returned as a TimeSeriesDataSetInfo of the parameter output. These results can be used to create TimeSeriesDataSetLayers.

Parameters

input	The information about the DataSource and DataSet that contains time series
output	The information about each time series (its correct id).

Note

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

te::gm::Envelope te::st::STDataLoaderFromMemDS::getSpatialExtent ( const ObservationDataSetInfo &  info )

virtual

It returns the temporal extent of the data set with observations of a coverage series.

Returns

The temporal extent of the observations of a coverage series.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointer "info".

It can throw an Exception when internal errors occur.

It returns the spatial extent of the observations, when there is an observed value of geometry type.

Returns

The spatial extent of the observations.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

te::gm::Envelope te::st::STDataLoaderFromMemDS::getSpatialExtent ( const TrajectoryDataSetInfo &  info )

virtual

It returns the spatial extent of the observations of a trajectory.

Returns

The spatial extent of the observations of a trajectory.

Note

The caller will take the ownership of the returned pointer.

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<te::dt::DateTimePeriod> te::st::STDataLoaderFromMemDS::getTemporalExtent ( const ObservationDataSetInfo &  info )

virtual

It returns the temporal extent of the data set with observations.

Returns

The temporal extent of the observations.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointer "info".

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<te::dt::DateTimePeriod> te::st::STDataLoaderFromMemDS::getTemporalExtent ( const TrajectoryDataSetInfo &  info )

virtual

It returns the temporal extent of the data set with observations of a trajectory.

Returns

The temporal extent of the observations of a trajectory.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointer "info".

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

std::auto_ptr<te::dt::DateTimePeriod> te::st::STDataLoaderFromMemDS::getTemporalExtent ( const TimeSeriesDataSetInfo &  info )

virtual

It returns the temporal extent of the data set with observations of a time series.

Returns

The temporal extent of the observations of a time series.

Note

The caller will take the ownership of the returned pointer.

It will NOT take the ownership of the given pointer "info".

It can throw an Exception when internal errors occur.

Implements te::st::STDataLoaderImpl.

void te::st::STDataLoaderFromMemDS::loadDataSet ( const te::da::DataSourceInfo &  info, const std::string  dsname, const std::string &  begTimePropName, const std::string &  endTimePropName, const std::string &  gmPropName  )

protected

It loads DataSet from the original DataSource and put it in the In-Memory DataSource.

Note

It can through an Exception.

Member Data Documentation

te::da::DataSourcePtr te::st::STDataLoaderFromMemDS::m_ds

private

Definition at line 188 of file STDataLoaderFromMemDS.h.

---

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

• /home/castejon/castejon_files/develop/terralib5/git_master/src/terralib/st/loader/STDataLoaderFromMemDS.h