fastscapelib.RasterGrid

class fastscapelib.RasterGrid

A 2-dimensional raster grid.

This raster grid type has 8-node connectivity (i.e., including diagonals).

__init__(self, size: List[int], spacing: array_like, bounds_status: NodeStatus | List[NodeStatus] | RasterBoundaryStatus, nodes_status: Dict[Tuple[int, int], NodeStatus] | None = None) → None

Raster grid initializer.

Parameters:

  • shape (tuple) – Shape of the grid (number of rows and cols).

  • spacing (array_like) – Distance between two adjacent grid nodes (row, cols).

  • bounds_status (NodeStatus or list or RasterBoundaryStatus) – Status at boundary borders (left/right/top/bottom grid borders).

  • nodes_status (dict, optional) – A dictionary where keys are node (row, col) indices and values are NodeStatus values. If present (default is None), it is used to manually define the status at any node on the grid.

Methods

__init__(self, size, spacing, bounds_status)

Raster grid initializer.

from_length(self, shape, length, bounds_status)

Raster grid initializer from given total lengths.

neighbors(idx)

Returns the neighbors of a given node.

neighbors_count(idx)

Returns the number of neighbors at a given node.

neighbors_distances(idx)

Returns the distances from a given node to its neighbors.

neighbors_indices(idx)

Returns the (flat) indices of the neighbors of a given node.

nodes_areas(*args)

Returns the area of the direct vicinity of a given node or all nodes.

nodes_indices(*args)

Returns the (flattened) indices of grid nodes, possibly filtered by node status.

nodes_status(*args)

Returns the status of a given node or all nodes.

Attributes

is_structured

is_uniform

length

Returns the total length of the grid for each of its dimension.

n_neighbors_max

shape

Returns the shape of the grid node arrays.

size

Returns the total number of grid nodes.

spacing

Returns the fixed distance between two adjacent nodes for each dimension.
static from_length(self, shape: tuple, length: array_like, bounds_status: NodeStatus | List[NodeStatus] | RasterBoundaryStatus, nodes_status: Dict[Tuple[int, int], NodeStatus] | None = None) → None

Raster grid initializer from given total lengths.

Parameters:

  • shape (tuple) – Shape of the grid (number of rows and cols).

  • length (array_like) – Total physical length of the grid in y (rows) and x (cols).

  • bounds_status (NodeStatus or list or RasterBoundaryStatus) – Status at boundary borders (left/right/top/bottom grid borders).

  • nodes_status (dict, optional) – A dictionary where keys are node (row, col) indices and values are NodeStatus values. If present (default is None), it is used to manually define the status at any node on the grid.

property length

Returns the total length of the grid for each of its dimension.

neighbors(idx: int) → List[Neighbor]

Returns the neighbors of a given node.

Parameters:

idx (int) – The grid node (flat) index.

Returns:

neighbors (list) – A list of Neighbor instances.

Notes

For a RasterGrid, it is also possible to provide row and col indices as arguments, which returns a list of RasterNeighbor instances.

neighbors_count(idx: int) → int

Returns the number of neighbors at a given node.

Parameters:

idx (int) – The grid node (flat) index.

neighbors_distances(idx: int) → numpy.ndarray

Returns the distances from a given node to its neighbors.

Parameters:

idx (int) – The grid node (flat) index.

Returns:

distances (numpy.ndarray) – A 1-dimensional array of node distances (float). The neighbor order is the same than the one returned by neighbors_indices(idx).

neighbors_indices(idx: int) → numpy.ndarray

Returns the (flat) indices of the neighbors of a given node.

Parameters:

idx (int) – The grid node (flat) index.

Returns:

indices (numpy.ndarray) – A 1-dimensional array of node (flat) indices (int).

Notes

For a RasterGrid, it is also possible to provide row and col indices as arguments.

nodes_areas(*args) → float | numpy.ndarray

Returns the area of the direct vicinity of a given node or all nodes.

Overloaded method that supports the following signatures:

  1. nodes_areas() -> numpy.ndarray

  2. nodes_areas(idx: int) -> float

Parameters:

idx (int) – The grid node (flat) index.

nodes_indices(*args) → numpy.ndarray

Returns the (flattened) indices of grid nodes, possibly filtered by node status.

Overloaded method that supports the following signatures:

  1. nodes_indices() -> numpy.ndarray

  2. nodes_indices(status: NodeStatus) -> numpy.ndarray

Parameters:

status (NodeStatus) – The status of the grid nodes to filter in.

Returns:

indices (numpy.ndarray) – A new, 1-dimensional array with grid node (filtered) flat indices.

nodes_status(*args) → NodeStatus | numpy.ndarray

Returns the status of a given node or all nodes.

Overloaded method that supports the following signatures:

  1. nodes_status() -> numpy.ndarray

  2. nodes_status(idx: int) -> NodeStatus

Parameters:

idx (int) – The grid node (flat) index.

Returns:

status (NodeStatus or numpy.ndarray) – If an array is returned, it is a copy of the original array and has the NodeStatus enum class values (int) as values.

property shape

Returns the shape of the grid node arrays.

property size

Returns the total number of grid nodes.

property spacing

Returns the fixed distance between two adjacent nodes for each dimension.