Subversion Repositories lagranto.icon

.TH mergetra

.SH NAME 

.B mergetra - 

combine two trajectory files

.SH SYNOPSIS 

.B mergetra

.I inpfile1

.I inpfile2

.I outfile

.SH DESCRIPTION

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).

.SH PARAMETERS

.TP 15

.I inpfile1

first input trajectory file

.TP 15

.I inpfile2

second input trajectory file

.TP 15

.I outfile

output trajectory file

.SH MODES FOR COMBINATION

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:

.TP 5

.B - column

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". 

.TP 5

.B - append

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.

.TP 5

.B - times

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.

.SH EXAMPLES

.TP 5

.B [1] mergetra file1 file2 newfile

combines the two trajectory files "file1" and "file2" and writes a new trajectory file; the mode for combination is automatically detected.

.SH AUTHOR

Written by Michael Sprenger and Heini Wernli (January 2011)