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 14
1
.TH extract
1
.TH extract
2
.SH extract
2
.SH extract
3
.B extract - extract columns, times, single trajectories and starting positions 
3
.B extract - extract columns, times, single trajectories and starting positions 
4
.SH SYNOPSIS
4
.SH SYNOPSIS
5
.B extract 
5
.B extract 
6
.I inptra
6
.I inptra
7
.I outtra
7
.I outtra
8
.I mode
8
.I mode
9
.SH DESCRIPTION
9
.SH DESCRIPTION
10
Extract columns, times, single trajectories or starting positions from an input trajectory file 
10
Extract columns, times, single trajectories or starting positions from an input trajectory file 
11
.I inptra
11
.I inptra
12
and write output to a new trajectory file
12
and write output to a new trajectory file
13
.I outtra. 
13
.I outtra. 
14
The different extraction modes are specified with 
14
The different extraction modes are specified with 
15
.I mode.
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.
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 
17
.SH EXTRACTION MODE 
18
.TP 5
18
.TP 5
19
.B -var
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.
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
21
.TP 5
22
.B -time 
22
.B -time 
23
extract trajectory times; the times cna be given as a list of times (e.g. -time 6 12) or as a time range (e.g. -time 6 to 18). 
23
extract trajectory times; the times cna 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
24
.TP 5
25
.B -tra
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).
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
27
.TP 5
28
.B -startf
28
.B -startf
29
extract list (longitude, latitude, pressure) of starting positions ofvthe trajectory file (corresponding to time 0).
29
extract list (longitude, latitude, pressure) of starting positions ofvthe trajectory file (corresponding to time 0).
30
.TP 5
30
.TP 5
31
.B -index
31
.B -index
32
extract single trajectories - the trajectory indices (from 1 to #trajectories) are given on a file (e.g. -index filename).
32
extract single trajectories - the trajectory indices (from 1 to #trajectories) are given on a file (e.g. -index filename).
33
.TP 5
33
.TP 5
34
.B -boolean
34
.B -boolean
35
extract single trajectories - the trajectory are specified on a boolean (0/1) file (e.g. -boolean filename).
35
extract single trajectories - the trajectory are specified on a boolean (0/1) file (e.g. -boolean filename).
36
.SH EXAMPLES
36
.SH EXAMPLES
37
.TP 5
37
.TP 5
38
.B [1] extract inptra outtra -time 6 to 36 72
38
.B [1] extract inptra outtra -time 6 to 36 72
39
read input trajectory file "inptra", extract times 6 to 36 and additionally time 72, and write output to trajectory file "outtra".
39
read input trajectory file "inptra", extract times 6 to 36 and additionally time 72, and write output to trajectory file "outtra".
40
.TP 5
40
.TP 5
41
.B [2] extract inptra outtra -index indfile
41
.B [2] extract inptra outtra -index indfile
42
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.
42
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.
43
.SH AUTHOR
43
.SH AUTHOR
44
Written by Michael Sprenger and Heini Wernli (January 2011)
44
Written by Michael Sprenger and Heini Wernli (January 2011)