Skip to main content

Unstructured grid model reading and recognizing with xarray.

Project description

CI GitHub Workflow Status Code Coverage Status
Docs Documentation Status
Package Conda PyPI
License License
Citing DOI

UXarray aims to address the geoscience community need for tools that enable standard data analysis techniques to operate directly on unstructured grid data. UXarray will provide Xarray styled functions to better read in and use unstructured grid datasets that follow standard conventions, including UGRID, SCRIP, Exodus and shapefile formats. This effort is a result of the collaboration between Project Raijin (NCAR and Pennsylvania State University) and the SEATS Project (Argonne National Laboratory, UC Davis, and Lawrence Livermore National Laboratory). The UXarray team welcomes other community members to become part of this collaboration at any level of contribution.

UXarray is implemented in pure Python and does not explicitly contain or require any compiled code. This makes UXarray more accessible to the general Python community. Any contributions to this repository in pure Python are welcome and documentation for contribution guidelines can be found when clicking New Issue under the Issues tab in the UXarray repository.

Why is the name "UXarray"?

We have created UXarray based on Xarray (via composition of a Xarray dataset object), a Pangeo ecosystem package commonly-used for structured grids recognition, to support reading and recognizing unstructured grid model outputs. We picked the name "UXarray" and preferred to capitalize the first two letters to emphasize it is Xarray for Unstructured grids.

UXarray Functionality

The following intended functionality has been inspired by discussions with members of the scientific community, within the SEATS Project and Project Raijin, and on several community platforms such as Xarray GitHub Repository. The UXarray team is receptive to additional functionality requests.

Intended Functionality for Grids

  • Support for reading and writing UGRID, SCRIP and Exodus formatted grids.
  • Support for reading and writing shapefiles.
  • Support for arbitrary structured and unstructured grids on the sphere, including latitude-longitude grids, grids with only partial coverage of the sphere, and grids with concave faces.
  • Support for finite volume and finite element outputs.
  • Support for edges that are either great circle arcs or lines of constant latitude.
  • Calculation of face areas, centroids, and bounding latitude-longitude boxes.
  • Triangular decompositions.
  • Calculation of supermeshes (consisting of grid lines from two input grids).

Intended Functionality for DataArrays on Grids

  • Regridding of data between unstructured grids.
  • Global and regional integration of fields, including zonal averages.
  • Application of calculus operations, including divergence, curl, Laplacian and gradient.
  • Snapshots and composites following particular features.

Documentation

UXarray Documentation

Contributor’s Guide

Installation

Project Raijin Homepage

SEATS Project Homepage

Citing UXarray

If you'd like to cite our work, please follow How to cite UXarray.

Support

NSF Logo Project Raijin, entitled "Collaborative Research: EarthCube Capabilities: Raijin: Community Geoscience Analysis Tools for Unstructured Mesh Data", was awarded by NSF 21-515 EarthCube (Award Number (FAIN): 2126458) on 08/19/2021. The award period of performance has a start date of 09/01/2021 and end date of 08/31/2024.
DOE Logo SEATS is funded by the Regional and Global Modeling and Analysis (RGMA) program area in the U.S. Department of Energy (DOE) Earth and Environmental System Modeling Program which is part of the Earth and Environmental Systems Sciences Division of the Office of Biological and Environmental Research in DOE’s Office of Science.
EarthCube Logo EarthCube aims to transform the conduct of geosciences research by developing and maintaining a well-connected and facile environment that improves access, sharing, visualization, and analysis of data and related resources.
PANGEO Logo Pangeo supports collaborative efforts to develop software and infrastructure to enable Big Data geoscience research.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uxarray-2022.12.0.tar.gz (9.3 MB view details)

Uploaded Source

Built Distribution

uxarray-2022.12.0-py3-none-any.whl (26.2 kB view details)

Uploaded Python 3

File details

Details for the file uxarray-2022.12.0.tar.gz.

File metadata

  • Download URL: uxarray-2022.12.0.tar.gz
  • Upload date:
  • Size: 9.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for uxarray-2022.12.0.tar.gz
Algorithm Hash digest
SHA256 bfa0d78215513d57701f1577dc927a5e7018de2ecbadba1d7c9660628ba5695d
MD5 afdfbff8f7cfe9e63d292e7aaf14c3d8
BLAKE2b-256 81d83999b52863e088d5eff51dadd6af62498b799a0255d5f69463c1bdc4eb04

See more details on using hashes here.

Provenance

File details

Details for the file uxarray-2022.12.0-py3-none-any.whl.

File metadata

  • Download URL: uxarray-2022.12.0-py3-none-any.whl
  • Upload date:
  • Size: 26.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for uxarray-2022.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f683a4b5529f2eabfd9d6302ca294f40725b1ba128e3cd1bb142de2e42ad2018
MD5 a5b3e5aa5ed1de5164ebfcce00ef2ff1
BLAKE2b-256 8cc11930718895a80c7c6495435f2eebe6b69d86a2f77fa793d4809ef4b6535f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page