[Dart-dev] [7682] DART/trunk/observations/observations.html: add a section on suggestions for what existing convert to start

Tue Mar 10 09:14:05 MDT 2015

Revision: 7682
Author:   nancy
Date:     2015-03-10 09:14:01 -0600 (Tue, 10 Mar 2015)
Log Message:
-----------
add a section on suggestions for what existing convert to start
from if you need to write a new one.  usually this is based on
what file format the input observations are distributed in.

Modified Paths:
--------------
    DART/trunk/observations/observations.html

-------------- next part --------------
Modified: DART/trunk/observations/observations.html
===================================================================

--- DART/trunk/observations/observations.html	2015-03-10 00:34:55 UTC (rev 7681)
+++ DART/trunk/observations/observations.html	2015-03-10 15:14:01 UTC (rev 7682)
@@ -9,7 +9,7 @@
 <BODY>
 <A NAME="TOP"></A>
 
-<H1>Observations</H1>
+<H1>DART Observations</H1>
 
 <table border=0 summary="" cellpadding=5>
 <tr>
@@ -123,7 +123,44 @@
 See the <a href="#Programs">Programs</a> section below for a list of
 the current converter programs.
 </P>
+<P>
+If you have looked and none of the existing converters are right
+for your data, here are some suggestions for where to start creating
+a new converter.  Create a new subdirectory in the <em class=file>observations</em>
+directory.  Copy with the recursive option (<em class=code>cp -r</em>) one of
+the existing converters and adapt to your needs.  Our suggestions for which
+converter to start from depends on the format of your input observations
+to be converted.  If your input data format is:
+<DL>
+<DT>netCDF</DT><DD>Start with the <em class=file>MADIS</em> converters,
+and in particular try the <em class=file>convert_madis_profiler.f90</em>
+file because it is the most straightforward.
+</DD>
+<DT>Comma separated text</DT><DD>Start with the <em class=file>Ameriflux</em> converter.
+</DD>
+<DT>Generic text</DT><DD>Start with the <em class=file>text</em> converter.
+</DD>
+<DT>HDF-EOS</DT><DD>Start with the <em class=file>AIRS</em> converter.
+</DD>
+<DT>BUFR or prepBUFR</DT><DD>Start with the <em class=file>NCEP</em> converter.
+</DD>
+<DT>Dense data, like Satellite swaths</DT><DD>Start with the <em class=file>tpw</em> converter,
+which includes code that averages the raw data in space and time.
+</DD>
+<DT>Ray-path integrated data</DT><DD>Start with the <em class=file>GPS</em> converter,
+which includes code that traces a path and integrates values along the ray.
+</DD>
+<DT>World Ocean Database packed ASCII</DT><DD>Start with the <em class=file>WOD</em> converter.
+<DD>
 
+</DL>
+</P>
+
+
+
+<!-- FIXME: add suggested starting locations for different file
+ formats here.   -->
+
 <!--==================================================================-->
 
 <A NAME="Decisions"></A>
