[Dart-dev] DART/branches Revision: 11326
dart at ucar.edu
dart at ucar.edu
Wed Mar 15 09:12:38 MDT 2017
nancy at ucar.edu
2017-03-15 09:12:38 -0600 (Wed, 15 Mar 2017)
updated for Manhattan.
--- DART/branches/rma_trunk/README 2017-03-15 13:44:58 UTC (rev 11325)
+++ DART/branches/rma_trunk/README 2017-03-15 15:12:38 UTC (rev 11326)
@@ -11,28 +11,26 @@
Extensive local documentation is included in the DART subversion
-checkout. Open 'index.html' in your browser to begin.
+checkout. Open 'documentation/index.html' in your browser to begin.
-A Matlab/PDF introduction is in the DART_LAB directory. There are a set
-of PDF presentations, along with hands-on Matlab exercises. This starts
-with a very basic introduction to data assimilation, and covers several
-fundamental algorithms in the system.
+A Matlab/PDF introduction is in the documentation/DART_LAB directory.
+There are a set of PDF presentations along with hands-on Matlab exercises.
+This starts with a very basic introduction to data assimilation and covers
+several fundamental algorithms in the system.
+A slightly more advanced tutorial in PDF format is in the documentationb/tutorial
+subdirectory. Start with the index file which explains what each subsection covers.
-A slightly more advanced tutorial in PDF format is in the tutorial
-subdirectory. Start with the index file which explains what each
+The DART Manhattan release documentation is on the web:
-The DART Lanai release documentation is on the web:
and also in the subversion tree here at:
-General documentation in HTML format is in the doc/html directory, plus
-all parts of the DART system include HTML files in the respective model
-and source directories. There is an 'index.html' file in the top level
-directory which references all the other doc files.
+General documentation in HTML format is in the documentation/html directory.
+In addition, all parts of the DART system include HTML files in the respective
+model and source directories. There is an 'index.html' file in the top level
+documentation directory which references all the other doc files.
There is a mailing list where we summarize updates to the DART repository
and notify users about recent bug fixes. It is not generally used for
@@ -40,6 +38,18 @@
click on 'Dart-users', and if you use WRF see 'wrfdart-users' also:
+The Manhattan release is new and currently supports only a subset of the
+models. We will port over any requested model so contact us if yours
+is not on the list. In the meantime, we suggest you check out our
+'classic' release of DART which is the Lanai release plus additional
+development features. All new development will be based on the
+Manhattan release but the 'classic' release will remain for those
+models which already have the necessary features.
+Existing users will see that we have rearranged our directory tree.
+We hope this helps you find the various pieces that come with the
Contact us for more help or for more information on other models already
using DART or for how to add your model or observation types.
@@ -50,31 +60,38 @@
Quick-start for the impatient:
-Go into the 'mkmf' directory and copy over the closest
+Go into the 'build_templates' directory and copy over the closest
mkmf.template.compiler.system file into 'mkmf.template'.
-Edit it to set the NETCDF directory location if not in /usr/local,
+Edit it to set the NETCDF directory location if not in /usr/local
or comment it out and set $NETCDF in your environment.
*This NetCDF library must have been compiled with the same compiler
-that you use to compile DART, and must include the F90 interfaces.*
+that you use to compile DART and must include the F90 interfaces.*
Go into 'models/lorenz_63/work' and run './quickbuild.csh'.
-If it compiles, hooray. Run './perfect_model_obs' and then './filter'.
-If it runs, hooray again. Finally, if you have Matlab installed on
-your system, add '$DART/matlab' to your matlab search path and run the
-'plot_total_err' diagnostic script while in the 'models/lorenz_63/work'
-directory. If the output plots and looks reasonable (error level stays
-around 2 and doesn't grow unbounded), you're great! Congrats.
+If it compiles, hooray. Run this series of commands to do a very
+ncgen -o perfect_input.nc perfect_input.cdl
+ncgen -o filter_input.nc filter_input.cdl
+If that runs, hooray again. Finally, if you have Matlab installed on
+your system add '$DART/diagnostics/matlab' to your matlab search path
+and run the 'plot_total_err' diagnostic script while in the
+'models/lorenz_63/work' directory. If the output plots and looks
More information about the Dart-dev