NAME

s.to.rast - Converts a site file to a cell file
(GRASS Sites Program)

SYNOPSIS

s.to.rast
s.to.rast help
s.to.rast [-qs] input=name output=name size=value title="phrase" field=value findex=value string=value

DESCRIPTION

s.to.rast converts a GRASS site file to a GRASS raster file.

The quad size (ie the number of cells used to represent one site) is fixed to 0 (ie one cell/site). If the output file already exists, the program exits gracefully.

OPTIONS

Flag:

-q
Run the module quietly.
-s
Create a single-valued (0/1, binary) raster map

Parameters:

input=name
Name of input site list
output=name
Name of output cell file
size=value
Number of cells to surround site cell
title="phrase"
Title for the resulting raster map
field=value
Attribute field type to use for operation
options: dim,decimal,cat
default: decimal
findex=value
Attribute field number to use for operation
default: 1
string=value
String attribute number to use for description
default: 1

NOTES

When converting from a sites layer to a raster layer with size=0, the site is converted into a single cell representing the location of the site, which can be hard to see (depending on the raster resolution).
size=2 (or higher) makes the sites show up as fatter in the raster layer.

Alternaticely the user can convert the sites to vector format and use v.bubble or v.circle to represent the location.

As site files can consist of several attribute fields (decimals or string categories), the user can select the column of interest for conversion using the filed selection parameters (findex, string). The attribute field type to use for operation is selected by parameter field.

The user will be warned if two or more sites fall into one raster cell. However, the module will continue to import (the last site value will determine the cell value). If such overwriting is not wanted, the cell resolution has to be changed using g.region.

The user will be warned if sites fall out of the current region.

SEE ALSO

g.region, s.menu, s.to.vect, v.bubble, v.circle,

AUTHORS

Katarina Johnsson, CCRS
GRASS 5 improvements: Eric G. Miller