Skip to main content

Open a Chart from Aquila

Compass can open a chart directly from Aquila. When you double-click an event row in a study's events table in the Aquila application, Aquila hands the event's moment and frame to Compass, which opens the corresponding Mundane or Transit chart. This saves you from re-entering the moment and frame in Compass by hand.

note

This feature has no control in the Compass interface. The action that starts it lives in Aquila; Compass receives the request and opens the chart.

Open a chart from an Aquila event

To open a chart in Compass from an Aquila event:

  • In Aquila, double-click an event row in a study's events table. The matching Mundane or Transit chart opens and comes to the front in Compass.

How the hand-off works

The way Aquila reaches Compass depends on whether Compass is already running:

  • Compass is already running: Aquila sends the request to Compass over the r7.compass.chartrequests named pipe, and Compass opens the chart.
  • Compass is installed but not running: Aquila launches Compass with a --chart-request startup argument. Because Compass runs as a single instance, a second launch forwards its request to the instance that is already open rather than starting a duplicate copy.

A request that arrives while Compass is still starting up is held in a queue and dispatched once loading finishes. If a request uses a newer format than the installed version of Compass understands, Compass prompts you to update instead of opening a chart.