Export to JHelioviewer¶
Qorona output drops into JHelioviewer for viewing and overlay
on observed imagery, through two registered routes: WCS-registered FITS for the image
products, and SunJSON geometry for field lines. Both need a timestamp (--timestamp, or a
volume baked with one): it sets the observation time the file is registered at.
| Route | Commands | JHelioviewer layer |
|---|---|---|
| FITS raster | render --export fits, wl --export fits |
image layer, WCS-registered |
| SunJSON field lines | fieldlines --export sunjson, export-lines |
Connection Layer, 3-D lines |
FITS rasters¶
--export fits writes the quantitative frame beside the PNG: render stores the
LOS-averaged log₁₀ Q⊥ (float32), wl the display frame plus the raw pB/total frames as
extensions. Drop the file into JHelioviewer and it registers at the correct scale,
orientation, position, and time; sunpy.map.Map reads the same registration for scripted
analysis. The run's full provenance rides in the FITS header.
--observer earthpoints the camera from the real Earth viewpoint at the timestamp, so the overlay matches Earth-based observations exactly (any named observer works the same way; see Camera).- The disk: with the default eclipse occulter it stays NaN, transparent in JHelioviewer, so
real disk imagery shows through;
render --occult compositefills it with the near-side surface Q instead.
Field lines as SunJSON¶
SunJSON is the geometry format of JHelioviewer's Connection Layer: drop the .json onto a
running JHelioviewer and the bundle appears in 3-D, at its timestamp on the timeline. Lines
carry the polarity palette of the field-line view (open warm/cool
by inner-foot B_r sign, closed neutral grey) and an open/closed topology tag.
qorona fieldlines ... --export sunjson: exactly the drawn bundle beside the PNG, with the same seeding, selection (--show), and colours as the image, the eclipse look included.qorona export-lines: a self-contained full trace on a uniform longitude/latitude seed grid (--seeds N_THETA N_PHI, default 100x100;--seed-radiusmoves the seed sphere); no camera involved.
qorona export-lines data/coconut_corona.CFmesh.xz -o data/coconut_fieldlines.json \
--timestamp 2025-10-09T18:19:52 --seeds 40 80
The solution frame¶
Both routes write positions in Carrington coordinates, which is what JHelioviewer expects, and
both start from the solution's own frame: the FITS observer and the SunJSON longitudes are
shifted by the declared frame's offset (--frame, see Camera), zero for a
Carrington frame and L0 for a Stonyhurst one. The frame is therefore part of the registration:
exported under the wrong one, a product lands up to 360 degrees off in longitude, and nothing in
the file reveals it. Without a declaration Qorona falls back to Carrington and warns.