Calculates propeller performance and wake field properties. More...

#include <propellerInfo.H>

Inheritance diagram for propellerInfo:

Collaboration diagram for propellerInfo:

[legend]

Public Types
enum class	rotationMode { SPECIFIED , MRF }

Public Member Functions
	TypeName ("propellerInfo")
	Runtime type information.
	propellerInfo (const word &name, const Time &runTime, const dictionary &dict, const bool readFields=true)
	Construct from name, Time and dictionary.
	propellerInfo (const word &name, const objectRegistry &obr, const dictionary &dict, const bool readFields=true)
	Construct from objectRegistry and dictionary.
virtual	~propellerInfo ()=default
	Destructor.
virtual bool	read (const dictionary &)
	Read the function-object dictionary.
virtual bool	execute ()
	Execute the function-object operations.
virtual bool	write ()
	Write the function-object results.
void	UpdateMesh (const mapPolyMesh &mpm)
void	movePoints (const polyMesh &mesh)
	Update for changes of mesh.
template<class Type>
Foam::tmp< Foam::Field< Type > >	interpolate (const GeometricField< Type, fvPatchField, volMesh > &psi, const Type &defaultValue) const
Public Member Functions inherited from forces
	TypeName ("forces")
	Runtime type information.
	forces (const word &name, const Time &runTime, const dictionary &dict, const bool readFields=true)
	Construct from name, Time and dictionary.
	forces (const word &name, const objectRegistry &obr, const dictionary &dict, const bool readFields=true)
	Construct from objectRegistry and dictionary.
	forces (const forces &)=delete
	No copy construct.
void	operator= (const forces &)=delete
	No copy assignment.
virtual	~forces ()=default
	Destructor.
virtual void	calcForcesMoments ()
	Calculate forces and moments.
virtual vector	forceEff () const
	Return the total force.
virtual vector	momentEff () const
	Return the total moment.
Public Member Functions inherited from fvMeshFunctionObject
	TypeName ("fvMeshFunctionObject")
	Runtime type information.
	fvMeshFunctionObject (const word &name, const Time &runTime, const dictionary &dict)
	Construct from Time and dictionary.
	fvMeshFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)
	Construct from the region objectRegistry and dictionary.
virtual	~fvMeshFunctionObject ()=default
	Destructor.
Public Member Functions inherited from regionFunctionObject
	TypeName ("regionFunctionObject")
	Runtime type information.
	regionFunctionObject (const word &name, const Time &runTime, const dictionary &dict)
	Construct from Time and dictionary.
	regionFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)
	Construct from the region objectRegistry and dictionary.
virtual	~regionFunctionObject ()=default
	Destructor.
template<class ObjectType>
const ObjectType *	lookupObjectPtr (const word &fieldName) const
	Deprecated(2018-10).
template<class ObjectType>
ObjectType *	lookupObjectRefPtr (const word &fieldName) const
	Deprecated(2018-10).
Public Member Functions inherited from stateFunctionObject
	stateFunctionObject (const word &name, const Time &runTime)
	Construct from components.
virtual	~stateFunctionObject ()=default
	Destructor.
dictionary &	propertyDict ()
	Return access to the property dictionary.
bool	foundProperty (const word &entryName) const
	Return true if the property exists.
void	clearTrigger ()
	Remove the trigger index from the properties.
label	getTrigger () const
	Get the current trigger index.
bool	setTrigger (const label triggeri)
	Set new trigger index.
bool	getDict (const word &entryName, dictionary &dict) const
	Set dictionary, return true if set.
bool	getObjectDict (const word &objectName, const word &entryName, dictionary &dict) const
	Set dictionary from named object, return true if set.
template<class Type>
Type	getProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property.
template<class Type>
bool	getProperty (const word &entryName, Type &value) const
	Set generic property, return true if set.
template<class Type>
void	setProperty (const word &entryName, const Type &value)
	Add generic property.
template<class Type>
Type	getObjectProperty (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from named object.
template<class Type>
bool	getObjectProperty (const word &objectName, const word &entryName, Type &value) const
	Set generic property from named object, return true if set.
template<class Type>
void	setObjectProperty (const word &objectName, const word &entryName, const Type &value)
	Add generic property from named object.
bool	getObjectResultDict (const word &objectName, dictionary &dict) const
template<class Type>
void	setResult (const word &entryName, const Type &value)
	Add result.
template<class Type>
void	setObjectResult (const word &objectName, const word &entryName, const Type &value)
	Add result from named object.
template<class Type>
Type	getResult (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve result.
template<class Type>
Type	getObjectResult (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve result from named object.
template<class Type>
bool	getObjectResult (const word &objectName, const word &entryName, Type &value) const
	Set result from named object, return true if set.
word	resultType (const word &entryName) const
	Retrieve the result type.
word	objectResultType (const word &objectName, const word &entryName) const
	Return the type of result.
wordList	objectResultEntries () const
	Retrieve the result entries.
wordList	objectResultEntries (const word &objectName) const
	Return result entries for named object.
void	writeResultEntries (Ostream &os) const
	Write the results entries for all objects to stream.
void	writeResultEntries (const word &objectName, Ostream &os) const
	Write the results entries for named object to stream.
void	writeAllResultEntries (Ostream &os) const
	Write the results entries for all objects to stream.
Public Member Functions inherited from timeFunctionObject
	timeFunctionObject (const word &name, const Time &runTime)
	Construct from Time.
virtual	~timeFunctionObject ()=default
	Destructor.
const Time &	time () const
	Return time database.
objectRegistry &	storedObjects ()
	Write access to the output objects ("functionObjectObjects") registered on Time.
const objectRegistry &	storedObjects () const
	Const access to the output objects ("functionObjectObjects") registered on Time.
Public Member Functions inherited from functionObject
	declareRunTimeSelectionTable (autoPtr, functionObject, dictionary,(const word &name, const Time &runTime, const dictionary &dict),(name, runTime, dict))
	functionObject (const word &name, const bool withNamePrefix=defaultUseNamePrefix)
	Construct from components.
autoPtr< functionObject >	clone () const
	Return clone.
virtual	~functionObject ()=default
	Destructor.
virtual const word &	type () const =0
	Runtime type information.
const word &	name () const noexcept
	Return the name of this functionObject.
bool	useNamePrefix () const noexcept
	Return the flag for adding a scoping name prefix.
bool	useNamePrefix (bool on) noexcept
	Modify the flag for adding a scoping name prefix.
virtual bool	execute (const label subIndex)
	Execute using the specified subIndex.
virtual bool	end ()
	Called when Time::run() determines that the time-loop exits.
virtual bool	adjustTimeStep ()
	Called at the end of Time::adjustDeltaT() if adjustTime is true.
virtual bool	filesModified () const
	Did any file get changed during execution?
virtual void	updateMesh (const mapPolyMesh &mpm)
	Update for changes of mesh.
Public Member Functions inherited from writeFile
	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name="undefined", const bool writeToFile=true, const string &ext=".dat")
	Construct from objectRegistry, prefix, fileName.
	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name, const dictionary &dict, const bool writeToFile=true, const string &ext=".dat")
	Construct from objectRegistry, prefix, fileName and read options from dictionary.
	writeFile (const writeFile &wf)
	Construct copy.
virtual	~writeFile ()=default
	Destructor.
virtual const string &	setExt (const string &ext)
	Set extension.
virtual OFstream &	file ()
	Return access to the file (if only 1).
virtual bool	writeToFile () const
	Flag to allow writing to file.
virtual bool	canWriteToFile () const
	Flag to allow writing to the file.
virtual bool	canResetFile () const
	Flag to allow resetting the file.
virtual bool	canWriteHeader () const
	Flag to allow writing the header.
virtual label	charWidth () const
	Return width of character stream output.
virtual void	writeCommented (Ostream &os, const string &str) const
	Write a commented string to stream.
virtual void	writeTabbed (Ostream &os, const string &str) const
	Write a tabbed string to stream.
virtual void	writeHeader (Ostream &os, const string &str) const
	Write a commented header to stream.
virtual void	writeCurrentTime (Ostream &os) const
	Write the current time to stream.
virtual void	writeBreak (Ostream &os) const
	Write a break marker to the stream.
template<class Type>
void	writeHeaderValue (Ostream &os, const string &property, const Type &value) const
	Write a (commented) header property and value pair.
template<class Type>
void	writeValue (Ostream &os, const Type &val) const
	Write a given value to stream with the space delimiter.

Static Public Attributes
static const Enum< rotationMode >	rotationModeNames_
Static Public Attributes inherited from functionObject
static int	debug
	Flag to execute debug content.
static bool	postProcess
	Global post-processing mode switch.
static bool	defaultUseNamePrefix
	Global default for useNamePrefix.
static word	outputPrefix
	Directory prefix.
Static Public Attributes inherited from writeFile
static label	addChars = 8
	Additional characters for writing.

Protected Member Functions
void	setCoordinateSystem (const dictionary &dict)
	Set the coordinate system.
void	setRotationalSpeed ()
	Set the rotational speed.
void	createFiles ()
	Create output files.
const volVectorField &	U () const
	Return the velocity field.
void	writePropellerPerformance ()
	Write the wake fields.
void	writeWake (const vectorField &U, const scalar URef)
	Write the wake text file.
void	writeAxialWake (const vectorField &U, const scalar URef)
	Write the axial wake text file.
void	writeWakeFields (const scalar URef)
	Write the wake fields.
void	setSampleDiskGeometry (const coordinateSystem &coordSys, const scalar r1, const scalar r2, const scalar nTheta, const label nRadius, faceList &faces, pointField &points) const
	Set the faces and points for the sample surface.
void	setSampleDiskSurface (const dictionary &dict)
	Set the sample surface based on dictionary settings.
void	updateSampleDiskCells ()
	Set the sample cells corresponding to the sample points.
scalar	meanSampleDiskField (const scalarField &field) const
	Return the area average of a field.
void	writeSampleDiskSurface (const vectorField &U, const vectorField &Ur, const scalar URef)
	Write the sample surface.
template<class Type>
tmp< Field< Type > >	interpolate (const GeometricField< Type, fvPatchField, volMesh > &psi, const Type &defaultValue) const
	Interpolate from the mesh onto the sample surface.
	propellerInfo (const propellerInfo &)=delete
	No copy construct.
void	operator= (const propellerInfo &)=delete
	No copy assignment.
Protected Member Functions inherited from forces
void	setCoordinateSystem (const dictionary &dict, const word &e3Name=word::null, const word &e1Name=word::null)
	Set the co-ordinate system from dictionary and axes names.
volVectorField &	force ()
	Return access to the force field.
volVectorField &	moment ()
	Return access to the moment field.
void	initialise ()
	Initialise containers and fields.
void	reset ()
	Reset containers and fields.
tmp< symmTensorField >	devRhoReff (const tensorField &gradUp, const label patchi) const
	Return the effective stress (viscous + turbulent) for patch.
tmp< volScalarField >	mu () const
	Return dynamic viscosity field.
tmp< volScalarField >	rho () const
	Return rho if specified otherwise rhoRef.
tmp< scalarField >	rho (const label patchi) const
	Return rho if specified otherwise rhoRef for patch.
scalar	rho (const volScalarField &p) const
	Return rhoRef if the pressure field is dynamic (i.e. p/rho), otherwise return 1.
void	addToPatchFields (const label patchi, const vectorField &Md, const vectorField &fP, const vectorField &fV)
	Add patch contributions to force and moment fields.
void	addToInternalField (const labelList &cellIDs, const vectorField &Md, const vectorField &f)
	Add cell contributions to force and moment fields, and include porosity effects.
void	createIntegratedDataFiles ()
	Create the integrated-data files.
void	writeIntegratedDataFileHeader (const word &header, OFstream &os) const
	Write header for an integrated-data file.
void	writeIntegratedDataFiles ()
	Write integrated data to files.
void	writeIntegratedDataFile (const vector &pres, const vector &vis, const vector &internal, OFstream &os) const
	Write integrated data to a file.
void	logIntegratedData (const string &descriptor, const vector &pres, const vector &vis, const vector &internal) const
	Write integrated data to stream.
Protected Member Functions inherited from fvMeshFunctionObject
	fvMeshFunctionObject (const fvMeshFunctionObject &)=delete
	No copy construct.
void	operator= (const fvMeshFunctionObject &)=delete
	No copy assignment.
Protected Member Functions inherited from regionFunctionObject
virtual const objectRegistry &	obr () const
	The region or sub-region registry being used.
template<class ObjectType>
bool	foundObject (const word &fieldName) const
	Find object (eg, a field) in the (sub) objectRegistry.
template<class ObjectType>
const ObjectType *	cfindObject (const word &fieldName) const
	Return const pointer to the object (eg, a field) in the (sub) objectRegistry.
template<class ObjectType>
const ObjectType *	findObject (const word &fieldName) const
	Return const pointer to the object (eg, a field) in the (sub) objectRegistry.
template<class ObjectType>
ObjectType *	findObject (const word &fieldName)
	Return non-const pointer to the object of the given Type, (sub) objectRegistry.
template<class ObjectType>
ObjectType *	getObjectPtr (const word &fieldName) const
	Return non-const pointer to the object of the given Type, using a const-cast to have it behave like a mutable.
template<class ObjectType>
const ObjectType &	lookupObject (const word &fieldName) const
	Lookup and return object (eg, a field) from the (sub) objectRegistry.
template<class ObjectType>
ObjectType &	lookupObjectRef (const word &fieldName) const
	Lookup and return object (eg, a field) from the (sub) objectRegistry.
template<class ObjectType>
bool	store (word &fieldName, const tmp< ObjectType > &tfield, bool cacheable=false)
	Store the field in the (sub) objectRegistry under the given name.
template<class ObjectType>
bool	storeInDb (const word &fieldName, const tmp< ObjectType > &tfield, const objectRegistry &obr)
	Store the field in an optional objectRegistry under the given name.
bool	writeObject (const word &fieldName)
	Write field if present in the (sub) objectRegistry.
bool	clearObject (const word &fieldName)
	Clear field from the (sub) objectRegistry if present.
void	clearObjects (const wordList &objNames)
	Clear fields from the (sub) objectRegistry if present.
	regionFunctionObject (const regionFunctionObject &)=delete
	No copy construct.
void	operator= (const regionFunctionObject &)=delete
	No copy assignment.
Protected Member Functions inherited from stateFunctionObject
const functionObjects::properties &	stateDict () const
	Return a const reference to the state dictionary.
functionObjects::properties &	stateDict ()
	Return non-const access to the state dictionary.
	stateFunctionObject (const stateFunctionObject &)=delete
	No copy construct.
void	operator= (const stateFunctionObject &)=delete
	No copy assignment.
Protected Member Functions inherited from timeFunctionObject
void	clearOutputObjects (const wordList &objNames)
	Remove specified items from "functionObjectObjects".
	timeFunctionObject (const timeFunctionObject &)=delete
	No copy construct.
void	operator= (const timeFunctionObject &)=delete
	No copy assignment.
Protected Member Functions inherited from functionObject
word	scopedName (const word &name) const
	Return a scoped (prefixed) name.
Protected Member Functions inherited from writeFile
void	initStream (Ostream &os) const
	Initialise the output stream for writing.
fileName	baseFileDir () const
	Return the base directory for output.
fileName	baseTimeDir () const
	Return the base directory for the current time value.
fileName	filePath (const fileName &fName) const
	Return the full path for the supplied file name.
virtual autoPtr< OFstream >	newFile (const fileName &fName) const
	Return autoPtr to a new file using file name.
virtual autoPtr< OFstream >	newFileAtTime (const word &name, scalar timeValue) const
	Return autoPtr to a new file for a given time.
virtual autoPtr< OFstream >	newFileAtStartTime (const word &name) const
	Return autoPtr to a new file using the simulation start time.
virtual void	resetFile (const word &name)
	Reset internal file pointer to new file with new name.
Omanip< int >	valueWidth (const label offset=0) const
	Return the value width when writing to stream with optional offset.
void	operator= (const writeFile &)=delete
	No copy assignment.
virtual autoPtr< OFstream >	createFile (const word &name, scalar timeValue) const
	Deprecated(2022-09) Return autoPtr to a new file for a given time.
virtual autoPtr< OFstream >	createFile (const word &name) const
	Deprecated(2022-09) Return autoPtr to a new file using the simulation start time.

Protected Attributes
dictionary	dict_
	Copy of dictionary used during construction.
scalar	radius_
	Propeller radius.
autoPtr< Function1< scalar > >	URefPtr_
	Reference velocity.
rotationMode	rotationMode_
	Rotation mode.
word	MRFName_
	Name of MRF zone (if applicable).
scalar	n_
	Propeller speed (revolutions per second).
bool	writePropellerPerformance_
	Flag to write performance data.
autoPtr< OFstream >	propellerPerformanceFilePtr_
	Propeller performance file.
bool	writeWakeFields_
	Flag to write wake fields.
autoPtr< surfaceWriter >	surfaceWriterPtr_
	Surface writer.
label	nTheta_
	Number of surface divisions in theta direction.
label	nRadial_
	Number of surface divisions in radial direction.
pointField	points_
	Surface points.
bool	errorOnPointNotFound_
	Flag to raise an error if the sample point is not found in the mesh. Default = false to enable. e.g. reduced geometry/symmetric cases.
faceList	faces_
	Surface faces.
labelList	cellIds_
	Surface point sample cell IDs.
boolList	pointMask_
	List of participating points (parallel reduced).
word	interpolationScheme_
	Interpolation scheme.
autoPtr< OFstream >	wakeFilePtr_
	Wake field file.
autoPtr< OFstream >	axialWakeFilePtr_
	Axial wake field file.
scalar	nanValue_
	Default value when a sample point is not found; default = scalar::min.
bool	initialised_
	Initialised flag.
Protected Attributes inherited from forces
vector	sumPatchForcesP_
	Sum of patch pressure forces.
vector	sumPatchForcesV_
	Sum of patch viscous forces.
vector	sumPatchMomentsP_
	Sum of patch pressure moments.
vector	sumPatchMomentsV_
	Sum of patch viscous moments.
vector	sumInternalForces_
	Sum of internal forces.
vector	sumInternalMoments_
	Sum of internal moments.
autoPtr< OFstream >	forceFilePtr_
	File stream for forces.
autoPtr< OFstream >	momentFilePtr_
	File stream for moments.
autoPtr< coordinateSystem >	coordSysPtr_
	Coordinate system used when evaluating forces and moments.
labelList	patchIDs_
	Selected operand patches.
scalar	rhoRef_
	Reference density needed for incompressible calculations.
scalar	pRef_
	Reference pressure.
word	pName_
	Name of pressure field.
word	UName_
	Name of velocity field.
word	rhoName_
	Name of density field.
word	fDName_
	Name of force density field.
bool	directForceDensity_
	Flag to directly supply force density.
bool	porosity_
	Flag to include porosity effects.
bool	writeFields_
	Flag to write force and moment fields.
bool	initialised_
	Flag of initialisation (internal).
Protected Attributes inherited from fvMeshFunctionObject
const fvMesh &	mesh_
	Reference to the fvMesh.
Protected Attributes inherited from regionFunctionObject
word	subRegistryName_
	Name for alternative object registry.
const objectRegistry &	obr_
	Reference to the region objectRegistry.
const objectRegistry *	obrPtr_
	Pointer to alternative (eg, sub-region) objectRegistry.
Protected Attributes inherited from timeFunctionObject
const Time &	time_
	Reference to the time database.
Protected Attributes inherited from writeFile
const objectRegistry &	fileObr_
	Reference to the region objectRegistry.
const fileName	prefix_
	Prefix.
word	fileName_
	Name of file.
autoPtr< OFstream >	filePtr_
	File pointer.
label	writePrecision_
	Write precision.
bool	writeToFile_
	Flag to enable/disable writing to file.
bool	updateHeader_
	Flag to update the header, e.g. on mesh changes. Default is true.
bool	writtenHeader_
	Flag to identify whether the header has been written.
bool	useUserTime_
	Flag to use the specified user time, e.g. CA deg instead of seconds. Default = true.
scalar	startTime_
	Start time value.
string	ext_
	File extension; default = .dat.

Additional Inherited Members
Static Public Member Functions inherited from functionObject
static autoPtr< functionObject >	New (const word &name, const Time &runTime, const dictionary &dict)
	Select from dictionary, based on its "type" entry.
Public Attributes inherited from functionObject
bool	log
	Flag to write log into Info.

Detailed Description

Calculates propeller performance and wake field properties.

Controlled by executeControl:

Propeller performance
- Thrust coefficient, Kt
- Torque coefficient, 10*Kq
- Advance coefficient, J
- Open water efficiency, etaO
- Written to postProcessing/<name>/<time>/propellerPerformance.dat

Controlled by writeControl:

Wake field text file
- Wake: 1 - UzMean/URef
- Velocity in cylindrical coordinates at xyz locations
- Written to postProcessing/<name>/<time>/wake.dat
Axial wake field text file
- 1 - Uz/URef at r/R and angle
- Written to postProcessing/<name>/<time>/axialWake.dat
Velocity surface
- Written to postProcessing/<name>/surfaces/<time>/disk.<fileType>

Usage

Example of function object specification:

propellerInfo1
{
    type            propellerInfo;
    libs            (forces);
    writeControl    writeTime;

    patches         ("propeller.*");

    URef            5; // Function1 type; 'constant' form shown here
    rho             rhoInf; // incompressible
    rhoInf          1.2;

    // Optionally write propeller performance data
    writePropellerPerformance yes;


    // Propeller data:

    // Radius
    radius          0.1;

    rotationMode    specified; // specified | MRF

    // rotationMode = specified:
    origin          (0 -0.1 0);
    n               25.15;
    axis            (0 1 0);

    // Optional reference direction for angle (alpha) = 0
    alphaAxis       (1 0 0);


    //// rotationMode = mrf
    //// MRF             MRFZoneName;
    //// (origin, n and axis retrieved from MRF model)

    // Optionally write wake text files
    // Note: controlled by writeControl
    writeWakeFields yes;

    // Sample plane (disk) properties
    // Note: controlled by writeControl
    sampleDisk
    {
        surfaceWriter   vtk;
        r1              0.05;
        r2              0.2;
        nTheta          36;
        nRadial         10;
        interpolationScheme cellPoint;
        errorOnPointNotFound false;
    }
}

Where the entries comprise:

Property	Description	Reqd	Deflt
`type`	Type name: propellerInfo	yes
`log`	Write to standard output	no	no
`patches`	Patches included in the forces calculation	yes
`p`	Pressure field name	no	p
`U`	Velocity field name	no	U
`rho`	Density field name	no	rho
`URef`	Reference velocity	yes
`rotationMode`	Rotation mode (see below)	yes
`origin`	Sample disk centre	no*
`axis`	Propeller axis	no*
`alphaAxis`	Axis that defines alpha=0 dir	no
`n`	Rotation speed [rev/sec]	no*
`rpm`	Rotation speed [rev/min]	no*
`MRF`	Name of MRF zone	no*
`originOffset`	Origin offset for MRF mode	no	(0 0 0)
`writePropellerPerformance`	Write propeller performance text file	yes
`writeWakeFields`	Write wake field text files	yes
`surfaceWriter`	Sample disk surface writer	no*
`r1`	Sample disk inner radius	no	0
`r2`	Sample disk outer radius	no*
`nTheta`	Divisions in theta direction	no*
`nRadial`	Divisions in radial direction	no*
`interpolationScheme`	Sampling interpolation scheme	no*	cell

Note

URef is a scalar Function1 type, i.e. supports constant, table, lookup values
rotationMode is used to set the origin, axis and revolutions per second (alternatively rpm)
- if set to 'specified' all 3 entries are required
  - note: origin is the sample disk origin
- if set to 'MRF' only the MRF entry is required
  - to move the sample disk away from the MRF origin, use the originOffset
if writePropellerPerformance is set to on|true:
- propellerPerformance text file will be written
if writeWakeFields is set to on|true:
- wake and axialWake text files will be written
if the surfaceWriter entry is set, the sample disk surface will be written
- extents set according to the r1 and r2 entries
- discretised according to the nTheta and nRadial entries

See also: Foam::functionObject::forces Foam::Function1

Source files

Definition at line 304 of file propellerInfo.H.

Member Enumeration Documentation

◆ rotationMode

enum class rotationMode

strong

Enumerator
SPECIFIED
MRF

Definition at line 311 of file propellerInfo.H.

Constructor & Destructor Documentation

◆ propellerInfo() [1/3]

propellerInfo ( const propellerInfo & )

protecteddelete

No copy construct.

References propellerInfo().

Referenced by operator=(), propellerInfo(), and propellerInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ propellerInfo() [2/3]

propellerInfo	(	const word &	name,
		const Time &	runTime,
		const dictionary &	dict,
		const bool	readFields = true )

Construct from name, Time and dictionary.

Definition at line 797 of file propellerInfo.C.

References axialWakeFilePtr_, cellIds_, dict, dict_, Foam::endl(), errorOnPointNotFound_, faces_, forces::forces(), initialised_, interpolationScheme_, Log, Foam::min(), MRFName_, n_, Foam::name(), nanValue_, nRadial_, nTheta_, pointMask_, points_, propellerPerformanceFilePtr_, radius_, read(), rotationMode_, runTime, surfaceWriterPtr_, URefPtr_, wakeFilePtr_, writePropellerPerformance_, and writeWakeFields_.

Here is the call graph for this function:

◆ propellerInfo() [3/3]

propellerInfo	(	const word &	name,
		const objectRegistry &	obr,
		const dictionary &	dict,
		const bool	readFields = true )

Construct from objectRegistry and dictionary.

Definition at line 837 of file propellerInfo.C.

References dict, Foam::name(), regionFunctionObject::obr(), propellerInfo(), and timeFunctionObject::time().

Here is the call graph for this function:

◆ ~propellerInfo()

virtual ~propellerInfo ( )

virtualdefault

Destructor.

References mesh.

Member Function Documentation

◆ setCoordinateSystem()

void setCoordinateSystem ( const dictionary & dict )

protected

Set the coordinate system.

Definition at line 53 of file propellerInfo.C.

References Foam::abort(), forces::coordSysPtr_, dict, Foam::exit(), Foam::FatalError, FatalErrorInFunction, Foam::FatalIOError, FatalIOErrorInFunction, fvMeshFunctionObject::mesh_, MRF, MRFName_, n_, Vector< Cmpt >::normalise(), rotationMode_, rotationModeNames_, SPECIFIED, Foam::constant::mathematical::twoPi(), and Foam::Zero.

Referenced by execute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setRotationalSpeed()

void setRotationalSpeed ( )

protected

Set the rotational speed.

Definition at line 131 of file propellerInfo.C.

References Foam::abort(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, fvMeshFunctionObject::mesh_, MRF, MRFName_, n_, rotationMode_, rotationModeNames_, SPECIFIED, and Foam::constant::mathematical::twoPi().

Referenced by writePropellerPerformance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createFiles()

void createFiles ( )

protected

Create output files.

Definition at line 169 of file propellerInfo.C.

References axialWakeFilePtr_, forces::coordSysPtr_, writeFile::newFileAtStartTime(), Foam::nl, os(), propellerPerformanceFilePtr_, radius_, wakeFilePtr_, writeFile::writeCommented(), Foam::writeHeader(), writeFile::writeHeaderValue(), writePropellerPerformance_, writeFile::writeTabbed(), writeFile::writeToFile(), and writeWakeFields_.

Referenced by execute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ U()

const Foam::volVectorField & U ( ) const

protected

Return the velocity field.

Definition at line 208 of file propellerInfo.C.

References Foam::exit(), Foam::FatalError, FatalErrorInFunction, Foam::flatOutput(), fvMeshFunctionObject::mesh_, GeometricField< vector, fvPatchField, volMesh >::null(), and forces::UName_.

Referenced by writeAxialWake(), writeSampleDiskSurface(), and writeWake().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writePropellerPerformance()

void writePropellerPerformance ( )

protected

Write the wake fields.

Definition at line 556 of file propellerInfo.C.

References forces::coordSysPtr_, forces::forceEff(), Log, Foam::mag(), forces::momentEff(), n_, name, Foam::nl, os(), Foam::pow4(), propellerPerformanceFilePtr_, radius_, forces::rhoRef_, stateFunctionObject::setResult(), setRotationalSpeed(), Foam::sign(), Foam::sqr(), Foam::tab, timeFunctionObject::time_, Foam::constant::mathematical::twoPi(), Foam::type(), URefPtr_, writeFile::writeCurrentTime(), writePropellerPerformance_, and writeFile::writeToFile().

Referenced by execute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeWake()

void writeWake	(	const vectorField &	U,
		const scalar	URef )

protected

Write the wake text file.

Definition at line 614 of file propellerInfo.C.

References forces::coordSysPtr_, Foam::endl(), UList< T >::last(), Foam::mag(), UPstream::master(), meanSampleDiskField(), Foam::nl, nRadial_, nTheta_, os(), pointMask_, points_, Foam::tab, timeFunctionObject::time_, U(), wakeFilePtr_, writeFile::writeBreak(), writeFile::writeCommented(), Foam::writeHeader(), writeFile::writeHeaderValue(), and writeFile::writeTabbed().

Referenced by writeWakeFields().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeAxialWake()

void writeAxialWake	(	const vectorField &	U,
		const scalar	URef )

protected

Write the axial wake text file.

Definition at line 673 of file propellerInfo.C.

References axialWakeFilePtr_, forces::coordSysPtr_, Foam::endl(), UList< T >::last(), Foam::mag(), UPstream::master(), Foam::nl, nRadial_, nTheta_, os(), pointMask_, points_, Foam::tab, timeFunctionObject::time_, U(), writeFile::writeBreak(), and writeFile::writeHeaderValue().

Referenced by writeWakeFields().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeWakeFields()

void writeWakeFields ( const scalar URef )

protected

Write the wake fields.

Definition at line 733 of file propellerInfo.C.

References forces::coordSysPtr_, Foam::endl(), Foam::interpolate(), Foam::mag(), nanValue_, U, VectorSpace< Form, Cmpt, Ncmpts >::uniform(), WarningInFunction, writeAxialWake(), writeSampleDiskSurface(), writeWake(), and writeWakeFields_.

Referenced by write().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSampleDiskGeometry()

void setSampleDiskGeometry	(	const coordinateSystem &	coordSys,
		const scalar	r1,
		const scalar	r2,
		const scalar	nTheta,
		const label	nRadius,
		faceList &	faces,
		pointField &	points ) const

protected

Set the faces and points for the sample surface.

Definition at line 227 of file propellerInfo.C.

References DynamicList< T, SizeMin >::append(), DynamicList< T, SizeMin >::clear(), UList< T >::fcIndex(), coordinateSystem::globalPosition(), Foam::identity(), coordinateSystem::origin(), p, points, List< T >::resize_nocopy(), and Foam::constant::mathematical::twoPi().

Referenced by setSampleDiskSurface().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSampleDiskSurface()

void setSampleDiskSurface ( const dictionary & dict )

protected

Set the sample surface based on dictionary settings.

Definition at line 330 of file propellerInfo.C.

References forces::coordSysPtr_, dict, errorOnPointNotFound_, faces_, surfaceWriter::formatOptions(), dictionary::getLabel(), dictionary::getOrDefault(), dictionary::getScalar(), surfaceWriter::New(), nRadial_, nTheta_, points_, dictionary::readIfPresent(), setSampleDiskGeometry(), surfaceWriterPtr_, and updateSampleDiskCells().

Referenced by execute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateSampleDiskCells()

void updateSampleDiskCells ( )

protected

Set the sample cells corresponding to the sample points.

Definition at line 381 of file propellerInfo.C.

References Foam::abort(), DynamicList< T, SizeMin >::append(), polyMesh::CELL_TETS, cellIds_, treeBoundBox::contains(), DebugInfo, Foam::endl(), errorOnPointNotFound_, Foam::FatalError, FatalErrorInFunction, forAll, found, boundBox::inflate(), Pstream::listCombineReduce(), fvMeshFunctionObject::mesh_, UPstream::myProcNo(), pointMask_, points_, Foam::pos(), Foam::reduce(), tree(), and writeWakeFields_.

Referenced by movePoints(), setSampleDiskSurface(), and UpdateMesh().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ meanSampleDiskField()

Foam::scalar meanSampleDiskField ( const scalarField & field ) const

protected

Return the area average of a field.

Definition at line 479 of file propellerInfo.C.

References Foam::abort(), f(), faces_, Foam::FatalError, FatalErrorInFunction, field(), pointMask_, and points_.

Referenced by execute(), and writeWake().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeSampleDiskSurface()

void writeSampleDiskSurface	(	const vectorField &	U,
		const vectorField &	Ur,
		const scalar	URef )

protected

Write the sample surface.

Definition at line 522 of file propellerInfo.C.

References writeFile::baseFileDir(), faces_, name, points_, surfaceWriterPtr_, timeFunctionObject::time_, and U().

Referenced by writeWakeFields().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ interpolate() [1/2]

template<class Type>

tmp< Field< Type > > interpolate	(	const GeometricField< Type, fvPatchField, volMesh > &	psi,
		const Type &	defaultValue ) const

protected

Interpolate from the mesh onto the sample surface.

References psi.

Referenced by execute().

Here is the caller graph for this function:

◆ operator=()

void operator= ( const propellerInfo & )

protecteddelete

No copy assignment.

References propellerInfo().

Here is the call graph for this function:

◆ TypeName()

TypeName ( "propellerInfo" )

Runtime type information.

References dict, Foam::name(), regionFunctionObject::obr(), and runTime.

Here is the call graph for this function:

◆ read()

bool read ( const dictionary & dict )

virtual

Read the function-object dictionary.

Reimplemented from forces.

Definition at line 851 of file propellerInfo.C.

References dict, dict_, interpolationScheme_, fvMeshFunctionObject::mesh_, nanValue_, radius_, forces::read(), rotationMode_, rotationModeNames_, URefPtr_, writePropellerPerformance_, and writeWakeFields_.

Referenced by propellerInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ execute()

bool execute ( )

virtual

Execute the function-object operations.

Reimplemented from forces.

Definition at line 879 of file propellerInfo.C.

References forces::calcForcesMoments(), Field< Type >::component(), forces::coordSysPtr_, createFiles(), dict_, initialised_, interpolate(), meanSampleDiskField(), nanValue_, setCoordinateSystem(), stateFunctionObject::setResult(), setSampleDiskSurface(), U, VectorSpace< Form, Cmpt, Ncmpts >::uniform(), writePropellerPerformance(), and writeWakeFields_.

Here is the call graph for this function:

◆ write()

bool write ( )

virtual

Write the function-object results.

Reimplemented from forces.

Definition at line 926 of file propellerInfo.C.

References timeFunctionObject::time_, URefPtr_, and writeWakeFields().

Here is the call graph for this function:

◆ UpdateMesh()

void UpdateMesh ( const mapPolyMesh & mpm )

Definition at line 935 of file propellerInfo.C.

References updateSampleDiskCells().

Here is the call graph for this function:

◆ movePoints()

void movePoints ( const polyMesh & mesh )

virtual

Update for changes of mesh.

The base implementation is a no-op.

Reimplemented from functionObject.

Definition at line 941 of file propellerInfo.C.

References mesh, and updateSampleDiskCells().

Here is the call graph for this function:

◆ interpolate() [2/2]

template<class Type>

Foam::tmp< Foam::Field< Type > > interpolate	(	const GeometricField< Type, fvPatchField, volMesh > &	psi,
		const Type &	defaultValue ) const

Definition at line 764 of file propellerInfo.C.

References cellIds_, field(), forAll, interpolationScheme_, Pstream::listReduce(), interpolation< Type >::New(), Foam::New(), points_, and psi.

Here is the call graph for this function:

Member Data Documentation

◆ rotationModeNames_

const Foam::Enum< Foam::functionObjects::propellerInfo::rotationMode > rotationModeNames_

static

Definition at line 317 of file propellerInfo.H.

Referenced by read(), setCoordinateSystem(), and setRotationalSpeed().

◆ dict_

dictionary dict_

protected

Copy of dictionary used during construction.

Definition at line 327 of file propellerInfo.H.

Referenced by execute(), propellerInfo(), and read().

◆ radius_

scalar radius_

protected

Propeller radius.

Definition at line 332 of file propellerInfo.H.

Referenced by createFiles(), propellerInfo(), read(), and writePropellerPerformance().

◆ URefPtr_

autoPtr<Function1<scalar> > URefPtr_

protected

Reference velocity.

Definition at line 337 of file propellerInfo.H.

Referenced by propellerInfo(), read(), write(), and writePropellerPerformance().

◆ rotationMode_

rotationMode rotationMode_

protected

Rotation mode.

Definition at line 342 of file propellerInfo.H.

Referenced by propellerInfo(), read(), setCoordinateSystem(), and setRotationalSpeed().

◆ MRFName_

word MRFName_

protected

Name of MRF zone (if applicable).

Definition at line 347 of file propellerInfo.H.

Referenced by propellerInfo(), setCoordinateSystem(), and setRotationalSpeed().

◆ n_

scalar n_

protected

Propeller speed (revolutions per second).

Definition at line 352 of file propellerInfo.H.

Referenced by propellerInfo(), setCoordinateSystem(), setRotationalSpeed(), and writePropellerPerformance().

◆ writePropellerPerformance_

bool writePropellerPerformance_

protected

Flag to write performance data.

Definition at line 357 of file propellerInfo.H.

Referenced by createFiles(), propellerInfo(), read(), and writePropellerPerformance().

◆ propellerPerformanceFilePtr_

autoPtr<OFstream> propellerPerformanceFilePtr_

protected

Propeller performance file.

Definition at line 362 of file propellerInfo.H.

Referenced by createFiles(), propellerInfo(), and writePropellerPerformance().

◆ writeWakeFields_

bool writeWakeFields_

protected

Flag to write wake fields.

Definition at line 367 of file propellerInfo.H.

Referenced by createFiles(), execute(), propellerInfo(), read(), updateSampleDiskCells(), and writeWakeFields().

◆ surfaceWriterPtr_

autoPtr<surfaceWriter> surfaceWriterPtr_

protected

Surface writer.

Definition at line 375 of file propellerInfo.H.

Referenced by propellerInfo(), setSampleDiskSurface(), and writeSampleDiskSurface().

◆ nTheta_

label nTheta_

protected

Number of surface divisions in theta direction.

Definition at line 380 of file propellerInfo.H.

Referenced by propellerInfo(), setSampleDiskSurface(), writeAxialWake(), and writeWake().

◆ nRadial_

label nRadial_

protected

Number of surface divisions in radial direction.

Definition at line 385 of file propellerInfo.H.

Referenced by propellerInfo(), setSampleDiskSurface(), writeAxialWake(), and writeWake().

◆ points_

pointField points_

protected

Surface points.

Definition at line 390 of file propellerInfo.H.

Referenced by interpolate(), meanSampleDiskField(), propellerInfo(), setSampleDiskSurface(), updateSampleDiskCells(), writeAxialWake(), writeSampleDiskSurface(), and writeWake().

◆ errorOnPointNotFound_

bool errorOnPointNotFound_

protected

Flag to raise an error if the sample point is not found in the mesh. Default = false to enable. e.g. reduced geometry/symmetric cases.

Definition at line 397 of file propellerInfo.H.

Referenced by propellerInfo(), setSampleDiskSurface(), and updateSampleDiskCells().

◆ faces_

faceList faces_

protected

Surface faces.

Definition at line 402 of file propellerInfo.H.

Referenced by meanSampleDiskField(), propellerInfo(), setSampleDiskSurface(), and writeSampleDiskSurface().

◆ cellIds_

labelList cellIds_

protected

Surface point sample cell IDs.

Definition at line 407 of file propellerInfo.H.

Referenced by interpolate(), propellerInfo(), and updateSampleDiskCells().

◆ pointMask_

boolList pointMask_

protected

List of participating points (parallel reduced).

Definition at line 412 of file propellerInfo.H.

Referenced by meanSampleDiskField(), propellerInfo(), updateSampleDiskCells(), writeAxialWake(), and writeWake().

◆ interpolationScheme_

word interpolationScheme_

protected

Interpolation scheme.

Definition at line 417 of file propellerInfo.H.

Referenced by interpolate(), propellerInfo(), and read().

◆ wakeFilePtr_

autoPtr<OFstream> wakeFilePtr_

protected

Wake field file.

Definition at line 422 of file propellerInfo.H.

Referenced by createFiles(), propellerInfo(), and writeWake().

◆ axialWakeFilePtr_

autoPtr<OFstream> axialWakeFilePtr_

protected

Axial wake field file.

Definition at line 427 of file propellerInfo.H.

Referenced by createFiles(), propellerInfo(), and writeAxialWake().

◆ nanValue_

scalar nanValue_

protected

Default value when a sample point is not found; default = scalar::min.

Definition at line 433 of file propellerInfo.H.

Referenced by execute(), propellerInfo(), read(), and writeWakeFields().

◆ initialised_

bool initialised_

protected

Initialised flag.

Definition at line 438 of file propellerInfo.H.

Referenced by execute(), and propellerInfo().

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

src/functionObjects/forces/propellerInfo/propellerInfo.H
src/functionObjects/forces/propellerInfo/propellerInfo.C

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ rotationMode

Constructor & Destructor Documentation

◆ propellerInfo() [1/3]

◆ propellerInfo() [2/3]

◆ propellerInfo() [3/3]

◆ ~propellerInfo()

Member Function Documentation

◆ setCoordinateSystem()

◆ setRotationalSpeed()

◆ createFiles()

◆ U()

◆ writePropellerPerformance()

◆ writeWake()

◆ writeAxialWake()

◆ writeWakeFields()

◆ setSampleDiskGeometry()

◆ setSampleDiskSurface()

◆ updateSampleDiskCells()

◆ meanSampleDiskField()

◆ writeSampleDiskSurface()

◆ interpolate() [1/2]

◆ operator=()

◆ TypeName()

◆ read()

◆ execute()

◆ write()

◆ UpdateMesh()

◆ movePoints()

◆ interpolate() [2/2]

Member Data Documentation

◆ rotationModeNames_

◆ dict_

◆ radius_

◆ URefPtr_

◆ rotationMode_

◆ MRFName_

◆ n_

◆ writePropellerPerformance_

◆ propellerPerformanceFilePtr_

◆ writeWakeFields_

◆ surfaceWriterPtr_

◆ nTheta_

◆ nRadial_

◆ points_

◆ errorOnPointNotFound_

◆ faces_

◆ cellIds_

◆ pointMask_

◆ interpolationScheme_

◆ wakeFilePtr_

◆ axialWakeFilePtr_

◆ nanValue_

◆ initialised_