MRPT
2.0.4
|
An implementation of the holonomic reactive navigation method "Nearness-Diagram".
The algorithm "Nearness-Diagram" was proposed in:
Nearness diagram (ND) navigation: collision avoidance in troublesome scenarios, IEEE Transactions on Robotics and Automation, Minguez, J. and Montano, L., vol. 20, no. 1, pp. 45-59, 2004.
These are the optional parameters of the method which can be set by means of a configuration file passed to the constructor or to CHolonomicND::initialize() or directly in CHolonomicND::options
Definition at line 52 of file CHolonomicND.h.
#include <mrpt/nav/holonomic/CHolonomicND.h>
Classes | |
struct | TGap |
The structure used to store a detected gap in obstacles. More... | |
struct | TOptions |
Algorithm options. More... | |
Public Types | |
enum | TSituations { SITUATION_TARGET_DIRECTLY = 1, SITUATION_SMALL_GAP, SITUATION_WIDE_GAP, SITUATION_NO_WAY_FOUND } |
The set of posible situations for each trajectory. More... | |
using | TGapArray = std::vector< TGap > |
Public Member Functions | |
CHolonomicND (const mrpt::config::CConfigFileBase *INI_FILE=nullptr) | |
Initialize the parameters of the navigator, from some configuration file, or default values if set to nullptr. More... | |
void | navigate (const NavInput &ni, NavOutput &no) override |
Invokes the holonomic navigation algorithm itself. More... | |
void | initialize (const mrpt::config::CConfigFileBase &INI_FILE) override |
Initialize the parameters of the navigator. More... | |
void | saveConfigFile (mrpt::config::CConfigFileBase &c) const override |
saves all available parameters, in a forma loadable by initialize() More... | |
double | getTargetApproachSlowDownDistance () const override |
Returns the actual value of this parameter [m], as set via the children class options structure. More... | |
void | setTargetApproachSlowDownDistance (const double dist) override |
Sets the actual value of this parameter [m]. More... | |
void | setConfigFileSectionName (const std::string §Name) |
Defines the name of the section used in initialize() More... | |
std::string | getConfigFileSectionName () const |
Gets the name of the section used in initialize() More... | |
void | setAssociatedPTG (mrpt::nav::CParameterizedTrajectoryGenerator *ptg) |
Optionally, sets the associated PTG, just in case a derived class requires this info (not required for methods where the robot kinematics are totally abstracted) More... | |
mrpt::nav::CParameterizedTrajectoryGenerator * | getAssociatedPTG () const |
Returns the pointer set by setAssociatedPTG() More... | |
void | enableApproachTargetSlowDown (bool enable) |
virtual mxArray * | writeToMatlab () const |
Introduces a pure virtual method responsible for writing to a mxArray Matlab object, typically a MATLAB struct whose contents are documented in each derived class. More... | |
RTTI classes and functions for polymorphic hierarchies | |
mrpt::rtti::CObject::Ptr | duplicateGetSmartPtr () const |
Makes a deep copy of the object and returns a smart pointer to it. More... | |
Static Public Member Functions | |
static CAbstractHolonomicReactiveMethod::Ptr | Factory (const std::string &className) noexcept |
static CAbstractHolonomicReactiveMethod * | Create (const std::string &className) noexcept |
Class factory from class name, e.g. More... | |
Public Attributes | |
TOptions | options |
Parameters of the algorithm (can be set manually or loaded from CHolonomicND::initialize or options.loadFromConfigFile(), etc.) More... | |
Protected Member Functions | |
CSerializable virtual methods | |
uint8_t | serializeGetVersion () const override |
Must return the current versioning number of the object. More... | |
void | serializeTo (mrpt::serialization::CArchive &out) const override |
Pure virtual method for writing (serializing) to an abstract archive. More... | |
void | serializeFrom (mrpt::serialization::CArchive &in, uint8_t serial_version) override |
Pure virtual method for reading (deserializing) from an abstract archive. More... | |
CSerializable virtual methods | |
virtual void | serializeTo (CSchemeArchiveBase &out) const |
Virtual method for writing (serializing) to an abstract schema based archive. More... | |
virtual void | serializeFrom (CSchemeArchiveBase &in) |
Virtual method for reading (deserializing) from an abstract schema based archive. More... | |
Protected Attributes | |
mrpt::nav::CParameterizedTrajectoryGenerator * | m_associatedPTG |
If applicable, this will contain the argument of the most recent call to setAssociatedPTG() More... | |
bool | m_enableApproachTargetSlowDown |
Whether to decrease speed when approaching target. More... | |
Private Member Functions | |
unsigned int | direction2sector (const double a, const unsigned int N) |
void | gapsEstimator (const std::vector< double > &obstacles, const mrpt::math::TPoint2D &in_target, TGapArray &gaps) |
Find gaps in the obtacles. More... | |
void | searchBestGap (const std::vector< double > &in_obstacles, const double in_maxObsRange, const TGapArray &in_gaps, const mrpt::math::TPoint2D &in_target, unsigned int &out_selDirection, double &out_selEvaluation, TSituations &out_situation, double &out_riskEvaluation, CLogFileRecord_ND &log) |
Search the best gap. More... | |
void | calcRepresentativeSectorForGap (TGap &gap, const mrpt::math::TPoint2D &target, const std::vector< double > &obstacles) |
Fills in the representative sector field in the gap structure: More... | |
void | evaluateGaps (const std::vector< double > &in_obstacles, const double in_maxObsRange, const TGapArray &in_gaps, const unsigned int TargetSector, const float TargetDist, std::vector< double > &out_gaps_evaluation) |
Evaluate each gap: More... | |
Private Attributes | |
unsigned int | m_last_selected_sector |
RTTI stuff | |
using | Ptr = std::shared_ptr< mrpt::nav ::CHolonomicND > |
using | ConstPtr = std::shared_ptr< const mrpt::nav ::CHolonomicND > |
using | UniquePtr = std::unique_ptr< mrpt::nav ::CHolonomicND > |
using | ConstUniquePtr = std::unique_ptr< const mrpt::nav ::CHolonomicND > |
static const mrpt::rtti::TRuntimeClassId | runtimeClassId |
static constexpr const char * | className = "mrpt::nav" "::" "CHolonomicND" |
static const mrpt::rtti::TRuntimeClassId * | _GetBaseClass () |
static constexpr auto | getClassName () |
static const mrpt::rtti::TRuntimeClassId & | GetRuntimeClassIdStatic () |
static std::shared_ptr< CObject > | CreateObject () |
template<typename... Args> | |
static Ptr | Create (Args &&... args) |
template<typename Alloc , typename... Args> | |
static Ptr | CreateAlloc (const Alloc &alloc, Args &&... args) |
template<typename... Args> | |
static UniquePtr | CreateUnique (Args &&... args) |
virtual const mrpt::rtti::TRuntimeClassId * | GetRuntimeClass () const override |
Returns information about the class of an object in runtime. More... | |
virtual mrpt::rtti::CObject * | clone () const override |
Returns a deep copy (clone) of the object, indepently of its class. More... | |
using mrpt::nav::CHolonomicND::ConstPtr = std::shared_ptr<const mrpt::nav :: CHolonomicND > |
Definition at line 54 of file CHolonomicND.h.
using mrpt::nav::CHolonomicND::ConstUniquePtr = std::unique_ptr<const mrpt::nav :: CHolonomicND > |
Definition at line 54 of file CHolonomicND.h.
using mrpt::nav::CHolonomicND::Ptr = std::shared_ptr< mrpt::nav :: CHolonomicND > |
A type for the associated smart pointer
Definition at line 54 of file CHolonomicND.h.
using mrpt::nav::CHolonomicND::TGapArray = std::vector<TGap> |
Definition at line 73 of file CHolonomicND.h.
using mrpt::nav::CHolonomicND::UniquePtr = std::unique_ptr< mrpt::nav :: CHolonomicND > |
Definition at line 54 of file CHolonomicND.h.
The set of posible situations for each trajectory.
(mrpt::typemeta::TEnumType works with this enum)
Enumerator | |
---|---|
SITUATION_TARGET_DIRECTLY | |
SITUATION_SMALL_GAP | |
SITUATION_WIDE_GAP | |
SITUATION_NO_WAY_FOUND |
Definition at line 77 of file CHolonomicND.h.
mrpt::nav::CHolonomicND::CHolonomicND | ( | const mrpt::config::CConfigFileBase * | INI_FILE = nullptr | ) |
Initialize the parameters of the navigator, from some configuration file, or default values if set to nullptr.
|
staticprotected |
|
private |
Fills in the representative sector field in the gap structure:
Definition at line 445 of file CHolonomicND.cpp.
References mrpt::abs_diff(), dir, mrpt::nav::CHolonomicND::TGap::end, mrpt::nav::CHolonomicND::TGap::ini, mrpt::keep_max(), mrpt::keep_min(), mrpt::nav::CHolonomicND::TGap::representative_sector, mrpt::round(), mrpt::math::TPoint2D_data< T >::x, and mrpt::math::TPoint2D_data< T >::y.
|
overridevirtual |
Returns a deep copy (clone) of the object, indepently of its class.
Implements mrpt::rtti::CObject.
|
inlinestatic |
Definition at line 54 of file CHolonomicND.h.
|
staticnoexceptinherited |
Class factory from class name, e.g.
"CHolonomicVFF"
, etc.
std::logic_error | On invalid or missing parameters. |
|
inlinestatic |
Definition at line 54 of file CHolonomicND.h.
|
static |
|
inlinestatic |
Definition at line 54 of file CHolonomicND.h.
|
private |
Definition at line 608 of file CHolonomicND.cpp.
References M_PI, mrpt::round(), and mrpt::math::wrapToPi().
|
inlineinherited |
Makes a deep copy of the object and returns a smart pointer to it.
Definition at line 204 of file CObject.h.
References mrpt::rtti::CObject::clone().
Referenced by mrpt::obs::CRawlog::insert().
|
inlineinherited |
Definition at line 119 of file CAbstractHolonomicReactiveMethod.h.
References mrpt::nav::CAbstractHolonomicReactiveMethod::m_enableApproachTargetSlowDown.
Referenced by mrpt::nav::CAbstractPTGBasedReactive::build_movement_candidate().
|
private |
Evaluate each gap:
Definition at line 508 of file CHolonomicND.cpp.
References mrpt::abs_diff(), ASSERT_, mrpt::nav::CHolonomicND::TGap::end, mrpt::containers::end(), mrpt::nav::CHolonomicND::TGap::ini, mrpt::min3(), mrpt::math::minimumDistanceFromPointToSegment(), mrpt::nav::CHolonomicND::TGap::representative_sector, mrpt::square(), and mrpt::math::sum().
|
staticnoexceptinherited |
Definition at line 51 of file CAbstractHolonomicReactiveMethod.cpp.
References mrpt::rtti::TRuntimeClassId::createObject(), mrpt::rtti::findRegisteredClass(), mrpt::ptr_cast< CAST_TO >::from(), and mrpt::rtti::registerAllPendingClasses().
Referenced by mrpt::nav::CAbstractPTGBasedReactive::setHolonomicMethod().
|
private |
Find gaps in the obtacles.
Definition at line 131 of file CHolonomicND.cpp.
References ASSERT_, mrpt::nav::CHolonomicND::TGap::end, mrpt::containers::end(), mrpt::nav::CHolonomicND::TGap::ini, mrpt::keep_max(), mrpt::keep_min(), mrpt::nav::CHolonomicND::TGap::maxDistance, mrpt::nav::CHolonomicND::TGap::minDistance, and mrpt::math::TPoint2D_< T >::norm().
|
inherited |
Returns the pointer set by setAssociatedPTG()
Definition at line 46 of file CAbstractHolonomicReactiveMethod.cpp.
References mrpt::nav::CAbstractHolonomicReactiveMethod::m_associatedPTG.
|
inlinestatic |
Definition at line 54 of file CHolonomicND.h.
|
inherited |
Gets the name of the section used in initialize()
Definition at line 35 of file CAbstractHolonomicReactiveMethod.cpp.
References mrpt::nav::CAbstractHolonomicReactiveMethod::m_cfgSectionName.
|
overridevirtual |
Returns information about the class of an object in runtime.
Reimplemented from mrpt::nav::CAbstractHolonomicReactiveMethod.
|
static |
|
inlineoverridevirtual |
Returns the actual value of this parameter [m], as set via the children class options structure.
Implements mrpt::nav::CAbstractHolonomicReactiveMethod.
Definition at line 115 of file CHolonomicND.h.
References options, and mrpt::nav::CHolonomicND::TOptions::TARGET_SLOW_APPROACHING_DISTANCE.
|
overridevirtual |
Initialize the parameters of the navigator.
Implements mrpt::nav::CAbstractHolonomicReactiveMethod.
Definition at line 37 of file CHolonomicND.cpp.
Invokes the holonomic navigation algorithm itself.
See the description of the input/output structures for details on each parameter.
Implements mrpt::nav::CAbstractHolonomicReactiveMethod.
Definition at line 49 of file CHolonomicND.cpp.
References ASSERT_, mrpt::nav::CAbstractHolonomicReactiveMethod::NavOutput::desiredDirection, mrpt::nav::CAbstractHolonomicReactiveMethod::NavOutput::desiredSpeed, mrpt::nav::CAbstractHolonomicReactiveMethod::NavOutput::logRecord, mrpt::nav::CAbstractHolonomicReactiveMethod::NavInput::maxRobotSpeed, mrpt::nav::CAbstractHolonomicReactiveMethod::NavInput::obstacles, and mrpt::nav::CAbstractHolonomicReactiveMethod::NavInput::targets.
|
overridevirtual |
saves all available parameters, in a forma loadable by initialize()
Implements mrpt::nav::CAbstractHolonomicReactiveMethod.
Definition at line 41 of file CHolonomicND.cpp.
|
private |
Search the best gap.
Definition at line 294 of file CHolonomicND.cpp.
References mrpt::nav::CHolonomicND::TGap::end, mrpt::nav::CLogFileRecord_ND::gaps_eval, mrpt::nav::CHolonomicND::TGap::ini, mrpt::math::TPoint2D_< T >::norm(), mrpt::round(), mrpt::math::TPoint2D_data< T >::x, and mrpt::math::TPoint2D_data< T >::y.
|
overrideprotectedvirtual |
Pure virtual method for reading (deserializing) from an abstract archive.
Users don't call this method directly. Instead, use stream >> object;
.
in | The input binary stream where the object data must read from. |
version | The version of the object stored in the stream: use this version number in your code to know how to read the incoming data. |
std::exception | On any I/O error |
Implements mrpt::serialization::CSerializable.
Definition at line 731 of file CHolonomicND.cpp.
References mrpt::nav::CHolonomicND::TOptions::factorWeights, m_last_selected_sector, mrpt::nav::CHolonomicND::TOptions::MAX_SECTOR_DIST_FOR_D2_PERCENT, MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION, options, mrpt::nav::CHolonomicND::TOptions::RISK_EVALUATION_DISTANCE, mrpt::nav::CHolonomicND::TOptions::RISK_EVALUATION_SECTORS_PERCENT, mrpt::nav::CHolonomicND::TOptions::TARGET_SLOW_APPROACHING_DISTANCE, mrpt::nav::CHolonomicND::TOptions::TOO_CLOSE_OBSTACLE, and mrpt::nav::CHolonomicND::TOptions::WIDE_GAP_SIZE_PERCENT.
|
inlineprotectedvirtualinherited |
Virtual method for reading (deserializing) from an abstract schema based archive.
Definition at line 74 of file CSerializable.h.
References mrpt::serialization::CSerializable::GetRuntimeClass(), and THROW_EXCEPTION.
|
overrideprotectedvirtual |
Must return the current versioning number of the object.
Start in zero for new classes, and increments each time there is a change in the stored format.
Implements mrpt::serialization::CSerializable.
Definition at line 719 of file CHolonomicND.cpp.
|
overrideprotectedvirtual |
Pure virtual method for writing (serializing) to an abstract archive.
Users don't call this method directly. Instead, use stream << object;
.
std::exception | On any I/O error |
Implements mrpt::serialization::CSerializable.
Definition at line 720 of file CHolonomicND.cpp.
References mrpt::nav::CHolonomicND::TOptions::factorWeights, m_last_selected_sector, mrpt::nav::CHolonomicND::TOptions::MAX_SECTOR_DIST_FOR_D2_PERCENT, options, out, mrpt::nav::CHolonomicND::TOptions::RISK_EVALUATION_DISTANCE, mrpt::nav::CHolonomicND::TOptions::RISK_EVALUATION_SECTORS_PERCENT, mrpt::nav::CHolonomicND::TOptions::TARGET_SLOW_APPROACHING_DISTANCE, mrpt::nav::CHolonomicND::TOptions::TOO_CLOSE_OBSTACLE, and mrpt::nav::CHolonomicND::TOptions::WIDE_GAP_SIZE_PERCENT.
|
inlineprotectedvirtualinherited |
Virtual method for writing (serializing) to an abstract schema based archive.
Definition at line 64 of file CSerializable.h.
References mrpt::serialization::CSerializable::GetRuntimeClass(), and THROW_EXCEPTION.
|
inherited |
Optionally, sets the associated PTG, just in case a derived class requires this info (not required for methods where the robot kinematics are totally abstracted)
Definition at line 40 of file CAbstractHolonomicReactiveMethod.cpp.
References mrpt::nav::CAbstractHolonomicReactiveMethod::m_associatedPTG.
|
inherited |
Defines the name of the section used in initialize()
Defines the name of the section (Default: "FULL_EVAL_CONFIG")
Definition at line 30 of file CAbstractHolonomicReactiveMethod.cpp.
References mrpt::nav::CAbstractHolonomicReactiveMethod::m_cfgSectionName.
|
inlineoverridevirtual |
Sets the actual value of this parameter [m].
Implements mrpt::nav::CAbstractHolonomicReactiveMethod.
Definition at line 119 of file CHolonomicND.h.
References options, and mrpt::nav::CHolonomicND::TOptions::TARGET_SLOW_APPROACHING_DISTANCE.
|
inlinevirtualinherited |
Introduces a pure virtual method responsible for writing to a mxArray
Matlab object, typically a MATLAB struct
whose contents are documented in each derived class.
mxArray
(caller is responsible of memory freeing) or nullptr is class does not support conversion to MATLAB. Definition at line 90 of file CSerializable.h.
|
static |
Definition at line 54 of file CHolonomicND.h.
|
protectedinherited |
If applicable, this will contain the argument of the most recent call to setAssociatedPTG()
Definition at line 127 of file CAbstractHolonomicReactiveMethod.h.
Referenced by mrpt::nav::CAbstractHolonomicReactiveMethod::getAssociatedPTG(), and mrpt::nav::CAbstractHolonomicReactiveMethod::setAssociatedPTG().
|
protectedinherited |
Whether to decrease speed when approaching target.
Definition at line 129 of file CAbstractHolonomicReactiveMethod.h.
Referenced by mrpt::nav::CAbstractHolonomicReactiveMethod::enableApproachTargetSlowDown().
|
private |
Definition at line 125 of file CHolonomicND.h.
Referenced by serializeFrom(), and serializeTo().
TOptions mrpt::nav::CHolonomicND::options |
Parameters of the algorithm (can be set manually or loaded from CHolonomicND::initialize or options.loadFromConfigFile(), etc.)
Definition at line 113 of file CHolonomicND.h.
Referenced by getTargetApproachSlowDownDistance(), serializeFrom(), serializeTo(), and setTargetApproachSlowDownDistance().
|
staticprotected |
Definition at line 54 of file CHolonomicND.h.
Page generated by Doxygen 1.8.14 for MRPT 2.0.4 Git: 33de1d0ad Sat Jun 20 11:02:42 2020 +0200 at sáb jun 20 17:35:17 CEST 2020 |