{"id":13569641,"url":"https://github.com/UXARRAY/uxarray","last_synced_at":"2025-04-04T06:31:14.625Z","repository":{"id":37851310,"uuid":"421447986","full_name":"UXARRAY/uxarray","owner":"UXARRAY","description":"Xarray extension for unstructured climate and global weather data analysis and visualization.","archived":false,"fork":false,"pushed_at":"2025-03-27T18:10:08.000Z","size":144367,"stargazers_count":177,"open_issues_count":124,"forks_count":35,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-03-29T05:31:23.925Z","etag":null,"topics":["geoscience","ugrid","unstructured-grids"],"latest_commit_sha":null,"homepage":"https://uxarray.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UXARRAY.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-26T14:00:08.000Z","updated_at":"2025-03-24T23:12:12.000Z","dependencies_parsed_at":"2023-10-16T13:18:47.544Z","dependency_job_id":"2b136284-9294-4104-b65c-6cb6b07f9144","html_url":"https://github.com/UXARRAY/uxarray","commit_stats":{"total_commits":1637,"total_committers":25,"mean_commits":65.48,"dds":0.643860720830788,"last_synced_commit":"4fa1f7a48e35b9e4064244e27ff8ff78e8a77729"},"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UXARRAY%2Fuxarray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UXARRAY%2Fuxarray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UXARRAY%2Fuxarray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UXARRAY%2Fuxarray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UXARRAY","download_url":"https://codeload.github.com/UXARRAY/uxarray/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246281223,"owners_count":20752209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geoscience","ugrid","unstructured-grids"],"created_at":"2024-08-01T14:00:42.275Z","updated_at":"2025-04-04T06:31:09.616Z","avatar_url":"https://github.com/UXARRAY.png","language":"Python","funding_links":[],"categories":["Uncategorized","Climate Change"],"sub_categories":["Uncategorized","Climate Data Processing and Analysis"],"readme":"\u003cimg src=\"https://github.com/UXARRAY/uxarray/raw/main/docs/_static/images/logos/uxarray_logo_h_dark.svg\" data-canonical-src=\"https://github.com/UXARRAY/uxarray/raw/main/docs/_static/images/logos/uxarray_logo_h_dark.svg\" width=\"450\"/\u003e\u003cbr\u003e\n\n\n-----------------\n\n# Xarray extension for unstructured climate and global weather data\n|    |    |\n| --- | --- |\n| **Build Status**             | [![GitHub Workflow Status][github-ci-badge]][github-ci-link] [![CI Upstream](https://github.com/UXARRAY/uxarray/actions/workflows/upstream-dev-ci.yml/badge.svg)](https://github.com/UXARRAY/uxarray/actions/workflows/upstream-dev-ci.yml) [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/UXARRAY/uxarray/main.svg)](https://results.pre-commit.ci/latest/github/UXARRAY/uxarray/main) |\n| **Code Coverage**             |  [![Code Coverage Status][codecov-badge]][codecov-link] |\n| **Docs**       |                                   [![Documentation Status][rtd-badge]][rtd-link]                                    |\n| **Benchmarks** |                                       [![ASV Repostory][asv-badge]][asv-link]                                       |\n| **Releases**    |                        ![Github release](https://img.shields.io/github/release/UXARRAY/uxarray.svg?label=tag\u0026colorB=11ccbb) [![Conda][conda-badge]][conda-link] [![PyPI][pypi-badge]][pypi-link]                         |\n| **License**    |                                       [![License][license-badge]][repo-link]                                        |\n| **Citing**     |                                            [![DOI][doi-badge]][doi-link]                                            |\n\n-----------------\n\n## What is it?\n\nUXarray aims to address the geoscience community's need for tools that enable\nstandard data analysis techniques to operate directly on unstructured grid\ndata. UXarray provides Xarray-styled functionality to better read in and use\nunstructured grid datasets that follow standard conventions, including UGRID,\nMPAS, ICON, SCRIP, ESMF, FESOM2, and Exodus grid formats. This effort is a result of the\ncollaboration between Project Raijin (NSF NCAR and Pennsylvania State University)\nand the SEATS Project (Argonne National Laboratory, UC Davis, and Lawrence\nLivermore National Laboratory). The UXarray team welcomes community\nmembers to become part of this collaboration at any level of contribution.\n\nUXarray is implemented in pure Python and does not explicitly contain or require\nany compiled code. This makes UXarray more accessible to the general Python\ncommunity. Any contributions to this repository in pure Python are welcome and\ndocumentation for contribution guidelines can be found when clicking `New Issue`\nunder the `Issues` tab in the UXarray repository.\n\n## Why is the name \"UXarray\"?\n\nWe have created UXarray based on [Xarray](https://docs.xarray.dev/en/stable/)\n(via inheritance of Xarray Dataset and DataArray classes), a Pangeo ecosystem package\ncommonly-used for structured grids recognition, to support reading and\nrecognizing unstructured grid model outputs. We picked the name \"UXarray\"\n(pronounced \"you-ex-array\"), with the \"U\" representing unstructured grids.\n\n## Features\n\n* ``Grid`` class for storing grid information and providing grid-specific functionality\n  * Support for reading UGRID, MPAS, ESMF, ICON, GEOS-CS, SCRIP, and EXODUS grid formats\n* Extension of xarray's ``DataArray`` and ``Dataset`` classe to support unstructured grid operations\n  * ``uxarray.UxDataArray`` inherits ``xarray.DataArray`` and is attached to a ``Grid`` instance through the ``.uxgrid`` accessor\n  * ``uxarray.UxDataset`` inherits ``xarray.Dataset`` and is attached to a ``Grid`` instance through the ``.uxgrid`` accessor\n* Extension of xarray's ``open_dataset`` and ``open_mfdataset`` methods to support reading grid and data files\n* Plotting\n  * Native visualization of unstructured grids written using the ``hvPlot`` package\n  * Support for grid topology visualization (i.e. exploring the geometry of a grid) and data visualization (i.e. data mapped to each face)\n* Subsetting\n  * Ability to select arbitrary regions of a grid using different selection methods (nearest neighbor, bounding circle, bounding box)\n* Remapping\n  * Support for nearest neighbor and inverse distance weighted unstructured to unstructured remapping\n* Topological Aggregations\n  * Perform aggregations within different topology elements using connectivity information\n* Mathematical Operators\n  * Support for Integral, Difference, and Gradient calculations\n\n\n## Intended Features\n\nThe following intended features have been inspired by discussions with\nmembers of the scientific community, within the SEATS Project and Project\nRaijin, and on several community platforms such as [Xarray GitHub\nRepository](https://github.com/pydata/xarray/issues/4222). The UXarray team\nis receptive to additional functionality requests.\n\n\n* Support for arbitrary structured and unstructured grids on the sphere,\n  including latitude-longitude grids, grids with only partial coverage of\n  the sphere, and grids with concave faces.\n* Support for finite volume and finite element outputs.\n* Triangular decompositions.\n* Calculation of supermeshes (consisting of grid lines from two input grids).\n* Snapshots and composites following particular features.\n\n## Documentation\n\n[UXarray Documentation](https://uxarray.readthedocs.io/en/latest)\n\n[Contributor’s Guide](https://uxarray.readthedocs.io/en/latest/contributing.html)\n\n[Installation](https://uxarray.readthedocs.io/en/latest/getting-started/installation.html)\n\n[Project Raijin Homepage](https://raijin.ucar.edu/)\n\n[SEATS Project Homepage](https://seatstandards.org)\n\n## Contributors\n\nThank you to all of our contributors!\n\n[![Contributors](https://contrib.rocks/image?repo=UXARRAY/uxarray)](https://github.com/UXARRAY/uxarray/graphs/contributors)\n\n## Citing UXarray\n\nIf you'd like to cite our work, please follow [How to cite\nUXarray](https://uxarray.readthedocs.io/en/latest/citation.html).\n\n## Support\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://www.nsf.gov/\"\u003e\u003cimg src=\"docs/_static/images/logos/NSF_logo.png\" alt=\"NSF Logo\" width=\"400\"/\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003eProject 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.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://www.energy.gov/science/office-science\"\u003e\u003cimg src=\"docs/_static/images/logos/DOE_vertical.png\" alt=\"DOE Logo\" width=\"1200\"/\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003eSEATS 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.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://www.earthcube.org/\"\u003e\u003cimg src=\"docs/_static/images/logos/EarthCube_logo.png\" alt=\"EarthCube Logo\" width=\"300\"/\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://www.earthcube.org/\"\u003eEarthCube\u003c/a\u003e 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.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://pangeo.io/\"\u003e\u003cimg src=\"docs/_static/images/logos/PANGEO_logo.png\" alt=\"PANGEO Logo\" width=\"400\"/\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://pangeo.io/\"\u003ePangeo\u003c/a\u003e supports collaborative efforts to develop software and infrastructure to enable Big Data geoscience research.\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n[github-ci-badge]: https://github.com/UXARRAY/uxarray/actions/workflows/ci.yml/badge.svg\n[github-ci-link]: https://github.com/UXARRAY/uxarray/actions/workflows/ci.yml\n[codecov-badge]: https://codecov.io/github/UXARRAY/uxarray/graph/badge.svg?token=lPxJeGNxE0\n[codecov-link]: https://codecov.io/github/UXARRAY/uxarray\n[rtd-badge]: https://readthedocs.org/projects/uxarray/badge/?version=latest\n[rtd-link]: https://uxarray.readthedocs.io/en/latest/?badge=latest\n[pypi-badge]: https://img.shields.io/pypi/v/uxarray.svg\n[pypi-link]: https://pypi.python.org/pypi/uxarray/\n[conda-badge]: https://img.shields.io/conda/vn/conda-forge/uxarray\n[conda-link]: https://anaconda.org/conda-forge/uxarray\n[license-badge]: https://img.shields.io/github/license/UXARRAY/uxarray\n[asv-badge]: https://img.shields.io/badge/benchmarked%20by-asv-green.svg?style=flat\n[asv-link]: https://uxarray.github.io/uxarray-asv/\n[doi-badge]: https://zenodo.org/badge/421447986.svg\n[doi-link]: https://zenodo.org/badge/latestdoi/421447986\n[repo-link]: https://github.com/UXARRAY/uxarray\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUXARRAY%2Fuxarray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUXARRAY%2Fuxarray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUXARRAY%2Fuxarray/lists"}