| 3 |
michaesp |
1 |
.TH extract
|
|
|
2 |
.SH extract
|
|
|
3 |
.B extract - extract columns, times, single trajectories and starting positions
|
|
|
4 |
.SH SYNOPSIS
|
|
|
5 |
.B extract
|
|
|
6 |
.I inptra
|
|
|
7 |
.I outtra
|
|
|
8 |
.I mode
|
|
|
9 |
.SH DESCRIPTION
|
|
|
10 |
Extract columns, times, single trajectories or starting positions from an input trajectory file
|
|
|
11 |
.I inptra
|
|
|
12 |
and write output to a new trajectory file
|
|
|
13 |
.I outtra.
|
|
|
14 |
The different extraction modes are specified with
|
|
|
15 |
.I mode.
|
|
|
16 |
Note: the time, longitude, latitude and pressure need not be extracted beacuse they are an integral part of every trajectory file - they are extracted by default.
|
|
|
17 |
.SH EXTRACTION MODE
|
|
|
18 |
.TP 5
|
|
|
19 |
.B -var
|
|
|
20 |
extract columns of a trajectory file; the columns can be listed by name (e.g. -var TH PV RH) or a range of columns can be specified by the "to" operator (e.g. -var TH to PV). The two modes can also be combined: "-var TH to PV RH" extracts all columns between TH and PV, and additionally RH.
|
|
|
21 |
.TP 5
|
|
|
22 |
.B -time
|
|
|
23 |
extract trajectory times; the times can be given as a list of times (e.g. -time 6 12) or as a time range (e.g. -time 6 to 18).
|
|
|
24 |
.TP 5
|
|
|
25 |
.B -tra
|
|
|
26 |
extract single trajectories; the index of the trajectories can be specified as a list (e.g. -tra 10 12 14) or as a range of trajectories (e.g. -tra 10 to 20).
|
|
|
27 |
.TP 5
|
|
|
28 |
.B -startf
|
|
|
29 |
extract list (longitude, latitude, pressure) of starting positions ofvthe trajectory file (corresponding to time 0).
|
|
|
30 |
.TP 5
|
|
|
31 |
.B -index
|
|
|
32 |
extract single trajectories - the trajectory indices (from 1 to #trajectories) are given on a file (e.g. -index filename).
|
|
|
33 |
.TP 5
|
|
|
34 |
.B -boolean
|
|
|
35 |
extract single trajectories - the trajectory are specified on a boolean (0/1) file (e.g. -boolean filename).
|
|
|
36 |
.TP 5
|
|
|
37 |
.B -pattern
|
|
|
38 |
extract all trajectories which match the pattern given; the pattern is a list of numbers. It is then checked whether
|
|
|
39 |
these numbers occur in a trajectory (all at one time).
|
|
|
40 |
.SH EXAMPLES
|
|
|
41 |
.TP 5
|
|
|
42 |
.B [1] extract inptra outtra -time 6 to 36 72
|
|
|
43 |
read input trajectory file "inptra", extract times 6 to 36 and additionally time 72, and write output to trajectory file "outtra".
|
|
|
44 |
.TP 5
|
|
|
45 |
.B [2] extract inptra outtra -index indfile
|
|
|
46 |
reads input trajectories from "inptra" and write all trajectories to "outtra" which are listed in the file "indfile". In "infile" the indices of selected trajectories are listed line-by-line.
|
|
|
47 |
.TP 5
|
|
|
48 |
.B [3] extract inptra outtra -pattern -999.99
|
|
|
49 |
extracts all trajectories which have a missing data (-999.99) entry.
|
|
|
50 |
.TP 5
|
|
|
51 |
.B [4] extract inptra outtra -pattern 0.00 -44.25 -28.47 140
|
|
|
52 |
extracts all trajectories which have the numbers '0.00 -44.25 -28.47 140' in their list. This options
|
|
|
53 |
is convenient to search for specific times and positions, and then to see the complete trajectory.
|
|
|
54 |
.SH AUTHOR
|
|
|
55 |
Written by Michael Sprenger and Heini Wernli (January 2011)
|