diff --git a/docs/intro.rst b/docs/intro.rst index 59c5c89c..8a12679e 100644 --- a/docs/intro.rst +++ b/docs/intro.rst @@ -1,23 +1,23 @@ Overview ######## -The ``odc-geo`` library provides powerful tools for geospatial data manipulation, including working +The ``odc-geo`` library provides powerful tools for geospatial data manipulation in Python, including working with coordinate reference systems, grid definitions, and spatial transformations. The library integrates closely with the Python geospatial ecosystem (including shapely_ and pyproj_), -providing a projection-aware :py:class:`~odc.geo.geom.Geometry` class that simplify complex geospatial -operations. Geo-registered raster analysis is supported through an ``.odc.`` extension that is automatically +providing a projection-aware :py:class:`~odc.geo.geom.Geometry` class that simplifies complex geospatial +operations. Geo-registered raster analysis is supported through an ``.odc.`` `Xarray extension`_ that is automatically added to :py:class:`xarray.Dataset` and :py:class:`xarray.DataArray` data loaded using the `Open Data Cube`_ or rioxarray_ - exposing important geospatial metadata and a variety of useful geospatial analysis tools. Key features ************ -* **Vector and raster reprojection:** Efficiently reproject data between CRSs using high-performance reprojection utilities powered by dask_ +* **Vector and raster reprojection:** Efficiently reproject data between coordinate reference systems using high-performance reprojection utilities powered by dask_ * **Geospatial metadata handling:** Inspect and manipulate geo-registered raster metadata using a standardised :py:class:`~odc.geo.geobox.GeoBox` pixel grid model * **Spatial grid definition:** Generate precise :py:class:`~odc.geo.gridspec.GridSpec` tile grids for seamless large-scale analysis * **Cloud-optimised data:** Export geo-registered raster data into optimised cloud-optimised GeoTIFF files -* **Spatial analysis:** Tools for rasterising, masking, clipping vector and raster data +* **Spatial analysis:** Rasterise, mask and clip vector and raster data * **Interactive visualisation:** Plot and explore spatial vector and raster data on an interactive map .. This library combines geometry shape classes from shapely_ with CRS from pyproj_ to provide @@ -72,3 +72,4 @@ Using Conda .. _shapely: https://shapely.readthedocs.io/en/stable/manual.html .. _pyproj: https://pyproj4.github.io/pyproj/stable/ .. _`Open Data Cube`: https://github.com/opendatacube/datacube-core +.. _`Xarray extension`: https://docs.xarray.dev/en/stable/internals/extending-xarray.html