Commit 8448dff9 authored by Bernd Flemisch's avatar Bernd Flemisch
Browse files

[documentation] update CHANGELOG and README

Approved by natalies.


git-svn-id: svn://svn.iws.uni-stuttgart.de/DUMUX/dumux/trunk@13500 2fb0f335-1f38-0410-981e-8018bf24f1b0
parent bcd9b820
Differences Between DuMuX 2.5 and DuMuX 2.6 Differences Between DuMuX 2.5 and DuMuX 2.6
=================================================== ===================================================
* IMPORTANT NOTES:
- To set paramaters from the command line, --parameterFile=NAME is deprecated. Use
from now on -ParameterFile NAME.
* IMPROVEMENTS and ENHANCEMENTS: * IMPROVEMENTS and ENHANCEMENTS:
- multidomain models can now be used with the 2.3 release versions of DUNE core modules - For the non-isothermal porous media models, the energy equation is
- the free flow models now include the component enthalpy fluxes transported implemented in a more generic way for all models in
by diffusion process (h^k D grad x), which was not considered before dumux/implicit/nonisothermal. The existing TypeTag names like TwoPNI stay
- UMFPack is a new direct linear solver and can be use as a drop-in replacement for the same. If a new non-isothermal model should be used, it is important
SuperLU. Some users claim a speed-up up to the factor of seven. We know cases where to NOT include anything from the old model-specific implementation like
it was 10% slower, so please measure for your problems. from dumux/implicit/2pni, but to include from the model folder without the
"ni". See test/implicit/2pni for details. In principle, any isothermal
porous media model can be enhanced with the energy equation. Ideally, only
the corresponding property files have to be augmented. See
dumux/implicit/2p/2ppropert*.hh for details. The 1p2c model already has
been enhanced, the remaining models will follow in 2.7.
- The AMG backend is based directly on dune-istl now. No PDELab is required
anymore. The tests so far exhibit an improved robustness. Thanks to Markus
Blatt for the work.
- The multidomain models can now be used with the 2.3 release versions of the
DUNE core modules and dune-multidomaingrid, and the 2.0 release versions
of dune-pdelab and dune-multidomain. See test/multidomain/README for
details.
- In the fully implicit mpnc model, a further specialization allows now to
describe two-phase flow with two energy equations.
- The free flow models now include the component enthalpy fluxes transported
by diffusion processes (h^k D grad x), which was not considered before.
- UMFPack is a new direct linear solver and can be use as a drop-in
replacement for SuperLU. Some users claim a speed-up up to a factor of
seven. We know cases where it was 10% slower, so please measure for your
problems.
* IMMEDIATE INTERFACE CHANGES not allowing/requiring a deprecation period: * IMMEDIATE INTERFACE CHANGES not allowing/requiring a deprecation period:
- in the fully implicit mpnc model a further specialization allows now to describe two-phase - The 3p3cni model now also uses an effective thermal conductivity model
flow with two energy equations. The boolean property EnableKineticEnergy has therefore been (ETCM). The ETCM is easily exchangeable. The default one is
changed to the integer property NumEnergyEquations ThermalConductivitySomerton, which is implemented in
dumux/material/fluidmatrixinteractions/3p. The ETCM requires that 3p3cni
spatial parameters provide a function thermalConductivitySolid instead of
matrixHeatFlux. See test/implicit/3p3cni/columnxylolspatialparams.hh for
details. Moreover, the employed fluid system has to actually implement the
function thermalConductivity. See
dumux/material/fluidsystems/h2oairxylenefluidsystem.hh for details.
- The non-isothermal flux variables call the effective thermal conductivity
models (ETCM) in a different way. If you used a self-written ETCM and want
to use a new non-isothermal model, the ETCM has to be adapted. See
material/fluidmatrixinteractions/2p/thermalconductivitysomerton.hh for
details.
- Fully implicit mpnc model: in order to account for the possibility of using
two energy equations, the boolean property EnableKineticEnergy has been
changed to the integer property NumEnergyEquations.
* Deprecated way of setting command line parameters, to be removed after 2.6:
- To set paramaters from the command line, the notation --parameterFile=NAME
is deprecated. Use from now on -ParameterFile NAME.
* Deprecated CLASSES/FILES, to be removed after 2.6: * Deprecated CLASSES/FILES, to be removed after 2.6:
- FVPressure2P2CAdaptive, use 2d-specific implementation FV2dPressure2P2CAdaptive instead. - The old non-isothermal porous media models are deprecated. Technically,
- FVTransport2P2CAdaptive, use 2d-specific implementation FV2dTransport2P2CAdaptive instead. including a ..niproperties.hh file triggers a deprecation warning.
* Deprecated PROPERTY NAMES, to be removed after 2.6: BEWARE: The compiler will - FVPressure2P2CAdaptive, use dimension-specific implementations
not print any warning if a deprecated property name is used. FV2dPressure2P2CAdaptive and FV3dPressure2P2CAdaptive instead.
* Deprecated CONSTANTS/ENUMS, to be removed after 2.6: BEWARE: Older compilers - FVTransport2P2CAdaptive, use dimension-specific implementations
will not print any warning if a deprecated constant/enum is used. FV2dTransport2P2CAdaptive and FV3dTransport2P2CAdaptive instead.
* Deprecated public MEMBER VARIABLES, to be removed after 2.6: BEWARE: Older
compilers will not print any warning if a deprecated public member variable
is used.
* Deprecated MEMBER FUNCTIONS, to be removed after 2.6: * Deprecated MEMBER FUNCTIONS, to be removed after 2.6:
- In Stokes fluxes the method eddyViscosity() is deprecated, use dynamicEddyViscosity() instead. - In the Stokes flux variables, the method eddyViscosity() is deprecated, use
- In Stokes non-isothermal fluxes the method eddyConductivity() is deprecated, use dynamicEddyViscosity() instead.
thermalEddyConductivity() instead.
* Deprecated MACROS, to be removed after 2.6: BEWARE: The compiler will not - In the Stokes non-isothermal flux variables, the method eddyConductivity()
print any warning if a deprecated macro is used. is deprecated, use thermalEddyConductivity() instead.
- Already in 2.5, the following member functions of MultiDomainModel/Problem
have been deprecated: subProblemX, subModelX, subIDX, gridViewX with X=1,2.
They are replaced by sdProblemX, sdModelX, sdIDX, sdGridViewX.
* DELETED classes/files, property names, constants/enums, * DELETED classes/files, property names, constants/enums,
member functions, which have been deprecated in DuMuX 2.5: member functions, which have been deprecated in DuMuX 2.5:
......
...@@ -6,17 +6,19 @@ Dune core modules: release 2.3 ...@@ -6,17 +6,19 @@ Dune core modules: release 2.3
Dune-PDELab: release 2.0 Dune-PDELab: release 2.0
dune-multidomaingrid: release branch 2.3 dune-multidomaingrid: release branch 2.3
dune-multidomain: release branch 2.0 dune-multidomain: release branch 2.0
For your convenience we provide the Shell script installRequiredModules.sh
in the same folder as this README. Alternatively, you can use the script
checkout-dumux from dumux.org/download/.
Install the external grid manager UG. Additional you need to install a Install the external grid manager UG and a direct linear solver like SuperLU
direct linear solver like SuperLU or PARDISO. or PARDISO. You need Boost fusion for dune-multidomaingrid.
You need Boost fusion for dune-multidomaingrid.
There are compiler restrictions: If UG is installed for parallel usage, dune-grid has to be patched. See the
- GCC 4.6 works. patches directory for more information.
- GCC 4.7 produces segmentation faults.
- GCC 4.8 and 4.9 works only with unoptimized builds (-O0). On some machines, some compilers with full optimization -O3 might produce
- Clang is not supported. executables that yield segmentation faults. In this case, reduce the
- Intel ICC is not tested. optimization level or try a different compiler. If you still encounter
segmentation faults, make sure that UG, all DUNE libraries and the executable
in question are built with the same compiler.
For your convenience we provide the Shell script installRequiredModules.sh
in the same folder as this README.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment