Merge pull request #205 from NCAR/update-changelog

Update changelog to reflect 9.10.0 release

CHANGELOG.rst

@@ -14,14 +14,86 @@ output of ``git log``
 
 ::
 
-   0[1011] machine:dartGIT % git log > full_git_log.txt
+   0[1011] machine:DART % git log > full_git_log.txt
 
-A reminder that since many files were moved or renamed, the best way to
+A reminder that since many files were moved or renamed, the best way to 
 get the complete log is to use ``git log --follow`` for information on
 individual files.
 
 The changes are now listed with the most recent at the top.
 
+**April 27 2021 :: preprocess, inflation options, external FO output, 
+wrf-hydro, AMSU-A, DART_LAB Tag: v9.10.0**
+
+*New features*
+
+-  Updated ``preprocess``:
+
+   -  Integers for quantities (kinds) are created and 
+      managed by preprocess instead of through a list of integers in 
+      ``DEFAULT_obs_kind_mod.F90``.
+   -  Quantities are defined by name in files: ``xxx_quantities_mod.f90``.
+   -  ``preprocess`` is backwards compatible with existing (v9.9.0)
+      ``DEFAULT_obs_kind_mod.F90`` files and corresponding ``&preprocess_nml`` options.  
+
+-  Inflation algorithm options in ``&filter_nml`` can be given as strings. 
+
+-  External forward operators can be selectively written out by observation type in
+   ``obs_sequence_tool``.
+
+-  Updated wrf-hydro interface from **James McCreight**. 
+
+-  Added ``AIRS/convert_amsu_L1.f90`` and ``amsua_bt_mod.f90`` to support converting 
+   AMSUA brightness temperatures to obs_seq.
+
+-  ``AIRS/airs_JPL_mod.f90`` strictly supports HDF-EOS2 (not HDF-EOS5) and is only 
+   used for Level 2 (i.e. retrievals of) temperature and humidity observations.
+
+-  POP CESM2.1 scripts use the unzipped CAM reanalysis files available on
+   the Research Data Archive (RDA). 
+
+-  Enhanced adaptive inflation added to DART_LAB.   
+
+-  Improved support for RTPS: output posterior inflation files now contain posterior
+   inflation values when using RTPS. 
+
+-  Improved support for RTTOV in MPAS:
+
+   -  ``loc_sea`` variable used to create sfc, 2m, 10m 
+      locations relative to model surface elevation. 
+   -  new error code for pressure *not* monotonically decreasing with level.
+   -  QTY_CLOUD_FRACTION added. 
+
+-  ``E_CONTINUE`` added to allow programs continue after throwing an error. Used in 
+   developer tests.
+-  Support for more Flux Tower observations (``obs_def_tower_mod.f90``)
+-  Expanded support for netcdf in ``netcdf_utilities_mod``.
+-  Documentation converted to reStructuredText and available online. Reorganization
+   of directories to support this: docs -> guide, docs/tutorial -> theory.
+
+*Bug fixes*
+
+-  Check for monotonically decreasing pressure from TOA down to surface in
+   ``obs_def_rttov_mod.f90`` now checks for greater than or *equal* to previous 
+   level.
+-  External forward operators now use the correct ensemble members when 
+   ``distributed_state=false``.
+-  The ``obs_sequence_tool`` now writes out external forward operator values. 
+   Thanks to **Chris Riedel** for reporting this and providing the 
+   original bug-fix.
+-  ``obs_def_radar_mod.f90`` now correctly applies ``apply_ref_limit_to_fwd_op``
+   when QTY_RADAR_REFLECTIVITY is in the state. Thanks to **Craig Schwartz** for 
+   providing the bug-fix.   
+-  ``quality_control_mod.f90`` now correctly handles ``enable_special_outlier = .true.``
+   Thanks to **Craig Schwartz** for providing the bug-fix.
+
+
+*Removed*
+
+-   Doxygen directory.
+-   Removed svn logging variables and ``register_module`` for cleaner log 
+    messages. The svn info has not been used since DART moved to Git. 
+
 **Oct 29 2020 :: radiance support, MPAS, obs converters Tag: v9.9.0**
 
 -  Use RTTOV (Radiative Transfer for TOVS) routines to support radiance
@@ -130,7 +202,7 @@ The changes are now listed with the most recent at the top.
 .. _email Dr. Mizzi: mailto:[email protected],[email protected]?subject=WRF-Chem/DART%20inquiry
 
 
-Nov 20 2019 :: FESOM,NOAH-MP model support, better testing Tag: v9.8.0
+**Nov 20 2019 :: FESOM,NOAH-MP model support, better testing Tag: v9.8.0**
 
 -  first release entirely from GIT
 

README.md

@@ -6,17 +6,31 @@
 
 # DART 
 
-Welcome to DART, the **Data Assimilation Research Testbed**. DART is an open-source, freely available community facility for ensemble data assimilation (DA). 
+Welcome to DART, the **Data Assimilation Research Testbed**. DART is an open-source, 
+freely available community facility for ensemble data assimilation (DA). 
 
 [The DART documentation is available online](https://dart-documentation.readthedocs.io/en/latest/).
 
-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 discussion so it's a low-traffic list. To subscribe to the list, click on [Dart-users](http://mailman.ucar.edu/mailman/listinfo/dart-users). 
+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 discussion so it's a low-traffic list. 
+To subscribe to the list, click on [Dart-users](http://mailman.ucar.edu/mailman/listinfo/dart-users). 
+
+#### Downloading DART
+
+DART is available through GitHub. To download the latest version of DART:
+
+```
+git clone https://github.com/NCAR/DART.git
+cd DART
+git checkout -b v9.10.0-branch tags/v9.10.0 
+```
 
 #### Citing DART
 
 To cite DART, please use the following text:
 
-> The Data Assimilation Research Testbed (Version X.Y.Z) [Software]. (2021). Boulder, Colorado: UCAR/NCAR/CISL/DAReS.  http://doi.org/10.5065/D6WQ0202
+> The Data Assimilation Research Testbed (Version X.Y.Z) [Software]. (2021). Boulder, Colorado: UCAR/NCAR/CISL/DAReS.
+> http://doi.org/10.5065/D6WQ0202
 
 and update the DART version and year as appropriate.
 
@@ -26,9 +40,10 @@ DART is developed and maintained by the [Data Assimilation Research Section
 (DAReS)](https://dart.ucar.edu/about/) at [the National Center
 for Atmospheric Research (NCAR)](https://ncar.ucar.edu).
 
-For information on research projects featuring DART and the DAReS team, visit [dart.ucar.edu](https://dart.ucar.edu/research/). 
+For information on research projects featuring DART and the DAReS team, 
+visit [dart.ucar.edu](https://dart.ucar.edu/research/). 
 
 ### Contributing
 
-Please see the [Contributors' Guide](https://dart-documentation.readthedocs.io/en/latest/guide/contributors-guide.html) for how 
-to contribute to DART.
+Please see the [Contributors' Guide](https://dart-documentation.readthedocs.io/en/latest/guide/contributors-guide.html) 
+for how to contribute to DART.

README.rst

@@ -80,13 +80,21 @@ Quick-start
 
 1. fork the NCAR/DART repo
 2. clone your (new) fork to your machine - this will set up a remote named
-   ‘origin’
+   ‘origin’. To clone DART and checkout the latest release, use
+
+.. code::
+
+   git clone https://github.com/USERNAME/DART.git
+   cd DART
+   git checkout -b v9.10.0-branch tags/v9.10.0 
+
+where `USERNAME` is your GitHub username. 
+
 3. create a remote to point back to the NCAR/DART repo … convention dictates
    that this remote should be called ‘upstream’
-4. check out the appropriate branch
-5. Download one of the tar files (listed below) of ‘large’ files so you can test
+4. Download one of the tar files (listed below) of ‘large’ files so you can test
    your DART installation.
-6. If you want to issue a PR, create a feature branch and push that to your fork
+5. If you want to issue a PR, create a feature branch and push that to your fork
    and issue the PR.
 
 There are several large files that are needed to run some of the tests and

conf.py

@@ -21,7 +21,7 @@
 author = 'Data Assimilation Research Section'
 
 # The full version, including alpha/beta/rc tags
-release = '9.9.0'
+release = '9.10.0'
 master_doc = 'README'
 
 # -- General configuration ---------------------------------------------------

guide/downloading-dart.rst

@@ -12,13 +12,25 @@ for more information on how to clone a repository. Take note of the
 directory you installed into, which is referred to as ``DART`` throughout 
 this documentation.
 
+To checkout the latest release of DART:
+
+.. code:: 
+
+   git clone https://github.com/NCAR/DART.git
+   cd DART
+   git checkout -b v9.10.0-branch tags/v9.10.0 
+
+If you have forked the DART repository, replace ``NCAR`` with your
+Github username.
+
 .. note::
 
    If you are interested in contributing to DART, see the
    :doc:`contributors-guide` for more information. In short, you
    will need to be familiar with the
    `GitHub workflow <https://guides.github.com/introduction/flow/>`_.
 
+
 Unzip or clone the distribution in your desired directory, which we refer to as
 ``DART`` in this document. Compiling the code in this tree (as is usually the
 case) may require a large amount of additional disk space (up to the 1 Gb