Skip to content

Selecting an Event

After importing data, the first step before inspecting or processing is to identify which event you want to work with. All processing commands operate on one event at a time.

Listing events

aimbat event list

The table shows each event's ID, time, and location. IDs are displayed in their shortest unambiguous form — use any unique prefix when passing an ID to other commands.

Events are listed in the Project tab under Events.

Events are listed in the Project tab.

Selecting an Event for CLI / Shell

Most processing commands (like aimbat align iccs or aimbat snapshot create) operate on a single event. You can specify the target event in two ways:

1. The --event-id flag (or --event)

Pass the ID directly to any command. You can use the full UUID or any unique prefix:

aimbat align iccs --event-id 6a4a

2. The DEFAULT_EVENT_ID environment variable

If you are working on the same event for multiple commands, you can set the DEFAULT_EVENT_ID environment variable in your shell. This tells AIMBAT to use that event whenever the --event-id flag is omitted:

export DEFAULT_EVENT_ID=6a4a
aimbat align iccs
aimbat snapshot create "post-ICCS"

The shell prompt also reflects this ID when set. To clear it, simply unset the variable: unset DEFAULT_EVENT_ID.

Selecting an event for processing (TUI / GUI)

The TUI and GUI maintain their own event selection independently of the CLI / shell context — changing it here does not affect what the CLI uses, and vice versa.

Two ways to select an event:

  • Press e to open the event switcher, navigate with j / k, and press Enter to select.
  • In the Project tab, navigate to the Events table, press Enter on a row, and choose Select event.

The selected event is shown in the event bar at the top of the screen and marked with ▶ in both the switcher and the events table.

Select an event in the Project tab. The selection is reflected across the Event, Snapshots, and Processing tabs.