// @HEADER // ***************************************************************************** // LOCA: Library of Continuation Algorithms Package // // Copyright 2001-2005 NTESS and the LOCA contributors. // SPDX-License-Identifier: BSD-3-Clause // ***************************************************************************** // @HEADER #ifndef NORMCONSTRAINT_H #define NORMCONSTRAINT_H #include "LOCA.H" //! A simple constraint equation based on the solution norm /*! * This class implements the LOCA::MultiContinuation::ConstraintInterfaceMVDX * constraint interface for a simple norm constraint: * \f[ * g(x,p) = \frac{1}{2 N} \|x\|^2 - \gamma * \f] * where \f$x\f$ is the solution vector and \gamma is the constraint * parameter. */ class NormConstraint : public LOCA::MultiContinuation::ConstraintInterfaceMVDX { public: //! Constructor NormConstraint(int N, const LOCA::ParameterVector& pVec, NOX::Abstract::Vector& cloneVec); //! Copy constructor NormConstraint(const NormConstraint& source, NOX::CopyType type = NOX::DeepCopy); //! Destructor virtual ~NormConstraint(); /*! * @name Implementation of LOCA::MultiContinuation::ConstraintInterfaceMVDX * virtual methods */ //@{ //! Copy virtual void copy(const LOCA::MultiContinuation::ConstraintInterface& source); //! Cloning function virtual Teuchos::RCP clone(NOX::CopyType type = NOX::DeepCopy) const; //! Return number of constraints virtual int numConstraints() const; //! Set the solution vector to y. virtual void setX(const NOX::Abstract::Vector& y); //! Sets parameter indexed by paramID virtual void setParam(int paramID, double val); //! Sets parameters indexed by paramIDs virtual void setParams(const std::vector& paramIDs, const NOX::Abstract::MultiVector::DenseMatrix& vals); //! Compute continuation constraint equations virtual NOX::Abstract::Group::ReturnType computeConstraints(); //! Compute derivative of constraints w.r.t. solution vector x virtual NOX::Abstract::Group::ReturnType computeDX(); //! Compute derivative of constraints w.r.t. supplied parameters. /*! * The first column of \c dgdp should be filled with the constraint * residuals \f$g\f$ if \c isValidG is \c false. If \c isValidG is * \c true, then the \c dgdp contains \f$g\f$ on input. */ virtual NOX::Abstract::Group::ReturnType computeDP(const std::vector& paramIDs, NOX::Abstract::MultiVector::DenseMatrix& dgdp, bool isValidG); //! Return \c true if constraint residuals are valid virtual bool isConstraints() const; //! Return \c true if derivative of constraint w.r.t. x is valid virtual bool isDX() const; //! Return constraint residuals virtual const NOX::Abstract::MultiVector::DenseMatrix& getConstraints() const; //! Return solution component of constraint derivatives virtual const NOX::Abstract::MultiVector* getDX() const; /*! * \brief Return \c true if solution component of constraint * derivatives is zero */ virtual bool isDXZero() const; //@} /*! * \brief Set the flag determinging whether isDXZero() * returns true or false. This is for testing bordered solvers when B * is zero. */ void setIsZeroDX(bool flag); private: //! Prohibit generation and use of operator=() NormConstraint& operator=(const NormConstraint& source); protected: //! Dimension of discretization int n; //! Constraint values NOX::Abstract::MultiVector::DenseMatrix constraints; //! Flag indicating whether constraints are valid bool isValidConstraints; //! Parameter vector LOCA::ParameterVector p; //! Solution vector Teuchos::RCP x; //! Flag indicating whether dgdx is zero bool isZeroDgDx; }; #endif