.. SPDX-FileCopyrightText: 2022 SeisSol Group SPDX-License-Identifier: BSD-3-Clause SPDX-LicenseComments: Full text under /LICENSE and /LICENSES/ SPDX-FileContributor: Author lists in /AUTHORS and /CITATION.cff Breaking changes in backward compatibility ========================================== To keep up-to-date with changes in compute-centers and geoscientists' needs, breaking changes sometimes needed to be introduced in SeisSol. All breaking changes for version 0.9.0 and later are listed here. Energy Output ~~~~~~~~~~~~~ (since 0.9.0, `#531 `_, April 2022) Since we merged GitHub pull request `#531 `_ (April 2022), the seismic moment time history output, from which the moment rate can be post-processed, is integrated into the energy output (see :ref:`energy_output`). Therefore, the parameters `magnitude_output_on`, `energy_rate_output_on` and `energy_rate_printtimeinterval` have been removed from the `DynamicRupture` namelist in the main parameter file. C++ dynamic rupture implementation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (1.0.0 to 1.3.2, since `#625 `_, September 2022) While porting dynamic rupture to C++, we changed a few parameter names to make things more consistent. The new dynamic rupture implementation has been merged in September 2022 (GitHub pull request `#625 `_). The linear slip weakening friction laws FL=2 (nucleation by stress increase) and FL=16 (forced time rupture nucleation) have been merged (the new friction law is FL=16; but FL=2 will be accepted as input after `#1288 `_). Because of this change, FL=16 now requires nucleation stress or tractions to be specified in the fault-specific yaml file. Parameter file (`parameters.par`): +-----------------+-------------------------------------------------------------------------------------------------+ | old | new | +=================+=================================================================================================+ | ``0d0`` | ``0.0`` (only until `#1173 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``v_star`` | ``pc_vStar`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``L`` | ``pc_prakashLength`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``mu_w`` | ``rs_muW`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``alpha_th`` | ``tp_thermalDiffusivity`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``rho_c`` | ``tp_heatCapacity`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``tp_lambda`` | ``tp_undrainedTPResponse`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``initemp`` | ``tp_iniTemp`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ | ``inipressure`` | ``tp_iniPressure`` (only until `#1288 `_) | +-----------------+-------------------------------------------------------------------------------------------------+ Fault-specific yaml file (`fault.yaml`): +-------------------------------+---------------------------------------------------------------------------------------------------+ | old | new | +===============================+===================================================================================================+ | ``RS_sl0`` | ``rs_sl0`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``alpha_hy`` | ``tp_hydraulicDiffusivity`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``TP_half_width_shear_zone`` | ``tp_halfWidthShearZone`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``Ts0`` | ``T_s`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``Td0`` | ``T_d`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``Pn0`` | ``T_n`` (only until `#1427 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``RS_f0`` | ``rs_f0`` (only until `#1540 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``RS_b`` | ``rs_b`` (only until `#1540 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ | ``RS_muw`` | ``rs_muw`` (only until `#1540 `_) | +-------------------------------+---------------------------------------------------------------------------------------------------+ FORTRAN Removal ~~~~~~~~~~~~~~~ (since 1.1.0, `#829 `_, April 2023) All FORTRAN had been removed; and several parameters have been deprecated. However, all previous configuration files continue working. Relative Paths ~~~~~~~~~~~~~~ (since 1.2.0, `#1156 `_, August 2024) SeisSol now looks for all paths in the parameter file first relatively to the parameter file, and only then relative to the execution directory. This rule does not apply for the output directory. Before this change, also all other paths were only viewed relative to the execution directory. For absolute paths, nothing has changed. DR Traction Computation ~~~~~~~~~~~~~~~~~~~~~~~ (since 1.1.0, `#895 `_, September 2023) There was an adjustment in the Rate-and-State friction law computation; thus the results differ slightly between 1.0.1, and 1.1.0 onwards for the CPU computation. The adjustment was propagated to the GPU implementation after 1.3.0. The respective `commit `_ updated the CPU implementation; the GPU implementation was updated by `#1288 `_. Name of the Strain Rate Output for Off-Fault Receivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (since 1.2.0, `#1126 `_, June 2024) The strain rate output was named just "strain" output for the off-fault receivers. The corresponding option was likewise called :code:`ReceiverComputeStrain`, not :code:`ReceiverComputeStrainRate`. Potency and Seismic Moment Quadrature ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (since before 0.9.0, `#527 `_, April 2022) The potency and the seismic moment were computed by averaging the value over all points. Now, to make the integration more exact, they are instead weighed by the quadrature rule the underlying DR implementation uses. As a result, the computed seismic moment and magnitude may slightly change compared to before.