odc.geo
#######
|Documentation Status| |Test Status| |Test Coverage| |Conda Version| |Discord|
This library combines geometry shape classes from shapely_ with CRS from pyproj_ to provide
projection aware ``Geometry``. It exposes all the functionality provided by ``shapely`` modules, but
will refuse operations between geometries defined in different projections. Geometries can be
brought into a common projection with ``Geometry.to_crs`` method.
Based on that foundation a number of data types and utilities useful for working with geospatial
metadata are implemented. Of particular importance is ``GeoBox``. It is an abstraction for a
geo-registered bounded pixel plane where a linear mapping from pixel coordinates to the real world
is defined.
To make working with geo-registered raster data easier an integration with xarray_ is provided.
Importing ``odc.geo.xr`` enables the ``.odc.`` accessor on every ``xarray.Dataset`` and
``xarray.DataArray``. This exposes geospatial information of a raster loaded with `Open Datacube`_
or rioxarray_. Methods for attaching geospatial information to xarray objects in a robust way are
also provided. Geospatial information attached in this way survives most operations you might do on
the data: basic mathematical operations, type conversions, cropping, serialization to most formats
like zarr, netcdf, GeoTIFF.
For more details see Documentation_.
|Intro Image|
Origins
=======
This repository contains geometry related code extracted from `Open Datacube`_.
For details and motivation see `ODC-EP-06`_ enhancement proposal.
.. |Documentation Status| image:: https://readthedocs.org/projects/odc-geo/badge/?version=latest
:target: https://odc-geo.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. |Test Status| image:: https://github.com/opendatacube/odc-geo/actions/workflows/main.yml/badge.svg
:target: https://github.com/opendatacube/odc-geo/actions/workflows/main.yml
:alt: Test Status
.. |Test Coverage| image:: https://codecov.io/gh/opendatacube/odc-geo/branch/develop/graph/badge.svg?token=Qc7isqXNGF
:target: https://codecov.io/gh/opendatacube/odc-geo
:alt: Test Coverage
.. |Conda Version| image:: https://anaconda.org/conda-forge/odc-geo/badges/version.svg
:target: https://anaconda.org/conda-forge/odc-geo
:alt: Conda Version
.. |Discord| image:: https://img.shields.io/discord/1212501566326571070?label=Discord&logo=discord&logoColor=white&color=7289DA
:target: https://discord.gg/4hhBQVas5U
:alt: Join Discord for support
.. |Intro Image| image:: docs/_static/intro.svg
:alt: Map with GeoBoxes
:width: 256
.. _rioxarray: https://corteva.github.io/rioxarray/stable/
.. _xarray: https://docs.xarray.dev/en/stable/
.. _shapely: https://shapely.readthedocs.io/en/stable/manual.html
.. _pyproj: https://pyproj4.github.io/pyproj/stable/
.. _`Open Datacube`: https://github.com/opendatacube/datacube-core
.. _`ODC-EP-06`: https://github.com/opendatacube/datacube-core/wiki/ODC-EP-06---Extract-Geometry-Utilities-into-a-Separate-Package
.. _`Documentation`: https://odc-geo.readthedocs.io/
Raw data
{
"_id": null,
"home_page": "https://github.com/opendatacube/odc-geo/",
"name": "odc-geo",
"maintainer": "Open Data Cube",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Open Data Cube",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/36/7a/a95edf2b3ca6618ff47169aa76d20c8b288425a2fa1e9c0313f7cd289b80/odc_geo-0.4.9.post0.tar.gz",
"platform": "any",
"description": "odc.geo\n#######\n\n|Documentation Status| |Test Status| |Test Coverage| |Conda Version| |Discord|\n\nThis library combines geometry shape classes from shapely_ with CRS from pyproj_ to provide\nprojection aware ``Geometry``. It exposes all the functionality provided by ``shapely`` modules, but\nwill refuse operations between geometries defined in different projections. Geometries can be\nbrought into a common projection with ``Geometry.to_crs`` method.\n\nBased on that foundation a number of data types and utilities useful for working with geospatial\nmetadata are implemented. Of particular importance is ``GeoBox``. It is an abstraction for a\ngeo-registered bounded pixel plane where a linear mapping from pixel coordinates to the real world\nis defined.\n\nTo make working with geo-registered raster data easier an integration with xarray_ is provided.\nImporting ``odc.geo.xr`` enables the ``.odc.`` accessor on every ``xarray.Dataset`` and\n``xarray.DataArray``. This exposes geospatial information of a raster loaded with `Open Datacube`_\nor rioxarray_. Methods for attaching geospatial information to xarray objects in a robust way are\nalso provided. Geospatial information attached in this way survives most operations you might do on\nthe data: basic mathematical operations, type conversions, cropping, serialization to most formats\nlike zarr, netcdf, GeoTIFF.\n\nFor more details see Documentation_.\n\n|Intro Image|\n\nOrigins\n=======\n\nThis repository contains geometry related code extracted from `Open Datacube`_.\n\nFor details and motivation see `ODC-EP-06`_ enhancement proposal.\n\n\n.. |Documentation Status| image:: https://readthedocs.org/projects/odc-geo/badge/?version=latest\n :target: https://odc-geo.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. |Test Status| image:: https://github.com/opendatacube/odc-geo/actions/workflows/main.yml/badge.svg\n :target: https://github.com/opendatacube/odc-geo/actions/workflows/main.yml\n :alt: Test Status\n\n.. |Test Coverage| image:: https://codecov.io/gh/opendatacube/odc-geo/branch/develop/graph/badge.svg?token=Qc7isqXNGF\n :target: https://codecov.io/gh/opendatacube/odc-geo\n :alt: Test Coverage\n\n.. |Conda Version| image:: https://anaconda.org/conda-forge/odc-geo/badges/version.svg\n :target: https://anaconda.org/conda-forge/odc-geo\n :alt: Conda Version\n\n.. |Discord| image:: https://img.shields.io/discord/1212501566326571070?label=Discord&logo=discord&logoColor=white&color=7289DA\n :target: https://discord.gg/4hhBQVas5U\n :alt: Join Discord for support\n\n.. |Intro Image| image:: docs/_static/intro.svg\n :alt: Map with GeoBoxes\n :width: 256\n\n.. _rioxarray: https://corteva.github.io/rioxarray/stable/\n.. _xarray: https://docs.xarray.dev/en/stable/\n.. _shapely: https://shapely.readthedocs.io/en/stable/manual.html\n.. _pyproj: https://pyproj4.github.io/pyproj/stable/\n.. _`Open Datacube`: https://github.com/opendatacube/datacube-core\n.. _`ODC-EP-06`: https://github.com/opendatacube/datacube-core/wiki/ODC-EP-06---Extract-Geometry-Utilities-into-a-Separate-Package\n.. _`Documentation`: https://odc-geo.readthedocs.io/\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Geometry Classes and Operations (opendatacube)",
"version": "0.4.9.post0",
"project_urls": {
"Bug Reporting": "https://github.com/opendatacube/odc-geo/issues",
"Documentation": "https://odc-geo.readthedocs.io/en/latest/",
"Homepage": "https://github.com/opendatacube/odc-geo/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4b25771bca8387587f2eda3a2cef47afb783e0bece01d4c58fff723d2b996ba5",
"md5": "976eb1ba8ea61158e1344964cc1c0a44",
"sha256": "80559e18361c554046c3214cbe357ec00d64f9f407754b197bb8dc269708d5e7"
},
"downloads": -1,
"filename": "odc_geo-0.4.9.post0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "976eb1ba8ea61158e1344964cc1c0a44",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 153765,
"upload_time": "2025-01-17T08:32:50",
"upload_time_iso_8601": "2025-01-17T08:32:50.973668Z",
"url": "https://files.pythonhosted.org/packages/4b/25/771bca8387587f2eda3a2cef47afb783e0bece01d4c58fff723d2b996ba5/odc_geo-0.4.9.post0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "367aa95edf2b3ca6618ff47169aa76d20c8b288425a2fa1e9c0313f7cd289b80",
"md5": "d10fd7f1cca4607922414235a401ab69",
"sha256": "1b7bf45ab5ba98b3c61478784f8744fc24153ccca31ae58ef8edc04c2b17f68a"
},
"downloads": -1,
"filename": "odc_geo-0.4.9.post0.tar.gz",
"has_sig": false,
"md5_digest": "d10fd7f1cca4607922414235a401ab69",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 191756,
"upload_time": "2025-01-17T08:32:52",
"upload_time_iso_8601": "2025-01-17T08:32:52.362280Z",
"url": "https://files.pythonhosted.org/packages/36/7a/a95edf2b3ca6618ff47169aa76d20c8b288425a2fa1e9c0313f7cd289b80/odc_geo-0.4.9.post0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-17 08:32:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "opendatacube",
"github_project": "odc-geo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "odc-geo"
}
JSON
