No subject

Bruce Powell nps!bruce at cerl.cecer.army.mil
Tue Jun 22 15:52:34 EDT 1993


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




More information about the grass-dev mailing list