-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME_License-UserGuide.htm
220 lines (168 loc) · 9.34 KB
/
README_License-UserGuide.htm
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
<html>
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=Generator content="Microsoft Word 15 (filtered)">
<style>
<!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin-top:0in;
margin-right:0in;
margin-bottom:8.0pt;
margin-left:0in;
line-height:107%;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{color:#954F72;
text-decoration:underline;}
p.MsoNoSpacing, li.MsoNoSpacing, div.MsoNoSpacing
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
.MsoChpDefault
{font-family:"Calibri",sans-serif;}
.MsoPapDefault
{margin-bottom:8.0pt;
line-height:107%;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
-->
</style>
</head>
<body lang=EN-US link="#0563C1" vlink="#954F72">
<div class=WordSection1>
<p class=MsoNoSpacing><span lang=EN-GB>INTRODUCTION</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>This ARL meteorological profile
conversion software (ARL_MET-profile_Converter version 1.0.0) is designed to
aid in the analysis of meteorological model output and various types of
measured soundings such as radiosonde observations. Input and output samples
may be found in the sub-directory ‘Input_Output_Samples’.</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The software produces profiles of
meteorological variables for levels and layers as defined by user input height
or pressure levels. It can process input profiles from sensing systems such as
radiosonde, lidar, or wind profiling radar, and from profiles derived from
numerical weather model output such as from the Weather Research and
Forecasting model. Some changes to the input routine may be required for
different input types and formats, and in a few cases modest changes in one or
more other routines may be needed. </span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>LICENSE</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>This software is covered by the ARL CC0
1.0 Universal (CC0_1.0) Public Domain Dedication and the Contributor License
Agreement (CLA) available at the ARL GitHub site (<a
href="https://github.com/USArmyResearchLab/ARL-Open-Source-Guidance-and-Instructions">https://github.com/USArmyResearchLab/ARL-Open-Source-Guidance-and-Instructions</a>).
</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>DESCRIPTION </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The software has two primary types. One
produces height based level and layer output and the other pressure based level
and layer output. For Weather Research and Forecasting (WRF) model derived
atmospheric profiles each type uses a common input routine. For radiosonde
observation (RAOB) soundings from the University of Wyoming weather web site
each type of software has a common input routine. For RAOBs from the NOAA
archive site each type has a common input routine. In addition to the input
routine, use of RAOB data from the NOAA archive required a modification to one
other routine. The total number of executables is 6 as of June 2017. </span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>COMPILATION</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The software is written in standard
ASCII “C” and should compile on a wide variety of systems. It may be compiled
via a simple command using a file that contains the necessary compile code; it
uses the standard GNU "C" compiler supplied with many operating
systems. For example, ccmsg_wyo compiles the code for height based level and
layer output from a RAOB obtained from the University of Wyoming website producing
the executable convertwyo. The code for this example follows:</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>gcc -g -lm -o convertwyo
convertdatawyo.c msgvalues.c initdata.c \</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>level.c layer.c clean_data.c
tvfromtemp.c prscomp.c readwyo.c \</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>writeusrmsg.c writeusrlvls.c checkdata.c</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The other executables have similar
compile codes. The other executables are:</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>convertwrf - produces height based level
and layer output from soundings derived from WRF output,</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>convertnoaa - produces height based
level and layer output from NOAA archive RAOBs,</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>convertprswyo - produces pressure based
level and layer output from the University of Wyoming RAOBs,</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>convertprswrf - produces pressure based
level and layer output from soundings derived from WRF output,</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>convertprsnoaa - produces pressure based
level and layer output from NOAA archive RAOBs,</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>OPERATION</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The 6 programs require a
"lvls" file where lvls is the last part of the name of the file
containing the user supplied height or pressure levels (usrhgt_lvls or usrprs_lvls).
They also need a parameter file (i.e. input_parameters) with the paths of the
input and output directories. They may be the same or different, but both need
to be listed. Here we present the procedures to use the programs once the
lvls and input_parameters files are in place. Those files should be in the
same directory as the executable. Sample versions of the _lvls and
input_paramters files are included in the same directory as the source code
files.</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>1. Height based method:</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For RAOBs from the U of Wyoming
type and return the command line ./convertwyo 'input file name' (e.g.,
./convertwyo RAOB_ABC_20140520).</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For RAOBs from the NOAA archive
type and return the command line ./convertnoaa 'input file name' (e.g., ./convertnoaa
RAOB_XYZ_20140520). </span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For WRF generated soundings type
and return the command line ./convertwrf 'input file name' (e.g., ./convertwrf
WRF_ABC_20140520).</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>2. Pressure based method:</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For RAOBs from the U of Wyoming
type and return the command line ./convertprswyo 'input file name' (e.g.,
./convertprswyo RAOB_ABC_20140520).</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For RAOBs from the NOAA archive
type and return the command line ./convertprswyo 'input file name' (e.g.,
./convertprsnoaa RAOB_XYZ_20140520).</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> For WRF generated soundings type
and return the command line ./convertprswrf 'input file name' (e.g.,
./convertprswrf WRF_ABC_20140520).</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>ADDITIONAL COMMENTS</span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The programs have run on both Linux and
Windows operating systems. For use with the Windows "Command Prompt"
and some Linux systems the "./" before the executable is not used.
For example, the syntax for an instance of the convertwrf program could be
convertwrf WRF_ABC_2016050512 vs. ./convertwrf WRF_ABC_2016050512.</span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>The function checkdata (file name =
checkdata.c) allows the user to check the input or output data at an
intermediate stage. At present it's commented out where it appears. To
activate "uncomment" it, or if not at a specific location in the code
add as appropriate. To stop the program after the use of checkdata add the
statement "exit(0);" immediately afterwards. The output appears in
the file “datacheck” and has some, but not all, variables normally in the
output data structure. A sample may be found in the directory with the
source code. </span></p>
<p class=MsoNoSpacing><span lang=EN-GB> </span></p>
<p class=MsoNoSpacing><span lang=EN-GB>Based on user experiences at ARL, a
technically trained person with no previous knowledge of any of the programs
should be able to run it within 5 to 10 min.</span></p>
</div>
</body>
</html>