NAME

SYNOPSIS

DESCRIPTION

The random surface generated are composed of floating point numbers, and saved in the category description files of the output map(s). Cell values are uniformly or normally distributed between 1 and high values inclusive (determined by whether the -u flag is used). The category names indicate the average floating point value and the range of floating point values that each cell value represents.

r.random.surface's original goal is to generate random fields for spatial error modeling. A procedure to use r.random.surface in spatial error modeling is given in the NOTES section.

OPTIONS

Flags:

-q

This flag prevents the program from sending information to standard output.

-u

This flag will make the output map's cell values have a uniform distribution instead of a normal distribution. Uniform distributions are useful in situations where the user wants random values for a range of integer values. The user then uses the cell values instead of the random values in the category description file. The uniform flag is also useful when the random values near the mean are more meaningful to the user. The flag on will cause the cell values from low to high to have an equal chance of being used. Thus, not using the flag is useful in situations where you want to use the floating point numbers in the category description in your analysis. Keeping this flag off will allow the outliers of the random distribution to be more accurately represented. See the NOTES section for example use of this flag.

Parameters:

output

Output map(s): Random surface(s). The cell values are a random distribution between the low and high values inclusive. The category values of the output map(s) are in the form "#.# #.# to #.#" where each #.# is a floating point number. The first number is the average of the random values the cell value represents. The other two numbers are the range of random values for that cell value. The "average" mean value of generated \fIoutput\fR map(s) is 0. The "average" variance of map(s) generated is 1. The random values represent the standard deviation from the mean of that random surface.

distance

Input value(s) [default 0.0]: distance determines the spatial dependence of the output map(s). The distance value indicates the minimum distance at which two map cells have no relationship to each other. A distance value of 0.0 indicates that there is no spatial dependence (i.e., adjacent cell values have no relationship to each other). As the distance value increases, adjacent cell values will have values closer to each other. But the range and distribution of cell values over the output map(s) will remain the same. Visually, the clumps of lower and higher values gets larger as distance increases. If multiple values are given, each output map will have multiple filters, one for each set of distance, exponent, and weight values.

exponent

Input value(s) [default 1.0]: exponent determines the distance decay exponent for a particular filter. The exponent value(s) have the property of determining the "texture" of the random surface. Texture will decrease as the exponent value(s) get closer to 1.0. Normally, exponent will be 1.0 or less. If there are no exponent values given, each filter will be given an exponent value of 1.0. If there is at least one exponent value given, there must be one exponent value for each distance value.

flat

Input value(s) [default 0.0]: flat determines the distance at which the filter

weight

Input value(s) [default 1.0]: weight determines the relative importance of each filter. For example, if there were two filters driving the algorithm and weight=1.0, 2.0 was given in the command line: The second filter would be twice as important as the first filter. If no weight values are given, each filter will be just as important as the other filters defining the random field. If weight values exist, there must be a weight value for each filter of the random field.

high

Input value [default 255]: Specifies the high end of the range of cell values in the output map(s). Specifying a very large high value will minimize the "errors" caused by the random surface's discretization. The word errors is in quotes because errors in discretization are often going to cancel each other out and the spatial statistics are far more sensitive to the initial independent random deviates than any potential discretization errors.

seed

Input value(s) [default random]: Specifies the random seed(s), one for each map, that r.random.surface will use to generate the initial set of random values that the resulting map is based on. If the random seed is not given, r.random.surface will get a seed from the process ID number.

NOTES

r.random.surface builds the random surface using a filter algorithm smoothing a map of independent random deviates. The size of the filter is determined by the largest distance of spatial dependence. The shape of the filter is determined by the distance decay exponent(s), and the various weights if different sets of spatial parameters are used. The map of independent random deviates will be as large as the current region PLUS the extent of the filter. This will eliminate edge effects caused by the reduction of degrees of freedom. The map of independent random deviates will ignore the current mask for the same reason.

One of the most important uses for r.random.surface is to determine how the error inherent in raster maps might effect the analyses done with those maps. If you wanted to check to see how sensitive your analysis is to the errors in the DEMs in your study area, see: