modules.txt 19.4 KB
Newer Older
Benjamin Faigle's avatar
 
Benjamin Faigle committed
1
/*!
2
3
4
 * \file
 *
 * \brief This file contains all module definitions for the doxygen documentation.
5
 *
Benjamin Faigle's avatar
 
Benjamin Faigle committed
6
 */
7

8
/* ***************** Porousmediumflow ******************/
9
/*!
10
 * \defgroup PorousmediumflowModels Porous-Medium Flow Models
11
 * \brief Single and multi-phase models for flow and transport in porous materials
12
 */
13
    /*!
14
     * \ingroup PorousmediumflowModels
15
     * \defgroup OnePModel 1p
16
     * \brief Single-phase (immiscible) Darcy flow
17
18
19
20
21
     * \copydetails ./porousmediumflow/1p/model.hh
     */
       /*!
        * \ingroup OnePModel
        * \defgroup SequentialOnePModel Sequential
22
23
        * \brief Sequential single-phase (immiscible) Darcy flow
        *
24
25
        * # Pressure
        * \copydetails ./porousmediumflow/1p/sequential/diffusion/cellcentered/pressure.hh
26
        *
27
28
29
30
31
        * # Velocity
        * \copydetails ./porousmediumflow/1p/sequential/diffusion/cellcentered/velocity.hh
        */
    /*!
     * \ingroup PorousmediumflowModels
32
     * \defgroup OnePNCModel 1pnc
33
     * \brief Single-phase, multi-component Darcy flow
34
     * \copydetails ./porousmediumflow/1pnc/model.hh
35
     */
36
    /*!
37
     * \ingroup PorousmediumflowModels
38
     * \defgroup OnePNCMinModel 1pncmin
39
     * \brief Single-phase, multi-component Darcy flow with mineralization
40
     * \copydetails ./porousmediumflow/1pncmin/model.hh
41
     */
42
    /*!
43
     * \ingroup PorousmediumflowModels
44
     * \defgroup TwoPModel 2p
45
     * \brief Two-phase (immiscible) Darcy flow
46
     * \copydetails ./porousmediumflow/2p/model.hh
47
     */
48
        /*!
49
50
         * \ingroup TwoPModel
         * \defgroup SequentialTwoPModel Sequential
51
52
         * \brief Sequential two-phase (immiscible) Darcy flow
         *
53
54
         * # Pressure
         * \copydetails ./porousmediumflow/2p/sequential/diffusion/cellcentered/pressure.hh
55
         *
56
57
         * # Velocity
         * \copydetails ./porousmediumflow/2p/sequential/diffusion/cellcentered/velocity.hh
58
         */
59
    /*!
60
     * \ingroup PorousmediumflowModels
61
     * \defgroup TwoPOneCModel 2p1c
62
     * \brief Two-phase, one-component Darcy flow
63
     * \copydetails ./porousmediumflow/2p1c/model.hh
64
     */
65
    /*!
66
     * \ingroup PorousmediumflowModels
67
     * \defgroup TwoPTwoCModel 2p2c
68
     * \brief Two-phase, two-component Darcy flow
69
     * \copydetails ./porousmediumflow/2p2c/model.hh
70
     */
71
        /*!
72
73
         * \ingroup TwoPTwoCModel
         * \defgroup SequentialTwoPTwoCModel Sequential
74
75
         * \brief Sequential two-phase, two-component Darcy flow
         *
76
77
         * # Pressure
         * \copydetails ./porousmediumflow/2p2c/sequential/fvpressure.hh
78
         *
79
80
         * # Velocity
         * \copydetails ./porousmediumflow/2p2c/sequential/fvtransport.hh
81
         */
82
    /*!
83
     * \ingroup PorousmediumflowModels
84
85
     * \defgroup TwoPNCModel 2pnc
     * \brief two-phase, multi-component Darcy flow
86
     * \copydetails ./porousmediumflow/2pnc/model.hh
87
88
     */
    /*!
89
     * \ingroup PorousmediumflowModels
90
     * \defgroup TwoPNCMinModel 2pncmin
91
     * \brief Two-phase, multi-component Darcy flow with mineralization
92
     * \copydetails ./porousmediumflow/2pncmin/model.hh
93
     */
94
    /*!
95
     * \ingroup PorousmediumflowModels
96
     * \defgroup ThreePModel 3p
97
     * \brief Three-phase (immiscible) Darcy flow
98
     * \copydetails ./porousmediumflow/3p/model.hh
99
100
     */
    /*!
101
     * \ingroup PorousmediumflowModels
102
     * \defgroup ThreePThreeCModel 3p3c
103
     * \brief Three-phase, three-component Darcy flow
104
     * \copydetails ./porousmediumflow/3p3c/model.hh
105
     */
106
    /*!
107
     * \ingroup PorousmediumflowModels
108
     * \defgroup ThreePWaterOilModel 3pwateroil
109
     * \brief Three-phase, two-component Darcy flow with water (liquid & gas) and oil
110
     * \copydetails ./porousmediumflow/3pwateroil/model.hh
111
     */
112
    /*!
113
     * \ingroup PorousmediumflowModels
114
     * \defgroup CO2Model CO2
115
     * \brief Two-phase, two-component Darcy flow specialized for supercritical CO<sub>2</sub> storage
116
     * \copydetails ./porousmediumflow/co2/model.hh
117
     */
118
    /*!
119
     * \ingroup PorousmediumflowModels
120
     * \defgroup MineralizationModel mineralization
121
     * \brief Model adding components that can precipitate as a solid phase to a standard Darcy flow model
122
     *
123
     * \copydetails ./porousmediumflow/mineralization/model.hh
124
     */
125
    /*!
126
     * \ingroup PorousmediumflowModels
127
     * \defgroup MPNCModel mpnc
128
     * \brief Generalized multi-phase, multi-component Darcy flow
129
     *
130
     * \copydetails ./porousmediumflow/mpnc/model.hh
131
     */
132
133
134
    /*!
     * \ingroup PorousmediumflowModels
     * \defgroup PorousmediumNonEquilibriumModel NonEquilibrium 
135
     * \brief Model that adds nonequilibrium equations to another porous medium flow model (only used in MPNCModel currently)
136
137
     * \copydetails ./porousmediumflow/nonequilibrium/model.hh
     */
138
		/*!
139
140
         * \ingroup PorousmediumNonEquilibriumModel
         * \defgroup PorousmediumThermalNonEquilibriumModel ThermalNonEquilibrium
141
         * \brief Model that adapts the energy localresidual to thermal nonequilibrium
142
143
         * \copydetails ./porousmediumflow/nonequilibrium/thermal/localresidual.hh
         */
144
    /*!
145
     * \ingroup PorousmediumflowModels
146
     * \defgroup NIModel nonisothermal
147
     * \brief Model that adds an energy equation (thermal equilibrium) to another porous medium flow model
148
     *
149
     * \copydetails ./porousmediumflow/nonisothermal/model.hh
150
     */
151
    /*!
152
     * \ingroup PorousmediumflowModels
153
154
     * \defgroup RichardsModel Richards
     * \brief Richards flow
155
     * \copydetails ./porousmediumflow/richards/model.hh
156
157
     */
    /*!
158
     * \ingroup PorousmediumflowModels
159
160
     * \defgroup RichardsNCModel Richards nc
     * \brief Richards multi-component flow
161
     * \copydetails ./porousmediumflow/richardsnc/model.hh
162
163
     */
    /*!
164
     * \ingroup PorousmediumflowModels
165
166
     * \defgroup TracerModel Tracer
     * \brief Multi-component advection-diffusion-reaction model with given velocity field
167
     * \copydetails ./porousmediumflow/tracer/model.hh
168
     */
169

170
/* ***************** FreeflowModels ******************/
171
/*!
172
 * \defgroup FreeflowModels Free Flow Models
173
 * \brief Single-phase Navier-Stokes / Stokes model
174
 */
175
	/*!
176
     * \ingroup FreeflowModels
177
178
     * \defgroup NavierStokesModel Navier-Stokes
     * \brief Single-phase Navier-Stokes flow
179
     * \copydetails ./freeflow/navierstokes/model.hh
180
181
     */
    /*!
182
     * \ingroup FreeflowModels
183
184
     * \defgroup NavierStokesNCModel Navier-Stokes nc
     * \brief Single-phase multi-component Navier-Stokes flow
185
     * \copydetails ./freeflow/navierstokesnc/model.hh
186
     */
187
    /*!
188
     * \ingroup FreeflowModels
189
     * \defgroup NavierStokesNIModel nonisothermal
190
     * \brief An energy equation adaptor for isothermal Navier-Stokes models
191
     * \copydetails ./freeflow/nonisothermal/model.hh
192
     */
193
194
195
196
197
198
199
200
201
202
203
204
    /*!
     * \ingroup FreeflowModels
     * \defgroup RANSModel Reynolds-Averaged Navier-Stokes
     * \brief Single-phase Reynolds-Averaged Navier-Stokes flow
     * \copydetails ./freeflow/rans/model.hh
     */
      /*!
      * \ingroup RANSModel
      * \defgroup ZeroEqModel 0-Eq. Models
      * \brief Zero-equation or algebraic turbulence models
      * \copydetails ./freeflow/rans/model.hh
      */
205

206
/* ***************** Benchmarks and Tests ******************/
207
/*!
208
 * \defgroup BenchmarksAndTests Benchmarks and Tests
209
 * \brief Benchmarks and tests used for (automated) testing and demonstration purposes
210
 */
211
212
213
214
 	/*! 
 	 * \ingroup BenchmarksAndTests
 	 * \defgroup PorousmediumflowTests Porous-Medium Flow Tests
 	 * \brief Single and multi-phase tests for flow and transport in porous materials
215
 	 */
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
 	 	/*! 
 	     * \ingroup PorousmediumflowTests
 	 	 * \defgroup OnePTests 1p (one phase) benchmarks and tests
 	     * \brief Various tests using a OnePModel. The files are listed below.
 	     */
 		/*!  
 	     * \ingroup PorousmediumflowTests
 	 	 * \defgroup OnePNCTests 1pnc (one phase, multi-component) benchmarks and tests
 	 	 * \brief Various tests using a OnePNCModel. The files are listed below.
 	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup OnePNCMinTests 1pncmin (one phase, multi-component mineralization) benchmarks and tests
	     * \brief Various tests using the OnePNCMinModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TwoPTests 2p (two phase) benchmarks and tests
	 	 * \brief Various tests using a TwoPModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TwoPOneCTests 2p1c (two phase, one component) benchmarks and tests
	  	 * \brief Various tests using the TwoPOneCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TwoPTwoCTests 2p2c (two phase, two component) benchmarks and tests
	 	 * \brief Various tests using a TwoPTwoCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TwoPNCTests 2pnc (two phase, multi-component) benchmarks and tests
	 	 * \brief A fuel cell test problem using the TwoPNCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TwoPNCMinTests 2pncmin (two phase, multi-component mineralization) benchmarks and tests
	 	 * \brief A salt dissolution test problem using the TwoPNCMinModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup ThreePTests 3p (three phase) benchmarks and tests
	 	 * \brief Various tests using a ThreePModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup ThreePThreeCTests 3p3c (three phase, three component) benchmarks and tests
	 	 * \brief Various tests using a ThreePThreeCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup ThreePWaterOilTests 3pwateroil (three phase, water oil) benchmarks and tests
	 	 * \brief A SAGD test problem using the ThreePWaterOilModel. The files are listed below.
	 	 */
		/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup CO2Tests CO2 (two phase, two component) benchmarks and tests
	 	 * \brief A CO2 injection test problem using the TwoPTwoCModel and heterogeneous spatial parameters. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup MPNCTests MPNC (multi-phase, multi-component) benchmarks and tests
	     * \brief Various tests using the MPNCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup RichardsTests Richards benchmarks and tests
	 	 * \brief Various tests using a RichardsModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup RichardsNCTests Richards multi-component benchmarks and tests
	 	 * \brief A multi-component transport problem in the unsaturated zone using the RichardsNCModel. The files are listed below.
	 	 */
	 	/*!  
 	     * \ingroup PorousmediumflowTests
	 	 * \defgroup TracerTests Tracer benchmarks and tests
	 	 * \brief Various tests using a TracerModel. The files are listed below.
	 	 */
	/*!  
 	 * \ingroup BenchmarksAndTests
 	 * \defgroup FreeflowTests Free Flow Tests
299
 	 * \brief Varios tests for single-phase Navier-Stokes / Stokes tests
300
 	 */
301
302
 	  	/*!  
 	     * \ingroup FreeflowTests
303
304
	 	 * \defgroup NavierStokesTests Single-phase Navier-Stokes tests
	 	 * \brief Various tests using a Single-phase Navier-Stokes flow. The files are listed below.
305
306
307
	 	 */
	   	/*!  
 	     * \ingroup FreeflowTests
308
309
	 	 * \defgroup NavierStokesNCTests Single-phase Navier-Stokes nc tests
	 	 * \brief Various tests using a Single-phase Navier-Stokes flow. The files are listed below.
310
311
312
313
314
	 	 */
	/*!  
 	 * \ingroup BenchmarksAndTests
 	 * \defgroup MaterialTests Material system tests
 	 * \brief Benchmarks and Test(s) for the material system.
315
 	 */
316

317
/* ***************** Discretization ******************/
318
/*!
319
 * \defgroup Discretization Discretization schemes
320
 * \brief The discretization schemes available in DuMu<sup>x</sup>
321
 */
322
    /*!
323
     * \ingroup Discretization
324
     * \defgroup BoxDiscretization Box FV scheme
325
     * \brief The box method is a collocated finite volume scheme with control volumes centered at grid nodes.
326
327
     */
    /*!
328
     * \ingroup Discretization
329
     * \defgroup CCDiscretization Cell-centered FV scheme
330
     * \brief Finite volume schemes with degrees of freedom located at grid cell centers.
331
332
     */	
        /*!
333
         * \ingroup CCDiscretization
334
         * \defgroup CCTpfaDiscretization Two-point flux approximation (Tpfa)
335
         * \brief A cell-centered finite volume scheme with two-point flux approximation.
336
         */
337
        /*!
338
         * \ingroup CCDiscretization
339
         * \defgroup CCMpfaDiscretization Multi-point flux approximation (Mpfa)
340
         * \brief A cell-centered finite volume scheme with multi-point flux approximation.
341
342
         */
    /*!
343
     * \ingroup Discretization
344
     * \defgroup StaggeredDiscretization Staggered FV scheme
345
     * \brief A staggered finite volume scheme with degrees of freedom at cell-centers and facets.
346
347
     */

348
/* ***************** Material ******************/
349
/*!
350
 * \defgroup Material Material and Fluid Framework
351
352
 * \brief The DuMu<sup>x</sup> material and fluid framework with constitutive laws and physics
 * \par
353
354
 * Short description of the most important concepts of the material and fluid framework:
 *
355
356
357
358
359
 *  - __Binary coefficient:__ <br>  @copydoc Binarycoefficients
 *  - __Chemistry:__ <br> @copydoc Chemistry
 *  - __Component:__ <br> @copydoc Components
 *  - __Constraint solver:__ <br> @copydoc ConstraintSolver
 *  - __Equation of state:__ <br> @copydoc EOS
360
 *  - __Fluid-Matrix Interactions:__ <br> @copydoc Fluidmatrixinteractions
361
362
363
 *  - __Fluid state:__ <br> @copydoc FluidStates
 *  - __Fluid system:__ <br> @copydoc Fluidsystems
 *  - __Spatial Parameters:__ <br> @copydoc SpatialParameters
Benjamin Faigle's avatar
 
Benjamin Faigle committed
364
 */
365
	/*!
366
367
     * \ingroup Material
     * \defgroup Binarycoefficients Binary Coefficients
368
     * \brief Binary coefficients
369
     *
370
371
372
373
374
     *  Binary coefficients describe the relations
     *  of a mixture of two components. Typical binary coefficients are
     *  Henry coefficients or binary molecular diffusion
     *  coefficients. So far, the programming interface for accessing binary
     *  coefficients has not been standardized in Dumux.
375
     */
376
377
378
    /*!
     * \ingroup Material
     * \defgroup Chemistry Chemistry
379
     * \brief Chemical reactions
380
     *
381
382
383
384
385
     * Chemical reactions can be relevant for all thermodynamic relations
     * for the liquid and gas phase of multiple chemical species
     * The main purpose is to provide a convenient way to access these
     * relationships via source or sink terms.
     */
386
387
388
    /*!
     * \ingroup Material
     * \defgroup Components Components
Bernd Flemisch's avatar
Bernd Flemisch committed
389
     * \brief thermodynamics of single chemical species or fixed mixtures of species
390
     *
Bernd Flemisch's avatar
Bernd Flemisch committed
391
392
393
394
     * Components provide the thermodynamic relations for the liquid,
     * gaseous and/or solid state of a single
     * chemical species or a _fixed_ mixture of species.
     * Fluid systems use components to compute thermodynamic quantities of phases.
395
     */
396
		/*!
397
398
         * \ingroup Components
         * \defgroup IAPWS IAPWS
399
         * \brief Tabulated values according to the International Association for the Properties of Water and Steam (IAPWS)
400
         */
401
    /*!
402
     * \ingroup Material
403
     * \defgroup ConstraintSolver Constraint Solver
404
     * \brief Constraint solvers converting primary to secondary variables
405
     *
406
407
408
409
410
     * Constraint solvers are auxiliary tools to
     * make sure that a fluid state is consistent with some thermodynamic
     * constraints. All constraint solvers specify a well defined set of
     * input variables and make sure that the resulting fluid state is
     * consistent with a given set of thermodynamic equations.
411
412
413
414
415
     * Constraint solvers connect the thermodynamic relations expressed by
     * fluid systems with the thermodynamic quantities stored by fluid
     * states. Using them is not mandatory for models, but given the fact
     * that some thermodynamic constraints can be quite complex to solve,
     * sharing this code between models makes sense.
416
     */
417
418
419
    /*!
     * \ingroup Material
     * \defgroup EOS Equation of State
420
     * \brief Equations of state
421
     *
422
423
424
425
426
     * Equations of state (EOS) are auxiliary
     * classes which provide relations between a fluid phase's temperature,
     * pressure, composition and density. Since these classes are only used
     * internally in fluid systems, their programming interface is
     * currently ad-hoc.
427
     */
428
429
    /*!
     * \ingroup Material
430
     * \defgroup Fluidmatrixinteractions Fluid-Matrix Interactions
431
432
     * \brief e.g. pc-Sw, kr-Sw relations, effective diffusion coefficients
     *
433
434
435
436
437
     * Some parameters are functions of the fluid state as well as parameters of
     * the matrix. For example the capillary pressure is a function of the phase saturation
     * and the shape parameter \f$\lambda\f$ which is dependent on the material. All such relations
     * are gathered in this module.
     */
438
    /*!
Thomas Fetzer's avatar
Thomas Fetzer committed
439
440
     * \ingroup Material
     * \defgroup FluidStates Fluid States
441
     * \brief Fluid states are responsible for representing the
442
     * complete thermodynamic configuration of a system at a given spatial
443
444
445
     * and temporal position.
     *
     * A fluid state always provides access methods
446
447
448
449
450
     * to __all__ thermodynamic quantities, but the concept of a fluid state does not
     * mandate what assumptions are made to store these thermodynamic
     * quantities. What fluid states also do __not__ do is to make sure
     * that the thermodynamic state which they represent is physically
     * possible.
451
452
453
454
     */
    /*!
     * \ingroup Material
     * \defgroup Fluidsystems Fluid Systems
455
456
457
458
459
460
461
     * \brief Fluid systems express the thermodynamic relations (functions).
     *
     * Since functions do
     *  not exhibit any internal state, fluid systems are stateless classes,
     *  i.e. all member functions are static. This is a conscious
     *  decision since the thermodynamic state of the system is expressed by
     *  a fluid state!
Thomas Fetzer's avatar
Thomas Fetzer committed
462
     */
463
464
465
    /*!
     * \ingroup Material
     * \defgroup SpatialParameters Spatial Parameters
466
467
     * \brief Parameters of the porous matrix and other parameter varying with position (e.g. porosity)
     *
468
469
470
     * All parameters which depend on the matrix and
     * therefore on the position within the model domain are defined as spatial
     * parameters. For example permeability, porosity etc.
471
     *
472
     */
473

474
475
476
/* ***************** Adaptive ******************/
/*!
 * \defgroup Adaptive Adaptive
477
 * \brief Adaptive grids
478
 */
479

480
481
482
/* ***************** Assembly ******************/
/*!
 * \defgroup Assembly Assembly
483
 * \brief Assembly of linear systems (Jacobian and residual)
484
 */
485

486
/* ***************** Common ******************/
487
/*!
488
 * \defgroup Common Common
489
 * \brief Common classes, functions, properties and concepts
490
 */
491
 	/*!
492
493
  	 * \ingroup Common
  	 * \defgroup Properties Properties
494
  	 * \brief Basic properties of all models in DuMu<sup>x</sup>
495
  	 */
496

497
498
499
/* ***************** InputOutput ******************/
/*!
 * \defgroup InputOutput Input Output
500
 * \brief Classes and functions dealing with input and output of data and grids
501
502
503
504
505
 */

/* ***************** Linear ******************/
/*!
 * \defgroup Linear Linear
506
 * \brief Linear solvers and helpers
507
508
509
510
511
 */

/* ***************** Nonlinear ******************/
/*!
 * \defgroup Nonlinear Nonlinear
512
 * \brief Nonlinear solvers: Newton method
513
514
515
516
517
 */

/* ***************** Parallel ******************/
/*!
 * \defgroup Parallel Parallel
518
 * \brief Helpers for parallel runs with MPI
519
 */