'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH pkdsm2shadow 1 "14 June 2016" "" ""
.SH NAME
pkdsm2shadow \- program to calculate sun shadow based on digital surface model and sun angles
.SH SYNOPSIS
'nh
.fi
.ad l
\fBpkdsm2shadow\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
\fB-i\fR \fIinput\fR \fB-o\fR \fIoutput\fR [\fB-sza\fR \fIangle\fR] [\fB-saa\fR \fIangle\fR] [\fIoptions\fR] [\fIadvanced options\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBpkdsm2shadow\fR is a utility to create a binary shadow
mask from a digital surface model, based on Sun zenith
(\*(T<\fB\-sza\fR\*(T>) and azimuth angles (\*(T<\fB\-saa\fR\*(T>).
.SH OPTIONS
.TP 
\*(T<\fB\-i\fR\*(T> \fIfilename\fR, \*(T<\fB\-\-input\fR\*(T> \fIfilename\fR
input image file
.TP 
\*(T<\fB\-o\fR\*(T> \fIfilename\fR, \*(T<\fB\-\-output\fR\*(T> \fIfilename\fR
Output image file
.TP 
\*(T<\fB\-sza\fR\*(T> \fIangle\fR, \*(T<\fB\-\-sza\fR\*(T> \fIangle\fR
Sun zenith angle.
.TP 
\*(T<\fB\-saa\fR\*(T> \fIangle\fR, \*(T<\fB\-\-saa\fR\*(T> \fIangle\fR
Sun azimuth angle (N=0 E=90 S=180 W=270).
.TP 
\*(T<\fB\-f\fR\*(T> \fIvalue\fR, \*(T<\fB\-\-flag\fR\*(T> \fIvalue\fR
Flag to put in image if pixel shadow 
.TP 
\*(T<\fB\-ot\fR\*(T> \fItype\fR, \*(T<\fB\-\-otype\fR\*(T> \fItype\fR
Data type for output image
({Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}).
Empty string: inherit type from input image 
.TP 
\*(T<\fB\-of\fR\*(T> \fIGDALformat\fR, \*(T<\fB\-\-oformat\fR\*(T> \fIGDALformat\fR
Output image format (see also
\fBgdal_translate\fR(1)).
.TP 
\*(T<\fB\-ct\fR\*(T> \fIfilename\fR, \*(T<\fB\-\-ct\fR\*(T> \fIfilename\fR
color table (file with 5 columns:
id R G B ALFA (0: transparent, 255: solid)
.TP 
\*(T<\fB\-co\fR\*(T> \fIoption\fR, \*(T<\fB\-\-co\fR\*(T> \fIoption\fR
Creation option for output file.
Multiple options can be specified.
.TP 
\*(T<\fB\-v\fR\*(T> \fIlevel\fR, \*(T<\fB\-\-verbose\fR\*(T> \fIlevel\fR
verbose mode if > 0
.PP
Advanced options
.TP 
\*(T<\fB\-s\fR\*(T> \fIvalue\fR, \*(T<\fB\-\-scale\fR\*(T> \fIvalue\fR
scale used for input dsm:
height=scale*input+offset
.TP 
\*(T<\fB\-off\fR\*(T> \fIvalue\fR, \*(T<\fB\-\-offset\fR\*(T> \fIvalue\fR
offset used for input dsm:
height=scale*input+offset
.SH EXAMPLE
Create a shadow mask for the input raster dataset
\*(T<\fIdsm.tif\fR\*(T>, using Sun zenith angle of 10 degrees and
a Sun azimuth angle of 135 degrees (South-South-East).
All shadow pixels are set to a value of 1.
.PP
.nf
\*(T<
\fBpkdsm2shadow\fR \fB\-i\fR \fIdsm.tif\fR \fB\-sza\fR \fI10\fR \fB\-saa\fR \fI170\fR \fB\-f\fR \fI1\fR \fB\-o\fR \fIshadow.tif\fR
      \*(T>
.fi