This class extends CAbstractNavigator
with the capability of following a list of waypoints.
By default, waypoints are followed one by one, but, if they are tagged with allow_skip=true
and the derived navigator class supports it, the navigator may choose to skip some to make a smoother, safer and shorter navigation.
Waypoints have an optional target_heading
field, which will be honored only for waypoints that are skipped, and if the underlying robot interface supports the pure-rotation methods.
Notes on navigation status and event dispatchment:
IDLE
status between a waypoint is reached and a new navigation command is issued towards the next waypoint.sendNavigationEndEvent()
will be called only when the last waypoint is reached.sendWaypointReachedEvent()
instead.Definition at line 33 of file CWaypointsNavigator.h.
#include <mrpt/nav/reactive/CWaypointsNavigator.h>
Classes | |
struct | TNavigationParamsWaypoints |
The struct for configuring navigation requests to CWaypointsNavigator and derived classes. More... | |
struct | TWaypointsNavigatorParams |
Public Member Functions | |
CWaypointsNavigator (CRobot2NavInterface &robot_interface_impl) | |
ctor More... | |
virtual | ~CWaypointsNavigator () |
dtor More... | |
virtual void | navigationStep () MRPT_OVERRIDE |
This method must be called periodically in order to effectively run the navigation. More... | |
virtual void | cancel () MRPT_OVERRIDE |
Cancel current navegation. More... | |
bool | isRelativePointReachable (const mrpt::math::TPoint2D &wp_local_wrt_robot) const |
Returns true if, according to the information gathered at the last navigation step, there is a free path to the given point; false otherwise: if way is blocked or there is missing information, the point is out of range for the existing PTGs, etc. More... | |
virtual void | loadConfigFile (const mrpt::utils::CConfigFileBase &c) MRPT_OVERRIDE |
Loads all params from a file. More... | |
virtual void | saveConfigFile (mrpt::utils::CConfigFileBase &c) const MRPT_OVERRIDE |
Saves all current options to a config file. More... | |
const mrpt::utils::CTimeLogger & | getDelaysTimeLogger () const |
Gives access to a const-ref to the internal time logger used to estimate delays. More... | |
Waypoint navigation control API | |
virtual void | navigateWaypoints (const TWaypointSequence &nav_request) |
Waypoint navigation request. More... | |
virtual void | getWaypointNavStatus (TWaypointStatusSequence &out_nav_status) const |
Get a copy of the control structure which describes the progress status of the waypoint navigation. More... | |
TWaypointStatusSequence | getWaypointNavStatus () const |
Get a copy of the control structure which describes the progress status of the waypoint navigation. More... | |
Public Attributes | |
TWaypointsNavigatorParams | params_waypoints_navigator |
TAbstractNavigatorParams | params_abstract_navigator |
Protected Member Functions | |
virtual bool | impl_waypoint_is_reachable (const mrpt::math::TPoint2D &wp_local_wrt_robot) const =0 |
Implements the way to waypoint is free function in children classes: true must be returned if, according to the information gathered at the last navigation step, there is a free path to the given point; false otherwise: if way is blocked or there is missing information, the point is out of range, etc. More... | |
virtual void | onStartNewNavigation () MRPT_OVERRIDE |
Called whenever a new navigation has been started. More... | |
virtual void | onNavigateCommandReceived () MRPT_OVERRIDE |
Called after each call to CAbstractNavigator::navigate() More... | |
virtual bool | checkHasReachedTarget (const double targetDist) const MRPT_OVERRIDE |
Default implementation: check if target_dist is below the accepted distance. More... | |
virtual void | waypoints_navigationStep () |
The waypoints-specific part of navigationStep() More... | |
bool | waypoints_isAligning () const |
void | dispatchPendingNavEvents () |
virtual void | performNavigationStep ()=0 |
To be implemented in derived classes. More... | |
virtual void | processNavigateCommand (const TNavigationParams *params) |
Does the job of navigate(), except the call to onNavigateCommandReceived() More... | |
virtual void | updateCurrentPoseAndSpeeds () |
Call to the robot getCurrentPoseAndSpeeds() and updates members m_curPoseVel accordingly. More... | |
virtual void | performNavigationStepNavigating (bool call_virtual_nav_method=true) |
Factorization of the part inside navigationStep(), for the case of state being NAVIGATING. More... | |
virtual void | doEmergencyStop (const std::string &msg) |
Stops the robot and set navigation state to error. More... | |
virtual bool | changeSpeeds (const mrpt::kinematics::CVehicleVelCmd &vel_cmd) |
Default: forward call to m_robot.changeSpeed(). Can be overriden. More... | |
virtual bool | changeSpeedsNOP () |
Default: forward call to m_robot.changeSpeedsNOP(). Can be overriden. More... | |
virtual bool | stop (bool isEmergencyStop) |
Default: forward call to m_robot.stop(). Can be overriden. More... | |
virtual bool | checkCollisionWithLatestObstacles (const mrpt::math::TPose2D &relative_robot_pose) const |
Checks whether the robot shape, when placed at the given pose (relative to the current pose), is colliding with any of the latest known obstacles. More... | |
Navigation control API | |
virtual void | initialize ()=0 |
Must be called before any other navigation command. More... | |
virtual void | navigate (const TNavigationParams *params) |
Navigation request to a single target location. More... | |
virtual void | resume () |
Continues with suspended navigation. More... | |
virtual void | suspend () |
Suspend current navegation. More... | |
virtual void | resetNavError () |
Resets a NAV_ERROR state back to IDLE More... | |
TState | getCurrentState () const |
Returns the current navigator state. More... | |
const TErrorReason & | getErrorReason () const |
In case of state=NAV_ERROR, this returns the reason for the error. More... | |
void | setFrameTF (mrpt::poses::FrameTransformer< 2 > *frame_tf) |
Sets a user-provided frame transformer object; used only if providing targets in a frame ID different than the one in which robot odometry is given (both IDs default to "map" ). More... | |
const mrpt::poses::FrameTransformer< 2 > * | getFrameTF () const |
Get the current frame tf object (defaults to nullptr) More... | |
void | enableRethrowNavExceptions (const bool enable) |
By default, error exceptions on navigationStep() will dump an error message to the output logger interface. More... | |
bool | isRethrowNavExceptionsEnabled () const |
enum | TState { IDLE =0, NAVIGATING, SUSPENDED, NAV_ERROR } |
The different states for the navigation system. More... | |
enum | TErrorCode { ERR_NONE =0, ERR_EMERGENCY_STOP, ERR_CANNOT_REACH_TARGET, ERR_OTHER } |
Explains the reason for the navigation error. More... | |
|
inherited |
Explains the reason for the navigation error.
Enumerator | |
---|---|
ERR_NONE | |
ERR_EMERGENCY_STOP | |
ERR_CANNOT_REACH_TARGET | |
ERR_OTHER |
Definition at line 131 of file CAbstractNavigator.h.
|
inherited |
The different states for the navigation system.
Enumerator | |
---|---|
IDLE | |
NAVIGATING | |
SUSPENDED | |
NAV_ERROR | In this case, use getErrorReason() |
Definition at line 120 of file CAbstractNavigator.h.
CWaypointsNavigator::CWaypointsNavigator | ( | CRobot2NavInterface & | robot_interface_impl | ) |
ctor
Definition at line 42 of file CWaypointsNavigator.cpp.
|
virtual |
dtor
Definition at line 50 of file CWaypointsNavigator.cpp.
|
virtual |
Cancel current navegation.
Reimplemented from mrpt::nav::CAbstractNavigator.
Definition at line 96 of file CWaypointsNavigator.cpp.
References mrpt::nav::CAbstractNavigator::cancel(), m_nav_waypoints_cs, and m_waypoint_nav_status.
|
protectedvirtualinherited |
Default: forward call to m_robot.changeSpeed(). Can be overriden.
Definition at line 414 of file CAbstractNavigator.cpp.
References mrpt::nav::CRobot2NavInterface::changeSpeeds(), and mrpt::nav::CAbstractNavigator::m_robot.
Referenced by mrpt::nav::CNavigatorManualSequence::navigationStep(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), and waypoints_navigationStep().
|
protectedvirtualinherited |
Default: forward call to m_robot.changeSpeedsNOP(). Can be overriden.
Definition at line 418 of file CAbstractNavigator.cpp.
References mrpt::nav::CRobot2NavInterface::changeSpeedsNOP(), and mrpt::nav::CAbstractNavigator::m_robot.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep().
|
protectedvirtualinherited |
Checks whether the robot shape, when placed at the given pose (relative to the current pose), is colliding with any of the latest known obstacles.
Default implementation: always returns false.
Reimplemented in mrpt::nav::CReactiveNavigationSystem3D, and mrpt::nav::CReactiveNavigationSystem.
Definition at line 626 of file CAbstractNavigator.cpp.
Referenced by mrpt::nav::CAbstractNavigator::performNavigationStepNavigating().
|
protectedvirtual |
Default implementation: check if target_dist is below the accepted distance.
If true is returned here, the end-of-navigation event will be sent out (only for non-intermediary targets).
Reimplemented from mrpt::nav::CAbstractNavigator.
Definition at line 449 of file CWaypointsNavigator.cpp.
References mrpt::system::dateTimeLocalToString(), mrpt::nav::TWaypointStatus::getAsText(), INVALID_TIMESTAMP, mrpt::nav::CAbstractNavigator::m_navigationParams, m_waypoint_nav_status, MRPT_LOG_DEBUG_STREAM, mrpt::nav::TWaypointStatus::reached, mrpt::nav::CAbstractNavigator::TNavigationParams::target, mrpt::nav::CAbstractNavigator::TargetInfo::targetAllowedDistance, and mrpt::nav::CAbstractNavigator::TargetInfo::targetIsIntermediaryWaypoint.
|
protectedinherited |
Definition at line 249 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::ERR_CANNOT_REACH_TARGET, mrpt::nav::CAbstractNavigator::TErrorReason::error_code, mrpt::nav::CAbstractNavigator::TErrorReason::error_msg, mrpt::nav::CAbstractNavigator::TPendingEvent::event_noargs, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationState, mrpt::nav::CAbstractNavigator::m_pending_events, mrpt::nav::CAbstractNavigator::m_robot, MRPT_LOG_WARN, mrpt::nav::CAbstractNavigator::NAV_ERROR, mrpt::nav::CRobot2NavInterface::sendCannotGetCloserToBlockedTargetEvent(), mrpt::nav::CRobot2NavInterface::sendNewWaypointTargetEvent(), mrpt::nav::CRobot2NavInterface::sendWaypointReachedEvent(), and mrpt::nav::CRobot2NavInterface::sendWaySeemsBlockedEvent().
Referenced by navigationStep(), and mrpt::nav::CAbstractNavigator::navigationStep().
|
protectedvirtualinherited |
Stops the robot and set navigation state to error.
Definition at line 284 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::ERR_EMERGENCY_STOP, mrpt::nav::CAbstractNavigator::ERR_NONE, mrpt::nav::CAbstractNavigator::TErrorReason::error_code, mrpt::nav::CAbstractNavigator::TErrorReason::error_msg, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_LOG_ERROR, mrpt::nav::CAbstractNavigator::NAV_ERROR, and mrpt::nav::CAbstractNavigator::stop().
Referenced by mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep().
|
inlineinherited |
By default, error exceptions on navigationStep() will dump an error message to the output logger interface.
If rethrow is enabled (default=false), the error message will be reported as well, but exceptions will be re-thrown.
Definition at line 167 of file CAbstractNavigator.h.
|
inlineinherited |
Returns the current navigator state.
Definition at line 128 of file CAbstractNavigator.h.
|
inlineinherited |
Gives access to a const-ref to the internal time logger used to estimate delays.
Definition at line 190 of file CAbstractNavigator.h.
|
inlineinherited |
In case of state=NAV_ERROR, this returns the reason for the error.
Error state is reseted everytime a new navigation starts with a call to navigate(), or when resetNavError() is called.
Definition at line 150 of file CAbstractNavigator.h.
|
inlineinherited |
Get the current frame tf object (defaults to nullptr)
Definition at line 161 of file CAbstractNavigator.h.
|
virtual |
Get a copy of the control structure which describes the progress status of the waypoint navigation.
Definition at line 90 of file CWaypointsNavigator.cpp.
References m_waypoint_nav_status.
|
inline |
Get a copy of the control structure which describes the progress status of the waypoint navigation.
Definition at line 69 of file CWaypointsNavigator.h.
Referenced by waypoints_navigationStep().
|
protectedpure virtual |
Implements the way to waypoint is free function in children classes: true
must be returned if, according to the information gathered at the last navigation step, there is a free path to the given point; false
otherwise: if way is blocked or there is missing information, the point is out of range, etc.
Implemented in mrpt::nav::CAbstractPTGBasedReactive.
Referenced by isRelativePointReachable(), and waypoints_navigationStep().
|
pure virtualinherited |
Must be called before any other navigation command.
Implemented in mrpt::nav::CAbstractPTGBasedReactive, and mrpt::nav::CNavigatorManualSequence.
bool CWaypointsNavigator::isRelativePointReachable | ( | const mrpt::math::TPoint2D & | wp_local_wrt_robot | ) | const |
Returns true
if, according to the information gathered at the last navigation step, there is a free path to the given point; false
otherwise: if way is blocked or there is missing information, the point is out of range for the existing PTGs, etc.
Definition at line 404 of file CWaypointsNavigator.cpp.
References impl_waypoint_is_reachable().
|
inlineinherited |
Definition at line 170 of file CAbstractNavigator.h.
|
virtual |
Loads all params from a file.
To be called before initialize(). Each derived class MUST load its own parameters, and then call ITS PARENT'S overriden method to ensure all params are loaded.
Reimplemented from mrpt::nav::CAbstractNavigator.
Reimplemented in mrpt::nav::CAbstractPTGBasedReactive, mrpt::nav::CReactiveNavigationSystem3D, and mrpt::nav::CReactiveNavigationSystem.
Definition at line 409 of file CWaypointsNavigator.cpp.
References mrpt::nav::CAbstractNavigator::loadConfigFile(), mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::loadFromConfigFile(), MRPT_END, MRPT_START, and params_waypoints_navigator.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::loadConfigFile().
|
virtualinherited |
Navigation request to a single target location.
It starts a new navigation.
[in] | params | Pointer to structure with navigation info (its contents will be copied, so the original can be freely destroyed upon return if it was dynamically allocated.) |
Reimplemented in mrpt::nav::CNavigatorManualSequence.
Definition at line 341 of file CAbstractNavigator.cpp.
References MRPT_END, MRPT_START, mrpt::nav::CAbstractNavigator::onNavigateCommandReceived(), and mrpt::nav::CAbstractNavigator::processNavigateCommand().
|
virtual |
Waypoint navigation request.
This immediately cancels any other previous on-going navigation.
Definition at line 66 of file CWaypointsNavigator.cpp.
References ASSERT_, ASSERTMSG_, m_nav_waypoints_cs, m_waypoint_nav_status, MRPT_END, MRPT_START, mrpt::system::now(), onNavigateCommandReceived(), mrpt::nav::TWaypointStatusSequence::timestamp_nav_started, mrpt::nav::TWaypointSequence::waypoints, and mrpt::nav::TWaypointStatusSequence::waypoints.
|
virtual |
This method must be called periodically in order to effectively run the navigation.
Reimplemented from mrpt::nav::CAbstractNavigator.
Definition at line 373 of file CWaypointsNavigator.cpp.
References mrpt::nav::CAbstractNavigator::dispatchPendingNavEvents(), mrpt::nav::CAbstractNavigator::IDLE, m_is_aligning, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_END, MRPT_START, mrpt::nav::CAbstractNavigator::NAVIGATING, mrpt::nav::CAbstractNavigator::navigationStep(), and waypoints_navigationStep().
|
protectedvirtual |
Called after each call to CAbstractNavigator::navigate()
Reimplemented from mrpt::nav::CAbstractNavigator.
Definition at line 54 of file CWaypointsNavigator.cpp.
References INVALID_TIMESTAMP, m_nav_waypoints_cs, m_was_aligning, m_waypoint_nav_status, mrpt::nav::CAbstractNavigator::onNavigateCommandReceived(), mrpt::nav::TWaypointStatusSequence::timestamp_nav_started, and mrpt::nav::TWaypointStatusSequence::waypoint_index_current_goal.
Referenced by navigateWaypoints().
|
protectedvirtual |
Called whenever a new navigation has been started.
Can be used to reset state variables, etc.
Implements mrpt::nav::CAbstractNavigator.
Reimplemented in mrpt::nav::CAbstractPTGBasedReactive.
Definition at line 400 of file CWaypointsNavigator.cpp.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::onStartNewNavigation().
|
protectedpure virtualinherited |
To be implemented in derived classes.
Implemented in mrpt::nav::CAbstractPTGBasedReactive, and mrpt::nav::CNavigatorManualSequence.
Referenced by mrpt::nav::CAbstractNavigator::performNavigationStepNavigating().
|
protectedvirtualinherited |
Factorization of the part inside navigationStep(), for the case of state being NAVIGATING.
Performs house-hold tasks like raising events in case of starting/ending navigation, timeout reaching destination, etc. call_virtual_nav_method
can be set to false to avoid calling the virtual method performNavigationStep()
Definition at line 467 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::TAbstractNavigatorParams::alarm_seems_not_approaching_target_timeout, ASSERT_, mrpt::nav::CAbstractNavigator::checkCollisionWithLatestObstacles(), mrpt::nav::CAbstractNavigator::checkHasReachedTarget(), mrpt::nav::CAbstractNavigator::TAbstractNavigatorParams::dist_check_target_is_blocked, mrpt::nav::CAbstractNavigator::TAbstractNavigatorParams::dist_to_target_for_sending_event, mrpt::math::TSegment2D::distance(), mrpt::poses::CPoseInterpolatorBase< DIM >::empty(), mrpt::nav::CAbstractNavigator::ERR_CANNOT_REACH_TARGET, mrpt::nav::CAbstractNavigator::ERR_NONE, mrpt::nav::CAbstractNavigator::ERR_OTHER, mrpt::nav::CAbstractNavigator::TErrorReason::error_code, mrpt::nav::CAbstractNavigator::TErrorReason::error_msg, mrpt::nav::CAbstractNavigator::TPendingEvent::event_cannot_get_closer_target, mrpt::nav::CAbstractNavigator::TPendingEvent::event_noargs, mrpt::mrpt::format(), mrpt::nav::CAbstractNavigator::TNavigationParams::getAsText(), mrpt::system::getCurrentTime(), mrpt::nav::CAbstractNavigator::TAbstractNavigatorParams::hysteresis_check_target_is_blocked, mrpt::nav::CAbstractNavigator::IDLE, mrpt::nav::CAbstractNavigator::internal_onStartNewNavigation(), mrpt::nav::CAbstractNavigator::m_badNavAlarm_lastMinDistTime, mrpt::nav::CAbstractNavigator::m_badNavAlarm_minDistTarget, mrpt::nav::CAbstractNavigator::m_counter_check_target_is_blocked, mrpt::nav::CAbstractNavigator::m_curPoseVel, mrpt::nav::CAbstractNavigator::m_lastNavigationState, mrpt::nav::CAbstractNavigator::m_latestPoses, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationEndEventSent, mrpt::nav::CAbstractNavigator::m_navigationParams, mrpt::nav::CAbstractNavigator::m_navigationState, mrpt::nav::CAbstractNavigator::m_pending_events, mrpt::nav::CAbstractNavigator::m_rethrow_exceptions, MRPT_LOG_DEBUG, MRPT_LOG_ERROR, MRPT_LOG_ERROR_FMT, MRPT_LOG_INFO, MRPT_LOG_THROTTLE_WARN, MRPT_LOG_WARN, mrpt::nav::CAbstractNavigator::NAV_ERROR, mrpt::nav::CAbstractNavigator::NAVIGATING, mrpt::nav::CAbstractNavigator::params_abstract_navigator, mrpt::nav::CAbstractNavigator::performNavigationStep(), mrpt::nav::CAbstractNavigator::TRobotPoseVel::pose, mrpt::poses::CPoseInterpolatorBase< DIM >::rbegin(), mrpt::nav::CRobot2NavInterface::sendNavigationEndEvent(), mrpt::nav::CRobot2NavInterface::sendNavigationStartEvent(), mrpt::nav::CRobot2NavInterface::sendWaySeemsBlockedEvent(), mrpt::poses::CPoseInterpolatorBase< DIM >::size(), mrpt::nav::CAbstractNavigator::stop(), mrpt::nav::CAbstractNavigator::TNavigationParams::target, mrpt::nav::CAbstractNavigator::TargetInfo::target_coords, mrpt::nav::CAbstractNavigator::TargetInfo::targetIsIntermediaryWaypoint, mrpt::system::timeDifference(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), mrpt::math::TPose2D::x, and mrpt::math::TPose2D::y.
Referenced by mrpt::nav::CAbstractNavigator::navigationStep(), and waypoints_navigationStep().
|
protectedvirtualinherited |
Does the job of navigate(), except the call to onNavigateCommandReceived()
Definition at line 309 of file CAbstractNavigator.cpp.
References ASSERT_, mrpt::nav::CAbstractNavigator::TNavigationParams::clone(), mrpt::mrpt::utils::delete_safe(), mrpt::system::getCurrentTime(), mrpt::nav::CAbstractNavigator::m_badNavAlarm_lastMinDistTime, mrpt::nav::CAbstractNavigator::m_badNavAlarm_minDistTarget, mrpt::nav::CAbstractNavigator::m_curPoseVel, mrpt::nav::CAbstractNavigator::m_nav_cs, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationParams, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_END, MRPT_START, mrpt::nav::CAbstractNavigator::NAVIGATING, mrpt::nav::CAbstractNavigator::TRobotPoseVel::pose, mrpt::nav::CAbstractNavigator::TNavigationParams::target, mrpt::nav::CAbstractNavigator::TargetInfo::target_coords, mrpt::nav::CAbstractNavigator::TargetInfo::targetIsRelative, and mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
Referenced by mrpt::nav::CAbstractNavigator::navigate(), and waypoints_navigationStep().
|
virtualinherited |
Resets a NAV_ERROR
state back to IDLE
Definition at line 155 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::IDLE, mrpt::nav::CAbstractNavigator::m_nav_cs, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_LOG_DEBUG, and mrpt::nav::CAbstractNavigator::NAV_ERROR.
|
virtualinherited |
Continues with suspended navigation.
Definition at line 128 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::m_nav_cs, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_LOG_DEBUG, mrpt::nav::CAbstractNavigator::NAVIGATING, and mrpt::nav::CAbstractNavigator::SUSPENDED.
|
virtual |
Saves all current options to a config file.
Each derived class MUST save its own parameters, and then call ITS PARENT'S overriden method to ensure all params are saved.
Reimplemented from mrpt::nav::CAbstractNavigator.
Reimplemented in mrpt::nav::CAbstractPTGBasedReactive, mrpt::nav::CReactiveNavigationSystem3D, and mrpt::nav::CReactiveNavigationSystem.
Definition at line 419 of file CWaypointsNavigator.cpp.
References params_waypoints_navigator, mrpt::nav::CAbstractNavigator::saveConfigFile(), and mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::saveToConfigFile().
Referenced by mrpt::nav::CAbstractPTGBasedReactive::saveConfigFile().
|
inherited |
Sets a user-provided frame transformer object; used only if providing targets in a frame ID different than the one in which robot odometry is given (both IDs default to "map"
).
Ownership of the pointee object remains belonging to the user, which is responsible of deleting it and ensuring its a valid pointer during the lifetime of this navigator object.
Definition at line 167 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::m_frame_tf.
|
protectedvirtualinherited |
Default: forward call to m_robot.stop(). Can be overriden.
Definition at line 422 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::m_robot, and mrpt::nav::CRobot2NavInterface::stop().
Referenced by mrpt::nav::CAbstractNavigator::cancel(), mrpt::nav::CAbstractNavigator::doEmergencyStop(), mrpt::nav::CNavigatorManualSequence::navigationStep(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::nav::CAbstractPTGBasedReactive::preDestructor(), mrpt::nav::CAbstractNavigator::suspend(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), and waypoints_navigationStep().
|
virtualinherited |
Suspend current navegation.
Definition at line 141 of file CAbstractNavigator.cpp.
References mrpt::nav::CAbstractNavigator::m_nav_cs, mrpt::nav::CAbstractNavigator::m_navigationState, MRPT_LOG_DEBUG, mrpt::nav::CAbstractNavigator::NAVIGATING, mrpt::nav::CAbstractNavigator::stop(), and mrpt::nav::CAbstractNavigator::SUSPENDED.
|
protectedvirtualinherited |
Call to the robot getCurrentPoseAndSpeeds() and updates members m_curPoseVel accordingly.
If an error is returned by the user callback, first, it calls robot.stop() ,then throws an std::runtime_error exception.
Definition at line 349 of file CAbstractNavigator.cpp.
References mrpt::poses::CPoseInterpolatorBase< DIM >::begin(), mrpt::poses::CPoseInterpolatorBase< DIM >::clear(), mrpt::poses::CPoseInterpolatorBase< DIM >::erase(), mrpt::nav::CAbstractNavigator::ERR_EMERGENCY_STOP, mrpt::nav::CAbstractNavigator::TErrorReason::error_code, mrpt::nav::CAbstractNavigator::TErrorReason::error_msg, mrpt::nav::CRobot2NavInterface::getCurrentPoseAndSpeeds(), mrpt::nav::CRobot2NavInterface::getNavigationTime(), mrpt::poses::CPoseInterpolatorBase< DIM >::insert(), mrpt::nav::CAbstractNavigator::m_curPoseVel, mrpt::nav::CAbstractNavigator::m_last_curPoseVelUpdate_pose_frame_id, mrpt::nav::CAbstractNavigator::m_last_curPoseVelUpdate_robot_time, mrpt::nav::CAbstractNavigator::m_latestOdomPoses, mrpt::nav::CAbstractNavigator::m_latestPoses, mrpt::nav::CAbstractNavigator::m_navErrorReason, mrpt::nav::CAbstractNavigator::m_navigationState, mrpt::nav::CAbstractNavigator::m_robot, mrpt::nav::CAbstractNavigator::m_timlog_delays, MRPT_LOG_ERROR, MRPT_LOG_THROTTLE_DEBUG_FMT, mrpt::nav::CAbstractNavigator::NAV_ERROR, mrpt::math::TPose2D::phi, mrpt::nav::CAbstractNavigator::TRobotPoseVel::pose, mrpt::nav::CAbstractNavigator::TRobotPoseVel::pose_frame_id, PREVIOUS_POSES_MAX_AGE, mrpt::nav::CAbstractNavigator::TRobotPoseVel::rawOdometry, mrpt::poses::CPoseInterpolatorBase< DIM >::rbegin(), mrpt::math::TTwist2D::rotate(), mrpt::poses::CPoseInterpolatorBase< DIM >::size(), mrpt::nav::CAbstractNavigator::stop(), mrpt::system::timeDifference(), mrpt::nav::CAbstractNavigator::TRobotPoseVel::timestamp, mrpt::nav::CAbstractNavigator::TRobotPoseVel::velGlobal, and mrpt::nav::CAbstractNavigator::TRobotPoseVel::velLocal.
Referenced by mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::nav::CAbstractNavigator::processNavigateCommand(), and waypoints_navigationStep().
|
inlineprotected |
Definition at line 113 of file CWaypointsNavigator.h.
|
protectedvirtual |
The waypoints-specific part of navigationStep()
Definition at line 105 of file CWaypointsNavigator.cpp.
References mrpt::nav::TWaypoint::allowed_distance, mrpt::math::angDistance(), ASSERT_, mrpt::nav::CAbstractNavigator::changeSpeeds(), mrpt::math::TSegment2D::distance(), mrpt::nav::CAbstractNavigator::TPendingEvent::event_new_wp, mrpt::nav::CAbstractNavigator::TPendingEvent::event_new_wp_index, mrpt::nav::CAbstractNavigator::TPendingEvent::event_wp_reached, mrpt::nav::CAbstractNavigator::TPendingEvent::event_wp_reached_index, mrpt::nav::CAbstractNavigator::TPendingEvent::event_wp_reached_reached, mrpt::nav::TWaypointStatusSequence::final_goal_reached, mrpt::nav::CRobot2NavInterface::getAlignCmd(), getWaypointNavStatus(), impl_waypoint_is_reachable(), mrpt::nav::TWaypoint::INVALID_NUM, mrpt::poses::CPose2D::inverseComposePoint(), mrpt::nav::TWaypointStatusSequence::last_robot_pose, mrpt::nav::CAbstractNavigator::m_curPoseVel, m_is_aligning, m_last_alignment_cmd, m_nav_waypoints_cs, mrpt::nav::CAbstractNavigator::m_pending_events, mrpt::nav::CAbstractNavigator::m_robot, mrpt::nav::CAbstractNavigator::m_timlog_delays, m_was_aligning, m_waypoint_nav_status, mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::max_distance_to_allow_skip_waypoint, mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::min_timesteps_confirm_skip_waypoints, MRPT_END, MRPT_LOG_DEBUG_STREAM, MRPT_LOG_INFO_FMT, MRPT_LOG_THROTTLE_INFO_FMT, MRPT_START, mrpt::nav::CWaypointsNavigator::TNavigationParamsWaypoints::multiple_targets, mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::multitarget_look_ahead, mrpt::math::TPoint2D::norm(), mrpt::system::now(), params_waypoints_navigator, mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::math::TPose2D::phi, mrpt::math::TSegment2D::point1, mrpt::math::TSegment2D::point2, mrpt::nav::CAbstractNavigator::TRobotPoseVel::pose, mrpt::nav::CAbstractNavigator::processNavigateCommand(), mrpt::mrpt::utils::RAD2DEG(), mrpt::nav::TWaypoint::speed_ratio, mrpt::mrpt::math::square(), mrpt::nav::CAbstractNavigator::stop(), mrpt::nav::TWaypoint::target, mrpt::nav::CAbstractNavigator::TNavigationParams::target, mrpt::nav::CAbstractNavigator::TargetInfo::target_coords, mrpt::nav::TWaypoint::target_frame_id, mrpt::nav::CAbstractNavigator::TargetInfo::target_frame_id, mrpt::nav::TWaypoint::target_heading, mrpt::nav::CAbstractNavigator::TargetInfo::targetAllowedDistance, mrpt::nav::CAbstractNavigator::TargetInfo::targetDesiredRelSpeed, mrpt::nav::CAbstractNavigator::TargetInfo::targetIsIntermediaryWaypoint, mrpt::nav::CAbstractNavigator::TargetInfo::targetIsRelative, mrpt::system::timeDifference(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), mrpt::nav::CWaypointsNavigator::TWaypointsNavigatorParams::waypoint_angle_tolerance, mrpt::nav::TWaypointStatusSequence::waypoint_index_current_goal, mrpt::nav::TWaypointStatusSequence::waypoints, mrpt::math::TPoint2D::x, mrpt::math::TPose2D::x, mrpt::math::TPoint2D::y, and mrpt::math::TPose2D::y.
Referenced by navigationStep().
|
protectedinherited |
Definition at line 295 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), and mrpt::nav::CAbstractNavigator::processNavigateCommand().
|
protectedinherited |
For sending an alarm (error event) when it seems that we are not approaching toward the target in a while...
Definition at line 294 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), and mrpt::nav::CAbstractNavigator::processNavigateCommand().
|
protectedinherited |
Current robot pose (updated in CAbstractNavigator::navigationStep() )
Definition at line 286 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::build_movement_candidate(), mrpt::nav::CAbstractPTGBasedReactive::calc_move_candidate_scores(), mrpt::nav::CReactiveNavigationSystem::implementSenseObstacles(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::nav::CAbstractNavigator::processNavigateCommand(), mrpt::nav::CAbstractPTGBasedReactive::STEP8_GenerateLogRecord(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), and waypoints_navigationStep().
|
protectedinherited |
Optional, user-provided frame transformer.
Note: We dont have ownership of the pointee object!
Definition at line 272 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), and mrpt::nav::CAbstractNavigator::setFrameTF().
|
protected |
Definition at line 116 of file CWaypointsNavigator.h.
Referenced by navigationStep(), and waypoints_navigationStep().
|
protected |
Definition at line 117 of file CWaypointsNavigator.h.
Referenced by waypoints_navigationStep().
|
protectedinherited |
Definition at line 288 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
|
protectedinherited |
Definition at line 287 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::onStartNewNavigation(), and mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
|
protectedinherited |
Latest robot poses (updated in CAbstractNavigator::navigationStep() )
Definition at line 289 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::CAbstractNavigator(), mrpt::nav::CAbstractNavigator::internal_onStartNewNavigation(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), and mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
|
protectedinherited |
Definition at line 289 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::CAbstractNavigator(), mrpt::nav::CAbstractNavigator::internal_onStartNewNavigation(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), and mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
|
protectedinherited |
mutex for all navigation methods
Definition at line 274 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::cancel(), mrpt::nav::CAbstractPTGBasedReactive::enableLogFile(), mrpt::nav::CAbstractPTGBasedReactive::initialize(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractNavigator::onNavigateCommandReceived(), mrpt::nav::CAbstractPTGBasedReactive::preDestructor(), mrpt::nav::CAbstractNavigator::processNavigateCommand(), mrpt::nav::CAbstractNavigator::resetNavError(), mrpt::nav::CAbstractNavigator::resume(), mrpt::nav::CAbstractPTGBasedReactive::setHolonomicMethod(), and mrpt::nav::CAbstractNavigator::suspend().
|
protected |
Definition at line 100 of file CWaypointsNavigator.h.
Referenced by cancel(), navigateWaypoints(), onNavigateCommandReceived(), and waypoints_navigationStep().
|
protectedinherited |
Current navigation parameters.
Definition at line 266 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::calc_move_candidate_scores(), checkHasReachedTarget(), mrpt::nav::CAbstractNavigator::onNavigateCommandReceived(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::nav::CAbstractNavigator::processNavigateCommand(), and mrpt::nav::CAbstractNavigator::~CAbstractNavigator().
|
protectedinherited |
Current internal state of navigator:
Definition at line 265 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::cancel(), mrpt::nav::CAbstractNavigator::dispatchPendingNavEvents(), mrpt::nav::CAbstractNavigator::doEmergencyStop(), navigationStep(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), mrpt::nav::CAbstractNavigator::processNavigateCommand(), mrpt::nav::CAbstractNavigator::resetNavError(), mrpt::nav::CAbstractNavigator::resume(), mrpt::nav::CAbstractNavigator::suspend(), and mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds().
|
protectedinherited |
Events generated during navigationStep(), enqueued to be called at the end of the method execution to avoid user code to change the navigator state.
Definition at line 222 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::dispatchPendingNavEvents(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), and waypoints_navigationStep().
|
protectedinherited |
The navigator-robot interface.
Definition at line 268 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::changeSpeeds(), mrpt::nav::CAbstractNavigator::changeSpeedsNOP(), mrpt::nav::CAbstractNavigator::dispatchPendingNavEvents(), mrpt::nav::CReactiveNavigationSystem::implementSenseObstacles(), mrpt::nav::CReactiveNavigationSystem3D::implementSenseObstacles(), mrpt::nav::CNavigatorManualSequence::initialize(), mrpt::nav::CAbstractNavigator::internal_onStartNewNavigation(), mrpt::nav::CNavigatorManualSequence::navigationStep(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractNavigator::stop(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), and waypoints_navigationStep().
|
protectedinherited |
Time logger to collect delay-related stats.
Definition at line 291 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CReactiveNavigationSystem::implementSenseObstacles(), mrpt::nav::CReactiveNavigationSystem3D::implementSenseObstacles(), mrpt::nav::CAbstractNavigator::navigationStep(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::nav::CAbstractPTGBasedReactive::STEP8_GenerateLogRecord(), mrpt::nav::CAbstractNavigator::updateCurrentPoseAndSpeeds(), and waypoints_navigationStep().
|
protected |
Whether the last timestep was "is_aligning" in a waypoint with heading.
Definition at line 115 of file CWaypointsNavigator.h.
Referenced by onNavigateCommandReceived(), and waypoints_navigationStep().
|
protected |
The latest waypoints navigation command and the up-to-date control status.
Definition at line 99 of file CWaypointsNavigator.h.
Referenced by cancel(), checkHasReachedTarget(), getWaypointNavStatus(), navigateWaypoints(), onNavigateCommandReceived(), and waypoints_navigationStep().
|
inherited |
Definition at line 187 of file CAbstractNavigator.h.
Referenced by mrpt::nav::CAbstractNavigator::loadConfigFile(), mrpt::nav::CAbstractNavigator::performNavigationStepNavigating(), and mrpt::nav::CAbstractNavigator::saveConfigFile().
TWaypointsNavigatorParams mrpt::nav::CWaypointsNavigator::params_waypoints_navigator |
Definition at line 93 of file CWaypointsNavigator.h.
Referenced by loadConfigFile(), saveConfigFile(), and waypoints_navigationStep().
Page generated by Doxygen 1.8.14 for MRPT 1.5.7 Git: 5902e14cc Wed Apr 24 15:04:01 2019 +0200 at lun oct 28 01:39:17 CET 2019 |