Installation and Startup
Native installers are available for Windows, macOS and Linux. Each bundles the application with everything it needs to run, including the Python runtime and all scientific libraries, so no separate Python installation is required. Installers can be downloaded from the official website, https://ecallistoanalyzer.org, from the e-CALLISTO software page, https://www.e-callisto.org/Software/Callisto-Software.html, or from the project’s GitHub releases page, https://github.com/SaanDev/e-Callisto_FITS_Analyzer/releases.
Full application and Lite
Each release also carries e-CALLISTO FITS Analyzer Lite, a
separate, lighter application that contains only the radio analysis. Its
installers have -lite in their names. This guide describes
the full application: download the installer without
-lite. The two can be installed side by side.
System requirements
| Item | Requirement |
|---|---|
| Windows | 64-bit Windows able to run x64 applications. Installation needs administrator approval. |
| macOS | macOS 13 (Ventura) or later on a Mac with Apple silicon (arm64). |
| Linux | Debian, Ubuntu or a derivative on 64-bit
x86 (amd64), with the Qt/OpenGL runtime libraries
libgl1, libegl1,
libxkbcommon-x11-0 and libxcb-cursor0
(installed automatically by apt). |
| Disk space | About 3 GB for the application, plus space for the download caches. Solar image sequences can occupy several gigabytes. |
| Display | 1280 800 pixels or larger. A resolution of at least 1440 900 is recommended for the Solar Image Analysis and GCS CME Fitting windows. |
| Network | Required for the downloaders, archive searches, context viewers, the geomagnetic response and event catalogs, update checks and bug reports. Local files, saved projects (including embedded ones) and cached downloads can be analyzed offline. |
Installing on Windows
Download the installer,
e-CALLISTO_FITS_Analyzer_v3.2.0_Setup.exe.Run the installer and approve the Windows administrator prompt.
Follow the installation steps. The installer can optionally create a desktop shortcut.
Start the application from the Start menu or the desktop shortcut.
Note
If a save location chosen by the application is not writable — for
example a folder inside C:
Program Files — the application asks you to choose another
folder.
Installing on macOS
Download the disk image,
e-callisto-fits-analyzer_3.2.0_macOS_arm64.dmg.Quit any running instance of the application.
Open the disk image and drag the application to the
Applicationsfolder, replacing the previous version if asked.Eject the disk image and start the application from
Applicationsor Launchpad.
Note
The macOS application is not notarized, so macOS blocks it the first
time it opens. Try to open the application, close the warning, then open
System Settings > Privacy & Security and click
Open Anyway next to the message about the e-CALLISTO
FITS Analyzer, and confirm with your password. On macOS 13 and 14, you
can also Control-click the application in Applications,
choose Open and confirm. macOS remembers the choice, so
this is needed only once for each installed version.
Installing on Linux
Download the Debian package and install it from a terminal in the download folder:
sudo apt install ./e-callisto-fits-analyzer_3.2.0_amd64.deb
The package installs a desktop entry, so the application appears in
the desktop environment’s application menu. Using apt
rather than dpkg also installs any missing runtime
libraries.
Running from source
The source code is openly available at https://github.com/SaanDev/e-Callisto_FITS_Analyzer. Running from source is intended for developers and for platforms without an installer. With Python 3.12 or newer:
Clone or download the repository and create a virtual environment in it.
Install the pinned dependencies with
python scripts/install_requirements.py.Start the application with
python src/main.py.
On Windows, if Qt reports DLL load failed at start-up,
the script packaging/windows/repair_windows_venv.ps1
rebuilds the virtual environment with the supported Python version.
Starting the application
When the application starts it shows a splash screen and then opens the main window (Chapter 3) with an empty plotting area. Shortly after start-up it checks GitHub for a newer release and reports the result on the right of the status bar, for example Updates: up to date (Section 4.3).
If the previous session ended unexpectedly while it had unsaved work, the application offers to recover the latest autosave snapshot (Section 10.2).
With Solar Events > Fetch Event Context Automatically on (the default), loading data also fetches the event’s geomagnetic response and, when the Event Context Strip is shown, the event catalogs (Section 15.1). Turn it off if you prefer that nothing is downloaded on your behalf.
The application remembers your preferences between sessions, including the theme and rendering mode, which sidebar sections are expanded, the frequency-axis scale, the recent files and projects, processing and display-range presets, the Event Context Strip and its sources, automatic event-context fetching, the Geomagnetic Response panels, and the JSOC e-mail address and download product used by Solar Image Analysis.
Updating and uninstalling
Use About > Check for Updates... to look for a newer version; if one exists, the installer can be downloaded from within the application (Section 4.3). Installing a new version over an existing one keeps your preferences. Before saving an existing project in a new version, check the compatibility notes of that version: projects saved by version 3.2.0 cannot be opened by version 3.1.
To uninstall, use Settings > Apps on Windows,
move the application from Applications to the Trash on
macOS, or run sudo apt remove e-callisto-fits-analyzer on
Linux. Downloaded data remain in the cache folders; empty them first
with the Clear Cache buttons of the downloaders if you
want to reclaim the space.