[Dart-dev] [4917] DART/trunk/obs_sequence/obs_seq_to_netcdf.html: suggested improvements by kevin
nancy at ucar.edu
nancy at ucar.edu
Wed May 25 13:36:25 MDT 2011
Revision: 4917
Author: nancy
Date: 2011-05-25 13:36:25 -0600 (Wed, 25 May 2011)
Log Message:
-----------
suggested improvements by kevin
Modified Paths:
--------------
DART/trunk/obs_sequence/obs_seq_to_netcdf.html
-------------- next part --------------
Modified: DART/trunk/obs_sequence/obs_seq_to_netcdf.html
===================================================================
--- DART/trunk/obs_sequence/obs_seq_to_netcdf.html 2011-05-25 17:48:51 UTC (rev 4916)
+++ DART/trunk/obs_sequence/obs_seq_to_netcdf.html 2011-05-25 19:36:25 UTC (rev 4917)
@@ -88,19 +88,18 @@
<br />
<br />
<em class=new>The dependence on the <em class=file>threed_sphere/location_mod.f90</em>
- has been removed. This program will soon be available to any conforming
+ has been removed. This program will work with any
<em class=file>location_mod.f90</em>.</em> Also, this program no longer tries
to construct 'wind' observations from horizontal components since the program really
should be faithful to preserving exactly what is in the input file. i.e. We're not
making stuff up.
<br />
<br />
- There are more Matlab scripts in the works ... keep an eye out for a
- <em class=program>link_obs.m</em> script that will create several linked
+ There are several Matlab scripts that understand how to read and plot
+ observation data in netcdf format. See the
+ <em class=program>link_obs.m</em> script that creates several linked
figures with the ability to 'brush' data in one view and have those selected
- data (and attributes) get highlighted in the other views. There are still
- a couple nuances to the figures that I'd like to get right before I release it
- for general consumption -- Tim.
+ data (and attributes) get highlighted in the other views.
</P>
<!--==================================================================-->
@@ -112,7 +111,6 @@
<H2>NAMELIST</H2>
<P>We adhere to the F90 standard of starting a namelist with an ampersand
'&' and terminating with a slash '/' for all our namelist input.
-The declarations have a different syntax, naturally.
</P>
<div class=namelist>
<pre>
@@ -150,25 +148,25 @@
everything to the right, and a directory structure to the left.
The directory structure is then queried to see if it can be
incremented to handle a sequence of observation files.
- The default behavior of <em class="program">obs_diag</em>
+ The default behavior of <em class="program">obs_seq_to_netcdf</em>
is to look for additional files to include until the files
are exhausted or an <em class=file>obs_seq.final</em> file
is found that contains observations beyond the timeframe of
interest.<BR>e.g. 'obsdir_001/obs_seq.final' will cause
- <em class="program">obs_diag</em> to look for
+ <em class="program">obs_seq_to_netcdf</em> to look for
'obsdir_002/obs_seq.final', and so on.
<br />
- If this is specified, 'obs_sequence_list' must be set to ''.
+ If this is specified, 'obs_sequence_list' must be set to ' '.
Default 'obs_seq.final'</TD></TR>
<TR><!--contents--><TD valign=top> obs_sequence_list </TD>
<!-- type --><TD valign=top> character(len=129) </TD>
<!--descript--><TD>Name of an ascii text file which contains a list
of one or more observation sequence files, one per line.
- If this is specified, 'obs_sequence_name' must be set to ''.
+ If this is specified, 'obs_sequence_name' must be set to ' '.
Can be created by any method, including sending the output
of the 'ls' command to a file, a text editor, or another program.
- Default '' - and empty string.</TD></TR>
+ Default ' ' (an empty string).</TD></TR>
<TR><!--contents--><TD valign=top> append_to_netcdf </TD>
<!-- type --><TD valign=top> logical </TD>
@@ -182,12 +180,12 @@
<TR><!--contents--><TD valign=top> lonlim1 </TD>
<!-- type --><TD valign=top> real </TD>
- <!--descript--><TD>Westernmost longitude of the region.<BR>
+ <!--descript--><TD>Westernmost longitude of the region in degrees.<BR>
Default: none </TD></TR>
<TR><!--contents--><TD valign=top> lonlim2 </TD>
<!-- type --><TD valign=top> real </TD>
- <!--descript--><TD>Easternmost longitude of the region.
+ <!--descript--><TD>Easternmost longitude of the region in degrees.
<em class="new">If this value is <b>less than</b>
the westernmost value, it defines a region that spans the
prime meridian. No problem.</em> It is perfectly acceptable
@@ -197,12 +195,12 @@
<TR><!--contents--><TD valign=top> latlim1 </TD>
<!-- type --><TD valign=top> real </TD>
- <!--descript--><TD>Southernmost latitude of the region.<BR>
+ <!--descript--><TD>Southernmost latitude of the region in degrees.<BR>
Default: none</TD></TR>
<TR><!--contents--><TD valign=top> latlim2 </TD>
<!-- type --><TD valign=top> real </TD>
- <!--descript--><TD>Northernmost latitude of the region.<BR>
+ <!--descript--><TD>Northernmost latitude of the region in degrees.<BR>
Default: none</TD></TR>
<TR><!--contents--><TD valign=top> verbose </TD>
@@ -427,7 +425,7 @@
</UL>
<H3 class="indent1">Related Matlab functions</H3>
<UL><LI><em class="file">diagnostics/matlab/read_obs_netcdf.m</em>
- reads the netcdf files and returns an structure with easy-to-plot
+ reads the netcdf files and returns a structure with easy-to-plot
components. More on that in the 'Usage' section below.
</LI>
<LI><em class="file">diagnostics/matlab/plot_obs_netcdf.m</em> may
@@ -577,7 +575,8 @@
<H3 class="indent1">obs_seq_to_netcdf</H3>
<P>
<em class="program">obs_seq_to_netcdf</em> is built and run in
-<em class="file">/DART/observations/utilities/threed_sphere</em>
+<em class="file">/DART/observations/utilities/threed_sphere</em> or
+<em class="file">/DART/observations/utilities/oned</em> or
in the same way as the other DART components. That directory is
intentionally designed to hold components that are model-insensitive.
Essentially, we avoid having to populate every <em class="file">model</em>
@@ -585,11 +584,9 @@
<em class="file">path_names_obs_seq_to_netcdf</em> files. After the program has been run,
<em class="file">/DART/observations/utilities/threed_sphere/</em><em
class="program">plot_obs_netcdf.m</em> can be run to plot the observations.
-The only thing that is tricky is the fact that the table of known
-observation types in the netCDF file is not pruned down to reflect the
-contents of the netCDF file. As a consequence, a dump of <em
-class="code">ObsObsTypesMetaData</em> might lead you to try to plot
-observation types that do not exist in the file. Stay tuned.
+Be aware that
+the <em class="code">ObsTypesMetaData</em> list is all known observation
+types and not only the observation types in the netCDF file.
<br />
<H4 class="indent1">example</H4>
<div class="routine">
More information about the Dart-dev
mailing list