DASH v4.0.0

Woohoo! 🎉 😎

Summary

This release adds

• A tutorial,
• A number of new PSMs,
• The ability to implement totals (sums) across state vector dimensions,
• 1D covariance localization, and
• Improvements to the PSM interface

The release also includes a number of minor improvements and bug fixes.

Details

Major Additions

1. Tutorial
   The HTML pages in the DASH docs now include a tutorial and introduction to DASH.

2. PSM.identity
   Added an identity PSM. This built-in PSM returns input values directly as outputs without running any forward model.

3. PSM.pdsi
   Added a PSM that estimates the Palmer Drought-Severity Index.

4. PRYSM PSMs
   Added PSMs to implement several of the sensor modules from the PRYSM python package. Specifically, these are the cellulose, coral, and icecore sensor modules. (See PSM.prysm.cellulose, PSM.prysm.coral, and PSM.prysm.icecore). Also added instructions for setting up PRYSM to run within Matlab (See help PSM.prysm).

5. State vector totals
   Added the stateVector.total and stateVector.weightedTotal commands. These commands are similar to the stateVector.mean and stateVector.weightedMean commands, but they implement a sum total (rather than a mean) over the indicated dimensions. For example, these new commands can be used to compute total precipitation over a spatial field.

6. Covariance localization in 1D
   Added the dash.localize.gc1d function. This function allows users to calculate localization weights over a single dimension (such as height or depth). The outputs of this function can also be combined with 2D localization weights to implement localization over a 3D spatial array.

7. PSM.download
   Added an option for PSM.download to download the latest commit of an external code. Previously, users could only download the officially supported commit.

8. PSM memory
   Added PSM memory to the informational properties in the PSM interface. Users can now see whether a PSM maintains memory of previous time steps (and should thus use a time-ordered ensemble) when using the PSM.info method.

Minor changes

1. gridfile.new
   Users can now use strings (in addition to logicals) to select overwriting options.

2. dash.parse.nameValue
   Flag parsing is now case-insensitive.

3. PSM descriptions
   Fixed some minor typos in the PSM descriptions. (i.e. "Baysian" -> "Bayesian")

4. sv.variable
   Fixed a bug in the console display of detailed variable dimensions wherein weighted means were reported as standard means.

Acknowledgements

Many thanks to:

@kanchukaitis For the suggestion of state vector totals
@amrhein For suggesting the identity PSM, and 1D covariance localization
@PaleoLipidRR For noting the typos in the PSM descriptions, and
@sylvia-dee For providing validation data for the PRYSM PSMs