diff --git a/dumux/boxmodels/common/boxfvelementgeometry.hh b/dumux/boxmodels/common/boxfvelementgeometry.hh index b9727b1f5fbbfdefb08aa73581e7674eaf833353..f4d39737d23faa8ce72984e1ec6ec0637bcc3e2d 100644 --- a/dumux/boxmodels/common/boxfvelementgeometry.hh +++ b/dumux/boxmodels/common/boxfvelementgeometry.hh @@ -44,9 +44,8 @@ NEW_PROP_TAG(Scalar); // specialize member functions of template classes because of some // weird reason I didn't really get... -/*! - * \internal - */ +//!< \cond INTERNAL + template <typename BoxFVElementGeometry, int dim> class _BoxFVElemGeomHelper { @@ -57,9 +56,6 @@ public: }; }; -/*! - * \internal - */ template <typename BoxFVElementGeometry> class _BoxFVElemGeomHelper<BoxFVElementGeometry, 1> { @@ -73,9 +69,6 @@ public: } }; -/*! - * \internal - */ template <typename BoxFVElementGeometry> class _BoxFVElemGeomHelper<BoxFVElementGeometry, 2> { @@ -110,9 +103,6 @@ public: } }; -/*! - * \internal - */ template <typename BoxFVElementGeometry> class _BoxFVElemGeomHelper<BoxFVElementGeometry, 3> { @@ -286,6 +276,9 @@ public: } } }; + +//!< \endcond + // END HACK ///////////////////// @@ -567,7 +560,7 @@ public: bool inner; }; - struct SubControlVolumeFace + struct SubControlVolumeFace //! interior face of a sub control volume { int i,j; //!< scvf seperates corner i and j of elem FV ipLocal; //!< integration point in local coords @@ -577,7 +570,8 @@ public: Dune::FieldVector<Scalar, maxNC> shapeValue; //!< value of shape functions at ip }; - struct BoundaryFace { + struct BoundaryFace //! boundary face of a sub control volume + { FV ipLocal; //!< integration point in local coords FV ipGlobal; //!< integration point in global coords Scalar area; //!< area of boundary face diff --git a/dumux/boxmodels/common/pdelabboxassembler.hh b/dumux/boxmodels/common/pdelabboxassembler.hh index 443a635ba8efe3e801beb72be609b76ff1bb28ba..d3b36478f07bfe5c92697f29d26551eafbe8592b 100644 --- a/dumux/boxmodels/common/pdelabboxassembler.hh +++ b/dumux/boxmodels/common/pdelabboxassembler.hh @@ -28,7 +28,7 @@ namespace Dumux { namespace PDELab { -/* +/*! * \brief An assembler for the Jacobian matrix based on PDELab. */ template<class TypeTag> diff --git a/dumux/boxmodels/common/pdelabboxistlvectorbackend.hh b/dumux/boxmodels/common/pdelabboxistlvectorbackend.hh index d68959beb4b584e521b56d1deac27103ba8f88bc..ad08708ee31257d68f1ff8e67ac8741274eadb3f 100644 --- a/dumux/boxmodels/common/pdelabboxistlvectorbackend.hh +++ b/dumux/boxmodels/common/pdelabboxistlvectorbackend.hh @@ -96,7 +96,7 @@ public: } }; - // extract type of container element + //! extract type of container element template<class C> struct Value { diff --git a/dumux/boxmodels/common/pdelabboxlocaloperator.hh b/dumux/boxmodels/common/pdelabboxlocaloperator.hh index fb08945c8133c5623d17204ac2e53064579ad1c6..3f8ad4023077c3e098ecbbd8a52e656204e0cc9d 100644 --- a/dumux/boxmodels/common/pdelabboxlocaloperator.hh +++ b/dumux/boxmodels/common/pdelabboxlocaloperator.hh @@ -31,8 +31,6 @@ namespace Dumux { namespace PDELab { /*! - * \file - * * \brief A local operator for PDELab which wraps the box models. */ template<class TypeTag> diff --git a/dumux/common/fixedlengthspline_.hh b/dumux/common/fixedlengthspline_.hh index fe15c7b0830d10ac7498e419feb33521724c8b9f..7b577c3b7d5c0f0c3dc825ff29305be45a188248 100644 --- a/dumux/common/fixedlengthspline_.hh +++ b/dumux/common/fixedlengthspline_.hh @@ -27,10 +27,8 @@ namespace Dumux { - +//! \cond INTERNAL /*! - * \internal - * * \brief The common code for all 3rd order polynomial splines with * more than two sampling points. */ @@ -150,6 +148,8 @@ protected: BlockVector m_; }; +//! \endcond + } #endif diff --git a/dumux/common/pdelabpreconditioner.hh b/dumux/common/pdelabpreconditioner.hh index 7d10a56bc6de3aad3faa643d111d50e332c70a96..c5e60c311024fa0c6cf77d74e9afb71f52f316aa 100644 --- a/dumux/common/pdelabpreconditioner.hh +++ b/dumux/common/pdelabpreconditioner.hh @@ -44,6 +44,10 @@ NEW_PROP_TAG(ConstraintsTrafo); namespace PDELab { + +/*! + * \brief exchanges matrix entries for parallel computations + */ template<class TypeTag> class Exchanger { @@ -67,6 +71,7 @@ class Exchanger typedef typename Dune::GenericReferenceElement<CoordScalar, dim> ReferenceElement; public: + Exchanger(const Problem& problem) : gridView_(problem.gridView()), vertexMapper_(problem.vertexMapper()), borderIndices_(0) { @@ -96,6 +101,9 @@ public: } } + /*! + * \brief matrix entry for the MatEntryExchange class + */ struct MatEntry { IdType first; @@ -104,7 +112,9 @@ public: MatEntry () {} }; - // A DataHandle class to exchange matrix entries + /*! + * \brief A DataHandle class to exchange matrix entries + */ class MatEntryExchange : public Dune::CommDataHandleIF<MatEntryExchange,MatEntry> { @@ -242,7 +252,9 @@ private: std::vector<int> borderIndices_; }; -// wrapped sequential preconditioner +/*! + * \brief Wrapper for a sequential preconditioner + */ template<class CC, class GFS, class P> class NonoverlappingWrappedPreconditioner : public Dune::Preconditioner<typename P::domain_type,typename P::range_type> @@ -313,6 +325,9 @@ private: const Dune::PDELab::ParallelISTLHelper<GFS>& helper; }; +/*! + * \brief backend for an ISTL parallel ILU preconditioned BiCGSTAB solver + */ template<class TypeTag> class ISTLBackend_NoOverlap_BCGS_ILU { @@ -400,6 +415,9 @@ private: Exchanger<TypeTag> exchanger_; }; +/*! + * \brief backend for an ISTL parallel Pardiso preconditioned loop solver + */ template<class TypeTag> class ISTLBackend_NoOverlap_Loop_Pardiso { diff --git a/dumux/common/spline.hh b/dumux/common/spline.hh index fca6d3e2058890cc36e6fdc940ca59f688d65f24..d0aa63d8961455c15af6060322e88cc9b54009e7 100644 --- a/dumux/common/spline.hh +++ b/dumux/common/spline.hh @@ -108,7 +108,7 @@ public: { this->set(points, m0, m1); } }; -/* +/*! * \brief Specialization of a spline with the number of sampling * points only known at run time. * @@ -128,8 +128,6 @@ public: s''(x_n) & = 0 \f} */ - - template<class Scalar> class Spline<Scalar, -1> : public VariableLengthSpline_<Scalar> { diff --git a/dumux/common/splinecommon_.hh b/dumux/common/splinecommon_.hh index 0b7536babc673b935a83d55dbec0d96874e0a76d..b8c804ebad174d1a9e5d387051e66d59b59328b1 100644 --- a/dumux/common/splinecommon_.hh +++ b/dumux/common/splinecommon_.hh @@ -29,8 +29,8 @@ namespace Dumux { +//! \cond INTERNAL /*! - * \internal * * \brief The common code for all 3rd order polynomial splines. */ @@ -589,6 +589,8 @@ protected: { return asImp_().numSamples(); } }; +//! \endcond + } #endif diff --git a/dumux/common/variablelengthspline_.hh b/dumux/common/variablelengthspline_.hh index 1d2b7f31bcbf691a97d061b1144f036da23d083d..2de1de2870e7699b8777125feec5892183659213 100644 --- a/dumux/common/variablelengthspline_.hh +++ b/dumux/common/variablelengthspline_.hh @@ -28,10 +28,8 @@ namespace Dumux { - +//! \cond INTERNAL /* - * \internal - * * \brief The common code for all 3rd order polynomial splines with * where the number of sampling points only known at run-time. */ @@ -209,7 +207,7 @@ protected: Vector yPos_; Vector m_; }; - +//! \endcond } #endif diff --git a/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaopressure2p.hh b/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaopressure2p.hh index 9607620c262969e3cf02d566d4fa3a1ccb6a17ce..1ce4f8feb96240345f0b1e43913da1a96553afb4 100644 --- a/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaopressure2p.hh +++ b/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaopressure2p.hh @@ -41,9 +41,11 @@ namespace Dumux { -//! \ingroup MPFA2p -//! Base class for defining an instance of a numerical diffusion model. -/*! An interface for defining a numerical diffusion model for the +/*! \ingroup MPFA2p + * + * \brief MPFA-O method for the pressure equation + * + * An interface for defining a numerical diffusion model for the * solution of equations of the form * \f$ - \text{div}\, (\lambda K \text{grad}\, p ) = 0, \f$, * \f$p = g\f$ on \f$\Gamma_1\f$, and diff --git a/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaovelocity2p.hh b/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaovelocity2p.hh index 118ff7a63490354ed23acc773dc8af642ddf6295..824ed06e8cdee4d830d0e327c50743966cdaead9 100644 --- a/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaovelocity2p.hh +++ b/dumux/decoupled/2p/diffusion/fvmpfa/fvmpfaovelocity2p.hh @@ -28,7 +28,10 @@ namespace Dumux { -//! \ingroup MPFA2p +/*! \ingroup MPFA2p + * + * \brief velocity calculation for the MPFA-O method + */ template<class TypeTag> class FVMPFAOVelocity2P: public FVMPFAOPressure2P<TypeTag> { typedef FVMPFAOVelocity2P<TypeTag> ThisType; diff --git a/dumux/decoupled/2p/diffusion/mimetic/mimeticpressure2p.hh b/dumux/decoupled/2p/diffusion/mimetic/mimeticpressure2p.hh index 6200f014ab0db12e94ff031f8726552073ab3501..c14e11134c8fc83dcae222167e6813b2d5ba3e09 100644 --- a/dumux/decoupled/2p/diffusion/mimetic/mimeticpressure2p.hh +++ b/dumux/decoupled/2p/diffusion/mimetic/mimeticpressure2p.hh @@ -36,9 +36,11 @@ namespace Dumux { -//! \ingroup mimetic -//! mimetic Diffusion Model -/*! Provides a mimetic implementation for the evaluation +/*! \ingroup mimetic + * + * \brief mimetic method for the pressure equation + * + * Provides a mimetic implementation for the evaluation * of equations of the form * \f[\text{div}\, \boldsymbol{v}_{total} = q.\f] * The definition of the total velocity \f$\boldsymbol{v}_total\f$ depends on the kind of pressure chosen. This could be a wetting (w) phase pressure leading to diff --git a/dumux/io/outputToFile.hh b/dumux/io/outputToFile.hh index 0432e00bda431e37c5e1064bf6232c2cc0aa7bd9..cc230dd9c4eb88591da7b3f35c358f071867db67 100644 --- a/dumux/io/outputToFile.hh +++ b/dumux/io/outputToFile.hh @@ -50,7 +50,7 @@ namespace Properties } -/* +/*! * \brief A collection of functions for output purposes. * These output files are meant for visualization with another program (matlab, gnuplot...) */ diff --git a/dumux/material/fluidsystems/gasphase.hh b/dumux/material/fluidsystems/gasphase.hh index 017dc5318d345a2a212531624178558fe91ced74..93a9eaa27e17423fcb38edc7c76dd25ce6338c3a 100644 --- a/dumux/material/fluidsystems/gasphase.hh +++ b/dumux/material/fluidsystems/gasphase.hh @@ -23,7 +23,11 @@ namespace Dumux { -template <class Scalar, class ComponentT> class GasPhase +/*! + * \brief gaseous phase consisting of a single component + */ +template <class Scalar, class ComponentT> +class GasPhase { public: typedef ComponentT Component; diff --git a/dumux/material/fluidsystems/liquidphase.hh b/dumux/material/fluidsystems/liquidphase.hh index 9039ff3677f5ac0499c84921b8e5a417060f8781..ad523aa44e5509824415e7dfb9ea75d6ca4fee0f 100644 --- a/dumux/material/fluidsystems/liquidphase.hh +++ b/dumux/material/fluidsystems/liquidphase.hh @@ -23,7 +23,11 @@ namespace Dumux { -template <class Scalar, class ComponentT> class LiquidPhase +/*! + * \brief liquid phase consisting of a single component + */ +template <class Scalar, class ComponentT> +class LiquidPhase { public: typedef ComponentT Component; diff --git a/dumux/nonlinear/newtoncontroller.hh b/dumux/nonlinear/newtoncontroller.hh index dc78336cea393886380729a068e9608ac0577aa5..90056bf76c8b3a3de35399ba0eb3ac086e569530 100644 --- a/dumux/nonlinear/newtoncontroller.hh +++ b/dumux/nonlinear/newtoncontroller.hh @@ -105,8 +105,8 @@ SET_PROP_DEFAULT(NewtonUseLineSearch) }; }; +//! \cond INTERNAL /*! - * \internal * \brief Writes the intermediate solutions during * the Newton scheme */ @@ -166,7 +166,6 @@ private: }; /*! - * \internal * \brief Writes the intermediate solutions during * the Newton scheme. * @@ -201,6 +200,7 @@ struct NewtonConvergenceWriter<TypeTag, false> void endTimestep() { }; }; +//! \endcond /*! * \brief A reference implementation of a newton controller specific diff --git a/test/boxmodels/2p/test_2p.cc b/test/boxmodels/2p/test_2p.cc index 425981318ee9b944a6635721fa14ad49bb530e0f..1ee83b27cdadfed233eb0d042b81482e01ea24e2 100644 --- a/test/boxmodels/2p/test_2p.cc +++ b/test/boxmodels/2p/test_2p.cc @@ -34,6 +34,7 @@ #include <iostream> #include <boost/format.hpp> +//! \cond INTERNAL //////////////////////// // helper class for grid instantiation //////////////////////// @@ -132,6 +133,7 @@ public: }; }; +//! \endcond //////////////////////// // the main function diff --git a/test/decoupled/1p/benchmarkresult.hh b/test/decoupled/1p/benchmarkresult.hh index e71530b4ccd4271705127d488c4380e9781c44ab..6e07feb2060d190f8598acc77e892afe93d624f9 100644 --- a/test/decoupled/1p/benchmarkresult.hh +++ b/test/decoupled/1p/benchmarkresult.hh @@ -24,26 +24,31 @@ namespace Dumux { -template<int dim> -struct ElementLayout -{ - bool contains (Dune::GeometryType gt) - { - return gt.dim() == dim; - } -}; - -template<int dim> -struct FaceLayout -{ - bool contains (Dune::GeometryType gt) - { - return gt.dim() == dim-1; - } -}; - +/*! + * \brief calculate errors for a FVCA5 benchmark problem + */ struct BenchmarkResult { +private: + template<int dim> + struct ElementLayout + { + bool contains (Dune::GeometryType gt) + { + return gt.dim() == dim; + } + }; + + template<int dim> + struct FaceLayout + { + bool contains (Dune::GeometryType gt) + { + return gt.dim() == dim-1; + } + }; + +public: double relativeL2Error; double ergrad; double ervell2; @@ -308,8 +313,31 @@ struct BenchmarkResult } }; +/*! + * \brief calculate errors for a FVCA5 benchmark problem + */ struct ResultEvaluation { +private: + template<int dim> + struct ElementLayout + { + bool contains (Dune::GeometryType gt) + { + return gt.dim() == dim; + } + }; + + template<int dim> + struct FaceLayout + { + bool contains (Dune::GeometryType gt) + { + return gt.dim() == dim-1; + } + }; + +public: double relativeL2Error; double ergrad; double ervell2; diff --git a/test/decoupled/1p/test_1p_problem.hh b/test/decoupled/1p/test_1p_problem.hh index ae51fe6134fbd5c6facfe77a6cf961409e65c024..54e840be6acfcea66b7b4edbcf6aaea9a1e7c69e 100644 --- a/test/decoupled/1p/test_1p_problem.hh +++ b/test/decoupled/1p/test_1p_problem.hh @@ -91,8 +91,10 @@ SET_TYPE_PROP(TestProblemOneP, Problem, Dumux::TestProblemOneP<TTAG(TestProblemO } /*! -* \ingroup DecoupledProblems -*/ + * \ingroup DecoupledProblems + * + * \brief test problem for the decoupled one-phase model. + */ template<class TypeTag = TTAG(TestProblemOneP)> class TestProblemOneP: public DiffusionProblem1P<TypeTag, TestProblemOneP<TypeTag> > { diff --git a/test/decoupled/1p/test_diffusion_problem.hh b/test/decoupled/1p/test_diffusion_problem.hh index 238e47250218b2a9322951ac457d80eb672eca2f..9e4f0b70e4643f4c287cd080f1c449dcab8e2365 100644 --- a/test/decoupled/1p/test_diffusion_problem.hh +++ b/test/decoupled/1p/test_diffusion_problem.hh @@ -43,6 +43,7 @@ namespace Dumux { +//! \cond INTERNAL struct FileNames { enum @@ -50,6 +51,7 @@ struct FileNames TPFAName = 0, MPFAName = 1, MimeticName = 2 }; }; +//! \endcond template<class TypeTag> class TestDiffusionProblem; @@ -140,8 +142,10 @@ SET_TYPE_PROP(MimeticPressure2PTestProblem, Problem, Dumux::TestDiffusionProblem } /*! -* \ingroup DecoupledProblems -*/ + * \ingroup DecoupledProblems + * + * \brief test problem for diffusion models from the FVCA5 benchmark. + */ template<class TypeTag = TTAG(DiffusionTestProblem)> class TestDiffusionProblem: public DiffusionProblem2P<TypeTag, TestDiffusionProblem<TypeTag> > { diff --git a/test/decoupled/1p/test_diffusion_spatialparams.hh b/test/decoupled/1p/test_diffusion_spatialparams.hh index 17f1725e07640321e964f7fc0b11a18f609c16b6..fd392174413e82e9c8c827786866678720d14a13 100644 --- a/test/decoupled/1p/test_diffusion_spatialparams.hh +++ b/test/decoupled/1p/test_diffusion_spatialparams.hh @@ -28,8 +28,9 @@ namespace Dumux { -/** \todo Please doc me! */ - +/*! + * \brief spatial parameters for the test problem for diffusion models. + */ template<class TypeTag> class TestDiffusionSpatialParams { diff --git a/test/decoupled/2p/test_impes_problem.hh b/test/decoupled/2p/test_impes_problem.hh index 163645408483858ae06263a9604b08abd1225090..5f35b6a029dad531a7c9cda76afdb9da51eb3cee 100644 --- a/test/decoupled/2p/test_impes_problem.hh +++ b/test/decoupled/2p/test_impes_problem.hh @@ -127,6 +127,8 @@ SET_SCALAR_PROP(IMPESTestProblem, CFLFactor, 0.95); /*! * \ingroup DecoupledProblems + * + * \brief test problem for the sequential 2p model */ template<class TypeTag = TTAG(IMPESTestProblem)> class TestIMPESProblem: public IMPESProblem2P<TypeTag, TestIMPESProblem<TypeTag> > diff --git a/test/decoupled/2p/test_impes_spatialparams.hh b/test/decoupled/2p/test_impes_spatialparams.hh index edc328ddd8ce95767f350734d67c924933758331..cab3c4125bec45439ee67f3e70a6dfe9a8113e7d 100644 --- a/test/decoupled/2p/test_impes_spatialparams.hh +++ b/test/decoupled/2p/test_impes_spatialparams.hh @@ -29,8 +29,9 @@ namespace Dumux { -/** \todo Please doc me! */ - +/*! + * \brief spatial parameters for the sequential 2p test + */ template<class TypeTag> class TestIMPESSpatialParams { diff --git a/test/decoupled/2p/test_transport_problem.hh b/test/decoupled/2p/test_transport_problem.hh index f1ae6af9cff8033616fee80ea11284d5c57d3646..f53d75884624065cf5820f64b1ff8acca150360b 100644 --- a/test/decoupled/2p/test_transport_problem.hh +++ b/test/decoupled/2p/test_transport_problem.hh @@ -108,6 +108,8 @@ SET_SCALAR_PROP(TransportTestProblem, CFLFactor, 1.0); /*! * \ingroup DecoupledProblems + * + * \brief test problem for the explicit transport model */ template<class TypeTag = TTAG(TransportTestProblem)> class TestTransportProblem: public TransportProblem2P<TypeTag, TestTransportProblem<TypeTag> > diff --git a/test/decoupled/2p/test_transport_spatialparams.hh b/test/decoupled/2p/test_transport_spatialparams.hh index 0424c3519bbd5e82b10b6226fd64f810807c4e36..14e3fd6d0e278b8ec66b99f4b9b54bba317fcc28 100644 --- a/test/decoupled/2p/test_transport_spatialparams.hh +++ b/test/decoupled/2p/test_transport_spatialparams.hh @@ -29,8 +29,9 @@ namespace Dumux { -/** \todo Please doc me! */ - +/*! + * \brief spatial parameters for the explicit transport test + */ template<class TypeTag> class TestTransportSpatialParams { diff --git a/test/decoupled/2p2c/test_dec2p2c_spatialparams.hh b/test/decoupled/2p2c/test_dec2p2c_spatialparams.hh index dca0ec2492ef570a66685e3f0cd7f67d7ba80807..4c78fccda37e041f64a8fbf8ef454643b9bf3a1d 100644 --- a/test/decoupled/2p2c/test_dec2p2c_spatialparams.hh +++ b/test/decoupled/2p2c/test_dec2p2c_spatialparams.hh @@ -29,8 +29,9 @@ namespace Dumux { -/** \todo Please doc me! */ - +/*! + * \brief spatial parameters for the sequential 2p2c test + */ template<class TypeTag> class Test2P2CSpatialParams { diff --git a/test/decoupled/2p2c/test_dec2p2cproblem.hh b/test/decoupled/2p2c/test_dec2p2cproblem.hh index ac23feb361afcb3f1b361ef82c5fa4aa6fbece4a..6371eef46237bd30bcd45c16c003a825477c1b44 100644 --- a/test/decoupled/2p2c/test_dec2p2cproblem.hh +++ b/test/decoupled/2p2c/test_dec2p2cproblem.hh @@ -119,6 +119,8 @@ SET_SCALAR_PROP(TestTwoPTwoCProblem, CFLFactor, 0.8); /*! * \ingroup DecoupledProblems + * + * \brief test problem for the sequential 2p2c model */ template<class TypeTag = TTAG(TestTwoPTwoCProblem)> class TestTwoPTwoCProblem: public IMPETProblem2P2C<TypeTag, TestTwoPTwoCProblem<TypeTag> >