Changelog

---

Release of Service v3.7.0 (08.10.2021)

Features:

• New API for Swarm-A/Swarm-B conjunctions
  The VirES server calculates times of minimal angular separation (conjunctions) between the Swarm-A and Swarm-B spacecrafts. These times can be requested via a new server API (see client documentation).
• Upgrade of the AMPS magnetic model
  The AMPS model has been upgraded its current latest version 0104 (pyAMPS v1.5.2).
• Removing Facebook social network authentication
  Sadly, due to the unfavourable service terms we had to remove the Facebook social network authentication from VirES. If Facebook was your only login method, please request your new password via the password reset or contact us via support@vires.services.

---

Release of Service v3.6.0 (23.08.2021)

Features:

• New Plasmapause Related boundaries in the topside Ionosphere as derived from Swarm Measurements (PRISM) products
  The data from the new MITx_LP_2F, MITxTEC_2F, PPIxFAC_2F products prepared by the PRISM project have been added to VirES and they are accessible through the VirES API.
• New CryoSat-2, GRACE and GRACE-FO magnetic measurements
  API access to magnetic field measurements acquired by the CryoSat-2, GRACE and GRACE-FO missions has been added to VirES.
• Multi-mission support
  The "VirES for Swarm" server and API has been extended to support products from missions other than Swarm, including the auxiliary data such as the orbit numbers and directions.
• Swarm spacecraft position from MODx_SC_1B products
  The Swarm spacecraft positions are now read from the MODx_SC_1B products with better temporal coverage than the previously used MAGx_LR_1B. The MODx_SC_1B positions are also available via the VirES API.

---

Release of Service v3.5.0 (15.04.2021)

Features:

New Auroral Electrojet and auroral Boundaries estimated from Swarm observations (AEBS) products
The data from the new AEJxLPL_2F, AEJxPBL_2F, AEJxLPS_2F, AEJxPBS_2F, and AOBxFAC_2F products have been added to VirES and they are accessible through both the API and Web-GUI.

• New virtual observatory products
  The VOBS products prepared by the GVO project are now accessible via the VirES API.
• New ground magnetic observatory data
  The INTERMAGNET and WDC hourly AUX_OBS products are now accessible via the VirES API.
• Orbit plotting
  It is now possible to plot orbits of the Swarm spacecrafts in the Globe view.
• Improved AEBS products plotting
  The AEBS peaks and boundaries are now be displayed also in the Analytics view 2D plots.

For more details on the VirES API, see the VirES Python Client documentation.

---

Release of Service v3.4.0 (02.10.2020)

Features:

• New Auroral Electrojet and auroral Boundaries estimated from Swarm observations (AEBS) products
  The data from the new AEJxLPL_2F, AEJxPBL_2F, AEJxLPS_2F, AEJxPBS_2F, and AOBxFAC_2F products have been added to VirES and they are accessible through both the API and Web-GUI.
• New new magnetic observatory data
  The INTERMAGNET and WDC 1 minute and 1 second AUX_OBS products are now accessible via the VirES API.

---

Release of Service v3.3.0 (05.06.2020)

Features:

• Adding the Swarm extended lithospheric model
  The Swarm extended lithospheric model MLI_SHA_2E has been added to VirES.
• New AMPS magnetic model
  The magnetic field calculated by the AMPS model has been added to VirES.
• Composed magnetic models
  A set of new composed magnetic models have been added to VirES. These composed models group already available simple models and form new, complete and easy-to-use ones:
  • SwarmCI - Swarm Comprehensive Inversion model (MCO_SHA_2C, MLI_SHA_2C, MMA_SHA_2C, MIO_SHA_2C)
  • CHAOS-7 (CHAOS-7 Core, CHAOS-7 Static, CHAOS-MMA)
  • CHAOS-MMA (CHAOS-MMA-Primary + CHAOS-MMA-Secondary)
  • MMA_SHA_2C (MMA_SHA_2C-Primary, MMA_SHA_2C-Secondary)
  • MMA_SHA_2F (MMA_SHA_2F-Primary, MMA_SHA_2F-Secondary)
  • MIO_SHA_2C (MIO_SHA_2C-Primary, MIO_SHA_2C-Secondary)
  • MIO_SHA_2D (MIO_SHA_2D-Primary, MIO_SHA_2D-Secondary)
• New dDst index
  The absolute value of the Dst temporal rate of change has been added to VirES as a new index quantifying the magnetospheric activity.
• VRE automatic VirES access configuration
  The VRE is now initialized automatically and it is no longer needed to configure the VirES Python client manually.

---

Release of Service v3.2.0 (06.04.2020)

Features:

• Python 3 and Django 2.2 support
  The VirES for Swarm server has been migrated to Python 3 and Django 2.2.
• MAGx_HR_1B
  High-resolution MAGx_HR_1B products are accessible via the server API (VirES Python client).
• New EEFxTMS_2F baseline 02
  The EEFxTMS_2F baseline 02 products are now provided by VirES.
• Removal of the deprecated models
  The deprecated IGRF12 and CHAOS-6-* models have been removed from VirES.

---

Release of Service v3.1.3 (20.01.2020)

Features:

• IGRF-13
  The IGRF model has been upgraded to the latest 13th generation. This update also affects calculation of the magnetic coordinates (dipole, quasi-dipole and magnetic local time).

---

Release of Service v3.1.2 (11.12.2019)

Features:

• Django 1.11
  Server migrated to Django 1.11.

---

Release of Service v3.1.1 (14.11.2019)

Features:

• CHAOS-7
  The CHAOS geomagnetic model has been updated to its latest version CHAOS-7.
• Redesigned data upload user interface
  The data upload user interface has been redesigned. It is now possible to set additional constant parameters not present in uploaded dataset. This feature can be use, e.g., to specify missing mandatory coordinates of a stationary ground observatory.
• VRE integration
  The Jupyter-based Virtual Research Environment (VRE) has been opened for all VirES users and a direct link has been added to the VirES client user interface.
• Reviewed service terms and conditions
  The VirES Service Terms have been reviewed and updated. In addition, a GDPR compliant Privacy Notice has been added.

---

Release of Service v3.1.0 (3.9.2019)

Features:

• New ionospheric plasma irregularities products (IPIR)
  Support for the new IPDxIRR_2F products has been added to VirES.
• Revised list of magnetic models
  Following outdated magnetic models were removed from VirES:
  • SIFM
  • MCO_SHA_2F
  Following crustal field models were added to VirES:
  • LCS-1
  • MF7
• Workspace export/import
  It is now possible to save the state of the VirES application to a JSON file. This file can be then later loaded recalling the saved application state.
• Workspace initial state invocation
  The VirES application can be invoked with a predefined state.
• Improved user data upload and support for CSV data format.
  The custom user data upload has been improved based on the feedback to the initial implementation released in v3.0.0. Support for arbitrary custom variables and CSV data format has been added. For more details, see the data format specification.
• Revised user management
  In order to allow access to multiple related services using one VirES user identity (single sign-on) the VirES user management has been revised. From now on, the users' identities are held by a separate OAuth2 Identity Server.
  Apart from a minor change of the user interface, this change is transparent to the VirES users. The existing accounts are preserved, including the social account authentication, and no action is required from the users.
• Authentication using GitHub accounts
  The GitHub has been added to the list of the supported social network identity providers and it is now possible to use GitHub account to log into VirES.

---

Release of Service v3.0.0 (10.5.2019)

Features:

• Full source products/models traceability
  Information about the source products/models and their versions is now available for both the downloaded data and data displayed in the client.
• Improved composed model GUI
  The client-side handling of the composed models has been thoroughly reviewed. The client GUI now shows information about the source models and the composed model expressions are now consistently shown throughout different parts of the web client.
• Enhanced field-lines
  The displayed field-lines can be now selected by clicking. Information about the apex and ground intersections is displayed for a selected field-line.
• New cyclic color-maps
  Two new cyclic color-maps (twilight and twilight-shifted) have been added to be used with cyclic variables such as latitude or MLT.
• User data upload
  A possibility to upload own data in the CDF file and compare them with the Swarm products has been added. The supported file format is identical the format of the downloaded data and most of the Swarm products (e.g., MAGx_LR).
• Machine-to-machine (M2M) interface
  The VirES server M2M interface has been opened for registered VirES users. This interface has been so far accessible only indirectly trough web client. Now it can used either directly via the low-level API (based on the OGC WPS protocol) or via an alternative VirES client (e.g. VirES Python Client.
• Token-based authentication for the M2M interface
  The access to the VirES server M2M interface is granted only for authenticated requests. A new option to use the token-based authentication has been added to VirES. The access tokens can be generated and revoked by the users themselves via the user settings of the web client.

---

Release of Service v2.3.0 (22.3.2019)

Features:

• Improved data plotting
  The data visualization has been improved by the following enhancements of the Analytic Viewer:
  
  • Multiple plots can be stacked vertically sharing the X-axis. Each plot can displays a different set of parameters.
  • The plotted data can be coloured by mapping values of another parameter.
  • New styling options were added such as the selection of font size of the labels, size and symbol of the data points or their optional connection by line.
  • Naturally periodic parameters (longitude, QD-longitude, MLT) are displayed using periodic axes.
  • Special "periodic latitude" and "periodic QD-latitude" axes were added to display data periodically along the polar orbit of the Swarm satellites.
• Reworked model selection
  The selection of the geomagnetic models has been thoroughly reworked to allow composition of new derived models from different components such as core, lithosphere, magnetosphere and ionosphere. These new composed models can be visualized or subtracted from the satellite measurements (residuals).
  The source models can be constrained by a desired range of degrees of the spherical-harmonic coefficients and added to or subtracted from each other.

---

Release of Service v2.2.3 (15.2.2019)

Features:

• New model data
  Following new models have been added for visualization, analysis and filtering options:
  
  • CHAOS-6-MMA-Primary
  • CHAOS-6-MMA-Secondary
• Updated TEC support
  The TEC product support has been aligned with the latest baseline and VirES newly allows access to the Elevation Angle and Absolute Vertical TEC parameters.
• Magnetic models' validity
  Handling of the magnetic model validity has been improved:
  • The validity period of the magnetic models is now dynamically synchronised with the server.
  • The validity period is now displayed also for the user provided Custom SHC model.
  • The models are not visualized for time selections outside their validity period.

---

Release of Service v2.2.2 (11.1.2019)

Features:

• New plasma products
  Support for the new EFIx_LP_1B has been added to VirES. The new EFIx_LP_1B products replaced the discontinued EFIx_PL_1B products.

---

Release of Service v2.2.1 (4.9.2018)

Features:

• New model data
  New models have been added for visualization, analysis and filtering options. When selecting magnetic (MAG) product in combination with models the respective residuals will be calculated which can be used for filtering and plotting parameters. It is also possible to calculate the difference between models by opening the settings panel and selecting another model from the "Difference to" drop-down selection. The newly integrated models are:
  
  • MMA_SHA_2F-Primary
  • MMA_SHA_2F-Secondary
• F10.7 index
  The F10.7 index has been added as a new index layer and its source has been changed from the AUX_IMF_2_ to AUX_F10_2_ product.

Release of Service v2.2 (4.6.2018)

Features:

• Plotting (Analytics viewer) tool reworked and updated
  The performance of the (scatter) plot tool has been increased and multiple new features have been introduced:
  • The user interface has been rearranged to provide more space for plotting, the download button has been moved to the navigation bar on top
  • By clicking on the parameter label it is possible to set the symbol to be used, as well as color and connection by line
  • By clicking on the axis parameter labels it is now possible to directly select which parameter should be used for which axis as well as the possibility to set the scale to logarithmic
  • The filters panel on the bottom is now scrollable allowing selection of any amount of filters you need to work with
  • The add filter button has been improved to more easily allow searching for a specific parameter (it is possible to filter by name, description and UOM)
  • The visualization of time on the x axis has been reworked to show better tick-marks as well as always showing complete dates for start and end ticks
• New model data
  New models have been added for visualization, analysis and filtering options. When selecting magnetic (MAG) product in combination with models the respective residuals will be calculated which can be used for filtering and plotting parameters. It is also possible to calculate the difference between models by opening the settings panel and selecting another model from the "Difference to" drop-down selection. The newly integrated models are:
  
  • MCO_SHA_2C
  • MCO_SHA_2D
  • MCO_SHA_2F
  • MLI_SHA_2C
  • MLI_SHA_2D
  • MMA_SHA_2C-Primary
  • MMA_SHA_2C-Secondary
  • MIO_SHA_2C-Primary
  • MIO_SHA_2C-Secondary
  • MIO_SHA_2D-Primary
  • MIO_SHA_2D-Secondary
• Updated TEC visualization
  The visualization of the TEC product has been updated to show vector lines in direction to the related GPS satellites (instead of the previous visualization of points offset in height for each measurement)
• F10.7 index
  A new parameter "F10.7 index" (taken form the AUX_IMF_2_ product) has been introduced to for additional sorting and plotting options

---

Release of Service v2.1 (20.10.2017)

Features:

• Alpha and Charlie satellite residuals
  The magnetic residual between satellites Alpha and Charlie in the NEC-frame have been added as parameters. The residuals can be accessed together with magnetic data from Swarm Alpha.
• Orbit number
  The orbit number has been added as a parameter counting the number of Equator crossings of the ascending node since the Swarm mission start.
• Spacecraft as product parameter
  A new parameter "Spacecraft" has been introduced to downloaded data to easily identify which satellite downloaded data originates from within a product.
• Solar position
  Several parameters to determine the position of the sun have been added as filters:
  • SunDeclination, SunRightAscension and SunHourAngle defining Sun position in the Equatorial Coordinate System
  • SunZenithAngle, SunAzimuthAngle defining Sun position in the local Horizontal Coordinate System
  See "Equatorial coordinate system" and "Horizontal coordinate system".
• All new parameters described above can be downloaded as part of a product by selecting them with the "Custom download parameters" in the Download panel.
• Cursor coordinates on globe
  On hover of the globe in the Globe View, latitude and longitude for that point will be displayed in the top-left corner.
• Extended Download panel functionality
  Parameter filters can be added directly in the Download panel by selecting "Add filter" in the Download panel. A Timestep filter enabling subsampling of the product. Subsampling can be enabled by selecting "Custom time subsampling" and specifying subsample interval in the Download panel. Subsampling will be applied to each daily product independently.
• Product names in Layers
  Several data selections have been renamed:
  • "Electric Field Data" changed to "Equatorial electric field (EEF)"
  • "Electron data" changed to "Total electron content (TEC)"
  • "Currents data" changed to "Electric current data (FAC)"
  • "Non S/C" changed to "AC" (currently only includes combined S/C FAC data)
• Model difference
  The difference between two models at any coefficient range can be displayed on the globe. This functionality can be accessed under settings of any of the geomagnetic models available in the Layers panel.
• CHAOS-6
  Geomagnetic field model CHAOS-5 has been replaced by CHAOS-6 in the Layers panel.
• Cartographic layer update
  "Blue Marble" layer previously available in the Layers panel has been updated with a "S2 Cloudless" mosaic, which has higher resolution and is based on Sentinel-2 data.

---

Release of Service v2.0 (20.03.2017)

Features:

• Asynchronous processing
  It is now possible to download filtered Swarm data from an arbitrarily large time span to one file. This can be done by defining your filters in the analytics view (in addition to area selection on the globe view) for a smaller time span. Once satisfied with your selection you can click on download. In the Download Manager which then appears you can set the time window of interest, then click on "Process & create link". The processing is then done in the background, the progress can be seen in the download panel. Once finished a download link is provided there for you to get the results. Download limit will be set to the equivalent of 50 Magnetic low rate products.
• Ionospheric total electron content data
  The data from TECxTMS_2F has been added to VirES with the possibility to view the Absolute slant TEC, Relative slant TEC and the root mean square error of relative slant TEC on the globe. A new visualization was created for this product to display the TEC parameter value for each of the paths to nearby GPS satellites simultaneously. The values for a timestamp are shown one above the other, allowing one to quickly see how many satellites were visible and what the values were for each timestamp shown.
• Field aligned current
  The data from FACxTMS_2F (single S/C soluton) and FAC_TMS_2F (combined S/C solution) has been added to VirES with the possibility to view the Field-aligned current (FAC) and Ionospheric radial current (IRC) on the globe and in the Analytics View. The combined S/C solution data can be found by selecting "Non S/C" and "Currents data (FAC)" in the Layers widget.
• Dayside equatorial electric field
  The data from EEFxTMS_2F has been added to VirES with the possibility to view the Estimate of the equatorial electric field (EEF) on the globe and in the Analytics View.
• Local evaluation of custom model
  Providing a more detailed rendering, one can restrict the evaluation of a custom uploaded spherical harmonics model to an area of interest with the Area Selection tool.
• Updated backplane map
  The new version of the backplane map offers the following improvements:
  • Digital Elevation Model (DEM) data merged from SRTM, ASTER and regional/local data like EU-DEM
  • New shaded relief with better generalization and geotopographical features
  • Improved generalization of coastlines and land polygons
  • Updated OpenStreetMaps data
  • Removed data gap within Antarctica

---

Release of Service v1.2 (21.12.2016)

Features:

• Resume session
  Upon termination of your session information about the view, time window, area, data and filter selections and all corresponding settings will be stored for your convenience. Upon restart of the service, your session will be resumed where you left off. The session state information is stored locally with your internet browser, unless VirES is accessed using private browsing.
• Jump to date
  To quickly access data from any part of the Swarm mission, press on the button in the top right corner of the timeslider slider. This will allow you to display data from a date of your choice. The time selection will be on a corresponding time of day as your previous time selection. If the previous time selection passes over midnight, the selection will be clipped to end at midnight
• Set detailed download time filter
  In addition to filtering Swarm products by a wide range of parameters when downloading, you can select "Custom time selection" in the Download Manager. This will make it possible to define a precise start and end time for the downloaded product. Other filters shown in the Download Manager will still apply to the data
• New overlay layers
  Three new overlays are available from the layers panel:
  • Coastlines and Countries: Black coastlines with light grey country borders
  • Graticules: Grid lines for geographic longitude/latitude
  • Magnetic graticules: Grid lines for magnetic longitude/latitude
• Additional colour scales
  When selecting Swarm products or models to display on the globe, the colour representation of the data can be set in the respective settings widgets found in the Layers widget. It is now possible to choose between 27 scales including ones such as viridis, plasma and portland. The names of custom1 and custom2 colour scales have been changed to diverging_1 and diverging_2 to better represent the corresponding style.

---

Release of Service v1.1 (26.09.2016)

Features:

• Plasma products
  The data from EFIX_PL_1B have been added to VirES with the possibility to view the plasma density and temperature, in addition to the spacecraft velocity and potential both on the globe and in the Analytics View. The full set of parameters are accessible on download
• Ionospheric bubble product
  The data from IBI_TMS_2F have been added to VirES with the possibility to view the bubble probability on the globe and in the Analytics View. Positive Bubble index detections are shown in the time slider. The full set of parameters are accessible on download
• Layers interface changes
  The Layers widget has changed separating out satellite specific products. Selecting a satellite specific product is now independent of selecting what satellites to view data from. Selection of satellite is done using separate checkboxes in the Layers widget. This change was introduced to make the Layers widget more compact after adding more products.
• Customize download fields
  When downloading data, in addition to customizing the exact filter values and format, it is possible to specify what parameters to include by ticking off on "Custom download parameters", then either select the data from a dropdown menu or type it in. This customization allows for parameters from multiple Swarm products.
• Label with colorscale information directly integrated into globe visualization
  Now when using the save function the currently configured color scale and ranges are saved also into the image. It is possible to toggle the visualization of the label in the settings panel for each Layer using the "Legend" tickbox.
• Dynamic range calculation for models
  When changing model parameters (for SIFM, IGRF12, CHAOS-5 and Custom Model), such as the coefficient range or height, the colorscale range is calculated and adjusted automatically. It is still possible to manually adjust the range with both textfields available in the settings panel. This change was introduced as it became clear that finding the correct range after changing model parameters was cumbersome for users and we wanted to facilitate the process.
• Single axis interaction
  When exploring the scatterplot, one can scroll when hovering over an axis to zoom along one axis while keeping the other axes ranges fixed. Similarily one can drag on an axis to pan the plot. These features apply to both the x-axis and the y-axes and complement the zooming and panning one can perform on the scatterplot itself to zoom along all axes.
• Zoom limit removed
  The zoom limit previously applied to the scatterplot is now removed. There are now no restrictions to how far you can zoom in or out. A reset button is added to enable the user to return to the initial zoom level and position at one's convenience.
• Customizable filter list
  The data filter histograms found in the Analytics View can be removed individually, and new histograms for any other available parameter can be added by selecting it in the histogram "Add" dropdown menu. Any active filters will be removed when its corresponding histogram is removed. In addition the filters can be hidden to allow for more space for the scatterplot.
• Secondary y-axis
  When selecting multiple parameters a second y-axis will appear. When selecting two parameters this means that each parameter has its own axis. If more than two parameters are selected, they will be grouped according to their range, such that the parameters with the most similar value ranges are grouped together and share an axis.
• Scatterplot units
  The units are now displayed in a parenthesis next to the axis parameter labels in the scatterplot.
• Extended time selection
  The time selection limit when selecting a time window from the time slider has been extended from 15 days to 30 days. The limit when downloading products has not changed and is still set at the equivalent of 5 unfiltered MAGX_LR products.

---