User guideWorking with Dynamic SpectraChapter 6

The Sidebar Panels

The sidebar on the left of the main window groups the controls used most often while working on a spectrum. It contains eight sections, from top to bottom: Timeline, Background Subtraction, Noise Clipping Thresholds, Units, Axis, Graph Properties, Analysis Summary and Ruler Measurement. Each section is a card with a clickable header that collapses or expands it; the state of every card is remembered between sessions. The whole sidebar can be hidden with the arrow handle on the left edge of the plot.

Timeline

A loaded dataset knows which station, focus codes and observation times it came from. The Timeline panel (Figure 6.1) lists them and extends or trims the dataset in place, without returning to the downloader.

The Timeline panel.
Figure 6.1. The Timeline panel.
◀ Prev / Next ▶

Fetch the observation before the first, or after the last, and time-combine it into the spectrum (Ctrl+Shift+Left and Ctrl+Shift+Right, also in the Edit menu).

Step selector (×\times1, ×\times2, ×\times4, ×\times8)

The number of observations added per click.

Observation list

One row per observation, giving its start time and focus code(s).

Trim Start / Trim End

Remove the earliest or the latest observation. Trimming down to a single observation returns to a plain single-file load.

Status line

The station, the covered time range and the number of observations, for example BIR · 08:00–08:15 · 2 observations. When a direction is unavailable the panel says why, for example the end of the archive day or a timestamp that supplies only part of the focus-code set.

Adjacent observations are looked for first among the loaded file’s neighbors on disk, and only then in the e-CALLISTO archive, so a set that has already been downloaded extends without network access. Day listings are cached during the session. With Edit > Prefetch Adjacent Observations ticked (the default), neighboring files are downloaded in the background so that the next step is instant; untick it to avoid unrequested archive traffic.

Extending and trimming preserve your work:

  • annotations, the ruler measurement and drift picks are kept, and their time coordinates shift with the axis when an earlier observation is prepended;

  • the active background subtraction and RFI cleaning are recalculated over the longer array rather than returning the view to the raw data;

  • the display thresholds are kept;

  • every extension or trim is a single undo step (Ctrl+Z), restoring the arrays, the source list and the annotations together.

After an extension or trim the plot is rescaled to show the full spectrum.

Background Subtraction

The receiver background varies strongly from channel to channel, producing horizontal stripes in a raw spectrum. The Background Subtraction panel (Figure 6.2) removes it.

The Background Subtraction panel.
Figure 6.2. The Background Subtraction panel.

Choose a Method and click Subtract Background. The background is computed for each frequency channel over the whole observation time:

Mean

subtracts the mean of each frequency channel; the result stays in the raw intensity unit (Digits).

Median

subtracts the median of each frequency channel; the result stays in Digits. The median is less affected by bursts and RFI than the mean.

Median (dB)

subtracts the median of each channel and converts the result to decibels above that background, following the CALLISTO Plotutil recipe used by the batch processor. This method is recommended for analysis.

The status line below the button names the method in use, for example Applied: Median (dB). The subtraction is always computed from the raw data, so choosing another method and clicking again replaces the previous result rather than stacking on it. Re-applying the subtraction also clears any RFI cleaning or isolated burst that was derived from the previous result. While a Median (dB) result is shown, the intensity unit is locked to dB because the data are already in decibels. Edit > Reset to Raw removes the subtraction.

Noise Clipping Thresholds

The Noise Clipping Thresholds panel (Figure 6.3) sets the limits of the color scale.

The Noise Clipping Thresholds panel.
Figure 6.3. The Noise Clipping Thresholds panel.
Lower Threshold / Upper Threshold

High-resolution sliders for the lower and upper limits of the color scale (Vmin and Vmax). The display updates live while you drag; no Apply button is needed. The value card beside each label shows the limit. When the intensity is shown in Digits, a second line gives the corresponding dB value.

Logarithmic Threshold Scale

Makes the sliders logarithmic for finer control near zero.

The thresholds change the contrast only; the data are never clipped or modified. With both sliders at zero the color scale spans the whole data range. Limits chosen on the raw data are reset when you subtract the background, because they would saturate the new scale. Processing > Presets > Raw FITS Percentile (5-98%) sets the limits from the distribution of the data on show (Section 7.4).

Units

The Units panel (Figure 6.4) selects the units of the intensity and time axes.

The Units panel.
Figure 6.4. The Units panel.
Intensity: Digits / dB

Digits shows raw CALLISTO ADC values as stored in the file. dB converts them with the CALLISTO receiver scale (see the glossary entry Digit).

Time: Seconds / UT

Seconds measures time from the start of the loaded data; UT shows Universal Time. UT requires the observation start time (TIME-OBS) in the FITS header.

Switching units does not modify or lose data; it only changes the axis labels, the color-bar label and the cursor readout.

Axis

The Axis panel (Figure 6.5) switches the frequency axis between Linear (proportional to MHz) and Log (proportional to log⁡10\log_{10} MHz).

The Axis panel.
Figure 6.5. The Axis panel.

A logarithmic axis spreads out the decametric end of the band, where Type II and Type III bursts spend most of their drift, and places a fundamental–harmonic pair at a constant separation. Ticks are anchored to the decades and labeled in MHz (for example 20, 30, 40, 50, 60, 70, 80 across a 20–80 MHz band), thinning as the span widens. Both renderers support the logarithmic axis, and annotations, the ruler, light-curve picks and drift points behave identically in both scales because their coordinates remain in MHz. The choice is remembered between sessions. The STEREO/SWAVES panel always uses its own logarithmic axis (Section 13.2).

Graph Properties

The Graph Properties panel (Figure 6.6) controls the appearance of the plot. It becomes active once a file is loaded. The settings apply to the on-screen plot and to exported figures and reports.

The Graph Properties panel.
Figure 6.6. The Graph Properties panel.
Controls of the Graph Properties panel.
Group Control Function
Appearance Colormap Custom (blue–red–yellow), viridis, plasma, inferno, magma, cividis, turbo, RdYlBu, jet, cubehelix or bone_r.
Font family Typeface of all plot text; Default or any installed font.
Text Graph title A custom title; leave empty for the default title.
Remove Titles Hide the plot title.
Font sizes Tick labels (px) 6–60 px (default 11).
Axis labels (px) 6–60 px (default 12).
Title (px) 6–80 px (default 14).
Text style Title, Axis labels, Tick labels Bold and Italic for each text element.

Analysis Summary

The Analysis Summary panel (Figure 6.7) is a read-only summary of the current analysis session: the fitted equation, R2R^2, the fold number and the average shock speed and height from the Burst Analyzer (Section 8.7). It also reports when a saved session has been restored. Before any analysis it reads No analysis session loaded.

The Analysis Summary panel.
Figure 6.7. The Analysis Summary panel.

Ruler Measurement

The Ruler Measurement panel (Figure 6.8) shows the result of the ruler tool, started with Analysis > Ruler Measurement (Section 7.8): the two points P1 and P2 (time and frequency), the Duration, the Frequency drift and the Slope in MHz/s. Copy copies the readout to the clipboard and Clear removes the measurement.

The Ruler Measurement panel.
Figure 6.8. The Ruler Measurement panel.