<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>GRASS GIS: r.transect</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <link rel="stylesheet" href="grassdocs.css" type="text/css"> </head> <body bgcolor="white"> <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade> <h2>NAME</h2> <em><b>r.transect</b></em> - Outputs raster map layer values lying along user defined transect line(s). <h2>KEYWORDS</h2> raster <h2>SYNOPSIS</h2> <b>r.transect</b><br> <b>r.transect help</b><br> <b>r.transect</b> [-<b>g</b>] <b>map</b>=<em>name</em> <b>line</b>=<em>east,north,azimuth,distance</em>[,<i>east,north,azimuth,distance</i>,...] [<b>null</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>] <h3>Flags:</h3> <DL> <DT><b>-g</b></DT> <DD>Output easting and northing in first two columns of four column output</DD> <DT><b>--verbose</b></DT> <DD>Verbose module output</DD> <DT><b>--quiet</b></DT> <DD>Quiet module output</DD> </DL> <h3>Parameters:</h3> <DL> <DT><b>map</b>=<em>name</em></DT> <DD>Raster map to be queried</DD> <DT><b>line</b>=<em>east,north,azimuth,distance[,<i>east,north,azimuth,distance</i>,...]</em></DT> <DD>Transect definition</DD> <DT><b>null</b>=<em>string</em></DT> <DD>Char string to represent no data cell</DD> <DD>Default: <em>*</em></DD> </DL> <H2>DESCRIPTION</H2> This program 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. <!-- The transects may be single-cell wide lines, or multiple-cell wide lines. The output, for each transect, may be the values at each of the cells, or a single aggregate value (e.g., average or median value). --> <P> The <B>line</B> parameter is a definition of (each) transect line, specified by the geographic coordinates of its starting point (<EM>easting, northing</EM>), the angle and direction of its travel (<EM>azimuth</EM>), and its distance (<EM>distance</EM>). <P> The <EM>azimuth</EM> is an angle, in degrees, measured to the east of north. The <EM>distance</EM> is in map units (meters for a metered database, like UTM). <P> The <B>null</B> parameter can optionally be set to change the character string representing null values. <H2>NOTES</H2> This program is a front-end to the <EM> <A HREF="r.profile.html">r.profile</A></EM> program. It simply converts the azimuth and distance to an ending coordinate and then runs <EM> <A HREF="r.profile.html">r.profile</A></EM>. There once were <B>width=</B> and <B>result=</B><EM>raw|median|average</EM> options which are not currently implemented. <H2>SEE ALSO</H2> <EM><A HREF="r.profile.html">r.profile</A></EM> <H2>AUTHOR</H2> Michael Shapiro, U.S. Army Construction Engineering Research Laboratory <p><i>Last changed: $Date: 2004-02-24 01:35:46 +0100 (Tue, 24 Feb 2004) $</i> <HR> <P><a href="index.html">Main index</a> - <a href="raster.html">raster index</a> - <a href="full_index.html">Full index</a></P> <P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p> </body> </html>