[Dart-dev] DART/branches Revision: 12571

[dart at ucar.edu]

nancy at ucar.edu
2018-05-03 09:20:58 -0600 (Thu, 03 May 2018)
532
updates to the scripts used to convert gps radio occultation
and gps ionospheric observations to dart obs_seq format.

renamed some existing scripts to be more clear about
what they do, and added some examples of how to run
long series of conversion days.  also added the scripts
i used to convert ionospheric obs (ionPrf data) to
obs_seq format.  these are also committed to the
openggcm branch so if/when we merge, this will already
exist on the rma_trunk.

the batch functions run on cheyenne and have
sections for PBS and LSF.




Modified: DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/README
===================================================================
--- DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/README	2018-05-03 15:11:57 UTC (rev 12570)
+++ DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/README	2018-05-03 15:20:58 UTC (rev 12571)
@@ -4,64 +4,12 @@
 #
 # DART $Id$
 
-Description of the scripts provided to process the COSMIC and 
-CHAMP GPS radio occultation data.
+The instructions for how to do large numbers of file conversions
+have been moved to the gps.html file one directory up from here.
 
-Summary of workflow:  
-1) cd to the ../work directory and run ./quickbuild.csh to compile everything.  
-2) Edit ./gpsro_to_obsseq.csh once to set the directory where the DART
-    code is installed, and your CDAAC web site user name and password.
-3) Edit ./do_convert.csh to set the days of data to download/convert/remove.
-4) Run ./do_convert.csh
-5) For additional days repeat steps 3 and 4.
+It describes the scripts here and how they are intended to be used.
 
 
-More details:
-
-1) quickbuild.csh:
-
-Make sure your $DART/mkmf/mkmf.template is one that matches the
-platform and compiler for your system.  It should be the same as
-how you have it set to build the other DART executables.
-
-Run quickbuild.csh and it should compile all the executables needed
-to do the GPS conversion into DART obs_sequence files.
-
-
-2) gpsro_to_obsseq.csh:
-
-Edit gpsro_to_obsseq.csh once to set the DART_DIR to where you have
-downloaded the DART distribution.  (There are a few additional options
-in this script, but the distribution version should be good for most users.)
-If you are downloading data from the CDAAC web site, set your
-web site user name and password.  After this you should be able to 
-ignore this script.
-
-
-3) do_convert.csh:
-
-A wrapper script that calls the converter script a day at a time.
-Set the days of data you want to download/convert/remove.  See the
-comments at the top of this script for the various options to set.  
-Rerun this script for all data you need.  This script depends on
-the advance_time executable, which should automatically be built
-in the ../work directory, but you may have to copy or link to a
-version from this dir.  you also need a minimal input.nml here:
-
-&utilities_nml
- /
-
-is all the contents it needs.
-
-
-
-It can be risky to use the automatic delete/cleanup option - if there are
-any errors in the script or conversion (file system full, bad file format,
-etc) and the script doesn't exit, it can delete the input files before 
-the conversion has succeeded.  But if you have file quota concerns
-this allows you to keep the total disk usage lower.
-
-
 # <next few lines under version control, do not edit>
 # $URL$
 # $Revision$

Copied: DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/convert_afew_gpsro.csh (from rev 12570, DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/convert_script.csh)
===================================================================
--- DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/convert_afew_gpsro.csh	                        (rev 0)
+++ DART/branches/rma_trunk/observations/obs_converters/gps/shell_scripts/convert_afew_gpsro.csh	2018-05-03 15:20:58 UTC (rev 12571)
@@ -0,0 +1,65 @@
+#!/bin/csh
+#
+# DART software - Copyright UCAR. This open source software is provided
+# by UCAR, "as is", without charge, subject to all terms of use at
+# http://www.image.ucar.edu/DAReS/DART/DART_download
+#
+# DART $Id$
+#
+# example script for converting only a few days of GPS Radiosonde Occultation
+# observations to DART observation sequence format.
+#
+# for longer time periods see the convert_many_gpsro.csh script.
+#
+#
+# this script calls the gpsro_to_obsseq script with 6 args:
+#
+#  - the date in YYYYMMDD format
+#  - the processing directory location, relative to the 'work' dir.
+#  - whether to download the data automatically from the cosmic web site.
+#     'yes' will do the download, 'no' assumes the data is already downloaded
+#     and on local disk.  (downloading data requires signing up for a 
+#     username/password to access the site, and then setting the username 
+#     and password in the gpsro_to_obsseq script before running it.)