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

New Contributors

• @rfiorella made their first contribution in https://github.com/amanzi/ats/pull/266
• @ehinrichs made their first contribution in https://github.com/amanzi/ats/pull/289

Full Changelog: https://github.com/amanzi/ats/compare/ats-1.5.0...ats-1.6.0

- C++
Published by ecoon 9 months ago

ats - ATS Release 1.5.2

What's Changed

• Patch for resolving parallel issue in 1.5.1 by @dasvyat in https://github.com/amanzi/ats/pull/292

Full Changelog: https://github.com/amanzi/ats/compare/ats-1.5.1...ats-1.5.2

- C++
Published by ecoon about 1 year ago

ats - 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 rootingdepthfraction --> 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

- C++
Published by ecoon over 1 year ago

ats - 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.

- C++
Published by ecoon almost 2 years ago

ats - ATS Release 1.4.2

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

- C++
Published by ecoon over 2 years ago

ats - 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.

- C++
Published by ecoon about 3 years ago

ats - 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.

- C++
Published by ecoon over 3 years ago

ats - 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.

- C++
Published by ecoon over 3 years ago

ats - 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.

- C++
Published by ecoon over 4 years ago

ats - 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).

- C++
Published by ecoon almost 5 years ago

ats - ATS Release 1.0.0

Release 1.0 brings together major changes that have happened from 0.88, including improved evapotranspiration models, greatly improved documentation and example problems, and ongoing work in sediment and other development areas. We're also very excited as we're ready to call the base capabilities of hydrology, freeze/thaw, and ecohydrology on watersheds mature enough to be 1.0. This release partners with Amanzi's release 1.0.

This is a big milestone for Amanzi and ATS development teams -- thank you all so much for all of your hard work!

- C++
Published by ecoon about 6 years ago

ats - ATS Release 0.88

This release adds new stable functionality in:

• deformation, allowing volumetric change of grid cells to allow for a deforming mesh
• subgrid parameterizations in evaporation and the surface energy balance
• fixed major issues in assumptions about energy transport with evaporative fluxes. 0.87's evaporation model should not be trusted. While 0.86 is still a supported release, 0.87 should now be considered a deprecated/legacy release and will not be supported.

Additionally, there was significant cleanup of the surface energy balance in preparation for future work (hopefully for ATS-0.89?) on transpiration in temperate environments. These did not change physics, but changed code significantly.

- C++
Published by ecoon over 6 years ago

ats - ATS Release 0.87

Includes significant change through the concept of domains, ensuring that all (nearly all?) variables are now prefixed with a domain name. This allows all (nearly all?) PKs to be multiply instantiated on, for instance, subgrid models, column models, and other strategies. Also adds support for tracer transport, including surface and subsurface transport in icy soils. Also adds work on subsidence, including significant work on the deformation capabilities in ATS.

- C++
Published by ecoon over 8 years ago

ats - ats version 0.86, patch 3

This release adds a single key to the vegetation model, which allows the surface energy balance to use a shaded incoming shortwave instead of the total incoming shortwave. This is a workaround for a broader issue, which is that many PKs hard-code their dependencies. Many of these have already been refactored on dev, and that effort will continue on dev in a more comprehensive way.

- C++
Published by ecoon about 9 years ago

ats - ats-0.86.p2

Updates relative permeability to be calculated directly from liquid saturation instead of through capillary pressure. This makes life easier for ice saturation. It also fixes some bugs in rel perm smoothing under permafrost WRMs with freezing point depression.

Note that this results in a change in the input spec, where:

"smoothing interval width"

is renamed:

"smoothing interval width [saturation]"

and the units of this change from [Pa] to -. Typical values in input files should change from ~100-1000 to ~.01-.1

- C++
Published by ecoon over 9 years ago