IBAMR  IBAMR version 0.19.
Public Member Functions | Static Public Member Functions | List of all members
IBAMR::INSCollocatedWavePropConvectiveOperator Class Reference

Class INSCollocatedWavePropConvectiveOperator is a concrete ConvectiveOperator that implements a convective operator based on the wave propagation method. More...

#include <ibamr/INSCollocatedWavePropConvectiveOperator.h>

Inheritance diagram for IBAMR::INSCollocatedWavePropConvectiveOperator:
Inheritance graph
[legend]

Public Member Functions

 INSCollocatedWavePropConvectiveOperator (std::string object_name, SAMRAI::tbox::Pointer< SAMRAI::tbox::Database > input_db, ConvectiveDifferencingType difference_form, std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > bc_coefs)
 Class constructor. More...
 
 ~INSCollocatedWavePropConvectiveOperator ()
 Destructor. More...
 
void applyConvectiveOperator (int U_idx, int N_idx) override
 Compute the action of the convective operator. More...
 
void setAdvectionVelocity (int u_idx)
 Set the patch data index corresponding to the advection velocity to be used when computing the convective derivative. More...
 
int getAdvectionVelocity () const
 Get the patch data index corresponding to the advection velocity used when computing the convective derivative. More...
 
void setConvectiveDifferencingType (ConvectiveDifferencingType difference_form)
 Set the convective differencing form to be used by the operator. More...
 
ConvectiveDifferencingType getConvectiveDifferencingType () const
 Get the convective differencing form used by the operator. More...
 

Static Public Member Functions

static SAMRAI::tbox::Pointer< ConvectiveOperatorallocate_operator (const std::string &object_name, SAMRAI::tbox::Pointer< SAMRAI::tbox::Database > input_db, ConvectiveDifferencingType difference_form, const std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > &bc_coefs)
 Static function to construct an INSCollocatedWavePropConvectiveOperator. More...
 

General operator functionality.

void apply (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &x, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &y) override
 Compute \(y=F[x]\). More...
 
ConvectiveDifferencingType d_difference_form
 
int d_u_idx = IBTK::invalid_index
 

General operator functionality.

std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > d_bc_coefs
 
std::string d_bdry_extrap_type = "CONSTANT"
 
std::vector< IBTK::HierarchyGhostCellInterpolation::InterpolationTransactionComponentd_transaction_comps
 
SAMRAI::tbox::Pointer< IBTK::HierarchyGhostCellInterpolationd_hier_bdry_fill
 
SAMRAI::tbox::Pointer< SAMRAI::hier::PatchHierarchy< NDIM > > d_hierarchy
 
int d_coarsest_ln = IBTK::invalid_level_number
 
int d_finest_ln = IBTK::invalid_level_number
 
SAMRAI::tbox::Pointer< SAMRAI::pdat::CellVariable< NDIM, double > > d_U_var
 
int d_U_scratch_idx = IBTK::invalid_index
 
int d_k = 3
 
void initializeOperatorState (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &in, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &out) override
 Compute hierarchy dependent data required for computing y=F[x] and z=F[x]+y. More...
 
void deallocateOperatorState () override
 Remove all hierarchy dependent data allocated by initializeOperatorState(). More...
 
 INSCollocatedWavePropConvectiveOperator ()=delete
 Default constructor. More...
 
 INSCollocatedWavePropConvectiveOperator (const INSCollocatedWavePropConvectiveOperator &from)=delete
 Copy constructor. More...
 
INSCollocatedWavePropConvectiveOperatoroperator= (const INSCollocatedWavePropConvectiveOperator &that)=delete
 Assignment operator. More...
 

General operator functionality.

const std::string & getName () const
 Return the object name. More...
 
virtual bool getIsInitialized () const
 Return whether the operator is initialized. More...
 
virtual void setHomogeneousBc (bool homogeneous_bc)
 Set whether the operator should use homogeneous boundary conditions. More...
 
virtual bool getHomogeneousBc () const
 Return whether the operator is using homogeneous boundary conditions. More...
 
virtual void setSolutionTime (double solution_time)
 Set the time at which the solution is to be evaluated. More...
 
virtual double getSolutionTime () const
 Get the time at which the solution is being evaluated. More...
 
virtual void setTimeInterval (double current_time, double new_time)
 Set the current time interval. More...
 
virtual std::pair< double, doublegetTimeInterval () const
 Get the current time interval. More...
 
virtual double getDt () const
 Get the current time step size. More...
 
virtual void setHierarchyMathOps (SAMRAI::tbox::Pointer< HierarchyMathOps > hier_math_ops)
 Set the HierarchyMathOps object used by the operator. More...
 
virtual SAMRAI::tbox::Pointer< HierarchyMathOps > getHierarchyMathOps () const
 Get the HierarchyMathOps object used by the operator. More...
 
virtual void applyAdd (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &x, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &y, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &z)
 Compute \(z=F[x]+y\). More...
 
virtual void modifyRhsForBcs (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &y)
 Modify the RHS vector to account for boundary conditions. More...
 
virtual void imposeSolBcs (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &u)
 Impose boudary conditions in the solution vector. More...
 

Logging functions.

virtual void setLoggingEnabled (bool enable_logging=true)
 Enable or disable logging. More...
 
virtual bool getLoggingEnabled () const
 Determine whether logging is enabled or disabled. More...
 
virtual void printClassData (std::ostream &stream)
 Print class data to stream. More...
 
const std::string d_object_name
 
bool d_is_initialized = false
 
bool d_homogeneous_bc
 
double d_solution_time = std::numeric_limits<double>::quiet_NaN()
 
double d_current_time = std::numeric_limits<double>::quiet_NaN()
 
double d_new_time = std::numeric_limits<double>::quiet_NaN()
 
SAMRAI::tbox::Pointer< HierarchyMathOps > d_hier_math_ops
 
bool d_hier_math_ops_external = false
 
bool d_enable_logging = false
 

Detailed Description

Class INSCollocatedWavePropConvectiveOperator computes the convective derivative of a cell-centered velocity field using the wave propagation method of Ketcheson and LeVeque.

Note
INSCollocatedWavePropConvectiveOperator currently only works in ADVECTIVE form.
Todo:
Implement a CONSERVATIVE form for the operator. This will involve writing a new Riemann solver for the flux.
See also
INSCollocatedHierarchyIntegrator

Constructor & Destructor Documentation

◆ INSCollocatedWavePropConvectiveOperator() [1/3]

IBAMR::INSCollocatedWavePropConvectiveOperator::INSCollocatedWavePropConvectiveOperator ( std::string  object_name,
SAMRAI::tbox::Pointer< SAMRAI::tbox::Database input_db,
ConvectiveDifferencingType  difference_form,
std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * >  bc_coefs 
)

◆ ~INSCollocatedWavePropConvectiveOperator()

IBAMR::INSCollocatedWavePropConvectiveOperator::~INSCollocatedWavePropConvectiveOperator ( )

◆ INSCollocatedWavePropConvectiveOperator() [2/3]

IBAMR::INSCollocatedWavePropConvectiveOperator::INSCollocatedWavePropConvectiveOperator ( )
privatedelete
Note
This constructor is not implemented and should not be used.

◆ INSCollocatedWavePropConvectiveOperator() [3/3]

IBAMR::INSCollocatedWavePropConvectiveOperator::INSCollocatedWavePropConvectiveOperator ( const INSCollocatedWavePropConvectiveOperator from)
privatedelete
Note
This constructor is not implemented and should not be used.
Parameters
fromThe value to copy to this object.

Member Function Documentation

◆ allocate_operator()

static SAMRAI::tbox::Pointer<ConvectiveOperator> IBAMR::INSCollocatedWavePropConvectiveOperator::allocate_operator ( const std::string &  object_name,
SAMRAI::tbox::Pointer< SAMRAI::tbox::Database input_db,
ConvectiveDifferencingType  difference_form,
const std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > &  bc_coefs 
)
inlinestatic

◆ applyConvectiveOperator()

void IBAMR::INSCollocatedWavePropConvectiveOperator::applyConvectiveOperator ( int  U_idx,
int  N_idx 
)
overridevirtual

◆ initializeOperatorState()

void IBAMR::INSCollocatedWavePropConvectiveOperator::initializeOperatorState ( const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  in,
const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  out 
)
overridevirtual

The vector arguments for apply(), applyAdjoint(), etc, need not match those for initializeOperatorState(). However, there must be a certain degree of similarity, including

  • hierarchy configuration (hierarchy pointer and level range)
  • number, type and alignment of vector component data
  • ghost cell widths of data in the input and output vectors
Note
It is generally necessary to reinitialize the operator state when the hierarchy configuration changes.

It is safe to call initializeOperatorState() when the state is already initialized. In this case, the operator state is first deallocated and then reinitialized.

Conditions on arguments:

  • input and output vectors must have same hierarchy
  • input and output vectors must have same structure, depth, etc.

Call deallocateOperatorState() to remove any data allocated by this method.

See also
deallocateOperatorState
Parameters
ininput vector
outoutput vector

Reimplemented from IBTK::GeneralOperator.

◆ deallocateOperatorState()

void IBAMR::INSCollocatedWavePropConvectiveOperator::deallocateOperatorState ( )
overridevirtual
Note
It is safe to call deallocateOperatorState() when the operator state is already deallocated.
See also
initializeOperatorState

Reimplemented from IBTK::GeneralOperator.

◆ operator=()

INSCollocatedWavePropConvectiveOperator& IBAMR::INSCollocatedWavePropConvectiveOperator::operator= ( const INSCollocatedWavePropConvectiveOperator that)
privatedelete
Note
This operator is not implemented and should not be used.
Parameters
thatThe value to assign to this object.
Returns
A reference to this object.

◆ setAdvectionVelocity()

void IBAMR::ConvectiveOperator::setAdvectionVelocity ( int  u_idx)
inherited

◆ getAdvectionVelocity()

int IBAMR::ConvectiveOperator::getAdvectionVelocity ( ) const
inherited

◆ setConvectiveDifferencingType()

void IBAMR::ConvectiveOperator::setConvectiveDifferencingType ( ConvectiveDifferencingType  difference_form)
inherited

◆ getConvectiveDifferencingType()

ConvectiveDifferencingType IBAMR::ConvectiveOperator::getConvectiveDifferencingType ( ) const
inherited

◆ apply()

void IBAMR::ConvectiveOperator::apply ( SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  x,
SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  y 
)
overridevirtualinherited

Before calling apply(), the form of the vectors x and y should be set properly by the user on all patch interiors on the specified range of levels in the patch hierarchy. The user is responsible for all data management for the quantities associated with the vectors. In particular, patch data in these vectors must be allocated prior to calling this method.

Parameters
xinput vector
youtput vector, i.e., \(y=F[x]\)

Conditions on Parameters:

  • vectors x and y must have same hierarchy
  • vectors x and y must have same structure, depth, etc.

In general, the vectors x and y cannot be the same.

See also
initializeOperatorState

Implements IBTK::GeneralOperator.

◆ getName()

const std::string& IBTK::GeneralOperator::getName ( ) const
inherited

◆ getIsInitialized()

virtual bool IBTK::GeneralOperator::getIsInitialized ( ) const
virtualinherited

◆ setHomogeneousBc()

virtual void IBTK::GeneralOperator::setHomogeneousBc ( bool  homogeneous_bc)
virtualinherited

◆ getHomogeneousBc()

virtual bool IBTK::GeneralOperator::getHomogeneousBc ( ) const
virtualinherited

◆ setSolutionTime()

virtual void IBTK::GeneralOperator::setSolutionTime ( double  solution_time)
virtualinherited

◆ getSolutionTime()

virtual double IBTK::GeneralOperator::getSolutionTime ( ) const
virtualinherited

◆ setTimeInterval()

virtual void IBTK::GeneralOperator::setTimeInterval ( double  current_time,
double  new_time 
)
virtualinherited

◆ getTimeInterval()

virtual std::pair<double, double> IBTK::GeneralOperator::getTimeInterval ( ) const
virtualinherited

◆ getDt()

virtual double IBTK::GeneralOperator::getDt ( ) const
virtualinherited

◆ setHierarchyMathOps()

virtual void IBTK::GeneralOperator::setHierarchyMathOps ( SAMRAI::tbox::Pointer< HierarchyMathOps hier_math_ops)
virtualinherited

◆ getHierarchyMathOps()

virtual SAMRAI::tbox::Pointer<HierarchyMathOps> IBTK::GeneralOperator::getHierarchyMathOps ( ) const
virtualinherited

◆ applyAdd()

virtual void IBTK::GeneralOperator::applyAdd ( SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  x,
SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  y,
SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  z 
)
virtualinherited

Before calling applyAdd(), the form of the vectors x, y, and z should be set properly by the user on all patch interiors on the specified range of levels in the patch hierarchy. The user is responsible for all data management for the quantities associated with the vectors. In particular, patch data in these vectors must be allocated prior to calling this method.

Parameters
xinput vector
yinput vector
zoutput vector, i.e., \(z=F[x]+y\)

Conditions on Parameters:

  • vectors x, y, and z must have same hierarchy
  • vectors x, y, and z must have same structure, depth, etc.

In general, the vectors x and y cannot be the same.

Note
Subclasses may require that the operator be initialized prior to calling applyAdd().
See also
initializeOperatorState
Note
A default implementation is provided which employs apply() and SAMRAI::solv::SAMRAIVectorReal::add().

Reimplemented in IBTK::PETScSNESJacobianJOWrapper, and IBTK::PETScMatLOWrapper.

◆ modifyRhsForBcs()

virtual void IBTK::GeneralOperator::modifyRhsForBcs ( SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  y)
virtualinherited

Before calling this function, the form of the vector y should be set properly by the user on all patch interiors on the range of levels covered by the operator. All data in this vector should be allocated. The user is responsible for managing the storage for the vectors.

Note
The operator MUST be initialized prior to calling modifyRhsForBcs.
See also
initializeOperatorState
Note
A default implementation does not modify the RHS vector y.

Reimplemented in IBTK::LinearOperator.

◆ imposeSolBcs()

virtual void IBTK::GeneralOperator::imposeSolBcs ( SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &  u)
virtualinherited

Before calling this function, the form of the vector y should be set properly by the user on all patch interiors on the range of levels covered by the operator. All data in this vector should be allocated. The user is responsible for managing the storage for the vectors.

Note
The operator MUST be initialized prior to calling imposeSolBcs.
See also
initializeOperatorState
Note
A default implementation does not modify the sol vector u.

◆ setLoggingEnabled()

virtual void IBTK::GeneralOperator::setLoggingEnabled ( bool  enable_logging = true)
virtualinherited

◆ getLoggingEnabled()

virtual bool IBTK::GeneralOperator::getLoggingEnabled ( ) const
virtualinherited

◆ printClassData()

virtual void IBTK::GeneralOperator::printClassData ( std::ostream &  stream)
virtualinherited

Member Data Documentation

◆ d_bc_coefs

std::vector<SAMRAI::solv::RobinBcCoefStrategy<NDIM>*> IBAMR::INSCollocatedWavePropConvectiveOperator::d_bc_coefs
private

◆ d_bdry_extrap_type

std::string IBAMR::INSCollocatedWavePropConvectiveOperator::d_bdry_extrap_type = "CONSTANT"
private

◆ d_transaction_comps

std::vector<IBTK::HierarchyGhostCellInterpolation::InterpolationTransactionComponent> IBAMR::INSCollocatedWavePropConvectiveOperator::d_transaction_comps
private

◆ d_hier_bdry_fill

SAMRAI::tbox::Pointer<IBTK::HierarchyGhostCellInterpolation> IBAMR::INSCollocatedWavePropConvectiveOperator::d_hier_bdry_fill
private

◆ d_hierarchy

SAMRAI::tbox::Pointer<SAMRAI::hier::PatchHierarchy<NDIM> > IBAMR::INSCollocatedWavePropConvectiveOperator::d_hierarchy
private

◆ d_coarsest_ln

int IBAMR::INSCollocatedWavePropConvectiveOperator::d_coarsest_ln = IBTK::invalid_level_number
private

◆ d_finest_ln

int IBAMR::INSCollocatedWavePropConvectiveOperator::d_finest_ln = IBTK::invalid_level_number
private

◆ d_U_var

SAMRAI::tbox::Pointer<SAMRAI::pdat::CellVariable<NDIM, double> > IBAMR::INSCollocatedWavePropConvectiveOperator::d_U_var
private

◆ d_U_scratch_idx

int IBAMR::INSCollocatedWavePropConvectiveOperator::d_U_scratch_idx = IBTK::invalid_index
private

◆ d_k

int IBAMR::INSCollocatedWavePropConvectiveOperator::d_k = 3
private

◆ d_difference_form

ConvectiveDifferencingType IBAMR::ConvectiveOperator::d_difference_form
protectedinherited

Enumerated type that determines which form of differencing to use.

◆ d_u_idx

int IBAMR::ConvectiveOperator::d_u_idx = IBTK::invalid_index
protectedinherited

The advection velocity patch data descriptor index.

◆ d_object_name

const std::string IBTK::GeneralOperator::d_object_name
protectedinherited

◆ d_is_initialized

bool IBTK::GeneralOperator::d_is_initialized = false
protectedinherited

◆ d_homogeneous_bc

bool IBTK::GeneralOperator::d_homogeneous_bc
protectedinherited

◆ d_solution_time

double IBTK::GeneralOperator::d_solution_time = std::numeric_limits<double>::quiet_NaN()
protectedinherited

◆ d_current_time

double IBTK::GeneralOperator::d_current_time = std::numeric_limits<double>::quiet_NaN()
protectedinherited

◆ d_new_time

double IBTK::GeneralOperator::d_new_time = std::numeric_limits<double>::quiet_NaN()
protectedinherited

◆ d_hier_math_ops

SAMRAI::tbox::Pointer<HierarchyMathOps> IBTK::GeneralOperator::d_hier_math_ops
protectedinherited

◆ d_hier_math_ops_external

bool IBTK::GeneralOperator::d_hier_math_ops_external = false
protectedinherited

◆ d_enable_logging

bool IBTK::GeneralOperator::d_enable_logging = false
protectedinherited

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