pkdsm2shadow(1)

pkdsm2shadow1

Program to calculate sun shadow based on digital surface model and sun angles

Usage

FCpkdsm2shadowF [0] FC-iF [0] input FC-oF [0] output [FC-szaF [0] angle] [FC-saaF [0] angle] [options] [advanced options]

Overview

pkdsm2shadow is a utility to create a binary shadow mask from a digital surface model, based on Sun zenith (FC-szaF[0]) and azimuth angles (FC-saaF[0]).

Options

FC-iF[0] filename, FC--inputF[0] filename

input image file

FC-oF[0] filename, FC--outputF[0] filename

Output image file

FC-szaF[0] angle, FC--szaF[0] angle

Sun zenith angle.

FC-saaF[0] angle, FC--saaF[0] angle

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

FC-fF[0] value, FC--flagF[0] value

Flag to put in image if pixel shadow

FC-otF[0] type, FC--otypeF[0] type

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

FC-ofF[0] GDALformat, FC--oformatF[0] GDALformat

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

FC-ctF[0] filename, FC--ctF[0] filename

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

FC-coF[0] option, FC--coF[0] option

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

FC-vF[0] level, FC--verboseF[0] level

verbose mode if > 0

Advanced options

FC-sF[0] value, FC--scaleF[0] value

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

FC-offF[0] value, FC--offsetF[0] value

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

Examples

Create a shadow mask for the input raster dataset FCdsm.tifF[0], 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.

FC
pkdsm2shadow -i dsm.tif -sza 10 -saa 170 -f 1 -o shadow.tif
      F[0]

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

From pktools 2.6.7.6+ds-6+b3 in Debian 13 (Trixie). Parsed by carta from the page's man source.