##############################
GCPy: GEOS-Chem Python toolkit
##############################

.. raw:: html

   <p>
   <a href="https://github.com/geoschem/gcpy/releases"><img src="https://img.shields.io/github/v/release/geoschem/gcpy?include_prereleases&label=Latest%20Pre-Release"></a>
   <a href="https://github.com/geoschem/gcpy/releases"><img src="https://img.shields.io/github/v/release/geoschem/gcpy?label=Latest%20Stable%20Release"></a>
   <a href="https://doi.org/10.5281/zenodo.3689589"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.3689589.svg" alt="DOI"></a>
   <br />
   <a href="https://github.com/geoschem/gcpy/blob/main/LICENSE.txt"><img src="https://img.shields.io/badge/License-MIT-blue.svg"></a>
   <a href="https://github.com/geoschem/gcpy/releases/"><img src="https://img.shields.io/github/release-date/geoschem/gcpy"></a>
   <a href="https://gcpy.readthedocs.io/en/latest/"><img src="https://img.shields.io/readthedocs/gcpy?label=ReadTheDocs"></a>
   <a href="https://github.com/geoschem/gcpy/actions/workflows/build-gcpy-environment.yml"><img src="https://github.com/geoschem/gcpy/actions/workflows/build-gcpy-environment.yml/badge.svg"></a>
   </p>

Welcome to the GCPy ReadTheDocs documentation! This site provides documentation
on the functionality of GCPy and instructions for common use cases.

**GCPy** is a Python-based toolkit containing useful functions for
working specifically with the **GEOS-Chem** model of atmospheric
chemistry and composition. GCPy is primarily used for plotting/tabling
GEOS-Chem output and regridding input files in special cases.

For documentation on setting up and running GEOS-Chem please see our
`list of manuals for GEOS-Chem and related software
<https://geos-chem.readthedocs.io/en/latest/geos-chem-shared-docs/supplemental-guides/related-docs.html>`_.

.. toctree::
   :maxdepth: 4
   :caption: Overview

   About-GCPy
   Getting-Started-with-GCPy
   Matplotlib-Backend
   Guide-to-Useful-Capabilities

.. toctree::
   :maxdepth: 4
   :caption: Using GCPy

   Plotting
   Regridding
   Benchmarking

.. toctree::
   :maxdepth: 1
   :caption: Examples

   Test-Plot
   Single-Panel
   Six-Panel
   Compare-Diags
   KPP-Standalone

.. toctree::
   :maxdepth: 3
   :caption: Community Contributions

   Hemco-Formatting
   ObsPack
   
.. toctree::
   :maxdepth: 1
   :caption: Help & Reference

   Known-Bugs	     
   reference/CONTRIBUTING.md
   reference/SUPPORT.md
   editing_these_docs
   Release-Guide