.TH r.plane 1grass "" "GRASS 7.6.0" "Grass User's Manual"
.SH NAME
\fI\fBr.plane\fR\fR  \- Creates raster plane map given dip (inclination), aspect (azimuth) and one point.
.SH KEYWORDS
raster, elevation
.SH SYNOPSIS
\fBr.plane\fR
.br
\fBr.plane \-\-help\fR
.br
\fBr.plane\fR \fBoutput\fR=\fIname\fR \fBdip\fR=\fIfloat\fR \fBazimuth\fR=\fIfloat\fR \fBeasting\fR=\fIfloat\fR \fBnorthing\fR=\fIfloat\fR \fBelevation\fR=\fIfloat\fR  [\fBtype\fR=\fIstring\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBoutput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name for output raster map
.IP "\fBdip\fR=\fIfloat\fR \fB[required]\fR" 4m
.br
Dip of plane in degrees
.br
Default: \fI0.0\fR
.IP "\fBazimuth\fR=\fIfloat\fR \fB[required]\fR" 4m
.br
Azimuth of the plane in degrees
.br
Default: \fI0.0\fR
.IP "\fBeasting\fR=\fIfloat\fR \fB[required]\fR" 4m
.br
Easting coordinate of a point on the plane
.IP "\fBnorthing\fR=\fIfloat\fR \fB[required]\fR" 4m
.br
Northing coordinate of a point on the plane
.IP "\fBelevation\fR=\fIfloat\fR \fB[required]\fR" 4m
.br
Elevation coordinate of a point on the plane
.IP "\fBtype\fR=\fIstring\fR" 4m
.br
Type of raster map to be created
.br
Storage type for resultant raster map
.br
Options: \fICELL, FCELL, DCELL\fR
.br
Default: \fIFCELL\fR
.br
\fBCELL\fR: Integer
.br
\fBFCELL\fR: Single precision floating point
.br
\fBDCELL\fR: Double precision floating point
.SH DESCRIPTION
\fIr.plane\fR 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 \fIazimuth\fR parameter increase counter\-clockwise,
i.e., 0 degree = N, 45 degree = NW, 90 degree = W etc.
.PP
Increasing values of the \fIdip\fR parameter progressively lower (or dip) the northern
half of the plane, and incline the southern half, assuming the \fIazimuth\fR parameter
is held constant at 0 degrees.
.SH NOTES
g.region \-c provides the easting and northing coordinates for
the center of the current region.
.PP
\fICELL\fR (integer) maps take less disk space than \fIFCELL\fRs (floating point),
which in turn take up less space than \fIDCELL\fRs (double precision floating point).
.SH EXAMPLE
A tilted plane in the North Carolina sample dataset region:
.br
.nf
\fC
g.region \-d
g.region \-c
r.plane myplane45 dip=45 az=90 east=527500.0 north=165000.0 \(rs
        elev=1000 type=FCELL
\fR
.fi
.SH AUTHOR
Stefan Jä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
.PP
\fILast changed: $Date: 2017\-10\-17 19:33:31 +0200 (Tue, 17 Oct 2017) $\fR
.SH SOURCE CODE
.PP
Available at: r.plane source code (history)
.PP
Main index |
Raster index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2019
GRASS Development Team,
GRASS GIS 7.6.0 Reference Manual