geoutils.Raster.__init__

geoutils.Raster.__init__#

Raster.__init__(filename_or_dataset, bands=None, is_mask=False, load_data=False, parse_sensor_metadata=False, silent=True, downsample=1, force_nodata=None)[source]#

Instantiate a raster from a filename or rasterio dataset.

Parameters:
  • filename_or_dataset (str | Path | RasterType | DatasetReader | MemoryFile | dict[str, Any]) – Path to file or Rasterio dataset.

  • bands (int | list[int] | None) – Band(s) to load into the object. Default loads all bands.

  • load_data (bool) – Whether to load the array during instantiation. Default is False.

  • parse_sensor_metadata (bool) – Whether to parse sensor metadata from filename and similarly-named metadata files.

  • silent (bool) – Whether to parse metadata silently or with console output.

  • downsample (int | float | integer[Any] | floating[Any]) – Downsampling factor (e.g., 2 selects one out of two pixels for every row/column). Rows or columns that do not fill a complete interval are omitted. Default 1 keeps the native resolution. See Rasterio’s overview documentation for how stored overviews can make reduced reads faster.

  • force_nodata (int | float | None) – Force nodata value to be used (overwrites the metadata). Default reads from metadata.