Subversion Repositories lagranto.um

Rev

Rev 3 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 3 Rev 12
1 
.TH mergetra
 1 
.TH mergetra
2 
.SH NAME
2 
.SH NAME
3 
.B mergetra -
3 
.B mergetra -
4 
combine two trajectory files
 4 
combine two trajectory files
5 
.SH SYNOPSIS
5 
.SH SYNOPSIS
6 
.B mergetra
 6 
.B mergetra
7 
.I inpfile1
 7 
.I inpfile1
8 
.I inpfile2
 8 
.I inpfile2
9 
.I outfile
 9 
.I outfile
10 
.SH DESCRIPTION
 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).
 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
 12 
.SH PARAMETERS
13 
.TP 15
 13 
.TP 15
14 
.I inpfile1
 14 
.I inpfile1
15 
first input trajectory file
 15 
first input trajectory file
16 
.TP 15
 16 
.TP 15
17 
.I inpfile2
 17 
.I inpfile2
18 
second input trajectory file
 18 
second input trajectory file
19 
.TP 15
 19 
.TP 15
20 
.I outfile
 20 
.I outfile
21 
output trajectory file
 21 
output trajectory file
22 
.SH MODES FOR COMBINATION
 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:
 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
 24 
.TP 5
25 
.B - column
 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".
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
 27 
.TP 5
28 
.B - append
 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.
 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
 30 
.TP 5
31 
.B - times
 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.
 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
 33 
.SH EXAMPLES
34 
.TP 5
 34 
.TP 5
35 
.B [1] mergetra file1 file2 newfile
 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.
 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
 37 
.SH AUTHOR
38 
Written by Michael Sprenger and Heini Wernli (January 2011)
 38 
Written by Michael Sprenger and Heini Wernli (January 2011)