Map2DStorage: A device capable of read/save collections of maps from disk, and make them accessible to any Map2DClient device. More...

#include <map2DStorage/Map2DStorage.h>

Inheritance diagram for Map2DStorage:

Public Member Functions
	Map2DStorage ()
	Map2DStorage.

	~Map2DStorage ()

bool	open (yarp::os::Searchable &params) override
	Open the DeviceDriver.

bool	close () override
	Close the DeviceDriver.

yarp::dev::ReturnValue	clearAllMaps () override
	Removes all the registered maps from the server.

yarp::dev::ReturnValue	store_map (const yarp::dev::Nav2D::MapGrid2D &map) override
	Stores a map into the map server.

yarp::dev::ReturnValue	get_map (std::string map_name, yarp::dev::Nav2D::MapGrid2D &map) override
	Gets a map from the map server.

yarp::dev::ReturnValue	get_map_names (std::vector< std::string > &map_names) override
	Gets a list containing the names of all registered maps.

yarp::dev::ReturnValue	remove_map (std::string map_name) override
	Removes a map from the map server.

yarp::dev::ReturnValue	storeLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation loc) override
	Store a location specified by the user in the world reference frame.

yarp::dev::ReturnValue	storeArea (std::string area_name, yarp::dev::Nav2D::Map2DArea area) override
	Store an area.

yarp::dev::ReturnValue	storePath (std::string path_name, yarp::dev::Nav2D::Map2DPath path) override
	Store a path.

yarp::dev::ReturnValue	getLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation &loc) override
	Retrieves a location specified by the user in the world reference frame.

yarp::dev::ReturnValue	getArea (std::string area_name, yarp::dev::Nav2D::Map2DArea &area) override
	Retrieves an area.

yarp::dev::ReturnValue	getPath (std::string path_name, yarp::dev::Nav2D::Map2DPath &path) override
	Retrieves a path.

yarp::dev::ReturnValue	getLocationsList (std::vector< std::string > &locations) override
	Get a list of the names of all stored locations.

yarp::dev::ReturnValue	getAreasList (std::vector< std::string > &areas) override
	Get a list of the names of all stored areas.

yarp::dev::ReturnValue	getPathsList (std::vector< std::string > &paths) override
	Get a list of the names of all stored paths.

yarp::dev::ReturnValue	getAllLocations (std::vector< yarp::dev::Nav2D::Map2DLocation > &locations) override
	Get a list of all stored locations.

yarp::dev::ReturnValue	getAllAreas (std::vector< yarp::dev::Nav2D::Map2DArea > &areas) override
	Get a list of all stored areas.

yarp::dev::ReturnValue	getAllPaths (std::vector< yarp::dev::Nav2D::Map2DPath > &paths) override
	Get a list of all stored paths.

yarp::dev::ReturnValue	renameLocation (std::string original_name, std::string new_name) override
	Searches for a location and renames it.

yarp::dev::ReturnValue	deleteLocation (std::string location_name) override
	Delete a location.

yarp::dev::ReturnValue	deletePath (std::string path_name) override
	Delete a path.

yarp::dev::ReturnValue	renameArea (std::string original_name, std::string new_name) override
	Searches for an area and renames it.

yarp::dev::ReturnValue	renamePath (std::string original_name, std::string new_name) override
	Searches for a path and renames it.

yarp::dev::ReturnValue	deleteArea (std::string area_name) override
	Delete an area.

yarp::dev::ReturnValue	clearAllLocations () override
	Delete all stored locations.

yarp::dev::ReturnValue	clearAllAreas () override
	Delete all stored areas.

yarp::dev::ReturnValue	clearAllPaths () override
	Delete all stored paths.

yarp::dev::ReturnValue	clearAllMapsTemporaryFlags () override
	Clear all temporary flags from all stored maps.

yarp::dev::ReturnValue	clearMapTemporaryFlags (std::string map_name) override
	Clear all temporary flags from a specific map.

yarp::dev::ReturnValue	saveMapToDisk (std::string map_name, std::string file_name) override
	Save a map to disk.

yarp::dev::ReturnValue	loadMapFromDisk (std::string file_name) override
	Load a map from disk.

yarp::dev::ReturnValue	saveMapsCollection (std::string maps_collection_file) override
	Save a collection of maps to disk.

yarp::dev::ReturnValue	loadMapsCollection (std::string maps_collection_file) override
	Load a collection of maps from disk.

yarp::dev::ReturnValue	loadLocationsAndExtras (std::string locations_file) override
	Load a collection of locations/areas/paths etc from disk.

yarp::dev::ReturnValue	saveLocationsAndExtras (std::string locations_file) override
	Save a collection of locations/area/paths etc to disk.

yarp::dev::ReturnValue	enableMapsCompression (bool enable) override
	Enable/disables maps compression over the network.

Public Member Functions inherited from yarp::dev::DeviceDriver
	DeviceDriver ()

	DeviceDriver (const DeviceDriver &other)=delete

	DeviceDriver (DeviceDriver &&other) noexcept=delete

DeviceDriver &	operator= (const DeviceDriver &other)=delete

DeviceDriver &	operator= (DeviceDriver &&other) noexcept=delete

virtual	~DeviceDriver ()

virtual std::string	id () const
	Return the id assigned to the PolyDriver.

virtual void	setId (const std::string &id)
	Set the id for this device.

template<class T >
bool	view (T *&x)
	Get an interface to the device driver.

virtual DeviceDriver *	getImplementation ()
	Some drivers are bureaucrats, pointing at others.

Public Member Functions inherited from yarp::os::PortReader
virtual	~PortReader ()
	Destructor.

virtual Type	getReadType () const

Public Member Functions inherited from yarp::dev::Nav2D::IMap2D
virtual	~IMap2D ()
	Destructor.

Public Member Functions inherited from Map2DStorage_ParamsParser
	Map2DStorage_ParamsParser ()

	~Map2DStorage_ParamsParser () override=default

bool	parseParams (const yarp::os::Searchable &config) override
	Parse the DeviceDriver parameters.

std::string	getDeviceClassName () const override
	Get the name of the DeviceDriver class.

std::string	getDeviceName () const override
	Get the name of the device (i.e.

std::string	getDocumentationOfDeviceParams () const override
	Get the documentation of the DeviceDriver's parameters.

std::vector< std::string >	getListOfParams () const override
	Return a list of all params used by the device.

Public Member Functions inherited from yarp::dev::IDeviceDriverParams
virtual	~IDeviceDriverParams ()

Additional Inherited Members
Public Attributes inherited from Map2DStorage_ParamsParser
const std::string	m_device_classname = {"Map2DStorage"}

const std::string	m_device_name = {"map2DStorage"}

bool	m_parser_is_strict = false

const parser_version_type	m_parser_version = {}

const std::string	m_name_defaultValue = {"/map2DStorage/rpc"}

const std::string	m_mapCollectionContext_defaultValue = {""}

const std::string	m_mapCollectionFile_defaultValue = {"maps_collection.ini"}

const std::string	m_mapLocationsFile_defaultValue = {"locations.ini"}

std::string	m_name = {"/map2DStorage/rpc"}

std::string	m_mapCollectionContext = {}

std::string	m_mapCollectionFile = {"maps_collection.ini"}

std::string	m_mapLocationsFile = {"locations.ini"}

Detailed Description

Map2DStorage: A device capable of read/save collections of maps from disk, and make them accessible to any Map2DClient device.

Map2DStorage

Parameters required by this device are shown in class: Map2DStorage_ParamsParser

Definition at line 50 of file Map2DStorage.h.

Constructor & Destructor Documentation

◆ Map2DStorage()

Map2DStorage::Map2DStorage ( )

Map2DStorage.

Definition at line 33 of file Map2DStorage.cpp.

◆ ~Map2DStorage()

Map2DStorage::~Map2DStorage ( )

default

Member Function Documentation

◆ clearAllAreas()

ReturnValue Map2DStorage::clearAllAreas ( )

overridevirtual

Delete all stored areas.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 981 of file Map2DStorage.cpp.

◆ clearAllLocations()

ReturnValue Map2DStorage::clearAllLocations ( )

overridevirtual

Delete all stored locations.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 975 of file Map2DStorage.cpp.

◆ clearAllMaps()

ReturnValue Map2DStorage::clearAllMaps ( )

overridevirtual

Removes all the registered maps from the server.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 714 of file Map2DStorage.cpp.

◆ clearAllMapsTemporaryFlags()

ReturnValue Map2DStorage::clearAllMapsTemporaryFlags ( )

overridevirtual

Clear all temporary flags from all stored maps.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 993 of file Map2DStorage.cpp.

◆ clearAllPaths()

ReturnValue Map2DStorage::clearAllPaths ( )

overridevirtual

Delete all stored paths.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 987 of file Map2DStorage.cpp.

◆ clearMapTemporaryFlags()

ReturnValue Map2DStorage::clearMapTemporaryFlags ( std::string map_name )

overridevirtual

Clear all temporary flags from a specific map.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 1002 of file Map2DStorage.cpp.

◆ close()

bool Map2DStorage::close ( )

overridevirtual

Close the DeviceDriver.

Returns: true/false on success/failure.

Reimplemented from yarp::dev::DeviceDriver.

Definition at line 239 of file Map2DStorage.cpp.

◆ deleteArea()

ReturnValue Map2DStorage::deleteArea ( std::string area_name )

overridevirtual

Delete an area.

Parameters

area_name the name of the area

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 911 of file Map2DStorage.cpp.

◆ deleteLocation()

ReturnValue Map2DStorage::deleteLocation ( std::string location_name )

overridevirtual

Delete a location.

Parameters

location_name the name of the location

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 899 of file Map2DStorage.cpp.

◆ deletePath()

ReturnValue Map2DStorage::deletePath ( std::string path_name )

overridevirtual

Delete a path.

Parameters

path_name the name of the path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 923 of file Map2DStorage.cpp.

◆ enableMapsCompression()

ReturnValue Map2DStorage::enableMapsCompression ( bool enable )

overridevirtual

Enable/disables maps compression over the network.

Parameters

enable

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 1104 of file Map2DStorage.cpp.

◆ get_map()

ReturnValue Map2DStorage::get_map	(	std::string	map_name,
		yarp::dev::Nav2D::MapGrid2D &	map
	)

overridevirtual

Gets a map from the map server.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 737 of file Map2DStorage.cpp.

◆ get_map_names()

ReturnValue Map2DStorage::get_map_names ( std::vector< std::string > & map_names )

overridevirtual

Gets a list containing the names of all registered maps.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 748 of file Map2DStorage.cpp.

◆ getAllAreas()

ReturnValue Map2DStorage::getAllAreas ( std::vector< yarp::dev::Nav2D::Map2DArea > & areas )

overridevirtual

Get a list of all stored areas.

Parameters

the	returned list of areas

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 862 of file Map2DStorage.cpp.

◆ getAllLocations()

ReturnValue Map2DStorage::getAllLocations ( std::vector< yarp::dev::Nav2D::Map2DLocation > & locations )

overridevirtual

Get a list of all stored locations.

Parameters

the	returned list of locations

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 852 of file Map2DStorage.cpp.

◆ getAllPaths()

ReturnValue Map2DStorage::getAllPaths ( std::vector< yarp::dev::Nav2D::Map2DPath > & paths )

overridevirtual

Get a list of all stored paths.

Parameters

the	returned list of paths

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 871 of file Map2DStorage.cpp.

◆ getArea()

ReturnValue Map2DStorage::getArea	(	std::string	area_name,
		yarp::dev::Nav2D::Map2DArea &	area
	)

overridevirtual

Retrieves an area.

Parameters

area_name	the name of the area
area	the area

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 800 of file Map2DStorage.cpp.

◆ getAreasList()

ReturnValue Map2DStorage::getAreasList ( std::vector< std::string > & areas )

overridevirtual

Get a list of the names of all stored areas.

Parameters

the	returned list of areas names

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 832 of file Map2DStorage.cpp.

◆ getLocation()

ReturnValue Map2DStorage::getLocation	(	std::string	location_name,
		yarp::dev::Nav2D::Map2DLocation &	loc
	)

overridevirtual

Retrieves a location specified by the user in the world reference frame.

Parameters

location_name	the name of the location
loc	the location

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 789 of file Map2DStorage.cpp.

◆ getLocationsList()

ReturnValue Map2DStorage::getLocationsList ( std::vector< std::string > & locations )

overridevirtual

Get a list of the names of all stored locations.

Parameters

the	returned list of locations names

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 822 of file Map2DStorage.cpp.

◆ getPath()

ReturnValue Map2DStorage::getPath	(	std::string	path_name,
		yarp::dev::Nav2D::Map2DPath &	path
	)

overridevirtual

Retrieves a path.

Parameters

path_name	the name of the path
path	the path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 811 of file Map2DStorage.cpp.

◆ getPathsList()

ReturnValue Map2DStorage::getPathsList ( std::vector< std::string > & paths )

overridevirtual

Get a list of the names of all stored paths.

Parameters

the	returned list of paths names

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 842 of file Map2DStorage.cpp.

◆ loadLocationsAndExtras()

ReturnValue Map2DStorage::loadLocationsAndExtras ( std::string file_name )

overridevirtual

Load a collection of locations/areas/paths etc from disk.

Parameters

file_name file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 576 of file Map2DStorage.cpp.

◆ loadMapFromDisk()

ReturnValue Map2DStorage::loadMapFromDisk ( std::string file_name )

overridevirtual

Load a map from disk.

Parameters

file_name file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 1076 of file Map2DStorage.cpp.

◆ loadMapsCollection()

ReturnValue Map2DStorage::loadMapsCollection ( std::string file_name )

overridevirtual

Load a collection of maps from disk.

Parameters

file_name file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 80 of file Map2DStorage.cpp.

◆ open()

bool Map2DStorage::open ( yarp::os::Searchable & config )

overridevirtual

Open the DeviceDriver.

Parameters

config is a list of parameters for the device. Which parameters are effective for your device can vary. See device invocation examples. If there is no example for your device, you can run the "yarpdev" program with the verbose flag set to probe what parameters the device is checking. If that fails too, you'll need to read the source code (please nag one of the yarp developers to add documentation for your device).

Returns: true/false upon success/failure

Reimplemented from yarp::dev::DeviceDriver.

Definition at line 150 of file Map2DStorage.cpp.

◆ remove_map()

ReturnValue Map2DStorage::remove_map ( std::string map_name )

overridevirtual

Removes a map from the map server.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 758 of file Map2DStorage.cpp.

◆ renameArea()

ReturnValue Map2DStorage::renameArea	(	std::string	original_name,
		std::string	new_name
	)

overridevirtual

Searches for an area and renames it.

Parameters

original_name	the name of the area
new_name	the new name of the area

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 935 of file Map2DStorage.cpp.

◆ renameLocation()

ReturnValue Map2DStorage::renameLocation	(	std::string	original_name,
		std::string	new_name
	)

overridevirtual

Searches for a location and renames it.

Parameters

original_name	the name of the area
new_name	the new name of the area

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 881 of file Map2DStorage.cpp.

◆ renamePath()

ReturnValue Map2DStorage::renamePath	(	std::string	original_name,
		std::string	new_name
	)

overridevirtual

Searches for a path and renames it.

Parameters

original_name	the name of the path
new_name	the new name of the path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 954 of file Map2DStorage.cpp.

◆ saveLocationsAndExtras()

ReturnValue Map2DStorage::saveLocationsAndExtras ( std::string file_name )

overridevirtual

Save a collection of locations/area/paths etc to disk.

Parameters

file_name file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 642 of file Map2DStorage.cpp.

◆ saveMapsCollection()

ReturnValue Map2DStorage::saveMapsCollection ( std::string file_name )

overridevirtual

Save a collection of maps to disk.

Parameters

file_name file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 39 of file Map2DStorage.cpp.

◆ saveMapToDisk()

ReturnValue Map2DStorage::saveMapToDisk	(	std::string	map_name,
		std::string	file_name
	)

overridevirtual

Save a map to disk.

Parameters

map_name	the name of the area
file_name	file name with full path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 1051 of file Map2DStorage.cpp.

◆ store_map()

ReturnValue Map2DStorage::store_map ( const yarp::dev::Nav2D::MapGrid2D & map )

overridevirtual

Stores a map into the map server.

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 720 of file Map2DStorage.cpp.

◆ storeArea()

ReturnValue Map2DStorage::storeArea	(	std::string	area_name,
		yarp::dev::Nav2D::Map2DArea	area
	)

overridevirtual

Store an area.

Parameters

area_name	the name of the area
area	the area

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 777 of file Map2DStorage.cpp.

◆ storeLocation()

ReturnValue Map2DStorage::storeLocation	(	std::string	location_name,
		yarp::dev::Nav2D::Map2DLocation	loc
	)

overridevirtual

Store a location specified by the user in the world reference frame.

Parameters

location_name	the name of the location
loc	the location of the robot

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 771 of file Map2DStorage.cpp.

◆ storePath()

ReturnValue Map2DStorage::storePath	(	std::string	path_name,
		yarp::dev::Nav2D::Map2DPath	path
	)

overridevirtual

Store a path.

Parameters

path_name	the name of the path
path	the path

Returns: a ReturnValue, convertible to true/false

Implements yarp::dev::Nav2D::IMap2D.

Definition at line 783 of file Map2DStorage.cpp.

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

src/devices/map2DStorage/Map2DStorage.h
src/devices/map2DStorage/Map2DStorage.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Map2DStorage

Constructor & Destructor Documentation

◆ Map2DStorage()

◆ ~Map2DStorage()

Member Function Documentation

◆ clearAllAreas()

◆ clearAllLocations()

◆ clearAllMaps()

◆ clearAllMapsTemporaryFlags()

◆ clearAllPaths()

◆ clearMapTemporaryFlags()

◆ close()

◆ deleteArea()

◆ deleteLocation()

◆ deletePath()

◆ enableMapsCompression()

◆ get_map()

◆ get_map_names()

◆ getAllAreas()

◆ getAllLocations()

◆ getAllPaths()

◆ getArea()

◆ getAreasList()

◆ getLocation()

◆ getLocationsList()

◆ getPath()

◆ getPathsList()

◆ loadLocationsAndExtras()

◆ loadMapFromDisk()

◆ loadMapsCollection()

◆ open()

◆ remove_map()

◆ renameArea()

◆ renameLocation()

◆ renamePath()

◆ saveLocationsAndExtras()

◆ saveMapsCollection()

◆ saveMapToDisk()

◆ store_map()

◆ storeArea()

◆ storeLocation()

◆ storePath()