gcpy

A Python-based toolkit containing useful functions for working specifically with the GEOS-Chem model of atmospheric chemistry and composition.
https://github.com/geoschem/gcpy

Category: Atmosphere
Sub Category: Atmospheric Chemistry and Aerosol

Keywords

atmospheric-chemistry atmospheric-modelling benchmarking cartopy cloud-computing geos-chem numpy plots plotting-in-python python python-toolkit scientific-computing visualization-tools xarray

Keywords from Contributors

earth-system-modeling climate aerosols carbon-cycle greenhouse-gases particulate-matter atmospheric-composition mercury methane run-directory

Last synced: about 18 hours ago
JSON representation

Repository metadata

Python toolkit for GEOS-Chem. Contains basic plotting scripts, plus the suite of GEOS-Chem benchmarking utilities.

Host: GitHub
URL: https://github.com/geoschem/gcpy
Owner: geoschem
License: other
Created: 2018-07-26T14:43:02.000Z (almost 7 years ago)
Default Branch: main
Last Pushed: 2025-04-17T15:15:15.000Z (10 days ago)
Last Synced: 2025-04-20T10:41:23.224Z (7 days ago)
Topics: atmospheric-chemistry, atmospheric-modelling, benchmarking, cartopy, cloud-computing, geos-chem, numpy, plots, plotting-in-python, python, python-toolkit, scientific-computing, visualization-tools, xarray
Language: Jupyter Notebook
Homepage: https://gcpy.readthedocs.io
Size: 10 MB
Stars: 51
Watchers: 8
Forks: 25
Open Issues: 24
Releases: 23
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Support: SUPPORT.md
- Authors: AUTHORS.txt
- Zenodo: .zenodo.json

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, numpy, and xarray to simplify the task of working with GEOS-Chem model output and performing atmospheric chemistry analyses.

What GCPy was intended to do:

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

What GCPy was not intended to do:

General NetCDF file modification: (crop a domain, extract some variables):
- Instead, use netCDF tools such as:
  - xarray
  - netCDF operators (NCO)
  - Climate Data Operators instead.
- Also see our Work with netCDF files guide at geos-chem.readthedocs.io
Statistical analysis:
- Instead, use statistical tools such as:
  - Use scipy
  - scikit-learn
  - R
  - etc
Machine Learning:
- Instead, use machine learning tools such as:
  - pytorch,
  - tensorflow
  - julia
  - etc.

Documentation:

For more information on installing and using GCPy, visit the official documentation at gcpy.readthedocs.io.

License

GCPy is distributed under the MIT license. Please see the GCPy license agreement and List of GCPy developers for more information.

Requesting support

To report a bug or suggest a new feature, please see our Support
Guidelines.

Submitting new features

If you are interested in submitting code to GCPy, please see our
Contributing Guidelines.

Owner metadata

Name: GEOS-Chem
Login: geoschem
Email: [email protected]
Kind: organization
Description: The GEOS-Chem model of atmospheric chemistry and composition
Website: http://www.geos-chem.org
Location: International
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/8321017?v=4
Repositories: 51
Last ynced at: 2024-03-19T10:10:16.778Z
Profile URL: https://github.com/geoschem

GitHub Events

Total

Create event: 16
Issues event: 3
Release event: 2
Watch event: 3
Delete event: 11
Issue comment event: 10
Push event: 47
Pull request review event: 9
Pull request event: 20
Fork event: 1

Last Year

Create event: 16
Issues event: 3
Release event: 2
Watch event: 3
Delete event: 11
Issue comment event: 10
Push event: 47
Pull request review event: 9
Pull request event: 20
Fork event: 1

Committers metadata

Last synced: 4 days ago

Total Commits: 1,483
Total Committers: 16
Avg Commits per committer: 92.688
Development Distribution Score (DDS): 0.527

Commits in past year: 102
Committers in past year: 4
Avg Commits per committer in past year: 25.5
Development Distribution Score (DDS) in past year: 0.137

Name	Email	Commits
Bob Yantosca	y**a@s**u	702
Will Downs	w**s@g**u	269
Lizzie Lundgren	e**n@s**u	233
Melissa Sulprizio	m**r@s**u	116
darothen	d**n@m**u	34
laestrada	l**0@g**m	32
Liam Bindle	l**e@g**m	31
JiaweiZhuang	j**g@g**u	18
Sebastian D. Eastham	s**m@m**u	17
Killian Murphy	k**y@y**k	14
Yuanjian Zhang	y**z@w**u	7
dependabot[bot]	4****]	5
Lucas Estrada	l**a@h**u	2
Hannah O Nesser	h**r@g**m	1
jmoch1214	j**h@g**u	1
Tomas Sherwen	t**n@T**l	1

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 231
Total pull requests: 143
Average time to close issues: 4 months
Average time to close pull requests: 9 days
Total issue authors: 38
Total pull request authors: 13
Average comments per issue: 2.94
Average comments per pull request: 1.61
Merged pull request: 118
Bot issues: 0
Bot pull requests: 17

Past year issues: 10
Past year pull requests: 38
Past year average time to close issues: 3 months
Past year average time to close pull requests: 7 days
Past year issue authors: 2
Past year pull request authors: 5
Past year average comments per issue: 2.0
Past year average comments per pull request: 0.71
Past year merged pull request: 31
Past year bot issues: 0
Past year bot pull requests: 4

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/geoschem/gcpy

Top Issue Authors

lizziel (71)
yantosca (56)
msulprizio (41)
WilliamDowns (9)
TylerElgiar (5)
jmoch1214 (4)
laestrada (4)
1Dandan (3)
sdeastham (3)
barronh (3)
SadiaToma (2)
Aosrain (2)
tsherwen (2)
liwenjia12 (2)
hmhorow (1)

Top Pull Request Authors

yantosca (71)
dependabot[bot] (17)
msulprizio (17)
lizziel (13)
LiamBindle (10)
laestrada (5)
kilicomu (3)
yuanjianz (2)
sdeastham (1)
Jourdan-He (1)
jmoch1214 (1)
tsherwen (1)
hannahnesser (1)

Top Issue Labels

bug (97)
feature (80)
benchmark plots and tables (41)
never stale (26)
question (20)
stale (19)
environment (15)
topic: Benchmark Plots and Tables (15)
category: Feature Request (14)
category: Bug (10)
cubed-sphere (9)
regridding (6)
colors / display (6)
discussion (5)
structural modification (5)
no-issue-activity (5)
topic: Regridding (5)
topic: Structural Modifications (3)
github actions (3)
topic: User Environment (2)
topic: Community Contributions (2)
category: Question (2)
dependencies (2)
topic: Dependencies (2)
TODO: Documentation (1)
topic: Colors and Display (1)
topic: Installation (1)
help needed: Request Input from Community (1)
topic: Cubed-Sphere Grid (1)
topic: Stretched Grid (1)

Top Pull Request Labels

benchmark plots and tables (37)
feature (27)
bugfix (25)
category: Feature Request (24)
topic: Benchmark Plots and Tables (18)
category: Bug Fix (15)
dependencies (13)
environment (11)
structural modification (10)
topic: Example Scripts (6)
regridding (6)
topic: User Environment (5)
topic: Dependencies (5)
bug (4)
documentation (4)
colors / display (3)
never stale (2)
github actions (2)
topic: GitHub (2)
cubed-sphere (2)
topic: GitHub Actions (2)
topic: Utilities (2)
topic: Structural Modifications (2)
topic: Input Data (1)
topic: Community Contributions (1)
utilities (1)
stale (1)
topic: Cubed-Sphere Grid (1)
topic: Regridding (1)

Package metadata

Total packages: 2
Total downloads:
- pypi: 914 last-month
Total dependent packages: 0 (may contain duplicates)
Total dependent repositories: 1 (may contain duplicates)
Total versions: 23
Total maintainers: 2

pypi.org: geoschem-gcpy

Homepage: https://github.com/geoschem/gcpy
Documentation: https://geoschem-gcpy.readthedocs.io/
Licenses: MIT
Latest release: 1.6.1 (published about 1 month ago)
Last Synced: 2025-04-25T13:05:30.897Z (2 days ago)
Versions: 15
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 914 Last month
Rankings:
- Dependent packages count: 7.31%
- Forks count: 8.139%
- Stargazers count: 9.68%
- Average: 15.749%
- Dependent repos count: 22.088%
- Downloads: 31.529%
Maintainers (2)
- msulprizio
- yantosca

conda-forge.org: geoschem-gcpy

Homepage: https://github.com/geoschem/gcpy
Licenses: MIT
Latest release: 1.3.2 (published over 2 years ago)
Last Synced: 2025-04-01T02:08:39.637Z (26 days ago)
Versions: 8
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Forks count: 33.247%
- Dependent repos count: 34.025%
- Stargazers count: 39.052%
- Average: 39.375%
- Dependent packages count: 51.175%

Dependencies

docs/requirements.txt pypi

docutils ==0.16
jinja2 ==3.0.3
recommonmark *
sphinx ==3.5.4
sphinx_rtd_theme ==0.5.2
sphinxcontrib-bibtex ==2.2.0

.github/workflows/codeql.yml actions

actions/checkout v3 composite
github/codeql-action/analyze v2 composite
github/codeql-action/autobuild v2 composite
github/codeql-action/init v2 composite

.github/workflows/pylint.yml actions

actions/checkout v3 composite
actions/setup-python v3 composite

.github/workflows/stale.yml actions

actions/stale v5 composite

.github/workflows/build-gcpy-environment.yml actions

actions/checkout v2 composite
mamba-org/setup-micromamba v1 composite

.github/workflows/build-test-environment.yml actions

actions/checkout v2 composite
mamba-org/setup-micromamba v1 composite

setup.py pypi

awscli ==2.13.39
cartopy ==0.22.0
cf_xarray ==0.8.4
dask ==2023.9.2
docutils ==0.16
esmf ==8.1.1
esmpy ==8.1.1
gridspec ==0.1.0
ipython ==8.15.0
jinja2 ==3.0.3
joblib ==1.3.2
jupyter ==1.0.0
matplotlib ==3.8.0
netcdf-fortran ==4.5.4
netcdf4 ==1.6.0
numpy ==1.26.0
pandas ==2.1.1
pip ==23.2.1
pylint ==2.17.5
pypdf ==3.16.1
pyproj ==3.6.1
python ==3.9.18
recommonmark ==0.7.1
requests ==2.31.0
scipy ==1.11.2
sparselt ==0.1.3
sphinx ==3.5.4
sphinx-autoapi ==1.9.0
sphinx-autobuild ==2021.3.14
sphinx_rtd_theme ==0.5.2
sphinxcontrib-bibtex ==2.2.0
tabulate ==0.9.0
tk ==8.6.12
xarray ==2023.8.0
xesmf ==0.5.1

docs/environment_files/environment.yml pypi

environment.yml pypi

Score: 13.911184308032556

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology