YARP
Yet Another Robot Platform

Map2D_nwc_yarp: A device which allows a client application to store/retrieve user maps device in a map server. More...

#include <map2D_nwc_yarp/Map2D_nwc_yarp.h>

+ Inheritance diagram for Map2D_nwc_yarp:

Public Member Functions

bool open (yarp::os::Searchable &config) override
 Open the DeviceDriver. More...
 
bool close () override
 Close the DeviceDriver. More...
 
bool clearAllMaps () override
 Removes all the registered maps from the server. More...
 
bool remove_map (std::string map_name) override
 Removes a map from the map server. More...
 
bool store_map (const yarp::dev::Nav2D::MapGrid2D &map) override
 Stores a map into the map server. More...
 
bool get_map (std::string map_name, yarp::dev::Nav2D::MapGrid2D &map) override
 Gets a map from the map server. More...
 
bool get_map_names (std::vector< std::string > &map_names) override
 Gets a list containing the names of all registered maps. More...
 
bool storeLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation loc) override
 Store a location specified by the user in the world reference frame. More...
 
bool storeArea (std::string area_name, yarp::dev::Nav2D::Map2DArea area) override
 Store an area. More...
 
bool storePath (std::string path_name, yarp::dev::Nav2D::Map2DPath path) override
 Store a path. More...
 
bool getLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation &loc) override
 Retrieves a location specified by the user in the world reference frame. More...
 
bool getArea (std::string location_name, yarp::dev::Nav2D::Map2DArea &area) override
 Retrieves an area. More...
 
bool getPath (std::string path_name, yarp::dev::Nav2D::Map2DPath &path) override
 Retrieves a path. More...
 
bool renameLocation (std::string original_name, std::string new_name) override
 Searches for a location and renames it. More...
 
bool renameArea (std::string original_name, std::string new_name) override
 Searches for an area and renames it. More...
 
bool renamePath (std::string original_name, std::string new_name) override
 Searches for a path and renames it. More...
 
bool deleteLocation (std::string location_name) override
 Delete a location. More...
 
bool deleteArea (std::string location_name) override
 Delete an area. More...
 
bool deletePath (std::string path_name) override
 Delete a path. More...
 
bool getLocationsList (std::vector< std::string > &locations) override
 Get a list of the names of all stored locations. More...
 
bool getAreasList (std::vector< std::string > &locations) override
 Get a list of the names of all stored areas. More...
 
bool getPathsList (std::vector< std::string > &paths) override
 Get a list of the names of all stored paths. More...
 
bool getAllLocations (std::vector< yarp::dev::Nav2D::Map2DLocation > &locations) override
 Get a list of all stored locations. More...
 
bool getAllAreas (std::vector< yarp::dev::Nav2D::Map2DArea > &areas) override
 Get a list of all stored areas. More...
 
bool getAllPaths (std::vector< yarp::dev::Nav2D::Map2DPath > &paths) override
 Get a list of all stored paths. More...
 
bool clearAllLocations () override
 Delete all stored locations. More...
 
bool clearAllAreas () override
 Delete all stored areas. More...
 
bool clearAllPaths () override
 Delete all stored paths. More...
 
bool clearAllMapsTemporaryFlags () override
 Clear all temporary flags from all stored maps. More...
 
bool clearMapTemporaryFlags (std::string map_name) override
 Clear all temporary flags from a specific map. More...
 
bool saveMapsCollection (std::string maps_collection_file) override
 Save a collection of maps to disk. More...
 
bool loadMapsCollection (std::string maps_collection_file) override
 Load a collection of maps from disk. More...
 
bool saveLocationsAndExtras (std::string locations_collection_file) override
 Save a collection of locations/area/paths etc to disk. More...
 
bool loadLocationsAndExtras (std::string locations_collection_file) override
 Load a collection of locations/areas/paths etc from disk. More...
 
bool saveMapToDisk (std::string map_name, std::string file_name) override
 Save a map to disk. More...
 
bool loadMapFromDisk (std::string file_name) override
 Load a map from disk. More...
 
bool enableMapsCompression (bool enable) override
 99999999999 More...
 
- Public Member Functions inherited from yarp::dev::DeviceDriver
 DeviceDriver ()
 
 DeviceDriver (const DeviceDriver &other)=delete
 
 DeviceDriver (DeviceDriver &&other) noexcept=delete
 
DeviceDriveroperator= (const DeviceDriver &other)=delete
 
DeviceDriveroperator= (DeviceDriver &&other) noexcept=delete
 
 ~DeviceDriver () override
 
bool open (yarp::os::Searchable &config) override
 Open the DeviceDriver. More...
 
bool close () override
 Close the DeviceDriver. More...
 
virtual std::string id () const
 Return the id assigned to the PolyDriver. More...
 
virtual void setId (const std::string &id)
 Set the id for this device. More...
 
template<class T >
bool view (T *&x)
 Get an interface to the device driver. More...
 
virtual DeviceDrivergetImplementation ()
 Some drivers are bureaucrats, pointing at others. More...
 
- Public Member Functions inherited from yarp::os::IConfig
virtual ~IConfig ()
 Destructor. More...
 
virtual bool open (Searchable &config)
 Initialize the object. More...
 
virtual bool close ()
 Shut the object down. More...
 
virtual bool configure (Searchable &config)
 Change online parameters. More...
 
- Public Member Functions inherited from yarp::dev::Nav2D::IMap2D
virtual ~IMap2D ()
 Destructor. More...
 
virtual bool clearAllMaps ()=0
 Removes all the registered maps from the server. More...
 
virtual bool store_map (const yarp::dev::Nav2D::MapGrid2D &map)=0
 Stores a map into the map server. More...
 
virtual bool get_map (std::string map_name, yarp::dev::Nav2D::MapGrid2D &map)=0
 Gets a map from the map server. More...
 
virtual bool get_map_names (std::vector< std::string > &map_names)=0
 Gets a list containing the names of all registered maps. More...
 
virtual bool remove_map (std::string map_name)=0
 Removes a map from the map server. More...
 
virtual bool storeLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation loc)=0
 Store a location specified by the user in the world reference frame. More...
 
virtual bool storeArea (std::string area_name, yarp::dev::Nav2D::Map2DArea area)=0
 Store an area. More...
 
virtual bool storePath (std::string path_name, yarp::dev::Nav2D::Map2DPath path)=0
 Store a path. More...
 
virtual bool getLocation (std::string location_name, yarp::dev::Nav2D::Map2DLocation &loc)=0
 Retrieves a location specified by the user in the world reference frame. More...
 
virtual bool getArea (std::string area_name, yarp::dev::Nav2D::Map2DArea &area)=0
 Retrieves an area. More...
 
virtual bool getPath (std::string path_name, yarp::dev::Nav2D::Map2DPath &path)=0
 Retrieves a path. More...
 
virtual bool getLocationsList (std::vector< std::string > &locations)=0
 Get a list of the names of all stored locations. More...
 
virtual bool getAreasList (std::vector< std::string > &areas)=0
 Get a list of the names of all stored areas. More...
 
virtual bool getPathsList (std::vector< std::string > &paths)=0
 Get a list of the names of all stored paths. More...
 
virtual bool getAllLocations (std::vector< yarp::dev::Nav2D::Map2DLocation > &locations)=0
 Get a list of all stored locations. More...
 
virtual bool getAllAreas (std::vector< yarp::dev::Nav2D::Map2DArea > &areas)=0
 Get a list of all stored areas. More...
 
virtual bool getAllPaths (std::vector< yarp::dev::Nav2D::Map2DPath > &paths)=0
 Get a list of all stored paths. More...
 
virtual bool renameLocation (std::string original_name, std::string new_name)=0
 Searches for a location and renames it. More...
 
virtual bool deleteLocation (std::string location_name)=0
 Delete a location. More...
 
virtual bool deletePath (std::string path_name)=0
 Delete a path. More...
 
virtual bool renameArea (std::string original_name, std::string new_name)=0
 Searches for an area and renames it. More...
 
virtual bool renamePath (std::string original_name, std::string new_name)=0
 Searches for a path and renames it. More...
 
virtual bool deleteArea (std::string area_name)=0
 Delete an area. More...
 
virtual bool clearAllLocations ()=0
 Delete all stored locations. More...
 
virtual bool clearAllAreas ()=0
 Delete all stored areas. More...
 
virtual bool clearAllPaths ()=0
 Delete all stored paths. More...
 
virtual bool clearAllMapsTemporaryFlags ()=0
 Clear all temporary flags from all stored maps. More...
 
virtual bool clearMapTemporaryFlags (std::string map_name)=0
 Clear all temporary flags from a specific map. More...
 
virtual bool saveMapToDisk (std::string map_name, std::string file_name)=0
 Save a map to disk. More...
 
virtual bool loadMapFromDisk (std::string file_name)=0
 Load a map from disk. More...
 
virtual bool saveMapsCollection (std::string file_name)=0
 Save a collection of maps to disk. More...
 
virtual bool loadMapsCollection (std::string file_name)=0
 Load a collection of maps from disk. More...
 
virtual bool saveLocationsAndExtras (std::string file_name)=0
 Save a collection of locations/area/paths etc to disk. More...
 
virtual bool loadLocationsAndExtras (std::string file_name)=0
 Load a collection of locations/areas/paths etc from disk. More...
 
virtual bool enableMapsCompression (bool enable)=0
 99999999999 More...
 

Protected Attributes

yarp::os::Port m_rpcPort_to_Map2D_nws
 
std::string m_local_name
 
std::string m_map_server
 
std::string m_carrier
 
IMap2DMsgs m_map_RPC
 
std::mutex m_mutex
 

Detailed Description

Map2D_nwc_yarp: A device which allows a client application to store/retrieve user maps device in a map server.

Map2D_nwc_yarp

Parameters required by this device are:

Parameter name SubParameter Type Units Default Value Required Description Notes
local - string - - Yes Full port name opened by the Map2D_nwc_yarp device.
remote - string - - Yes Full port name of the port remotely opened by the Map2D_nws_yarp, to which the Map2D_nwc_yarp connects to.
carrier - string - tcp No The carier used for the connection with the server.

Definition at line 37 of file Map2D_nwc_yarp.h.

Member Function Documentation

◆ clearAllAreas()

bool Map2D_nwc_yarp::clearAllAreas ( )
overridevirtual

Delete all stored areas.

Returns
true/false

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

Definition at line 297 of file Map2D_nwc_yarp.cpp.

◆ clearAllLocations()

bool Map2D_nwc_yarp::clearAllLocations ( )
overridevirtual

Delete all stored locations.

Returns
true/false

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

Definition at line 291 of file Map2D_nwc_yarp.cpp.

◆ clearAllMaps()

bool Map2D_nwc_yarp::clearAllMaps ( )
overridevirtual

Removes all the registered maps from the server.

Returns
true/false

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

Definition at line 95 of file Map2D_nwc_yarp.cpp.

◆ clearAllMapsTemporaryFlags()

bool Map2D_nwc_yarp::clearAllMapsTemporaryFlags ( )
overridevirtual

Clear all temporary flags from all stored maps.

Returns
true/false

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

Definition at line 303 of file Map2D_nwc_yarp.cpp.

◆ clearAllPaths()

bool Map2D_nwc_yarp::clearAllPaths ( )
overridevirtual

Delete all stored paths.

Returns
true/false

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

Definition at line 315 of file Map2D_nwc_yarp.cpp.

◆ clearMapTemporaryFlags()

bool Map2D_nwc_yarp::clearMapTemporaryFlags ( std::string  map_name)
overridevirtual

Clear all temporary flags from a specific map.

Returns
true/false

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

Definition at line 309 of file Map2D_nwc_yarp.cpp.

◆ close()

bool Map2D_nwc_yarp::close ( )
overridevirtual

Close the DeviceDriver.

Returns
true/false on success/failure.

Reimplemented from yarp::dev::DeviceDriver.

Definition at line 321 of file Map2D_nwc_yarp.cpp.

◆ deleteArea()

bool Map2D_nwc_yarp::deleteArea ( std::string  area_name)
overridevirtual

Delete an area.

Parameters
area_namethe name of the area
Returns
true/false

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

Definition at line 267 of file Map2D_nwc_yarp.cpp.

◆ deleteLocation()

bool Map2D_nwc_yarp::deleteLocation ( std::string  location_name)
overridevirtual

Delete a location.

Parameters
location_namethe name of the location
Returns
true/false

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

Definition at line 255 of file Map2D_nwc_yarp.cpp.

◆ deletePath()

bool Map2D_nwc_yarp::deletePath ( std::string  path_name)
overridevirtual

Delete a path.

Parameters
path_namethe name of the path
Returns
true/false

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

Definition at line 273 of file Map2D_nwc_yarp.cpp.

◆ enableMapsCompression()

bool Map2D_nwc_yarp::enableMapsCompression ( bool  enable)
overridevirtual

99999999999

Parameters
enable
Returns
true/false

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

Definition at line 362 of file Map2D_nwc_yarp.cpp.

◆ get_map()

bool Map2D_nwc_yarp::get_map ( std::string  map_name,
yarp::dev::Nav2D::MapGrid2D map 
)
overridevirtual

Gets a map from the map server.

Returns
true/false

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

Definition at line 82 of file Map2D_nwc_yarp.cpp.

◆ get_map_names()

bool Map2D_nwc_yarp::get_map_names ( std::vector< std::string > &  map_names)
overridevirtual

Gets a list containing the names of all registered maps.

Returns
true/false

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

Definition at line 101 of file Map2D_nwc_yarp.cpp.

◆ getAllAreas()

bool Map2D_nwc_yarp::getAllAreas ( std::vector< yarp::dev::Nav2D::Map2DArea > &  areas)
overridevirtual

Get a list of all stored areas.

Parameters
thereturned list of areas
Returns
true/false

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

Definition at line 190 of file Map2D_nwc_yarp.cpp.

◆ getAllLocations()

bool Map2D_nwc_yarp::getAllLocations ( std::vector< yarp::dev::Nav2D::Map2DLocation > &  locations)
overridevirtual

Get a list of all stored locations.

Parameters
thereturned list of locations
Returns
true/false

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

Definition at line 177 of file Map2D_nwc_yarp.cpp.

◆ getAllPaths()

bool Map2D_nwc_yarp::getAllPaths ( std::vector< yarp::dev::Nav2D::Map2DPath > &  paths)
overridevirtual

Get a list of all stored paths.

Parameters
thereturned list of paths
Returns
true/false

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

Definition at line 203 of file Map2D_nwc_yarp.cpp.

◆ getArea()

bool Map2D_nwc_yarp::getArea ( std::string  area_name,
yarp::dev::Nav2D::Map2DArea area 
)
overridevirtual

Retrieves an area.

Parameters
area_namethe name of the area
areathe area
Returns
true/false

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

Definition at line 229 of file Map2D_nwc_yarp.cpp.

◆ getAreasList()

bool Map2D_nwc_yarp::getAreasList ( std::vector< std::string > &  areas)
overridevirtual

Get a list of the names of all stored areas.

Parameters
thereturned list of areas names
Returns
true/false

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

Definition at line 151 of file Map2D_nwc_yarp.cpp.

◆ getLocation()

bool Map2D_nwc_yarp::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_namethe name of the location
locthe location
Returns
true/false

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

Definition at line 216 of file Map2D_nwc_yarp.cpp.

◆ getLocationsList()

bool Map2D_nwc_yarp::getLocationsList ( std::vector< std::string > &  locations)
overridevirtual

Get a list of the names of all stored locations.

Parameters
thereturned list of locations names
Returns
true/false

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

Definition at line 138 of file Map2D_nwc_yarp.cpp.

◆ getPath()

bool Map2D_nwc_yarp::getPath ( std::string  path_name,
yarp::dev::Nav2D::Map2DPath path 
)
overridevirtual

Retrieves a path.

Parameters
path_namethe name of the path
paththe path
Returns
true/false

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

Definition at line 242 of file Map2D_nwc_yarp.cpp.

◆ getPathsList()

bool Map2D_nwc_yarp::getPathsList ( std::vector< std::string > &  paths)
overridevirtual

Get a list of the names of all stored paths.

Parameters
thereturned list of paths names
Returns
true/false

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

Definition at line 164 of file Map2D_nwc_yarp.cpp.

◆ loadLocationsAndExtras()

bool Map2D_nwc_yarp::loadLocationsAndExtras ( std::string  file_name)
overridevirtual

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

Parameters
file_namefile name with full path
Returns
true/false

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

Definition at line 344 of file Map2D_nwc_yarp.cpp.

◆ loadMapFromDisk()

bool Map2D_nwc_yarp::loadMapFromDisk ( std::string  file_name)
overridevirtual

Load a map from disk.

Parameters
file_namefile name with full path
Returns
true/false

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

Definition at line 356 of file Map2D_nwc_yarp.cpp.

◆ loadMapsCollection()

bool Map2D_nwc_yarp::loadMapsCollection ( std::string  file_name)
overridevirtual

Load a collection of maps from disk.

Parameters
file_namefile name with full path
Returns
true/false

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

Definition at line 332 of file Map2D_nwc_yarp.cpp.

◆ open()

bool Map2D_nwc_yarp::open ( yarp::os::Searchable config)
overridevirtual

Open the DeviceDriver.

Parameters
configis 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 27 of file Map2D_nwc_yarp.cpp.

◆ remove_map()

bool Map2D_nwc_yarp::remove_map ( std::string  map_name)
overridevirtual

Removes a map from the map server.

Returns
true/false

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

Definition at line 114 of file Map2D_nwc_yarp.cpp.

◆ renameArea()

bool Map2D_nwc_yarp::renameArea ( std::string  original_name,
std::string  new_name 
)
overridevirtual

Searches for an area and renames it.

Parameters
original_namethe name of the area
new_namethe new name of the area
Returns
true/false

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

Definition at line 279 of file Map2D_nwc_yarp.cpp.

◆ renameLocation()

bool Map2D_nwc_yarp::renameLocation ( std::string  original_name,
std::string  new_name 
)
overridevirtual

Searches for a location and renames it.

Parameters
original_namethe name of the area
new_namethe new name of the area
Returns
true/false

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

Definition at line 261 of file Map2D_nwc_yarp.cpp.

◆ renamePath()

bool Map2D_nwc_yarp::renamePath ( std::string  original_name,
std::string  new_name 
)
overridevirtual

Searches for a path and renames it.

Parameters
original_namethe name of the path
new_namethe new name of the path
Returns
true/false

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

Definition at line 285 of file Map2D_nwc_yarp.cpp.

◆ saveLocationsAndExtras()

bool Map2D_nwc_yarp::saveLocationsAndExtras ( std::string  file_name)
overridevirtual

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

Parameters
file_namefile name with full path
Returns
true/false

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

Definition at line 338 of file Map2D_nwc_yarp.cpp.

◆ saveMapsCollection()

bool Map2D_nwc_yarp::saveMapsCollection ( std::string  file_name)
overridevirtual

Save a collection of maps to disk.

Parameters
file_namefile name with full path
Returns
true/false

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

Definition at line 326 of file Map2D_nwc_yarp.cpp.

◆ saveMapToDisk()

bool Map2D_nwc_yarp::saveMapToDisk ( std::string  map_name,
std::string  file_name 
)
overridevirtual

Save a map to disk.

Parameters
map_namethe name of the area
file_namefile name with full path
Returns
true/false

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

Definition at line 350 of file Map2D_nwc_yarp.cpp.

◆ store_map()

bool Map2D_nwc_yarp::store_map ( const yarp::dev::Nav2D::MapGrid2D map)
overridevirtual

Stores a map into the map server.

Returns
true/false

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

Definition at line 76 of file Map2D_nwc_yarp.cpp.

◆ storeArea()

bool Map2D_nwc_yarp::storeArea ( std::string  area_name,
yarp::dev::Nav2D::Map2DArea  area 
)
overridevirtual

Store an area.

Parameters
area_namethe name of the area
areathe area
Returns
true/false

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

Definition at line 126 of file Map2D_nwc_yarp.cpp.

◆ storeLocation()

bool Map2D_nwc_yarp::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_namethe name of the location
locthe location of the robot
Returns
true/false

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

Definition at line 120 of file Map2D_nwc_yarp.cpp.

◆ storePath()

bool Map2D_nwc_yarp::storePath ( std::string  path_name,
yarp::dev::Nav2D::Map2DPath  path 
)
overridevirtual

Store a path.

Parameters
path_namethe name of the path
paththe path
Returns
true/false

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

Definition at line 132 of file Map2D_nwc_yarp.cpp.

Member Data Documentation

◆ m_carrier

std::string Map2D_nwc_yarp::m_carrier
protected

Definition at line 45 of file Map2D_nwc_yarp.h.

◆ m_local_name

std::string Map2D_nwc_yarp::m_local_name
protected

Definition at line 43 of file Map2D_nwc_yarp.h.

◆ m_map_RPC

IMap2DMsgs Map2D_nwc_yarp::m_map_RPC
protected

Definition at line 46 of file Map2D_nwc_yarp.h.

◆ m_map_server

std::string Map2D_nwc_yarp::m_map_server
protected

Definition at line 44 of file Map2D_nwc_yarp.h.

◆ m_mutex

std::mutex Map2D_nwc_yarp::m_mutex
protected

Definition at line 47 of file Map2D_nwc_yarp.h.

◆ m_rpcPort_to_Map2D_nws

yarp::os::Port Map2D_nwc_yarp::m_rpcPort_to_Map2D_nws
protected

Definition at line 42 of file Map2D_nwc_yarp.h.


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