metpy

MetPy is a collection of tools in Python for reading, visualizing and performing calculations with weather data.

https://github.com/unidata/metpy

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    34 of 89 committers (38.2%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.0%) to scientific vocabulary

Keywords

atmospheric-science hacktoberfest hodograph meteorology plotting python scientific-computations skew-t weather weather-data

Keywords from Contributors

gtk qt tk wx mesh atmospheric-modelling closember photovoltaic geosciences scipy-stack
Last synced: 6 months ago · JSON representation

Repository

MetPy is a collection of tools in Python for reading, visualizing and performing calculations with weather data.

Basic Info
Statistics
  • Stars: 1,355
  • Watchers: 58
  • Forks: 437
  • Open Issues: 356
  • Releases: 43
Topics
atmospheric-science hacktoberfest hodograph meteorology plotting python scientific-computations skew-t weather weather-data
Created almost 15 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License Code of conduct Citation Codeowners Support Authors Cla

README.md

MetPy

MetPy Logo NSF Unidata Logo

License Gitter PRs Welcome

Latest Docs PyPI Package Conda Package PyPI Downloads Conda Downloads

PyPI Tests Conda Tests Code Coverage Status Codacy Badge asv Maintainability

MetPy is a collection of tools in Python for reading, visualizing and performing calculations with weather data.

MetPy follows semantic versioning in its version number. This means that any MetPy 1.x release will be backwards compatible with an earlier 1.y release. By "backward compatible", we mean that correct code that works on a 1.y version will work on a future 1.x version.

For additional MetPy examples not included in this repository, please see the MetPy Cookbook on Project Pythia.

We support Python >= 3.10.

Need Help?

Need help using MetPy? Found an issue? Have a feature request? Checkout our support page.

Important Links

Dependencies

Other required packages:

  • Numpy
  • Scipy
  • Matplotlib
  • Pandas
  • Pint
  • Xarray

There is also an optional dependency on the pyproj library for geographic projections (used with cross sections, grid spacing calculation, and the GiniFile interface).

See the installation guide for more information.

Code of Conduct

We want everyone to feel welcome to contribute to MetPy and participate in discussions. In that spirit please have a look at our Code of Conduct.

Contributing

Imposter syndrome disclaimer: We want your help. No, really.

There may be a little voice inside your head that is telling you that you're not ready to be an open source contributor; that your skills aren't nearly good enough to contribute. What could you possibly offer a project like this one?

We assure you - the little voice in your head is wrong. If you can write code at all, you can contribute code to open source. Contributing to open source projects is a fantastic way to advance one's coding skills. Writing perfect code isn't the measure of a good developer (that would disqualify all of us!); it's trying to create something, making mistakes, and learning from those mistakes. That's how we all improve, and we are happy to help others learn.

Being an open source contributor doesn't just mean writing code, either. You can help out by writing documentation, tests, or even giving feedback about the project (and yes - that includes giving feedback about the contribution process). Some of these contributions may be the most valuable to the project as a whole, because you're coming to the project with fresh eyes, so you can see the errors and assumptions that seasoned contributors have glossed over.

For more information, please read the see the contributing guide.

Philosophy

The space MetPy aims for is GEMPAK (and maybe NCL)-like functionality, in a way that plugs easily into the existing scientific Python ecosystem (numpy, scipy, matplotlib). So, if you take the average GEMPAK script for a weather map, you need to:

  • read data
  • calculate a derived field
  • show on a map/skew-T

One of the benefits hoped to achieve over GEMPAK is to make it easier to use these routines for any meteorological Python application; this means making it easy to pull out the LCL calculation and just use that, or reuse the Skew-T with your own data code. MetPy also prides itself on being well-documented and well-tested, so that on-going maintenance is easily manageable.

The intended audience is that of GEMPAK: researchers, educators, and any one wanting to script up weather analysis. It doesn't even have to be scripting; all python meteorology tools are hoped to be able to benefit from MetPy. Conversely, it's hoped to be the meteorological equivalent of the audience of scipy/scikit-learn/skimage.

Owner

  • Name: NSF Unidata
  • Login: Unidata
  • Kind: organization
  • Email: support@unidata.ucar.edu
  • Location: Boulder, Colorado, USA

Our mission is to transform the geosciences community, research, and education by providing innovative data services and tools.

GitHub Events

Total
  • Create event: 111
  • Release event: 2
  • Issues event: 69
  • Watch event: 85
  • Delete event: 98
  • Issue comment event: 204
  • Push event: 238
  • Pull request review comment event: 81
  • Pull request event: 326
  • Pull request review event: 264
  • Fork event: 19
Last Year
  • Create event: 111
  • Release event: 2
  • Issues event: 69
  • Watch event: 85
  • Delete event: 98
  • Issue comment event: 204
  • Push event: 238
  • Pull request review comment event: 81
  • Pull request event: 326
  • Pull request review event: 264
  • Fork event: 19

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 4,836
  • Total Committers: 89
  • Avg Commits per committer: 54.337
  • Development Distribution Score (DDS): 0.51
Past Year
  • Commits: 325
  • Committers: 18
  • Avg Commits per committer: 18.056
  • Development Distribution Score (DDS): 0.489
Top Committers
Name Email Commits
Ryan May r****y@u****u 2,368
dependabot[bot] 4****] 964
John Leeman k****b@g****m 347
Jon Thielen g****b@j****c 167
Drew Camron d****n@u****u 166
Zach Bruick z****k@v****u 118
Kevin Goebbert k****t@v****u 104
Steven Decker s****r@e****u 55
Nathan Wendt n****t@n****v 36
mgrover1 m****x@g****m 34
Sean Arms s****s@u****u 33
Connor Cozad 2****d@g****m 32
Daryl Herzmann a****z@i****u 29
Claude Dicaire 3****6 26
Haoyu Zhuang z****d@g****m 25
Alex Haberlie a****e@n****u 23
Kristen Pozsonyi k****n@m****u 23
Tyler Wixtrom t****m@g****m 23
Kyle J Gillett 1****t 19
Patrick Marsh p****x@g****m 19
Matt Wilson m****n@v****u 16
Andrew Huang a****1@i****u 13
Ana Castaneda a****1@g****m 13
Christian F c****2@g****m 9
Eric Bruning e****g@g****m 9
Nathan Wendt n****t@o****u 8
Sarawut Arthayakun 4****g 8
Lydia Bunting l****g@t****u 8
Aaron Hill a****l@t****u 6
David Ahijevych a****c@u****u 6
and 59 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1,199
  • Total pull requests: 2,742
  • Average time to close issues: 5 months
  • Average time to close pull requests: 21 days
  • Total issue authors: 277
  • Total pull request authors: 127
  • Average comments per issue: 2.74
  • Average comments per pull request: 1.26
  • Merged pull requests: 2,327
  • Bot issues: 80
  • Bot pull requests: 1,417
Past Year
  • Issues: 48
  • Pull requests: 380
  • Average time to close issues: 9 days
  • Average time to close pull requests: 3 days
  • Issue authors: 27
  • Pull request authors: 21
  • Average comments per issue: 1.13
  • Average comments per pull request: 0.36
  • Merged pull requests: 309
  • Bot issues: 14
  • Bot pull requests: 265
Top Authors
Issue Authors
  • dopplershift (376)
  • jrleeman (167)
  • github-actions[bot] (77)
  • sgdecker (60)
  • jthielen (30)
  • kgoebber (29)
  • akrherz (20)
  • dcamron (18)
  • ahuang11 (12)
  • eliteuser26 (9)
  • zbruick (9)
  • winash12 (8)
  • raybellwaves (7)
  • avatar101 (6)
  • am-thyst (6)
Pull Request Authors
  • dependabot[bot] (1,394)
  • dopplershift (525)
  • jrleeman (157)
  • jthielen (84)
  • kgoebber (75)
  • zbruick (52)
  • dcamron (49)
  • sgdecker (38)
  • akrherz (29)
  • tjwixtrom (20)
  • nawendt (19)
  • 23ccozad (19)
  • github-actions[bot] (15)
  • mgrover1 (13)
  • mwilson14 (13)
Top Labels
Issue Labels
Type: Bug (360) Area: Calc (294) Type: Enhancement (232) Type: Maintenance (200) Type: Feature (197) Area: Plots (169) Area: Docs (162) Area: Infrastructure (94) Area: IO (91) Area: Xarray (65) Area: Units (62) good first issue (54) Status: Not A Bug (51) Area: Examples (48) GEMPAK Conversion (43) Status: Duplicate (26) Subarea: Thermo (25) Type: API Change (24) Type: Question (20) Area: Tests (20) Area: Gridding (18) Area: Projections (17) Status: Upstream (13) Status: On Hold (9) Area: Cross-sections (9) Hacktoberfest (4) Epic (3) Status: Won't Fix (3) Area: DevTools (2) Status: Need Info (2)
Pull Request Labels
Type: Maintenance (1,736) Area: Infrastructure (1,186) Type: Enhancement (305) Type: Bug (297) Area: Calc (293) Area: Docs (236) Type: Feature (145) Area: Plots (143) Area: IO (79) Area: Xarray (59) Area: Examples (57) Area: Tests (54) Area: Units (40) Type: API Change (33) backported-pr (20) Area: Projections (17) backport (15) Area: Gridding (12) Subarea: Thermo (12) Status: Not A Bug (8) hacktoberfest-accepted (6) Area: Remote (6) nightly-ci (5) Area: DevTools (4) Area: Cross-sections (4) Status: Duplicate (2) manual backport (2) Status: Team Discussion (2) GEMPAK Conversion (1) benchmark (1)

Packages

  • Total packages: 4
  • Total downloads:
    • pypi 94,548 last-month
  • Total docker downloads: 12
  • Total dependent packages: 49
    (may contain duplicates)
  • Total dependent repositories: 180
    (may contain duplicates)
  • Total versions: 116
  • Total maintainers: 2
pypi.org: metpy

Collection of tools for reading, visualizing and performing calculations with weather data.

  • Versions: 43
  • Dependent Packages: 37
  • Dependent Repositories: 76
  • Downloads: 94,548 Last month
  • Docker Downloads: 12
Rankings
Dependent packages count: 0.5%
Dependent repos count: 1.7%
Average: 1.7%
Downloads: 1.9%
Stargazers count: 1.9%
Forks count: 2.7%
Maintainers (2)
Last synced: 6 months ago
conda-forge.org: metpy

The space MetPy aims for is GEMPAK (and maybe NCL)-like functionality, in a way that plugs easily into the existing scientific Python ecosystem (numpy, scipy, matplotlib). So, if you take the average GEMPAK script for a weather map, you need to: read data, calculate a derived field, and show on a map/skew-T. One of the benefits hoped to achieve over GEMPAK is to make it easier to use these routines for any meteorological Python application; this means making it easy to pull out the LCL calculation and just use that, or re-use the Skew-T with your own data code. MetPy also prides itself on being well-documented and well-tested, so that on-going maintenance is easily manageable.

  • Versions: 27
  • Dependent Packages: 12
  • Dependent Repositories: 104
Rankings
Dependent repos count: 3.3%
Dependent packages count: 5.1%
Average: 7.4%
Forks count: 8.7%
Stargazers count: 12.6%
Last synced: 6 months ago
proxy.golang.org: github.com/unidata/metpy
  • Versions: 42
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
spack.io: py-metpy

Collection of tools for reading, visualizing and performing calculations with weather data.

  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Forks count: 4.8%
Stargazers count: 7.5%
Average: 17.4%
Dependent packages count: 57.3%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/actions/build-docs/action.yml actions
  • actions/upload-artifact v3 composite
.github/actions/install-conda/action.yml actions
  • mamba-org/provision-with-micromamba v14 composite
.github/actions/install-pypi/action.yml actions
  • actions/setup-python v4 composite
.github/actions/run-tests/action.yml actions
  • actions/upload-artifact v3 composite
  • codecov/codecov-action v3 composite
.github/workflows/assign-milestone.yml actions
  • actions/github-script v6 composite
.github/workflows/backport-prs.yml actions
  • actions-ecosystem/action-remove-labels v1 composite
  • actions/checkout v3 composite
  • actions/github-script v6 composite
  • peter-evans/create-pull-request v4 composite
.github/workflows/cffcheck.yml actions
  • actions/checkout v3 composite
  • citation-file-format/cffconvert-github-action 2.0.0 composite
.github/workflows/code-analysis.yml actions
  • actions/checkout v3 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/init v2 composite
.github/workflows/docs-conda.yml actions
  • ./.github/actions/build-docs * composite
  • ./.github/actions/install-conda * composite
  • actions/checkout v3 composite
.github/workflows/docs.yml actions
  • ./.github/actions/build-docs * composite
  • ./.github/actions/install-pypi * composite
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • peaceiris/actions-gh-pages v3 composite
.github/workflows/linting.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/nightly-builds.yml actions
  • ./.github/actions/build-docs * composite
  • ./.github/actions/install-pypi * composite
  • ./.github/actions/run-tests * composite
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/github-script v6 composite
  • actions/upload-artifact v3 composite
.github/workflows/release.yml actions
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • pypa/gh-action-pypi-publish v1.6.4 composite
.github/workflows/tests-conda.yml actions
  • ./.github/actions/install-conda * composite
  • ./.github/actions/run-tests * composite
  • actions/checkout v3 composite
ci/requirements.txt pypi
  • importlib_resources ==5.10.2
  • matplotlib ==3.6.2
  • numpy ==1.24.1
  • pandas ==1.5.2
  • pint ==0.20.1
  • pooch ==1.6.0
  • pyproj ==3.4.1
  • scipy ==1.10.0
  • traitlets ==5.8.0
  • xarray ==2022.12.0
.github/workflows/tests-pypi.yml actions
  • ./.github/actions/install-pypi * composite
  • ./.github/actions/run-tests * composite
  • actions/checkout v3 composite
.devcontainer/Dockerfile docker
  • mcr.microsoft.com/vscode/devcontainers/miniconda latest build
ci/extra_requirements.txt pypi
  • cartopy ==0.21.1
  • shapely ==2.0.0
.github/workflows/unstable-builds.yml actions
  • ./.github/actions/build-docs * composite
  • ./.github/actions/install-pypi * composite
  • ./.github/actions/run-tests * composite
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
.github/workflows/run-unstable-pr.yml actions
pyproject.toml pypi
  • matplotlib >=3.5.0
  • numpy >=1.20.0
  • pandas >=1.2.0
  • pint >=0.15
  • pooch >=1.2.0
  • pyproj >=3.0.0
  • scipy >=1.6.0
  • traitlets >=5.0.5
  • xarray >=0.18.0
.github/workflows/automerge-dependabot.yml actions
ci-dev/doc_requirements.txt pypi
  • geopandas ==1.1.0 development
  • myst-parser ==4.0.1 development
  • pydata-sphinx-theme ==0.16.1 development
  • sphinx ==8.1.3 development
  • sphinx-design ==0.6.1 development
  • sphinx-gallery ==0.19.0 development
ci-dev/linting_requirements.txt pypi
  • codespell ==2.4.1 development
  • doc8 ==1.1.2 development
  • flake8 ==7.2.0 development
  • flake8-continuation ==1.0.5 development
  • flake8-isort ==6.1.2 development
  • flake8-requirements ==2.2.1 development
  • flake8-rst-docstrings ==0.3.1 development
  • isort ==6.0.1 development
  • pooch ==1.8.2 development
  • pycodestyle ==2.13.0 development
  • pyflakes ==3.3.2 development
  • restructuredtext_lint ==1.4.0 development
  • ruff ==0.11.11 development
ci-dev/test_requirements.txt pypi
  • coverage ==7.8.2 development
  • packaging ==25.0 development
  • pytest ==8.3.5 development
  • pytest-mpl ==0.17.0 development
  • vcrpy ==7.0.0 development
.github/workflows/benchmark-pr.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
benchmarks/Dockerfile docker
  • python 3.12 build