ATS Release 1.6.0

What's Changed at a Glance

• Major refactor of transport and reactive transport, modernizing that code to include tags and support sub cycling.
• Changes in transport naming conventions, from concentration to mole fraction, to match the actual quantity used.
• Ongoing development of root fraction and granularity in transpiration
• Updates to sediment transport, bringing that capability back to ATS
• Evaluators supporting urban / managed hydrology, including pumps, gates, impervious surface, etc.
• Better CI, including CI testing both amd64 and arm64 architectures

Detailed Changes

• rename rooting_depth_fraction to root_fraction by @gaobhub in #265
• Code by Daniiil Svyatsky for creating mesh info files by @saubhagya-gatech in #259
• Merge elm_ats updates to master by @rfiorella in #266
• clean name preserving domain name by @ecoon in #268
• separate water table and perched water table by @gaobhub in #263
• Optimize and Reorganize Transport PK Code Structure by @levuvietphong in #232
• Rework of PKs to split out parseParameterList, make RequireEvaluator() call EnsureEvaluators() by @ecoon in #270
• dummy commit to move regression test pointer and create PR for CI by @ecoon in #278
• Add conditional to select correct regression tests when --disable-geochemistry by @rfiorella in #281
• [wip] add debugging info to ctest output in CI by @rfiorella in #272
• updates to match Amanzi PR of same branch by @ecoon in #280
• Transport update and fixes by @levuvietphong in #271
• Updates TimeStepManager by @ecoon in #273
• add cell volume to the calculation of carbon decomposition rate and remove an assertion bug by @gaobhub in #284
• Updated test_manager.py to allow docker executables to be run by @ehinrichs in #289
• modified carbon decomp coeff by multiplying cell thickness by @gaobhub in #288
• Added parallel comuunication update for calculating cell-center darcy… by @dasvyat in #291
• WIP: Fixing parallel bug in transport #285 by @dasvyat in #290
• WIP: documentation cleanup by @ecoon in #299
• Modified time unit conversion from ats vis files to vis postprocessing by @gaobhub in #302
• molar ratio --> mole fraction, adds subfield names to ND-vectors by @ecoon in #303
• Ecoon/parallel transport bug by @ecoon in #306
• intermediate check of input converter -- updating converter where possible by @ecoon in #307
• matches Amanzi change of the same branch by @ecoon in #308
• Add Observations for Advective and Diffusive Solute Mass Flux by @levuvietphong in #304
• Fix C-Q evaluator bug: use current cell concentration for outgoing flux by @levuvietphong in #314
• provide the option for transport to take sources as evaluators by @ecoon in #313
• Enable arm64 runners by @rfiorella in #296
• Evaluators for Urban Infrastructure Model Components by @saubhagya-gatech in #267
• Geomorphology and sediment transport by @dasvyat in #310
• clang-format 19 with new file by @ecoon in #316
• Ecoon/bugfix seb derivatives by @ecoon in #318
• Documentation for sediment transport and morphology evaluators by @dasvyat in #317

New Contributors

• @rfiorella made their first contribution in #266
• @ehinrichs made their first contribution in #289

Full Changelog: ats-1.5.0...ats-1.6.0

ATS Release 1.5.2

What's Changed

• Patch for resolving parallel issue in 1.5.1 by @dasvyat in #292

Full Changelog: ats-1.5.1...ats-1.5.2

ATS Release 1.5.1

This release fixes several minor bugs in ATS and supporting code:

1. fixes a bug in ats_xdmf.py's centroid calculation
2. fixes a bug in hydraulic redistribution in the new transpiration distribution evaluator
3. adds code to construct MeshInfo files, needed for tile drain work
4. renames rooting_depth_fraction --> root_fraction in the input spec converter from 1.4 to 1.5
5. fixes the name of the input spec converter from 1.4 to 1.5

ATS Release 1.5.0

This release contains a few significant additions in process capability in ATS:

1. A new transpiration reduction function (TRF) was added. In previous versions, transpiration was reduced in dry conditions by an empirical function that was a function of water potential (based on CLM 4.5 technical note). The downside of this method is that it ignored soil properties; in some collections of van Genuchten water retention models, the TRF would still allow transpiration when there was very little water available in the soil. This would result in very small time steps. The new model is a simpler for of including plant hydraulics, and computes a plant water potential; this model reduces transpiration in all soils as needed.
2. New capabilities were added for managed water systems, including tile drains and evaluators to map tiles to drainage ditches.
3. New relative permeability models for freezing soils were added to support Arctic hillslope simulations.
4. Preferential snow distribution was recovered -- it existed in older versions, but was not maintained and not included in the previous few releases.

Additionally, multiple bugs were fixed including in canopy evapotranspiration, and several evaluators were refactored to make them more flexible, particularly in splitting the radiation balance to be used in multiple configurations of surface energy.

ATS Release 1.4.2

This patch release fixes a bug in the aspect calculation, where NW-facing aspects got negative values.

ATS Release 1.4.1

This release fixes a bug in the Priestley-Taylor computation of evapotranspiration, introduced in 1.4, which incorrectly set ET to a high value because of a units mistake in the function for the slope of the vapor pressure curve.

ATS Release 1.4.0

ATS version 1.4.0 is a major new release, with a complete revision of significant infrastructure within Amanzi and ATS. Little physics has changed, but the underlying multiphysics infrastructure has changed substantially, so this release affects developers more than users (though input files have changed substantially as well in this release).

• The new State model in Amanzi fundamentally changes what can be stored in State.
• The new Tag system in Amanzi required a rewrite of all ATS PKs to use Tags instead of multiple copies of State to deal with time-slices, subcycling etc.
• DomainSets were completely rewritten and updated to allow PKs to work on subdomains robustly. This is particularly important for multiscale and multidimensional models (e.g. the Arctic Intermediate Scale Model, the ADELS transport model for hyporheic exchange, etc)
• A complete pass through (nearly) all PKs and Evaluators was completed, standardizing a lot of documentation, use of the input spec, use of State and Evaluators, use of Keys and Tags, and more.
• Subcycling was generalized and now works with any PK/MPC.

ATS Release 1.3.0

ATS version 1.3.0 introduces a significant number of bug fixes, more robust implementations of transport, reactive transport, and Priestley-Taylor evapotranspiration models, and salinity transport and its effects on flow. Many of these are not brand new this release, but made much more robust. This is also the first version that is well-integrated with Watershed Workflow as a tool for setting up ATS simulations.

ATS 1.2.0

This release includes major refactoring of land surface processes for enabling improved evapotranspiration models.

1. New options for "land cover types," conceptually similar to Plant Functional Types in ESM land models or to National Land Cover Indices, these allow partitioning the surface for use in various processes, typically governing evapotranspiration.
2. Updated Arctic evaporation to use this new concept, but also making evaporation in ice-rich conditions much more robust than previously. The old model is still available, and is documented in tests, but demos will migrate to the newer model.
3. Addition of a few Priestley-Taylor models, including a basic one based on PRMS (this existed previously but is improved here) and a new one allowing canopy, snow and bare ground evaporation, along with transpiration from the rooting zone.

Note that this version is the version of the code to be used in the Sept 2021 workshop training on ATS.
Also, updating release notes (no change to code) to establish DOI with Zenodo.

ATS version 1.1

This release, which parallels Amanzi release 1.1, adds significant new functionality in a variety of physics spaces. The big new capabilities include:

1. Reliable integrated (surface and subsurface) transport, including 1st and 2nd order schemes for transport, molecular diffusion, dispersion (including tensor dispersion) and more.
2. Reactive transport through the Alquimia geochemical interface, allowing access to PFloTran and Crunch reaction networks. This is coupled with transport, allowing geochemical constraints on sources and boundary conditions, linear and nonlinear sorption, and more.
3. Much-improved support for multi scale models, including subgrid models of in-stream hyporheic exchange.
4. Support for the transport of salinity, including the effects of salinity on liquid density.
5. Preliminary support for sediment transport.

This release also includes significant improvements to the documentation of existing capabilities, and improved integration of tests through continuous integration (in the ate-regression-tests repository), and added examples (in the ats-demos repository).