PatchFunction1 to sample an existing field. More...

Inheritance diagram for Sampled< Type >:

Collaboration diagram for Sampled< Type >:

Public Member Functions
	TypeName ("sampled")

void	operator= (const Sampled< Type > &)=delete
	No copy assignment. More...

	Sampled (const polyPatch &pp, const word &redirectType, const word &entryName, const dictionary &dict, const bool faceValues=true)
	Construct from entry name and dictionary. More...

	Sampled (const Sampled< Type > &rhs)
	Copy construct. More...

	Sampled (const Sampled< Type > &rhs, const polyPatch &pp)
	Copy construct setting patch. More...

virtual tmp< PatchFunction1< Type > >	clone () const
	Construct and return a clone. More...

virtual tmp< PatchFunction1< Type > >	clone (const polyPatch &pp) const
	Construct and return a clone setting patch. More...

virtual	~Sampled ()=default
	Destructor. More...

const GeometricField< Type, fvPatchField, volMesh > &	sampleField () const
	Field to sample. Either on my or nbr mesh. More...

virtual tmp< Field< Type > >	value (const scalar x) const
	Return sampled value. More...

virtual bool	constant () const
	Is value constant (i.e. independent of x) More...

virtual bool	uniform () const
	Is value uniform (i.e. independent of coordinate) More...

virtual tmp< Field< Type > >	integrate (const scalar x1, const scalar x2) const
	Integrate between two values. More...

virtual void	writeData (Ostream &os) const
	Write in dictionary format. More...

Public Member Functions inherited from PatchFunction1< Type >
	TypeName ("PatchFunction1") declareRunTimeSelectionTable(autoPtr
	Runtime type information. More...

	PatchFunction1 (const polyPatch &pp, const word &entryName, const bool faceValues=true)
	Construct from polyPatch and entry name. More...

	PatchFunction1 (const polyPatch &pp, const word &entryName, const dictionary &dict, const bool faceValues=true)
	Construct from polyPatch, dictionary and entry name. More...

	PatchFunction1 (const PatchFunction1< Type > &rhs)
	Copy construct. More...

	PatchFunction1 (const PatchFunction1< Type > &rhs, const polyPatch &pp)
	Copy construct setting patch. More...

virtual tmp< PatchFunction1< Type > >	clone () const =0
	Return a clone. More...

virtual tmp< PatchFunction1< Type > >	clone (const polyPatch &pp) const =0
	Return a clone, setting patch. More...

virtual	~PatchFunction1 ()=default
	Destructor. More...

virtual bool	constant () const
	Is value constant (i.e. independent of x) More...

virtual bool	good () const
	Can function be evaluated? More...

virtual bool	uniform () const =0
	Is value uniform (i.e. independent of coordinate) More...

virtual tmp< Field< Type > >	value (const scalar x) const
	Return value as a function of (scalar) independent variable. More...

virtual tmp< Field< Type > >	integrate (const scalar x1, const scalar x2) const
	Integrate between two (scalar) values. More...

virtual tmp< pointField >	localPosition (const pointField &globalPos) const
	Helper: optionally convert coordinates to local coordinates. More...

virtual tmp< Field< Type > >	transform (const Field< Type > &fld) const
	Apply optional transformation. More...

virtual tmp< Field< Type > >	transform (const tmp< Field< Type > > &tfld) const
	Apply optional transformation. More...

virtual void	autoMap (const FieldMapper &mapper)
	Map (and resize as needed) from self given a mapping object. More...

virtual void	rmap (const PatchFunction1< Type > &rhs, const labelList &addr)
	Reverse map the given PatchFunction1 onto this PatchFunction1. More...

virtual void	writeData (Ostream &os) const
	Write in dictionary format. More...

Public Member Functions inherited from patchFunction1Base
	patchFunction1Base (const polyPatch &pp, const word &entryName, const bool faceValues=true)
	Construct from polyPatch and entry name. More...

	patchFunction1Base (const polyPatch &pp, const word &entryName, const dictionary &dict, const bool faceValues=true)
	Construct from polyPatch, dictionary and entry name. More...

	patchFunction1Base (const patchFunction1Base &rhs)
	Copy construct. More...

	patchFunction1Base (const patchFunction1Base &rhs, const polyPatch &pp)
	Copy construct setting patch. More...

virtual	~patchFunction1Base ()=default
	Destructor. More...

const word &	name () const noexcept
	The name of the entry. More...

const polyPatch &	patch () const noexcept
	Reference to the patch. More...

bool	faceValues () const noexcept
	Generate face or point values on patch? More...

label	size () const
	Number of faces or points on the patch. More...

const objectRegistry *	whichDb () const
	Return the associated registry (ie, the mesh) More...

const objectRegistry &	obr () const
	Return the object registry (ie, the mesh) More...

const Time &	time () const
	Return false: function not created with time database. More...

virtual void	userTimeToTime (const Time &t)
	Convert time. More...

Public Member Functions inherited from refCount
constexpr	refCount () noexcept
	Default construct, initializing count to 0. More...

int	count () const noexcept
	Return the current reference count. More...

bool	unique () const noexcept
	Return true if the reference count is zero. More...

void	operator++ () noexcept
	Increment the reference count. More...

void	operator++ (int) noexcept
	Increment the reference count. More...

void	operator-- () noexcept
	Decrement the reference count. More...

void	operator-- (int) noexcept
	Decrement the reference count. More...

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

	mappedPatchBase (const polyPatch &)
	Construct from patch. More...

	mappedPatchBase (const polyPatch &pp, const word &sampleRegion, const sampleMode sampleMode, const word &samplePatch, const vectorField &offsets)
	Construct with offsetMode=non-uniform. More...

	mappedPatchBase (const polyPatch &pp, const word &sampleRegion, const sampleMode sampleMode, const word &samplePatch, const vector &uniformOffset)
	Construct from offsetMode=uniform. More...

	mappedPatchBase (const polyPatch &pp, const word &sampleRegion, const sampleMode sampleMode, const word &samplePatch, const scalar normalDistance)
	Construct from offsetMode=normal and distance. More...

	mappedPatchBase (const polyPatch &, const dictionary &)
	Construct from dictionary. More...

	mappedPatchBase (const polyPatch &, const sampleMode, const dictionary &)
	Construct from dictionary and (collocated) sample mode. More...

	mappedPatchBase (const polyPatch &, const mappedPatchBase &)
	Construct as copy, resetting patch. More...

	mappedPatchBase (const polyPatch &, const mappedPatchBase &, const labelUList &mapAddressing)
	Construct as copy, resetting patch, map original data. More...

virtual	~mappedPatchBase ()
	Destructor. More...

void	clearOut ()

void	setOffset (const scalar normalDist)
	Change to normal offset with given distance. More...

void	setOffset (const vector &uniformOffset)
	Change to uniform offset with value. More...

void	setOffset (const vectorField &offsets)
	Change to non-uniform offsets. More...

sampleMode	mode () const noexcept
	What to sample. More...

const word &	sampleWorld () const noexcept
	World to sample. More...

const word &	sampleRegion () const
	Region to sample. More...

const word &	samplePatch () const
	Patch (only if NEARESTPATCHFACE) More...

const word &	coupleGroup () const
	PatchGroup (only if NEARESTPATCHFACE) More...

label	sampleSize () const
	Return size of mapped mesh/patch/boundary. More...

const vector &	offset () const noexcept
	Offset vector (from patch faces to destination mesh objects) More...

const vectorField &	offsets () const noexcept
	Offset vectors (from patch faces to destination mesh objects) More...

label	getCommunicator () const
	Get the communicator (worldComm or world-to-world) More...

label	comm () const
	Identical to getCommunicator() More...

bool	sameWorld () const
	Is sample world the local world? More...

bool	masterWorld () const
	Is my world ordered before the sampleWorld? More...

bool	sameRegion () const noexcept
	Cached sampleRegion != mesh.name() More...

const mapDistribute &	map () const
	Return reference to the parallel distribution map. More...

const AMIPatchToPatchInterpolation &	AMI (const bool forceUpdate=false) const
	Return reference to the AMI interpolator. More...

bool	owner () const
	Is it owner. More...

const autoPtr< Foam::searchableSurface > &	surfPtr () const
	Return a pointer to the AMI projection surface. More...

const polyMesh &	sampleMesh () const
	Get the region mesh. More...

const polyPatch &	samplePolyPatch () const
	Get the patch on the region. More...

tmp< pointField >	samplePoints () const
	Get the sample points. More...

const fileName &	sampleDatabasePath () const

bool	sampleDatabase () const

virtual fileName	sendPath (const label proci) const

virtual fileName	receivePath (const label proci) const

template<class Type >
void	distribute (List< Type > &lst) const
	Wrapper around map/interpolate data distribution. More...

template<class Type , class CombineOp >
void	distribute (List< Type > &lst, const CombineOp &cop) const
	Wrapper around map/interpolate data distribution with operation. More...

template<class Type >
void	reverseDistribute (List< Type > &lst) const
	Wrapper around map/interpolate data distribution. More...

template<class Type , class CombineOp >
void	reverseDistribute (List< Type > &lst, const CombineOp &cop) const
	Wrapper around map/interpolate data distribution with operation. More...

virtual void	write (Ostream &os) const
	Write as a dictionary. More...

Protected Member Functions
bool	haveSampleField () const
	Field to sample. Either on my or nbr mesh. More...

Protected Member Functions inherited from PatchFunction1< Type >
void	operator= (const PatchFunction1< Type > &)=delete
	No copy assignment. More...

Protected Member Functions inherited from patchFunction1Base
void	operator= (const patchFunction1Base &)=delete
	No copy assignment. More...

Protected Member Functions inherited from mappedPatchBase
bool	addWorldConnection ()
	Add a world-world connection. More...

label	getWorldCommunicator () const
	Get the communicator for the world-world connection. More...

const polyMesh &	lookupMesh (const word &region) const
	Lookup mesh. More...

const polyPatch &	lookupPatch (const word &sampleRegion, const word &samplePatch) const
	Lookup patch. More...

tmp< pointField >	facePoints (const polyPatch &) const

void	collectSamples (const label mySampleWorld, const pointField &facePoints, pointField &samples, labelList &patchFaceWorlds, labelList &patchFaceProcs, labelList &patchFaces, pointField &patchFc) const

void	findLocalSamples (const sampleMode mode, const label sampleWorld, const word &sampleRegion, const word &samplePatch, const pointField &samplePoints, List< nearInfoWorld > &nearest) const
	Find (local) cells/faces containing samples. More...

void	findSamples (const sampleMode mode, const label myWorldIndex, const pointField &, const labelList &wantedWorlds, const labelList &origProcs, labelList &sampleProcs, labelList &sampleIndices, pointField &sampleLocations) const
	Find (global) cells/faces containing samples. More...

tmp< pointField >	samplePoints (const pointField &) const
	Get the sample points given the face points. More...

void	calcMapping () const
	Calculate mapping. More...

void	calcAMI () const
	Calculate AMI interpolator. More...

Protected Attributes
word	fieldName_
	Name of the field. More...

const bool	setAverage_
	If true adjust the mapped field to maintain average value average_. More...

const Type	average_

word	interpolationScheme_
	Interpolation scheme to use for nearestcell mode. More...

Protected Attributes inherited from PatchFunction1< Type >
coordinateScaling< Type >	coordSys_
	Optional local coordinate system and scaling. More...

Protected Attributes inherited from patchFunction1Base
const word	name_
	Name of entry. More...

const polyPatch &	patch_
	Reference to the patch. More...

const bool	faceValues_
	Generate face or point values on patch. More...

Protected Attributes inherited from mappedPatchBase
const polyPatch &	patch_
	Patch to sample. More...

word	sampleWorld_
	World to sample. More...

word	sampleRegion_
	Region to sample. More...

const sampleMode	mode_
	What to sample. More...

word	samplePatch_
	Patch (if in sampleMode NEARESTPATCH*) More...

const coupleGroupIdentifier	coupleGroup_
	PatchGroup (if in sampleMode NEARESTPATCH*) More...

const autoPtr< fileName >	sampleDatabasePtr_
	Empty or location of database. More...

offsetMode	offsetMode_
	How to obtain samples. More...

vector	offset_
	Offset vector (uniform) More...

vectorField	offsets_
	Offset vector (nonuniform) More...

scalar	distance_
	Offset distance (normal) More...

label	communicator_
	Communicator. More...

bool	sameRegion_
	Same region. More...

autoPtr< mapDistribute >	mapPtr_
	Communication schedule: More...

const bool	AMIReverse_
	Flag to indicate that slave patch should be reversed for AMI. More...

autoPtr< AMIPatchToPatchInterpolation >	AMIPtr_
	Pointer to AMI interpolator. More...

autoPtr< searchableSurface >	surfPtr_
	Pointer to projection surface employed by AMI interpolator. More...

dictionary	surfDict_
	Dictionary storing projection surface description. More...

Additional Inherited Members
Public Types inherited from PatchFunction1< Type >
typedef Field< Type >	returnType

Public Types inherited from mappedPatchBase
enum	sampleMode { NEARESTCELL , NEARESTPATCHFACE , NEARESTPATCHFACEAMI , NEARESTPATCHPOINT , NEARESTFACE , NEARESTONLYCELL }
	Mesh items to sample. More...

enum	offsetMode { UNIFORM , NONUNIFORM , NORMAL }
	How to project face centres. More...

typedef Tuple2< pointIndexHit, Tuple2< scalar, label > >	nearInfo
	Helper class for finding nearest. More...

typedef Tuple2< nearInfo, label >	nearInfoWorld
	nearest + world More...

Static Public Member Functions inherited from PatchFunction1< Type >
static autoPtr< PatchFunction1< Type > >	New (const polyPatch &pp, const word &entryName, const dictionary &dict, const bool faceValues=true, const bool mandatory=true)
	Selector. More...

static autoPtr< PatchFunction1< Type > >	NewCompat (const polyPatch &pp, const word &entryName, std::initializer_list< std::pair< const char *, int > > compat, const dictionary &dict, const bool faceValues=true, const bool mandatory=true)
	Compatibility selector. More...

static autoPtr< PatchFunction1< Type > >	NewIfPresent (const polyPatch &pp, const word &entryName, const dictionary &dict, const bool faceValues=true)
	An optional selector. More...

static refPtr< PatchFunction1< Type > >	New (HashPtrTable< PatchFunction1< Type > > &cache, const polyPatch &pp, const word &entryName, const dictionary &dict, enum keyType::option matchOpt=keyType::LITERAL, const bool faceValues=true, const bool mandatory=true)

Static Public Member Functions inherited from mappedPatchBase
static pointIndexHit	facePoint (const polyMesh &, const label facei, const polyMesh::cellDecomposition)
	Get a point on the face given a face decomposition method: More...

static fileName	sendPath (const fileName &root, const label proci)
	Helper: return path to store data to be sent to processor i. More...

static fileName	receivePath (const fileName &root, const label proci)

static const objectRegistry &	subRegistry (const objectRegistry &obr, const fileName &path)

template<class Type >
static void	storeField (objectRegistry &obr, const word &fieldName, const Field< Type > &values)
	Store an IOField on the objectRegistry relative to obr. More...

static void	writeDict (const objectRegistry &obr, dictionary &dict)
	Convert objectRegistry contents into dictionary. More...

static void	readDict (const dictionary &d, objectRegistry &obr)
	(recursively) construct and register IOFields from dictionary More...

Public Attributes inherited from PatchFunction1< Type >
	PatchFunction1

	dictionary

const polyPatch &	pp

const polyPatch const word &	type

const polyPatch const word const word &	entryName

const polyPatch const word const word const dictionary &	dict

const polyPatch const word const word const dictionary const bool	faceValues

const polyPatch const word const word const dictionary const bool	pp

const polyPatch const word const word const dictionary const bool	type

const polyPatch const word const word const dictionary const bool	entryName

const polyPatch const word const word const dictionary const bool	dict

Static Public Attributes inherited from mappedPatchBase
static const Enum< sampleMode >	sampleModeNames_

static const Enum< offsetMode >	offsetModeNames_

Static Protected Member Functions inherited from mappedPatchBase
static autoPtr< fileName >	readDatabase (const dictionary &dict)
	Read optional database name from dictionary. More...

static const objectRegistry &	subRegistry (const objectRegistry &obr, const wordList &names, const label index)

template<class Type >
static bool	writeIOField (const regIOobject &obj, dictionary &dict)
	Attempt to detect an IOField<Type> and write to dictionary. More...

template<class Type >
static bool	constructIOField (const word &name, token &tok, Istream &is, objectRegistry &obr)
	Attempt to read an IOField<Type> and store on objectRegistry. More...

Detailed Description

template<class Type>
class Foam::PatchFunction1Types::Sampled< Type >

PatchFunction1 to sample an existing field.

It is the exact functionality from mappedField boundary condition with the following differences:

the field name is specified. So any derived fields will have the same field name to sample.
if used with uniformFixedValue boundary condition there is the problem that that re-evaluates instead of reading/mapping.

Usage

Property	Description	Required	Default value
`field`	Field name	yes
`sampleMode`	how to obtain samples	yes
`sampleRegion`	mesh to sample	no	""
`samplePatch`	patch to sample	no	""
`offsetMode`	how to offset samples	no	uniform
`offset`	uniform offset vector	no	(0 0 0)
`interpolationScheme`	interpolation method	yes	cell
`setAverage`	optional average adjustment	no	false
`average`	optional average value	no

Example of the boundary condition specification:

    <patchName>
    {
        // Field to sample
        field           U;

        // Geometric/mapping info (equivalent of 'mappedPatch' patch type)
        sampleMode      nearestCell;
        offset          (0 -0.001 0);

        // Field specific info (equivalent of 'mappedField' patch field type)
        interpolationScheme cell;
    }

Source files

Definition at line 142 of file Sampled.H.

Constructor & Destructor Documentation

◆ Sampled() [1/3]

Sampled	(	const polyPatch &	pp,
		const word &	redirectType,
		const word &	entryName,
		const dictionary &	dict,
		const bool	faceValues = `true`
	)

Construct from entry name and dictionary.

Definition at line 53 of file Sampled.C.

References Sampled< Type >::interpolationScheme_, mappedPatchBase::mode(), mappedPatchBase::NEARESTCELL, and dictionary::readEntry().

Here is the call graph for this function:

◆ Sampled() [2/3]

Sampled ( const Sampled< Type > & rhs )

explicit

Copy construct.

Definition at line 77 of file Sampled.C.

◆ Sampled() [3/3]

Sampled	(	const Sampled< Type > &	rhs,
		const polyPatch &	pp
	)

explicit

Copy construct setting patch.

Definition at line 87 of file Sampled.C.

◆ ~Sampled()

virtual ~Sampled ( )

virtualdefault

Destructor.

Member Function Documentation

◆ haveSampleField()

bool haveSampleField

protected

Field to sample. Either on my or nbr mesh.

Definition at line 125 of file Sampled.C.

References polyPatch::boundaryMesh(), polyBoundaryMesh::mesh(), and mappedPatchBase::patch_.

Here is the call graph for this function:

◆ TypeName()

TypeName ( "sampled" )

◆ operator=()

void operator= ( const Sampled< Type > & )

delete

No copy assignment.

◆ clone() [1/2]

virtual tmp< PatchFunction1< Type > > clone ( ) const

inlinevirtual

Construct and return a clone.

Implements PatchFunction1< Type >.

Definition at line 212 of file Sampled.H.

◆ clone() [2/2]

virtual tmp< PatchFunction1< Type > > clone ( const polyPatch & pp ) const

inlinevirtual

Construct and return a clone setting patch.

Implements PatchFunction1< Type >.

Definition at line 221 of file Sampled.H.

References PatchFunction1< Type >::pp.

◆ sampleField()

const Foam::GeometricField< Type, Foam::fvPatchField, Foam::volMesh > & sampleField

Field to sample. Either on my or nbr mesh.

Definition at line 106 of file Sampled.C.

References polyPatch::boundaryMesh(), polyBoundaryMesh::mesh(), and mappedPatchBase::patch_.

Here is the call graph for this function:

◆ value()

Foam::tmp< Foam::Field< Type > > value ( const scalar x ) const

virtual

Return sampled value.

Reimplemented from PatchFunction1< Type >.

Definition at line 145 of file Sampled.C.

References Foam::abort(), polyMesh::boundaryMesh(), mapDistribute::distribute(), Foam::FatalError, FatalErrorInFunction, polyBoundaryMesh::findPatchID(), forAll, Foam::gAverage(), Foam::gSum(), Foam::mag(), pTraits< complex >::max, mesh, Foam::mode(), UPstream::msgType(), patchIdentifier::name(), primitiveMesh::nCells(), mappedPatchBase::NEARESTCELL, mappedPatchBase::NEARESTFACE, mappedPatchBase::NEARESTPATCHFACE, mappedPatchBase::NEARESTPATCHFACEAMI, Time::New(), Foam::New(), primitiveMesh::nFaces(), Foam::nl, mappedPatchBase::patch_, Foam::returnReduce(), mapDistribute::reverseDistribute(), samples(), Foam::transform(), and Foam::Zero.

Here is the call graph for this function:

◆ constant()

virtual bool constant ( ) const

inlinevirtual

Is value constant (i.e. independent of x)

Reimplemented from PatchFunction1< Type >.

Definition at line 245 of file Sampled.H.

◆ uniform()

virtual bool uniform ( ) const

inlinevirtual

Is value uniform (i.e. independent of coordinate)

Implements PatchFunction1< Type >.

Definition at line 251 of file Sampled.H.

◆ integrate()

Foam::tmp< Foam::Field< Type > > integrate	(	const scalar	x1,
		const scalar	x2
	)		const

virtual

Integrate between two values.

Reimplemented from PatchFunction1< Type >.

Definition at line 316 of file Sampled.C.

References NotImplemented.

◆ writeData()

void writeData ( Ostream & os ) const

virtual

Write in dictionary format.

Reimplemented from PatchFunction1< Type >.

Definition at line 328 of file Sampled.C.

References Foam::name(), os(), Foam::type(), and ObukhovLength::write().

Here is the call graph for this function:

Member Data Documentation

◆ fieldName_

word fieldName_

protected

Name of the field.

Definition at line 158 of file Sampled.H.

◆ setAverage_

const bool setAverage_

protected

If true adjust the mapped field to maintain average value average_.

Definition at line 161 of file Sampled.H.

◆ average_

const Type average_

protected

Average value the mapped field is adjusted to maintain if setAverage_ is set true

Definition at line 165 of file Sampled.H.

◆ interpolationScheme_

word interpolationScheme_

protected

Interpolation scheme to use for nearestcell mode.

Definition at line 168 of file Sampled.H.

Referenced by Sampled< Type >::Sampled().

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

src/finiteVolume/fields/fvPatchFields/derived/mappedField/Sampled/Sampled.H
src/finiteVolume/fields/fvPatchFields/derived/mappedField/Sampled/Sampled.C

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Sampled() [1/3]

◆ Sampled() [2/3]

◆ Sampled() [3/3]

◆ ~Sampled()

Member Function Documentation

◆ haveSampleField()

◆ TypeName()

◆ operator=()

◆ clone() [1/2]

◆ clone() [2/2]

◆ sampleField()

◆ value()

◆ constant()

◆ uniform()

◆ integrate()

◆ writeData()

Member Data Documentation

◆ fieldName_

◆ setAverage_

◆ average_

◆ interpolationScheme_