## NAME

r.in.poly - Create raster maps from ascii polygon/line data files in the current directory.
(GRASS Raster Program)

## SYNOPSIS

r.in.poly
r.in.poly help
r.in.poly input=name output=name [TITLE="phrase"] [rows=value]

## DESCRIPTION

r.in.poly allows the creation of GRASS binary raster maps from ASCII files in the current directory containing polygon and linear features.

## OPTIONS

### Parameters:

input=name
  Unix input file, in ascii format, containing the polygon and linear features. The format of this file is described in the section INPUT FORMAT below.
output=name
  Raster output file
TITLE="phrase"
  Title for resultant raster map (optional)
rows=value
  Number of rows to hold in memory (default: 512). This parameter allows users with less memory (or more) on their system to control how much memory r.in.poly uses.

## INPUT FORMAT

The input format for the input file consists of sections describing either polygonal areas or linear features. The basic format is:

    A                      <for polygonal areas>
        easting northing
        .
        .
        .
    =   cat# label
    L                      <for linear features>
        easting northing
        .
        .
        .
    =   cat# label

The A signals the beginning of a polygon. It must appear in the first column. The L signal the beginning of a linear feature. It also must appear in the first column. The coordinates of the vertices of the polygon, or the coordinates defining the linear feature follow and must have a space in the first column and at least one space between the easting and the northing. To give meaning to the features, the = indicates that the feature currently being processed has category value cat# (which must be an integer) and a label (which may be more than one word, or which may be omitted).

## EXAMPLE

An area described by four points:

      A
      591316.80   4926455.50
      591410.25   4926482.40
      591434.60   4926393.60
      591341.20   4926368.70
      = 42 stadium

## SEE ALSO

r.digit for interactive on-screen polygon/line digitizing for raster maps

r.colors for creates color tables for raster maps

## AUTHOR

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

Last changed: $Date: 2003/07/04 08:35:34 $