Spatial integration of point measurements¶
spatialize [--traceback] config_file
DESCRIPTION AND QUICK START¶
spatialize gets the data of time series from files and performs
spatial integration, storing the result in
tif files. The details
of its operation are specified in the configuration file specified on
the command line.
How to run it¶
First, you need to create a configuration file with a text editor such
notepad, or whatever. Create such a file
and name it, for example,
/var/tmp/spatialize.conf, or, on
Windows, something like
C:\Users\user\spatialize.conf , with
the following contents (the contents don’t matter at this stage, just
copy and paste them from below):
[General] loglevel = INFO
Then, open a command prompt and give it this command:
C:\Program Files\Pthelma\spatialize.exe C:\Users\user\spatialize.conf
(the details may differ; for example, in 64-bit Windows, it may be
C:\Program Files (x86) instead of
If you have done everything correctly, it should output an error message complaining that something in its configuration file isn’t right.
Configuration file example¶
Take a look at the following example configuration file and read the explanatory comments that follow it:
[General] loglevel = INFO logfile = C:\Somewhere\spatialize.log mask = C:\Somewhere\mask.tif epsg = 2100 output_dir = C:\Somewhere\SpatializeOutput filename_prefix = rainfall number_of_output_files = 24 method = idw alpha = 1 files = C:\Somewhere\inputfile1.hts C:\Somewhere\inputfile2.hts C:\Somewhere\inputfile3.hts
With the above configuration file,
spatialize will log information
in the file specified by
the study area, whose co-ordinates are in the reference system
epsg. The output is GeoTIFF files in
output_dir, prefixed with
this example, the output files will be named something like
Only the most recent 24 (
files will be kept, and older ones will automatically be deleted;
these 24 files will be recreated if missing. The integration method
alpha = 1. The spatial
integration will be performed given the three time series specified in
CONFIGURATION FILE REFERENCE¶
The configuration file has the format of INI files. There is only one
Optional. Can have the values
DEBUG. The default is
Optional. The full pathname of a log file. If unspecified, log messages will go to the standard error.
A GeoTIFF file defining the study area. It must contain a single band, whose nonzero cells comprise the area.
spatializewill interpolate a value in each of these cells.
An integer specifying the co-ordinate reference system (CRS) used by
spatializewill transform the co-ordinates of the stations to that CRS before performing the integration.
Output files are GeoTIFF files placed in
output_dirand having the specified
filename_prefix. After the prefix there follows a hyphen and then the date in format YYYY-MM-DD-HH-mm, however some parts of the date may be missing; for daily time series, the hour and minutes are missing; for monthly, the date is also missing; for annual, the month is also missing.
These GeoTIFF files contain a single band with the calculated result.
The number of files to produce and keep.
spatializeperforms spatial integration for the last available timestamp, for the last-but-one, and so on, until there are
number_of_output_filesfiles (or less if the time series don’t have enough records). If any files already exist, they are not recalculated. Older files in excess of
The interpolation method. Currently only idw is allowed, but hopefully in the future there will also be kriging. If the method is idw, the parameter
alphacan optionally be specified (default 1).