Making changes to any of the following variables may decrease system safety. It is recommended that users only modify these parameters in consultation with Clearpath Robotics Support.
Changes to any of the following variables will only take effect after power cycling the UGV.
The OutdoorNav Software contains a set of features that can be enabled
or disabled according to your required application requirements. These
features can be enabled or disabled through the use of environment
variables, which should be added to the
/opt/onav/<onav_version>/config/autonomy.env file, where onav_version
is the currently running version of OutdoorNav. The following table describes
the available features, their default state and any additional parameters
that we expose that may also be included to tune the feature.
|Collision avoidance is the UGV's ability to detect obstacles and stop/maneuver around the obstacle without any collisions. If
true, the UGV will detect obstacles and if
false no obstacles will be detected. Setting to
false is not recommended and may cause harm to property or to individuals.
|The constrained replanning feature, which is always enabled, restricts the area in which the UGV can plan paths. For example, if the default
PATH_CONSTRAINT of 3.0 m is used, the UGV will not be allowed to 1) produce paths that drives it more than 3.0 meters from the initial path, and 2) fail to compute paths if the UGV is further than 3.0 meters from the any of the Waypoints. This allowable planning/navigation area can be shown on the map over the connecting lines between Waypoints. See Constrained Replanning for further details.
PATH_CONSTRAINT environment variable to modify the path constraint (in meters).
|Generate paths according to a specified turning radius.
TURN_RADIUS environment variable to modify the radius of the planned paths (in meters).
|The stop distance feature allows the UGV to stop a predefined distance away from obstacles. This is useful if a UGV cannot drive in reverse and needs the required room in front of it to replan around an obstacle.
STOP_DISTANCE environment variable to modify the stop distance (in meters). Note that if the stop distance is larger than 4.5 meters for the Clearpath Robotics Jackal and Husky UGVs, or 10.0 meters for the Clearpath Robotics Warthog UGV, the computational load will increase and may cause a decrease in performance in the navigation.
|The delay compensation feature is able to compensate for mechanical delay on UGVs where either the accelerator introduces delay into the linear velocity or the steering introduces delay in the angular velocity. This feature is not required for Clearpath Robotics UGVs as negligible delay is present in our system.
CONTROLLER_DELAY environment variable to modify the amount of delay to be compensated (in milliseconds).
|If purchased, autonomous docking will allow the user to autonomously dock/undock their UGV. If not purchased, enabling this environment variable will do nothing.