Makes a collection of surface geometries by copying from an existing defined surface geometry. There are no boolean operations, e.g. overlapping surfaces are not intersected. More...

Inheritance diagram for collection:

[legend]

Collaboration diagram for collection:

[legend]

Public Member Functions
	TypeName ("collection")
	Runtime type information. More...

	collection (const IOobject &io, const dictionary &dict)
	Construct from dictionary (used by searchableSurface) More...

	collection (const collection &)=delete
	Disallow default bitwise copy construction. More...

virtual	~collection ()
	Destructor. More...

const vectorField &	scale () const
	Scaling vector per subsurface. More...

vectorField &	scale ()
	Scaling vector per subsurface. More...

const PtrList< coordinateSystem > &	transform () const
	Coordinate system per subsurface. More...

PtrList< coordinateSystem > &	transform ()
	Coordinate system per subsurface. More...

virtual const wordList &	regions () const
	Names of regions. More...

virtual bool	hasVolumeType () const
	Whether supports volume type below. More...

virtual label	size () const
	Range of local indices that can be returned. More...

virtual tmp< pointField >	coordinates () const
	Get representative set of element coordinates. More...

virtual void	boundingSpheres (pointField &centres, scalarField &radiusSqr) const
	Get bounding spheres (centre and radius squared), one per element. More...

virtual tmp< pointField >	points () const
	Get the points that define the surface. More...

virtual bool	overlaps (const boundBox &bb) const
	Does any part of the surface overlap the supplied bound box? More...

virtual void	findNearest (const pointField &sample, const scalarField &nearestDistSqr, List< pointIndexHit > &) const

virtual void	findLine (const pointField &start, const pointField &end, List< pointIndexHit > &) const
	Find first intersection on segment from start to end. More...

virtual void	findLineAny (const pointField &start, const pointField &end, List< pointIndexHit > &) const
	Return any intersection on segment from start to end. More...

virtual void	findLineAll (const pointField &start, const pointField &end, List< List< pointIndexHit >> &) const
	Get all intersections in order from start to end. More...

virtual void	getRegion (const List< pointIndexHit > &, labelList &region) const
	From a set of points and indices get the region. More...

virtual void	getNormal (const List< pointIndexHit > &, vectorField &normal) const
	From a set of points and indices get the normal. More...

virtual void	getVolumeType (const pointField &, List< volumeType > &) const
	Determine type (inside/outside/mixed) for point. unknown if. More...

virtual void	distribute (const List< treeBoundBox > &, const bool keepNonLocal, autoPtr< distributionMap > &faceMap, autoPtr< distributionMap > &pointMap)
	Set bounds of surface. Bounds currently set as list of. More...

virtual void	setField (const labelList &values)
	WIP. Store element-wise field. More...

virtual void	getField (const List< pointIndexHit > &, labelList &) const
	WIP. From a set of hits (points and. More...

bool	writeData (Ostream &) const
	Pure virtual writaData function. More...

void	operator= (const collection &)=delete
	Disallow default bitwise assignment. More...

Public Member Functions inherited from searchableSurface
	TypeName ("searchableSurface")
	Runtime type information. More...

	declareRunTimeSelectionTable (autoPtr, searchableSurface, dictionary,(const IOobject &io, const dictionary &dict),(io, dict))

	searchableSurface (const IOobject &io)

	searchableSurface (const searchableSurface &)=delete
	Disallow default bitwise copy construction. More...

virtual autoPtr< searchableSurface >	clone () const
	Clone. More...

virtual	~searchableSurface ()
	Destructor. More...

const boundBox &	bounds () const
	Return const reference to boundBox. More...

boundBox &	bounds ()
	Return non-const access to the boundBox to allow it to be set. More...

virtual label	globalSize () const
	Range of global indices that can be returned. More...

virtual void	findNearest (const pointField &samples, const scalarField &nearestDistSqr, const labelList &regionIndices, List< pointIndexHit > &info) const
	Find the nearest locations for the supplied points to a. More...

virtual void	findNearest (const pointField &sample, const scalarField &nearestDistSqr, List< pointIndexHit > &, vectorField &normal, labelList &region) const
	Find nearest, normal and region. Can be overridden with. More...

void	operator= (const searchableSurface &)=delete
	Disallow default bitwise assignment. More...

Public Member Functions inherited from regIOobject
	TypeName ("regIOobject")
	Runtime type information. More...

	regIOobject (const IOobject &, const bool isTime=false)
	Construct from IOobject. Optional flag for if IOobject is the. More...

	regIOobject (const regIOobject &)
	Copy constructor. More...

	regIOobject (regIOobject &&)
	Move constructor. More...

	regIOobject (const regIOobject &, bool registerCopy)
	Copy constructor, transferring registry registration to copy. More...

	regIOobject (const word &newName, const regIOobject &, bool registerCopy)
	Copy constructor with new name, transferring registry registration. More...

	regIOobject (const IOobject &, const regIOobject &)
	Copy constructor with new IO parameters. More...

virtual	~regIOobject ()
	Destructor. More...

virtual bool	global () const
	Return true if object is global, i.e. same for all processors. More...

virtual bool	globalFile () const
	Return true if object is global, i.e. same for all processors. More...

const fileName &	caseName () const

fileName	path () const
	Return complete path. More...

fileName	objectPath () const
	Return complete path + object name. More...

fileName	filePath () const
	Return complete path + object name if the file exists. More...

bool	checkIn ()
	Add object to registry. More...

bool	checkOut ()
	Remove object from registry. More...

void	addWatch ()
	Add file watch on object (if registered and READ_IF_MODIFIED) More...

bool	registered () const
	Is this object registered with the registry? More...

bool	ownedByRegistry () const
	Is this object owned by the registry? More...

void	store ()
	Transfer ownership of this object to its registry. More...

void	release ()
	Release ownership of this object from its registry. More...

label	eventNo () const
	Event number at last update. More...

label &	eventNo ()
	Event number at last update. More...

bool	upToDate (const regIOobject &) const
	Return true if up-to-date with respect to given object. More...

bool	upToDate (const regIOobject &, const regIOobject &) const
	Return true if up-to-date with respect to given objects. More...

bool	upToDate (const regIOobject &, const regIOobject &, const regIOobject &) const
	Return true if up-to-date with respect to given objects. More...

bool	upToDate (const regIOobject &, const regIOobject &, const regIOobject &, const regIOobject &) const
	Return true if up-to-date with respect to given objects. More...

void	setUpToDate ()
	Set up to date (obviously) More...

virtual void	rename (const word &newName)
	Rename. More...

bool	headerOk ()
	Read and check header info. More...

Istream &	readStream (const word &, const bool read=true)
	Return Istream and check object type against that given. More...

void	close ()
	Close Istream. More...

virtual bool	readData (Istream &)
	Virtual readData function. More...

virtual bool	read ()
	Read object. More...

const labelList &	watchIndices () const
	Return file-monitoring handles. More...

labelList &	watchIndices ()
	Return file-monitoring handles. More...

virtual bool	modified () const
	Return true if the object's file (or files for objectRegistry) More...

virtual bool	dependenciesModified () const
	Return true if the object's dependencies have been modified. More...

virtual bool	readIfModified ()
	Read object if modified (as set by call to modified) More...

virtual bool	writeObject (IOstream::streamFormat, IOstream::versionNumber, IOstream::compressionType, const bool write) const
	Write using given format, version and compression. More...

virtual bool	write (const bool write=true) const
	Write using setting from DB. More...

void	operator= (const IOobject &)=delete
	Assign to IOobject. More...

void	operator= (const regIOobject &)=delete
	Disallow default assignment. More...

const fileName &	caseName (const bool global) const

fileName	path (const bool global) const
	Return complete path including the processor sub-directory. More...

fileName	objectPath (const bool global) const
	Return complete path + object name including the processor. More...

fileName	filePath (const bool global) const
	Return complete path + object name if the file exists. More...

Public Member Functions inherited from IOobject
	TypeName ("IOobject")
	Runtime type information. More...

	IOobject (const word &name, const fileName &instance, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
	Construct from name, instance, registry, io options. More...

	IOobject (const word &name, const fileName &instance, const fileName &local, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
	Construct from name, instance, local, registry, io options. More...

	IOobject (const fileName &path, const objectRegistry &registry, readOption r=NO_READ, writeOption w=NO_WRITE, bool registerObject=true)
	Construct from path, registry, io options. More...

	IOobject (const IOobject &io, const objectRegistry &registry)
	Construct from copy resetting registry. More...

	IOobject (const IOobject &io, const word &name)
	Construct from copy resetting name. More...

	IOobject (const IOobject &io)=default
	Copy constructor. More...

autoPtr< IOobject >	clone () const
	Clone. More...

autoPtr< IOobject >	clone (const objectRegistry &registry) const
	Clone resetting registry. More...

virtual	~IOobject ()
	Destructor. More...

const Time &	time () const
	Return time. More...

const objectRegistry &	db () const
	Return the local objectRegistry. More...

const word &	name () const
	Return name. More...

const word &	headerClassName () const
	Return name of the class name read from header. More...

word &	headerClassName ()
	Return name of the class name read from header. More...

string &	note ()
	Return non-constant access to the optional note. More...

const string &	note () const
	Return the optional note. More...

bool &	registerObject ()
	Register object created from this IOobject with registry if true. More...

bool	registerObject () const
	Register object created from this IOobject with registry if true. More...

readOption	readOpt () const

readOption &	readOpt ()

writeOption	writeOpt () const

writeOption &	writeOpt ()

word	group () const
	Return group (extension part of name) More...

word	member () const
	Return member (name without the extension) More...

const fileName &	rootPath () const

const fileName &	caseName (const bool global) const

fileName &	instance () const
	Return the instance directory, constant, system, <time> etc. More...

void	updateInstance () const
	If the instance is a time directory update to the current time. More...

void	updateTimeInstance () const
	Update instance to the current time. More...

const fileName &	local () const

fileName	path (const bool global) const
	Return complete path including the processor sub-directory. More...

fileName	objectPath (const bool global) const
	Return complete path + object name including the processor. More...

fileName	relativePath () const
	Return the path relative to the case directory. More...

fileName	relativeObjectPath () const
	Return complete relativePath + object name. More...

fileName	filePath (const bool global) const
	Return complete path + object name if the file exists. More...

bool	readHeader (Istream &)
	Read header. More...

bool	headerOk ()
	Read header of local object without type-checking. More...

template<class Type >
void	warnNoRereading () const
	Helper: warn that type does not support re-reading. More...

bool	writeHeader (Ostream &) const
	Write header. More...

bool	writeHeader (Ostream &, const word &objectType) const
	Write header. Allow override of type. More...

bool	good () const

bool	bad () const

InfoProxy< IOobject >	info () const
	Return info proxy. More...

void	operator= (const IOobject &)

template<class Name >
Foam::word	groupName (Name name, const word &group)

Additional Inherited Members
Public Types inherited from IOobject
enum	objectState { GOOD , BAD }
	Enumeration defining the valid states of an IOobject. More...

enum	readOption { MUST_READ , MUST_READ_IF_MODIFIED , READ_IF_PRESENT , NO_READ }
	Enumeration defining the read options. More...

enum	writeOption { AUTO_WRITE = 0 , NO_WRITE = 1 }
	Enumeration defining the write options. More...

enum	fileCheckTypes { timeStamp , timeStampMaster , inotify , inotifyMaster }
	Enumeration defining the file checking options. More...

Static Public Member Functions inherited from searchableSurface
static autoPtr< searchableSurface >	New (const word &surfaceType, const IOobject &io, const dictionary &dict)
	Return a reference to the selected searchableSurface. More...

static const word &	geometryDir ()
	Return the geometry directory name. More...

static const word &	geometryDir (const Time &time)
	Check that the geometry directory exists and return. More...

Static Public Member Functions inherited from regIOobject
template<class Type >
static Type &	store (Type *)
	Transfer ownership of the given object pointer to its registry. More...

template<class Type >
static Type &	store (autoPtr< Type > &)
	Transfer ownership of the given object pointer to its registry. More...

Static Public Member Functions inherited from IOobject
static bool	fileNameComponents (const fileName &path, fileName &instance, fileName &local, word &name)
	Split path into instance, local, name components. More...

template<class Name >
static word	groupName (Name name, const word &group)

static word	group (const word &name)
	Return group (extension part of name) More...

static word	member (const word &name)
	Return member (name without the extension) More...

template<class Stream >
static Stream &	writeBanner (Stream &os, bool noHint=false)
	Write the standard OpenFOAM file/dictionary banner. More...

template<class Stream >
static Stream &	writeDivider (Stream &os)
	Write the standard file section divider. More...

template<class Stream >
static Stream &	writeEndDivider (Stream &os)
	Write the standard end file divider. More...

Static Public Attributes inherited from searchableSurface
static word	geometryDir_
	Name of the directory for the geometry files. More...

Static Public Attributes inherited from regIOobject
static float	fileModificationSkew

Static Public Attributes inherited from IOobject
static constexpr const char *	foamFile = "FoamFile"
	Keyword for the FoamFile header sub-dictionary. More...

static const NamedEnum< fileCheckTypes, 4 >	fileCheckTypesNames

static fileCheckTypes	fileModificationChecking
	Type of file modification checking. More...

Protected Member Functions inherited from regIOobject
bool	readHeaderOk (const IOstream::streamFormat defaultFormat, const word &typeName)
	Read header, check readOpt flags and read data if necessary. More...

Protected Member Functions inherited from IOobject
template<class Type >
bool	typeHeaderOk (const bool checkType)
	Read header using typeGlobalFile to find file. More...

Detailed Description

Makes a collection of surface geometries by copying from an existing defined surface geometry. There are no boolean operations, e.g. overlapping surfaces are not intersected.

Usage: collection requires a surface geometry to be defined initially, e.g. buildingA in the example below. The collection then defines copies of buildingA which each can be scaled using the mandatory scale parameter and then rotated and translated by the mandatory transform. In the example below, two geometries are included named buildingB and buildingC which are both formed by a translation of buildingA according to the origin parameter. No rotation is applied (by setting e1 and e2 to the global x and y axis directions, respectively).

Example specification in snappyHexMeshDict/geometry:

buildingA
{
    type       searchableBox;
    min        (100 100  0);
    max        (120 120  100);
}

moreBuildings
{
    type collection;

    mergeSubRegions true;

    buildingB
    {
        surface buildingA;
        scale   (1 1 1);
        transform
        {
            coordinateSystem
            {
                type cartesian;
                coordinateRotation
                {
                    type    axesRotation;
                    e1      (1 0 0);
                    e2      (0 1 0);
                }
                origin  (40 40 0);
            }
        }
    }

    buildingC
    {
        $buildingB;
        transform
        {
            coordinateSystem { origin  (30 -40 0); }
        }
    }
}

Source files

collection_searchableSurface.H collection_
searchableSurface.C

Definition at line 114 of file collection_searchableSurface.H.

Constructor & Destructor Documentation

◆ collection() [1/2]

collection	(	const IOobject &	io,
		const dictionary &	dict
	)

Construct from dictionary (used by searchableSurface)

Definition at line 185 of file collection_searchableSurface.C.

References searchableSurface::bounds(), Foam::cmptMultiply(), IOobject::db(), dict, Foam::dimless, Foam::endl(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, forAll, forAllConstIter, Foam::Info, dictionary::lookup(), objectRegistry::lookupObject(), boundBox::max(), Foam::max(), VectorSpace< Form, Cmpt, Ncmpts >::max, boundBox::min(), Foam::min(), VectorSpace< Form, Cmpt, Ncmpts >::min, IOobject::name(), coordinateSystem::New(), s(), List< T >::setSize(), and dictionary::subDict().

Here is the call graph for this function:

◆ collection() [2/2]

collection ( const collection & )

delete

Disallow default bitwise copy construction.

◆ ~collection()

~collection ( )

virtual

Destructor.

Definition at line 292 of file collection_searchableSurface.C.

Member Function Documentation

◆ TypeName()

TypeName ( "collection" )

Runtime type information.

◆ scale() [1/2]

const vectorField& scale ( ) const

inline

Scaling vector per subsurface.

Definition at line 200 of file collection_searchableSurface.H.

◆ scale() [2/2]

vectorField& scale ( )

inline

Scaling vector per subsurface.

Definition at line 206 of file collection_searchableSurface.H.

◆ transform() [1/2]

const PtrList<coordinateSystem>& transform ( ) const

inline

Coordinate system per subsurface.

Definition at line 212 of file collection_searchableSurface.H.

◆ transform() [2/2]

PtrList<coordinateSystem>& transform ( )

inline

Coordinate system per subsurface.

Definition at line 218 of file collection_searchableSurface.H.

◆ regions()

const Foam::wordList & regions ( ) const

virtual

Names of regions.

Implements searchableSurface.

Definition at line 298 of file collection_searchableSurface.C.

References DynamicList< T, SizeInc, SizeMult, SizeDiv >::append(), forAll, Foam::name(), List< T >::setSize(), DynamicList< T, SizeInc, SizeMult, SizeDiv >::shrink(), and List< T >::size().

Here is the call graph for this function:

◆ hasVolumeType()

virtual bool hasVolumeType ( ) const

inlinevirtual

Whether supports volume type below.

Implements searchableSurface.

Definition at line 226 of file collection_searchableSurface.H.

◆ size()

Foam::label size ( ) const

virtual

Range of local indices that can be returned.

Implements searchableSurface.

Definition at line 330 of file collection_searchableSurface.C.

◆ coordinates()

Foam::tmp< Foam::pointField > coordinates ( ) const

virtual

Get representative set of element coordinates.

Usually the element centres (should be of length size()).

Implements searchableSurface.

Definition at line 337 of file collection_searchableSurface.C.

References Foam::cmptMultiply(), Foam::tracking::coordinates(), forAll, and tmp< T >::ref().

Here is the call graph for this function:

◆ boundingSpheres()

void boundingSpheres	(	pointField &	centres,
		scalarField &	radiusSqr
	)		const

virtual

Get bounding spheres (centre and radius squared), one per element.

Any point on element is guaranteed to be inside.

Implements searchableSurface.

Definition at line 366 of file collection_searchableSurface.C.

References Foam::cmptMax(), Foam::cmptMultiply(), forAll, List< T >::setSize(), and List< T >::size().

Here is the call graph for this function:

◆ points()

Foam::tmp< Foam::pointField > points ( ) const

virtual

Get the points that define the surface.

Implements searchableSurface.

Definition at line 404 of file collection_searchableSurface.C.

References Foam::cmptMultiply(), forAll, nPoints, points, and tmp< T >::ref().

Here is the call graph for this function:

◆ overlaps()

virtual bool overlaps ( const boundBox & bb ) const

inlinevirtual

Does any part of the surface overlap the supplied bound box?

Implements searchableSurface.

Definition at line 250 of file collection_searchableSurface.H.

References NotImplemented.

◆ findNearest()

void findNearest	(	const pointField &	sample,
		const scalarField &	nearestDistSqr,
		List< pointIndexHit > &	nearestInfo
	)		const

virtual

Implements searchableSurface.

Definition at line 441 of file collection_searchableSurface.C.

References samples().

Here is the call graph for this function:

◆ findLine()

void findLine	(	const pointField &	start,
		const pointField &	end,
		List< pointIndexHit > &
	)		const

virtual

Find first intersection on segment from start to end.

Note: searchableSurfacesQueries expects no intersection to be found if start==end. Is problem?

Implements searchableSurface.

Definition at line 462 of file collection_searchableSurface.C.

References Foam::abort(), Foam::cmptDivide(), Foam::cmptMultiply(), Foam::FatalError, FatalErrorInFunction, forAll, Foam::mag(), n, s(), List< T >::setSize(), and List< T >::size().

Here is the call graph for this function:

◆ findLineAny()

void findLineAny	(	const pointField &	start,
		const pointField &	end,
		List< pointIndexHit > &
	)		const

virtual

Return any intersection on segment from start to end.

Implements searchableSurface.

Definition at line 559 of file collection_searchableSurface.C.

◆ findLineAll()

void findLineAll	(	const pointField &	start,
		const pointField &	end,
		List< List< pointIndexHit >> &	info
	)		const

virtual

Get all intersections in order from start to end.

Implements searchableSurface.

Definition at line 571 of file collection_searchableSurface.C.

References List< T >::clear(), forAll, and List< T >::size().

Here is the call graph for this function:

◆ getRegion()

void getRegion	(	const List< pointIndexHit > &	info,
		labelList &	region
	)		const

virtual

From a set of points and indices get the region.

Implements searchableSurface.

Definition at line 598 of file collection_searchableSurface.C.

References forAll, List< T >::setSize(), and List< T >::size().

Here is the call graph for this function:

◆ getNormal()

void getNormal	(	const List< pointIndexHit > &	info,
		vectorField &	normal
	)		const

virtual

From a set of points and indices get the normal.

Implements searchableSurface.

Definition at line 663 of file collection_searchableSurface.C.

References forAll, List< T >::setSize(), and List< T >::size().

Here is the call graph for this function:

◆ getVolumeType()

void getVolumeType	(	const pointField &	points,
		List< volumeType > &	volType
	)		const

virtual

Determine type (inside/outside/mixed) for point. unknown if.

cannot be determined (e.g. non-manifold surface)

Implements searchableSurface.

Definition at line 706 of file collection_searchableSurface.C.

References Foam::exit(), Foam::FatalError, and FatalErrorInFunction.

Here is the call graph for this function:

◆ distribute()

void distribute	(	const List< treeBoundBox > &	bbs,
		const bool	keepNonLocal,
		autoPtr< distributionMap > &	faceMap,
		autoPtr< distributionMap > &	pointMap
	)

virtual

Set bounds of surface. Bounds currently set as list of.

bounding boxes. The bounds are hints to the surface as for the range of queries it can expect. faceMap/pointMap can be set if the surface has done any redistribution.

Reimplemented from searchableSurface.

Definition at line 718 of file collection_searchableSurface.C.

References Foam::faceMap(), and forAll.

Here is the call graph for this function:

◆ setField()

void setField ( const labelList & values )

virtual

WIP. Store element-wise field.

Reimplemented from searchableSurface.

Definition at line 752 of file collection_searchableSurface.C.

References forAll.

◆ getField()

void getField	(	const List< pointIndexHit > &	info,
		labelList &	values
	)		const

virtual

WIP. From a set of hits (points and.

indices) get the specified field. Misses do not get set. Return empty field if not supported.

Reimplemented from searchableSurface.

Definition at line 772 of file collection_searchableSurface.C.

References forAll, List< T >::setSize(), and List< T >::size().

Here is the call graph for this function:

◆ writeData()

bool writeData ( Ostream & ) const

inlinevirtual

Pure virtual writaData function.

Must be defined in derived types

Implements regIOobject.

Definition at line 335 of file collection_searchableSurface.H.

References NotImplemented.

◆ operator=()

void operator= ( const collection & )

delete

Disallow default bitwise assignment.

The documentation for this class was generated from the following files:

src/meshTools/searchableSurfaces/collection/collection_searchableSurface.H
src/meshTools/searchableSurfaces/collection/collection_searchableSurface.C

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ collection() [1/2]

◆ collection() [2/2]

◆ ~collection()

Member Function Documentation

◆ TypeName()

◆ scale() [1/2]

◆ scale() [2/2]

◆ transform() [1/2]

◆ transform() [2/2]

◆ regions()

◆ hasVolumeType()

◆ size()

◆ coordinates()

◆ boundingSpheres()

◆ points()

◆ overlaps()

◆ findNearest()

◆ findLine()

◆ findLineAny()

◆ findLineAll()

◆ getRegion()

◆ getNormal()

◆ getVolumeType()

◆ distribute()

◆ setField()

◆ getField()

◆ writeData()

◆ operator=()