1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
#!/bin/sh
# **************************** LICENSE START ***********************************
#
# Copyright 2014 ECMWF and INPE. This software is distributed under the terms
# of the Apache License version 2.0. In applying this license, ECMWF does not
# waive the privileges and immunities granted to it by virtue of its status as
# an Intergovernmental Organization or submit itself to any jurisdiction.
#
# ***************************** LICENSE END ************************************
#
cat <<HEND
_________________________________________________________________________
$METVIEW_VERSION_TITLE @ `hostname`
_________________________________________________________________________
Environment variables that have an effect on Metview and its underlying
ECMWF libraries:
[current value in brackets; empty brackets = internal default value used]
EmosLib
--------------------------------------------------------------------------
BUFR_TABLES BUFR tables directory
[$BUFR_TABLES]
PPDIR path to Spectral-to-Grid conversion coefficients
[$PPDIR]
EMOS_CYCLE change Emoslib version number - use with care!
[$EMOS_CYCLE]
MARS
--------------------------------------------------------------------------
MARS_LSM_PATH path to Land-Sea-Mask files
[$MARS_LSM_PATH]
MARS_REFERENCE_DATE set a custom reference date for relative dates
[$MARS_REFERENCE_DATE]
MARS_AUTO_RESOL Spectral->Grid conversion auto resolution
[$MARS_AUTO_RESOL]
MARS_NOFORK disable forking in parent modules when it is set to 1
[$MARS_NOFORK]
MARS_MAXFORKS max nro of forked processes from a parent module
[$MARS_MAXFORKS]
MARS_PACK_BITS number of bits to be used in encoding new GRIB messages
[$MARS_PACK_BITS]
MARS_COMPUTE_FLAG assign 0 to conserve GRIB 'generating process' octet
[$MARS_COMPUTE_FLAG]
MARS_DEBUG triggers all modules to print lots of extra debug info
[$MARS_DEBUG]
METVIEW_MARS_INTERP set the default interpolation package (MIR or EMOS) used for MARS requests and DivRot
[$METVIEW_MARS_INTERP]
GRIB handling
--------------------------------------------------------------------------
METVIEW_GRIB_DUMP path to the grib_dump utility program
[$METVIEW_GRIB_DUMP]
METVIEW_EXTRA_GRIB_DEFINITION_PATH path to additional GRIB definitions to the
ones used internally by Metview.
[$METVIEW_EXTRA_GRIB_DEFINITION_PATH]
Macro Editing
--------------------------------------------------------------------------
METVIEW_MACRO_EDITOR primary Macro external editor candidate
[$METVIEW_MACRO_EDITOR]
EDITOR secondary Macro external editor - for fallback only
[$EDITOR]
Inline Fortran/C
--------------------------------------------------------------------------
MACRO_EXTRA_LIBS to provide extra linking flags for inlined programs
[$MACRO_EXTRA_LIBS]
MACRO_EXTRA_INCS to provide extra include flags for inlined C/C++ programs
[$MACRO_EXTRA_INCS]
MACRO_EXTRA_F77_FLAGS to provide extra compiler flags for inlined F77 programs
[$MACRO_EXTRA_F77_FLAGS]
MACRO_EXTRA_F90_FLAGS to provide extra compiler flags for inlined F90 programs
[$MACRO_EXTRA_F90_FLAGS]
MACRO_EXTRA_CC_FLAGS to provide extra compiler flags for inlined C/C++ programs
[$MACRO_EXTRA_CC_FLAGS]
MACRO_DELETE_TEMPORARIES to force deleting more temporary files than normally;
use with care and only when your macro overflows the
available cache file system quota; in some cases files
that might be needed later will also be deleted!
[$MACRO_DELETE_TEMPORARY_FILES]
System
--------------------------------------------------------------------------
MV_BATCH_NOABORT set to restore old behaviour not-to-signal-exit-status
[$MV_BATCH_NOABORT]
METVIEW_TIMEOUT idle time for unused Metview modules before they exit
[$METVIEW_TIMEOUT]
METVIEW_LOCALHOST helps to get Event started in some network config cases; 0 to disable
[$METVIEW_LOCALHOST]
DISPLAY X11 display that interactive Metview runs in
[$DISPLAY]
METVIEW_GRAPHICS_SYSTEM set the default graphics backend for Qt-based applications
in Metview. The possible values are 'raster' and 'native'.
[$METVIEW_GRAPHICS_SYSTEM]
METVIEW_WALL_URL set the URL for the 'export to Weather Room' functionality.
This will override the default setting.
[$METVIEW_WALL_URL]
METVIEW_WALL_TOKEN set the token for the 'export to Weather Room' functionality.
This will override the default setting.
[$METVIEW_WALL_TOKEN]
Viewers
--------------------------------------------------------------------------
MV_BROWSER_NAME WEB browser to view function/icon documentation from Code Editor
[$MV_BROWSER_NAME]
METVIEW_PS_VIEWER external application to view PostScript icons
[$METVIEW_PS_VIEWER]
METVIEW_PDF_VIEWER external application to view PDF icons
[$METVIEW_PDF_VIEWER]
METVIEW_PNG_VIEWER external application to view PNG icons
[$METVIEW_PNG_VIEWER]
METVIEW_JPEG_VIEWER external application to view JPEG icons
[$METVIEW_JPEG_VIEWER]
METVIEW_GIF_VIEWER external application to view GIF icons
[$METVIEW_GIF_VIEWER]
METVIEW_KML_VIEWER external application to view KML icons
[$METVIEW_KML_VIEWER]
METVIEW_RASTER_EDITOR external application to edit raster images
[$METVIEW_RASTER_EDITOR]
FLEXTRA
--------------------------------------------------------------------------
MV_FLEXTRA_EXE path to the executable of the FLEXTRA trajectory model
[$MV_FLEXTRA_EXE]
FLEXPART
--------------------------------------------------------------------------
MV_FLEXPART_EXE path to the executable of the FLEXPART Lagrangian dispersion model
[$MV_FLEXPART_EXE]
MV_FLEXPART_RESOURCES path to the parameter files needed for FLEXPART
[$MV_FLEXPART_RESOURCES]
MV_FLEXPART_SPECIES path to the species files for FLEXPART
[$MV_FLEXPART_SPECIES]
SCM
--------------------------------------------------------------------------
MV_SCM_EXE path to the executable of the Single Column Model
[$MV_SCM_EXE]
VAPOR
--------------------------------------------------------------------------
MV_VAPOR_BIN path to the bin directory of the VAPOR 3D visualisation system
[$MV_VAPOR_BIN]
Other
--------------------------------------------------------------------------
MV_GENERATING_PROCESS custom value used when converting an LLMatrix to GRIB
[$MV_GENERATING_PROCESS]
METVIEW_TMPDIR current Metview cache directory
[$METVIEW_TMPDIR]
MVNEWSMAIL primary mail location for Metview News
[$MVNEWSMAIL]
MAIL secondary mail location for Metview News
[$MAIL]
SCRATCH interactive run-time working dir, batch job log dir
[$SCRATCH]
MV_DEBUG_PRINT triggers all modules to print some more debug info
[$MV_DEBUG_PRINT]
MV_SCRIPT_DEBUG triggers this script to print executed commands
[$MV_SCRIPT_DEBUG]
_________________________________________________________________________
Metview command flags:
Common flags:
-u dir use/create 'dir' as Metview user directory (main Metview folder)
-nocreatehome suppresses creation of Metview user directory for batch jobs
-q quiet - suppress warnings about other Metview runtime dirs found
-v print Metview version, last Metview update date, and current host
-H print this help text and start Metview
-h print this help text and exit
Interactive usage specific flags:
-display dis set \$DISPLAY temporarily to 'dis'
-F use bigger fonts for big audience
-mfdbg dbgr run your external Macro Functions (Fortran/C/C++) under debugger 'dbgr'
-wr enable export of plots to the Weather Room screens (only at ECMWF)
-fs set default fontsize (in points) for the user interface
Data examiner flags:
-e type path examine the given file
'type' can be grib, bufr or odb
e.g. metview -e grib /path/to/grib
Plotting flags:
-p path plot the given file
e.g. metview -p /path/to/grib
Batch mode specific flags:
-b mname run macro mname in batch mode
(-b must be the last Metview flag!)
-b mname p1 p2... as above, p1 p2... are parameters for the macro
Log related flags:
-slog "Single Log" - combines output from all modules into
standard output (longer log)
-qlog "Quiet Log" - as -slog, but only error messages are
printed (shorter log)
-mlog "Mars Log" - as -qlog, but all MARS retrieval messages
are printed (shortish log)
Note: You can increase the amount of log information with environment variables
MARS_DEBUG, MV_DEBUG_PRINT, MV_SCRIPT_DEBUG, JDCNDBG (see above)
Old log related flags:
-log multiple log files into \$SCRATCH/default_log.<module>.log
(longest logs)
-log logid multiple log files into \$SCRATCH/'logid'.<module>.log
(longest logs)
Development-only flags:
-edbg dbgr start debugger 'dbgr' instead of central module Event
(for solving development/installation problems)
-xserv in "dev" mode starts xserv instead of Desktop by default
HEND
|
