ASPECT
Changes after the latest release (v2.5.0)

This is the list of changes made after the release of ASPECT version 2.5.0. All entries are signed with the names of the author.

  1. Removed: The outdated input option for the geoid postprocessor named 'Include the contributon from dynamic topography' has been removed. Use 'Include surface topography contribution' or 'Include CMB topography contribution' instead.
    (Rene Gassmoeller, 2024/03/15)

  2. Implemented a new fluid-rock interaction scheme for the reactive fluid transport material model based on a parametrization by Tian et al., 2019 G3, https://doi.org/10.1029/2019GC008488.
    (Daniel Douglas, 2024/02/24)

  3. Incompatible: When using the "AsciiDataBoundary" class to read initial topographies for the chunk geometry, the input file needed to provide topographies spaced on a grid in latitude and longitude where the longitude was to be provided from -pi (180 degrees west) to +pi (180 degrees east). This is contrary to the rest of ASPECT, which generally uses 0 to 2*pi (0 to 360 degrees east) as a convention. This has now been changed: The initial topography plugin will be asked about topographies in lat-long with longitudes between 0 and 2*pi. This also means that input files have to be changed correspondingly.
    (Wolfgang Bangerth, 2024/02/16)

  4. New: There is now a new cookbook that demonstrates how to use the Geodynamic World Builder to set up initial conditions for a mid-ocean ridge model with a transform fault following the setup of Behn et al., 2007.
    (Juliane Dannberg, 2024/02/13)

  5. New: There is now a new visualization postprocessor called "surface elevation" that can be used to plot the initial topography or the effects of a free surface.
    (Wolfgang Bangerth, 2024/02/04)

  6. Improved: For the diffusion_dislocation, visco_plastic and visco_elastic material models, it is no longer necessary to specify material properties in the input file for fields that do not represent chemical compositions, like strain and stress fields.
    (Anne Glerum, 2024/01/22)

  7. Improved: The geometry function point_is_in_domain now also works for meshes that include initial topography and/or mesh deformation for box and chunk geometries.
    (Anne Glerum, 2023/12/14)

  8. Removed: The GeometryModel::Chunk and GeometryModel::TwoMergedChunks classes had member functions depth_wrt_topo(), but these were not used anywhere and did not work with the mesh deformation framework. They have consequently been removed.
    (Wolfgang Bangerth, 2023/12/07)

  9. Changed: The interface Postprocess::VisualizationPostprocessors::CellDataVectorCreator::execute() used to return an object of type std::pair<std::string, Vector<float>*> where the second part is just a raw pointer. This has been changed (incompatibly) to std::pair<std::string, std::unique_ptr<Vector<float>>> to avoid the use of raw pointers and ensure that memory de-allocation happens automatically.
    (Wolfgang Bangerth, 2023/11/28)

  10. Fixed: The stress and shear stress visualization postprocessors now output the correct stresses when elasticity is enabled.
    (Bob Myhill, Rebecca Fildes, 2023/11/10)

  11. Fixed: The 'principal stress' postprocessor used the wrong sign for stresses in models with elastic deformation, leading to principal stress directions that were rotated by 90 degrees. This is fixed now.
    (Rene Gassmoeller, Rebecca Fildes, 2023/11/09)

  12. Changed: ASPECT now considers boundaries with no normal flow as boundaries with inflow for the purposes of the parameter 'Allow fixed temperature on outflow boundaries' and the corresponding parameter for composition. This was the default behavior up to ASPECT 2.4.0. This behavior was changed in ASPECT 2.5.0, in which boundaries with no normal flow are treated like outflow boundaries. The new behavior caused unintended side effects, therefore it is reverted back to the original behavior. The reason for the initial change was a bugfix for boundary conditions in the first timestep that is now implemented differently.
    (Rene Gassmoeller, 2023/11/06)

  13. Fixed: The RK4 particle interpolation scheme computed wrong particle locations for particles that crossed periodic boundaries in a box geometry. This is fixed now.
    (Rene Gassmoeller, 2023/11/03)

  14. New: There is now a new cookbook that demonstrates how to use the grain size material model and how to choose the particle parameters in a model with a complex nonlinear rheology.
    (Juliane Dannberg, 2023/10/07)

  15. New: The amount of shear heating in a computation can now be limited by setting a maximum stress to be used, based on a Drucker-Prager yield stress with a user- specified cohesion and friction angle. This is useful in models with unrealistically high stresses.
    (Juliane Dannberg, 2023/10/01)

  16. Added: There is now a prescribed viscosity material model plugin, which can overwrite the viscosity of a specified location with a viscosity prescribed by a function.
    (Menno Fraters, 2023/09/27)

  17. Changed: ASPECT has been renamed from "Advanced Solver for Problems in Earth's ConvecTion" to "Advanced Solver for Planetary Evolution, Convection, and Tectonics" to reflect that the scope of ASPECT has grown beyond mantle convection.
    (Timo Heister, 2023/09/17)

  18. New: There is now an entropy table lookup model in the initial composition model. This model takes an initial temperature field and converts it to an initial entropy field using a lookup table.
    (Haoyuan Li, 2023/08/11)

  19. Changed: ASPECT now requires CMake 3.13.4 (just like deal.II v9.5.0) and no longer supports GeodynamicWorldBuilder older than 0.5.0.
    (Rene Gassmoeller, 2023/09/09)

  20. Changed: The benchmarks 'blankenbach' and 'king2dcompressible' have been reworked and extended. Changes include: (1) higher resolution, (2) more reproducible convergence results, (3) additional figures, (4) a comparison between gradient based and CBF heat flux calculation, (5) reproducible Richardson extrapolation of ASPECT reference results.
    (Rene Gassmoeller, 2023/08/29)

  21. New: There is now a new viscosity profile data file that is more consistent with how the profile is computed in the original Steinberger and Calderwood (2006) paper.
    (Juliane Dannberg, Bernhard Steinberger, 2023/08/22)

  22. New: The steinberger material model now allows the viscosities of different materials to differ from the reference viscosity by a constant factor via the parameter Composition viscosity prefactors.
    (Poulami Roy and Bob Myhill, 2023/08/14)

  23. Improved: The 'spherical constant' boundary composition and boundary temperature plugins have been updated. In particular the boundary composition plugin can now prescribe different values for different compositional fields.
    (Rene Gassmoeller, 2023/08/02)

  24. Improved: The iteration scheme in the diffusion dislocation material model now uses the derivative of the logarithm of the strain rate to the logarithm of the stress. This improves efficiency and stability of the iterative scheme. The parameter "Strain rate residual tolerance" now corresponds to the residual for the logarithm of the strain rate (which close to the solution corresponds to the relative residual).
    (Haoyuan Li and Bob Myhill, 2023/07/18)

  25. New: There is now a strain rate tensor postprocessor that is only outputted on the surface of the model domain.
    (Anne Glerum, 2023/07/17)

  26. Added: A sea level postprocessor that computes the sea level for glacial isostatic adjustment modeling. It computes the sea level based on the free surface topography, ocean basin, ice melt from boundary traction, and perturbed gravitational potential of the Earth model from the geoid postprocessor.
    (Maaike Weerdesteijn, 2023/07/14)

  27. New: There is now a new material model ('reactive fluid transport') that is designed to advect fluids and compute fluid release and absorption based on different models for fluid-rock interaction. The properties of the solid are taken from a base material model.
    (John Naliboff, 2023/07/14)

  28. Fixed: The strain rheology now uses the correct 'old strain' when computing the reaction term updates.
    (John Naliboff 2023/07/14)

  29. New: There is now a new cookbook which models the (Poiseuille) flow of the lower crust around a rigid obstacle.
    (Cedric Thieulot, 2023/07/13)

  30. Improved: The initial lithostatic pressure plugin for boundary tractions now includes the initial topography of the reference point into its pressure profile instead of the maximum topography within the domain.
    (Anne Glerum, 2023/07/13)

  31. Changed: Boundary traction models are now organized in a manager class that allows to assign multiple boundary traction plugins to each boundary. Existing user plugins that use the function this->get_boundary_traction() will need to be modified to use this->get_boundary_traction_manager().
    (Chameera Silva, Rene Gassmoeller, 2023/07/13)

  32. New: Added a cookbook on how to set up global instantaneous models based on recent geophysical constraints with a heterogeneous density and viscosity distribution and weak plate boundaries prescribed using different plate boundary configurations.
    (Arushi Saxena, Juliane Dannberg, and Rene Gassmoeller 2023/07/13)

  33. New: There is now a new cookbook which is a very simple subduction initiation model as published by Matsumoto and Tomoda (1983).
    (Cedric Thieulot, 2023/07/12)

  34. Changed: The entropy plugin now includes a plasticity rheology, which can be set by cohesion and frictional angle. It can also use a viscosity prefactor profile, set the lateral viscosity variation limit, and choose p-T dependent conductivity


    (Ranpeng Li & Juliane Dannberg, 2023/07/13)

  35. Changed: Material models are now always provided with the current strain rate. Checks if the strain rate is provided are not longer necessary. MaterialModelInputs can no longer be initialized without a strain rate.
    (Rene Gassmoeller, 2023/07/12)

  36. New: A cookbook which replicates the model setup of the van Keken et al., 2008 2D corner flow subduction benchmark.
    (Daniel Douglas, Cedric Thieulot, Wolfgang Bangerth, Max Rudolph, 2023/07/12)

  37. New: There is now a new cookbook which models the deformation of elliptical and rectangular inclusions in simple shear and pure shear.
    (Cedric Thieulot, 2023/07/11)

  38. Fixed: When using the 'artificial viscosity' visualization postprocessor in parallel, we used to put NaNs into the output vector (for ghost and artificial cells) that then triggered floating point exceptions. This is now fixed.
    (Wolfgang Bangerth, 2023/07/10)

  39. New: The base code for the computation and output of Crystal Preferred Orientation (CPO) has been added to ASPECT.
    (Menno Fraters, 2023/07/09)

  40. Changed: The input parameter 'Include viscoelasticity' has been removed from the visco_plastic material model. When 'Enable elasticity' in the Formulation subsection is switched on, elasticity will automatically be included in the visco_plastic material model.
    (Anne Glerum, 2023/07/09)

  41. New: ASPECT now allows it to select a different list of assemblers for each advection field.
    (Juliane Dannberg, 2023/07/09)

  42. Improved: The iteration scheme in the Peierls creep rheology now uses the derivative of the logarithm of the strain rate to the logarithm of the stress.
    (Haoyuan Li and Bob Myhill, 2023/07/08)

  43. New: The cutoff stress for the Peierls stress could now be applied strictly as the lower limit of the stress in the Peierls rheology
    (Haoyuan Li, Bob Myhill, 2023/07/08)

  44. Fixed: The computation of the upper box origin in the 'box with lithosphere boundary indicators' geometry model did not take into account a nonzero origin. This is fixed now.
    (Juliane Dannberg, 2023/07/08)

  45. Changed: Default field types are now defined by ASPECT based on Field Names if the types are not defined by the user. The logic is as follows: if the name contains the substring stress, it has type stress. If the name is equal to s11, s12, s22, s13, s23, s33, it has type strain. If the name is equal to grain_size, porosity, density_field, or entropy it has the types grain size, porosity, density or entropy respectively. Otherwise it has the type chemical composition.
    (Bob Myhill, 2023/07/08)

  46. New: There is now a new additional benchmark called solubility that demonstrates the mass of water is conserved as water is released, migrates and is being reabsorbed.
    (Juliane Dannberg, 2023/07/08)

  47. Improved: ASPECT is now by default compiled in DebugRelease mode which compiles both a debug and a release (optimized) version of the executable. Individual build types can still be selected using 'make debug' or 'make release' or by setting the cmake variable CMAKE_BUILD_TYPE to Debug or Release.
    (Rene Gassmoeller, Timo Heister, 2023/07/07)

  48. New: The maximum relative increase in the time step length is now bounded by a factor of 1.91, where before it was unbounded. This value is obtained from theoretical considerations about parabolic problems.
    (Laila Busaleh, 2022/09/15)

  49. New: Mesh deformation plugin that uses the landscape evolution code FastScape to deform the surface through erosion and sediment deposition.

    Citations: Neuharth, D., Brune, S., Wrona, T., Glerum, A., Braun, J., & Yuan, X. (2022). Evolution of rift systems and their fault networks in response to surface processes. Tectonics, 41(3), e2021TC007166.

    Neuharth, D., Brune, S., Glerum, A., Morley, C. K., Yuan, X., & Braun, J. (2022). Flexural strike-slip basins. Geology, 50(3), 361-365.


    (Derek Neuharth, Anne Glerum, Sascha Brune, Esther Heckenbach 2023/03/01)

  50. New: There is now a new initial temperature plugin that adds a fixed number of Gaussian perturbations placed at random locations to the initial temperature.
    (Juliane Dannberg, 2023/02/10)

  51. New: The 'grain size' material model now supports the grain size evolution equations of Mulyukova & Bercovici 2018 in addition to the existing formulations. For this purpose the old input parameter 'Use paleowattmeter' has been deprecated and replaced with 'Grain size evolution formulation'. The default behavior of the material model has not changed. Benchmarks and tests for the new feature have been added.
    (Arushi Saxena, Ranpeng Li, Juliane Dannberg, Rene Gassmoeller, 2023/08/23)