geovista

Cartographic rendering and mesh analytics powered by PyVista ๐ŸŒ

https://github.com/bjlittle/geovista

Science Score: 67.0%

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

  • โœ“
    CITATION.cff file
    Found CITATION.cff file
  • โœ“
    codemeta.json file
    Found codemeta.json file
  • โœ“
    .zenodo.json file
    Found .zenodo.json file
  • โœ“
    DOI references
    Found 3 DOI reference(s) in README
  • โœ“
    Academic publication links
    Links to: zenodo.org
  • โ—‹
    Committers with academic emails
  • โ—‹
    Institutional organization owner
  • โ—‹
    JOSS paper metadata
  • โ—‹
    Scientific vocabulary similarity
    Low similarity (3.5%) to scientific vocabulary

Keywords

cartography curvilinear earth-science grid mesh python pyvista rectilinear ugrid unstructured vtk

Keywords from Contributors

iris grib meteorology oceanography spaceweather visualisation energy-system finite-element-analysis open-science meshviewer
Last synced: 6 months ago · JSON representation ·

Repository

Cartographic rendering and mesh analytics powered by PyVista ๐ŸŒ

Basic Info
Statistics
  • Stars: 202
  • Watchers: 8
  • Forks: 30
  • Open Issues: 33
  • Releases: 13
Topics
cartography curvilinear earth-science grid mesh python pyvista rectilinear ugrid unstructured vtk
Created almost 5 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation Codeowners Security

README.md

GeoVista

Cartographic rendering and mesh analytics powered by PyVista

| | | |--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | โš™๏ธ CI | ci-citation ci-linkcheck ci-locks ci-manifest ci-tests ci-wheels pre-commit | | ๐Ÿ’ฌ Community | Contributor Covenant GH Discussions Bluesky YouTube Channel Subscribers All Contributors Mentioned in Awesome Open Geoscience GitHub Repo stars | | ๐Ÿ“š Docs | Documentation Status | | ๐Ÿ“ˆ Health | codecov | | โœจ Meta | Pixi Badge Ruff SPEC 0 โ€” Minimum Supported Dependencies license - bsd-3-clause conda platform | | ๐Ÿ“ฆ Package | DOI conda-forge pypi pypi - python version | | ๐Ÿงฐ Repo | commits-since contributors release | | ๐Ÿ›ก๏ธ Status | scitools | | | |

Rediscover Your Data

WW3 SMC time-series ๐ŸŽฅ

GeoVista is built on the shoulders of giants, namely PyVista and VTK, thus allowing it to easily leverage the power of the GPU.

As a result, it offers a paradigm shift in rendering performance and interactive user experience, as demonstrated by this realtime, time-series animation of WAVEWATCH IIIยฎ third-generation wave model (WAVE-height, WATer depth and Current Hindcasting) data developed at NOAA/NCEP.

The animation shows a time-series of Sea Surface Wave Significant Height data located on the cell faces of a quasi-unstructured Spherical Multi-Cell (SMC) grid.

Bring your data alive with GeoVista! ๐Ÿš€

Tempted? Keen to know more? Well, let's begin ...

Motivation

The goal of GeoVista is simple; to complement PyVista with a convenient cartographic capability.

In this regard, from a design perspective we aim to keep GeoVista as pure to PyVista as possible i.e., minimise specialisation as far as practically possible in order to maximise native compatibility within the PyVista and VTK ecosystems.

We intend GeoVista to be a cartographic gateway into the powerful world of PyVista, and all that it offers.

GeoVista is intentionally agnostic to packages such as geopandas, iris, xarray et al, which specialise in preparing your spatial data for visualisation. Rather, we delegate that responsibility and choice of tool to you the user, as we want GeoVista to remain as flexible and open-ended as possible to the entire Scientific Python community.

Simply put, "GeoVista is to PyVista", as "Cartopy is to Matplotlib". Well, that's the aspiration.

Installation

GeoVista is available on both conda-forge and PyPI. See our Installation guide for further details.

Conda

GeoVista is available on conda-forge, and can be easily installed with conda:

shell conda install --channel conda-forge geovista

Also see our conda-forge feedstock.

Pip

GeoVista is also available on PyPI:

shell pip install geovista

Checkout out our PyPI Download Stats, if you like that kinda thing.

Pixi ๐Ÿงš

Alternatively, install GeoVista with pixi:

shell pixi add geovista `

For more information visit our prefix.dev dashboard.

Quick Start

GeoVista comes with various pre-canned resources to help get you started on your visualisation journey.

Resources

GeoVista makes use of various resources, such as rasters, VTK meshes, Natural Earth features, and sample model data.

If you want to download and cache all registered GeoVista resources to make them available offline, simply: shell geovista download --all Alternatively, just leave GeoVista to download resources on-the-fly, as and when she needs them.

To view the list of registered resources, simply: shell geovista download --list

Want to know more? shell geovista download --help

Plotting Examples

Let's explore a sample of various oceanographic and atmospheric model data using GeoVista.

WAVEWATCH III

First, let's render a WAVEWATCH III (WW3) unstructured triangular mesh, with 10m Natural Earth coastlines, a 1:50m Natural Earth Cross-Blended Hypsometric Tints base layer, and the gorgeous perceptually uniform cmocean balance diverging colormap.

WAVEWATCH III Model, Unstructured Triangular Mesh of Sea Surface Wave Significant Height

Finite Volume Community Ocean Model

Now, let's visualise the bathymetry of the Plymouth Sound and Tamar River from an FVCOM unstructured mesh, as kindly provided by the Plymouth Marine Laboratory using the lush cmocean deep colormap.

Finite Volume Community Ocean Model, Unstructured Triangular Mesh of Sea Floor Below Geoid

CF UGRID

Local Area Model

Initial projection support is available within GeoVista for Cylindrical and Pseudo-Cylindrical projections. As GeoVista matures and stabilises, we'll aim to complement this capability with other classes of projections, such as Azimuthal and Conic.

In the meantime, let's showcase our basic projection support with some high-resolution unstructured Local Area Model (LAM) data reprojected to Mollweide using a PROJ string, with 10m Natural Earth coastlines and a 1:50m Natural Earth Cross-Blended Hypsometric Tints base layer.

CF UGRID Local Area Model, Unstructured Quadrilateral Mesh of Air Potential Temperature

Using the same unstructured LAM data, reproject to Equidistant Cylindrical but this time using a Cartopy Plate Carrรฉe CRS, also with 10m Natural Earth coastlines and a 1:50m Natural Earth Cross-Blended Hypsometric Tints base layer.

CF UGRID Local Area Model, Unstructured Quadrilateral Mesh of Air Potential Temperature in Plate Carrรฉe Projection

LFRic Cube-Sphere

Now render a Met Office LFRic C48 cube-sphere unstructured mesh of Sea Surface Temperature data on a Robinson Projection using an ESRI SRID, with 10m Natural Earth coastlines and a cmocean thermal colormap.

LFRic Model, Unstructured Cube Sphere of Surface Temperature in Robinson Projection

NEMO ORCA2

So far we've demonstrated GeoVista's ability to cope with unstructured data. Now let's plot a curvilinear mesh using Nucleus for European Modelling of the Ocean (NEMO) ORCA2 Sea Water Potential Temperature data, with 10m Natural Earth coastlines and a 1:50m Natural Earth I base layer.

NEMO ORCA2 Model, Curvilinear Quadrilateral Mesh of Sea Water Potential Temperature

OISST AVHRR

Now let's render a NOAA/NCEI Optimum Interpolation SST (OISST) Advanced Very High Resolution Radiometer (AVHRR) rectilinear mesh, with 10m Natural Earth coastlines and a NASA Blue Marble base layer.

Optimum Interpolation Sea Surface Temperature Advanced Very High Resolution Radiometer Model, Rectilinear Quadrilateral Mesh

DYNAMICO

Finally, to demonstrate support for non-traditional cell geometries i.e., not triangles or quadrilaterals, we plot the unstructured mesh from the DYNAMICO project. This model uses hexagonal and pentagonal cells, and is a new dynamical core for LMD-Z, the atmospheric General Circulation Model (GCM) part of the IPSL-CM Earth System Model. The render also contains 10m Natural Earth coastlines.

DYNAMICO Model, Unstructured Hexagonal Mesh of Surface Air Temperature

Further Examples

"Please, sir, I want some more", Charles Dickens, Oliver Twist, 1838.

Certainly, our pleasure! From the command line, simply:

bash geovista examples --run all --verbose

Want to know more? shell geovista examples --help

Candy Store ๐Ÿฌ

We've opened the doors to the Candy Store ๐Ÿฌ.

A community space where you can openly share and promote how you're using GeoVista for your work, research or pleasure!

Showcase your most awesome GeoVista eye candy with undiluted pride and tell us more about your work.

We'd ๐Ÿ’š to hear from you!

Documentation

The documentation is built by Sphinx and hosted on Read the Docs.

Ecosystem

Whilst you're here, why not hop on over to the pyvista-xarray project and check it out!

It's aiming to provide xarray DataArray accessors for PyVista to visualize datasets in 3D for the xarray community, and will be building on top of GeoVista ๐ŸŽ‰

Support

Need help? ๐Ÿ˜ข

Why not check out our existing GitHub issues. See something similar? Well, give it a ๐Ÿ‘ to raise its priority and feel free to chip in on the conversation. Otherwise, don't hesitate to create a new GitHub issue instead.

However, if you'd rather have a natter, then head on over to our GitHub Discussions. That's definitely the place to wax lyrical all things GeoVista!

License

GeoVista is distributed under the terms of the BSD-3-Clause license.

Star History

Diggin' GeoVista? Then why not show it some ๐Ÿ’š with a GitHub โญ!

It's a simple click that means the world to us, and helps others discover our community too!

Star History Chart

#ShowYourStripes

#showyourstripes Global 1850-2022

Graphics and Lead Scientist: Ed Hawkins, National Centre for Atmospheric Science, University of Reading.

Data: Berkeley Earth, NOAA, UK Met Office, MeteoSwiss, DWD, SMHI, UoR, Meteo France & ZAMG.

#ShowYourStripes is distributed under a Creative Commons Attribution 4.0 International License creative-commons-by

Owner

  • Name: Bill Little
  • Login: bjlittle
  • Kind: user
  • Location: Exeter, Devon, England
  • Company: Met Office

Soft, fluffy and machine washable.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Little"
  given-names: "Bill"
  orcid: "https://orcid.org/0000-0002-1345-9465"
title: "geovista"
abstract: "Cartographic rendering and mesh analytics powered by PyVista"
repository-code: "https://github.com/bjlittle/geovista"
license: "BSD-3-Clause"
license-url: "https://spdx.org/licenses/BSD-3-Clause.html"
doi: "10.5281/zenodo.7608302"
type: "software"

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 1,754
  • Total Committers: 20
  • Avg Commits per committer: 87.7
  • Development Distribution Score (DDS): 0.332
Past Year
  • Commits: 559
  • Committers: 13
  • Avg Commits per committer: 43.0
  • Development Distribution Score (DDS): 0.533
Top Committers
Name Email Commits
Bill Little b****e@g****m 1,171
geovista-ci[bot] 1****] 185
pre-commit-ci[bot] 6****] 127
dependabot[bot] 4****] 113
allcontributors[bot] 4****] 87
github-actions[bot] 4****] 27
Martin Yeo 4****s 13
Tetsuo Koyama t****0@g****m 13
Henry Wright 8****t 3
Bane Sullivan b****n@g****m 3
Elias 1****O 2
stephenworsley 4****y 2
Andrew Coughtrie 2****e 1
Patrick Peglar p****r@m****k 1
RichardScottOZ 7****Z 1
beroda 1****a 1
bjlittle-pr-auth[bot] 1****] 1
geovista-actions[bot] 1****] 1
tkknight 2****t 1
user27182 8****2 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 170
  • Total pull requests: 1,941
  • Average time to close issues: about 2 months
  • Average time to close pull requests: about 24 hours
  • Total issue authors: 24
  • Total pull request authors: 18
  • Average comments per issue: 2.45
  • Average comments per pull request: 1.02
  • Merged pull requests: 1,691
  • Bot issues: 81
  • Bot pull requests: 902
Past Year
  • Issues: 98
  • Pull requests: 786
  • Average time to close issues: 5 days
  • Average time to close pull requests: about 19 hours
  • Issue authors: 9
  • Pull request authors: 13
  • Average comments per issue: 0.32
  • Average comments per pull request: 0.87
  • Merged pull requests: 643
  • Bot issues: 78
  • Bot pull requests: 443
Top Authors
Issue Authors
  • github-actions[bot] (76)
  • bjlittle (38)
  • tkoyama010 (12)
  • trexfeathers (9)
  • banesullivan (5)
  • dennissergeev (5)
  • PBrockmann (4)
  • geovista-ci[bot] (2)
  • pp-mo (2)
  • k-a-mendoza (2)
  • akaszynski (2)
  • jbusecke (1)
  • dependabot[bot] (1)
  • stephenworsley (1)
  • allcontributors[bot] (1)
Pull Request Authors
  • bjlittle (946)
  • geovista-ci[bot] (323)
  • dependabot[bot] (237)
  • pre-commit-ci[bot] (177)
  • allcontributors[bot] (165)
  • tkoyama010 (29)
  • trexfeathers (24)
  • HGWright (7)
  • banesullivan (6)
  • pp-mo (6)
  • stephenworsley (4)
  • ESadek-MO (4)
  • user27182 (4)
  • tkknight (2)
  • beroda (2)
Top Labels
Issue Labels
new: issue (99) bot (78) type: documentation (72) type: bug (15) new: documentation (10) new: feature (9) type: infrastructure (9) type: tech debt (8) type: enhancement (5) skip changelog (4) status: blocked (3) new: pull request (3) scipy 2023 (3) scipy 2024 (3) type: dependencies (2) good first issue (2) pyvista (2) status: decision required (2) type: performance (2) stale (2) feature: line projection support (2) type: examples (1) type: cli (1) pixi (1) status: stalled (1) breaking-change (1) feature: crs (1) platform: macOS (1) type: gha (1) type: cache (1)
Pull Request Labels
skip changelog (702) type: infrastructure (575) new: pull request (558) bot (558) type: dependencies (429) type: gha (298) type: documentation (293) type: examples (166) type: testing (102) type: bug (51) type: cache (38) pixi (35) type: cli (21) scipy 2024 (18) type: enhancement (17) breaking-change (16) type: tech debt (13) status: blocked (9) type: merge-back (8) scipy 2023 (5) new: feature (4) type: performance (3) feature: line projection support (2) type: nep-29 (2) feature: pyvista-xarray (1) pyvista (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 1,028 last-month
  • Total dependent packages: 2
    (may contain duplicates)
  • Total dependent repositories: 3
    (may contain duplicates)
  • Total versions: 29
  • Total maintainers: 5
proxy.golang.org: github.com/bjlittle/geovista
  • Versions: 13
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
pypi.org: geovista

Cartographic rendering and mesh analytics powered by PyVista

  • Documentation: https://geovista.readthedocs.io
  • License: BSD 3-Clause License Copyright (c) 2021, GeoVista Contributors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • Latest release: 0.5.3
    published over 1 year ago
  • Versions: 14
  • Dependent Packages: 2
  • Dependent Repositories: 3
  • Downloads: 1,028 Last month
Rankings
Dependent packages count: 4.8%
Stargazers count: 7.6%
Average: 8.9%
Dependent repos count: 8.9%
Forks count: 9.6%
Downloads: 13.5%
Last synced: 6 months ago
conda-forge.org: geovista

GeoVista provides a cartographic gateway into the world of PyVista. It leverages the power of the GPU through VTK to provide a paradigm shift in rendering performance and interactive user experience.

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 34.0%
Stargazers count: 41.7%
Average: 42.6%
Forks count: 43.4%
Dependent packages count: 51.2%
Last synced: 6 months ago

Dependencies

.github/workflows/ci-citation.yml actions
  • actions/checkout v4 composite
  • citation-file-format/cffconvert-github-action 2.0.0 composite
.github/workflows/ci-label.yml actions
  • actions-ecosystem/action-add-labels v1 composite
  • actions/labeler v4 composite
.github/workflows/ci-locks.yml actions
  • ./.github/workflows/composite/conda-env-cache * composite
  • ./.github/workflows/composite/conda-pkg-cache * composite
  • ./.github/workflows/composite/tox-cache * composite
  • actions/checkout v4 composite
  • actions/download-artifact v3 composite
  • actions/upload-artifact v3 composite
  • conda-incubator/setup-miniconda v2 composite
  • peter-evans/create-pull-request 153407881ec5c347639a548ade7d8ad1d6740e38 composite
  • tibdex/github-app-token v2 composite
.github/workflows/ci-manifest.yml actions
  • actions/checkout v4 composite
.github/workflows/ci-stale.yml actions
  • actions/stale v8 composite
.github/workflows/ci-tests.yml actions
  • ./.github/workflows/composite/cartopy-cache * composite
  • ./.github/workflows/composite/conda-env-cache * composite
  • ./.github/workflows/composite/conda-pkg-cache * composite
  • ./.github/workflows/composite/tox-cache * composite
  • actions/checkout v4 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/ci-wheels.yml actions
  • ./.github/workflows/composite/conda-env-cache * composite
  • ./.github/workflows/composite/conda-pkg-cache * composite
  • ./.github/workflows/composite/tox-cache * composite
  • actions/checkout v4 composite
  • actions/download-artifact v3 composite
  • actions/upload-artifact v3 composite
  • conda-incubator/setup-miniconda v2 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/codeql.yml actions
  • actions/checkout v4 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/autobuild v2 composite
  • github/codeql-action/init v2 composite
.github/workflows/composite/cartopy-cache/action.yml actions
  • actions/cache v3 composite
.github/workflows/composite/conda-env-cache/action.yml actions
  • actions/cache v3 composite
.github/workflows/composite/conda-pkg-cache/action.yml actions
  • actions/cache v3 composite
.github/workflows/composite/tox-cache/action.yml actions
  • actions/cache v3 composite
pyproject.toml pypi
requirements/pypi-core.txt pypi
  • cartopy >=0.20
  • click *
  • click-default-group *
  • cmocean *
  • netCDF4 *
  • numpy >=1.21
  • platformdirs *
  • pooch *
  • pykdtree *
  • pyproj >=3.3
  • pyvista >=0.40
requirements/pypi-optional-cmap.txt pypi
  • colorcet *
requirements/pypi-optional-docs.txt pypi
  • jupyter-sphinx *
  • pydata-sphinx-theme *
  • sphinx *
  • sphinx-copybutton *
requirements/pypi-optional-test.txt pypi
  • codecov * test
  • pre-commit * test
  • pytest >=6.0 test
  • pytest-cov * test
  • pytest-mock * test
setup.py pypi
.github/workflows/ci-approve.yml actions
  • hmarr/auto-approve-action v3 composite
  • tibdex/github-app-token v2 composite
requirements/pypi-optional-exam.txt pypi
  • fastparquet *
  • pandas *