read#

read(path: Union[str, CloudPath, Path], resolution: Optional[Union[tuple, list, float]] = None, size: Optional[Union[list, tuple]] = None, resampling: Resampling = Resampling.nearest, masked: bool = True, indexes: Optional[Union[int, list]] = None, **kwargs) → DataArray[source]#

Overload of sertit.rasters.read() managing DASK in EOReader’s way.

>>> raster_path = "path/to/raster.tif"
>>> xds1 = read(raster_path)
>>> # or
>>> with rasterio.open(raster_path) as dst:
>>>    xds2 = read(dst)
>>> xds1 == xds2
True
Parameters:

  • path (Union[str, CloudPath, Path]) – Path to the raster

  • resolution (Union[tuple, list, float]) – Resolution of the wanted band, in dataset resolution unit (X, Y)

  • size (Union[tuple, list]) – Size of the array (width, height). Not used if resolution is provided.

  • resampling (Resampling) – Resampling method

  • masked (bool) – Get a masked array

  • indexes (Union[int, list]) – Indexes to load. Load the whole array if None.

  • **kwargs – Optional keyword arguments to pass into rioxarray.open_rasterio().

Returns:

Masked xarray corresponding to the raster data and its metadata

Return type:

xr.DataArray