including blockMeshDict, surfaceFeaturesDict and snappyHexMeshDict, based on the
case surface geometry.
Description
Preconfigures blockMeshDict, surfaceFeaturesDict and snappyHexMeshDict
files based on the case surface geometry files.
Starting from a standard OpenFOAM case, this utility locates surface
geometry files, e.g. OBJ, STL format, in the constant/geometry directory.
It writes out the configuration files for mesh generation with
snappyHexMesh based on assumptions which can be overridden by options on
the command line.
The utility processes the surface geometry files, attempting to anticipate
their intended purpose, trying in particular to recognise whether the
domain represents an external or internal flow. If there is a surface
which is closed, and is either single or surrounds all other surfaces,
then it is assumed that it forms the external boundary of an internal
flow. This assumption is overridden if the bounds of the background mesh
are specified using the '-bounds' option and they are more than 50% larger
than the surface bounds.
Surfaces which form boundaries of the domain may contain named regions
that are intended to become patches in the final mesh. Any surface region
whose name begins with 'inlet' or 'outlet' will become a patch of the same
name in the final mesh. On an external surface (for an internal flow),
regions can be identified as inlets and outlets using the '-inletRegions'
and '-outletRegions' options, respectively. When either option specifies a
single region, the resulting patch name will be specifically 'inlet' or
'outlet', respectively. Surfaces which are contained within the domain,
which do not surround or intersect other surfaces, are assumed by default
to be wall patches. Any closed surface which surrounds another (but not an
external surface) is used to form a cellZone within the mesh. Any surface
can be specifically identified as a cellZone with the '-cellZones' option,
with the additional '-baffles' and '-rotatingZones' options available to
assign a surface to a more specific use.
The background mesh for snappyHexMesh is a single block generated by
blockMesh, configured using a blockMeshDict file. The block bounds are
automatically calculated, but can be overridden by the '-bounds'
option. The number of cells is calculated to produce a fairly small
prototype mesh. The cell density can be overridden by the '-nCells' option
or can be scaled up by an integer factor using the '-refineBackground'
option. When the background mesh is required to form patches in the final
mesh, e.g. for an external flow, the user can specify the names and types
of the patches corresponding to the six block faces using options such as
'-xMinPatch', '-xMaxPatch', etc. The name and type of the default patch,
formed from block faces which are not configured, can also be specified
with the '-defaultPatch' option. The utility provides placeholder entries
for all block faces unless the '-clearBoundary' option is used. A special
'-cylindricalBackground' option generates a cylindrical background mesh,
oriented along the z-axis along x = y = 0.
The snappyHexMesh configuration is generated automatically, applying a set
of defaults to the main configuration parameters. By default, explicit
feature capturing is configured, for which a surfaceFeaturesDict file is
written for the user to generate the features files with the
surfaceFeatures utility. Implicit feature capturing can alternatively be
selected with the '-implicitFeatures' option. Refinement levels can be
controlled with a range of options including: '-refinementLevel' for the
baseline refinement level; '-refinementSurfaces' for levels on specific
surfaces; '-refinementRegions' for levels inside specific surfaces;
'-refinementBoxes' for quick, box-shaped refinement regions specified by
min and max bounds; '-refinementDists' for distance-based refinement; and
'-nCellsBetweenLevels' to control the transition between refinement
levels. A '-layers' option specifies additional layers of cells at wall
boundaries. The insidePoint parameter is set to '(0 0 0)' by default but
can be overridden using the '-insidePoint' option.
212 lines
6.4 KiB
C++
212 lines
6.4 KiB
C++
/*---------------------------------------------------------------------------*\
|
|
========= |
|
|
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
|
|
\\ / O peration | Website: https://openfoam.org
|
|
\\ / A nd | Copyright (C) 2023 OpenFOAM Foundation
|
|
\\/ M anipulation |
|
|
-------------------------------------------------------------------------------
|
|
License
|
|
This file is part of OpenFOAM.
|
|
|
|
OpenFOAM is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
Class
|
|
Foam::snappyHexMeshConfiguration
|
|
|
|
Description
|
|
From a set of input surface geometry files and some configuration
|
|
parameters, writes out a snappyHexMeshDict configuration file.
|
|
|
|
SourceFiles
|
|
snappyHexMeshConfigurationI.H
|
|
snappyHexMeshConfiguration.C
|
|
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef snappyHexMeshConfiguration_H
|
|
#define snappyHexMeshConfiguration_H
|
|
|
|
#include "caseFileConfiguration.H"
|
|
#include "meshingSurfaceList.H"
|
|
#include "Tuple3.H"
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
namespace Foam
|
|
{
|
|
|
|
/*---------------------------------------------------------------------------*\
|
|
Class snappyHexMeshConfiguration Declaration
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
class snappyHexMeshConfiguration
|
|
:
|
|
public caseFileConfiguration
|
|
{
|
|
// Private Typedefs
|
|
|
|
//- The surface type
|
|
typedef meshingSurface::surfaceType surfaceType;
|
|
|
|
|
|
// Private Data
|
|
|
|
//- List of surfaces used for meshing
|
|
const meshingSurfaceList& surfaces_;
|
|
|
|
//- Refinement level applied across the snappyHexMeshDict file
|
|
const label refinementLevel_;
|
|
|
|
//- Level of refinement on speficied surfaces
|
|
const List<Tuple2<word, label>>& surfaceLevels_;
|
|
|
|
//- Refinement regions specified by surface and level
|
|
const List<Tuple2<word, label>>& refinementRegions_;
|
|
|
|
//- Refinement boxes with level of refinement
|
|
const List<Tuple3<vector, vector, label>>& refinementBoxes_;
|
|
|
|
//- Refinement distances with level of refinement
|
|
const List<Tuple3<word, scalar, label>>& refinementDists_;
|
|
|
|
//- Using implicit feature capturing?
|
|
const bool implicitFeatures_;
|
|
|
|
//- Number of layers at wall patches, default 0
|
|
const label layers_;
|
|
|
|
//- insidePoint parameter
|
|
point insidePoint_;
|
|
|
|
//- nCellsBetweenLevels parameter
|
|
const label nCellsBetweenLevels_;
|
|
|
|
|
|
// Private Member Functions
|
|
|
|
//- Write switches
|
|
void writeSnappySwitches();
|
|
|
|
//- Write surface entry for geometry sub-dictionary
|
|
void writeGeometrySurface(const label surfID);
|
|
|
|
//- Write searchableBox entry for geometry sub-dictionary
|
|
void writeSearchableBox(const label i);
|
|
|
|
//- Write geometry sub-dictionary
|
|
void writeSnappyGeometry();
|
|
|
|
//- Write features list in castellatedMeshControls
|
|
void writeFeatures();
|
|
|
|
//- Write refinementSurfaces level entry
|
|
void writeRefinementSurfacesLevel(const label rl);
|
|
|
|
//- Write refinementSurfaces level entry using refinementLevel_
|
|
void writeRefinementSurfacesLevel();
|
|
|
|
//- Write refinementSurfaces level entry for a surface with name
|
|
void writeRefinementSurfacesLevel(const word& name);
|
|
|
|
//- Write refinementSurfaces wall patchInfo entry
|
|
void writePatchInfo(const word& type, const word& group="");
|
|
|
|
//- Write refinementSurfaces
|
|
void writeRefinementSurfaces();
|
|
|
|
//- Write a refinement surface region
|
|
void writeRefinementSurfacesRegion
|
|
(
|
|
const word regionName,
|
|
const List<word>& regions
|
|
);
|
|
|
|
//- Write refinement surface region information
|
|
void writeRefinementSurfacesRegions
|
|
(
|
|
const wordList& inletRegions,
|
|
const wordList& outletRegions
|
|
);
|
|
|
|
//- Write a refinement region
|
|
void writeRefinementRegion(const word& name, const label level);
|
|
|
|
//- Write refinementRegions
|
|
void writeRefinementRegions();
|
|
|
|
//- Write castellatedMeshControls
|
|
void writeCastellatedMeshControls();
|
|
|
|
//- Write snapControls
|
|
void writeSnapControls();
|
|
|
|
//- Write addLayersControls
|
|
void writeAddLayersControls();
|
|
|
|
//- Write writeFlags
|
|
void writeWriteFlags();
|
|
|
|
public:
|
|
|
|
// Constructors
|
|
|
|
//- Construct from components
|
|
snappyHexMeshConfiguration
|
|
(
|
|
const fileName& name,
|
|
const fileName& dir,
|
|
const Time& time,
|
|
const meshingSurfaceList& surfaces,
|
|
const label refinementLevel,
|
|
const List<Tuple2<word, label>>& surfaceLevels,
|
|
const List<Tuple2<word, label>>& refinementRegions,
|
|
const List<Tuple3<vector, vector, label>>& refinementBoxes,
|
|
const List<Tuple3<word, scalar, label>>& refinementDists,
|
|
const bool implicitFeatures,
|
|
const label layers,
|
|
const point& insidePoint,
|
|
const label nCellsBetweenLevels
|
|
);
|
|
|
|
//- Disallow default bitwise copy construction
|
|
snappyHexMeshConfiguration(const snappyHexMeshConfiguration&) = delete;
|
|
|
|
|
|
//- Destructor
|
|
~snappyHexMeshConfiguration();
|
|
|
|
|
|
// Member Functions
|
|
|
|
// Write the snappyHexMeshDict
|
|
void write();
|
|
|
|
|
|
// Member Operators
|
|
|
|
//- Disallow default bitwise assignment
|
|
void operator=(const snappyHexMeshConfiguration&) = delete;
|
|
};
|
|
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
} // End namespace Foam
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
#endif
|
|
|
|
// ************************************************************************* //
|