Manual pages for "v.circle", "r.in.elas", and "r.out.elas":
v.circle GRASS Reference Manual v.circle
NAME
v.circle - Creates one or more "polygon" circles in a binary
vector file. These circles are created using each point
from an existing "site_lists" file as the centers for those
circles. There is one circle created per "site_lists"
point.
(GRASS Vector Program)
SYNOPSIS
v.circle
v.circle help
v.circle [-s] [radius=value] [radius_uom=name] [area=value]
[area_uom=name] sitefile=name output=name
DESCRIPTION
"v.circle" will create a vector "polygon" circle around each
point read from an existing "site_lists" file. Each
"site_lists" point will be the center for each circle with
one circle created per point. The "polygon" circle will be
written to a binary vector file. Each "polygon" circle will
have 361 points with each point on the circumference of the
circle representing 1 degree of arc. "v.circle" only
creates vector files of either unreferenced XY or UTM
projections. If you use the unreferenced XY projection then
the coordinates are assumed to be in meters. The
coordinates for the vector file outputted will always be in
meters irregardless of whether you use the unreferenced XY
or UTM projections.
COMMAND LINE OPTIONS
Flags
-s Automatically run "v.support" on newly created vector
file.
Parameters
radius
Radius of circle(s) with "site_lists" point(s) as
center(s). If radius selected then area values are not
used for computations. If both radius and area
selected, then radius has precedence over area.
default: 0.0
radius_uom
Radius unit of measure, i.e. (m)meters, ft(feet),
(mi)miles.
default: m
area Area of circle(s) with "site_lists" point(s) as
GRASS 4.0 U.S. Army CERL 1
v.circle GRASS Reference Manual v.circle
center(s).
If area selected then radius values are not used for
computations.
default: 0.0
area_uom
Area unit of measure, i.e. sqm(square meters),
ac(acres), sqmi(square miles), hec(hectares).
default: sqm
sitefile
GRASS site_lists file (input).
output
Vector file to be created (output).
AUTHOR
Bruce Powell, National Park Service
GRASS 4.0 U.S. Army CERL 2
r.in.elas GRASS Reference Manual r.in.elas
NAME
r.in.elas - Copies and converts an ELAS raster file to a
GRASS cell file.
(GRASS Raster Program)
SYNOPSIS
r.in.elas
r.in.elas help
r.in.elas [-h] [channel=value] [zone=value] [proj=value]
[nbpe=value] [x-spot-size=value] [y-spot-size=value]
input=name output=name
DESCRIPTION
This program "r.in.elas" copies and converts an ELAS raster
file to a GRASS cell file. The ELAS raster file must be a 1
to 4 byte integer per element file. The GRASS file created
from the ELAS file will be either an unreferenced XY or a
UTM projection. The ELAS color values will be transferred
to GRASS only if there are color values in the ELAS header.
If no color values are transferred from ELAS then a GRASS
color file will automatically be created. This color file
will be a RGB color ramp. The area to be transferred from
ELAS to GRASS will be determined by the ELAS values "il"
(initial line), "ll" (last line), "ie" (initial element),
and "le"(last element). Multi-channel ELAS raster files may
be transferred to GRASS one channel at a time. Input
variables: nbpe, x-spot-size, and y-spot-size are OPTIONAL
variables and can only be inputted non-interactively, since
these values will usually already be stored in the ELAS
header. But if these values are not in the ELAS header,
then the user may provide those values by entering the non-
interactive command. This program will produce a GRASS
range file and if the flag "-h" is passed to the program
then a histogram file will be created as well. Using the
"-h" flag with larger files is not recommended since
creating a histogram file will increase processing time.
You can create a histogram file after this program is
finished executing by running "r.support". This program
will produce a new "WIND" (region) that will correspond to
the new "cellhd" file that has been created. If the user
should want to save their original "WIND" (region) then they
should run "g.region" prior to executing this program.
COMMAND LINE OPTIONS
Flags
-h Create GRASS histogram file.
GRASS 4.0 U.S. Army CERL 1
r.in.elas GRASS Reference Manual r.in.elas
Parameters
channel
ELAS channel number.
default: 1
zone UTM zone number. (1-60)
default: 0
proj GRASS "proj" value. (0 for XY and 1 for UTM)
default: 1
nbpe (number of bytes per element) for ELAS file. "nbpe" is
an OPTIONAL value, only to be inputted to override the
ELAS header value.
default: 0
x-spot-size
ELAS X Spot size number. "x-spot-size" is an OPTIONAL
value, only to be inputted to override the ELAS header
value.
default: 0
y-spot-size
ELAS Y Spot size number. "y-spot-size" is an OPTIONAL
value, only to be inputted to override the ELAS header
value.
default: 0
input
ELAS input raster file name.
output
GRASS output cell file name.
SEE ALSO
r.out.elas
AUTHOR
Bruce Powell, National Park Service
GRASS 4.0 U.S. Army CERL 2
r.out.elas GRASS Reference Manual r.out.elas
NAME
r.out.elas - Copies and converts a GRASS cell file to an
ELAS raster file.
(GRASS Raster Program)
SYNOPSIS
r.out.elas
r.out.elas help
r.out.elas [-f] input=name output=name
DESCRIPTION
"r.out.elas" will transfer and convert a GRASS cell file to
an ELAS raster file. The GRASS cell file will be a 1 to 4
byte integer per element file. This GRASS cell file may be
converted to either a 1 to 4 byte integer per element ELAS
file (default) or a 4 byte floating-point per element ELAS
file. Color values will be transferred from GRASS to ELAS
for GRASS 1 byte integer per element files only.
"r.out.elas" only transfers GRASS cell files that have
either an unreferenced XY or UTM projection. Whether the
GRASS cell file is either an unreferenced XY or UTM
projection, the ELAS file created will be a UTM projection.
"r.out.elas" will transfer the GRASS cell file based on the
selected region and will only transfer the portion of the
GRASS cell file that is within that selected region.
"r.out.elas" will notify the user as to whether the current
region has the same values as the "cellhd" file for the
GRASS cell file being transferred to ELAS. Since the area
transferred to ELAS is determined by the region (WIND file)
and not the cellhd file then the notification of a
difference between these files will indicate that not all of
the GRASS cell file will be transferred to ELAS. Also, this
program will notify the user as to whether the raster "MASK"
is on or not.
COMMAND LINE OPTIONS
Flags
-f Floating-point ELAS output file will be created.
Parameters
input
GRASS input cell file name.
output
ELAS output raster file name.
GRASS 4.0 U.S. Army CERL 1
r.out.elas GRASS Reference Manual r.out.elas
SEE ALSO
r.in.elas
AUTHOR
Bruce Powell, National Park Service