A topoSetCellSource to select cells based on relation to a surface given by an external file. More...

#include <surfaceToCell.H>

Inheritance diagram for surfaceToCell:

Collaboration diagram for surfaceToCell:

Public Member Functions
	TypeName ("surfaceToCell")
	Runtime type information.
	surfaceToCell (const polyMesh &mesh, const fileName &surfName, const pointField &outsidePoints, const bool includeCut, const bool includeInside, const bool includeOutside, const bool useSurfaceOrientation, const scalar nearDist, const scalar curvature)
	Construct from components.
	surfaceToCell (const polyMesh &mesh, const fileName &surfName, const triSurface &surf, const triSurfaceSearch &querySurf, const pointField &outsidePoints, const bool includeCut, const bool includeInside, const bool includeOutside, const bool useSurfaceOrientation, const scalar nearDist, const scalar curvature)
	Construct from components (supplied surface, surfaceSearch).
	surfaceToCell (const polyMesh &mesh, const dictionary &dict)
	Construct from dictionary.
	surfaceToCell (const polyMesh &mesh, Istream &is)
	Construct from Istream.
virtual	~surfaceToCell ()
	Destructor.
virtual void	applyToSet (const topoSetSource::setAction action, topoSet &) const
	Apply specified action to the topoSet.
Public Member Functions inherited from topoSetCellSource
	declareRunTimeSelectionTable (autoPtr, topoSetCellSource, word,(const polyMesh &mesh, const dictionary &dict),(mesh, dict))
	declareRunTimeSelectionTable (autoPtr, topoSetCellSource, istream,(const polyMesh &mesh, Istream &is),(mesh, is))
	topoSetCellSource (const polyMesh &mesh)
	Construct from mesh.
	topoSetCellSource (const polyMesh &mesh, const dictionary &dict)
	Construct from mesh, use "verbose" entry if present.
autoPtr< topoSetCellSource >	clone () const
	Clone (disallowed).
virtual	~topoSetCellSource ()=default
	Destructor.
virtual topoSetSource::sourceType	setType () const
	The source category is a cellSet.
Public Member Functions inherited from topoSetSource
	TypeName ("topoSetSource")
	Runtime type information.
	declareRunTimeSelectionTable (autoPtr, topoSetSource, word,(const polyMesh &mesh, const dictionary &dict),(mesh, dict))
	declareRunTimeSelectionTable (autoPtr, topoSetSource, istream,(const polyMesh &mesh, Istream &is),(mesh, is))
	topoSetSource (const polyMesh &mesh, bool verbose=true)
	Construct from mesh, with preferred verbosity.
	topoSetSource (const polyMesh &mesh, const dictionary &dict)
	Construct from mesh, use "verbose" entry if present.
autoPtr< topoSetSource >	clone () const
	Clone (disallowed).
virtual	~topoSetSource ()=default
	Destructor.
const polyMesh &	mesh () const noexcept
	Reference to the mesh.
bool	verbose () const noexcept
	Get output verbosity.
bool	verbose (bool on) noexcept
	Enable/disable verbose output.
void	verbose (const dictionary &dict)
	Use "verbose" entry (if present) to enable/disable verbose output.
bool	hasTransform () const noexcept
	True if coordinate transform is active.
tmp< pointField >	transform (const pointField &points) const
	Coordinate transform (optionally) coordinates. Returns reference to input data if no transform is active.

Additional Inherited Members
Public Types inherited from topoSetSource
enum	sourceType { UNKNOWN_SOURCE = 0 , CELL_TYPE = 0x1 , FACE_TYPE = 0x2 , POINT_TYPE = 0x4 , SET_SOURCE = 0x10 , CELLSET_SOURCE = (CELL_TYPE \| SET_SOURCE) , FACESET_SOURCE = (FACE_TYPE \| SET_SOURCE) , POINTSET_SOURCE = (POINT_TYPE \| SET_SOURCE) , ZONE_SOURCE = 0x20 , CELLZONE_SOURCE = (CELL_TYPE \| ZONE_SOURCE) , FACEZONE_SOURCE = (FACE_TYPE \| ZONE_SOURCE) , POINTZONE_SOURCE = (POINT_TYPE \| ZONE_SOURCE) , CELLSETSOURCE = CELLSET_SOURCE , FACESETSOURCE = FACESET_SOURCE , POINTSETSOURCE = POINTSET_SOURCE , CELLZONESOURCE = CELLZONE_SOURCE , FACEZONESOURCE = FACEZONE_SOURCE , POINTZONESOURCE = POINTZONE_SOURCE }
	Enumeration defining the types of sources. More...
enum	setAction { ADD , SUBTRACT , NEW , SUBSET , INVERT , CLEAR , REMOVE , LIST , IGNORE , DELETE = SUBTRACT }
	Enumeration defining various actions. More...
Static Public Member Functions inherited from topoSetCellSource
static autoPtr< topoSetCellSource >	New (const word &sourceType, const polyMesh &mesh, const dictionary &dict)
	Return a reference to the selected source type.
static autoPtr< topoSetCellSource >	New (const word &sourceType, const polyMesh &mesh, Istream &is)
	Return a reference to the selected source type.
Static Public Member Functions inherited from topoSetSource
static Istream &	checkIs (Istream &is)
	Check state of stream.
static bool	isSetSource (const sourceType t) noexcept
	True if a "set" source.
static bool	isZoneSource (const sourceType t) noexcept
	True if a "zone" source.
static bool	isCell (const sourceType t) noexcept
	True if "cell" geometric type.
static bool	isFace (const sourceType t) noexcept
	True if "face" geometric type.
static bool	isPoint (const sourceType t) noexcept
	True if "point" geometric type.
static const string &	usage (const word &name)
static autoPtr< topoSetSource >	New (const word &topoSetSourceType, const polyMesh &mesh, const dictionary &dict)
	Return a reference to the selected topoSetSource.
static autoPtr< topoSetSource >	New (const word &topoSetSourceType, const polyMesh &mesh, Istream &is)
	Return a reference to the selected topoSetSource.
static setAction	toAction (const word &actionName)
	Deprecated(2018-07) convert string to action.
static bool	readNames (const dictionary &dict, wordList &names)
	Helper: extract wordList of patches/zones from dictionary. Returns.
Static Public Attributes inherited from topoSetSource
static const Enum< setAction >	actionNames
	The setActions enum text. Names: "new", add", "subtract", "subset", "invert", "clear", "remove", "list", "ignore".
static const Enum< setAction >	combineNames
	The setAction enum text when combining selections. Names: "use", "add", "subtract", "subset", "invert", "ignore".
Protected Member Functions inherited from topoSetSource
void	addOrDelete (topoSet &set, const label id, const bool add) const
	Add or delete id from set. Add when 'add' is true.
void	addOrDelete (topoSet &set, const labelUList &labels, const bool add) const
	Add or delete labels from set. Add when 'add' is true.
void	addOrDelete (topoSet &set, const bitSet &labels, const bool add) const
	Add or delete labels from set. Add when 'add' is true.
	topoSetSource (const topoSetSource &)=delete
	No copy construct.
void	operator= (const topoSetSource &)=delete
	No copy assignment.
Static Protected Member Functions inherited from topoSetSource
static bool	check (labelList &list, const label maxLabel)
	Detect and remove any values less than 0 or ge maxLabel.
Protected Attributes inherited from topoSetSource
const polyMesh &	mesh_
	Reference to the mesh.
bool	verbose_
	Output verbosity (default: true).
autoPtr< solidBodyMotionFunction >	transformPtr_
	Optional transformation for geometric data.
Static Protected Attributes inherited from topoSetSource
static const string	illegalSource_
static HashTable< string > *	usageTablePtr_ = nullptr
	A table of usage strings.

Detailed Description

A topoSetCellSource to select cells based on relation to a surface given by an external file.

surfaceToCell can select:

all cells inside/outside/cut by a surface
all cells inside/outside surface (useSurfaceOrientation, requires closed surface)
cells with centre nearer than XXX to surface
cells with centre nearer than XXX to surface and with normal at nearest point to centre and cell-corners differing by more than YYY (i.e. point of high curvature)

Operands:

Operand	Type	Location
`input`	triSurface	$FOAM_CASE/constant/triSurface/<file>
`output`	cellSet	$FOAM_CASE/constant/polyMesh/sets/<set>

Usage

Minimal example by using system/topoSetDict.actions:

{
    // Mandatory (inherited) entries
    name            <name>;
    type            cellSet;
    action          <action>;

    // Mandatory entries
    source          surfaceToCell;
    file            <surfaceFileName>;
    outsidePoints
    (
        (<p1x> <p1y> <p1z>)
        (<p2x> <p2y> <p2z>)
        ...
    );
    includeCut      false;
    includeInside   false;
    includeOutside  true;
    nearDistance    0.5;
    curvature       1.0;

    // Optional entries
    useSurfaceOrientation false;
    fileType        stl;
    scale           2.0;
}

where the entries mean:

Property	Description	Type	Req'd	Dflt
`name`	Name of cellSet	word	yes	-
`type`	Type name: cellSet	word	yes	-
`action`	Action applied on cells - see below	word	yes	-
`source`	Source name: surfaceToCell	word	yes	-
`file`	The surface "filename"	word	yes	-
`outsidePoints`	List of points that define outside of the surface	vectorList	yes	-
`includeCut`	Flag to include cut cells	bool	yes	-
`includeInside`	Flag to include inside cells	bool	yes	-
`includeOutside`	Flag to include outside cells	bool	yes	-
`useSurfaceOrientation`	Flag to use inherently the orientation of the surface	bool	no	false
`nearDistance`	Near distance to the surface	scalar	yes	-
`curvature`	Surface curvature	scalar	yes	-
`fileType`	The format of the surface file	word	no	""
`scale`	Surface scaling factor	scalar	no	-1

Options for the action entry:

      new      | Create a new cellSet from selected cells
      add      | Add selected cells into this cellSet
      subtract | Remove selected cells from this cellSet

See also

Source files

Definition at line 239 of file surfaceToCell.H.

Constructor & Destructor Documentation

◆ surfaceToCell() [1/4]

surfaceToCell	(	const polyMesh &	mesh,
		const fileName &	surfName,
		const pointField &	outsidePoints,
		const bool	includeCut,
		const bool	includeInside,
		const bool	includeOutside,
		const bool	useSurfaceOrientation,
		const scalar	nearDist,
		const scalar	curvature )

Construct from components.

Definition at line 365 of file surfaceToCell.C.

References topoSetSource::mesh(), and topoSetCellSource::topoSetCellSource().

Here is the call graph for this function:

◆ surfaceToCell() [2/4]

surfaceToCell	(	const polyMesh &	mesh,
		const fileName &	surfName,
		const triSurface &	surf,
		const triSurfaceSearch &	querySurf,
		const pointField &	outsidePoints,
		const bool	includeCut,
		const bool	includeInside,
		const bool	includeOutside,
		const bool	useSurfaceOrientation,
		const scalar	nearDist,
		const scalar	curvature )