Skip to content

Command reference

dedrunk topics BAG
dedrunk intrinsics imu BAG                      [-O imu.yaml] [--pelorus PATH]
dedrunk intrinsics camera BAG --target FILE     [--camera TOPIC]... [--model pinhole-radtan|pinhole-equi]
                                                [-O camchain.yaml] [--bundle PATH]
dedrunk imu record TOPIC                        [--bag intrinsics.mcap] [--poses 12] [-O imu.yaml]
                                                [--coord-mode peer|autostart] [--local-only]
dedrunk imu noise BAG                           [-O imu.yaml] [--csv allan.csv] [--pelorus PATH]
dedrunk imu merge INTRINSICS NOISE              [-O imu.yaml] [--pelorus PATH]
dedrunk imu show FILE
dedrunk extrinsics lidar-imu BAG                [--imu-bag PATH] [--pelorus PATH] [--bundle PATH]
dedrunk extrinsics lidar-camera BAG             [--image-bag PATH] [--camera TOPIC]... [--intrinsics CAMCHAIN]
                                                [--lever-arm TOPIC=x,y,z]... [--bundle PATH]
dedrunk extrinsics camera-imu BAG               [--imu-bag PATH] [--camera TOPIC]... [--intrinsics CAMCHAIN]
                                                [-O camchain-imucam.yaml]
dedrunk gui [PATH]                              [--camera N] [--view N] [--outlines] [--coverage]
dedrunk config generate recommended|full
dedrunk config verify FILE|-
dedrunk completions [SHELL]

BAG is an MCAP file, a ROS 2 bag folder with MCAP storage, or a Marina dataset name. --camera takes an image topic or IMAGE=CAMERA_INFO and can be left out when the bag has one image topic. --csv '' disables the Allan CSV. dedrunk COMMAND --help describes every option.

Global options

-c, --config PATH
Ratslang file with overrides.
-o, --override KEY=VALUE
One setting, repeatable. Applied after --config.
--from TIME, --to TIME
Use only this stretch, in seconds from the first message (90, 90s, 1.5min). Only this stretch of an indexed MCAP is read. With a separate trajectory bag the window applies to the sensor recording.
-y, --yes
Overwrite existing outputs without asking.

Pelorus configuration

--pelorus writes the results as Ratslang, for -c or to paste into a larger file:

  • extrinsics lidar-imu --pelorus: imu.from_lidar_transform, imu.calibration.time_offset
  • imu noise --pelorus: imu.covariance_*
  • intrinsics imu --pelorus: imu.calibration.parameter_file
  • imu merge --pelorus: imu.calibration.parameter_file, imu.covariance_*

A parameter file next to the configuration is referenced as ./imu.yaml, elsewhere by absolute path. Unmeasured quantities are written as comments.