ShapeSensitivitiesBase Class Reference

Base class supporting Shape sensitivity derivatives. More...

Inheritance diagram for ShapeSensitivitiesBase:
Collaboration diagram for ShapeSensitivitiesBase:

Public Member Functions

 TypeName ("ShapeSensitivitiesBase")
 Runtime type information. More...
 
 ShapeSensitivitiesBase (const fvMesh &mesh, const dictionary &dict, adjointSolver &adjointSolver)
 Construct from components. More...
 
virtual ~ShapeSensitivitiesBase ()=default
 Destructor. More...
 
virtual bool readDict (const dictionary &dict)
 Read dict if changed. More...
 
const labelHashSetsensitivityPatchIDs () const
 Get patch IDs on which sensitivities are computed. More...
 
void setSensitivityPatchIDs (const labelHashSet &sensPatchIDs)
 Overwrite sensitivityPatchIDs. More...
 
virtual const labelHashSetgeometryVariationIntegrationPatches () const
 Return set of patches on which to compute direct sensitivities. More...
 
virtual void accumulateIntegrand (const scalar dt)
 Accumulate sensitivity integrands. More...
 
void clearSensitivities ()
 Zero sensitivity fields and their constituents. More...
 
virtual void write (const word &baseName=word::null)
 Write sensitivity fields. More...
 
tmp< volVectorFieldgetWallFaceSensVec ()
 Get wall face sensitivity vectors field. More...
 
tmp< volScalarFieldgetWallFaceSensNormal ()
 Get wall face sensitivity projected to normal field. More...
 
tmp< volVectorFieldgetWallFaceSensNormalVec ()
 Get wall face normal sens as vectors field. More...
 
tmp< pointVectorFieldgetWallPointSensVec ()
 Get wall point sensitivity vectors field. More...
 
tmp< pointScalarFieldgetWallPointSensNormal ()
 Get wall point sensitivity projected to normal field. More...
 
tmp< pointVectorFieldgetWallPointSensNormalVec ()
 Get wall point sens as vectors field. More...
 
virtual const boundaryVectorFieldgetWallFaceSensVecBoundary () const
 Get wall face sensitivity vectors field. More...
 
virtual const boundaryScalarFieldgetWallFaceSensNormalBoundary () const
 Get wall face sensitivity projected to normal field. More...
 
virtual const boundaryVectorFieldgetWallFaceSensNormalVecBoundary () const
 Get wall face normal sens as vectors field. More...
 
- Public Member Functions inherited from adjointSensitivity
 TypeName ("adjointSensitivity")
 Runtime type information. More...
 
 declareRunTimeSelectionTable (autoPtr, adjointSensitivity, dictionary,(const fvMesh &mesh, const dictionary &dict, adjointSolver &adjointSolver),(mesh, dict, adjointSolver))
 
 adjointSensitivity (const fvMesh &mesh, const dictionary &dict, adjointSolver &adjointSolver)
 Construct from components. More...
 
virtual ~adjointSensitivity ()=default
 Destructor. More...
 
const adjointSolvergetAdjointSolver () const
 Const access to adjoint solver. More...
 
adjointSolvergetAdjointSolver ()
 Non-const access to adjoint solver. More...
 
bool includeDistance () const
 Should the adjoint eikonal PDE should be solved. More...
 
autoPtr< adjointEikonalSolver > & getAdjointEikonalSolver ()
 Return the adjoint eikonal solver. More...
 
autoPtr< adjointMeshMovementSolver > & getAdjointMeshMovementSolver ()
 Return the adjoint eikonal solver. More...
 
void setSuffix (const word &suffix)
 Set suffix. More...
 
const wordgetSuffix () const
 Get suffix. More...
 
virtual bool computeDxDbInternalField () const
 Should the parameterization compute the internalField of dxdb. More...
 
virtual void assembleSensitivities (autoPtr< designVariables > &designVars)
 Assemble sensitivities. More...
 
virtual const scalarFieldcalculateSensitivities (autoPtr< designVariables > &designVars)
 Calculates and returns sensitivity fields. More...
 
const scalarFieldgetSensitivities () const
 Returns the sensitivity fields. More...
 
const autoPtr< volTensorField > & gradDxDbMult () const
 
autoPtr< volTensorField > & gradDxDbMult ()
 
const autoPtr< scalarField > & divDxDbMult () const
 
const autoPtr< boundaryVectorField > & dxdbMult () const
 
const autoPtr< boundaryVectorField > & dSfdbMult () const
 
const autoPtr< boundaryVectorField > & dnfdbMult () const
 
const autoPtr< boundaryVectorField > & dxdbDirectMult () const
 
const autoPtr< pointBoundaryVectorField > & pointDxDbDirectMult () const
 
const autoPtr< boundaryVectorField > & bcDxDbMult () const
 
const autoPtr< vectorField > & optionsDxDbMult () const
 
- Public Member Functions inherited from sensitivity
 TypeName ("sensitivity")
 Runtime type information. More...
 
 sensitivity (const fvMesh &mesh, const dictionary &dict)
 Construct from components. More...
 
virtual ~sensitivity ()=default
 Destructor. More...
 
const fvMeshmesh () const
 Return reference to mesh. More...
 
const dictionarydict () const
 Return the construction dictionary. More...
 
const autoPtr< volScalarField > & fieldSensPtr () const
 Get the fieldSensPtr. More...
 

Protected Member Functions

void allocateEikonalSolver ()
 Allocate the adjoint eikonal solver. More...
 
bool hasMultiplier (bool(objective::*hasFunction)() const)
 Check if any of the available objective has a certain multiplier, provided through a function object. More...
 
template<class Type >
void constructAndWriteSensitivityField (const autoPtr< typename GeometricField< Type, fvPatchField, volMesh >::Boundary > &sensFieldPtr, const word &name) const
 Constructs volField based on boundaryField and writes it. More...
 
template<class Type >
void constructAndWriteSensitivtyPointField (const autoPtr< List< Field< Type >>> &sensFieldPtr, const word &name) const
 Constructs pointField based on boundaryField and writes it. More...
 
template<class Type >
tmp< GeometricField< Type, fvPatchField, volMesh > > constructVolSensitivtyField (const autoPtr< typename GeometricField< Type, fvPatchField, volMesh >::Boundary > &sensFieldPtr, const word &name) const
 Constructs volField based on boundaryField and writes it. More...
 
void writeFaceBasedSens () const
 Write face-based sensitivities, if present. More...
 
void writePointBasedSens () const
 Write point-based sensitivities, if present. More...
 
void clearSurfaceFields ()
 Clear surface/point fields. More...
 
void allocateMultipliers ()
 Allocate multiplier fields. More...
 
void clearMultipliers ()
 Clear multipliers. More...
 

Protected Attributes

labelHashSet sensitivityPatchIDs_
 Patches on which to compute shape sensitivities. More...
 
bool writeAllSurfaceFiles_
 Whether to write all surface sensitivity fields. More...
 
autoPtr< boundaryVectorFieldwallFaceSensVecPtr_
 Wall face sens w.r.t. (x,y.z) More...
 
autoPtr< boundaryScalarFieldwallFaceSensNormalPtr_
 Wall face sens projected to normal. More...
 
autoPtr< boundaryVectorFieldwallFaceSensNormalVecPtr_
 Normal sens as vectors. More...
 
autoPtr< pointBoundaryVectorFieldwallPointSensVecPtr_
 Wall point sens w.r.t. (x,y.z) More...
 
autoPtr< pointBoundaryScalarFieldwallPointSensNormalPtr_
 Wall point sens projected to normal. More...
 
autoPtr< pointBoundaryVectorFieldwallPointSensNormalVecPtr_
 Normal sens as vectors. More...
 
- Protected Attributes inherited from adjointSensitivity
adjointSolveradjointSolver_
 Reference to the underlaying adjoint solver. More...
 
scalarField derivatives_
 The sensitivity derivative values. More...
 
word suffix_
 Append this word to files related to the sensitivities. More...
 
bool includeDistance_
 Include distance variation in sensitivity computations. More...
 
autoPtr< adjointEikonalSolvereikonalSolver_
 Adjoint eikonal equation solver. More...
 
autoPtr< adjointMeshMovementSolveradjointMeshMovementSolver_
 Adjoint grid displacement solver. More...
 
autoPtr< volTensorFieldgradDxDbMult_
 Multiplier of grad(dx/b) More...
 
autoPtr< scalarFielddivDxDbMult_
 Multiplier of div(dx/db) More...
 
autoPtr< boundaryVectorFielddxdbMult_
 Multiplier of face dx/db. More...
 
autoPtr< boundaryVectorFielddSfdbMult_
 Multiplier of dSf/db. More...
 
autoPtr< boundaryVectorFielddnfdbMult_
 Multiplier of dnf/db. More...
 
autoPtr< boundaryVectorFielddxdbDirectMult_
 Multiplier of dCf/db, found in the objective function. More...
 
autoPtr< pointBoundaryVectorFieldpointDxDbDirectMult_
 Multiplier of dx/db computed at points, found in the objective function. More...
 
autoPtr< boundaryVectorFieldbcDxDbMult_
 Multiplier of dx/db, coming from boundary conditions that depend on the geometry, like rotatingWallVelocity. More...
 
autoPtr< vectorFieldoptionsDxDbMult_
 dx/db multiplier coming from fvOptions More...
 
- Protected Attributes inherited from sensitivity
const fvMeshmesh_
 
dictionary dict_
 
bool writeFieldSens_
 
autoPtr< volScalarFieldfieldSensPtr_
 

Additional Inherited Members

- Static Public Member Functions inherited from adjointSensitivity
static autoPtr< adjointSensitivityNew (const fvMesh &mesh, const dictionary &dict, adjointSolver &adjointSolver)
 Return a reference to the selected turbulence model. More...
 

Detailed Description

Base class supporting Shape sensitivity derivatives.

Reference:

    For the FI formulation see
        Kavvadias, I., Papoutsis-Kiachagias, E., & Giannakoglou, K. (2015).
        On the proper treatment of grid sensitivities in continuous adjoint
        methods for shape optimization.
        Journal of Computational Physics, 301, 1–18.
        http://doi.org/10.1016/j.jcp.2015.08.012

    The ESI formulation is derived in a slightly different way than the
    one described in this paper, to provide a common mathematical
    formulation for both low- and high-Re meshes and to produce numerically
    identical results as the FI formulation. In brief, the boundary-bound
    part of the sensitivities is the patchInternalField of the tensor
    multiplying grad(dxdb) in the FI formulation.
Source files

Definition at line 75 of file ShapeSensitivitiesBase.H.

Constructor & Destructor Documentation

◆ ShapeSensitivitiesBase()

ShapeSensitivitiesBase ( const fvMesh mesh,
const dictionary dict,
adjointSolver adjointSolver 
)

Construct from components.

Definition at line 273 of file ShapeSensitivitiesBase.C.

◆ ~ShapeSensitivitiesBase()

virtual ~ShapeSensitivitiesBase ( )
virtualdefault

Destructor.

Member Function Documentation

◆ allocateEikonalSolver()

void allocateEikonalSolver ( )
protected

◆ hasMultiplier()

bool hasMultiplier ( bool(objective::*)() const  hasFunction)
protected

Check if any of the available objective has a certain multiplier, provided through a function object.

Definition at line 59 of file ShapeSensitivitiesBase.C.

◆ constructAndWriteSensitivityField()

void constructAndWriteSensitivityField ( const autoPtr< typename GeometricField< Type, fvPatchField, volMesh >::Boundary > &  sensFieldPtr,
const word name 
) const
protected

Constructs volField based on boundaryField and writes it.

Definition at line 34 of file ShapeSensitivitiesBaseTemplates.C.

References GeometricField< Type, PatchField, GeoMesh >::boundaryFieldRef(), Foam::dimless, Foam::name(), IOobjectOption::NO_READ, IOobjectOption::NO_WRITE, and Foam::Zero.

Here is the call graph for this function:

◆ constructAndWriteSensitivtyPointField()

void constructAndWriteSensitivtyPointField ( const autoPtr< List< Field< Type >>> &  sensFieldPtr,
const word name 
) const
protected

◆ constructVolSensitivtyField()

tmp< GeometricField< Type, fvPatchField, volMesh > > constructVolSensitivtyField ( const autoPtr< typename GeometricField< Type, fvPatchField, volMesh >::Boundary > &  sensFieldPtr,
const word name 
) const
protected

Constructs volField based on boundaryField and writes it.

Definition at line 106 of file ShapeSensitivitiesBaseTemplates.C.

References forAll, Foam::name(), IOobjectOption::NO_READ, IOobjectOption::NO_WRITE, and GeometricField< Type, PatchField, GeoMesh >::ref().

Here is the call graph for this function:

◆ writeFaceBasedSens()

void writeFaceBasedSens ( ) const
protected

Write face-based sensitivities, if present.

Definition at line 74 of file ShapeSensitivitiesBase.C.

◆ writePointBasedSens()

void writePointBasedSens ( ) const
protected

Write point-based sensitivities, if present.

Definition at line 111 of file ShapeSensitivitiesBase.C.

◆ clearSurfaceFields()

void clearSurfaceFields ( )
protected

Clear surface/point fields.

Definition at line 151 of file ShapeSensitivitiesBase.C.

◆ allocateMultipliers()

void allocateMultipliers ( )
protected

◆ clearMultipliers()

void clearMultipliers ( )
protected

Clear multipliers.

Definition at line 231 of file ShapeSensitivitiesBase.C.

References field(), and Foam::Zero.

Here is the call graph for this function:

◆ TypeName()

TypeName ( "ShapeSensitivitiesBase"  )

Runtime type information.

◆ readDict()

bool readDict ( const dictionary dict)
virtual

Read dict if changed.

Reimplemented from adjointSensitivity.

Reimplemented in sensitivitySurfacePoints, and sensitivityShapeESI.

Definition at line 307 of file ShapeSensitivitiesBase.C.

References dict, adjointSensitivity::readDict(), and keyType::REGEX_RECURSIVE.

Referenced by sensitivityShapeESI::readDict().

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

◆ sensitivityPatchIDs()

const labelHashSet& sensitivityPatchIDs ( ) const
inline

Get patch IDs on which sensitivities are computed.

Definition at line 262 of file ShapeSensitivitiesBase.H.

References ShapeSensitivitiesBase::sensitivityPatchIDs_.

◆ setSensitivityPatchIDs()

void setSensitivityPatchIDs ( const labelHashSet sensPatchIDs)
inline

Overwrite sensitivityPatchIDs.

Definition at line 270 of file ShapeSensitivitiesBase.H.

References ShapeSensitivitiesBase::sensitivityPatchIDs_.

◆ geometryVariationIntegrationPatches()

const Foam::labelHashSet & geometryVariationIntegrationPatches ( ) const
virtual

Return set of patches on which to compute direct sensitivities.

Reimplemented in sensitivitySurfacePoints.

Definition at line 340 of file ShapeSensitivitiesBase.C.

Referenced by ShapeSensitivitiesBase::allocateEikonalSolver(), sensitivityShapeESI::computeDxDbMult(), and adjointMeshMovementSolver::meshMovementSensitivities().

Here is the caller graph for this function:

◆ accumulateIntegrand()

void accumulateIntegrand ( const scalar  dt)
virtual

Accumulate sensitivity integrands.

Common function for the FI and E-SI approaches

Implements adjointSensitivity.

Definition at line 346 of file ShapeSensitivitiesBase.C.

◆ clearSensitivities()

void clearSensitivities ( )
virtual

Zero sensitivity fields and their constituents.

Reimplemented from adjointSensitivity.

Definition at line 380 of file ShapeSensitivitiesBase.C.

References adjointSensitivity::clearSensitivities().

Here is the call graph for this function:

◆ write()

void write ( const word baseName = word::null)
virtual

Write sensitivity fields.

If valid, copies boundaryFields to volFields and writes them.

Reimplemented from adjointSensitivity.

Reimplemented in sensitivitySurfacePoints.

Definition at line 388 of file ShapeSensitivitiesBase.C.

References adjointSensitivity::write().

Referenced by sensitivitySurfacePoints::write().

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

◆ getWallFaceSensVec()

Foam::tmp< Foam::volVectorField > getWallFaceSensVec ( )

Get wall face sensitivity vectors field.

Definition at line 397 of file ShapeSensitivitiesBase.C.

References Foam::dimless, Foam::endl(), and WarningInFunction.

Here is the call graph for this function:

◆ getWallFaceSensNormal()

Foam::tmp< Foam::volScalarField > getWallFaceSensNormal ( )

Get wall face sensitivity projected to normal field.

Definition at line 428 of file ShapeSensitivitiesBase.C.

References Foam::dimless, Foam::endl(), and WarningInFunction.

Here is the call graph for this function:

◆ getWallFaceSensNormalVec()

Foam::tmp< Foam::volVectorField > getWallFaceSensNormalVec ( )

Get wall face normal sens as vectors field.

Definition at line 458 of file ShapeSensitivitiesBase.C.

References Foam::dimless, Foam::endl(), and WarningInFunction.

Here is the call graph for this function:

◆ getWallPointSensVec()

Foam::tmp< Foam::pointVectorField > getWallPointSensVec ( )

Get wall point sensitivity vectors field.

Uses volPointInterpolation

Definition at line 490 of file ShapeSensitivitiesBase.C.

References volPointInterpolation::interpolate().

Here is the call graph for this function:

◆ getWallPointSensNormal()

Foam::tmp< Foam::pointScalarField > getWallPointSensNormal ( )

Get wall point sensitivity projected to normal field.

Uses volPointInterpolation

Definition at line 500 of file ShapeSensitivitiesBase.C.

References volPointInterpolation::interpolate().

Here is the call graph for this function:

◆ getWallPointSensNormalVec()

Foam::tmp< Foam::pointVectorField > getWallPointSensNormalVec ( )

Get wall point sens as vectors field.

Uses volPointInterpolation

Definition at line 510 of file ShapeSensitivitiesBase.C.

References volPointInterpolation::interpolate().

Here is the call graph for this function:

◆ getWallFaceSensVecBoundary()

const Foam::boundaryVectorField & getWallFaceSensVecBoundary ( ) const
virtual

Get wall face sensitivity vectors field.

Definition at line 520 of file ShapeSensitivitiesBase.C.

◆ getWallFaceSensNormalBoundary()

const Foam::boundaryScalarField & getWallFaceSensNormalBoundary ( ) const
virtual

Get wall face sensitivity projected to normal field.

Definition at line 527 of file ShapeSensitivitiesBase.C.

◆ getWallFaceSensNormalVecBoundary()

const Foam::boundaryVectorField & getWallFaceSensNormalVecBoundary ( ) const
virtual

Get wall face normal sens as vectors field.

Definition at line 534 of file ShapeSensitivitiesBase.C.

Member Data Documentation

◆ sensitivityPatchIDs_

◆ writeAllSurfaceFiles_

bool writeAllSurfaceFiles_
protected

Whether to write all surface sensitivity fields.

Definition at line 92 of file ShapeSensitivitiesBase.H.

◆ wallFaceSensVecPtr_

autoPtr<boundaryVectorField> wallFaceSensVecPtr_
protected

Wall face sens w.r.t. (x,y.z)

Definition at line 103 of file ShapeSensitivitiesBase.H.

Referenced by sensitivitySurface::smoothSensitivities().

◆ wallFaceSensNormalPtr_

autoPtr<boundaryScalarField> wallFaceSensNormalPtr_
protected

Wall face sens projected to normal.

Definition at line 108 of file ShapeSensitivitiesBase.H.

◆ wallFaceSensNormalVecPtr_

autoPtr<boundaryVectorField> wallFaceSensNormalVecPtr_
protected

Normal sens as vectors.

Definition at line 113 of file ShapeSensitivitiesBase.H.

◆ wallPointSensVecPtr_

autoPtr<pointBoundaryVectorField> wallPointSensVecPtr_
protected

Wall point sens w.r.t. (x,y.z)

Definition at line 121 of file ShapeSensitivitiesBase.H.

Referenced by sensitivitySurfacePoints::finalisePointSensitivities().

◆ wallPointSensNormalPtr_

autoPtr<pointBoundaryScalarField> wallPointSensNormalPtr_
protected

Wall point sens projected to normal.

Definition at line 126 of file ShapeSensitivitiesBase.H.

◆ wallPointSensNormalVecPtr_

autoPtr<pointBoundaryVectorField> wallPointSensNormalVecPtr_
protected

Normal sens as vectors.

Definition at line 131 of file ShapeSensitivitiesBase.H.


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