async-geotiff 0.1.0b3__py3-none-any.whl → 0.1.0b5__py3-none-any.whl

async_geotiff-0.1.0b5.dist-info/METADATA

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: async-geotiff
+Version: 0.1.0b5
+Summary: Async GeoTIFF reader for Python
+Keywords: geotiff,tiff,async,cog,raster,gis
+Author: Kyle Barron
+Author-email: Kyle Barron <kyle@developmentseed.org>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Typing :: Typed
+Requires-Dist: affine>=2.4.0
+Requires-Dist: async-tiff>=0.5.0b3
+Requires-Dist: numpy>=2.0
+Requires-Dist: pyproj>=3.3.0
+Requires-Dist: morecantile>=7.0,<8.0 ; extra == 'morecantile'
+Requires-Python: >=3.11
+Project-URL: Changelog, https://github.com/developmentseed/async-geotiff/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://developmentseed.github.io/async-geotiff/
+Project-URL: Homepage, https://github.com/developmentseed/async-geotiff
+Project-URL: Issues, https://github.com/developmentseed/async-geotiff/issues
+Project-URL: Repository, https://github.com/developmentseed/async-geotiff
+Provides-Extra: morecantile
+Description-Content-Type: text/markdown
+
+# async-geotiff
+
+Fast, async GeoTIFF and [Cloud-Optimized GeoTIFF][cogeo] (COG) reader for Python, wrapping the Rust-based [Async-TIFF][async-tiff] library.
+
+[async-tiff]: https://github.com/developmentseed/async-tiff
+[cogeo]: https://cogeo.org/
+
+## Features
+
+- Read-only support for GeoTIFF and COG formats.
+- High-level, familiar, easy to use API.
+- Performance-focused:
+    - Rust core ensures native performance.
+    - CPU-bound tasks like image decoding happen in a thread pool, without blocking the async executor.
+    - Buffer protocol integration for zero-copy data sharing between Rust and Python.
+- Lightweight with no GDAL dependency.
+- Integration with [obstore] for efficient data access on object stores.
+- Full type hinting for all operations.
+- Broad decompression support: Deflate, LZW, JPEG, JPEG2000, WebP, ZSTD.
+
+**Anti-Features** (features explicitly not in scope):
+
+- No pixel resampling.
+- No warping/reprojection.
+
+Resampling and warping bring significant additional complexity and are out of scope for this library.
+
+[obstore]: https://developmentseed.org/obstore/latest/
+[obspec]: https://developmentseed.org/obspec/latest/
+
+## Example
+
+First create a "store", such as an [`S3Store`][S3Store], [`GCSStore`][GCSStore], [`AzureStore`][AzureStore], or [`LocalStore`][LocalStore] for reading data from AWS S3, Google Cloud, Azure Storage, or local files. Refer to [obstore] documentation for more information.
+
+[S3Store]: https://developmentseed.org/obstore/latest/api/store/aws/#obstore.store.S3Store
+[GCSStore]: https://developmentseed.org/obstore/latest/api/store/gcs/#obstore.store.GCSStore
+[AzureStore]: https://developmentseed.org/obstore/latest/api/store/azure/#obstore.store.AzureStore
+[LocalStore]: https://developmentseed.org/obstore/latest/api/store/local/#obstore.store.LocalStore
+
+```py
+from obstore.store import S3Store
+
+store = S3Store("sentinel-cogs", region="us-west-2", skip_signature=True)
+path = "sentinel-s2-l2a-cogs/12/S/UF/2022/6/S2B_12SUF_20220609_0_L2A/TCI.tif"
+```
+
+Then open a `GeoTIFF`:
+
+```py
+from async_geotiff import GeoTIFF
+
+geotiff = await GeoTIFF.open(path, store=store)
+```
+
+On the `GeoTIFF` instance you have metadata about the image, such as its affine transform and Coordinate Reference System:
+
+```py
+geotiff.transform
+# Affine(10.0, 0.0, 300000.0,
+#        0.0, -10.0, 4100040.0)
+
+geotiff.crs
+# <Projected CRS: EPSG:32612>
+# Name: WGS 84 / UTM zone 12N
+```
+
+For a COG, you can access the overviews, or reduced resolution versions, of the image:
+
+```py
+# Overviews are ordered from finest to coarsest resolution
+# In this case, access the second-coarsest resolution version of the image
+overview = geotiff.overviews[-2]
+```
+
+Then we can read data from the image. This loads a 512-pixel square from the
+upper-left corner of the selected overview.
+
+```py
+from async_geotiff import Window
+
+window = Window(col_off=0, row_off=0, width=512, height=512)
+array = await overview.read(window=window)
+```
+
+This `Array` instance has `data`, `mask`, and some other metadata about the fetched array data.
+
+Plot, using [`rasterio.plot.show`](https://rasterio.readthedocs.io/en/stable/api/rasterio.plot.html#rasterio.plot.show) (requires `matplotlib`):
+
+```py
+import rasterio.plot
+
+rasterio.plot.show(array.data)
+```
+
+![](assets/sentinel_2_plot.jpg)

async_geotiff-0.1.0b5.dist-info/RECORD

@@ -0,0 +1,20 @@
+async_geotiff/__init__.py,sha256=X8z0LzXJNz1mBcP0kd9e_gsWzHavHf0W9FXc3oKGPNs,435
+async_geotiff/_array.py,sha256=fihbOeFIwJ2maHEiXlv8N00n-J6KcQibaToL74-rHAc,3874
+async_geotiff/_crs.py,sha256=upyEGDiuHyWniTD--blzujYHlXBvfHLCSPzgekvO26Q,22105
+async_geotiff/_fetch.py,sha256=cJvSxNFdiLMWFgtrx9FtP72iClXpR1sFPHsGwiSr66I,4434
+async_geotiff/_geotiff.py,sha256=oH_RBFkyodmeOsZpyftGY7IBPJsUyq9DACDxSsa3U5I,12927
+async_geotiff/_overview.py,sha256=tuht-cUN00usxwfnteJDbE6Y391jLZQmYJbWr61MiRg,3334
+async_geotiff/_read.py,sha256=4mX1ZSHERXJiRsuh7U1m3XN5Nu5Eb159NFcI26jYqJI,5676
+async_geotiff/_tile.py,sha256=Cob3xJusGzchH3_mB2Dg2E6nz_B8skcbQdNXCKURsuo,632
+async_geotiff/_transform.py,sha256=5up_xUgBjyXVE-VlugBENoBrZd4vNlvjx7PGzmN1ugc,2501
+async_geotiff/_version.py,sha256=WOBh553JMD6VV-k_R8km_U4yt5mzyrWhi4OeTSXNoJI,171
+async_geotiff/_windows.py,sha256=0bcJ29kL8kaJoj14RnJMz2Eh_a9B9P4ARrZfC4ACWec,2438
+async_geotiff/colormap.py,sha256=v3_lxOC_RYZojIqQy9NZVziS8YmBtjI9UCduf5n-w3Q,3300
+async_geotiff/enums.py,sha256=j-_K1UtI0tBzZ945auvhWZdktO1bgZp7Nf-K9c208IQ,1493
+async_geotiff/exceptions.py,sha256=rZfS6TFIQIzcj-GBNs_t1HsYNTg7aKvSjbrus1apau4,130
+async_geotiff/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+async_geotiff/tms.py,sha256=vHbavoMk1NlZx7MAWf7iuqo4xWsOmKvGfa25ZBTrLCE,3916
+async_geotiff-0.1.0b5.dist-info/licenses/LICENSE,sha256=VRb2Bx0c2u6mtWwU_cBiJx_5qrDwzkG3YMZfV0FQnhU,1073
+async_geotiff-0.1.0b5.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+async_geotiff-0.1.0b5.dist-info/METADATA,sha256=oISmmY2cVvIAjxDFEtvoNarkBZx_vZL7Hapjz-rMPFk,4699
+async_geotiff-0.1.0b5.dist-info/RECORD,,

async_geotiff-0.1.0b3.dist-info/METADATA

@@ -1,53 +0,0 @@
-Metadata-Version: 2.4
-Name: async-geotiff
-Version: 0.1.0b3
-Summary: Async GeoTIFF reader for Python
-Keywords: geotiff,tiff,async,cog,raster,gis
-Author: Kyle Barron
-Author-email: Kyle Barron <kyle@developmentseed.org>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Scientific/Engineering :: GIS
-Classifier: Typing :: Typed
-Requires-Dist: affine>=2.4.0
-Requires-Dist: async-tiff>=0.4.0
-Requires-Dist: numpy>=2.0
-Requires-Dist: pyproj>=3.3.0
-Requires-Dist: morecantile>=7.0,<8.0 ; extra == 'morecantile'
-Requires-Python: >=3.11
-Project-URL: Changelog, https://github.com/developmentseed/async-geotiff/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://developmentseed.github.io/async-geotiff/
-Project-URL: Homepage, https://github.com/developmentseed/async-geotiff
-Project-URL: Issues, https://github.com/developmentseed/async-geotiff/issues
-Project-URL: Repository, https://github.com/developmentseed/async-geotiff
-Provides-Extra: morecantile
-Description-Content-Type: text/markdown
-
-# async-geotiff
-
-Async GeoTIFF and [Cloud-Optimized GeoTIFF][cogeo] (COG) reader for Python, wrapping [`async-tiff`].
-
-[`async-tiff`]: https://github.com/developmentseed/async-tiff
-[cogeo]: https://cogeo.org/
-
-## Project Goals:
-
-- Support only for GeoTIFF and Cloud-Optimized GeoTIFF (COG) formats
-- Support for reading only, no writing support
-- Full type hinting.
-- API similar to rasterio where possible.
-    - We won't support the full rasterio API, but we'll try to when it's possible to implement rasterio APIs with straightforward maintenance requirements.
-    - For methods where we do intentionally try to match with rasterio, the tests should match against rasterio.
-- Initially, we'll try to support a core set of GeoTIFF formats. Obscure GeoTIFF files may not be supported.
-
-## References
-
-- aiocogeo: https://github.com/geospatial-jeff/aiocogeo

async_geotiff-0.1.0b3.dist-info/RECORD

@@ -1,12 +0,0 @@
-async_geotiff/__init__.py,sha256=Z_g9Z04lgDNeIOI4Z3lXn74G_7MOntwcPgjWBYLIoUU,259
-async_geotiff/_crs.py,sha256=upyEGDiuHyWniTD--blzujYHlXBvfHLCSPzgekvO26Q,22105
-async_geotiff/_geotiff.py,sha256=hEC0hR5qTB0DGEe4Cvoaz_56D-zfZeT9UR4lmjJD77w,13123
-async_geotiff/_overview.py,sha256=dsdbKpix3aebjtibfJSgLUbqSAY92tlMMcg3fVLFlfY,2423
-async_geotiff/_version.py,sha256=WOBh553JMD6VV-k_R8km_U4yt5mzyrWhi4OeTSXNoJI,171
-async_geotiff/enums.py,sha256=j-_K1UtI0tBzZ945auvhWZdktO1bgZp7Nf-K9c208IQ,1493
-async_geotiff/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-async_geotiff/tms.py,sha256=55nXenfss_KX7I5bmcMwtTHZWzNYAwSqhfjqSQju7OI,3922
-async_geotiff-0.1.0b3.dist-info/licenses/LICENSE,sha256=VRb2Bx0c2u6mtWwU_cBiJx_5qrDwzkG3YMZfV0FQnhU,1073
-async_geotiff-0.1.0b3.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-async_geotiff-0.1.0b3.dist-info/METADATA,sha256=8AIntKucPXRaoEp7iSW63TXjGdKzs4y6OS3zWiZy7zI,2259
-async_geotiff-0.1.0b3.dist-info/RECORD,,