xdem.dDEM#
- class xdem.dDEM(raster, start_time, end_time, error=None)[source]#
A difference-DEM object.
- __init__(raster, start_time, end_time, error=None)[source]#
Create a dDEM object from a Raster.
- Parameters:
raster (
Raster
) – A georeferenced Raster object.start_time (
datetime64
) – The starting time of the dDEM.end_time (
datetime64
) – The end time of the dDEM.error (
Any
|None
) – An error measure for the dDEM (UNUSED).
- Returns:
A new dDEM instance.
Methods
__init__
(raster, start_time, end_time[, error])Create a dDEM object from a Raster.
astype
(dtype[, convert_nodata, inplace])Convert data type of the raster.
coords
([grid, shift_area_or_point, force_offset])Get coordinates (x,y) of all pixels in the raster.
copy
([new_array])Return a copy of the DEM.
crop
(crop_geom[, mode, inplace])Crop the raster to a given extent.
from_array
(data, transform, crs, start_time, ...)Create a new dDEM object from an array.
from_pointcloud_regular
(pointcloud[, ...])Create a raster from a point cloud with coordinates on a regular grid.
from_xarray
(ds[, dtype])Create raster from a xarray.DataArray.
georeferenced_grid_equal
(raster)Check that raster shape, geotransform and CRS are equal.
get_bounds_projected
(out_crs[, densify_points])Get raster bounds projected in a specified CRS.
get_footprint_projected
(out_crs[, ...])Get raster footprint projected in a specified CRS.
get_mask
()Get mask of invalid values from the raster.
get_metric_crs
([local_crs_type, method])Get local metric coordinate reference system for the raster (UTM, UPS, or custom Mercator or Polar).
get_nanarray
([return_mask])Get NaN array from the raster.
ij2xy
(i, j[, shift_area_or_point, force_offset])Get coordinates (x,y) of indexes (row,column).
info
([stats, verbose])Print summary information about the raster.
interp_points
(points[, method, ...])Interpolate raster values at a set of points.
interpolate
([method, reference_elevation, mask])Interpolate the dDEM using the given method.
intersection
(raster[, match_ref])Returns the bounding box of intersection between this image and another.
load
([bands])Load the raster array from disk.
outside_image
(xi, yj[, index])Check whether a given point falls outside the raster.
plot
([bands, cmap, vmin, vmax, alpha, ...])Plot the raster, with axes in projection of image.
polygonize
([target_values, data_column_name])Polygonize the raster into a vector.
proximity
([vector, target_values, ...])Compute proximity distances to the raster target pixels, or to a vector geometry on the raster grid.
raster_equal
(other[, strict_masked, ...])Check if two rasters are equal.
reduce_points
(points[, reducer_function, ...])Reduce raster values around point coordinates.
reproject
([ref, crs, res, grid_size, ...])Reproject raster to a different geotransform (resolution, bounds) and/or coordinate reference system (CRS).
save
(filename[, driver, dtype, nodata, ...])Write the raster to file.
set_area_or_point
(new_area_or_point[, ...])Set new pixel interpretation of the raster.
set_mask
(mask)Set a mask on the raster array.
set_nodata
(new_nodata[, update_array, ...])Set a new nodata value for all bands.
split_bands
([copy, bands])Split the bands into separate rasters.
subsample
(subsample[, return_indices, ...])Randomly sample the raster.
to_pointcloud
([data_column_name, data_band, ...])Convert raster to point cloud.
to_points
(**kwargs)to_rio_dataset
()Export to a Rasterio in-memory dataset.
to_xarray
([name])Convert raster to a xarray.DataArray.
translate
(xoff, yoff[, distance_unit, inplace])Translate a raster by a (x,y) offset.
xy2ij
(x, y[, op, precision, shift_area_or_point])Get indexes (row,column) of coordinates (x,y).
Attributes
area_or_point
Pixel interpretation of the raster.
bands
Band indexes loaded in memory if they are, otherwise on disk.
bands_on_disk
Band indexes on disk if a file exists.
bounds
Bounding coordinates of the raster.
count
Count of bands loaded in memory if they are, otherwise the one on disk.
count_on_disk
Count of bands on disk if it exists.
crs
Coordinate reference system of the raster.
data
Array of the raster.
driver
Driver used to read a file on disk.
dtype
Data type of the raster (string representation).
fill_method
Return the fill method used for the filled_data.
filled_data
Get the filled data array if it exists, or else the original data if it has no nans.
footprint
Footprint of the raster.
height
Height of the raster in pixels.
indexes
Band indexes (duplicate of .bands attribute, mirroring Rasterio naming "indexes").
is_loaded
Whether the raster array is loaded.
is_modified
Whether the array has been modified since it was loaded from disk.
name
Name of the file on disk, if it exists.
nodata
Nodata value of the raster.
res
Resolution (X, Y) of the raster in georeferenced units.
shape
Shape (i.e., height, width) of the raster in pixels.
tags
Metadata tags of the raster.
time
Get the time duration.
transform
Geotransform of the raster.
width
Width of the raster in pixels.