University of Oulu

Cai L, Aikio A, Kullen A, Deng Y, Zhang Y, Zhang S-R, Virtanen I and Vanhamäki H (2022) GeospaceLAB: Python package for managing and visualizing data in space physics. Front. Astron. Space Sci. 9:1023163. doi: 10.3389/fspas.2022.1023163

GeospaceLAB : Python package for managing and visualizing data in space physics

Saved in:
Author: Cai, Lei1; Aikio, Anita1; Kullen, Anita2;
Organizations: 1Space Physics and Astronomy, University of Oulu, Oulu, Finland
2Space Plasma Physics, KTH Royal Institute of Technology, Stockholm, Sweden
3Department of Physics, University of Texas at Arlington, Arlington, TX, United States
4The Johns Hopkins University Applied Physics Laboratory, Laurel, MD, United States
5Haystack Observatory, Massachusetts Institute of Technology, Westford, MA, United States
Format: article
Version: published version
Access: open
Online Access: PDF Full Text (PDF, 51.6 MB)
Persistent link:
Language: English
Published: Frontiers Media, 2022
Publish Date: 2022-12-14


In the space physics community, processing and combining observational and modeling data from various sources is a demanding task because they often have different formats and use different coordinate systems. The Python package GeospaceLAB has been developed to provide a unified, standardized framework to process data. The package is composed of six core modules, including DataHub as the data manager, Visualization for generating publication quality figures, Express for higher-level interfaces of DataHub and Visualization, SpaceCoordinateSystem for coordinate system transformations, Toolbox for various utilities, and Configuration for preferences. The core modules form a standardized framework for downloading, storing, post-processing and visualizing data in space physics. The object-oriented design makes the core modules of GeospaceLAB easy to modify and extend. So far, GeospaceLAB can process more than twenty kinds of data products from nine databases, and the number will increase in the future. The data sources include, e.g., measurements by EISCAT incoherent scatter radars, DMSP, SWARM, and Grace satellites, OMNI solar wind data, and GITM simulations. In addition, the package provides an interface for the users to add their own data products. Hence, researchers can easily collect, combine, and view multiple kinds of data for their work using GeospaceLAB. Combining data from different sources will lead to a better understanding of the physics of the studied phenomena and may lead to new discoveries. GeospaceLAB is an open source software, which is hosted on GitHub. We welcome everyone in the community to contribute to its future development.

see all

Series: Frontiers in astronomy and space sciences
ISSN: 2296-987X
ISSN-E: 2296-987X
ISSN-L: 2296-987X
Volume: 9
Article number: 1023163
DOI: 10.3389/fspas.2022.1023163
Type of Publication: A1 Journal article – refereed
Field of Science: 115 Astronomy and space science
1171 Geosciences
114 Physical sciences
Funding: The development of the GeospaceLAB package is supported by the Kvantum Institute at University of Oulu. AK and LC acknowledge postdoc grant DNR-155A/17 funded by Swedish National Space Agency. YD was supported by AFOSR through award FA9559-16-1-0364 and NASA grants 80NSSC20K0195, 80NSSC20K1786 and 80NSSC22K0061. S-RZ acknowledges MURI grant ONR15-FOA-0011 and NSF grant AGS-2033787. HV was supported by the Academy of Finland project 314664. The authors acknowledge all the developers who developed the dependencies used in GeospaceLAB. The authors also acknowledge the data providers listed in Table 1 to support the open access of data. Millstone Hill ISR observation, GNSS TEC data processing, and Madrigal database system are provided to the community by MIT under the US NSF grant AGS-1952737 support. We acknowledge use of NASA/GSFC’s Space Physics Data Facility’s OMNIWeb (or CDAWeb or ftp) service, and OMNI data.
Academy of Finland Grant Number: 314664
Detailed Information: 314664 (Academy of Finland Funding decision)
Copyright information: © 2022 Cai, Aikio, Kullen, Deng, Zhang, Zhang, Virtanen and Vanhamäki. This is an open-access article distributed under the terms of the Creative Commons Attribution License (CC BY). The use, distribution or reproduction in other forums is permitted, provided the original author(s) and the copyright owner(s) are credited and that the original publication in this journal is cited, in accordance with accepted academic practice. No use, distribution or reproduction is permitted which does not comply with these terms.