GRASS logo

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

r.pi.export - Export of patch based information.

KEYWORDS

raster

SYNOPSIS

r.pi.export
r.pi.export --help
r.pi.export [-a] input=name output=string [values=string] [id_raster=string] [patch_raster=string] stats=string[,string,...] [title="phrase"] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-a
Set for 8 cell-neighbors. 4 cell-neighbors are default
--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=string [required]
Name for the output ASCII-file
values=string
Name for the output ASCII-file with patch values
id_raster=string
Name for the ID raster map
patch_raster=string
Name for the patch raster map
stats=string[,string,...] [required]
Statistical method to perform on the values
Options: average, variance, standard deviation, median, min, max
title="phrase"
Title for resultant raster map

Table of contents

DESCRIPTION

This module exports raster patch values (no single pixels, but single individual patch values), which can be used for subsequent analysis in R and later import into GRASS again, using r.pi.import.

NOTES

This module...

EXAMPLE

An example for the North Carolina sample dataset: generating a patch index map for later export:
r.pi.index input=landclass96 output=landclass96_forestclass5_area keyval=5 method=area
export this resulting map:
r.pi.export input=landclass96_forestclass5_area output=patch_area_out values=patch_area_values id_raster=forestclass5_ID stats=average,variance,min
various resulting files are generated:
patch_area_out: a text file with the average, variance and minimum statistics as defined above and additionally informaton about the percentage coverage (landcover) and the number of fragments (number) of the analysed landcover.
patch_area_values: a text file with the actual patch values not the statistics. The first column is providing the corresponding patch ID, which is also existing in the forestclass5_ID raster map (here:0-878). The second column is providing the percentage cover of each patch (sum is equal the overall coverage: 0.506). The third column is holding the actual patch index value (here area; e.g. patch 0: 12).

SEE ALSO

r.pi.corearea, r.pi.corr.mw, r.pi.csr.mw, r.pi.graph, r.pi.graph.dec, r.pi.graph.pr, r.pi.graph.red, r.pi.grow, r.pi.import, r.pi.index, r.pi.lm, r.pi.odc, r.pi.prob.mw, r.pi.rectangle, 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.export source code (history)

Latest change: Mon Jun 28 07:54:09 2021 in commit: 1cfc0af029a35a5d6c7dae5ca7204d0eb85dbc55


Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

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

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8dev Reference Manual