odc.geo.geobox.GeoBox.to_crs

GeoBox.to_crs(crs, *, resolution='auto', shape=None, tight=False, anchor='default', tol=0.01, round_resolution=None)[source]

Compute GeoBox covering the same region in a different projection.

Parameters:

  • crs (Union[str, int, CRS, CRS, Dict[str, Any]]) – Desired CRS of the output

  • resolution (Literal['auto', 'fit', 'same']) –

    • “same” use exactly the same resolution as src

    • ”fit” use center pixel to determine scale change between the two

    • ”auto” is to use the same resolution on the output if CRS units are the same
      between the source and destination and otherwise use “fit”

  • shape (Union[Tuple[int, int], XY[int], Shape2d, Index2d, int, None]) – Span that many pixels, if it’s a single number then span that many pixels along the longest dimension, other dimension will be computed to maintain roughly square pixels. Takes precedence over resolution= parameter.

  • tight (bool) – By default output pixel grid is adjusted to align pixel edges to X/Y axis, suppling tight=True produces unaligned geobox on the output.

  • anchor (Union[AnchorEnum, XY[float], float, Literal['center'], Literal['centre'], Literal['edge'], Literal['floating'], Literal['default']]) – Control pixel snapping, default is to snap pixel edge to X=0,Y=0. Ignored when tight=True is supplied.

  • tol (float) – Fraction of the output pixel that can be ignored, defaults to 1/100. Bounding box of the output geobox is allowed to be smaller by that amount than transformed footprint of the original.

  • round_resolution (Union[None, bool, Callable[[float, str], float]]) – round_resolution(res: float, units: str) -> float

Return type:

GeoBox

Returns:

Similar resolution, axis aligned geobox that fully encloses this one but in a different projection.