LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup Class Reference

A group representing the minimally augemented turning point equations. More...

#include <LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H>

Inheritance diagram for LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup:

Inheritance graph
[legend]
Collaboration diagram for LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 ExtendedGroup (const Teuchos::RCP< LOCA::GlobalData > &global_data, const Teuchos::RCP< LOCA::Parameter::SublistParser > &topParams, const Teuchos::RCP< Teuchos::ParameterList > &tpParams, const Teuchos::RCP< LOCA::TurningPoint::MinimallyAugmented::AbstractGroup > &g)
 Constructor with initial data passed through parameter lists.
 ExtendedGroup (const ExtendedGroup &source, NOX::CopyType type=NOX::DeepCopy)
 Copy constructor.
virtual ~ExtendedGroup ()
 Destructor.
double getBifParam () const
 Get bifurcation parameter.
Teuchos::RCP< const
NOX::Abstract::Vector
getLeftNullVec () const
 Returns left null vector.
Teuchos::RCP< const
NOX::Abstract::Vector
getRightNullVec () const
 Returns right null vector v.
Implementation of NOX::Abstract::Group virtual methods
virtual NOX::Abstract::Groupoperator= (const NOX::Abstract::Group &source)
 Assignment operator.
virtual Teuchos::RCP
< NOX::Abstract::Group
clone (NOX::CopyType type=NOX::DeepCopy) const
 Cloning function.
virtual void setX (const NOX::Abstract::Vector &y)
 Set the solution vector, x, to y.
virtual void computeX (const NOX::Abstract::Group &g, const NOX::Abstract::Vector &d, double step)
 Compute this.x = grp.x + step * d.
virtual
NOX::Abstract::Group::ReturnType 
computeF ()
 Compute the turning point equation residual $G$.
virtual
NOX::Abstract::Group::ReturnType 
computeJacobian ()
 Compute the blocks of the Jacobian derivative of $G$.
virtual
NOX::Abstract::Group::ReturnType 
computeGradient ()
 Gradient computation is not defined for this group.
virtual
NOX::Abstract::Group::ReturnType 
computeNewton (Teuchos::ParameterList &params)
 Compute Newton direction using applyJacobianInverse().
virtual
NOX::Abstract::Group::ReturnType 
applyJacobian (const NOX::Abstract::Vector &input, NOX::Abstract::Vector &result) const
 Computes the extended Jacobian vector product.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianTranspose (const NOX::Abstract::Vector &input, NOX::Abstract::Vector &result) const
 Computes the extended Jacobian transpose vector product.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianInverse (Teuchos::ParameterList &params, const NOX::Abstract::Vector &input, NOX::Abstract::Vector &result) const
 Applies the inverse of the extended Jacobian matrix.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianMultiVector (const NOX::Abstract::MultiVector &input, NOX::Abstract::MultiVector &result) const
 Applies Jacobian for extended system.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianTransposeMultiVector (const NOX::Abstract::MultiVector &input, NOX::Abstract::MultiVector &result) const
 Jacobian transpose for extended system.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianInverseMultiVector (Teuchos::ParameterList &params, const NOX::Abstract::MultiVector &input, NOX::Abstract::MultiVector &result) const
 Applies Jacobian inverse for extended system.
virtual bool isF () const
 Return true if the extended residual $G$ is valid.
virtual bool isJacobian () const
 Return true if the extended Jacobian is valid.
virtual bool isGradient () const
 Always returns false.
virtual bool isNewton () const
 Return true if the extended Newton direction is valid.
virtual const
NOX::Abstract::Vector
getX () const
 Return extended solution vector $z$.
virtual const
NOX::Abstract::Vector
getF () const
 Return extended equation residual $G(z)$.
virtual double getNormF () const
 Return 2-norm of $G(z)$.
virtual const
NOX::Abstract::Vector
getGradient () const
 Vector returned is not valid.
virtual const
NOX::Abstract::Vector
getNewton () const
 Return extended Newton direction.
virtual double getNormNewtonSolveResidual () const
 Return the norm of the Newton solve residual.
Implementation of LOCA::Extended::MultiAbstractGroup
virtual methods

virtual Teuchos::RCP< const
LOCA::MultiContinuation::AbstractGroup
getUnderlyingGroup () const
 Return underlying group.
virtual Teuchos::RCP
< LOCA::MultiContinuation::AbstractGroup
getUnderlyingGroup ()
 Return underlying group.
Implementation of LOCA::MultiContinuation::AbstractGroup
virtual methods

virtual void copy (const NOX::Abstract::Group &source)
 Assignment operator.
virtual void setParamsMulti (const vector< int > &paramIDs, const NOX::Abstract::MultiVector::DenseMatrix &vals)
 Set parameters indexed by (integer) paramIDs.
virtual void setParams (const ParameterVector &p)
 Set the parameter vector in the group to p.
virtual void setParam (string paramID, double val)
 Set parameter indexed by paramID.
virtual void setParam (int paramID, double val)
 Set parameter indexed by paramID.
virtual const ParameterVectorgetParams () const
 Return a const reference to the paramter vector owned by the group.
virtual double getParam (int paramID) const
 Return copy of parameter indexed by paramID.
virtual double getParam (string paramID) const
 Return copy of parameter indexed by paramID.
virtual
NOX::Abstract::Group::ReturnType 
computeDfDpMulti (const vector< int > &paramIDs, NOX::Abstract::MultiVector &dfdp, bool isValidF)
virtual void preProcessContinuationStep (LOCA::Abstract::Iterator::StepStatus stepStatus)
 Perform any preprocessing before a continuation step starts.
virtual void postProcessContinuationStep (LOCA::Abstract::Iterator::StepStatus stepStatus)
 Perform any postprocessing after a continuation step finishes.
virtual void projectToDraw (const NOX::Abstract::Vector &x, double *px) const
 Projects solution to a few scalars for multiparameter continuation.
virtual int projectToDrawDimension () const
 Returns the dimension of the project to draw array.
virtual void printSolution (const double conParam) const
 Function to print out extended solution and continuation parameter after successful continuation step.
virtual void printSolution (const NOX::Abstract::Vector &x_, const double conParam) const
 Function to print out extended solution and continuation parameter after successful continuation step.
Implementation of
virtual int getBorderedWidth () const
 Return the total width of the bordered rows/columns.
virtual Teuchos::RCP< const
NOX::Abstract::Group
getUnborderedGroup () const
 Get bottom-level unbordered group.
virtual bool isCombinedAZero () const
 Indicates whether combined A block is zero.
virtual bool isCombinedBZero () const
 Indicates whether combined B block is zero.
virtual bool isCombinedCZero () const
 Indicates whether combined C block is zero.
virtual void extractSolutionComponent (const NOX::Abstract::MultiVector &v, NOX::Abstract::MultiVector &v_x) const
virtual void extractParameterComponent (bool use_transpose, const NOX::Abstract::MultiVector &v, NOX::Abstract::MultiVector::DenseMatrix &v_p) const
virtual void loadNestedComponents (const NOX::Abstract::MultiVector &v_x, const NOX::Abstract::MultiVector::DenseMatrix &v_p, NOX::Abstract::MultiVector &v) const
virtual void fillA (NOX::Abstract::MultiVector &A) const
 Fill the combined A block as described above.
virtual void fillB (NOX::Abstract::MultiVector &B) const
 Fill the combined B block as described above.
virtual void fillC (NOX::Abstract::MultiVector::DenseMatrix &C) const
 Fill the combined C block as described above.
Implementation of LOCA::Abstract::TransposeSolveGroup
virtual methods

virtual
NOX::Abstract::Group::ReturnType 
applyJacobianTransposeInverse (Teuchos::ParameterList &params, const NOX::Abstract::Vector &input, NOX::Abstract::Vector &result) const
 Solve Jacobian-tranpose system.
virtual
NOX::Abstract::Group::ReturnType 
applyJacobianTransposeInverseMultiVector (Teuchos::ParameterList &params, const NOX::Abstract::MultiVector &input, NOX::Abstract::MultiVector &result) const
 Solve Jacobian-tranpose system with multiple right-hand sides.

Protected Member Functions

void setBifParam (double param)
 Set bifurcation parameter.
void getInitialVectors (Teuchos::RCP< NOX::Abstract::Vector > &aVecPtr, Teuchos::RCP< NOX::Abstract::Vector > &bVecPtr, bool isSymmetric)
 Computes initial "a" and "b" vectors.

Protected Attributes

Teuchos::RCP< LOCA::GlobalDataglobalData
 Pointer LOCA global data object.
Teuchos::RCP
< LOCA::Parameter::SublistParser
parsedParams
 Parsed top-level parameters.
Teuchos::RCP
< Teuchos::ParameterList > 
turningPointParams
 Bifurcation parameter list.
Teuchos::RCP
< LOCA::TurningPoint::MinimallyAugmented::AbstractGroup
grpPtr
 Pointer to base group that defines $F$.
Teuchos::RCP
< LOCA::TurningPoint::MinimallyAugmented::Constraint
constraint
 Pointer to the constraint equation.
Teuchos::RCP
< LOCA::MultiContinuation::ConstrainedGroup
conGroup
 Pointer to constrained group implementation.
int bifParamID
 Stores the bifurcation parameter index.

Private Member Functions

ExtendedGroupoperator= (const ExtendedGroup &)
 Prohibit generation and use of operator=().


Detailed Description

A group representing the minimally augemented turning point equations.

The LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup is a concrete implementation of the NOX::Abstract::Group, LOCA::MultiContinuation::AbstractGroup and LOCA::Extended::MultiAbstractGroup that defines the following extended set of equations that are regular at a generic turning point:

\[ G(z) = \left[ \begin{array}{c} F(x,p) \\ \sigma \end{array} \right] = 0 \]

where $z = [x, p]\in\Re^{n+1}$, $x$ is the solution vector, $p$ is the bifurcation parameter, $J$ is the Jacobian of $F$, and $\sigma\in\Re$ is a measure of the singularity of $F$ and is defined via

\[ \begin{bmatrix} J & a \\ b^T & 0 \end{bmatrix} \begin{bmatrix} v \\ \sigma_1 \end{bmatrix} = \begin{bmatrix} 0 \\ n \end{bmatrix}, \]

\[ \begin{bmatrix} J^T & b \\ a^T & 0 \end{bmatrix} \begin{bmatrix} w \\ \sigma_2 \end{bmatrix} = \begin{bmatrix} 0 \\ n \end{bmatrix}, \]

\[ \sigma = w^T J v/n \]

for any vectors $a$ and $b$ in $\Re^n$. Using these relationships, it is easy to show

\[ \begin{split} \sigma_x &= (w^T J v)_x/n = w^T J_x v/n \\ \sigma_p &= (w^T J v)_p/n = w^T J_p v/n \end{split} \]

The group stores an underlying group of type LOCA::TurningPoint::MinimallyAugmented::AbstractGroup to represent the equations $F(x,p) = 0$ and to manipulate the underlying Jacobian $J$. This interface defines methods for computing the derivatives $(w^T J v)_x$ and $(w^T J v)_p$ as well.

This class implements all of the NOX::Abstract::Group, LOCA::MultiContinuation::AbstractGroup, and LOCA::Extended::MultiAbstractGroup methods for this extended set of equations and therefore is a complete group which can be passed to most NOX solvers to locate a single turning point or to the LOCA::Stepper to compute a family of turning points in a second parameter.

The class is intialized via the tpParams parameter list argument to the constructor. The parameters this class recognizes are:

Definition at line 203 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.


Constructor & Destructor Documentation

LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::ExtendedGroup ( const Teuchos::RCP< LOCA::GlobalData > &  global_data,
const Teuchos::RCP< LOCA::Parameter::SublistParser > &  topParams,
const Teuchos::RCP< Teuchos::ParameterList > &  tpParams,
const Teuchos::RCP< LOCA::TurningPoint::MinimallyAugmented::AbstractGroup > &  g 
)

Constructor with initial data passed through parameter lists.

Definition at line 56 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References bifParamID, conGroup, constraint, LOCA::ParameterVector::getIndex(), getInitialVectors(), globalData, grpPtr, parsedParams, and turningPointParams.

Referenced by clone().

LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::ExtendedGroup ( const ExtendedGroup source,
NOX::CopyType  type = NOX::DeepCopy 
)

Copy constructor.

Definition at line 138 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup, constraint, and grpPtr.

LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::~ExtendedGroup (  )  [virtual]

Destructor.

Definition at line 157 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.


Member Function Documentation

NOX::Abstract::Group & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::operator= ( const NOX::Abstract::Group source  )  [virtual]

Assignment operator.

Implements NOX::Abstract::Group.

Definition at line 163 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References copy().

Teuchos::RCP< NOX::Abstract::Group > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::clone ( NOX::CopyType  type = NOX::DeepCopy  )  const [virtual]

Cloning function.

Implements NOX::Abstract::Group.

Definition at line 171 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References ExtendedGroup().

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setX ( const NOX::Abstract::Vector y  )  [virtual]

Set the solution vector, x, to y.

Implements NOX::Abstract::Group.

Definition at line 178 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeX ( const NOX::Abstract::Group g,
const NOX::Abstract::Vector d,
double  step 
) [virtual]

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeF (  )  [virtual]

Compute the turning point equation residual $G$.

This method fills the extended residual

\[ G(z) = \left[ \begin{array}{c} F(x,p) \\ \sigma \end{array} \right]. \]

Implements NOX::Abstract::Group.

Definition at line 207 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeJacobian (  )  [virtual]

Compute the blocks of the Jacobian derivative of $G$.

This method computes the $J$, $F_p$, $\sigma_x$ and $\sigma_p$ blocks of the extended Jacobian:

\[ D_z G(z) = \begin{bmatrix} J & F_p \\ \sigma_x & \sigma_p \end{bmatrix} \]

Reimplemented from NOX::Abstract::Group.

Definition at line 214 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeGradient (  )  [virtual]

Gradient computation is not defined for this group.

Reimplemented from NOX::Abstract::Group.

Definition at line 221 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeNewton ( Teuchos::ParameterList &  params  )  [virtual]

Compute Newton direction using applyJacobianInverse().

Reimplemented from NOX::Abstract::Group.

Definition at line 228 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobian ( const NOX::Abstract::Vector input,
NOX::Abstract::Vector result 
) const [virtual]

Computes the extended Jacobian vector product.

Reimplemented from NOX::Abstract::Group.

Definition at line 235 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianTranspose ( const NOX::Abstract::Vector input,
NOX::Abstract::Vector result 
) const [virtual]

Computes the extended Jacobian transpose vector product.

Reimplemented from NOX::Abstract::Group.

Definition at line 243 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianInverse ( Teuchos::ParameterList &  params,
const NOX::Abstract::Vector input,
NOX::Abstract::Vector result 
) const [virtual]

Applies the inverse of the extended Jacobian matrix.

Reimplemented from NOX::Abstract::Group.

Definition at line 251 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianMultiVector ( const NOX::Abstract::MultiVector input,
NOX::Abstract::MultiVector result 
) const [virtual]

Applies Jacobian for extended system.

Reimplemented from NOX::Abstract::Group.

Definition at line 260 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianTransposeMultiVector ( const NOX::Abstract::MultiVector input,
NOX::Abstract::MultiVector result 
) const [virtual]

Jacobian transpose for extended system.

Reimplemented from NOX::Abstract::Group.

Definition at line 268 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianInverseMultiVector ( Teuchos::ParameterList &  params,
const NOX::Abstract::MultiVector input,
NOX::Abstract::MultiVector result 
) const [virtual]

Applies Jacobian inverse for extended system.

Reimplemented from NOX::Abstract::Group.

Definition at line 276 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isF (  )  const [virtual]

Return true if the extended residual $G$ is valid.

Implements NOX::Abstract::Group.

Definition at line 285 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isJacobian (  )  const [virtual]

Return true if the extended Jacobian is valid.

Reimplemented from NOX::Abstract::Group.

Definition at line 292 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isGradient (  )  const [virtual]

Always returns false.

Reimplemented from NOX::Abstract::Group.

Definition at line 299 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isNewton (  )  const [virtual]

Return true if the extended Newton direction is valid.

Reimplemented from NOX::Abstract::Group.

Definition at line 306 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

const NOX::Abstract::Vector & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getX (  )  const [virtual]

Return extended solution vector $z$.

Implements NOX::Abstract::Group.

Definition at line 313 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

const NOX::Abstract::Vector & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getF (  )  const [virtual]

Return extended equation residual $G(z)$.

Implements NOX::Abstract::Group.

Definition at line 320 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

double LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getNormF (  )  const [virtual]

Return 2-norm of $G(z)$.

Implements NOX::Abstract::Group.

Definition at line 327 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

const NOX::Abstract::Vector & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getGradient (  )  const [virtual]

Vector returned is not valid.

Implements NOX::Abstract::Group.

Definition at line 334 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

const NOX::Abstract::Vector & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getNewton (  )  const [virtual]

Return extended Newton direction.

Implements NOX::Abstract::Group.

Definition at line 341 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

double LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getNormNewtonSolveResidual (  )  const [virtual]

Return the norm of the Newton solve residual.

Definition at line 348 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

Teuchos::RCP< const LOCA::MultiContinuation::AbstractGroup > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getUnderlyingGroup (  )  const [virtual]

Return underlying group.

Implements LOCA::Extended::MultiAbstractGroup.

Definition at line 355 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

Teuchos::RCP< LOCA::MultiContinuation::AbstractGroup > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getUnderlyingGroup (  )  [virtual]

Return underlying group.

Implements LOCA::Extended::MultiAbstractGroup.

Definition at line 362 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::copy ( const NOX::Abstract::Group source  )  [virtual]

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setParamsMulti ( const vector< int > &  paramIDs,
const NOX::Abstract::MultiVector::DenseMatrix vals 
) [virtual]

Set parameters indexed by (integer) paramIDs.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 390 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setParams ( const ParameterVector p  )  [virtual]

Set the parameter vector in the group to p.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 398 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setParam ( string  paramID,
double  val 
) [virtual]

Set parameter indexed by paramID.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 412 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setParam ( int  paramID,
double  val 
) [virtual]

Set parameter indexed by paramID.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 405 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

const LOCA::ParameterVector & LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getParams (  )  const [virtual]

Return a const reference to the paramter vector owned by the group.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 419 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

double LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getParam ( int  paramID  )  const [virtual]

Return copy of parameter indexed by paramID.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 426 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

double LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getParam ( string  paramID  )  const [virtual]

Return copy of parameter indexed by paramID.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 433 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::computeDfDpMulti ( const vector< int > &  paramIDs,
NOX::Abstract::MultiVector dfdp,
bool  isValidF 
) [virtual]

Compute $\partial F/\partial p$ for each parameter $p$ indexed by paramIDs. The first column of dfdp holds F, which is valid if isValidF is true. Otherwise F must be computed.

Implements LOCA::MultiContinuation::AbstractGroup.

Definition at line 440 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::preProcessContinuationStep ( LOCA::Abstract::Iterator::StepStatus  stepStatus  )  [virtual]

Perform any preprocessing before a continuation step starts.

The stepStatus argument indicates whether the previous step was successful.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 449 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::postProcessContinuationStep ( LOCA::Abstract::Iterator::StepStatus  stepStatus  )  [virtual]

Perform any postprocessing after a continuation step finishes.

The stepStatus argument indicates whether the step was successful.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 456 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::projectToDraw ( const NOX::Abstract::Vector x,
double *  px 
) const [virtual]

Projects solution to a few scalars for multiparameter continuation.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 463 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

int LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::projectToDrawDimension (  )  const [virtual]

Returns the dimension of the project to draw array.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 471 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::printSolution ( const double  conParam  )  const [virtual]

Function to print out extended solution and continuation parameter after successful continuation step.

This method prints the solution, null-vector, and parameter components of the extended solution vector using the printSolution method of the underlying group.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 478 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References constraint, getBifParam(), globalData, grpPtr, and NOX::Utils::StepperDetails.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::printSolution ( const NOX::Abstract::Vector x_,
const double  conParam 
) const [virtual]

Function to print out extended solution and continuation parameter after successful continuation step.

This method prints the solution, null-vector, and parameter components of the extended solution vector using the printSolution method of the underlying group.

Reimplemented from LOCA::MultiContinuation::AbstractGroup.

Definition at line 510 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References constraint, LOCA::Extended::Vector::getScalar(), LOCA::MultiContinuation::ExtendedVector::getXVec(), globalData, grpPtr, and NOX::Utils::StepperDetails.

int LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getBorderedWidth (  )  const [virtual]

Return the total width of the bordered rows/columns.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 546 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

Teuchos::RCP< const NOX::Abstract::Group > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getUnborderedGroup (  )  const [virtual]

Get bottom-level unbordered group.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 553 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isCombinedAZero (  )  const [virtual]

Indicates whether combined A block is zero.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 560 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isCombinedBZero (  )  const [virtual]

Indicates whether combined B block is zero.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 567 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

bool LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::isCombinedCZero (  )  const [virtual]

Indicates whether combined C block is zero.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 574 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::extractSolutionComponent ( const NOX::Abstract::MultiVector v,
NOX::Abstract::MultiVector v_x 
) const [virtual]

Given the vector v, extract the underlying solution component corresponding to the unbordered group.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 581 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::extractParameterComponent ( bool  use_transpose,
const NOX::Abstract::MultiVector v,
NOX::Abstract::MultiVector::DenseMatrix v_p 
) const [virtual]

Given the vector v, extract the parameter components of all of the nested subvectors in v down to the solution component for the unbordered group.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 589 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::loadNestedComponents ( const NOX::Abstract::MultiVector v_x,
const NOX::Abstract::MultiVector::DenseMatrix v_p,
NOX::Abstract::MultiVector v 
) const [virtual]

Given the solution component v_x and combined parameter components v_p, distribute these components through the nested sub-vectors in v.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 598 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::fillA ( NOX::Abstract::MultiVector A  )  const [virtual]

Fill the combined A block as described above.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 607 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::fillB ( NOX::Abstract::MultiVector B  )  const [virtual]

Fill the combined B block as described above.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 614 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::fillC ( NOX::Abstract::MultiVector::DenseMatrix C  )  const [virtual]

Fill the combined C block as described above.

Implements LOCA::BorderedSystem::AbstractGroup.

Definition at line 621 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianTransposeInverse ( Teuchos::ParameterList &  params,
const NOX::Abstract::Vector input,
NOX::Abstract::Vector result 
) const [virtual]

Solve Jacobian-tranpose system.

Implements LOCA::Abstract::TransposeSolveGroup.

Definition at line 628 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

NOX::Abstract::Group::ReturnType LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::applyJacobianTransposeInverseMultiVector ( Teuchos::ParameterList &  params,
const NOX::Abstract::MultiVector input,
NOX::Abstract::MultiVector result 
) const [virtual]

Solve Jacobian-tranpose system with multiple right-hand sides.

Implements LOCA::Abstract::TransposeSolveGroup.

Definition at line 637 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References conGroup.

double LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getBifParam (  )  const

Get bifurcation parameter.

Definition at line 646 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References bifParamID, and grpPtr.

Referenced by printSolution().

Teuchos::RCP< const NOX::Abstract::Vector > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getLeftNullVec (  )  const

Returns left null vector.

Definition at line 653 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References constraint.

Teuchos::RCP< const NOX::Abstract::Vector > LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getRightNullVec (  )  const

Returns right null vector v.

Definition at line 660 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References constraint.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::setBifParam ( double  param  )  [protected]

Set bifurcation parameter.

Definition at line 667 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References bifParamID, and conGroup.

void LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::getInitialVectors ( Teuchos::RCP< NOX::Abstract::Vector > &  aVecPtr,
Teuchos::RCP< NOX::Abstract::Vector > &  bVecPtr,
bool  isSymmetric 
) [protected]

Computes initial "a" and "b" vectors.

Definition at line 674 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.C.

References bifParamID, globalData, grpPtr, NOX::Abstract::Group::Ok, parsedParams, NOX::ShapeCopy, and turningPointParams.

Referenced by ExtendedGroup().

ExtendedGroup& LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::operator= ( const ExtendedGroup  )  [private]

Prohibit generation and use of operator=().


Member Data Documentation

Pointer LOCA global data object.

Definition at line 574 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by copy(), ExtendedGroup(), getInitialVectors(), and printSolution().

Parsed top-level parameters.

Definition at line 577 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by copy(), ExtendedGroup(), and getInitialVectors().

Teuchos::RCP<Teuchos::ParameterList> LOCA::TurningPoint::MinimallyAugmented::ExtendedGroup::turningPointParams [protected]

Bifurcation parameter list.

Definition at line 580 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by copy(), ExtendedGroup(), and getInitialVectors().

Pointer to base group that defines $F$.

Definition at line 583 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by copy(), ExtendedGroup(), getBifParam(), getInitialVectors(), and printSolution().

Pointer to the constraint equation.

Definition at line 586 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by computeX(), copy(), ExtendedGroup(), getLeftNullVec(), getRightNullVec(), and printSolution().

Stores the bifurcation parameter index.

Definition at line 592 of file LOCA_TurningPoint_MinimallyAugmented_ExtendedGroup.H.

Referenced by copy(), ExtendedGroup(), getBifParam(), getInitialVectors(), and setBifParam().


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

Generated on Wed Oct 21 14:28:41 2009 for Nonlinear Solver Project by  doxygen 1.5.9