The Solar Image Analysis Window
Solar Image Analysis is a multi-mission imaging workspace for extreme-ultraviolet (EUV) disk images, magnetograms, coronagraph images and heliospheric images. It retrieves image sequences from the solar archives or reads local FITS files, displays and processes them, measures eruptions and their kinematics, and models the coronal magnetic field. Open it with Analysis > Solar Image Analysis in the main window.
This chapter describes the window, its menus, how image data are obtained, and how its work is saved in the project. Display and processing are described in Chapter 18, measurements in Chapter 19 and magnetic-field modeling in Chapter 20.
Supported observables
Table 17.1 lists the observables that can be retrieved. Local FITS files from these and other solar instruments can be loaded as well.
| Instrument | Class | Observables |
|---|---|---|
| SDO/AIA (Lemen et al. 2012) | EUV/UV disk | 94, 131, 171, 193, 211, 304, 335, 1600 and 1700 Å |
| SDO/HMI (Scherrer et al. 2012) | Magnetograph | Magnetogram, Continuum (Intensitygram), Dopplergram; vector field (Section 18.10) |
| SOHO/EIT | EUV disk | 171, 195, 284 and 304 Å |
| SOHO/LASCO (Brueckner et al. 1995) | Coronagraph | C2, C3 |
| STEREO-A/B SECCHI (Howard et al. 2008) | EUV disk, coronagraph, heliospheric imager | EUVI 171, 195, 284 and 304 Å; COR1, COR2; HI1, HI2 |
| GOES/SUVI | EUV disk | 94, 131, 171, 195, 284 and 304 Å |
The sidebar shows only the tool groups that apply to the instrument class of the loaded data (or, before loading, of the selected observable); see Table 17.4.
Window layout
The window is divided into the regions numbered in Figure 17.1 and described in Table 17.2.
| No. | Region | Description |
|---|---|---|
| 1 | Menu bar | Project, Data, Analysis, Movie, Export and About (Section 17.2.1). |
| 2 | Sidebar | Collapsible cards that read from top to bottom as the workflow: get data, choose records, analyze, then display, export and instrument-specific tools. |
| 3 | Sidebar handle | Hides or shows the sidebar. |
| 4 | Header bar | Live cursor readout — distance from Sun center in , position angle, heliographic coordinates on the disk, and pixel — and the one-click Export MP4 button. |
| 5 | Measure toolbar | The Measurements switch, the Ruler, Profile, Region Stats, Track CME, Circle Fit and Clear tools, and Pan / Zoom (Chapter 19). |
| 6 | Image canvas | The current frame, titled with instrument, wavelength and time. |
| 7 | CME tracking panel | Measurement table, live height–time graph and kinematic fit; active when Measurements is ticked (Section 19.4). |
| 8 | Playback bar | Rewind, previous, play, pause and next buttons, the frame scrubber, the frame counter (Frame n / N) and the Speed in frames per second. |
| 9 | Details drawer | Results and warnings of every operation. Click Details to collapse it; drag the divider above it to resize. |
The playback speed set in the playback bar is used for playback and for exported movies. While a sequence plays, or while a contrast slider is dragged, the canvas switches to a fast preview that subsamples the display; full resolution returns as soon as playback stops. Measurements, statistics and exports always use the full-resolution data.
Menus
Sidebar cards
Table 17.4 lists the sidebar cards in order, and the instrument classes for which each is shown.
| Card | Shown for | See |
|---|---|---|
| Data Source | all | Section 17.3.1 |
| Archive Results | all | Section 17.3.4 |
| Analysis | all (disk tools for disk imagers and magnetographs only) | Section 18.1 |
| Processing Level | AIA and SUVI | Section 17.3.6 |
| Display & Crop | all | Section 18.2 |
| Solar Derotation | all | Section 18.3 |
| Movie Export | all | Section 18.11 |
| Coronagraph Tools | coronagraphs | Section 18.7 |
| Overlay Layers | coronagraphs | Section 18.8 |
| Heliospheric Imager (J-map) | HI1, HI2 | Section 18.9 |
| Magnetic Vector Field (HMI) | HMI | Section 18.10 |
| Potential Field (PFSS) | disk imagers, magnetographs, synoptic maps | Chapter 20 |
| Active Regions | disk imagers, magnetographs | Section 18.5 |
Obtaining image data
The Data Source card
The Data Source card defines what to retrieve and how.
- Observable
-
the instrument and wavelength or product (Table 17.1).
- Start (UTC), End (UTC)
-
the time range.
- Cadence (s)
-
the sampling interval between frames (0–3600 s; default 120 s).
- Max records
-
the maximum number of records to list (1–5000; default 120).
- Use Analyzer Time Window
-
copies the start and end times of the spectrum in the main window, so that the images match the radio burst being studied.
Download options
- Product
-
what Fetch Records lists and Load Selected downloads (Section 17.3.2): FITS · full resolution, FITS · reduced size or JP2 · quicklook (Helioviewer). The choice is remembered. Products that the selected observable does not have are greyed out, with the reason in their tooltip.
- Source
-
(SDO, FITS products) Auto (JSOC → VSO) tries the Joint Science Operations Center (JSOC) first and falls back to the Virtual Solar Observatory (VSO); JSOC (fast) returns direct, compressed AIA files and is usually much faster; VSO (classic) uses the VSO only.
- JSOC notify e-mail
-
JSOC requires a one-time, free registration of an e-mail address at https://jsoc.stanford.edu/ajax/register_email.html. The address is remembered.
- Frame size
-
for SDO FITS: Full disk (4096²), Synoptic 1024² (no e-mail), Binned ½ (2048²), Binned ¼ (1024²) or Cutout (region). The synoptic size reads JSOC’s AIA synoptic archive and needs no e-mail. Binned and cutout frames are produced by JSOC, so only the reduced data are transferred; they require the JSOC source and e-mail. For a cutout, enter the Centre X″, Centre Y″, Width″ and Height″ in arcseconds from disk center. For JP2 quicklooks the box offers Native size, Up to 2048 px or Up to 1024 px, which decodes AIA and HMI’s 4096-pixel images at a lower resolution to save memory while keeping the coordinates exact.
- High resolution AIA (best crop)
-
requests full-resolution AIA products. Files are larger, but cropped views keep more detail.
An estimate of the download size is shown below the options when records are selected.
Actions
- Fetch Records
-
searches the archive; the matching records appear in Archive Results. Stop cancels a running search or download; files already completed remain in the cache.
- Find Latest
-
scans the archive backwards to find the newest data actually available for the observable. This is useful for SOHO/LASCO, whose calibrated archive can lag real time by many months, and may take a minute or two.
- Upload FITS…
-
loads solar FITS files from disk without an archive search.
- Live Preview (Helioviewer)
-
shown for SOHO/LASCO and SOHO/EIT (Section 17.3.5).
Download products
- FITS · full resolution
-
the archive’s own calibrated files: the largest and slowest to download, and the product for photometry.
- FITS · reduced size
-
SDO only. The Synoptic 1024² (no e-mail) frame size reads JSOC’s level-1.5 AIA synoptic archive: 1024-pixel frames at a 2-minute cadence, available about a week after observation, with a near-real-time set covering the latest days (1700 Å is not included). The binned and cutout sizes are made by JSOC on request and need the JSOC notify e-mail.
- JP2 · quicklook (Helioviewer)
-
Helioviewer JPEG2000 images for AIA, HMI (magnetogram and continuum), EIT, LASCO and STEREO EUVI, COR1 and COR2. Frames are listed in seconds and are a few hundred kilobytes each, so this is the fast way to inspect an event. GOES/SUVI and the heliospheric imagers have no JP2 product.
Caution
JP2 pixels are 8-bit display values, not calibrated data. Viewing, differences, movies, geometry measurements and derotation work on them, but processing levels, light curves, Region Stats and active-region detection are disabled, and a JP2 quicklook · not calibrated badge above the image and the figure titles say so. Use a FITS product for photometry.
Download progress
The progress bar under the image follows the real transfer from every source: bytes done of the expected total, speed and time remaining, with Show file details listing each file While nothing can be measured — an archive search, or JSOC building binned or cutout frames, which can take minutes — the bar is a busy indicator and the line below it says what is being waited for. After the transfer it counts the frames as they are read, and reaches 100% only when they are on screen. Stop cancels a search, the wait for JSOC or the transfer; files already downloaded stay in the cache.
The Archive Results card
The Archive Results table lists the records found, with the columns Use, Start UTC, Source, Size and File ID. Tick records in the Use column, or use Select All and Deselect All, then:
Load Selected downloads the ticked records into the working cache and loads them for analysis; or
Save to Disk… downloads them to a folder you choose, for keeping.
The Analysis card then summarizes what is loaded (instrument, number of frames and configuration).
SOHO data
The archive serves two files for every SOHO/EIT observation, the calibrated Level 1 file and the raw level-zero file. The window chooses one per observation: Level 1 where it exists and the raw file otherwise. Level 1 processing runs about a year behind the raw archive, so recent searches return raw frames and older ones calibrated frames; a window that straddles the boundary loads as two configuration groups. The calibrated SOHO/LASCO archive also lags real time. For a date beyond the newest archived data, the search falls back to the nearest available data and says so. Use Live Preview to see the most recent SOHO images.
Live Preview (Helioviewer)
Live Preview (Helioviewer) opens the SOHO/… Near-Real-Time Preview (Helioviewer) window (Figure 17.2) with the newest quicklook image of SOHO/LASCO C2 or C3 or SOHO/EIT, usually updated within about an hour. These browse images are for situational awareness, not for analysis.
- Passband / Detector, Latest Frame
-
choose the EIT passband or LASCO detector, and reload the newest image.
- Movie (time range · step)
-
set Start (UTC), End (UTC), Step (minutes) and Max frames, then Build Movie to fetch one frame per step and play them with ◀, Play, Pause, ▶ and an FPS setting. Cancel stops the fetch. The frame cap protects the Helioviewer service.
- Open in Browser
-
opens the view on the Helioviewer web site.
Processing level
Downloads always fetch the archive’s base product. For instruments that publish more than one processing level, the Processing Level card selects the level that is displayed and analyzed:
- SDO/AIA
-
Level 1 (as downloaded), the archive product; or Level 1.5 (registered here), computed locally with aiapy (Barnes et al. 2020), which applies the master pointing, rotates the image to solar north, rescales it to 0.6 arcsec per pixel and centers the Sun.
- GOES/SUVI
-
Level 1b (as downloaded), single calibrated exposures; or Level 2 (archive composite), NOAA’s high-dynamic-range composites, which are downloaded separately when selected.
Apply Level re-derives the loaded sequence at the selected level; any crop or derotation is re-applied afterwards. The status line reports the level in use. The card is hidden for instruments that offer only one level.
Saving the work in a project
The frames, data source, display, crop and playback settings, the CME
measurements (height–time picks, circle fits and fit order) and the PFSS
settings are part of the main window’s project (Section 10.1). Project > Save
Project (Ctrl+S) and Save Project
As… (Ctrl+Shift+S) in this window save that
project. With Link data the project refers to the
frames on this computer; a linked project whose frames have been moved
or cleared from the cache fetches them again from the archive. With
Embed data the frames are stored in the project.
Measurements are matched to the reloaded frames by observation time, and
an overlay composite built when the project was saved is built again
once the frames are in. The PFSS solution itself is not stored; one
click on Compute PFSS reproduces it.
A Solar Image Analysis session (.ecsolar) from
version 3.1 or earlier can still be opened with Project >
Open Project…: it is imported as a new, unsaved project.
.ecsolar files are no longer written.