参考链接
官方github：https://github.com/MichaelGrupp/evo
一、 指令分析
1.1 tum数据集，evo_ape指令
evo_ape {kitti,tum,euroc,bag} -h
evo_ape tum -h
(1) 终端输入：
evo_ape tum -h
(2) 终端打印：
usage: evo_ape tum [-h][-r {full,trans_part,rot_part,angle_deg,angle_rad,point_distance}][-a] [-s] [--n_to_align N_TO_ALIGN] [--align_origin] [-p][--plot_mode {xy,xz,yx,yz,zx,zy,xyz}][--plot_x_dimension {index,seconds,distances}][--plot_colormap_max PLOT_COLORMAP_MAX][--plot_colormap_min PLOT_COLORMAP_MIN][--plot_colormap_max_percentile PLOT_COLORMAP_MAX_PERCENTILE][--plot_full_ref] [--ros_map_yaml ROS_MAP_YAML][--save_plot SAVE_PLOT] [--serialize_plot SERIALIZE_PLOT][--save_results SAVE_RESULTS] [--logfile LOGFILE][--no_warnings] [-v] [--silent] [--debug] [-c CONFIG][--t_max_diff T_MAX_DIFF] [--t_offset T_OFFSET][--t_start T_START] [--t_end T_END]ref_file est_fileAbsolute pose error (APE) metric app for TUM trajectory files - (c) evo
authorspositional arguments:ref_file reference trajectory fileest_file estimated trajectory fileoptional arguments:-h, --help show this help message and exit--t_max_diff T_MAX_DIFFmaximum timestamp difference for data association--t_offset T_OFFSET constant timestamp offset for data association--t_start T_START only use data with timestamps greater or equal thisstart time--t_end T_END only use data with timestamps less or equal this endtimealgorithm options:-r {full,trans_part,rot_part,angle_deg,angle_rad,point_distance}, --pose_relation {full,trans_part,rot_part,angle_deg,angle_rad,point_distance}pose relation on which the APE is based-a, --align alignment with Umeyama's method (no scale)-s, --correct_scale correct scale with Umeyama's method--n_to_align N_TO_ALIGNthe number of poses to use for Umeyama alignment,counted from the start (default: all)--align_origin align the trajectory origin to the origin of thereference trajectoryoutput options:-p, --plot show plot window--plot_mode {xy,xz,yx,yz,zx,zy,xyz}the axes for plot projection--plot_x_dimension {index,seconds,distances}dimension that is used on the x-axis of the raw valueplot(default: seconds, or index if no timestamps arepresent)--plot_colormap_max PLOT_COLORMAP_MAXthe upper bound used for the color map plot (default:maximum error value)--plot_colormap_min PLOT_COLORMAP_MINthe lower bound used for the color map plot (default:minimum error value)--plot_colormap_max_percentile PLOT_COLORMAP_MAX_PERCENTILEpercentile of the error distribution to be used as theupper bound of the color map plot (in %, overrides--plot_colormap_max)--plot_full_ref plot the full, unsynchronized reference trajectory--ros_map_yaml ROS_MAP_YAMLyaml file of an ROS 2D map image (.pgm/.png) that willbe drawn into the plot--save_plot SAVE_PLOTpath to save plot--serialize_plot SERIALIZE_PLOTpath to serialize plot (experimental)--save_results SAVE_RESULTS.zip file path to store results--logfile LOGFILE Local logfile path.usability options:--no_warnings no warnings requiring user confirmation-v, --verbose verbose output--silent don't print any output--debug verbose output with additional debug info-c CONFIG, --config CONFIG.json file with parameters (priority over command lineargs)
(3) 终端打印解释：
这段内容是 evo_ape 工具的命令行帮助信息，它提供了如何使用该工具来计算TUM轨迹文件的绝对位姿误差（Absolute Pose Error, APE）的详细说明。evo_ape 是一个用于评估视觉里程计（VO）或同时定位与建图（SLAM）系统性能的工具，特别是针对TUM数据集中的轨迹文件。
以下是命令行参数的解释：
位置参数：
ref_file：参考轨迹文件，通常是ground truth轨迹。est_file：估计轨迹文件，即你的视觉里程计或SLAM系统生成的轨迹。
可选参数：
-h, --help：显示帮助信息并退出。--t_max_diff T_MAX_DIFF：数据关联的最大时间戳差异。--t_offset T_OFFSET：数据关联的恒定时间戳偏移。--t_start T_START：只使用时间戳大于或等于这个开始时间的数据。--t_end T_END：只使用时间戳小于或等于这个结束时间的数据。
算法选项：
-r {full,trans_part,rot_part,angle_deg,angle_rad,point_distance}, --pose_relation {full,trans_part,rot_part,angle_deg,angle_rad,point_distance}：基于哪种位姿关系计算APE。-a, --align：使用Umeyama方法（不包括尺度）进行对齐。-s, --correct_scale：使用Umeyama方法进行尺度校正。--n_to_align N_TO_ALIGN：用于Umeyama对齐的位姿数量，从开始计数（默认：全部）。--align_origin：将轨迹原点与参考轨迹的原点对齐。
输出选项：
-p, --plot：显示绘图窗口。--plot_mode {xy,xz,yx,yz,zx,zy,xyz}：绘图投影的轴。--plot_x_dimension {index,seconds,distances}：用于原始值绘图的x轴的维度（默认：秒，或者如果没有时间戳则为索引）。--plot_colormap_max PLOT_COLORMAP_MAX：用于颜色图绘图的上界（默认：最大误差值）。--plot_colormap_min PLOT_COLORMAP_MIN：用于颜色图绘图的下界（默认：最小误差值）。--plot_colormap_max_percentile PLOT_COLORMAP_MAX_PERCENTILE：用作颜色图绘图上界的误差分布的百分位数（%，覆盖--plot_colormap_max）。--plot_full_ref：绘制完整的、未同步的参考轨迹。--ros_map_yaml ROS_MAP_YAML：ROS 2D地图图像（.pgm/.png）的yaml文件，将被绘制在绘图中。--save_plot SAVE_PLOT：保存绘图的路径。--serialize_plot SERIALIZE_PLOT：序列化绘图的路径（实验性）。--save_results SAVE_RESULTS：存储结果的.zip文件路径。--logfile LOGFILE：本地日志文件路径。
可用性选项：
--no_warnings：不显示需要用户确认的警告。-v, --verbose：详细输出。--silent：不打印任何输出。--debug：带有额外调试信息的详细输出。-c CONFIG, --config CONFIG：带有参数的.json文件（优先级高于命令行参数）。
这个工具主要用于研究和开发中，以评估和比较不同视觉里程计或SLAM系统的精度和鲁棒性。通过计算估计轨迹与参考轨迹之间的误差，研究人员和开发者可以了解他们系统的优缺点，并据此进行改进。
(4) 额外说明：
-va与-v -a
当你运行 evo_ape -va 命令时，这里的 -v 和 -a 是两个命令行参数：
-
-v：这是--verbose的简写形式，表示启用详细输出模式。启用这个选项后，evo_ape会输出更多的信息，包括处理过程中的中间步骤和额外的细节，这有助于用户了解评估过程的具体情况和诊断潜在的问题。 -
-a：这是--align的简写形式，表示启用Umeyama算法进行位姿对齐。Umeyama算法是一种著名的点云配准方法，它可以在不考虑尺度变化的情况下，通过最小化两组点云之间的误差来估计它们之间的旋转和平移关系。在评估轨迹时，这个选项可以用来对齐参考轨迹和估计轨迹，以便更准确地计算它们之间的误差。
因此，evo_ape -va 命令的作用是启用详细输出模式，并在计算APE之前对参考轨迹和估计轨迹进行对齐。这通常用于调试和优化视觉里程计或SLAM系统，因为它提供了足够的信息来分析系统的准确性和鲁棒性，并帮助开发者理解系统在哪些方面可能需要改进。
1.2 tum数据集，evo_traj指令
(1) 终端输入：
evo_traj tum -h
(2) 终端打印：
usage: evo_traj tum [-h] [-f] [-a] [-s] [--n_to_align N_TO_ALIGN][--align_origin] [--sync][--transform_left TRANSFORM_LEFT][--transform_right TRANSFORM_RIGHT][--propagate_transform] [--invert_transform] [--ref REF][--t_offset T_OFFSET] [--t_max_diff T_MAX_DIFF] [--merge][-p] [--plot_relative_time][--plot_mode {xy,xz,yx,yz,zx,zy,xyz}][--ros_map_yaml ROS_MAP_YAML] [--save_plot SAVE_PLOT][--save_table SAVE_TABLE][--serialize_plot SERIALIZE_PLOT] [--save_as_tum][--save_as_kitti] [--save_as_bag] [--logfile LOGFILE][--no_warnings] [-v] [--show_full_names] [--silent][--debug] [-c CONFIG]traj_files [traj_files ...]trajectory analysis and manipulation tool for TUM trajectory files - (c) evo
authorspositional arguments:traj_files one or multiple trajectory filesoptional arguments:-h, --help show this help message and exit-f, --full_check run all checks and print all statsalgorithm options:-a, --align alignment with Umeyama's method (no scale) - requires--ref-s, --correct_scale scale correction with Umeyama's method - requires--ref--n_to_align N_TO_ALIGNthe number of poses to use for Umeyama alignment,counted from the start (default: all)--align_origin align the trajectory origin to the origin of thereference trajectory--sync associate trajectories via matching timestamps -requires --ref--transform_left TRANSFORM_LEFTpath to a .json file with a transformation to apply tothe trajectories (left multiplicative)--transform_right TRANSFORM_RIGHTpath to a .json file with a transformation to apply tothe trajectories (right_multiplicative)--propagate_transformwith --transform_right: transform each pose andpropagate resulting drift to the next.--invert_transform invert the transformation of the .json file--ref REF trajectory that will be marked/used as the reference--t_offset T_OFFSET add a constant timestamp offset (not adding to --reftrajectory)--t_max_diff T_MAX_DIFFmaximum timestamp difference for data association--merge merge the trajectories in a single trajectoryoutput options:-p, --plot show plot window--plot_relative_time show timestamps relative to the start of the reference--plot_mode {xy,xz,yx,yz,zx,zy,xyz}the axes for plot projection--ros_map_yaml ROS_MAP_YAMLyaml file of an ROS 2D map image (.pgm/.png) that willbe drawn into the plot--save_plot SAVE_PLOTpath to save plot--save_table SAVE_TABLEpath to save table with statistics--serialize_plot SERIALIZE_PLOTpath to serialize plot (experimental)--save_as_tum save trajectories in TUM format (as *.tum)--save_as_kitti save poses in KITTI format (as *.kitti)--save_as_bag save trajectories in ROS bag as <date>.bag--logfile LOGFILE Local logfile path.usability options:--no_warnings no warnings requiring user confirmation-v, --verbose verbose output--show_full_names don't shorten input file paths when displayingtrajectory names--silent don't print any output--debug verbose output with additional debug info-c CONFIG, --config CONFIG.json file with parameters (priority over command lineargs)
(3) 终端打印的解释
evo_traj 是一个用于分析和操作TUM轨迹文件的工具。它提供了多种功能，包括轨迹对齐、尺度校正、时间戳同步、转换应用、合并轨迹等。以下是命令行参数的详细解释：
位置参数：
traj_files：一个或多个轨迹文件。
可选参数：
-h, --help：显示帮助信息并退出。-f, --full_check：运行所有检查并打印所有统计信息。
算法选项：
-a, --align：使用Umeyama方法进行对齐（不包括尺度）-需要指定--ref。-s, --correct_scale：使用Umeyama方法进行尺度校正-需要指定--ref。--n_to_align N_TO_ALIGN：用于Umeyama对齐的位姿数量，从开始计数（默认：全部）。--align_origin：将轨迹原点与参考轨迹的原点对齐。--sync：通过匹配时间戳来关联轨迹-需要指定--ref。--transform_left TRANSFORM_LEFT：左乘法变换的.json文件路径，用于应用于轨迹的变换。--transform_right TRANSFORM_RIGHT：右乘法变换的.json文件路径，用于应用于轨迹的变换。--propagate_transform：与--transform_right一起使用：变换每个位姿，并将结果漂移到下一个位姿。--invert_transform：反转.json文件中的变换。--ref REF：将被标记/用作参考的轨迹。--t_offset T_OFFSET：添加一个恒定的时间戳偏移（不添加到--ref轨迹）。--t_max_diff T_MAX_DIFF：数据关联的最大时间戳差异。--merge：将轨迹合并为单个轨迹。
输出选项：
-p, --plot：显示绘图窗口。--plot_relative_time：显示相对于参考开始的时间戳。--plot_mode {xy,xz,yx,yz,zx,zy,xyz}：绘图投影的轴。--ros_map_yaml ROS_MAP_YAML：ROS 2D地图图像（.pgm/.png）的yaml文件路径，将被绘制在绘图中。--save_plot SAVE_PLOT：保存绘图的路径。--save_table SAVE_TABLE：保存统计表格的路径。--serialize_plot SERIALIZE_PLOT：序列化绘图的路径（实验性）。--save_as_tum：以TUM格式（*.tum）保存轨迹。--save_as_kitti：以KITTI格式（*.kitti）保存位姿。--save_as_bag：以ROS bag格式（.bag）保存轨迹。--logfile LOGFILE：本地日志文件路径。
可用性选项：
--no_warnings：不显示需要用户确认的警告。-v, --verbose：详细输出。--show_full_names：在显示轨迹名称时不缩短输入文件路径。--silent：不打印任何输出。--debug：带有额外调试信息的详细输出。-c CONFIG, --config CONFIG：带有参数的.json文件（优先级高于命令行参数）。
这个工具主要用于研究和开发中，以分析和比较不同视觉里程计或SLAM系统的轨迹。通过计算和可视化轨迹之间的差异，研究人员和开发者可以了解他们系统的准确性和鲁棒性，并据此进行改进。