pkkalman(1)

NAME

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

SYNOPSIS

FCpkkalmanF[0] [options]

DESCRIPTION

pkkalman will complement a time series of observations (option FC-obsF[0]) 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-modF[0]). 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-obsnodataF[0]) or as an external mask (using option FC-obsmaskF[0]). The time sequence for the model and observation should be provided via the options FC-tmodF[0] and FC-tobsF[0]. Tuning parameters for the algorithm are process noise (option FC-qF[0]) and the weights for uncertainty of valid observations (FC-uoF[0]) and the model (FC-umF[0]).

OPTIONS

FC-dirF[0] forward|backward|smooth, FC--directionF[0] forward|backward|smooth

direction to run model (forward|backward|smooth)

FC-modF[0] filename, FC--modelF[0] filename

coarse spatial resolution input datasets(s) used as model. Use either multi-band input (FC-modelF[0] multiband_model.tif) or multiple single-band inputs (FC-modF[0] model1 FC-modF[0] model2 etc.)

FC-modmaskF[0] filename, FC--modmaskF[0] filename

model mask datasets(s). Must have same dimension as model input. Use either multi-band input or multiple single-band inputs

FC-obsF[0] filename, FC--observationF[0] filename

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

FC-obsmaskF[0] filename, FC--obsmaskF[0] filename

observation mask dataset(s). Must have same dimension as observation input (use multi-band input or multiple single-band inputs)

FC-tmodF[0] number, FC--tmodelF[0] 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-tobsF[0] number, FC--tobservationF[0] number

time sequence of observation input. Sequence must have exact same length as observation input

FC-a_srsF[0] EPSG:number, FC--a_srsF[0] 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-ofwF[0] filename, FC--outputfwF[0] filename

Output raster dataset for forward model

FC-u_ofwF[0] filename, FC--u_outputfwF[0] filename

Uncertainty output raster dataset for forward model

FC-obwF[0] filename, FC--outputbwF[0] filename

Output raster dataset for backward model

FC-u_obwF[0] filename, FC--u_outputbwF[0] filename

Uncertainty output raster dataset for backward model

FC-ofbF[0] filename, FC--outputfbF[0] filename

Output raster dataset for smooth model

FC-u_ofbF[0] filename, FC--u_outputfbF[0] filename

Uncertainty output raster dataset for smooth model

FC-modnodataF[0] value, FC--modnodataF[0] value

invalid value for model input

FC-obsnodataF[0] value, FC--obsnodataF[0] value

invalid value for observation input

FC-msknodataF[0] value, FC--msknodataF[0] value

Mask value not to consider

FC-mskbandF[0] value, FC--mskbandF[0] value

Mask band to read (0 indexed)

FC-obsminF[0] value, FC--obsminF[0] value

Minimum value for observation data

FC-obsmaxF[0] value, FC--obsmaxF[0] value

Maximum value for observation data

FC-epsF[0] value, FC--epsF[0] value

epsilon for non zero division. Default: 0.00001

FC-umF[0] value, FC--uncertmodelF[0] value

Uncertainty of the model

FC-uoF[0] value, FC--uncertobsF[0] value

Uncertainty of valid observations

FC-unodataF[0] value, FC--uncertnodataF[0] value

Uncertainty in case of no-data values in observation.

FC-qF[0] value, FC--qF[0] value

Process noise: expresses instability (variance) of proportions of fine res pixels within a moderate resolution pixel

FC-downF[0] number, FC--downF[0] number

Downsampling factor for reading model data to calculate regression (default is ratio between coarse (model) and fine (obs) resolution raster datasets)

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)). Empty string: inherit from input image

FC-coF[0] NAME=VALUE, FC--coF[0] NAME=VALUE

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

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

verbose mode when positive