r.transect

NAME

r.transect - Outputs raster map layer values lying along user defined transect line(s).
(GRASS Raster Program)

SYNOPSIS

r.transect
r.transect help
r.transect [-g] map=name line=east,north,azimuth,distance[,east,north,azimuth,distance,...] null=string

DESCRIPTION

This progream outputs, in ASCII, the values in a raster map which lie along one or more user-defined transect lines. The transects are described by their starting coordinates, azimuth, and distance.

OPTIONS

Flags:

-g: Output easting and northing in first two columns of four column output

Parameters:

map=name: Name of an existing raster map layer to be queried.
line=east,north,azimuth,distance[,east,north,azimuth,distance,...]: A definition of (each) transect line, specified by the geographic coordinates of its starting point (easting, northing), the angle and direction of its travel (azimuth), and its distance (distance).
The azimuth is an angle, in degrees, measured to the east of north. The distance is in map units (meters for a metered database, like UTM).
null=string: Character string to represent no data value.

NOTES

This program is a front-end to the r.profile program. It simply converts the azimuth and distance to an ending coordinate and then runs r.profile.

BUGS

There once were width= and result=raw|median|average options which are not currently implemented.

AUTHOR

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

Last changed: $Date$