Site Logo
Site Logo
Heliophysics Software Search Interface
HSSI

GCMprocpy

1.5.2
Code Docs
Concise Description
GCMprocpy is a tool used for TIE-GCM and WACCM-X post processing and plot generation.
Description
GCMprocpy is a post-processing and plot generation tool for TIE-GCM and WACCM-X NetCDF output. It provides three interfaces (a PySide6 desktop GUI, a Python API, and one console command per plot type) and produces latitude-longitude maps in several projections with optional coastline, nightshade and wind-vector overlays, vertical cross-sections, time series, and fields interpolated along a satellite track. Supporting functions convert units, interpolate between pressure level and geometric height, and compute derived quantities including the NO, CO2 and OH band emission rates ported from the legacy tgcmproc processor. Its gpigen and imfgen commands also build the geophysical-index and IMF/solar-wind NetCDF files that drive a model run.
Authors
Nikhil Rao ( NSF National Center for Atmospheric Research , NSF NCAR High Altitude Observatory )
Functionality
Data Processing and Analysis 2D Slices Analysis Data Access and Retrieval Data Reduction File Format Conversion Processing Time Series Analysis Data Visualization 2D Graphics 2D Slices Line Plots Movies Models and Simulations Physics-Based
Technical Details
Programming Languages Python 3.x
Operating Systems Linux
CPU Architecture HPC or HEC x86-64
Development Status Active
Publication Date Oct 28, 2024
Publisher GitHub
Data & File Formats
Data Sources CDAWeb FTP/FTPS Directories GFZ HAPI HTTP/HTTPS Directories OMNIWeb Other
Input Formats ascii HDF5 JSON netCDF3/4
Output Formats netCDF3/4 Other
Science Context
Related Phenomena Geomagnetic Storms Solar Wind
Related Regions Earth Atmosphere Earth Ionosphere Earth Lower and Middle Atmosphere Earth Thermosphere Solar Wind Interplanetary Space
Keywords
airglow data visualization f10.7 general circulation model geophysical indices IMF interpolation ionosphere kp index mesosphere model output netcdf omni plotting post-processing pyhc package python satellite flythrough solar wind thermosphere TIEGCM upper atmosphere waccm-x whole atmosphere
Related Items

Related Datasets

https://doi.org/10.5880/Kp.0001
https://hpde.io/NASA/NumericalData/OMNI/HighResolutionObservations/Version1/PT1M

Related Software

https://github.com/cmweiss/geomag
https://github.com/hapi-server/client-python
https://github.com/nasa/Kamodo
https://pypi.org/project/tiegcmpy/
https://www.hao.ucar.edu/modeling/tgcm/tiegcm2.0/userguide/html/postproc.html

Interoperable Software

https://doi.org/10.5281/zenodo.20076374
https://github.com/pydata/xarray
https://www.cesm.ucar.edu/models/waccm-x
Licensing & Funding
License Apache License 2.0
Version Information
Current Version 1.5.2
Release Date Jul 01, 2026
Release Notes
Adds a --model waccmx option to both input-file generators, so gpigen and imfgen emit the WACCM-X (CESM) formats directly: unlimited time dimension, date/datesec, and a 3-hourly ap series derived from Kp via the official lookup table. Adds a derive-if-missing resolver with in-place NetCDF persistence for intermediate fields, the RHO, PMB and TNFP derivables and the OX/NOZ/HOX composition groups and O/CO2 ratios ported from tgcmproc mkderived.F, cosine-latitude area-weighted wmean averaging, and WACCM-X hybrid-pressure support in the density conversions. Fixes the EP flux divergence mass density and raises a chain-aware error naming the missing dependency when a derivable cannot be computed.
Back to Software Catalog