Description

A topoSetPointSource to select points based on relation to a surface given by an external file.

surfaceToPoint can select based on:

distance to surface
inside/outside status to surface (Uses normal of nearest surface triangle so requires valid surface topology.)

Operands

Operand	Type	Location
input	typical surface file format (e.g. STL)	`$FOAM_CASE/<file>`
output	pointSet	`$FOAM_CASE/constant/polyMesh/sets/<set>`

Description

Example of the surfaceToPoint topoSet by using actions sub-dictionary in system/topoSetDict file:

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

    // Mandatory entries
    source          surfaceToPoint;
    file            <surfaceFileName>;
    includeInside   false;
    includeOutside  true;
    nearDistance    0.5;

    // Optional entries
    fileType        stl;
    scale           2.0;

}

where the entries mean:

Property	Description	Type	Required	Default
name	Name of pointSet	word	yes	-
type	Type name: pointSet	word	yes	-
action	Action applied on points - see below	word	yes	-
source	Source name: surfaceToPoint	word	yes	-
file	The surface "filename"	word	yes	-
includeInside	Flag to include inside points	bool	yes	-
includeOutside	Flag to include outside points	bool	yes	-
nearDistance	Near distance to the surface	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 pointSet from selected points
add      | Add selected points into this pointSet
subtract | Remove selected points from this pointSet