Man page - pkdsm2shadow(1)

Packages contains this manual

Manual

pkdsm2shadow

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE

NAME

pkdsm2shadow - program to calculate sun shadow based on digital surface model and sun angles

SYNOPSIS

pkdsm2shadow -i input -o output [ -sza angle ] [ -saa angle ] [ options ] [ advanced options ]

DESCRIPTION

pkdsm2shadow is a utility to create a binary shadow mask from a digital surface model, based on Sun zenith ( -sza ) and azimuth angles ( -saa ).

OPTIONS

-i filename , --input filename

input image file

-o filename , --output filename

Output image file

-sza angle , --sza angle

Sun zenith angle.

-saa angle , --saa angle

Sun azimuth angle (N=0 E=90 S=180 W=270).

-f value , --flag value

Flag to put in image if pixel shadow

-ot type , --otype type

Data type for output image ({Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}). Empty string: inherit type from input image

-of GDALformat , --oformat GDALformat

Output image format (see also gdal_translate (1)).

-ct filename , --ct filename

color table (file with 5 columns: id R G B ALFA (0: transparent, 255: solid)

-co option , --co option

Creation option for output file. Multiple options can be specified.

-v level , --verbose level

verbose mode if > 0

Advanced options
-s
value , --scale value

scale used for input dsm: height=scale*input+offset

-off value , --offset value

offset used for input dsm: height=scale*input+offset

EXAMPLE

Create a shadow mask for the input raster dataset dsm.tif , 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.

pkdsm2shadow -i dsm.tif -sza 10 -saa 170 -f 1 -o shadow.tif