includeFvModelEntry.H
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration | Website: https://openfoam.org
5  \\ / A nd | Copyright (C) 2023 OpenFOAM Foundation
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8 License
9  This file is part of OpenFOAM.
10 
11  OpenFOAM is free software: you can redistribute it and/or modify it
12  under the terms of the GNU General Public License as published by
13  the Free Software Foundation, either version 3 of the License, or
14  (at your option) any later version.
15 
16  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
17  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19  for more details.
20 
21  You should have received a copy of the GNU General Public License
22  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
23 
24 Class
25  Foam::functionEntries::includeFvModelEntry
26 
27 Description
28  Specify a fvModel dictionary file to include, expects the
29  fvModel name to follow with option arguments (without quotes).
30 
31  Searches for fvModel dictionary file in user/group/shipped
32  directories allowing for version-specific and version-independent files
33  using the following hierarchy:
34  - \b user settings:
35  - ~/.OpenFOAM/<VERSION>/caseDicts/fvModels
36  - ~/.OpenFOAM/caseDicts/fvModels
37  - \b group (site) settings (when $WM_PROJECT_SITE is set):
38  - $WM_PROJECT_SITE/<VERSION>/etc/caseDicts/fvModels
39  - $WM_PROJECT_SITE/etc/caseDicts/fvModels
40  - \b group (site) settings (when $WM_PROJECT_SITE is not set):
41  - $WM_PROJECT_INST_DIR/site/<VERSION>/etc/caseDicts/fvModels
42  - $WM_PROJECT_INST_DIR/site/etc/caseDicts/fvModels
43  - \b other (shipped) settings:
44  - $WM_PROJECT_DIR/etc/caseDicts/fvModels
45 
46  The optional field arguments included in the name are inserted in 'field' or
47  'fields' entries in the fvModel dictionary and included in the name
48  of the fvModel entry to avoid conflict.
49 
50  Examples:
51  \verbatim
52  #includeModel clouds
53  #includeModel surfaceFilms
54  \endverbatim
55 
56  Other dictionary entries may also be specified using named arguments.
57 
58 See also
59  Foam::includeFvConstraintEntry
60  Foam::includeFuncEntry
61 
62 SourceFiles
63  includeFvModelEntry.C
64 
65 \*---------------------------------------------------------------------------*/
66 
67 #ifndef includeFvModelEntry_H
68 #define includeFvModelEntry_H
69 
70 #include "functionEntry.H"
71 
72 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
73 
74 namespace Foam
75 {
76 namespace functionEntries
77 {
78 
79 /*---------------------------------------------------------------------------*\
80  Class includeFvModelEntry Declaration
81 \*---------------------------------------------------------------------------*/
82 
84 :
85  public functionEntry
86 {
87 
88 public:
89 
90  //- Runtime type information
91  ClassName("includeModel");
92 
93 
94  // Static Data Members
95 
96  //- Default relative path to the directory structure
97  // containing the fvModel dictionary files
99 
100 
101  // Member Functions
102 
103  //- Execute the functionEntry in a sub-dict context
104  static bool execute(dictionary& parentDict, Istream&);
105 };
106 
107 
108 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
109 
110 } // End namespace functionEntries
111 } // End namespace Foam
112 
113 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
114 
115 #endif
116 
117 // ************************************************************************* //
An Istream is an abstract base class for all input systems (streams, files, token lists etc)....
Definition: Istream.H:60
A list of keyword definitions, which are a keyword followed by any number of values (e....
Definition: dictionary.H:160
A class for handling file names.
Definition: fileName.H:82
Specify a fvModel dictionary file to include, expects the fvModel name to follow with option argument...
static bool execute(dictionary &parentDict, Istream &)
Execute the functionEntry in a sub-dict context.
ClassName("includeModel")
Runtime type information.
static fileName fvModelDictPath
Default relative path to the directory structure.
A functionEntry causes entries to be added/manipulated on the specified dictionary given an input str...
Definition: functionEntry.H:66
Namespace for OpenFOAM.