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.nlm - Creates a random generated map with values 0 or 1by given landcover and fragment count.

KEYWORDS

raster

SYNOPSIS

r.pi.nlm
r.pi.nlm --help
r.pi.nlm [-r] [input=name] output=name [keyval=integer] [nullval=integer[,integer,...]] [landcover=float] [sharpness=float] [seed=integer] [title="phrase"] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-r
Print report to stdout
--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
Name of input raster map
output=name [required]
Name for output raster map
keyval=integer
Value of a category from the input file to measure desired landcover
nullval=integer[,integer,...]
Values marking areas from the input file, which are to be NULL in the resulting map
landcover=float
Landcover in percent
sharpness=float
Small values produce smooth structures, great values produce sharp, edgy structures - Range [0-1]
seed=integer
Seed for random number generator
title="phrase"
Title for resultant raster map

Table of contents

DESCRIPTION

Creates a random generated map with values 0 or 1" "by given landcover and agglomeration value.

NOTES

Related to r.pi.nlm.circ but using fractal landscapes instead of circular growth. Per default the size of the whole region is used for generating a random landscape, this can be constraint by assigning a class in a raster map with acts as mask for the generation of the random landscape (nullval). The landcover can be set manually, randomly or be taken from the input class coverage. The agglomeration level (sharpness) can be set manually or randomly. If similar random landscape with differing e.g. percentage coverage should be generated, then the seed can be set using any number and reused for any subsequent analysis.

EXAMPLE

An example for the North Carolina sample dataset: A random landscape with random percentage coverage and agglomeration factor:
r.pi.nlm output=nlm.1 landcover=50
A random landscape is generated using the percentage coverage of class 5. The agglomeration factor is set randomly:
r.pi.nlm input=landclass96 output=nlm.2 keyval=5

SEE ALSO

r.pi.nlm.circ, r.pi.nlm.stats, 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.nlm 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