Skip to content

Latest commit

 

History

History
97 lines (67 loc) · 3.93 KB

landscape.rst

File metadata and controls

97 lines (67 loc) · 3.93 KB

Landscape analysis

The Landscape class is the core code unit of PyLandStats and is used to compute the metrics over a given landscape raster. It can be instantiated as follows:

pylandstats.Landscape.__init__

List of implemented metrics

The metrics of PyLandStats are computed according to their definitions in FRAGSTATS.

The notation for the metrics below is as follows:

  • the letters with suffixes ai, j, pi, j, hi, j respectively represent the area, perimeter, and distance to the nearest neighboring patch of the same class of the patch j of class i.
  • the letters with suffixes ei, k, gi, k respectively represent the total edge between and number of pixel adjacencies between classes i and k
  • the capital letters A, N, E respectively represent the total area, total number of patches and total edge of the landscape

Like FRAGSTATS, PyLandStats features six distribution-statistics metrics for each patch-level metric, which consist in a statistical aggregation of the values computed for each patch of a class or the whole landscape:

  • the mean, which can be computed by adding a _mn suffix to the method name, e.g., area_mn
  • the area-weighted mean, which can be computed by adding a _am suffix to the method name, e.g., area_am
  • the median, which can be computed by adding a _md suffix to the method name, e.g., area_md
  • the range, which can be computed by adding a _ra suffix to the method name, e.g., area_ra
  • the standard deviation, which can be computed by adding a _sd suffix to the method name, e.g., area_sd
  • the coefficient of variation, which can be computed by adding a _cv suffix to the method name, e.g., area_cv

note that the distribution-statistics metrics do not appear in the documentation below.

See the FRAGSTATS documentation for more information.

Patch-level metrics

Area, density, edge

pylandstats.Landscape.area

pylandstats.Landscape.perimeter

Shape

pylandstats.Landscape.perimeter_area_ratio

pylandstats.Landscape.shape_index

pylandstats.Landscape.fractal_dimension

Aggregation

pylandstats.Landscape.euclidean_nearest_neighbor

Class-level and landscape-level metrics

Area, density, edge

pylandstats.Landscape.total_area

pylandstats.Landscape.proportion_of_landscape

pylandstats.Landscape.number_of_patches

pylandstats.Landscape.patch_density

pylandstats.Landscape.largest_patch_index

pylandstats.Landscape.total_edge

pylandstats.Landscape.edge_density

Aggregation

pylandstats.Landscape.landscape_shape_index

pylandstats.Landscape.effective_mesh_size

Landscape-level metrics

Contagion, interspersion

pylandstats.Landscape.contagion

pylandstats.Landscape.shannon_diversity_index

Computing metrics data frames

pylandstats.Landscape.compute_patch_metrics_df

pylandstats.Landscape.compute_class_metrics_df

pylandstats.Landscape.compute_landscape_metrics_df

Plotting landscape raster

pylandstats.Landscape.plot_landscape