Introduction
What the e-CALLISTO FITS Analyzer is
The e-CALLISTO FITS Analyzer is a cross-platform desktop application for visualizing, processing and analyzing solar radio dynamic spectra recorded in FITS format by the e-CALLISTO spectrometer network, and for placing those observations in their solar and geophysical context. It runs natively on Windows, macOS and Linux (Debian and Ubuntu) and is distributed as self-contained installers, so no separate Python installation is required.
e-CALLISTO is a world-wide network of CALLISTO radio spectrometers
that monitors the Sun around the clock (Benz
et al. 2009). Each station records dynamic spectra — radio
intensity as a function of frequency and time — in FITS files that
normally span 15 minutes. A station may operate several receivers or
frequency bands, each identified by a two-digit focus code.
File names follow the pattern
STATION_YYYYMMDD_HHMMSS_FC.fit.gz, for example
Australia-ASSA_20261004_000000_63.fit.gz for focus code 63
of the Australia-ASSA station starting at 00:00:00 UT on
4 October 2026.
The application merges fragmented observations across time and frequency, removes the receiver background, mitigates radio-frequency interference (RFI), and isolates solar radio bursts with an interactive mask. Dedicated tools derive the frequency drift rate and shock parameters of Type II bursts and estimate the coronal magnetic field from band-split emission. Around this core, the software retrieves archive data from several radio instruments, displays X-ray, particle, geomagnetic and coronal mass ejection (CME) data for the same interval, analyzes solar images from space-borne observatories, models the coronal magnetic field, and reconstructs CMEs in three dimensions. It follows an event to Earth with its geomagnetic response, draws the flare, CME and storm catalogs beside the spectrum, composes a figure of the whole event, and keeps the radio, solar-image and CME work of one event in a single project file.
Capabilities at a glance
Table 1.1 summarizes the main modules, where they are opened, and where they are described in this guide.
| Module | Opened from | Purpose | Chapter |
|---|---|---|---|
| Main window | Application start | Display and process dynamic spectra | 3–7 |
| Type II analysis | Toolbar; Analysis | Burst isolation, maxima, drift and shock parameters | 8 |
| Band-splitting analysis | Analysis > Type II Band-splitting | Compression ratio, Alfvén speed, magnetic field | 9 |
| Projects and export | File | One project for every window, figures, FITS, reports, batch export | 10 |
| FITS Downloader | Download; toolbar | e-CALLISTO archive search, preview and import | 11 |
| Multi-Station Comparison | View | Stacked spectra from several stations | 12 |
| Learmonth, STEREO/SWAVES | Solar Events > Radio Bursts | Additional radio spectra | 13 |
| Solar-event viewers | Solar Events | GOES X-rays and protons, Dst, Kp, CME catalog | 14 |
| Geomagnetic Response | Solar Events > Geomagnetic; sidebar | Dst, Kp, IMF, solar wind and auroral indices around the event | 15 |
| Event Context Strip | View | Flare, CME, DONKI and burst catalogs above the spectrum | 15 |
| Event Figure | File > Export As | One publication figure of the whole event | 15 |
| SunPy Explorer | Solar Events > Archives | Multi-mission archive search and plots | 16 |
| Solar Image Analysis | Analysis > Solar Image Analysis | Imaging, measurement, CME kinematics, PFSS | 17–20 |
| GCS CME Fitting | Analysis > GCS CME Fitting… | 3-D flux-rope and shock reconstruction | 21–22 |
Supported data
The application reads and retrieves the data types listed in Table 1.2. The archives behind each retrieval tool are listed in Appendix C.
| Data | Use in the application |
|---|---|
CALLISTO FITS (.fit,
.fits, .fit.gz, .fits.gz) |
Loaded, combined, processed and analyzed in the main window. |
ARTEMIS-IV ARTLOOK FITS |
Loaded in the main window with instrument-specific time and intensity scaling (Section 5.1.1). |
| Learmonth Solar Radio Spectrograph archive | Converted to FIT files and imported (Section 13.1). |
| STEREO/SWAVES level-2 spectra | Displayed below the CALLISTO spectrum on a shared time axis (Section 13.2). |
| Solar image FITS (SDO/AIA, SDO/HMI, SOHO/EIT, SOHO/LASCO, STEREO/SECCHI, GOES/SUVI) | Displayed, processed and measured in Solar Image Analysis (Part V). |
| Helioviewer JPEG2000 images | Quicklook image sequences and near-real-time previews in Solar Image Analysis (Part V), the coronagraph images used for GCS fitting (Part VI), and Event Figure thumbnails. |
| Synoptic magnetograms (GONG, HMI, ADAPT) | Boundary condition for PFSS modeling (Chapter 20). |
| GOES XRS and SGPS, Kyoto Dst, GFZ Kp, SOHO/LASCO CME catalog | Context viewers and overlays (Chapter 14). |
| OMNI, DSCOVR and SWPC solar-wind data; SYM-H and AE indices | Geomagnetic Response (Section 15.2). |
| GOES/SWPC flare list, CDAW CMEs, NASA DONKI, e-CALLISTO burst lists | Event Context Strip, Event Figure and the report’s Event Story (Chapter 15). |
Workflow overview
Figure 1.1 shows how the main components relate to each other. Data enter the main window from local files, the downloaders or a saved project; they are processed in the sidebar; analysis windows take the processed spectrum as input; and every stage can be saved in a project or exported. The context and imaging tools can be synchronized to the time window of the loaded spectrum, and the event-context tools follow the event time of the loaded data.
Downloaders
Projects
Chapter 5
magnetic field
drift and shock
maximum intensities
FITS, reports (Ch. 10)
GCS CME Fitting
What is new in version 3.2.0
Version 3.2.0 turns a radio burst into the story of a whole event. It adds or substantially extends the following features, all of which are described in this guide:
One project for every window: a single
.efaprojfile holds the radio analysis, the Solar Image Analysis frames and measurements, and the GCS fits, with the images linked or embedded (Section 10.1);Geomagnetic Response: Dst, SYM-H, Kp, the IMF, solar wind and auroral indices from one day before to seven days after the event, as a sidebar card and a window (Section 15.2);
Event Context Strip and Event Figure: flare, CME, DONKI and burst catalogs above the spectrum, and one composed publication figure of the event (Sections 15.3 and 15.4);
Project reports that open with an Event Story and include Solar Image Analysis and GCS sections (Section 10.6);
Solar Image Analysis: a choice of full-resolution FITS, reduced-size FITS or JPEG2000 quicklook products, download progress based on the real transfer, the AIA 193 Å Sun in LASCO’s occulter, and labelled north-up movies (Chapters 17 and 18);
Reset All, which returns the application to its start-up state (Section 3.2).
Version 3.1.0 introduced ridge tracking, the selectable power-law time origin and density models, the Timeline panel, the logarithmic frequency axis, the Burst List, PFSS modeling and GCS fitting; they are described in the chapters concerned.
Caution
Projects saved by version 3.2.0 cannot be opened by version 3.1. Keep
a copy of any project you still need to open in version 3.1 before
saving it again. Version 3.1 radio projects open unchanged, and a
version 3.1 .ecsolar Solar Image Analysis session opens as
a new, unsaved project.
Citing the software
If you use the e-CALLISTO FITS Analyzer in your research, please cite Liyanage et al. (2026). The citation and a BibTeX entry can be copied from the application with the Cite this Software button (Section 4.2). The BibTeX entry is:
@article{liyanage2026ecallistofitsanalyzersoftware,
title={e-CALLISTO FITS analyzer: a software framework for CALLISTO solar
radio data},
author={Liyanage, G L S S and Adassuriya, J and Jayaratne, K P S C and
Monstein, C and Manoharan, P K},
journal={RAS Techniques and Instruments},
volume={5}, pages={rzag056}, year={2026},
doi={10.1093/rasti/rzag056}
}
When you publish results that depend on archive data retrieved through the application, acknowledge the corresponding data providers as well (Appendix C).