searchableSurface Class Referenceabstract

Base class of (analytical or triangulated) surface. Encapsulates all the search routines. WIP. More...

Inheritance diagram for searchableSurface:
Collaboration diagram for searchableSurface:

Classes

class  iNew
 Class used for the read-construction of. More...
 

Public Member Functions

 TypeName ("searchableSurface")
 Runtime type information. More...
 
 declareRunTimeSelectionTable (autoPtr, searchableSurface, dict,(const IOobject &io, const dictionary &dict),(io, dict))
 
 searchableSurface (const IOobject &io)
 
 searchableSurface (const searchableSurface &)=delete
 Disallow default bitwise copy construction. More...
 
virtual autoPtr< searchableSurfaceclone () const
 Clone. More...
 
virtual ~searchableSurface ()
 Destructor. More...
 
const boundBoxbounds () const
 Return const reference to boundBox. More...
 
boundBoxbounds ()
 Return non-const access to the boundBox to allow it to be set. More...
 
virtual const wordListregions () const =0
 Names of regions. More...
 
virtual bool hasVolumeType () const =0
 Whether supports volume type below. More...
 
virtual label size () const =0
 Range of local indices that can be returned. More...
 
virtual label globalSize () const
 Range of global indices that can be returned. More...
 
virtual tmp< pointFieldcoordinates () const =0
 Get representative set of element coordinates. More...
 
virtual void boundingSpheres (pointField &centres, scalarField &radiusSqr) const =0
 Get bounding spheres (centre and radius squared), one per element. More...
 
virtual tmp< pointFieldpoints () const =0
 Get the points that define the surface. More...
 
virtual bool overlaps (const boundBox &bb) const =0
 Does any part of the surface overlap the supplied bound box? More...
 
virtual void findNearest (const pointField &sample, const scalarField &nearestDistSqr, List< pointIndexHit > &) const =0
 
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 findLine (const pointField &start, const pointField &end, List< pointIndexHit > &) const =0
 Find first intersection on segment from start to end. More...
 
virtual void findLineAny (const pointField &start, const pointField &end, List< pointIndexHit > &) const =0
 Return any intersection on segment from start to end. More...
 
virtual void findLineAll (const pointField &start, const pointField &end, List< List< pointIndexHit >> &) const =0
 Get all intersections in order from start to end. More...
 
virtual void getRegion (const List< pointIndexHit > &, labelList &region) const =0
 From a set of points and indices get the region. More...
 
virtual void getNormal (const List< pointIndexHit > &, vectorField &normal) const =0
 From a set of points and indices get the normal. More...
 
virtual void getVolumeType (const pointField &, List< volumeType > &) const =0
 Determine type (inside/outside) for point. unknown if. 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...
 
virtual void distribute (const List< treeBoundBox > &, const bool keepNonLocal, autoPtr< mapDistribute > &faceMap, autoPtr< mapDistribute > &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 &values) const
 WIP. From a set of hits (points and. 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 (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...
 
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 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...
 
labeleventNo ()
 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...
 
virtual fileName filePath () const
 Return complete path + object name if the file exists. More...
 
bool headerOk ()
 Read and check header info. More...
 
IstreamreadStream (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 labelListwatchIndices () const
 Return file-monitoring handles. More...
 
labelListwatchIndices ()
 Return file-monitoring handles. More...
 
virtual bool modified () const
 Return true if the object's file (or files for objectRegistry) More...
 
virtual bool readIfModified ()
 Read object if modified (as set by call to modified) More...
 
virtual bool global () const
 Is object same for all processors. More...
 
virtual bool writeData (Ostream &) const =0
 Pure virtual writaData function. 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 &)
 
- 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< IOobjectclone () const
 Clone. More...
 
autoPtr< IOobjectclone (const objectRegistry &registry) const
 Clone resetting registry. More...
 
virtual ~IOobject ()
 Destructor. More...
 
const Timetime () const
 Return time. More...
 
const objectRegistrydb () const
 Return the local objectRegistry. More...
 
const wordname () const
 Return name. More...
 
const wordheaderClassName () const
 Return name of the class name read from header. More...
 
wordheaderClassName ()
 Return name of the class name read from header. More...
 
stringnote ()
 Return non-constant access to the optional note. More...
 
const stringnote () 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
 
readOptionreadOpt ()
 
writeOption writeOpt () const
 
writeOptionwriteOpt ()
 
word group () const
 Return group (extension part of name) More...
 
word member () const
 Return member (name without the extension) More...
 
word modelName (const char *name) const
 Return the name of the object within this model. More...
 
const fileNamerootPath () const
 
const fileNamecaseName () const
 
const fileNameinstance () const
 
fileNameinstance ()
 
const fileNamelocal () const
 
fileName path () const
 Return complete path. More...
 
fileName path (const word &instance, const fileName &local="") const
 Return complete path with alternative instance and local. More...
 
fileName localPath () const
 Return the path relative to the case. More...
 
fileName objectPath () const
 Return complete path + object name. More...
 
fileName localObjectPath () const
 Return complete localPath + object name. More...
 
fileName localFilePath (const word &typeName) const
 Helper for filePath that searches locally. More...
 
fileName globalFilePath (const word &typeName) const
 Helper for filePath that searches up if in parallel. More...
 
bool readHeader (Istream &)
 Read header. More...
 
template<class Type >
bool typeHeaderOk (const bool checkType=true)
 Read header (uses typeFilePath to find file) and check header. 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< IOobjectinfo () const
 Return info proxy. More...
 
void operator= (const IOobject &)
 
template<class Name >
Foam::word groupName (Name name, const word &group)
 
template<class Name >
Foam::word modelName (Name name, const word &model)
 

Static Public Member Functions

static autoPtr< searchableSurfaceNew (const word &surfaceType, const IOobject &io, const dictionary &dict)
 Return a reference to the selected searchableSurface. More...
 
static const wordgeometryDir ()
 Return the geometry directory name. More...
 
static const wordgeometryDir (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 Name >
static word modelName (Name name, const word &model)
 Return the name of the object within the given model. 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

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...
 

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...
 
- 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
void setBad (const string &)
 Set the object state to bad. More...
 

Detailed Description

Base class of (analytical or triangulated) surface. Encapsulates all the search routines. WIP.

Information returned is usually a pointIndexHit:

  • bool : was intersection/nearest found?
  • point : intersection point or nearest point
  • index : unique index on surface (e.g. triangle for triSurfaceMesh)
Source files

Definition at line 66 of file searchableSurface.H.

Constructor & Destructor Documentation

◆ searchableSurface() [1/2]

searchableSurface ( const IOobject io)

Definition at line 70 of file searchableSurface.C.

Referenced by searchableSurface::iNew::operator()().

Here is the caller graph for this function:

◆ searchableSurface() [2/2]

searchableSurface ( const searchableSurface )
delete

Disallow default bitwise copy construction.

◆ ~searchableSurface()

~searchableSurface ( )
virtual

Destructor.

Definition at line 78 of file searchableSurface.C.

Referenced by searchableSurface::clone().

Here is the caller graph for this function:

Member Function Documentation

◆ TypeName()

TypeName ( "searchableSurface"  )

Runtime type information.

◆ declareRunTimeSelectionTable()

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

◆ clone()

virtual autoPtr<searchableSurface> clone ( ) const
inlinevirtual

Clone.

Definition at line 140 of file searchableSurface.H.

References searchableSurface::geometryDir(), searchableSurface::New(), NotImplemented, IOobject::time(), and searchableSurface::~searchableSurface().

Here is the call graph for this function:

◆ New()

Foam::autoPtr< Foam::searchableSurface > New ( const word surfaceType,
const IOobject io,
const dictionary dict 
)
static

Return a reference to the selected searchableSurface.

Definition at line 45 of file searchableSurface.C.

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

Referenced by searchableSurface::clone(), searchableSurface::iNew::operator()(), searchableSurfaces::searchableSurfaces(), regionCoupledBase::surfPtr(), cyclicAMIPolyPatch::surfPtr(), and mappedPatchBase::surfPtr().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ geometryDir() [1/2]

◆ geometryDir() [2/2]

const Foam::word & geometryDir ( const Time time)
static

Check that the geometry directory exists and return.

if not return "triSurface" for backward compatibility

Definition at line 90 of file searchableSurface.C.

References TimePaths::constant(), searchableSurface::findNearest(), searchableSurface::geometryDir_, TimePaths::globalCaseName(), Foam::isDir(), and TimePaths::rootPath().

Here is the call graph for this function:

◆ bounds() [1/2]

◆ bounds() [2/2]

boundBox& bounds ( )
inline

Return non-const access to the boundBox to allow it to be set.

Definition at line 178 of file searchableSurface.H.

References searchableSurface::hasVolumeType(), searchableSurface::regions(), and searchableSurface::size().

Here is the call graph for this function:

◆ regions()

◆ hasVolumeType()

◆ size()

virtual label size ( ) const
pure virtual

◆ globalSize()

virtual label globalSize ( ) const
inlinevirtual

Range of global indices that can be returned.

Reimplemented in distributedTriSurfaceMesh.

Definition at line 193 of file searchableSurface.H.

References searchableSurface::boundingSpheres(), searchableSurface::coordinates(), searchableSurface::findNearest(), searchableSurface::overlaps(), searchableSurface::points(), and searchableSurface::size().

Referenced by refinementSurfaces::setMinLevelFields(), and searchableSurfaces::writeStats().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ coordinates()

virtual tmp<pointField> coordinates ( ) const
pure virtual

Get representative set of element coordinates.

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

Implemented in triSurfaceMesh, searchableSurfaceCollection, searchableCylinder, searchablePlate, searchableSurfaceWithGaps, searchableDisk, searchableSphere, searchableBox, searchablePlane, and searchableExtrudedCircle.

Referenced by searchableSurface::globalSize(), and searchableSurfaceWithGaps::size().

Here is the caller graph for this function:

◆ boundingSpheres()

virtual void boundingSpheres ( pointField centres,
scalarField radiusSqr 
) const
pure virtual

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

Any point on element is guaranteed to be inside.

Implemented in triSurfaceMesh, searchableSurfaceCollection, searchableCylinder, searchableSurfaceWithGaps, searchablePlate, searchableDisk, searchableSphere, searchableBox, searchablePlane, and searchableExtrudedCircle.

Referenced by searchableSurfaceWithGaps::boundingSpheres(), searchableSurface::globalSize(), and refinementSurfaces::setMinLevelFields().

Here is the caller graph for this function:

◆ points()

◆ overlaps()

virtual bool overlaps ( const boundBox bb) const
pure virtual

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

Implemented in triSurfaceMesh, searchableSurfaceCollection, searchableSurfaceWithGaps, searchableCylinder, searchablePlate, searchableDisk, searchableSphere, searchablePlane, searchableBox, and searchableExtrudedCircle.

Referenced by searchableSurface::globalSize(), and searchableSurfaceWithGaps::points().

Here is the caller graph for this function:

◆ findNearest() [1/3]

◆ findNearest() [2/3]

virtual void findNearest ( const pointField samples,
const scalarField nearestDistSqr,
const labelList regionIndices,
List< pointIndexHit > &  info 
) const
inlinevirtual

Find the nearest locations for the supplied points to a.

particular region in the searchable surface.

Reimplemented in triSurfaceMesh.

Definition at line 283 of file searchableSurface.H.

References searchableSurface::distribute(), searchableSurface::findLine(), searchableSurface::findLineAll(), searchableSurface::findLineAny(), searchableSurface::findNearest(), searchableSurface::getNormal(), searchableSurface::getRegion(), and searchableSurface::getVolumeType().

Here is the call graph for this function:

◆ findLine()

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

Find first intersection on segment from start to end.

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

Implemented in distributedTriSurfaceMesh, triSurfaceMesh, searchableBox, searchableSurfaceCollection, searchableSurfaceWithGaps, searchableCylinder, searchableDisk, searchablePlate, searchableSphere, searchablePlane, and searchableExtrudedCircle.

Referenced by searchableSurface::findNearest(), and refinementSurfaces::findNearestIntersection().

Here is the caller graph for this function:

◆ findLineAny()

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

◆ findLineAll()

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

◆ getRegion()

◆ getNormal()

◆ getVolumeType()

virtual void getVolumeType ( const pointField ,
List< volumeType > &   
) const
pure virtual

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

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

Implemented in distributedTriSurfaceMesh, triSurfaceMesh, searchableBox, searchableSurfaceCollection, searchableSurfaceWithGaps, searchableCylinder, searchableDisk, searchablePlate, searchableExtrudedCircle, searchableSphere, and searchablePlane.

Referenced by refinementSurfaces::findInside(), searchableSurface::findNearest(), and searchableSurfaceWithGaps::getVolumeType().

Here is the caller graph for this function:

◆ findNearest() [3/3]

void findNearest ( const pointField sample,
const scalarField nearestDistSqr,
List< pointIndexHit > &  info,
vectorField normal,
labelList region 
) const
virtual

Find nearest, normal and region. Can be overridden with.

optimised implementation

Definition at line 122 of file searchableSurface.C.

References searchableSurface::findNearest(), searchableSurface::getNormal(), and searchableSurface::getRegion().

Here is the call graph for this function:

◆ distribute()

virtual void distribute ( const List< treeBoundBox > &  ,
const bool  keepNonLocal,
autoPtr< mapDistribute > &  faceMap,
autoPtr< mapDistribute > &  pointMap 
)
inlinevirtual

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 in distributedTriSurfaceMesh, and searchableSurfaceCollection.

Definition at line 360 of file searchableSurface.H.

Referenced by searchableSurface::findNearest().

Here is the caller graph for this function:

◆ setField()

virtual void setField ( const labelList values)
inlinevirtual

WIP. Store element-wise field.

Reimplemented in triSurfaceMesh, searchableSurfaceWithGaps, and searchableSurfaceCollection.

Definition at line 369 of file searchableSurface.H.

References List< T >::clear(), searchableSurface::getField(), and searchableSurface::operator=().

Here is the call graph for this function:

◆ getField()

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

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 in distributedTriSurfaceMesh, triSurfaceMesh, searchableSurfaceWithGaps, and searchableSurfaceCollection.

Definition at line 375 of file searchableSurface.H.

Referenced by refinementSurfaces::findHigherIntersection(), searchableSurfaceWithGaps::getField(), and searchableSurface::setField().

Here is the caller graph for this function:

◆ operator=()

void operator= ( const searchableSurface )
delete

Disallow default bitwise assignment.

Referenced by searchableSurface::setField().

Here is the caller graph for this function:

Member Data Documentation

◆ geometryDir_

Foam::word geometryDir_
static

Name of the directory for the geometry files.

Defaults to "geometry"

Definition at line 87 of file searchableSurface.H.

Referenced by searchableSurface::geometryDir().


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