Template
slamlab_offline_importer: bag_path: "" output_dirpath: "" clouds: - topic: /points # example; all fields are mandatory, an unused list is [] point_stamps: # fields: [] gives all points the header stamp fields: [t] unit: nanosec # options: sec, nanosec relative_to_header: true intensity_field: intensity # "" gives all points intensity 0 stamp_filter: enabled: false min_stamp_sec: 0.0 max_stamp_sec: .inf distance_filter: enabled: true min_distance: 0.01 max_distance: .inf voxel_filter: enabled: false voxel_size: 0.1 method: first # options: first, centroid min_num_points: 1000 imu: - topic: /imu time_offset_sec: 0.0 accelerometer_axes: [x, y, z] gyroscope_axes: [x, y, z] gnss: - topic: /fix time_offset_sec: 0.0 require_fix: true max_sigma: [.inf, .inf, .inf] utm_shift: first_point: false shift: [0.0, 0.0, 0.0] trajectories: - topic: /odom format: tum # options: tum, kitti first_pose_to_identity: true child_T_frame: translation: [0.0, 0.0, 0.0] rotation: [0.0, 0.0, 0.0, 1.0] time_offset_sec: 0.0 images: - topic: /image time_offset_sec: 0.0 stride: 1 grayscale: false scale: 1.0 rotation_deg: 0 # options: -180, -90, 0, 90, 180
slamlab_core: clouds: dirpath: "" distance_filter: enabled: false min_distance: 0.0 max_distance: .inf intensity_filter: enabled: false min_intensity: 0 max_intensity: 2147483647 stride_filter: enabled: false row_interval: 1 col_interval: 1 voxel_filter: enabled: false voxel_size: 0.1 method: first # options: first, centroid, centroid_nn normal_estimation: enabled: false kernel_width: 3 kernel_height: 3 max_roughness: 0.2 voxel_pca: voxel_size: 1.0 min_planarity: 0.0 max_roughness: 0.1
matching: cloud_to_local_map: true cloud_to_prior_map: false
local_map: map_grows: true map_radius: 20.0 min_distance_between_cloud_origins: 1.0 voxel_pca: min_planarity: 0.25 max_roughness: 0.15 min_num_points_per_plane: 1
prior_map: filepath: "" min_distance_between_cloud_origins: 5.0
icp: max_iterations: 5 loss_function: trivial_loss # options: trivial_loss, huber_loss, soft_l_one_loss, cauchy_loss, arctan_loss, tukey_loss solver: ceres # options: ceres, irls cache_mov_voxel_pca: false # build moving-cloud VoxelPCA once & reuse (faster) vs rebuild each ICP iteration max_point_to_plane_distance: 0.4 max_angle_between_normals: 45.0 correspondences_max_weight: 1000.0 sigma_mad_limit: .inf sigma_mad_skip_iterations: 3
loop_closure_detection: enabled: false method: kiss_matcher_plus_icp # options: icp_only, kiss_matcher_plus_icp filter_key_clouds: true min_distance_between_key_cloud_origins: 1.0 num_merged_key_clouds: 1 # odd; merges this many key clouds around each loop closure endpoint before registration, spanning about num_merged_key_clouds * min_distance_between_key_cloud_origins metres. Raising it makes the kiss_matcher inlier thresholds effectively looser, so re-tune them together key_cloud_pair_candidates: max_distance: 15.0 min_time_difference: 20.0 kiss_matcher: min_num_rotation_inliers: 50 # raise to filter out borderline rough alignments; lower to admit looser loop closures min_num_translation_inliers: 50 icp: num_correspondences_acceptance_threshold: 100 # raise to reject weakly overlapping pairs; lower to admit loop closures in sparse scenes drain_pending_attempts_on_stop: false # set true only when the sequence genuinely closes its loop near the very last frame (e.g. kitti seq 09) sleep_between_attempts_sec: 1.0 # pause before each attempt; shorter: more attempts, but the result depends more on the machine load
trajectory: fixed_lag_smoother: enabled: false lag: 60.0 # imu: # optional IMU configuration # accelerometer_sigma: 1.0 # gyroscope_sigma: 1.0 # integration_sigma: 1.0 # accelerometer_bias_sigma: 1.0 # gyroscope_bias_sigma: 1.0 # average_delta_t: 0.0 # acceleration_unit_is_g: false # add_imu_factors_after_sec: 0.0 # absolute_position_measurements: # previous_cloud_idx_offset: 20 # interpolation_max_time_diff_sec: 0.5 # min_elapsed_time_since_last_added_measurement_sec: 0.5 # min_distance_to_last_added_measurement: 5.0 static_transforms: - frame: lidar base_T_frame: translation: [0.0, 0.0, 0.0] # x, y, z rotation: [0.0, 0.0, 0.0, 1.0] # qx, qy, qz, qw initial_base_pose: translation: [0.0, 0.0, 0.0] # x, y, z rotation: [0.0, 0.0, 0.0, 1.0] # qx, qy, qz, qw translation_sigma: 1.0 rotation_sigma: 1.0 clamp_pose_covariance_eigenvalues_to: 1.0e-6 factorization: cholesky # options: cholesky, qr
artifacts: enabled: true dirpath: "" save_densified_trajectory: true estimate_pose_covariances: false save_clouds: enabled: false distance_filter: enabled: false min_distance: 0.0 max_distance: 100.0 intensity_filter: enabled: false min_intensity: 100 max_intensity: 2147483647 stride_filter: enabled: false row_interval: 1 col_interval: 1 normal_estimation: enabled: false kernel_width: 3 kernel_height: 3 additional_attributes: raw_distance: false tiling: enabled: false tile_size: [50, 50, 50] # x, y, z voxel_filter: enabled: false voxel_size: 0.1 method: first # options: first, centroid, centroid_nn generate_prior_map: false
debug_mode: enabled: false dirpath: ""
send_visualization_data: enabled: true
slamlab_global_map: enabled: false cloud_collection: min_distance_between_cloud_origins: 5.0 redeskew_min_translation_change: 0.01 redeskew_min_rotation_change_deg: 0.1 region_of_interest: max_distance_of_cloud_origins_to_last_pose: 10.0 max_age_of_clouds_since_last_pose: 60.0 voxel_filter: enabled: true voxel_size: 0.25 method: first # options: first, center coordinate_filter: enabled: false x_limits: [-.inf, .inf] y_limits: [-.inf, .inf] z_limits: [-.inf, .inf]
slamlab_offline: clouds_dirpath: "" first_cloud_idx: 0 last_cloud_idx: -1 imu_measurements_filepath: "" absolute_position_measurements_filepath: ""
slamlab_visualization: images_dirpath: "" config_filepath: "" mesh_base_frame_filepath: "" mesh_map_frame_filepath: "" slam_host: "127.0.0.1" supersampling_factor: 4 # SSAA render scale (1-4); lower if headless rendering runs out of GPU VRAM and renders black egl_device_index: -1 # headless rendering EGL device index; -1 = auto-select video_recording: enabled: false headless: false fps: 30.0 width: 1920 height: 1080 capture_only_each_nth_frame: 1 hold_last_frame_seconds: 5.0 output_dirpath: "" font_ttf_filepath: "" widgets: [] # info overlays drawn onto the recorded frames; empty = no overlaysslamlab_render: clouds: dirpath: "$CONFIG_DIRPATH$/../04_results/artifacts/clouds_map_frame" # example filters: stamp_filter: enabled: false min_stamp_sec: 0.0 max_stamp_sec: .inf distance_filter: # w.r.t. the trajectory position at the point's stamp enabled: false min_distance: 0.0 max_distance: .inf intensity_filter: enabled: false min_intensity: 0.0 max_intensity: .inf rendering: point_radius: 0.0001 # relative to the scene length scale material: clay # polyscope material; flat (unlit) shows the colors at full strength color: mode: scalar # options: normal (pca attribute), scalar, rgb (red/green/blue attributes) scalar: quantity: intensity # options: absolute_height, intensity, time color_map: rainbow map_range_mode: quantile # options: quantile, absolute map_range: [0.05, 0.95] # quantile fractions, or absolute limits (time: stamps in seconds) trajectory: filepath: "$CONFIG_DIRPATH$/../04_results/artifacts/trajectory_tum.txt" # example stamp_filter: enabled: false min_stamp_sec: 0.0 max_stamp_sec: .inf resampling: # uniform spacing along the arc length; sets the frame count (speed = spacing * fps) enabled: false spacing: 0.1 smoothing: # arc-length weighted local linear fit, weights exp(-distance / (factor * length)) enabled: false factor_position: 0.001 factor_orientation: 0.005 rendering: enabled: false color: [1.0, 1.0, 1.0] radius: 0.00003 # relative to the scene length scale material: clay images: # camera images <sec>.<nsec>.<jpg|jpeg|png> of the $IMAGE$ widget lines enabled: false dirpath: "" use_only_each_nth_image: 1 camera: mode: trajectory # options: trajectory, turntable field_of_view: 90.0 # vertical, in degrees trajectory: base_T_camera: # camera pose relative to the base frame translation: [0.0, 0.0, 0.0] # x, y, z rotation: [0.0, 0.0, 0.0, 1.0] # qx, qy, qz, qw look_dir: x # options: x, y, z, -x, -y, -z up_dir: z turntable: center: auto # auto (cloud bounding-box center) or [x, y, z] distance: auto # auto (fit the cloud's bounding sphere into the field of view) or meters elevation_deg: 30.0 num_frames: 360 revolutions: 1.0 direction: ccw # options: ccw, cw start_angle_deg: 0.0 # 0 = camera on the +x side of the center video: filepath: "$CONFIG_DIRPATH$/../04_results/slamlab-render.mp4" # example width: 1920 height: 1080 fps: 20.0 hold_last_frame_seconds: 0.0 supersampling_factor: 4 headless: false egl_device_index: -1 # -1 = automatic keep_window_open: false font_ttf_filepath: "" # empty = bundled font widgets: # info overlays drawn onto every frame - enabled: true content: "**Length**: $LENGTH$\n$TRAJECTORY_TOPVIEW$" position: bottom_left width: 0.2 font: size: 0.02 alignment: left background_opacity: 0.5 image_opacity: 1.0