Subversion Repositories lagranto.ecmwf

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 michaesp 1 
.TH mergetra
2 
.SH NAME
3 
.B mergetra -
4 
combine two trajectory files
5 
.SH SYNOPSIS
6 
.B mergetra
7 
.I inpfile1
8 
.I inpfile2
9 
.I outfile
10 
.SH DESCRIPTION
11 
Combines two input trajectory files "inpfile1" and "inpfile2" and writes a new combined trajectory file "outfile". Three different modes for combination are supported (see below).
12 
.SH PARAMETERS
13 
.TP 15
14 
.I inpfile1
15 
first input trajectory file
16 
.TP 15
17 
.I inpfile2
18 
second input trajectory file
19 
.TP 15
20 
.I outfile
21 
output trajectory file
22 
.SH MODES FOR COMBINATION
23 
Three different combination modes are supported. They are tested for sequentially and the first mode which is accepted, based on the criteria listed below, is performed. The three modes are:
24 
.TP 5
25 
.B - column
26 
The input files have the same trajectory times, longitudes, latitudes and pressures, and both files contain the same number of trajectories. The new trajectory file contains all columns from both input files, duplicate columns only included once, e.g. if "inpfile1" has columns "time,lon,lat,p,TH,PV" and "inpfile2" columns "time,lon,lat,p,PV,Q", the output file will have "time,lon,lat,p,TH,PV,Q".
27 
.TP 5
28 
.B - append
29 
The input files have the same trajectory times and the same columns, but differ in the number of trajectories. Then the second file is appended to the first one and written as a new trajectory file.
30 
.TP 5
31 
.B - times
32 
The input files differ only in the time values, e.g. the first file might contain times -96 h to 0 h and the second the times from 0 h to 96 hours. Then the new combined file will contain the time -96 h to 96 h. Note that duplicate times are eliminated. Furthermore, the output times are sorted in increasing order.
33 
.SH EXAMPLES
34 
.TP 5
35 
.B [1] mergetra file1 file2 newfile
36 
combines the two trajectory files "file1" and "file2" and writes a new trajectory file; the mode for combination is automatically detected.
37 
.SH AUTHOR
38 
Written by Michael Sprenger and Heini Wernli (January 2011)