A class that contains a set of static methods to load spatiotemporal data from data sources. More...

#include <STDataLoader.h>

Public Member Functions
virtual	~STDataLoader ()
	Virtual destructor. More...

Static Public Member Functions

static void finalize ()

It finalize the STDataLoader. More...

static void initialize ()

It returns the spatial extent of the observations of a coverage series. More...

Operations for loading ObservationDataSet

static 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...

static 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...

static 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...

static 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...

static 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...

Operations for loading TrajectoryDataSet

static void getInfo (const TrajectoryDataSetInfo &input, std::vector< TrajectoryDataSetInfo > &output)

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

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

It returns a data set with observations of trajectories. More...

static 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...

static 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...

static 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...

static 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...

Operations for loading TimeSeriesDataSet

static void getInfo (const TimeSeriesDataSetInfo &input, std::vector< TimeSeriesDataSetInfo > &output)

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

static 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...

static 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...

Operations for loading spatiotemporal data types

(TimeSeries, Trajetory, CoverageSeries) directly from data sources, without using DataSets.

static std::auto_ptr
< CoverageSeries > getCoverageSeries (const PointCoverageSeriesDataSetInfo &info, AbstractPointCoverageInterp *interp)

It returns a point coverage series. More...

static std::auto_ptr
< CoverageSeries > getCoverageSeries (const RasterCoverageSeriesDataSetInfo &info)

It returns a raster coverage series. More...

static std::auto_ptr
< RasterCoverage > getCoverage (const RasterCoverageDataSetInfo &info)

It returns a raster coverage. More...

static std::auto_ptr
< PointCoverage > getCoverage (const PointCoverageDataSetInfo &info, AbstractPointCoverageInterp *interp)

It returns a point coverage. More...

Operations for loading temporal and spatial extent

It returns a time series associated to a point of a coverage series.

If info contains information about raster coverages and its associated data source supports raster data type, this function is executed by the data source. Otherwise, it is executed in two steps: (1) creating a CoverageSeries type and (2) using its method getTimeSeries.

Parameters

info	Information about the DataSource which the observations of a coverage series are from and the data sets which contain these observations.
p	A given point.

Returns: The returned CoverageSeries.

Note: The caller will take the ownership of the returned pointer.; It can throw an Exception when internal errors occur.

\TO DO: (1) vantagem de usar o DataSetCoverageDataSet � ele fica armazenado no driver \em mem�ria (stmem) ao inv�s de toda hora gerar o CoverageSeries para cada ponto \que queremos extrair a time series.

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

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

static 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...

static 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...

static te::gm::Envelope getSpatialExtent (const ObservationDataSetInfo &info)

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

static te::gm::Envelope getSpatialExtent (const TrajectoryDataSetInfo &info)

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

Protected Member Functions
	STDataLoader ()
	Protected constructor. More...

Detailed Description

A class that contains a set of static methods to load spatiotemporal data from data sources.

Note: Before using the methods of this class, certify that the Data Source exists in the DataSourceManager; The methods of this class can throw an Exception when internal errors occur.

See Also: ObservationDataSet ObservationDataSetInfo; TrajectoryDataSet TrajectoryDataSetInfo; CoverageSeriesDataSet CoverageSeriesDataSetInfo

Definition at line 86 of file STDataLoader.h.

Constructor & Destructor Documentation

te::st::STDataLoader::~STDataLoader ( )

virtual

Virtual destructor.

Definition at line 322 of file STDataLoader.cpp.

te::st::STDataLoader::STDataLoader ( )

protected

Protected constructor.

Definition at line 51 of file STDataLoader.cpp.

Member Function Documentation

void te::st::STDataLoader::finalize ( )

static

It finalize the STDataLoader.

It closes (cleans its iternal DataSets) ST Memory data source in the DataSourceManager.

Note: The user must use this method after using the STDataLoader.; It can throw an Exception when internal errors occur.

Definition at line 315 of file STDataLoader.cpp.

References te::common::Singleton< DataSourceManager >::getInstance(), and te::st::Globals::sm_STMemoryDataSourceId.

std::auto_ptr< te::st::RasterCoverage > te::st::STDataLoader::getCoverage ( const RasterCoverageDataSetInfo & info )

static

It returns a raster coverage.

Parameters

info	Information about the DataSource which the observations of a raster coverage are from and the data sets which contain these observations.

Returns: The returned RasterCoverage.

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.; It can throw an Exception when internal errors occur.

Definition at line 203 of file STDataLoader.cpp.

References te::da::GetDataSet(), te::st::ObservationDataSetInfo::getDataSetName(), te::st::RasterCoverageDataSetInfo::getDataSourceInfo(), te::da::DataSourceInfo::getId(), te::st::RasterCoverageDataSetInfo::getObservationDataSetInfo(), te::st::RasterCoverageDataSetInfo::getRasterPropIdx(), te::st::RasterCoverageDataSetInfo::getTime(), and te::st::RasterCoverageDataSetInfo::getTimePropIdxs().

std::auto_ptr< te::st::PointCoverage > te::st::STDataLoader::getCoverage	(	const PointCoverageDataSetInfo &	info,
		AbstractPointCoverageInterp *	interp
	)

static

It returns a point coverage.

Parameters

info	Information about the DataSource which the observations of a point coverage are from and the data sets which contain these observations.
interp	The interpolator associated to the point coverage

Returns: The returned PointCoverage.

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.; It will take the ownership of the given pointers.; It can throw an Exception when internal errors occur.

Definition at line 224 of file STDataLoader.cpp.

References te::da::GetDataSet(), te::st::ObservationDataSetInfo::getDataSetName(), te::st::PointCoverageDataSetInfo::getDataSourceInfo(), te::da::DataSourceInfo::getId(), te::st::PointCoverageDataSetInfo::getObservationDataSetInfo(), te::st::PointCoverageDataSetInfo::getPointPropIdx(), te::st::PointCoverageDataSetInfo::getTime(), te::st::PointCoverageDataSetInfo::getTimePropIdxs(), and te::st::PointCoverageDataSetInfo::getValuePropIdxs().

std::auto_ptr< te::st::CoverageSeries > te::st::STDataLoader::getCoverageSeries	(	const PointCoverageSeriesDataSetInfo &	info,
		AbstractPointCoverageInterp *	interp
	)

static

It returns a point coverage series.

Parameters

info	Information about the DataSource which the observations of a coverage series are from and the data sets which contain these observations.
interp	The interpolator associated to each

Returns: The returned CoverageSeries.

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.; It can throw an Exception when internal errors occur.

Definition at line 173 of file STDataLoader.cpp.

std::auto_ptr< te::st::CoverageSeries > te::st::STDataLoader::getCoverageSeries ( const RasterCoverageSeriesDataSetInfo & info )

static

It returns a raster coverage series.

Parameters

info	Information about the DataSource which the observations of a coverage series are from and the data sets which contain these observations.

Returns: The returned CoverageSeries.

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.; It can throw an Exception when internal errors occur.

Definition at line 189 of file STDataLoader.cpp.

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 56 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 64 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 72 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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

The possible temporal relations are: 1. AFTER;

AFTER | EQUALS; 3. BEFORE; 4. BEFORE | EQUALS; 5. DURING; 6. EQUALS

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: 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.

Definition at line 80 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

std::auto_ptr< te::st::ObservationDataSet > te::st::STDataLoader::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`
	)

static

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. AFTER;

AFTER | EQUALS; 3. BEFORE; 4. BEFORE | EQUALS; 5. DURING; 6. EQUALS

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: 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.; 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.

Definition at line 89 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

It returns a data set with observations of trajectories.

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 106 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 113 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 122 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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. AFTER;

AFTER | EQUALS; 3. BEFORE; 4. BEFORE | EQUALS; 5. DURING; 6. EQUALS

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: 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.

Definition at line 131 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

std::auto_ptr< te::st::TrajectoryDataSet > te::st::STDataLoader::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`
	)

static

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. AFTER;

AFTER | EQUALS; 3. BEFORE; 4. BEFORE | EQUALS; 5. DURING; 6. EQUALS

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: 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.; 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.

Definition at line 140 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It can throw an Exception when internal errors occur.

Definition at line 157 of file STDataLoader.cpp.

References te::st::TimeSeriesDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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. AFTER;

AFTER | EQUALS; 3. BEFORE; 4. BEFORE | EQUALS; 5. DURING; 6. EQUALS

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: 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.

Definition at line 164 of file STDataLoader.cpp.

References te::st::TimeSeriesDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: Before using this method, certify that the Data Source exists in the DataSourceManager and its "id" is correct in the info parameter; It can throw an Exception when internal errors occur.

Definition at line 98 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: Before using this method, certify that the Data Source exists in the DataSourceManager and its "id" is correct in the info parameter; It can throw an Exception when internal errors occur.

Definition at line 149 of file STDataLoader.cpp.

References te::st::TimeSeriesDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; 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: 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.; It can throw an Exception when internal errors occur.

Definition at line 297 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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

Returns: The spatial extent of the observations of a trajectory.

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.; It can throw an Exception when internal errors occur.

Definition at line 304 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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

Returns: The temporal extent of the observations.

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.; It will NOT take the ownership of the given pointer "info".; It can throw an Exception when internal errors occur.

Definition at line 276 of file STDataLoader.cpp.

References te::st::ObservationDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It will NOT take the ownership of the given pointer "info".; It can throw an Exception when internal errors occur.

Definition at line 283 of file STDataLoader.cpp.

References te::st::TrajectoryDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

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

static

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: 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.; It will NOT take the ownership of the given pointer "info".; It can throw an Exception when internal errors occur.

Definition at line 290 of file STDataLoader.cpp.

References te::st::TimeSeriesDataSetInfo::getDataSourceInfo(), and te::da::DataSourceInfo::getType().

void te::st::STDataLoader::initialize ( )

static

It returns the spatial extent of the observations of a coverage series.

Returns: The spatial extent of the observations of a coverage series.

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.; It can throw an Exception when internal errors occur.

It initialize the STDataLoader

It creates a ST Memory data source and adds it into the DataSourceManager.

Note: The user must use this method before using the other methods.; It can throw an Exception when internal errors occur.

Definition at line 310 of file STDataLoader.cpp.

References te::common::Singleton< DataSourceManager >::getInstance(), and te::st::Globals::sm_STMemoryDataSourceId.

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

/home/castejon/castejon_files/develop/terralib5/git/src/terralib/st/loader/STDataLoader.h
/home/castejon/castejon_files/develop/terralib5/git/src/terralib/st/loader/STDataLoader.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation