File: metview_help

package info (click to toggle)
metview 5.10.2-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 242,296 kB
  • sloc: cpp: 437,117; ansic: 41,433; xml: 19,944; f90: 13,059; sh: 6,562; python: 3,953; yacc: 1,774; lex: 1,121; perl: 701; makefile: 92
file content (236 lines) | stat: -rwxr-xr-x 9,175 bytes parent folder | download | duplicates (4)
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