Visualizing the travel path of the motion stages

Optionally, the visualize-stage-trajectory command-line tool visualizes the movement trajectory of the motion stages during the recording. This is helpful for debugging. This program is written in Python and it is implemented in tools/src/spotlight_tools/scripts/visualize_stage_trajectory.py.

The command-line arguments accepted this program are as follows. They can also be printed out by running visualize-stage-trajectory --help.

$ visualize-stage-trajectory --help
usage: visualize-stage-trajectory [-h] --recording-dir PATH [--output-dir {None}|PATH]

Generate a plot of the motion stages' trajectory over the recording.

╭─ options ────────────────────────────────────────────────────────────────────╮
│ -h, --help                                                                   │
│     show this help message and exit                                          │
│ --recording-dir PATH                                                         │
│     Root directory of the recording. This is the path that you set           │
│     in the Spotlight recording GUI. (required)                               │
│ --output-dir {None}|PATH                                                     │
│     Path to save the generated plot. If None, the plot is saved to           │
│     the "processed" directory under the recording directory. (default: None) │
╰──────────────────────────────────────────────────────────────────────────────╯