Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


GCPy: Python toolkit for GEOS-Chem

GCPy is a Python-based toolkit containing useful functions for working specifically with the GEOS-Chem model of atmospheric chemistry and composition.

GCPy aims to build on the well-established scientific Python technical stack, leveraging tools like cartopy and xarray to simplify the task of working with model output and performing atmospheric chemistry analyses.

What GCPy was intended to do:

  1. Produce plots and tables from GEOS-Chem output using simple function calls.
  2. Generate the standard evaluation plots and tables from GEOS-Chem benchmark output.
  3. Obtain GEOS-Chem's horizontal/vertical grid information.
  4. Implement GCHP-specific regridding functionalities (e.g. cubed-sphere to lat-lon regridding)
  5. Provide example scripts for creating specific types of plots or analysis from GEOS-Chem output.

What GCPY was not intended to do:

  1. General NetCDF file modification: (crop a domain, extract some variables):
  2. Statistical analysis:
  3. Machine Learning:


For more information on installing and using GCPy, visit the official documentation at


GCPy is distributed under the MIT license. Please read the license documents LICENSE.txt and AUTHORS.txt, which are located in the root folder.


To contact us, please open a new issue on the issue tracker connected to this repository. You can ask a question, report a bug, or request a new feature.