The Main Window
The main window is where dynamic spectra are displayed, processed and measured, and from where every other tool is opened. This chapter describes its layout, toolbar, menus and status bar. The sidebar panels are described in Chapter 6.
Layout
The main window (Figure 3.1) consists of the regions listed in Table 3.1.
| Region | Description |
|---|---|
| Menu bar | Access to every function, including those not on the toolbar (Section 3.4). On macOS the menu bar is at the top of the screen. |
| Toolbar | Icon buttons for the most frequent actions (Section 3.2). |
| Cite this Software | Opens the citation dialog (Section 4.2). |
| Sidebar | Collapsible panels for the timeline, background subtraction, display thresholds, units, axis scale, graph properties, the analysis summary, the geomagnetic response and the ruler readout (Chapter 6). |
| Main plotting area | The dynamic spectrum with its color bar, and optionally the Event Context Strip above it (Section 15.3). Interactive tools act here. |
| Status bar | Messages on the left; the update status and the live cursor readout on the right (Section 3.5). |
A narrow arrow handle on the left edge of the plotting area hides or shows the sidebar to give the plot more room. The divider between the sidebar and the plot can also be dragged.
Toolbar
The toolbar (Figure 3.2) contains 16 tools, described in Table 3.2. Hovering over a tool shows its name. Tools that need loaded or processed data remain disabled until they can be used.
| No. | Tool | Function | Shortcut |
|---|---|---|---|
| 1 | Open / Load | Load one or more CALLISTO FITS files from disk (Section 5.2). | Ctrl+O |
| 2 | Download | Open the e-CALLISTO FITS Downloader (Chapter 11). | |
| 3 | Export | Export the displayed spectrum as a figure (Section 10.3). | Ctrl+E |
| 4 | Export as FITS | Export the processed spectrum as a FITS file (Section 10.4). | Ctrl+F |
| 5 | Save Project | Save the complete workspace as an
.efaproj project (Section 10.1). |
Ctrl+S |
| 6 | Undo | Undo the last processing change. | Ctrl+Z |
| 7 | Redo | Redo the last undone change. | Ctrl+Shift+Z |
| 8 | Estimate Drift Rate | Estimate the drift rate from points clicked along a burst (Section 7.7). | |
| 9 | Isolate Burst | Draw a freehand mask around a burst (Section 8.2). | |
| 10 | Plot Maximum Intensities | Open the Maximum Intensities window (Section 8.3). | |
| 11 | Rectangular Zooming | Drag one rectangle to zoom into the plot. Available while navigation is locked (Section 7.1). | |
| 12 | Lock zooming and panning | Disable scroll-wheel zooming and panning, freezing the view and enabling rectangle zoom. | |
| 13 | Unlock zooming and panning | Re-enable scroll-wheel zooming and panning. | |
| 14 | Reset Selection | Clear the isolated-burst selection and drift markers. | |
| 15 | Reset to Raw | Discard all processing and show the raw spectrum. | |
| 16 | Reset All | Return the application to its start-up state (see below). |
Reset All (also Edit > Reset All) returns the application to how it starts: the loaded data, processing, graph settings, sidebar readouts and undo history are cleared, and the analysis, Geomagnetic Response, Event Figure, Solar Image Analysis and GCS windows are closed. Your preferences, including the View-menu event-strip choices, and the download cache are kept.
Caution
With unsaved changes, Reset All asks whether to Save, Discard or Cancel, as when opening a project or quitting. With everything saved but work open in the Solar Image Analysis or GCS window, it asks you to confirm.
Plotting area and renderers
The plotting area shows the dynamic spectrum with frequency on the vertical axis, time on the horizontal axis and intensity as color. The plot title shows the source file name and the processing state, for example -Background Subtracted or -Isolated Burst. With View > Event Context Strip on, catalog lanes are drawn above the spectrum on their own time axis (Section 15.3).
Two renderers are available and are selected with View > Mode:
- Modern
-
uses a hardware-accelerated canvas (PyQtGraph) for fast zooming and panning of large or combined spectra. This is the default.
- Classic
-
uses Matplotlib.
Processing > Hardware Acceleration > Enable switches the accelerated live canvas on or off. Both renderers support the same tools, annotations and overlays, and exported figures look the same whichever renderer is in use (Section 10.3).
Menu bar
Table 3.3 summarizes the menus of the main window. The tables that follow list every command, with its shortcut and the section where it is described.
Note
The disabled File > Save As entry in the main window is reserved; projects are saved with Save Project and Save Project As....
Status bar
The left part of the status bar shows messages from the current operation, for example the result of a drift-rate estimate or a reminder of how to finish a tool. The right part shows:
the update status, for example Updates: up to date; and
the live cursor readout t = … | f = … MHz | I = …, giving the time, frequency and intensity (in the selected units) under the mouse pointer.
The readout allows quick quantitative inspection of the spectrum without clicking.
Themes
View > Theme selects System (follow the operating system), Light or Dark. The theme applies to all windows of the application and to on-screen plots. Exported figures and PDF reports are always drawn on a white page, whichever theme is in use.
Drag and drop
FITS files and .efaproj projects can be dropped anywhere
on the main window, including the plot. A single FITS file opens on its
own; several are combined exactly as with File >
Open; a project file opens the project, and a version 3.1
.ecsolar session is imported as a new project. Other file
types are refused. If the current work has unsaved changes, you are
asked whether to save them first.