YARP
Yet Another Robot Platform
ILocalization2D.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2006-2020 Istituto Italiano di Tecnologia (IIT)
3  * All rights reserved.
4  *
5  * This software may be modified and distributed under the terms of the
6  * BSD-3-Clause license. See the accompanying LICENSE file for details.
7  */
8 
9 #ifndef YARP_DEV_ILOCALIZATION2D_H
10 #define YARP_DEV_ILOCALIZATION2D_H
11 
12 #include <yarp/os/Vocab.h>
13 #include <yarp/dev/api.h>
14 #include <yarp/dev/Map2DLocation.h>
15 #include <yarp/dev/OdometryData.h>
16 #include <yarp/sig/Matrix.h>
17 #include <vector>
18 
19 namespace yarp {
20  namespace dev {
21  namespace Nav2D {
22  class ILocalization2D;
23 
25  {
29  };
30  }
31  }
32 }
33 
40 {
41 public:
45  virtual ~ILocalization2D() {}
46 
51  virtual bool startLocalizationService() = 0;
52 
57  virtual bool stopLocalizationService() = 0;
58 
63  virtual bool getLocalizationStatus(LocalizationStatusEnum& status) = 0;
64 
69  virtual bool getEstimatedPoses(std::vector<yarp::dev::Nav2D::Map2DLocation>& poses) = 0;
70 
77 
85 
92 
93 
99  virtual bool setInitialPose(const yarp::dev::Nav2D::Map2DLocation& loc) = 0;
100 
107  virtual bool setInitialPose(const yarp::dev::Nav2D::Map2DLocation& loc, const yarp::sig::Matrix& cov) = 0;
108 };
109 
111 
116 
138 
139 #endif // YARP_DEV_ILOCALIZATION2D_H
yarp::dev::Nav2D::ILocalization2D::~ILocalization2D
virtual ~ILocalization2D()
Destructor.
Definition: ILocalization2D.h:45
yarp::os::createVocab
constexpr yarp::conf::vocab32_t createVocab(char a, char b=0, char c=0, char d=0)
Definition: Vocab.h:22
VOCAB_NAV_GET_CURRENT_POS
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_CURRENT_POS
Definition: ILocalization2D.h:122
VOCAB_NAV_GET_LOCALIZER_POSES
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_LOCALIZER_POSES
Definition: ILocalization2D.h:130
VOCAB_NAV_GET_ABS_TARGET
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_ABS_TARGET
Definition: ILocalization2D.h:119
VOCAB_NAV_LOCATION
constexpr yarp::conf::vocab32_t VOCAB_NAV_LOCATION
Definition: ILocalization2D.h:136
yarp::dev::Nav2D::localization_status_not_yet_localized
@ localization_status_not_yet_localized
Definition: ILocalization2D.h:26
yarp::dev::Nav2D::ILocalization2D
ILocalization2D interface.
Definition: ILocalization2D.h:40
VOCAB_NAV_DELETE_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_DELETE_X
Definition: ILocalization2D.h:132
Matrix.h
contains the definition of a Matrix type
yarp::dev::Nav2D::LocalizationStatusEnum
LocalizationStatusEnum
Definition: ILocalization2D.h:25
VOCAB_NAV_CLEAR_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_CLEAR_X
Definition: ILocalization2D.h:131
VOCAB_NAV_RENAME_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_RENAME_X
Definition: ILocalization2D.h:133
VOCAB_NAV_VELOCITY_CMD
constexpr yarp::conf::vocab32_t VOCAB_NAV_VELOCITY_CMD
Definition: ILocalization2D.h:114
yarp::dev::OdometryData
Definition: OdometryData.h:27
yarp::dev::Nav2D::localization_status_error
@ localization_status_error
Definition: ILocalization2D.h:28
VOCAB_NAV_GET_LIST_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_LIST_X
Definition: ILocalization2D.h:118
VOCAB_NAV_GOTOABS
constexpr yarp::conf::vocab32_t VOCAB_NAV_GOTOABS
Definition: ILocalization2D.h:112
yarp::dev::Nav2D::ILocalization2D::getEstimatedOdometry
virtual bool getEstimatedOdometry(yarp::dev::OdometryData &odom)=0
Gets the estimated odometry the robot, including its velocity expressed in the world and in the local...
yarp::dev::Nav2D::localization_status_localized_ok
@ localization_status_localized_ok
Definition: ILocalization2D.h:27
yarp::dev::Nav2D::ILocalization2D::startLocalizationService
virtual bool startLocalizationService()=0
Starts the localization service.
VOCAB_NAV_GET_NAVIGATION_STATUS
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_NAVIGATION_STATUS
Definition: ILocalization2D.h:128
VOCAB_NAV_GET_REL_TARGET
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_REL_TARGET
Definition: ILocalization2D.h:120
VOCAB_NAV_AREA
constexpr yarp::conf::vocab32_t VOCAB_NAV_AREA
Definition: ILocalization2D.h:135
VOCAB_NAV_GET_LOCALIZER_STATUS
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_LOCALIZER_STATUS
Definition: ILocalization2D.h:129
VOCAB_NAV_GET_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_X
Definition: ILocalization2D.h:117
VOCAB_NAV_LOCALIZATION_START
constexpr yarp::conf::vocab32_t VOCAB_NAV_LOCALIZATION_START
Definition: ILocalization2D.h:126
Map2DLocation.h
contains the definition of a Map2DLocation type
YARP_dev_API
#define YARP_dev_API
Definition: api.h:19
VOCAB_NAV_SET_INITIAL_POSCOV
constexpr yarp::conf::vocab32_t VOCAB_NAV_SET_INITIAL_POSCOV
Definition: ILocalization2D.h:125
VOCAB_NAV_GET_CURRENT_POSCOV
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_CURRENT_POSCOV
Definition: ILocalization2D.h:124
yarp::dev::Nav2D::ILocalization2D::stopLocalizationService
virtual bool stopLocalizationService()=0
Stops the localization service.
VOCAB_NAV_GET_NAME_TARGET
constexpr yarp::conf::vocab32_t VOCAB_NAV_GET_NAME_TARGET
Definition: ILocalization2D.h:121
yarp::dev::Nav2D::ILocalization2D::getCurrentPosition
virtual bool getCurrentPosition(yarp::dev::Nav2D::Map2DLocation &loc, yarp::sig::Matrix &cov)=0
Gets the current position of the robot w.r.t world reference frame, plus the covariance.
yarp::dev::Nav2D::Map2DLocation
Definition: Map2DLocation.h:30
yarp::dev::Nav2D::ILocalization2D::setInitialPose
virtual bool setInitialPose(const yarp::dev::Nav2D::Map2DLocation &loc)=0
Sets the initial pose for the localization algorithm which estimates the current position of the robo...
yarp::dev::Nav2D::ILocalization2D::getLocalizationStatus
virtual bool getLocalizationStatus(LocalizationStatusEnum &status)=0
Gets the current status of the localization task.
VOCAB_NAV_PATH
constexpr yarp::conf::vocab32_t VOCAB_NAV_PATH
Definition: ILocalization2D.h:137
VOCAB_NAV_STORE_X
constexpr yarp::conf::vocab32_t VOCAB_NAV_STORE_X
Definition: ILocalization2D.h:134
yarp
The main, catch-all namespace for YARP.
Definition: environment.h:18
yarp::conf::vocab32_t
std::int32_t vocab32_t
Definition: numeric.h:52
Vocab.h
VOCAB_NAV_RECOMPUTE_PATH
constexpr yarp::conf::vocab32_t VOCAB_NAV_RECOMPUTE_PATH
Definition: ILocalization2D.h:115
VOCAB_NAV_GOTOREL
constexpr yarp::conf::vocab32_t VOCAB_NAV_GOTOREL
Definition: ILocalization2D.h:113
yarp::dev::Nav2D::ILocalization2D::setInitialPose
virtual bool setInitialPose(const yarp::dev::Nav2D::Map2DLocation &loc, const yarp::sig::Matrix &cov)=0
Sets the initial pose for the localization algorithm which estimates the current position of the robo...
yarp::dev::Nav2D::ILocalization2D::getCurrentPosition
virtual bool getCurrentPosition(yarp::dev::Nav2D::Map2DLocation &loc)=0
Gets the current position of the robot w.r.t world reference frame.
VOCAB_NAV_LOCALIZATION_STOP
constexpr yarp::conf::vocab32_t VOCAB_NAV_LOCALIZATION_STOP
Definition: ILocalization2D.h:127
api.h
yarp::dev::Nav2D::ILocalization2D::getEstimatedPoses
virtual bool getEstimatedPoses(std::vector< yarp::dev::Nav2D::Map2DLocation > &poses)=0
Gets a set of pose estimates computed by the localization algorithm.
VOCAB_INAVIGATION
constexpr yarp::conf::vocab32_t VOCAB_INAVIGATION
Definition: ILocalization2D.h:110
VOCAB_NAV_SET_INITIAL_POS
constexpr yarp::conf::vocab32_t VOCAB_NAV_SET_INITIAL_POS
Definition: ILocalization2D.h:123
OdometryData.h
yarp::sig::Matrix
A class for a Matrix.
Definition: Matrix.h:46