pkkalman(1)

NAME
pkkalman - kalman raster images: median, min/max, morphological, kalmaning

SYNOPSIS
\FCpkkalman\F[]
[options]

DESCRIPTION
pkkalman will complement a time series of observations (option \FC-obs\F[]) at fine spatial resolution. A data assimilation technique based on a Kalman filter is hereby used. The data at fine spatial resolution are assimilated with coarse spatial resolution time series at a finer temporal resolution, referred to as a model (option \FC-mod\F[]). The time series for both observation and model can either be provided as multi-band raster datasets or as multiple single band datasets. Missing data in the observations are predicted by the algorithm. The model must cover at least the spatial coverage of the observation. The missing data must be provided either as nodata values in the input (using option \FC-obsnodata\F[]) or as an external mask (using option \FC-obsmask\F[]). The time sequence for the model and observation should be provided via the options \FC-tmod\F[] and \FC-tobs\F[]. Tuning parameters for the algorithm are process noise (option \FC-q\F[]) and the weights for uncertainty of valid observations (\FC-uo\F[]) and the model (\FC-um\F[]).

OPTIONS

\FC-dir\F[] forward|backward|smooth, \FC--direction\F[] forward|backward|smooth
    direction to run model (forward|backward|smooth)

\FC-mod\F[] filename, \FC--model\F[] filename
    coarse spatial resolution input datasets(s) used as model. Use either multi-band input (\FC-model\F[] multiband_model.tif) or multiple single-band inputs (\FC-mod\F[] model1 \FC-mod\F[] model2 etc.)

\FC-modmask\F[] filename, \FC--modmask\F[] filename
    model mask datasets(s). Must have same dimension as model input. Use either multi-band input or multiple single-band inputs

\FC-obs\F[] filename, \FC--observation\F[] filename
    fine spatial resolution input dataset(s) used as observation. Use either multi-band input (\FC-obs\F[] multiband_obs.tif) or multiple single-band inputs (\FC-obs\F[] obs1 \FC-obs\F[] obs2 etc.)

\FC-obsmask\F[] filename, \FC--obsmask\F[] filename
    observation mask dataset(s). Must have same dimension as observation input (use multi-band input or multiple single-band inputs)

\FC-tmod\F[] number, \FC--tmodel\F[] number
    time sequence of model input. Sequence must have exact same length as model input. Leave empty to have default sequence 0,1,2,etc.

\FC-tobs\F[] number, \FC--tobservation\F[] number
    time sequence of observation input. Sequence must have exact same length as observation input

\FC-a_srs\F[] EPSG:number, \FC--a_srs\F[] EPSG:number
    Override the projection for the output file (leave blank to copy from input file, use epsg:3035 to use European projection and force to European grid)

\FC-ofw\F[] filename, \FC--outputfw\F[] filename
    Output raster dataset for forward model

\FC-u_ofw\F[] filename, \FC--u_outputfw\F[] filename
    Uncertainty output raster dataset for forward model

\FC-obw\F[] filename, \FC--outputbw\F[] filename
    Output raster dataset for backward model

\FC-u_obw\F[] filename, \FC--u_outputbw\F[] filename
    Uncertainty output raster dataset for backward model

\FC-ofb\F[] filename, \FC--outputfb\F[] filename
    Output raster dataset for smooth model

\FC-u_ofb\F[] filename, \FC--u_outputfb\F[] filename
    Uncertainty output raster dataset for smooth model

\FC-modnodata\F[] value, \FC--modnodata\F[] value
    invalid value for model input

\FC-obsnodata\F[] value, \FC--obsnodata\F[] value
    invalid value for observation input

\FC-msknodata\F[] value, \FC--msknodata\F[] value
    Mask value not to consider

\FC-mskband\F[] value, \FC--mskband\F[] value
    Mask band to read (0 indexed)

\FC-obsmin\F[] value, \FC--obsmin\F[] value
    Minimum value for observation data

\FC-obsmax\F[] value, \FC--obsmax\F[] value
    Maximum value for observation data

\FC-eps\F[] value, \FC--eps\F[] value
    epsilon for non zero division. Default: 0.00001

\FC-um\F[] value, \FC--uncertmodel\F[] value
    Uncertainty of the model

\FC-uo\F[] value, \FC--uncertobs\F[] value
    Uncertainty of valid observations

\FC-unodata\F[] value, \FC--uncertnodata\F[] value
    Uncertainty in case of no-data values in observation.

\FC-q\F[] value, \FC--q\F[] value
    Process noise: expresses instability (variance) of proportions of fine res pixels within a moderate resolution pixel

\FC-down\F[] number, \FC--down\F[] number
    Downsampling factor for reading model data to calculate regression (default is ratio between coarse (model) and fine (obs) resolution raster datasets)

\FC-ot\F[] type, \FC--otype\F[] 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-of\F[] GDALformat, \FC--oformat\F[] GDALformat
    Output image format (see also gdal_translate(1)). Empty string: inherit from input image

\FC-co\F[] NAME=VALUE, \FC--co\F[] NAME=VALUE
    Creation option for output file. Multiple options can be specified.

\FC-v\F[] level, \FC--verbose\F[] level
    verbose mode when positive