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.
236 lines
5.7 KiB
C++
236 lines
5.7 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::meshingSurface
|
|
|
|
Description
|
|
Attributes of a surface geometry file (e.g. OBJ, STL) that are used in
|
|
the configuration of mesh input files, (e.g. blockMeshDict,
|
|
snappyHexMeshDict).
|
|
|
|
SourceFiles
|
|
meshingSurface.C
|
|
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef meshingSurface_H
|
|
#define meshingSurface_H
|
|
|
|
#include "Time.H"
|
|
#include "boundBox.H"
|
|
#include "NamedEnum.H"
|
|
#include "triSurfaceMesh.H"
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
namespace Foam
|
|
{
|
|
|
|
/*---------------------------------------------------------------------------*\
|
|
Class meshingSurface Declaration
|
|
\*---------------------------------------------------------------------------*/
|
|
|
|
class meshingSurface
|
|
{
|
|
public:
|
|
|
|
// Static Data Members
|
|
|
|
//- Type of surface
|
|
enum class surfaceType
|
|
{
|
|
wall, // Solid wall boundary
|
|
external, // External domain boundary
|
|
cellZone, // Surface defining a cellZone
|
|
rotatingZone, // Surface defining a rotatingZone
|
|
baffle // Zero-thickness wall
|
|
};
|
|
|
|
|
|
private:
|
|
|
|
// Private Data
|
|
|
|
//- Path to surface file
|
|
fileName path_;
|
|
|
|
//- Surface file name
|
|
fileName file_;
|
|
|
|
//- Surfaces names, without file extensions
|
|
word name_;
|
|
|
|
//- Type of surface: wall, external, cellZone, rotatingZone, baffle
|
|
surfaceType type_;
|
|
|
|
//- Bounding boxes of the surface
|
|
boundBox boundBox_;
|
|
|
|
//- Is the surface closed?
|
|
bool closed_;
|
|
|
|
//- Number of disconnected parts
|
|
label nParts_;
|
|
|
|
//- List of regions
|
|
List<word> regions_;
|
|
|
|
//- List of inlet regions
|
|
List<word> inletRegions_;
|
|
|
|
//- List of outlet regions
|
|
List<word> outletRegions_;
|
|
|
|
|
|
// Private Member Functions
|
|
|
|
//- Returns the number of disconnected regions in a surface
|
|
label nSurfaceParts(const triSurfaceMesh& surf);
|
|
|
|
|
|
public:
|
|
|
|
// Static Data Members
|
|
|
|
//- Enumeration names for surfaceTypes
|
|
static const NamedEnum<surfaceType, 5> surfaceTypeNames;
|
|
|
|
|
|
// Constructors
|
|
|
|
//- Construct null
|
|
meshingSurface();
|
|
|
|
//- Construct from components
|
|
meshingSurface(const fileName& file, const Time& time);
|
|
|
|
//- Disallow default bitwise copy construction
|
|
meshingSurface(const meshingSurface&) = delete;
|
|
|
|
|
|
//- Destructor
|
|
~meshingSurface();
|
|
|
|
|
|
// Member Functions
|
|
|
|
//- Path to the surface file
|
|
const fileName& path() const
|
|
{
|
|
return path_;
|
|
}
|
|
|
|
//- Surface file name
|
|
const fileName& file() const
|
|
{
|
|
return file_;
|
|
}
|
|
|
|
//- Surface name, without file extension
|
|
const word& name() const
|
|
{
|
|
return name_;
|
|
}
|
|
|
|
//- Surface type
|
|
const surfaceType& type() const
|
|
{
|
|
return type_;
|
|
}
|
|
|
|
//- Return non-const access to the surface type
|
|
surfaceType& type()
|
|
{
|
|
return type_;
|
|
}
|
|
|
|
//- Surface bounding box
|
|
const boundBox& bb() const
|
|
{
|
|
return boundBox_;
|
|
}
|
|
|
|
//- Is the surface closed?
|
|
bool closed() const
|
|
{
|
|
return closed_;
|
|
}
|
|
|
|
//- Return the number of disconnected surfaces
|
|
label nParts() const
|
|
{
|
|
return nParts_;
|
|
}
|
|
|
|
//- Surface geometry regions
|
|
const List<word>& regions() const
|
|
{
|
|
return regions_;
|
|
}
|
|
|
|
//- Inlet regions
|
|
const List<word>& inletRegions() const
|
|
{
|
|
return inletRegions_;
|
|
}
|
|
|
|
//- Inlet regions
|
|
List<word>& inletRegions()
|
|
{
|
|
return inletRegions_;
|
|
}
|
|
|
|
//- Outlet regions
|
|
const List<word>& outletRegions() const
|
|
{
|
|
return outletRegions_;
|
|
}
|
|
|
|
//- Outlet regions
|
|
List<word>& outletRegions()
|
|
{
|
|
return outletRegions_;
|
|
}
|
|
|
|
// Check the file extension of surface geometry files
|
|
static bool isSurfaceExt(const fileName& file);
|
|
|
|
|
|
// Member Operators
|
|
|
|
//- Disallow default bitwise assignment
|
|
void operator=(const meshingSurface&) = delete;
|
|
};
|
|
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
} // End namespace Foam
|
|
|
|
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
|
|
|
|
#endif
|
|
|
|
// ************************************************************************* //
|