Skip to content

Template

slamlab-config.yaml
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 overlays
slamlab_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