No version for distro humble showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro jazzy showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro kilted showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro rolling showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro galactic showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro iron showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro melodic showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange

No version for distro noetic showing github. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 3.0.0
License Copyright 2020-2024 OpenDR European Project Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Build type CATKIN
Use RECOMMENDED

Repository Summary

Description A modular, open and non-proprietary toolkit for core robotic functionalities by harnessing deep learning
Checkout URI https://github.com/opendr-eu/opendr.git
VCS Type git
VCS Version master
Last Updated 2025-01-29
Dev Status UNKNOWN
Released UNRELEASED
Tags deep-learning robotics
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

FMP SLAM Evaluation Package

Additional Links

No additional links.

Maintainers

  • Jose Arce

Authors

No additional authors.

FMP SLAM Evaluation

This module includes helper nodes and scripts, useful for characterizing and evaluating the results of some SLAM algorithms.

Nodes

err_collector

This node collects the translational, rotational and total errors computed by another node and stores them in CSV files.

Errors during the full-SLAM (mapping and localization) phase of a run are stored in one file, while (if used) errors measured during the Localization-Only phase are stored in a separate file.

Subscribed Topics

  • doLocOnly (std_msg/Bool):
    When the Localization-Only phase is started and the doLocOnly message is issued, the node switches from saving to the mapping error file to the localization error file.

  • tra_err (std_msg/Float64):
    Translational error of the SLAM corrected pose with respect to the ground truth pose.
  • rot_err (std_msg/Float64):
    Rotational error of the SLAM corrected pose with respect to the ground truth pose.
  • tot_err (std_msg/Float64):
    Total (translational + rotational) error of the SLAM corrected pose with respect to the ground truth pose.

Parameters

  • ~file_path (str, default: ”~/Desktop/Experiments”):
    Directory where the files with the collected errors will be stored in a CSV format.

    Two files are constructed per run: a Mapping and a Localization-Only phase positional error files. The path to the files is constructed as follows:

    <file_path>/<file_prefix><suffix>
    
where:

* ***\<file_prefix\>*** is another parameter, explained in the following entry, and
* ***\<suffix\>*** takes the value of either the *\<mapping\_suffix\>* or
*<localization\_suffix>* parameter depending on the phase of the evaluation.
  • ~file_prefix (str, default: “error_data”):
    Prefix for the file name of both the mapping error, and the localization-only error files.

  • ~mapping_suffix (str, default: “_map”):
    Suffix for the Mapping Phase error file.

  • ~localization_suffix (str, default: “_loc”):
    Suffix for the Localization-Only Phase error file.

fmp_plot

Node for plotting the Full Map Posterior distribution and its properties as color maps. Depending on the parameters, it can either save the plots to a directory, publish them to a topic, or both.

Subscribed Topics

  • map_model (gmapping/mapModel):
    Message specifying whether the SLAM algorithm is using the Reflection or Exponential Decay Rate map model.

    The used measurement likelihood functions and the resulting Map Posterior Distribution will depend on this parameter.

    The parametric, closed-form map posterior distribution will be either a Beta distribution (Beta(x; α, β)) for a Reflection Model, or a Gamma distribution (Gamma(x; α, β)) for Exponential Decay Rate model.

  • fmp_alpha (gmapping/doubleMap):
    Map of the alpha parameter of the distribution (either Beta or Gamma according to the map_model setting).
  • fmp_beta (gmapping/doubleMap):
    Map of the beta parameter of the distribution (either Beta or Gamma according to the map_model setting).

Published Topics

If parameter ~pub_image is set to True, then the node will publish the computed map distribution properties as images under the topics:

  • /<pub_topic_prefix>/<\topic> (sensor_msgs/Image)

where:

  • <pub_topic_prefix>: is a parameter determining the prefix to be used by all published topics.
  • <topic>: are the topic names for the different distribution properties that can be published, namely:
    • stats/mean and stats/var: for the mean and variance of the map posterior.
    • mlm: for the raw, un-thresholded most likely map
    • param/alpha and param/beta: for publishing the distribution’s parameters as images.

Parameters

  • ~img_stat (bool, default: False):
  • ~img_mlm (bool, default: False):
  • ~img_para (bool, default: False):
    If set to true, generate the plots for the statistics (mean and variance), most-likely-map (raw, un-thresholded), and parameter (alpha and beta) respectively.

  • ~pub_img (bool, default: False):
    Publish the generated plots as images if set to true.
  • ~pub_topic_prefix (str, default: “/fmp_img/”):
    Prefix to be prepended to the published map plot topics.

  • ~save_img (bool, default: False):
    Save the generated plots as image files if set to true.
  • ~resolution (int, default: 300):
    Resolution (in ppi) for the saved images.
  • ~path_prefix (str, default: “exp”):
    Prefix of the folder where the images are to be saved. Full folder name is constructed as _, where is the time of execution formatted as *"yymmdd_HHMMSS"*, unless a full path is explicitly set under parameter ***~save_dir***.

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Package Dependencies

System Dependencies

No direct system dependencies.

Dependant Packages

No known dependants.

Launch files

  • launch/experiment.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: false] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: true] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: true] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: true] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • mm [default: dec] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.05] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.0] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: true] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: true] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/default.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(find map_simulator)/rosbags/Robot_10Loop_noisy_3_2pi_180rays.bag] — (string)[Default: path to simulated Robot_10Loop rosbag] Explicit path to ROSBag to execute if 10Loop is not desired.
  • launch/experiment_real_data.launch
      • do_slam [default: true] — (bool)[Default: true] Run the OpenSlam Gmapping Node.
      • do_plots [default: true] — (bool)[Default: true] Run the fmp_plot and occ_map_saver nodes to save the statistical and occupation plots of the map.
      • do_error [default: false] — (bool)[Default: true] Run the pose_error_calc node to save each pose and the relative error of the SLAM corrected pose w.r.t the ground-truth pose.
      • do_gtmap [default: false] — (bool)[Default: true] Run the gt_mapping node for generating the Ground-Truth map.
      • do_odo [default: false] — (bool)[Default: true] Run the gt_mapping node for generation the Pure Odometry map.
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • do_gsp_debug [default: true] — (bool)[Default: true] Output all of the GridSlam Processor data to a csv file.
      • do_coll_err [default: false] — (bool)[Default: false] Collect error values from multiple runs in a single csv file.
      • bag [default: 10Loop] — (string)[Default: 10Loop] Bag file to be opened. If a specific file is to be desired, use the bag_file argument. Can take values of: * 10Loop: for the 10Loop Simulation ROSBag * 10Cell: for the 10Cell Simulation ROSBag
      • mm [default: ref] — (string)[Default: ref] Map Model. Can take values of * ref for Reflection Map or * dec for Exponential Decay Map.
      • pw [default: cmh] — (string)[Default: cmh] Particle weighting method. Can take values of * cmh for Closest Mean Hit, * fsm for Forward Sensor Model and * ml for Measurement Likelihood.
      • alpha0 [default: 1.0] — (float)[Default: 1.0] Value for the alpha parameter of the prior distribution.
      • beta0 [default: $(eval 0.000001 if mm_dcy else 1.0)] — (float)[Default: 1 for Ref, 1e-6 for Dec] Value for the beta parameter of the prior distribution.
      • exp_pfx [default: exp] — (string)[Default: exp] Prefix for the experiment directory.
      • resolution [default: 0.2] — (float)[Default: 0.05] Map resolution in [m].
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • ocuw [default: 0.2] — (float)[Default: 0.0] Weight of a Uniform Distribution to be added to the measurement likelihoods to avoid overconfidence
      • doPoseImprove [default: false] — (bool)[Default: true] Run scan matching for pose improvement if true.
      • publishAvgPose [default: false] — (bool)[Default: true] Use weighted average pose over all particles instead of only the most likely.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • ts [default: 880910_052410] — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • pfx_mm [default: $(eval 'dec' if mm_dcy else 'rfl')]
      • pfx_pw [default: $(eval 'fsm' if pw_fsm else ('ml' if pw_ml else 'cmh'))]
      • path_prefix [default: $(env HOME)/Desktop/Experiments/IndividualExperiments] — Main directory where experiment sub-folders will be created
      • path_save [default: $(arg path_prefix)/$(arg exp_pfx)_$(arg ts)_$(arg pfx_mm)_$(arg pfx_pw)] — (string)[Default: ~/Desktop/Experiments/IndividualExperiments/${exp_pfx}_${ts}_${pfx_mm}_${pfx_pw}/] Path for saving the experiment results.
      • path_log [default: $(arg path_save)/log] — (string)[Default: ${path_save}/log] Path for storing the nodes' logs.
      • path_save_img [default: $(arg path_save)/img] — (string)[Default: ${path_save}/img] Path for storing the result images.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • path_save_err [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the pose error file.
      • path_err_coll_path [default: $(arg path_save)/err] — (string)[Default: ${path_save}/err] Path for storing the accumulated pose error file.
      • path_err_coll_pfx [default: err_coll] — (string)[Default: err_coll] Prefix for the collected error file names.
      • bag_file [default: $(arg path_data)/Freiburg/101/fr101.raw.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/gt_map.launch
      • ts — (string)[Default: 880910_052410] Timestamp to be used for the save directory. It should be set to ts:=`date +'%Y%M%D_%h%m%s'`
      • occ_threshold [default: 0.25] — (float)[Default: 0.25] Threshold for determining whether a cell is occupied or free.
      • max_scan_buffer_len [default: 10000] — (int)[Default: 10000] Maximum size for the scan buffer.
      • resolution [default: 0.2] — (float)[Default: 0.2] Map resolution in [m].
      • do_rviz [default: true] — (bool)[Default: true] Run RVIZ to visualize the progress graphically in real time.
      • sim_pause [default: false] — (bool)[Default: false] Start the ROSbag in a paused state. Recommended to allow for the other nodes to initialize.
      • sim_quiet [default: false] — (bool)[Default: false] Run the ROSbag quietly.
      • path_save [default: $(env HOME)/Desktop/Experiments/DataSetGT/$(arg ts)] — (string)[Default: ~/Desktop/Experiments/DataSetGT/] Path for saving the experiment results.
      • path_save_occ [default: $(arg path_save)/img/occ] — (string)[Default: ${path_save}/img/occ] Path for storing the result occupancy images.
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/gt_map.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Freiburg/079/fr079-complete.gfs.2.bag] — (string)[Default: path to either Robot_10Loop or Robot_10Cell bags depending on $bag] Explicit path to ROSBag to execute if neither 10Loop nor 10Cell are desired.
  • launch/test_computeR.launch
      • cfg_rviz_file [default: $(arg path_cfg_rviz)/experiment.rviz] — (string)[Default: $(find map_simulator)/cfg/rviz/experiment.rviz] Path to an RVIZ configuration file.
      • bag_file [default: $(arg path_data)/Simulations/Robot_CellTest_det_8ray.bag]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged fmp_slam_eval at Robotics Stack Exchange