morecantile 3.3.0__tar.gz → 4.0.0a0__tar.gz

{morecantile-3.3.0 → morecantile-4.0.0a0}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.3.0
+current_version = 4.0.0a0
 commit = True
 tag = True
 tag_name = {new_version}

{morecantile-3.3.0 → morecantile-4.0.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: morecantile
-Version: 3.3.0
+Version: 4.0.0a0
 Summary: Construct and use map tile grids (a.k.a TileMatrixSet / TMS).
 Keywords: GIS,TMS,TileMatrixSet,Map Tile
 Author-email: Vincent Sarago <vincent@developmentseed.com>
@@ -17,6 +17,7 @@ Classifier: Topic :: Scientific/Engineering :: GIS
 Requires-Dist: attrs
 Requires-Dist: pyproj~=3.1
 Requires-Dist: pydantic
+Requires-Dist: cachetools
 Requires-Dist: pre-commit ; extra == "dev"
 Requires-Dist: mkdocs ; extra == "docs"
 Requires-Dist: mkdocs-material ; extra == "docs"
@@ -25,6 +26,7 @@ Requires-Dist: rasterio>=1.2.1 ; extra == "rasterio"
 Requires-Dist: mercantile ; extra == "test"
 Requires-Dist: pytest ; extra == "test"
 Requires-Dist: pytest-cov ; extra == "test"
+Requires-Dist: rasterio>=1.2.1 ; extra == "test"
 Project-URL: Documentation, https://developmentseed.org/morecantile/
 Project-URL: Source, https://github.com/developmentseed/morecantile
 Provides-Extra: dev
@@ -34,26 +36,10 @@ Provides-Extra: test
 
 # Morecantile
 
-```
-    +-------------+-------------+  ymax
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 0     |    y: 0     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 1     |    y: 1     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+  ymin
-
-xmin                            xmax
-```
-
 <p align="center">
-  <em>Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</em>
+  <img height="500" src="https://github.com/developmentseed/morecantile/assets/10407788/a1523c6d-e255-4dc6-a201-20029715858a"/>
+  <p align="center">Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</p>
+
 </p>
 <p align="center">
   <a href="https://github.com/developmentseed/morecantile/actions?query=workflow%3ACI" target="_blank">
@@ -83,7 +69,12 @@ xmin                            xmax
 
 Morecantile is like [mercantile](https://github.com/mapbox/mercantile) (the best tool to work with Web Mercator tile indexes), but with support for other TileMatrixSet grids.
 
-**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification found in [http://docs.opengeospatial.org/is/17-083r2/17-083r2.html](http://docs.opengeospatial.org/is/17-083r2/17-083r2.html)
+**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification **2.0** found in [https://docs.ogc.org/is/17-083r4/17-083r4.html](https://docs.ogc.org/is/17-083r4/17-083r4.html)
+
+| Morecantile Version | OGC Specification Version | Link
+| ------------------- | ------------------------- |---------
+| 4.0                 | 2.0                       | https://docs.ogc.org/is/17-083r4/17-083r4.html
+| 3.0 and earlier     | 1.0                       | http://docs.opengeospatial.org/is/17-083r2/17-083r2.html
 
 **Note**: Variable matrix width tile set are not supported.
 
@@ -94,17 +85,54 @@ $ python -m pip install -U pip
 $ python -m pip install morecantile
 
 # Or install from source:
-
 $ python -m pip install -U pip
 $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 ```
 
+## Usage
+
+```python
+import morecantile
+
+tms = morecantile.tms.get("WebMercatorQuad")
+
+# Get TMS bounding box
+print(tms.xy_bbox)
+>>> BoundingBox(
+    left=-20037508.342789244,
+    bottom=-20037508.34278919,
+    right=20037508.34278919,
+    top=20037508.342789244,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in the TMS's CRS (e.g epsg:3857)
+print(tms.xy_bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=5009377.085697308,
+    bottom=-7514065.628545959,
+    right=7514065.628545959,
+    top=-5009377.085697308,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in Geographic CRS (e.g epsg:4326)
+print(tms.bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=44.999999999999964,
+    bottom=-55.776573018667634,
+    right=67.4999999999999,
+    top=-40.97989806962009,
+)
+```
+
+More info can be found at https://developmentseed.org/morecantile/usage/
+
 ### Defaults Grids
 
+`morecantile` provides a set of default TMS grids:
+
 - **CanadianNAD83_LCC**: Lambert conformal conic NAD83 for Canada - EPSG:3978
 - **EuropeanETRS89_LAEAQuad**: ETRS89-extended / LAEA Europe - EPGS:3035
 - **LINZAntarticaMapTilegrid**: LINZ Antarctic Map Tile Grid (Ross Sea Region) - EPSG:5482
-- **NZTM2000**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **NZTM2000Quad**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **UPSAntarcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Antarctic - EPSG:5042
 - **UPSArcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Arctic - EPSG:5041
@@ -114,13 +142,16 @@ $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 - **WorldCRS84Quad**: CRS84 for the World
 - **WorldMercatorWGS84Quad**: Elliptical Mercator projection - EPGS:3395
 
-ref: http://schemas.opengis.net/tms/1.0/json/examples/
+ref: https://schemas.opengis.net/tms/2.0/json/examples/tilematrixset/
 
 ## Implementations
 
 - [rio-tiler](https://github.com/cogeotiff/rio-tiler): Create tile from raster using Morecantile TMS.
-- [timvt](https://github.com/developmentseed/timvt): A lightweight PostGIS based dynamic vector tile server.
+- [titiler](https://github.com/developmentseed/titiler): A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.
+- [tipg](https://github.com/developmentseed/tipg): OGC Features and Tiles API.
 - [planetcantile](https://github.com/AndrewAnnex/planetcantile): Tile matrix sets for other planets.
+- [supermorecado](https://github.com/developmentseed/supermorecado): Extend the functionality of morecantile with additional commands.
+
 
 ## Changes
 

{morecantile-3.3.0 → morecantile-4.0.0a0}/README.md

@@ -1,25 +1,9 @@
 # Morecantile
 
-```
-    +-------------+-------------+  ymax
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 0     |    y: 0     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 1     |    y: 1     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+  ymin
-
-xmin                            xmax
-```
-
 <p align="center">
-  <em>Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</em>
+  <img height="500" src="https://github.com/developmentseed/morecantile/assets/10407788/a1523c6d-e255-4dc6-a201-20029715858a"/>
+  <p align="center">Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</p>
+
 </p>
 <p align="center">
   <a href="https://github.com/developmentseed/morecantile/actions?query=workflow%3ACI" target="_blank">
@@ -49,7 +33,12 @@ xmin                            xmax
 
 Morecantile is like [mercantile](https://github.com/mapbox/mercantile) (the best tool to work with Web Mercator tile indexes), but with support for other TileMatrixSet grids.
 
-**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification found in [http://docs.opengeospatial.org/is/17-083r2/17-083r2.html](http://docs.opengeospatial.org/is/17-083r2/17-083r2.html)
+**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification **2.0** found in [https://docs.ogc.org/is/17-083r4/17-083r4.html](https://docs.ogc.org/is/17-083r4/17-083r4.html)
+
+| Morecantile Version | OGC Specification Version | Link
+| ------------------- | ------------------------- |---------
+| 4.0                 | 2.0                       | https://docs.ogc.org/is/17-083r4/17-083r4.html
+| 3.0 and earlier     | 1.0                       | http://docs.opengeospatial.org/is/17-083r2/17-083r2.html
 
 **Note**: Variable matrix width tile set are not supported.
 
@@ -60,17 +49,54 @@ $ python -m pip install -U pip
 $ python -m pip install morecantile
 
 # Or install from source:
-
 $ python -m pip install -U pip
 $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 ```
 
+## Usage
+
+```python
+import morecantile
+
+tms = morecantile.tms.get("WebMercatorQuad")
+
+# Get TMS bounding box
+print(tms.xy_bbox)
+>>> BoundingBox(
+    left=-20037508.342789244,
+    bottom=-20037508.34278919,
+    right=20037508.34278919,
+    top=20037508.342789244,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in the TMS's CRS (e.g epsg:3857)
+print(tms.xy_bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=5009377.085697308,
+    bottom=-7514065.628545959,
+    right=7514065.628545959,
+    top=-5009377.085697308,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in Geographic CRS (e.g epsg:4326)
+print(tms.bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=44.999999999999964,
+    bottom=-55.776573018667634,
+    right=67.4999999999999,
+    top=-40.97989806962009,
+)
+```
+
+More info can be found at https://developmentseed.org/morecantile/usage/
+
 ### Defaults Grids
 
+`morecantile` provides a set of default TMS grids:
+
 - **CanadianNAD83_LCC**: Lambert conformal conic NAD83 for Canada - EPSG:3978
 - **EuropeanETRS89_LAEAQuad**: ETRS89-extended / LAEA Europe - EPGS:3035
 - **LINZAntarticaMapTilegrid**: LINZ Antarctic Map Tile Grid (Ross Sea Region) - EPSG:5482
-- **NZTM2000**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **NZTM2000Quad**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **UPSAntarcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Antarctic - EPSG:5042
 - **UPSArcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Arctic - EPSG:5041
@@ -80,13 +106,16 @@ $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 - **WorldCRS84Quad**: CRS84 for the World
 - **WorldMercatorWGS84Quad**: Elliptical Mercator projection - EPGS:3395
 
-ref: http://schemas.opengis.net/tms/1.0/json/examples/
+ref: https://schemas.opengis.net/tms/2.0/json/examples/tilematrixset/
 
 ## Implementations
 
 - [rio-tiler](https://github.com/cogeotiff/rio-tiler): Create tile from raster using Morecantile TMS.
-- [timvt](https://github.com/developmentseed/timvt): A lightweight PostGIS based dynamic vector tile server.
+- [titiler](https://github.com/developmentseed/titiler): A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.
+- [tipg](https://github.com/developmentseed/tipg): OGC Features and Tiles API.
 - [planetcantile](https://github.com/AndrewAnnex/planetcantile): Tile matrix sets for other planets.
+- [supermorecado](https://github.com/developmentseed/supermorecado): Extend the functionality of morecantile with additional commands.
+
 
 ## Changes
 

{morecantile-3.3.0 → morecantile-4.0.0a0}/morecantile/__init__.py

@@ -8,7 +8,7 @@ Refs:
 
 """
 
-__version__ = "3.3.0"
+__version__ = "4.0.0a0"
 
 from .commons import BoundingBox, Coords, Tile  # noqa
 from .defaults import TileMatrixSets, tms  # noqa

morecantile-4.0.0a0/morecantile/data/CanadianNAD83_LCC.json

@@ -0,0 +1,270 @@
+{
+   "id": "CanadianNAD83_LCC",
+   "title": "Lambert conformal conic NAD83 for Canada",
+   "uri": "http://www.opengis.net/def/tilematrixset/OGC/1.0/CanadianNAD83_LCC",
+   "crs": "http://www.opengis.net/def/crs/EPSG/0/3978",
+   "orderedAxes": ["E", "N"],
+   "tileMatrices":
+   [
+      {
+        "id": "0",
+        "scaleDenominator": 145000000,
+        "cellSize": 38364.6600626534,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 5,
+        "matrixHeight": 5
+      },
+      {
+        "id": "1",
+        "scaleDenominator": 85000000,
+        "cellSize": 22489.6283125899,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 8,
+        "matrixHeight": 8
+      },
+      {
+        "id": "2",
+        "scaleDenominator": 50000000,
+        "cellSize": 13229.1931250529,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 13,
+        "matrixHeight": 14
+      },
+      {
+        "id": "3",
+        "scaleDenominator": 30000000,
+        "cellSize": 7937.51587503175,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 21,
+        "matrixHeight": 22
+      },
+      {
+        "id": "4",
+        "scaleDenominator": 17500000,
+        "cellSize": 4630.21759376852,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 36,
+        "matrixHeight": 38
+      },
+      {
+        "id": "5",
+        "scaleDenominator": 10000000,
+        "cellSize": 2645.83862501058,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 62,
+        "matrixHeight": 66
+      },
+      {
+        "id": "6",
+        "scaleDenominator": 6000000,
+        "cellSize": 1587.50317500635,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 103,
+        "matrixHeight": 110
+      },
+      {
+        "id": "7",
+        "scaleDenominator": 3500000,
+        "cellSize": 926.043518753704,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 177,
+        "matrixHeight": 188
+      },
+      {
+        "id": "8",
+        "scaleDenominator": 2000000,
+        "cellSize": 529.167725002116,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 309,
+        "matrixHeight": 329
+      },
+      {
+        "id": "9",
+        "scaleDenominator": 1200000,
+        "cellSize": 317.50063500127,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 515,
+        "matrixHeight": 548
+      },
+      {
+        "id": "10",
+        "scaleDenominator": 700000,
+        "cellSize": 185.20870375074,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 882,
+        "matrixHeight": 938
+      },
+      {
+        "id": "11",
+        "scaleDenominator": 420000,
+        "cellSize": 111.125222250444,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 1470,
+        "matrixHeight": 1563
+      },
+      {
+        "id": "12",
+        "scaleDenominator": 250000,
+        "cellSize": 66.1459656252646,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 2469,
+        "matrixHeight": 2626
+      },
+      {
+        "id": "13",
+        "scaleDenominator": 145000,
+        "cellSize": 38.3646600626534,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 4257,
+        "matrixHeight": 4528
+      },
+      {
+        "id": "14",
+        "scaleDenominator": 85000,
+        "cellSize": 22.4896283125899,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 7262,
+        "matrixHeight": 7723
+      },
+      {
+        "id": "15",
+        "scaleDenominator": 50000,
+        "cellSize": 13.2291931250529,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 12344,
+        "matrixHeight": 13130
+      },
+      {
+        "id": "16",
+        "scaleDenominator": 30000,
+        "cellSize": 7.93751587503175,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 20574,
+        "matrixHeight": 21882
+      },
+      {
+        "id": "17",
+        "scaleDenominator": 17500,
+        "cellSize": 4.63021759376852,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 35269,
+        "matrixHeight": 37512
+      },
+      {
+        "id": "18",
+        "scaleDenominator": 10000,
+        "cellSize": 2.64583862501058,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 61720,
+        "matrixHeight": 65646
+      },
+      {
+        "id": "19",
+        "scaleDenominator": 6000,
+        "cellSize": 1.58750317500635,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 102866,
+        "matrixHeight": 109409
+      },
+      {
+        "id": "20",
+        "scaleDenominator": 3500,
+        "cellSize": 0.926043518753704,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 176341,
+        "matrixHeight": 187558
+      },
+      {
+        "id": "21",
+        "scaleDenominator": 2000,
+        "cellSize": 0.529167725002116,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 308596,
+        "matrixHeight": 328227
+      },
+      {
+        "id": "22",
+        "scaleDenominator": 1200,
+        "cellSize": 0.31750063500127,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 514327,
+        "matrixHeight": 547044
+      },
+      {
+        "id": "23",
+        "scaleDenominator": 700,
+        "cellSize": 0.18520870375074,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 881703,
+        "matrixHeight": 937790
+      },
+      {
+        "id": "24",
+        "scaleDenominator": 420,
+        "cellSize": 0.111125222250444,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 1469505,
+        "matrixHeight": 1562983
+      },
+      {
+        "id": "25",
+        "scaleDenominator": 250,
+        "cellSize": 0.0661459656252645,
+        "pointOfOrigin": [-34655800,39310000],
+        "tileWidth": 256,
+        "tileHeight": 256,
+        "matrixWidth": 2468768,
+        "matrixHeight": 2625811
+      }
+   ]
+}