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
r.pi.odc is part of the patch based fragmentation analysis
package r.pi.* (Patch Index). It computes omnidirectional connectivity
analysis between patches.
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:
The
keyval operator determines which category value is taken
for the Patch Index analysis.
The
ratio operators determine what measure is applied.
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.
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
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
r.pi.fnn,
r.pi.enn,
r.pi.graph,
r.pi.index,
r.pi
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.4.1dev Reference Manual