.. _catalyst-sec-gui:

The main window
===============

.. figure:: media/catalyst/main-window.png
   :alt: The Catalyst main window with its toolbar, six panels and status bar
   :width: 100%

   The main window with its areas, described in the table below.

The main window consists of a toolbar, six panels arranged in two rows and a
status bar:

.. csv-table::
   :header: "Area", "Content"
   :widths: 22, 78

   "Profile and database", "Selects, loads and saves a
   :ref:`processing profile <catalyst-sec-profiles>`, and sets the time window
   of a database load. See :ref:`catalyst-sec-gui-toolbar`."
   "Load options", "What a database load fetches and keeps: picks,
   origins, preferred origins and their picks, aggregation after loading. See
   :ref:`catalyst-sec-gui-toolbar`."
   "Picks", "The loaded picks as a table, as a histogram over time and as
   array plots (Map, Beams, Slow/Baz, Baz/time). See
   :ref:`catalyst-sec-vis-picks`."
   "Origins", "The origins with their quality metrics, the cumulative
   count and the Wadati diagram. The selected origin is the *active origin*.
   See :ref:`catalyst-sec-vis-origins`."
   "Map", "Map, hexagon density map and 3D view. See
   :ref:`catalyst-sec-vis-map`."
   "Pick processing", "Tools that work on picks: nucleation and
   aggregation. See :ref:`catalyst-sec-nucleation` and
   :ref:`catalyst-sec-aggregation`."
   "Origin processing", "Tools that work on origins: relocation,
   association, DD relocation, aggregation, swarm recovery and quality
   control. See :ref:`catalyst-sec-refine` and :ref:`catalyst-sec-qc`."
   "Active origin", "Arrivals and diagnostic plots of the active origin:
   distance, azimuth and back-azimuth residuals, travel time, move-out and
   polar plot. See :ref:`catalyst-sec-vis-active`."
   "Status bar", "A pending relocation result (until it is accepted or
   reset) on the left; the log state and license on the right."

Every control has a tooltip. Hover over a control to see what it does.
Hovering a station on the map or a pick marker in a plot shows the station
name, phase and pick time.

**View → Panels** shows or hides panels, and **View → Home (reset layout)**
restores the default arrangement. The layout is saved when |appname| closes.
**View → Application Log** shows the log messages.


.. _catalyst-sec-gui-toolbar:

Toolbar
-------

Profile
^^^^^^^

**Profile** selects a :ref:`processing profile <catalyst-sec-profiles>`.
**Load** applies it, **Save as…** saves the current settings to a profile
file.

Database
^^^^^^^^

The database part of the toolbar loads picks and origins for a time window.
Set the start and end time and press **Load**. The arrow buttons move the
window back or forward by its own length and load it, for working through a
long period in steps.

.. csv-table::
   :header: "Option", "Description"
   :widths: 20, 80

   "picks", "Load all picks in the window."
   "origins", "Load all origins in the window, including alternative
   solutions."
   "pref. origins", "Load only the preferred origin of each event."
   "pref. picks", "Load only the picks associated with those preferred
   origins."
   "aggregate", "Aggregate the picks automatically after loading."
   "keep picks", "Add the picks to those already loaded instead of replacing
   them."
   "keep origins", "Add the origins to those already loaded instead of
   replacing them."

The database part is only enabled when |appname| is connected to a database.


.. _catalyst-sec-gui-menus:

File menu
---------

.. csv-table::
   :header: "Entry", "Description"
   :widths: 30, 70

   "Open…", "Load picks and origins from a |scname| XML file."
   "Save, Save As…", "Save the working set to a |scname| XML file."
   "Save Selection As…", "Save only the selected origins and their picks."
   "Send Selection to Messaging", "Send the updated origins to the messaging
   system, see :ref:`catalyst-sec-workflow-send`."
   "Quit", "Close |appname|."


Selecting origins
-----------------

* Click a row in the origin table to make it the active origin.
* **Shift+click** and **Ctrl+click** select several origins; **Ctrl+A**
  selects all visible origins.
* Clicking a cell on the Hexmap selects the origins in that cell.
* Clicking a pick on the map selects the origins it belongs to.

Many tools work on the selected origins, or on all visible origins when
nothing is selected. Their buttons show which, for example "Smart-locate 12"
or "Smart-locate all (340)".