ROL
|
Defines the general affine constraint with the form \(c(x)=g(x) + g'(x)s + u - v\). More...
#include <ROL_ElasticLinearConstraint.hpp>
Public Member Functions | |
ElasticLinearConstraint (const Ptr< const Vector< Real > > &x, const Ptr< Constraint< Real > > &con, const Ptr< const Vector< Real > > &c) | |
void | update (const Vector< Real > &x, UpdateType type, int iter=-1) override |
Update constraint function. | |
void | update (const Vector< Real > &x, bool flag=true, int iter=-1) override |
Update constraint functions. x is the optimization variable, flag = true if optimization variable is changed, iter is the outer algorithm iterations count. | |
void | value (Vector< Real > &c, const Vector< Real > &x, Real &tol) override |
Evaluate the constraint operator \(c:\mathcal{X} \rightarrow \mathcal{C}\) at \(x\). | |
void | applyJacobian (Vector< Real > &jv, const Vector< Real > &v, const Vector< Real > &x, Real &tol) override |
Apply the constraint Jacobian at \(x\), \(c'(x) \in L(\mathcal{X}, \mathcal{C})\), to vector \(v\). | |
void | applyAdjointJacobian (Vector< Real > &ajv, const Vector< Real > &v, const Vector< Real > &x, Real &tol) override |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\). | |
void | applyAdjointJacobian (Vector< Real > &ajv, const Vector< Real > &v, const Vector< Real > &x, const Vector< Real > &dualv, Real &tol) override |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\). | |
void | applyAdjointHessian (Vector< Real > &ahuv, const Vector< Real > &u, const Vector< Real > &v, const Vector< Real > &x, Real &tol) override |
Apply the derivative of the adjoint of the constraint Jacobian at \(x\) to vector \(u\) in direction \(v\), according to \( v \mapsto c''(x)(v,\cdot)^*u \). | |
void | setAnchor (const Ptr< const Vector< Real > > &x) |
![]() | |
virtual | ~Constraint (void) |
Constraint (void) | |
virtual void | update (const Vector< Real > &x, UpdateType type, int iter=-1) |
Update constraint function. | |
virtual void | update (const Vector< Real > &x, bool flag=true, int iter=-1) |
Update constraint functions. x is the optimization variable, flag = true if optimization variable is changed, iter is the outer algorithm iterations count. | |
virtual void | value (Vector< Real > &c, const Vector< Real > &x, Real &tol)=0 |
Evaluate the constraint operator \(c:\mathcal{X} \rightarrow \mathcal{C}\) at \(x\). | |
virtual void | applyJacobian (Vector< Real > &jv, const Vector< Real > &v, const Vector< Real > &x, Real &tol) |
Apply the constraint Jacobian at \(x\), \(c'(x) \in L(\mathcal{X}, \mathcal{C})\), to vector \(v\). | |
virtual void | applyAdjointJacobian (Vector< Real > &ajv, const Vector< Real > &v, const Vector< Real > &x, Real &tol) |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\). | |
virtual void | applyAdjointJacobian (Vector< Real > &ajv, const Vector< Real > &v, const Vector< Real > &x, const Vector< Real > &dualv, Real &tol) |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\). | |
virtual void | applyAdjointHessian (Vector< Real > &ahuv, const Vector< Real > &u, const Vector< Real > &v, const Vector< Real > &x, Real &tol) |
Apply the derivative of the adjoint of the constraint Jacobian at \(x\) to vector \(u\) in direction \(v\), according to \( v \mapsto c''(x)(v,\cdot)^*u \). | |
virtual std::vector< Real > | solveAugmentedSystem (Vector< Real > &v1, Vector< Real > &v2, const Vector< Real > &b1, const Vector< Real > &b2, const Vector< Real > &x, Real &tol) |
Approximately solves the augmented system | |
virtual void | applyPreconditioner (Vector< Real > &pv, const Vector< Real > &v, const Vector< Real > &x, const Vector< Real > &g, Real &tol) |
Apply a constraint preconditioner at \(x\), \(P(x) \in L(\mathcal{C}, \mathcal{C}^*)\), to vector \(v\). Ideally, this preconditioner satisfies the following relationship: | |
void | activate (void) |
Turn on constraints. | |
void | deactivate (void) |
Turn off constraints. | |
bool | isActivated (void) |
Check if constraints are on. | |
virtual std::vector< std::vector< Real > > | checkApplyJacobian (const Vector< Real > &x, const Vector< Real > &v, const Vector< Real > &jv, const std::vector< Real > &steps, const bool printToStream=true, std::ostream &outStream=std::cout, const int order=1) |
Finite-difference check for the constraint Jacobian application. | |
virtual std::vector< std::vector< Real > > | checkApplyJacobian (const Vector< Real > &x, const Vector< Real > &v, const Vector< Real > &jv, const bool printToStream=true, std::ostream &outStream=std::cout, const int numSteps=ROL_NUM_CHECKDERIV_STEPS, const int order=1) |
Finite-difference check for the constraint Jacobian application. | |
virtual std::vector< std::vector< Real > > | checkApplyAdjointJacobian (const Vector< Real > &x, const Vector< Real > &v, const Vector< Real > &c, const Vector< Real > &ajv, const bool printToStream=true, std::ostream &outStream=std::cout, const int numSteps=ROL_NUM_CHECKDERIV_STEPS) |
Finite-difference check for the application of the adjoint of constraint Jacobian. | |
virtual Real | checkAdjointConsistencyJacobian (const Vector< Real > &w, const Vector< Real > &v, const Vector< Real > &x, const bool printToStream=true, std::ostream &outStream=std::cout) |
virtual Real | checkAdjointConsistencyJacobian (const Vector< Real > &w, const Vector< Real > &v, const Vector< Real > &x, const Vector< Real > &dualw, const Vector< Real > &dualv, const bool printToStream=true, std::ostream &outStream=std::cout) |
virtual std::vector< std::vector< Real > > | checkApplyAdjointHessian (const Vector< Real > &x, const Vector< Real > &u, const Vector< Real > &v, const Vector< Real > &hv, const std::vector< Real > &step, const bool printToScreen=true, std::ostream &outStream=std::cout, const int order=1) |
Finite-difference check for the application of the adjoint of constraint Hessian. | |
virtual std::vector< std::vector< Real > > | checkApplyAdjointHessian (const Vector< Real > &x, const Vector< Real > &u, const Vector< Real > &v, const Vector< Real > &hv, const bool printToScreen=true, std::ostream &outStream=std::cout, const int numSteps=ROL_NUM_CHECKDERIV_STEPS, const int order=1) |
Finite-difference check for the application of the adjoint of constraint Hessian. | |
virtual void | setParameter (const std::vector< Real > ¶m) |
Private Attributes | |
const Ptr< Constraint< Real > > | con_ |
const Ptr< Vector< Real > > | x_ |
const Ptr< Vector< Real > > | c_ |
const Ptr< Vector< Real > > | tmp_ |
Additional Inherited Members | |
![]() | |
const std::vector< Real > | getParameter (void) const |
Defines the general affine constraint with the form \(c(x)=g(x) + g'(x)s + u - v\).
Definition at line 60 of file ROL_ElasticLinearConstraint.hpp.
ROL::ElasticLinearConstraint< Real >::ElasticLinearConstraint | ( | const Ptr< const Vector< Real > > & | x, |
const Ptr< Constraint< Real > > & | con, | ||
const Ptr< const Vector< Real > > & | c | ||
) |
Definition at line 50 of file ROL_ElasticLinearConstraint_Def.hpp.
References ROL::ElasticLinearConstraint< Real >::setAnchor().
|
overridevirtual |
Update constraint function.
This function updates the constraint function at new iterations.
[in] | x | is the new iterate. |
[in] | type | is the type of update requested. |
[in] | iter | is the outer algorithm iterations count. |
Reimplemented from ROL::Constraint< Real >.
Definition at line 58 of file ROL_ElasticLinearConstraint_Def.hpp.
|
overridevirtual |
Update constraint functions.
x is the optimization variable, flag = true if optimization variable is changed, iter is the outer algorithm iterations count.
Reimplemented from ROL::Constraint< Real >.
Definition at line 61 of file ROL_ElasticLinearConstraint_Def.hpp.
|
overridevirtual |
Evaluate the constraint operator \(c:\mathcal{X} \rightarrow \mathcal{C}\) at \(x\).
[out] | c | is the result of evaluating the constraint operator at x; a constraint-space vector |
[in] | x | is the constraint argument; an optimization-space vector |
[in,out] | tol | is a tolerance for inexact evaluations; currently unused |
On return, \(\mathsf{c} = c(x)\), where \(\mathsf{c} \in \mathcal{C}\), \(\mathsf{x} \in \mathcal{X}\).
Implements ROL::Constraint< Real >.
Definition at line 64 of file ROL_ElasticLinearConstraint_Def.hpp.
References ROL::Vector< Real >::axpy(), and ROL::Vector< Real >::plus().
|
overridevirtual |
Apply the constraint Jacobian at \(x\), \(c'(x) \in L(\mathcal{X}, \mathcal{C})\), to vector \(v\).
[out] | jv | is the result of applying the constraint Jacobian to v at x; a constraint-space vector |
[in] | v | is an optimization-space vector |
[in] | x | is the constraint argument; an optimization-space vector |
[in,out] | tol | is a tolerance for inexact evaluations; currently unused |
On return, \(\mathsf{jv} = c'(x)v\), where \(v \in \mathcal{X}\), \(\mathsf{jv} \in \mathcal{C}\).
The default implementation is a finite-difference approximation.
Reimplemented from ROL::Constraint< Real >.
Definition at line 76 of file ROL_ElasticLinearConstraint_Def.hpp.
References ROL::Vector< Real >::axpy(), and ROL::Vector< Real >::plus().
|
overridevirtual |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\).
[out] | ajv | is the result of applying the adjoint of the constraint Jacobian to v at x; a dual optimization-space vector |
[in] | v | is a dual constraint-space vector |
[in] | x | is the constraint argument; an optimization-space vector |
[in,out] | tol | is a tolerance for inexact evaluations; currently unused |
On return, \(\mathsf{ajv} = c'(x)^*v\), where \(v \in \mathcal{C}^*\), \(\mathsf{ajv} \in \mathcal{X}^*\).
The default implementation is a finite-difference approximation.
Reimplemented from ROL::Constraint< Real >.
Definition at line 86 of file ROL_ElasticLinearConstraint_Def.hpp.
References ROL::Vector< Real >::dual().
|
overridevirtual |
Apply the adjoint of the the constraint Jacobian at \(x\), \(c'(x)^* \in L(\mathcal{C}^*, \mathcal{X}^*)\), to vector \(v\).
[out] | ajv | is the result of applying the adjoint of the constraint Jacobian to v at x; a dual optimization-space vector |
[in] | v | is a dual constraint-space vector |
[in] | x | is the constraint argument; an optimization-space vector |
[in] | dualv | is a vector used for temporary variables; a constraint-space vector |
[in,out] | tol | is a tolerance for inexact evaluations; currently unused |
On return, \(\mathsf{ajv} = c'(x)^*v\), where \(v \in \mathcal{C}^*\), \(\mathsf{ajv} \in \mathcal{X}^*\).
The default implementation is a finite-difference approximation.
Reimplemented from ROL::Constraint< Real >.
Definition at line 96 of file ROL_ElasticLinearConstraint_Def.hpp.
|
overridevirtual |
Apply the derivative of the adjoint of the constraint Jacobian at \(x\) to vector \(u\) in direction \(v\), according to \( v \mapsto c''(x)(v,\cdot)^*u \).
[out] | ahuv | is the result of applying the derivative of the adjoint of the constraint Jacobian at x to vector u in direction v; a dual optimization-space vector |
[in] | u | is the direction vector; a dual constraint-space vector |
[in] | v | is an optimization-space vector |
[in] | x | is the constraint argument; an optimization-space vector |
[in,out] | tol | is a tolerance for inexact evaluations; currently unused |
On return, \( \mathsf{ahuv} = c''(x)(v,\cdot)^*u \), where \(u \in \mathcal{C}^*\), \(v \in \mathcal{X}\), and \(\mathsf{ahuv} \in \mathcal{X}^*\).
The default implementation is a finite-difference approximation based on the adjoint Jacobian.
Reimplemented from ROL::Constraint< Real >.
Definition at line 106 of file ROL_ElasticLinearConstraint_Def.hpp.
References ROL::Vector< Real >::zero().
void ROL::ElasticLinearConstraint< Real >::setAnchor | ( | const Ptr< const Vector< Real > > & | x | ) |
Definition at line 111 of file ROL_ElasticLinearConstraint_Def.hpp.
Referenced by ROL::ElasticLinearConstraint< Real >::ElasticLinearConstraint().
|
private |
Definition at line 62 of file ROL_ElasticLinearConstraint.hpp.
|
private |
Definition at line 63 of file ROL_ElasticLinearConstraint.hpp.
|
private |
Definition at line 63 of file ROL_ElasticLinearConstraint.hpp.
|
private |
Definition at line 63 of file ROL_ElasticLinearConstraint.hpp.