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

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

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

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

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

static std::auto_ptr< TimeSeriesDataSet > getDataSet (const TimeSeriesDataSetInfo &info, const te::gm::Geometry &geom, te::gm::SpatialRelation r=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. More...

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

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

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

Static Public Attributes
static bool	sm_STDataLoaderInitialized
	Indictes if the st data loader support was initialized. 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

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

virtual

Virtual destructor.

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

protected

Protected constructor.

Member Function Documentation

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

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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.
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.

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

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 temporal relations are:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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.

static std::auto_ptr<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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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: 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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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.

static std::auto_ptr<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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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: 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.

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

static

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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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.

static std::auto_ptr<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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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: 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.

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

static std::auto_ptr<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:

BEFORE; 2. AFTER; 3. DURING; 4. EQUALS;
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: 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.

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

static

It returns patches of a timeseries 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.

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

static

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.

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

static

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.

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

static

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.

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

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

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

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

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

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

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

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

Member Data Documentation

bool te::st::STDataLoader::sm_STDataLoaderInitialized

static

Indictes if the st data loader support was initialized.

Definition at line 816 of file STDataLoader.h.

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

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

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation