Space Weather JHelioviewer is an outcome of the ESA Contract No. 4000107325/12/NL/AK - High Performance Distributed Solar Imaging and Processing System - run at the Solar Influences Data Analysis Center (SIDC, http://sidc.be) of the Royal Observatory of Belgium (ROB) under the supervision of Space Environments and Effects section of ESA (ESTEC/TEC-EES, http://space-env.esa.int). This project builds upon the infrastructure of ESA/NASA Helioviewer Project (http://helioviewer.org) at all levels of the software stack, and significantly augments the capabilities of the JHelioviewer software (http://www.jhelioviewer.org).
The JHelioviewer solar data visualisation tool has been overhauled with a strong focus for space weather usage. The viewer is able to display solar image data, and one-dimensional and two-dimensional solar timeline data.
The solar images can be projected on a sphere. They can be rotated, translated, and zoomed in and out the sphere. Other projections are available, such as solar latitudinal or (log)polar. Field lines of the solar magnetic field calculated by a PFSS model can be displayed.
The timeline viewer shows one-dimensional and two-dimensional data. The time interval displayed can be translated and zoomed freely.
Several types of space weather related events can be displayed. Both the Heliophysics Events Knowledgebase and the COMESEP project provide the events. The events can be visualised on both the images and the timelines.
Since JHelioviewer is still rapidly evolving, this document may not reflect entirely all the capabilities of the software. Information and support requests can be sent to email@example.com.
JHelioviewer is a Java application that requires the Java Runtime Environment to be installed on the computer. The required Java version is 8, and JHelioviewer works best with the latest available Java 8 update, available at http://java.com. 64-bit computers should use the 64-bit version of Java.
The JHelioviewer software does advanced data processing and visualisation; therefore it works best on a reasonably recent computer with decent CPU and OpenGL graphics power, and memory. The minimal OpenGL version required is 2.1.
JHelioviewer is an open source project and its source code can be accessed at https://github.com/Helioviewer-Project/JHelioviewer-SWHV. Its releases are available in compiled form for Windows, Mac OS X and Linux from http://swhv.oma.be/download.
java -jar path/to/JHelioviewer.jar.
This procedure works for Windows, Mac OS X and Linux.
When the program opens for the first time, a directory structure (
JHelioviewer-SWHV) is created in the home directory. It contains configuration files, exported movies, plugins and other data.
The Troubleshooting and Frequent Asked Questions sections may contain contain useful hints about installing and running JHelioviewer.
The main user interface consists of the toolbar, the image canvas, the timeline canvas, the control panels, the view status and the mouse position indicators.
The toolbar is divided into three parts: the camera controlling part, the image controlling part and the three distinct miscellaneous parts. The camera controlling part allows to zoom in and out the image, fit the image in the available canvas, show the image at full scale (one image pixel corresponding to one pixel on screen), and reset the camera back into its original orientation.
The image on the image canvas can be rotated, translated and annotated. Each of those interaction modes can be enabled in the image controlling part of the toolbar.
The miscellaneous part of the toolbar contains buttons to switch on and off the solar rotation tracking and the visibility of off-disk corona. The corona button hides the off-disk corona from the images, while the solar rotation tracking button fixes the camera orientation and co-rotates with the Sun while the movie is played.
The image canvas displays in four projections: the default orthographic, latitudinal, logpolar and polar projection. Switching from one projection to the other is instantaneous.
There is also a direct link to the SDO AIA get data page (http://www.lmsal.com/get_aia_data/).
See the image canvas manipulation section and the toolbar figure for all the functionalities.
The image canvas displays the visible image layers. The images of the Sun are projected on a sphere. As long as no manipulations to the scene are done, and the camera is in observer mode (see the camera section), the image is an undistorted representation of the two-dimensional data recorded by the instrument.
The timeline canvas shows timelines and radio spectrograms (see the timeline figure). The timeline canvas can have multiple y-axes. It can display multiple timelines and space weather events. The time handling section visualises the position in time, the movie interval and the visible interval.
The movie controls allow playing and pausing the current movie. The movie can be advanced by one frame at a time in forward or backward direction. The image canvas can be recorded (see the section on recording). The movie controls have additional options where the frame rate, animation mode, and the recording mode and size can be set.
The image layers panel provides an overview of the image layers and the options of the selected layer. Information about the layers is given in the table listing. Some layers can be deleted; all layers can be made visible or invisible. The visible layers will be displayed on the image canvas. Every layer has specific options that become available if the corresponding entry in the table is selected. New image layers can be added. The image layer displayed with a bold name is the master image layer. The program time, the movie panel frame indication, and the frame rate displayed by the status indicator are based on the master layer. The full resolution zoom level is also based on the resolution of the master layer. The program attempts to match the frame timestamps of the other image layers to the master layer. Clicking on the name of another image layer leads to the change of the master layer.
The timeline layers panel is similar to the image layers panel. It has two parts: the listing of all the timeline layers and the options attached to the selected timeline layer. Some layers can be deleted; all layers can be made visible or invisible. All visible layers will be displayed on the timeline canvas. Some layers have specific options that become available when the corresponding entry in the table is selected. New timeline layers can be added.
The Space Weather Event Knowledgebase or SWEK offers a list of space weather related event types. Several event types can be enabled. Events for the current period will be downloaded and displayed by the image canvas and the timeline canvas if the corresponding event layers are made visible.
The view status shows the size of the field of view in solar radii, the distance from the Sun, the Carrington rotation number and the current frame rate of image decoding.
The position indicator shows the mouse position in solar coordinates (latitude, longitude) if the mouse pointer hovers over the solar surface, and the plane-of-sky radial distance from the Sun centre.
The image canvas can be manipulated in several ways. It can be zoomed, rotated and translated, the solar rotation can be tracked, the off-disk corona can be made visible or invisible, and the projection can be changed. All those manipulations can be performed from the toolbar as shown in the toolbar figure.
The image can be zoomed by pressing the zoom in and zoom out buttons in the toolbar and also with the mouse by scrolling up and down, or by using the shortcut keys:
The zooming will always take the centre of the image canvas as the focus point. The toolbar figure shows the different zoom options.
The standard mouse operation mode is rotation. By clicking and holding the mouse button, the Sun can be grabbed and rotated freely. By selecting the pan option in the toolbar, clicking and dragging the mouse results in a translation of the image in the image canvas. The figure below shows the result.
It is possible to annotate the image canvas with rectangles, circles and crosses. The annotation figure shows an annotated image canvas and the modes when clicking the annotation button. Click the annotate button and select the annotation shape to change to annotation mode. There are three annotation shape modes: rectangle, circle and cross. If more than one annotation is added, the red one indicates the active annotation. The active annotation can be changed by pressing the n-key. It is not possible to annotate outside the solar disk.
Consider the situation shown by the annotation figure. By pressing n-key, another annotation will become red. Pressing the forward or the backward delete key can delete the red rectangle. In order to delete a cross, press the n-key until the desired cross becomes highlighted in red and then the delete key has to be pressed. The annotations can deleted all at once via the menu item “View>Clear annotations” or from the toolbar annotation mode button.
The solar rotation can be tracked. Zoom, rotate and translate the image until a desired feature is visible. Enable the tracking mode in the toolbar and play the movie. The image canvas will show the evolution of the selected feature.
The figure below shows the tracking in action. Top image is the start position. The image was zoomed, rotated and translated on top of the active regions and tracking was enabled. The first image is taken at time 08:09:46, the middle image is at 19:43:58 and the bottom image is at 07:39:10 the next day. Notice that the same active regions stay in view and the miniview moves slightly to the solar West.
The off-disk solar corona can hidden by clicking the corona button in the toolbar. The figure below shows the result after turning on this mode.
Jhelioviewer is able to show images in four projections: orthographic, latitudinal (only for images on the solar disk), logpolar and polar. To change the projection click the projection button and select the projection. Projection figure 1 shows the orthographic and latitudinal projection, projection figure 2 shows the logpolar and polar projection.
The SDO Cut-out option will open the SDO AIA Get Data page (http://www.lmsal.com/get_aia_data/) at LMSAL with some of the parameters already filled-in based on the current AIA image layer stack.
The movie controls panel contains the tools to play the movie (see the movie panel figure). The movie can be played after at least one image layer with several frames was loaded. The movie is started by pressing the play button or by the ctrl/cmd + p shortcut. The play button becomes a pause button if the movie is playing. The slider visualises in light blue which image frames are partially downloaded and in dark blue which image frames are fully downloaded. The movie can be advanced by one frame at a time in the forward or backward direction by pressing the buttons or by using ctrl/cmd + right arrow and ctrl/cmd + left arrow, respectively. Clicking on the slider or on the timeline canvas allows jumping to arbitrary frames of the movie.
The movie controls panel contains a section with options. The movie options are shown in the movie panel figure. The speed of the movie can be changed, as well as the animation mode from the default loop mode to stop or swing mode. The loop mode will replay the movie from the beginning if the movie reaches the end of the movie, the stop mode will just stop at the end, and the swing mode will play the movie backward and forward again.
The timelines canvas shows the visible timelines. Once a timeline is loaded, it is displayed. The canvas can be translated freely in time by dragging it further to the past or to the future, shift+scroll will do the same. Scrolling on the plotted lines will zoom in time. Holding ctrl while scrolling, or scrolling with the mouse positioned on top of a y-axis will zoom the corresponding values. Clicking and holding the mouse above one the y-axes will translate the y-axis on which the mouse was located. Holding alt while scrolling will zoom both in time and value. Double-clicking the timeline canvas will fit independently the datasets in the plot area. Double-clicking a y-axis will reset its scaling to default.
To zoom in time to some predefined time intervals, like the maximum interval already downloaded, one year, six months, three months, one Carrington rotation, seven days and twelve hours, select one of those options in the dropdown menu located on timeline layers panel. The maximum interval is the interval currently visible in the timeline canvas. Selecting one of the possible periods will increase the interval to the interval of choice while keeping the old intervals upper limit.
Quick jumps to another time are possible by clicking in the interval indicator. The click position will be the centre of the new visible interval.
Everything drawn on the image canvas is an image layer. Those layers can be images of the Sun produced by different instruments, a solar grid, a timestamp, a visualisation of a solar magnetic field model (PFSS), the viewpoint, the miniview, and the space weather events (SWEK). The image layers can be deleted by pressing the red cross icon, the other layers are fixed and can only be made visible or invisible by pressing the adjacent checkbox. The layers are drawn on the image canvas in the order from the top of the list to the bottom. Dragging and dropping the image layers can change the order.
Each layer has specific options that become available when selecting its entry in the table listing.
The table below records the image providers as of November 4, 2016; for an up-to-date list, check the program.
|Intensity 1083 Å|
|Intensity 6302 Å|
|EUVI 171 Å|
|EUVI 195 Å|
|EUVI 284 Å|
|EUVI 304 Å|
A new image layer can be added by clicking the “New Layer” button (ctrl/cmd + n).
- a new dialog box will appear,
- select image data as data type,
- set the start date and the end date,
- select the time step,
- select the server from where to download the data,
- select the observatory, instrument and detector/measurement,
- click “Add” to add the layer to the image layers panel or cancel to stop
The image servers currently available are ROB, GSFC and IAS.
The layer is now added to the list of image layers. The layer becomes the master layer and will drive the timing for playing the movies. A layer can also be added by opening an image or series of images via the menu item “File>Open…”. A file selection dialog will open. Select the wanted image or image series to be added to the image layers. A layer can be removed by clicking the red cross. The loading of a layer can be cancelled by clicking the red cross while the layer is still loading.
To change the options of a layer, it has to be selected in the table listing and its options panel will become available underneath the listing. New layers are added with increased levels of transparency to avoid fully concealing the layers beneath and the opacity of each layer can be controlled from its options panel.
Image layers can be replaced by double-clicking in the listing and modifying any of the selection parameters that were initially used. The time span of all image layers loaded can be matched by clicking the “Synchronize layers time span” button.
The multiview figure shows what happens if the “Multiview” option is selected. The layers are displayed side-by-side instead of on top of each other. In this mode, up to four layers can be placed together in the image canvas.
The availability of image datasets can be checked for the ROB server by clicking on the “Available data” button at the bottom left of the dialog box. A web browser window will open with a page showing an approximation of the available data on the ROB server. The darker the green, the more images are available.
An image layer has several options shown in the image options figure. Selecting the image layer in the table listing allows the change of the options of an image. The options for the selected layer become available at the bottom part of the image layers panel.
Each layer can be displayed in a difference images mode. Several modes can be selected in the dropdown menu: “No difference images”, “Running difference” or “Base difference”. No difference images (default) will show the normal image, running difference will subtract the previous image in the sequence from the current image, and base difference will subtract the first image in the sequence from the current image. The figure below shows the result of the two types of difference images compared to the original image.
The opacity, the perceived sharpness of the image, the low and the high level can also be adjusted. Click between the levels slider thumbs and drag left or right to move together the levels. Double-click to reset the levels. An automatic high level dependent on the content of current image can be calculated by pressing on the “Auto” button. To change the colors used for the image select a different colormap in the dropdown menu. The available colormaps are listed in the list of colormaps. The colors of the image can be inverted by clicking the button next to the colormap dropdown menu. Individual color channels can be turned on and off.
|SDO-AIA 94 Å|
|SDO-AIA 131 Å|
|SDO-AIA 171 Å|
|SDO-AIA 193 Å|
|SDO-AIA 211 Å|
|SDO-AIA 304 Å|
|SDO-AIA 335 Å|
|SDO-AIA 1600 Å|
|SDO-AIA 1700 Å|
|SDO-AIA 4500 Å|
|SOHO EIT 171 Å|
|SOHO EIT 195 Å|
|SOHO EIT 284 Å|
|SOHO EIT 304 Å|
|STEREO EUVI 171 Å|
|STEREO EUVI 195 Å|
|STEREO EUVI 284 Å|
|STEREO EUVI 304 Å|
The download button next to the difference image selection combobox allows the download of the data for the selected layer. A JPX file in case of a multiframe layer, or a JP2 file can be found in the Downloads directory of the JHelioviewer home folder.
The FITS keywords can be shown by clicking the information icon next to the download icon. Basic information such as the observatory, instrument, detector and observation time, followed by the full list of FITS keywords, are displayed.
Click the button next to the invert colors button to make the corona better visible as is demonstrated in the enhance corona figure.
The grid can show heliographic coordinates as seen from the camera, Stonyhurst, Carrington and Heliocentric inertial coordinates. Two yellow great circles indicate the Earth direction. Clicking the adjacent checkbox can hide the grid. The grid options panel is shown in the figure below. The radial grid can be turned on and off; the same can be done for the solar axis (the blue and red lines at the poles of the Sun) and the grid labels.
The grid ticks size can be changed in both longitude and latitude. The value can be entered directly in the text field, it can be changed by scrolling the mouse over the text field, or by using the arrows. Values ranging from 5˚ and 90˚ are allowed.
The viewpoint represents the vantage point and manages how the images are viewed. The viewpoint is defined by a location, a time instance and a rotation with respect to the direction to Sun. There are three viewpoint modes: the observer view, Earth view and expert view. The different viewpoint modes are demonstrated in the figure below. The viewpoint is invisible by default. When visible, a field of view indicator is shown. In all viewpoint modes, entering the value in the text field, scrolling the mouse over the text field, or using the arrows can change the angle of the field of view indicator.
This is the view from the observer. The viewpoint time indicated in the layers list is defined by the timestamp of the master layer.
This is the view from Earth. For instruments located around Earth, this is very similar to the observer view, but for the case of STEREO or other instruments at a different location in the solar system, this view is different. The viewpoint time indicated in the layers list is defined by the timestamp of the master layer.
The expert view allows seeing the image as from a specific location. At the moment, the following locations are available:
The expert view uses an online location service. If the status of the expert view is not “Loaded”, there was a problem with the connection to the location service and the expert camera won’t work.
If “Use active layer timestamps” is selected the timestamps of the master layer are used for the viewpoint time, otherwise arbitrary time intervals can be used for the viewpoint time. The image canvas scene will correctly show the geometric configuration and orientation of the solar system bodies involved.
The timestamp indicated by the viewpoint is the one of the master layer for the observer and Earth camera modes. For the expert mode, it is the time of the expert viewpoint.
The timestamp is invisible by default. If it is made visible, the timestamp of the master layer will appear on the image canvas as shown in the figure below. The timestamp has no options.
The miniview is an aid for locating the position of the current scene within the full field of view, particularly when zoomed in. The size of the miniview can be changed in the option panel by entering the value in the text field, by scrolling the mouse over the text field, or by using the arrows. The smallest and largest miniview are shown in the figure below.
The SWEK image layer shows the events that have location information. The events are shown as contours combined with an icon that indicates the type of the event. Events that are on disk are drawn on disk; events like CMEs are drawn as an arch around the Sun. The icons representing the event type can be switched on or off in the options panel. More information can be found in the SWEK section and, in particular, in the section on events on the image canvas.
The PFSS model visualises a model of the magnetic field derived from magnetograms. The field lines are calculated on a daily basis using GONG magnetograms. The timestamp given in the list of layers is the timestamp of the GONG magnetogram used for the calculations. The figure below shows different views of the model. The number of field lines shown can be varied by decimation when changing the level of detail between 0 and 8. By default, the outgoing parts of the field lines are drawn in red, the incoming parts in blue. By enabling the “Fixed colors”, loops will be drawn white, open outgoing field lines red and incoming field lines blue.
Clicking the “Available data” button brings will open a web browser window with a page showing the available data for the PFSS Model. The darker the green, the more data are available.
JHelioviewer is able to display 1D and 2D timelines. Similar to the images, the timelines have their own panel that lists the timeline layers. The timeline layers can be made visible or invisible. Some timeline layers have options that can be accessed by selecting the corresponding entry in the table listing. The options appear under the listing of the timeline layers.
The listings 1 and 2 below show the status as of November 4, 2016; for an up-to-date list, check the program.
|1D Timeline||SWHV Data||GOES XRS-A (shortwave)|
|GOES XRS-B (longwave)|
|EVE XRS-A proxy|
|EVE XRS-B proxy|
|EVE ESP 17_1|
|EVE ESP 25_7|
|EVE ESP 30_4|
|EVE ESP 36_6|
|EVE MEGS-P 121_6|
|GOES XRS-A (shortwave, STAFF)|
|GOES XRS-B (longwave, STAFF)|
|LYRA Lyman-alpha (STAFF)|
|LYRA Herzberg (STAFF)|
|LYRA Aluminium (STAFF)|
|LYRA Zirconium (STAFF)|
|Bands Data (AIA)||AIA_A94|
|2D Timeline||Radio Data||Callisto|
Timelines can be added and removed. The appearance of the timelines can be changed.
To add a new timeline follow the steps:
- click “New Layer” button of the timeline layers panel or the image layers panel,
- a new dialog box will appear. Select the “1D time series” as data type,
- pick a desired start date,
- select a group,
- select a dataset,
- press the “Add” button to add the layer
The timeline will be visible in the list of timelines and three days around the chosen date will be downloaded. The timeline will always be given a new y-axis.
The availability of timeline datasets can be checked for the ROB server by clicking on the “Available data” button at the bottom left of the dialog box or in the options panel of the timeline. A web browser window will open with a page showing an approximation of the available data on the ROB server. The darker the green, the more data are available.
Selecting the timeline and picking a new color with the color picker can change the color for each timeline. This is demonstrated in the figure below.
The only two-dimensional data available for the moment are the radio spectra from the global Callisto network of radio receivers. Composite images are created continuously by merging observations from several instruments at different locations, times and frequency bands, therefore the intensity units are arbitrary. The composite images can be shown in the timeline viewer by clicking on the checkbox next to the Callisto Radiogram in the timeline layers panel.
The radio data will appear on the timeline canvas. Images will be grey if the data is loading and if there is no data available. The visible interval should be smaller than three days before the radio data becomes visible. The more zoomed in, the more detail becomes available. This is all demonstrated in the figure below.
The colormap can be changed by selecting the “Callisto Radiogram” in the list of timelines and picking another colormap. The colormaps are listed in the list of colormaps.
In normal cases, the movie timestamp indicator (vertical black line) will jump towards the correct time as can be seen in the figure with locking mode off. Pressing the lock interval button locks the visible interval of a timeline. Instead of having the visible interval fixed, the interval keeps its width, but the movie indicator will be kept in the middle of the timeline canvas. As a consequence, the data will now slide through the timeline canvas instead of being fixed. This is demonstrated in figure with locking mode on. After the interval lock button was pressed, the visible interval will center around the start of the visible interval. Afterwards, the size of the selected timeline interval can still be adapted as described in the section on timeline canvas manipulation.
The timeline canvas is able to display space weather events. By default space weather events are visible and they can be made invisible by clicking the adjacent checkbox. The events are displayed as colored bars. Events with the same color are related. If the mouse pointer is hovering over an event, that event gets highlighted. More information can be found in the section on events on the timeline canvas.
JHelioviewer provides a way to download space weather related events. A selection of important space weather event types was made. The list below enumerates the current default event types.
|HEK||Active Region||NOAA SWPC|
|Coronal Mass Ejection||CACTus|
|Coronal Dimming||Halo CME|
|Coronal Dimming Module|
|Coronal Wave||Halo CME|
|Filament Eruption||Halo CME|
|Drag Based Model|
For the moment only two sources for events are used: the Heliophysics Events Knowledgebase (HEK) and the COMESEP alert system.
By checking or unchecking the checkbox next to the event provider, or to the event type, the event types are enabled or disabled, as shown in the figure below. Once an event or event type is enabled, the download for the selected interval will start. Events that were downloaded are kept in a cache. Enabling and disabling events only initiate a new download of the events for the last two weeks.
Some events can be filtered:
- click the “Filter” button next to the event type to filter,
- set the values for the filter,
- switch the filter button on,
- the event type will be filtered.
Just switch off the filter button to remove the filter.
Space weather events are displayed by means of contours in the color of the event, and an icon of the event type on the image canvas (see the figure of events on both canvases). The event will only be visible if it contains location information. Not all the events have location information. By hovering with the mouse pointer over the events in the image canvas, the event gets highlighted and some brief information about it will be shown next to the mouse pointer. If the event is visible in the timeline canvas, it will be highlighted too. An event information dialog will appear after clicking on the icon.
The events can be made visible or invisible by clicking the checkbox in the image layers list as described in the section on image layers panel.
Events are displayed as colored bars in the timeline canvas (see the figure of events on both canvases). Related events have the same color and if possible, aligned at the same height level. Events are grouped by event type. By hovering with the mouse pointer over the events, the events get highlighted. The event information dialog will be displayed after clicking on the event.
Each event has details that become visible after clicking on the event in the image canvas or the timeline canvas. A dialog box will appear with the detailed information of the event. The title of the dialog box together with the icon defines the event type. The start and end time of the event are given, together with a patch in the color used for the event. To locate the event in the canvases, hovering with the mouse pointer over the icon and the colored patch will highlight the event.
An event has a standard and an all parameters panel. The standard parameters are parameters that are the most important for the event. The all parameters panel contains a list of all the parameters returned by the event provider that contained a valid value. An http link as the value of a parameter is clickable and will open in the browser. Some parameters might be clickable and allow to search for papers mentioning this parameter and event.
The event information dialog can also contain relationship information. Three different relationships exist:
Some event providers send their events each day and also link them together. This is the case for active regions or coronal holes detected by SPoCA. The preceding and following events will get the same color. This is shown on the right part of the figure of detail dialog box for SPoCA active region events.
Some events are related by rules. The active region number provides the relationship between active regions and flares. If both the event types flare and active region are enabled and a flare has the same active region number as an active region, this relationship will be visible in the “Related by rule”-panel. This is shown on the left part of the figure of detail dialog box.
The related events panels contain a list of small panels containing for each of the related event the icon of the event type and the color. If the events are in view in the image or the timeline canvas, hovering with the mouse pointer over this panel will highlight the related event.
The image and timeline canvases can be exported in three ways: a one-loop movie, a screenshot, or an open ended recording of all the manipulations. All movies are saved in the directory
JHelioviewer-SWHV/Exports/ in the home directory. The export format is streamable H.264/AVC in a MP4 container file for the movies, and the PNG format for the screenshots. Several frame sizes are offered: the image canvas original size, 1280 by 720 pixels, and 1920 by 1080 pixels. The exported movie file has the selected frames per second setting.
The record button is in the movie control panel. The default recording mode is a one-loop movie of the selected visible image layers. The created movie file will contain the first until the last frame of the current movie. The screenshot mode will make a screenshot of the current image and timeline canvases. In unlimited mode, all the manipulations are recorded from the moment the record button is clicked. Clicking the same record button, now indicating “busy”, stops the recording. Removing all image layers also stops the recording.
On Mac OS X, the preferences can be found under the program menu (JHelioviewer), for Windows and Linux it is located in the menu “Options”. A new dialog opens. The preferred server and the loading of a default movie at start-up can be set. There are also settings for normalization of SDO/AIA data brightness for aesthetically pleasing mission long movies, as well as for normalization of EUV solar radius to visible light solar radius.
Parts of JHelioviewer are built out of plugins that can be disabled for a more streamlined application. Managing the plugins is done via the menu item “Plug-ins>Manage Plug-ins…”. A dialog box will open. The list of plugins can be filtered: all plugins can be displayed, or only the enabled or disabled plugins. Clicking on more gives detailed information about the selected plugin.
|Add New Layer||Cmd/Ctrl-N|
|Toggle Full Screen||Cmd/Ctrl-Enter|
|Exit Full Screen||Esc|
|Zoom to Fit||Cmd/Ctrl–9|
|Step to Previous Frame||Cmd/Ctrl-Alt-Left Arrow|
|Step to Next Frame||Cmd/Ctrl-Alt-Right Arrow|
|Remove Current Annotation||Delete / Backspace|
|Scroll Up||Zoom Out|
|Scroll Down||Zoom In|
|Click||Annotate in Annotation Mode|
|Click and Drag||Pan in Panning Mode|
|Rotate in Rotation Mode|
|Double-click on Graph||Rescale Graphs Between Minimum and Maximum values|
|Double-click on Axis||Rescale Graphs Between Default Minimum and Maximum value|
|Scroll Up on Graph||Zoom Out in Time|
|Scroll Down on Graph||Zoom In in Time|
|Scroll Up on Value-Axis||Zoom Out in Value|
|Scroll Down on Value-Axis||Zoom In in Value|
|Scroll Up on Time-Axis||Zoom Out in Value And Time|
|Scroll Down on Time-Axis||Zoom In in Value And Time|
|Shift-Scroll Up on Graph area||Move Forward in Time with Same Visible Interval|
|Shift-Scroll Down on Graph area||Move Backward in Time with Same Visible Interval|
|Ctrl-Scroll Up||Zoom Out in Time and Value|
|Ctrl-Scroll Down||Zoom In in Time and Value|
|Click||Move Movie Time Indicator|
|Click and Drag on Graph||Move Graph in Time and Value|
|Click and Drag on Value-Axis||Move Graph in Value|
To find out the installed Windows version:
To find out the installed Java version:
You may encounter JHelioviewer crashes if the system is 64-bit and the Java version is 32-bit. To resolve those problems, the 32-bit version of Java must be uninstalled by following the guidelines on the page:
Do a clean install of Java by following the guidelines on this page:
Try to start JHelioviewer again after finishing the clean Java installation.
Although a lot of effort was put into reducing the memory usage of JHelioviewer, it usually needs more than the default amount reserved by Java on 32-bit systems, which is very low for a program with those functionalities. The amount of memory reserved by Java can be tweaked from the command line.
To start JHelioviewer from the command line in Windows:
Type the following command:
java -Xmx1g -jar "C:\Program Files\JHelioviewer\JHelioviewer.jar"
or where is JHelioviewer installed.
This allocates maximum 1GB for Java and reduces the risk of running into out-of-memory errors.
To find the amount of memory allocated by Java type:
java -XX:+PrintFlagsFinal -version | findstr /R /C:"HeapSize"
The interesting value is MaxHeapSize. The default value can be as low as about 256MB.
Since the introduction of Windows 10, Intel does not provide updated drivers anymore for some of its integrated graphics chips and relies on the drivers included in Windows by Microsoft. The integrated Intel(R) HD Graphics 2000/3000 chip is one of those affected devices under Windows 10. The list of graphics chips supported by Intel with its own drivers can be seen in the following chart: http://www.intel.com/content/www/us/en/support/graphics-drivers/000005526.html.
The driver patch attached to the following comment may help to run JHelioviewer on the affected devices: https://github.com/LWJGL/lwjgl/issues/119#issuecomment-262090230
JHelioviewer needs at least OpenGL 2.1 support, while the highest version of OpenGL provided by Microsoft is 1.1. Support for higher versions of OpenGL can be added to Windows by installing the drivers from the graphics card manufacturer.
The current revision of this document is $Rev: 8792 $ and it can be read both in HTML format and in PDF format.
|2015–11–25||Update for UI changes|
|2016–03–09||HTML structure changes|
|2016–05–25||Update for UI changes up to 2.10.3|
|2016–11–04||Add FAQ and troubleshooting|
|2016–11–16||Update for UI changes up to 2.10.7|
|2017–05–23||Update for UI changes up to 2.11.3|
|$Date: 2017-08-23 10:10:05 +0200 (Wed, 23 Aug 2017) $||Minor updates|