4. Usage

cookie-cutter [-i orbital_inclination] [-T orbital_period] [-w extraction_width] ascending_node_file input_directory output_file

Option arguments

orbital_inclination

The orbital inclination of the heliosynchronous satellite ; must be given in degrees (90° corresponds to a polar orbit). Default : 98.2° (A-Train value)

orbital_period

The orbital period of the heliosynchronous satellite ; must be given in minutes. Default : 98.88 minutes (A-Train value)

extraction_width

The width of extraction of SEVIRI data, around the heliosynchronous satellite track, in degrees of longitude at the equator. Default : 10°

Mandatory arguments

ascending_node_file

This is a three-columns formatted text file, containing the dates, hours and longitudes of the sun-synchronous ascending orbit nodes. For example, here is a file containing these infos for the satellite PARASOL, the 1st of june 2005:


2005-06-01 01:07:50     184.1
2005-06-01 02:46:43     159.38
2005-06-01 04:25:36     134.66
2005-06-01 06:04:29     109.94
2005-06-01 07:43:23     85.22
2005-06-01 09:22:16     60.5
2005-06-01 11:01:09     35.78
2005-06-01 12:40:02     11.06
2005-06-01 14:18:55     346.34
2005-06-01 15:57:48     321.62
2005-06-01 17:36:41     296.9
2005-06-01 19:15:34     272.18
2005-06-01 20:54:27     247.46
2005-06-01 22:33:20     222.74
Comments (beginning with #) and empty lines are currently forbidden in this text file, but might be supported in a future release.

input_directory

The directory containing the XRIT input files, in the SATMOS archive format (see Appendix A). For example:


[user@hostname SATMOS-20050601]$ pwd
/path/to/data/seviri/SATMOS-20050601
[user@hostname SATMOS-20050601]$ ls
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010000
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010015
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010030
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010045
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010100
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010115
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010130
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010145
H-000-MSG1__-MSG1________-IR016____-CYCLE____-200506010200
[...]
Note that these are not the original files diffused by EUMETSAT, but files derived from them by grouping all the segments of the same channel. We'll call it the SATMOS archive format and provide a tool to convert the EUMETSAT archive format into the SATMOS archive format. See the appendix for more details.

output_file

The name under which the output product will be saved. In fact two files will be created: an HDF file and a PPM file (an image file). Extensions .hdf and .ppm will be added automatically. A path may be specified but only the parent directory of the output file will be created if necessary. Otherwise an error will occur (for example if the parent of the parent doesn't exist). This behavior may change in the future, don't rely on it. You should always ensure that the parent directory already exists.