GRASS logo

NAME

r.pi.odc - Omnidirectional connectivity analysis

KEYWORDS

raster, landscape structure analysis, connectivity analysis

SYNOPSIS

r.pi.odc
r.pi.odc --help
r.pi.odc [-abdm] input=name output=name [mask=string] keyval=integer ratio=string stats=string[,string,...] [neighbor_level=integer] [title="phrase"] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a
Set for 8 cell-neighbors. 4 cell-neighbors are default
-b
Allow moving on diagonals
-d
Graphical output
-m
Adjacency matrix output
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

input=name [required]
Name of input raster map
output=name [required]
Name for output raster map
mask=string
Name of a raster file with a mask (0,1 values)
keyval=integer [required]
Category value of the patches
ratio=string [required]
Compensation method to perform on the values
Options: none, odd_area, area_odd, odd_perim, perim_odd
stats=string[,string,...] [required]
Statistical method to perform on the values
Options: average, variance, standard deviation, median
neighbor_level=integer
Level of neighbors to analyse
title="phrase"
Title for resultant raster map

Table of contents

DESCRIPTION

r.pi.odc is part of the patch based fragmentation analysis package r.pi.* (Patch Index). It computes omnidirectional connectivity analysis between patches.

NOTES

Several output raster are generated with the defined output file name and a suffix of the information provided. All files named *.FP.* are providing information concerning the focus patch. All files named *.TP.* are providing informaton about the target patches.
...

The user must specify the names of the raster map layers to be used for input and output, the keyval the ratio (area/odd or odd/area) and stats used (i.e., average).

Within r.pi.odc the following setting have to be set:

keyval setting:

The keyval operator determines which category value is taken for the Patch Index analysis.

Ratio setting:

The ratio operators determine what measure is applied.

Neighbourhood level:

The neighbor_level operator determines which neighbourhood level is used. 0 produces output for the focus patch itself, 1 assigns the connectivity information of the first omnidirectional neighbours to the focus patch, hence the connectivity of the surrouding fragments. This value can be increased for analysing the more distant neighbours.

Output:

Various output files are autmatically created with the pattern $output.* The ... FP describes attributes of the fokus patch (area and area of the odd) TP describes attributes of the target patch (all neighbouring patches around the FP) - separated by the statsmethod (average, median, variance, stddev) ratio describes which ratio is taken for all TPs. The output raster files are named accordingly:
*.FP.area: size of the patch
*.FP.odd: size of the isolation area
*.FP.odd_area: ratio of size of patch and size of isolaton area
*.TP.no: amount of neighbouring patches
*.TP.area.avg: average size of all neighbouring patches
*.TP.odd.avg: average size of all isolation areas of neighbouring patches
*.TP.odd_area.avg: average ratio of isolation area to patch size
*.diagram: (if flag -d active) isolation areas and border are depicted

EXAMPLE

An example for the North Carolina sample dataset:
r.pi.odc input=landclass96 output=odc keyval=5 ratio=odd_area stats=average neighbor_level=0 -d

SEE ALSO

r.pi.fnn, r.pi.enn, r.pi.graph, r.pi.index, r.pi

AUTHORS

Programming: Elshad Shirinov
Scientific concept: Dr. Martin Wegmann
Department of Remote Sensing
Remote Sensing and Biodiversity Unit
University of Wuerzburg, Germany

Port to GRASS GIS 7: Markus Metz

SOURCE CODE

Available at: r.pi.odc source code (history)

Latest change: Tuesday Sep 19 09:59:22 2023 in commit: e76c325998c8cd9053ce012a5adbb79f33ab0779


Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.5.0dev Reference Manual