Skip to content

Feature/add from rasterio cli #187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
vincentsarago wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Feature/add from rasterio cli #187

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
434c030
update deprecated
vincentsarago Oct 27, 2025
c97880e
add from-rasterio-cli
vincentsarago Oct 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
116 changes: 114 additions & 2 deletions morecantile/scripts/cli.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,18 @@

import json
import logging
import math
import sys
import uuid
from typing import Any, List

import click
from pyproj import CRS
from pyproj.exceptions import CRSError

import morecantile
from morecantile.models import CRS_to_uri
from morecantile.utils import meters_per_unit

logger = logging.getLogger(__name__)

Expand Down Expand Up @@ -411,7 +417,7 @@ def tiles(ctx, zoom, input, identifier, seq, tms): # noqa: C901
def tms(identifier):
"""Print TMS JSON."""
tms = morecantile.tms.get(identifier)
click.echo(tms.json(exclude_none=True))
click.echo(tms.model_dump_json(exclude_none=True))


################################################################################
Expand Down Expand Up @@ -465,7 +471,7 @@ def custom(
extent_crs=CRS.from_epsg(extent_epsg) if extent_epsg else None,
title=title or "Custom TileMatrixSet",
)
click.echo(tms.json(exclude_none=True))
click.echo(tms.model_dump_json(exclude_none=True))


################################################################################
Expand Down Expand Up @@ -608,3 +614,109 @@ def tms_to_geojson( # noqa: C901
"features": features,
}
click.echo(json.dumps(feature_collection, **dump_kwds))


################################################################################
# The `from_rasterio`` command.
@cli.command(short_help="Create Custom TileMatrixSet from Rasterio Dataset")
@click.argument("input", type=str)
@click.option(
"--identifier",
type=str,
help="Identifier of the TMS.",
)
@click.option(
"--title",
type=str,
help="Tile Matrix Set title.",
)
def from_rasterio(input, identifier, title):
"""Create TMS From Raster dataset."""
try:
import rasterio
except ImportError: # pragma: nocover
rasterio = None # type: ignore

assert rasterio, "'rasterio' needs to be installed in the python environemment to use `from_rasterio` command"

tile_matrices: List[morecantile.models.TileMatrix] = []

with rasterio.open(input) as src:
bounds = src.bounds
crs = src.crs
tr = src.transform
blockxsize, blockysize = src.block_shapes[0]

try:
ovr = src.overviews(1)
except Exception:
ovr = []

with rasterio.Env(OSR_WKT_FORMAT="WKT2_2018"):
proj_crs = CRS.from_wkt(crs.wkt)

mpu = meters_per_unit(proj_crs)
screen_pixel_size = 0.28e-3

tile_matrices.append(
morecantile.models.TileMatrix(
**{
"id": "0",
"scaleDenominator": tr.a * mpu / screen_pixel_size,
"cellSize": tr.a,
"pointOfOrigin": [tr.c, tr.f],
"tileWidth": blockxsize,
"tileHeight": blockysize,
"matrixWidth": math.ceil(src.width / blockxsize),
"matrixHeight": math.ceil(src.height / blockysize),
}
)
)

for ix, _ in enumerate(ovr):
with rasterio.open(input, OVERVIEW_LEVEL=ix) as ovr_src:
tr = ovr_src.transform
blockxsize, blockysize = ovr_src.block_shapes[0]
tile_matrices.append(
morecantile.models.TileMatrix(
**{
"id": f"{ix + 1}",
"scaleDenominator": tr.a * mpu / screen_pixel_size,
"cellSize": tr.a,
Copy link
Member

@kylebarron kylebarron Dec 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the cell size always be computed from the horizontal pixel size? How do you handle when there's slight differences between the decimated pixel size in x and y?

In particular, in my implementation I try to assert that the x scale and y scale are the same before I decimate the geotransform.

But with this image https://ds-wheels.s3.us-east-1.amazonaws.com/m_4007307_sw_18_060_20220803.tif, used in the test case I added, that's not always true due to some precision issues:

scaleX, scaleY 2 2
full height, height 12410 6205
full width, width 9680 4840

scaleX, scaleY 4 4.000644745325596
full height, height 12410 3102
full width, width 9680 2420

scaleX, scaleY 8 8.001289490651192
full height, height 12410 1551
full width, width 9680 1210

scaleX, scaleY 16 16.01290322580645
full height, height 12410 775
full width, width 9680 605

scaleX, scaleY 32.05298013245033 32.0671834625323
full height, height 12410 387
full width, width 9680 302

Copy link
Member Author

@vincentsarago vincentsarago Dec 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah that's one issue, I don't think TMS can take this into account.

we should at least raise a warning and then select either the smallest or the highest 🤷

"pointOfOrigin": [tr.c, tr.f],
"tileWidth": blockxsize,
"tileHeight": blockysize,
"matrixWidth": math.ceil(ovr_src.width / blockxsize),
"matrixHeight": math.ceil(ovr_src.height / blockysize),
}
)
)

bbox = morecantile.commons.BoundingBox(*bounds)

if proj_crs.to_authority(min_confidence=20):
crs_data: Any = CRS_to_uri(proj_crs)

# Some old Proj version might not support URI
# so we fall back to wkt
try:
CRS.from_user_input(crs_data)
except CRSError:
crs_data = {"wkt": proj_crs.to_json_dict()}

else:
crs_data = {"wkt": proj_crs.to_json_dict()}

tms = morecantile.TileMatrixSet(
title=title or input,
id=identifier or str(uuid.uuid4()),
crs=crs_data,
boundingBox=morecantile.models.TMSBoundingBox(
lowerLeft=[bbox.left, bbox.bottom],
upperRight=[bbox.right, bbox.top],
crs=crs_data,
),
tileMatrices=tile_matrices,
)

click.echo(tms.model_dump_json(exclude_none=True))