rasterize#
- rasterize(ds: str | tuple | ~rasterio.io.DatasetReader, vector: ~geopandas.geodataframe.GeoDataFrame | str | ~cloudpathlib.cloudpath.CloudPath | ~pathlib.Path, value_field: str = None, default_nodata: int = 0, default_value: int = 1, **kwargs) -> (<class 'numpy.ma.core.MaskedArray'>, <class 'dict'>)[source]#
Rasterize a vector into raster format.
Note that passing merge_alg = MergeAlg.add will add the vector values to the given a raster
See: https://pygis.io/docs/e_raster_rasterize.html
- Parameters:
ds (PATH_ARR_DS) – Path to the raster, its dataset, its
xarray
or a tuple containing its array and metadatavector (Union[gpd.GeoDataFrame, AnyPathStrType]) – Vector to be rasterized
value_field (str) – Field of the vector with the values to be burnt on the raster (should be scalars). If let to None, the raster will be binary (default_nodata, default_value).
default_nodata (int) – Default nodata of the raster (outside the vector in the raster extent)
default_value (int) – Used as value for all geometries, if value_field not provided
- Returns:
Rasterized vector and its metadata
- Return type:
np.ma.masked_array, dict