A class to manage Coordinate Systems representations within TerraLib environment. More...

#include <SpatialReferenceSystemManager.h>

Inheritance diagram for te::srs::SpatialReferenceSystemManager:

Classes
struct	srs_desc

Public Types
typedef boost::multi_index::nth_index< srs_set, 0 >::type::iterator	iterator
	An iterator by SRS <id,authority> More...

Public Member Functions
void	add (const std::string &name, const std::string &p4Txt, const std::string &wkt, unsigned int id, const std::string &authName)
	Adds a <id, authority> to the manager. More...

void	clear ()
	Removes all coordinate system representations from the manager. More...

std::pair< std::string, unsigned int >	getIdFromName (const std::string &name) const
	Returns a coordinate system identification given a name. More...

std::pair< std::string, unsigned int >	getIdFromP4Txt (const std::string &p4Txt) const
	Returns a coordinate system identification given a PROJ4 description. More...

std::pair< std::string, unsigned int >	getIdFromWkt (const std::string &wkt) const
	Returns a coordinate system identification given a WKT description. More...

std::pair< te::srs::SpatialReferenceSystemManager::iterator, te::srs::SpatialReferenceSystemManager::iterator >	getIterators () const
	Returns an iterator mechanism over the coordinate system descriptions in the manager. More...

std::string	getName (unsigned int id, const std::string &authName="") const
	Returns a coordinate system name given an identification. More...

int	getNewUserDefinedSRID ()
	Returns a SRID, not yet used, to identify an SRS created by an user. More...

std::string	getP4Txt (unsigned int id, const std::string &authName="") const
	Returns a coordinate system PROJ4 description given an identification. More...

SpatialReferenceSystemPtr	getSpatialReferenceSystem (unsigned int id, const std::string &authName="") const
	Returns a pointer to a coordinate system given an identification. More...

te::common::UnitOfMeasurePtr	getUnit (unsigned int id, const std::string &authName="")
	Returns the unit of measure for a SRS with a given id. More...

std::string	getWkt (unsigned int id, const std::string &authName="") const
	Returns a coordinate system WKT description given an id. More...

void	init ()
	Inializes the manager from a JSON file containing instances of SRSs. More...

void	init (const std::string &fileName)
	Inializes the manager from a JSON file containing instances of SRSs. More...

bool	isGeographic (unsigned int id, const std::string &authName="")
	Checks if a SRS with a given id refers to a geographic spatial reference system. More...

bool	isInitialized ()
	Returns true if the System Manager is already initialized. More...

bool	isValidNameID (const std::string &name)
	Returns true if there is a SRS with the given name. More...

bool	isValidP4TxtID (const std::string &p4Txt)
	Returns true if there is a SRS with the given proj string. More...

bool	isValidWktID (const std::string &wkt)
	Returns true if there is a SRS with the given WKT. More...

bool	recognizes (unsigned int id, const std::string &authName="") const
	Returns true is a pair <id, authority> is recognized by the manager. More...

void	remove (unsigned int id, const std::string &authName)
	Removes a coordinate system representation from the manager, given its identification. More...

size_t	size () const
	Returns the number of objects in the manager. More...

	~SpatialReferenceSystemManager ()
	Destructor. More...

Static Public Member Functions
static SpatialReferenceSystemManager &	getInstance ()
	It returns a reference to the singleton instance. More...

static std::string	getProjLibDir ()

Protected Member Functions
	SpatialReferenceSystemManager ()
	Constructor. More...

Private Types
typedef boost::multi_index_container< srs_desc, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< BOOST_MULTI_INDEX_CONST_MEM_FUN(srs_desc, std::string, srid)>, boost::multi_index::ordered_non_unique< BOOST_MULTI_INDEX_MEMBER(srs_desc, std::string, m_name)>, boost::multi_index::ordered_non_unique< BOOST_MULTI_INDEX_MEMBER(srs_desc, std::string, m_p4txt)>, boost::multi_index::ordered_non_unique< BOOST_MULTI_INDEX_MEMBER(srs_desc, std::string, m_wkt)>, boost::multi_index::ordered_non_unique< BOOST_MULTI_INDEX_MEMBER(srs_desc, std::string, m_auth_name)>, boost::multi_index::ordered_non_unique< BOOST_MULTI_INDEX_MEMBER(srs_desc, unsigned int, m_auth_id)> > >	srs_set

Private Member Functions
std::pair< std::string, unsigned int >	getIdFromP4TxtImpl (const std::string &p4Txt) const
	Returns a coordinate system identification given a PROJ4 description or a pair with an empty string if not found. More...

std::pair< std::string, unsigned int >	getIdFromWktImpl (const std::string &wkt) const
	Returns a coordinate system identification given a WKT description or a pair with an empty string if not found. More...

SpatialReferenceSystemManager &	operator= (const SpatialReferenceSystemManager &rhs)
	Assignment operator not allowed. More...

	SpatialReferenceSystemManager (const SpatialReferenceSystemManager &rhs)
	Copy constructor not allowed. More...

Private Attributes
std::map< int, te::common::UnitOfMeasurePtr >	m_cacheUnitOfMeasure

srs_set	m_set

Friends
class	te::common::Singleton< SpatialReferenceSystemManager >

Detailed Description

A class to manage Coordinate Systems representations within TerraLib environment.

A Coordinate System used to describe coordinates are also known as Spatial Reference System. It can be represented by either one of these properties:

A pair <id,authority>: a unique numeric id given by a particular authority;
A simple, human-readable, interface-friendly, name;
An OGC's WKT description;
A PROJ4 text: to support coordinate conversion.

Refer to the Spatial Reference website for more information about EPSG codes for SRS.

Definition at line 68 of file SpatialReferenceSystemManager.h.

Member Typedef Documentation

◆ iterator

typedef boost::multi_index::nth_index<srs_set,0>::type::iterator te::srs::SpatialReferenceSystemManager::iterator

An iterator by SRS <id,authority>

Definition at line 117 of file SpatialReferenceSystemManager.h.

◆ srs_set

typedef boost::multi_index_container< srs_desc, boost::multi_index::indexed_by< boost::multi_index::ordered_unique<BOOST_MULTI_INDEX_CONST_MEM_FUN(srs_desc,std::string,srid)>, boost::multi_index::ordered_non_unique<BOOST_MULTI_INDEX_MEMBER(srs_desc,std::string,m_name)>, boost::multi_index::ordered_non_unique<BOOST_MULTI_INDEX_MEMBER(srs_desc,std::string,m_p4txt)>, boost::multi_index::ordered_non_unique<BOOST_MULTI_INDEX_MEMBER(srs_desc,std::string,m_wkt)>, boost::multi_index::ordered_non_unique<BOOST_MULTI_INDEX_MEMBER(srs_desc,std::string,m_auth_name)>, boost::multi_index::ordered_non_unique<BOOST_MULTI_INDEX_MEMBER(srs_desc,unsigned int,m_auth_id)> > > te::srs::SpatialReferenceSystemManager::srs_set

private

A mult-index container with the following indexes: 0) an unique index by <auth_name, id>; 1) a non-unique index by name; 2) a non-unique index by p4txt; 3) a non-unique index by wkt; 4) a non-unique index by auth_name; 5) a non-unique index by m_auth_id;

Definition at line 107 of file SpatialReferenceSystemManager.h.

Constructor & Destructor Documentation

◆ ~SpatialReferenceSystemManager()

te::srs::SpatialReferenceSystemManager::~SpatialReferenceSystemManager ( )

Destructor.

◆ SpatialReferenceSystemManager() [1/2]

te::srs::SpatialReferenceSystemManager::SpatialReferenceSystemManager ( )

protected

Constructor.

◆ SpatialReferenceSystemManager() [2/2]

te::srs::SpatialReferenceSystemManager::SpatialReferenceSystemManager ( const SpatialReferenceSystemManager & rhs )

private

Copy constructor not allowed.

Parameters

rhs	The right-hand-side copy that would be used to copy from.

Member Function Documentation

◆ add()

void te::srs::SpatialReferenceSystemManager::add	(	const std::string &	name,
		const std::string &	p4Txt,
		const std::string &	wkt,
		unsigned int	id,
		const std::string &	authName
	)

Adds a <id, authority> to the manager.

Parameters

name	A simple, human-readable, interface-friendly, name;
p4Txt	a PROJ4 library description of coordinate system;
wkt	An OGC's WKT description for the coordinate system;
id	SRS id.
authName	The authority responsible for the id.

Exceptions

te::srs::Exception if the coordinate system id is already registered in the manager.

◆ clear()

void te::srs::SpatialReferenceSystemManager::clear ( )

Removes all coordinate system representations from the manager.

◆ getIdFromName()

std::pair< std::string, unsigned int > te::srs::SpatialReferenceSystemManager::getIdFromName ( const std::string & name ) const

Returns a coordinate system identification given a name.

Parameters

name	The coordinate system name.

Returns: A pair composed by the coordinate system identification and the name of the authority responsible for it.

Exceptions

te::srs::Exception if the coordinate system name is not found in the manager.

◆ getIdFromP4Txt()

std::pair< std::string, unsigned int > te::srs::SpatialReferenceSystemManager::getIdFromP4Txt ( const std::string & p4Txt ) const

Returns a coordinate system identification given a PROJ4 description.

Parameters

p4Txt The coordinate system PROJ4 description.

Returns: A pair composed by the coordinate system identification and the name of the authority responsible for it.

Exceptions

te::srs::Exception if the coordinate system PROJ4 description is not found in the manager.

◆ getIdFromP4TxtImpl()

std::pair< std::string, unsigned int > te::srs::SpatialReferenceSystemManager::getIdFromP4TxtImpl ( const std::string & p4Txt ) const

private

Returns a coordinate system identification given a PROJ4 description or a pair with an empty string if not found.

Parameters

p4Txt The coordinate system PROJ4 description.

Returns: Returns a coordinate system identification given a PROJ4 description or a pair with an empty string if not found.

Note: This function does not throw exceptions

◆ getIdFromWkt()

std::pair< std::string, unsigned int > te::srs::SpatialReferenceSystemManager::getIdFromWkt ( const std::string & wkt ) const

Returns a coordinate system identification given a WKT description.

Parameters

wkt	The coordinate system WKT.

Returns: A pair composed by the coordinate system identification and the name of the authority responsible for it.

Exceptions

te::srs::Exception if the coordinate system WKT is not found in the manager.

◆ getIdFromWktImpl()

std::pair< std::string, unsigned int > te::srs::SpatialReferenceSystemManager::getIdFromWktImpl ( const std::string & wkt ) const

private

Returns a coordinate system identification given a WKT description or a pair with an empty string if not found.

Parameters

wkt	The coordinate system WKT.

Returns: Returns a coordinate system identification given a WKT description or a pair with an empty string if not found.

Note: This function does not throw exceptions

◆ getInstance()

SpatialReferenceSystemManager & te::common::Singleton< SpatialReferenceSystemManager >::getInstance

inlinestaticinherited

It returns a reference to the singleton instance.

Returns: A reference to the singleton instance.

Definition at line 109 of file Singleton.h.

◆ getIterators()

std::pair< te::srs::SpatialReferenceSystemManager::iterator, te::srs::SpatialReferenceSystemManager::iterator > te::srs::SpatialReferenceSystemManager::getIterators ( ) const

Returns an iterator mechanism over the coordinate system descriptions in the manager.

The first iterator of the returned pair points to first coordinate system description. The second iterator of the returned pair points to the last plus one ccoordinate system description.

Returns: a pair of iterators pointing to the first and last coordnate system representation in the manager.

◆ getName()

std::string te::srs::SpatialReferenceSystemManager::getName	(	unsigned int	id,
		const std::string &	authName = `""`
	)		const

Returns a coordinate system name given an identification.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: the Coordinate System name if the identification is recognized or and empty string otherwise.

◆ getNewUserDefinedSRID()

int te::srs::SpatialReferenceSystemManager::getNewUserDefinedSRID ( )

Returns a SRID, not yet used, to identify an SRS created by an user.

Returns: a int represent a SRID, not yet used, to identify an SRS created by an user. Searches for the proj lib directory

◆ getP4Txt()

std::string te::srs::SpatialReferenceSystemManager::getP4Txt	(	unsigned int	id,
		const std::string &	authName = `""`
	)		const

Returns a coordinate system PROJ4 description given an identification.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: The coordinate system PROJ4 description if the identification is recognized or an empty string otherwise.

◆ getProjLibDir()

static std::string te::srs::SpatialReferenceSystemManager::getProjLibDir ( )

static

◆ getSpatialReferenceSystem()

SpatialReferenceSystemPtr te::srs::SpatialReferenceSystemManager::getSpatialReferenceSystem	(	unsigned int	id,
		const std::string &	authName = `""`
	)		const

Returns a pointer to a coordinate system given an identification.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: A pointer to a coordinate system if the identification is recognized or a null pointer otherwise. Caller is responsible for deleting the returned pointer.

◆ getUnit()

te::common::UnitOfMeasurePtr te::srs::SpatialReferenceSystemManager::getUnit	(	unsigned int	id,
		const std::string &	authName = `""`
	)

Returns the unit of measure for a SRS with a given id.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: A pointer to the unit of measure or a null pointer if it the SRS could not be founded.

◆ getWkt()

std::string te::srs::SpatialReferenceSystemManager::getWkt	(	unsigned int	id,
		const std::string &	authName = `""`
	)		const

Returns a coordinate system WKT description given an id.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: The coordinate system OGC WKT if the identification is recognized or an empty string otherwise.

◆ init() [1/2]

void te::srs::SpatialReferenceSystemManager::init ( )

Inializes the manager from a JSON file containing instances of SRSs.

This methods reads the file "TE_JSON_FILES_LOCATION/srs.json" for SRSs definitions and insert them on the manager if it is empty.

Exceptions

te::srs::Exception if the JSON file is not well formed.

◆ init() [2/2]

void te::srs::SpatialReferenceSystemManager::init ( const std::string & fileName )

Inializes the manager from a JSON file containing instances of SRSs.

Parameters

fileName Name of the JSON file.

Exceptions

te::srs::Exception if the JSON file is not well formed.

◆ isGeographic()

bool te::srs::SpatialReferenceSystemManager::isGeographic	(	unsigned int	id,
		const std::string &	authName = `""`
	)

Checks if a SRS with a given id refers to a geographic spatial reference system.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: True if the SRS with a given id refers to a geographic spatial reference system or false if not or not founded in the Manager.

◆ isInitialized()

bool te::srs::SpatialReferenceSystemManager::isInitialized ( )

Returns true if the System Manager is already initialized.

Returns: Returns true if the System Manager is already initialized.

◆ isValidNameID()

bool te::srs::SpatialReferenceSystemManager::isValidNameID ( const std::string & name )

Returns true if there is a SRS with the given name.

Returns: Returns true if there is a SRS with the given name.

◆ isValidP4TxtID()

bool te::srs::SpatialReferenceSystemManager::isValidP4TxtID ( const std::string & p4Txt )

Returns true if there is a SRS with the given proj string.

Returns: Returns true if there is a SRS with the given proj string.

◆ isValidWktID()

bool te::srs::SpatialReferenceSystemManager::isValidWktID ( const std::string & wkt )

Returns true if there is a SRS with the given WKT.

Returns: Returns true if there is a SRS with the given WKT.

◆ operator=()

SpatialReferenceSystemManager & te::srs::SpatialReferenceSystemManager::operator= ( const SpatialReferenceSystemManager & rhs )

private

Assignment operator not allowed.

Parameters

rhs	The right-hand-side copy that would be used to copy from.

Returns: A reference to this object.

◆ recognizes()

bool te::srs::SpatialReferenceSystemManager::recognizes	(	unsigned int	id,
		const std::string &	authName = `""`
	)		const

Returns true is a pair <id, authority> is recognized by the manager.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id or an empty string to match any authority.

Returns: True if the pair <id,authority> is already registered in the manager and false otherwise.

◆ remove()

void te::srs::SpatialReferenceSystemManager::remove	(	unsigned int	id,
		const std::string &	authName
	)

Removes a coordinate system representation from the manager, given its identification.

Parameters

id	The coordinate system identification.
authName	The authority responsible for the id.

◆ size()

size_t te::srs::SpatialReferenceSystemManager::size ( ) const

Returns the number of objects in the manager.

Friends And Related Function Documentation

◆ te::common::Singleton< SpatialReferenceSystemManager >

friend class te::common::Singleton< SpatialReferenceSystemManager >

friend

Definition at line 68 of file SpatialReferenceSystemManager.h.

Member Data Documentation

◆ m_cacheUnitOfMeasure

std::map<int, te::common::UnitOfMeasurePtr> te::srs::SpatialReferenceSystemManager::m_cacheUnitOfMeasure

private

Definition at line 112 of file SpatialReferenceSystemManager.h.

◆ m_set

srs_set te::srs::SpatialReferenceSystemManager::m_set

private

Definition at line 111 of file SpatialReferenceSystemManager.h.

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

/home/castejon/castejon_files/develop/terralib5/git_release/src/terralib/srs/SpatialReferenceSystemManager.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ iterator

◆ srs_set

Constructor & Destructor Documentation

◆ ~SpatialReferenceSystemManager()

◆ SpatialReferenceSystemManager() [1/2]

◆ SpatialReferenceSystemManager() [2/2]

Member Function Documentation

◆ add()

◆ clear()

◆ getIdFromName()

◆ getIdFromP4Txt()

◆ getIdFromP4TxtImpl()

◆ getIdFromWkt()

◆ getIdFromWktImpl()

◆ getInstance()

◆ getIterators()

◆ getName()

◆ getNewUserDefinedSRID()

◆ getP4Txt()

◆ getProjLibDir()

◆ getSpatialReferenceSystem()

◆ getUnit()

◆ getWkt()

◆ init() [1/2]

◆ init() [2/2]

◆ isGeographic()

◆ isInitialized()

◆ isValidNameID()

◆ isValidP4TxtID()

◆ isValidWktID()

◆ operator=()

◆ recognizes()

◆ remove()

◆ size()

Friends And Related Function Documentation

◆ te::common::Singleton< SpatialReferenceSystemManager >

Member Data Documentation

◆ m_cacheUnitOfMeasure

◆ m_set