File: r.plane.html

package info (click to toggle)
grass 8.4.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 277,040 kB
  • sloc: ansic: 460,798; python: 227,732; cpp: 42,026; sh: 11,262; makefile: 7,007; xml: 3,637; sql: 968; lex: 520; javascript: 484; yacc: 450; asm: 387; perl: 157; sed: 25; objc: 6; ruby: 4
file content (52 lines) | stat: -rw-r--r-- 1,869 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
<h2>DESCRIPTION</h2>

<em>r.plane</em> creates a tilted plane raster map given user-specified
parameters for inclination, azimuth, and the geographic location of a
point on the plane.<br>
The angle orientations of the <em>azimuth</em> parameter increase counter-clockwise,
i.e., 0 degree = N, 45 degree = NW, 90 degree = W etc.
<p>
Increasing values of the <em>dip</em> parameter progressively lower (or dip) the northern
half of the plane, and incline the southern half, assuming the <em>azimuth</em> parameter
is held constant at 0 degrees.

<h2>NOTES</h2>

<code>g.region -c</code> provides the easting and northing coordinates for
the center of the current region.
<p>
<em>CELL</em> (integer) maps take less disk space than <em>FCELL</em>s (floating point),
which in turn take up less space than <em>DCELL</em>s (double precision floating point).
<!-- is that true because of grass's compression? otherwise both int and float are both 4 bytes per cell -->

<h2>EXAMPLE</h2>

A tilted plane in the North Carolina sample dataset region:

<div class="code"><pre>
# set computational region
g.region raster=elev_lid792_1m -p

# get center coordinates as an example
g.region -c
# get terrain height at point
r.what map=elev_lid792_1m coordinates=638650.0,220375.0
# shows elevation: 116.7734

# generate tilted plane
r.plane myplane30 dip=30 az=75 east=638650.0 north=220375.0 \
        elev=116.7734 type=FCELL
</pre></div>

<div align="center" style="margin: 10px">
<a href="r_plane_3d.png">
<img src="r_plane_3d.png" width="600" height="360" alt="r.plane example" border="0">
</a><br>
<i>Figure: Tilted plane shown in NVIZ along with elevation map</i>
</div>

<h2>AUTHORS</h2>

Stefan J&auml;ger (1994), University of Heidelberg during a stay at USGS<br>
Updated to GRASS 5.7 by Michael Barton, Arizona State University<br>
Full rewrite for GRASS 7 by Glynn Clements