rpc/scft/iterator/Iterator.h

#ifndef RPC_ITERATOR_H
#define RPC_ITERATOR_H
 
/*
* PSCF - Polymer Self-Consistent Field
*
* Copyright 2015 - 2025, The Regents of the University of Minnesota
* Distributed under the terms of the GNU General Public License.
*/
 
#include <rpc/scft/sweep/Sweep.h>
#include <prdc/environment/Environment.h>
#include <util/param/ParamComposite.h>    // base class
#include <util/containers/FSArray.h>
#include <util/global.h>
 
namespace Pscf {
namespace Rpc
{
 
   template <int D>
   class System;
 
   using namespace Util;

   template <int D>
   class Iterator : public ParamComposite
   {
 
   public:

      Iterator();

      Iterator(System<D>& system);

      ~Iterator();

      virtual int solve(bool isContinuation) = 0;
      
      virtual void outputTimers(std::ostream& out) const = 0;
      
      virtual void clearTimers() = 0;

      bool isSymmetric() const
      {  return (isSymmetric_); }

      bool isFlexible() const
      {  return (isFlexible_); }

      FSArray<bool,6> flexibleParams() const
      {  return flexibleParams_; }

      int nFlexibleParams() const;
 
      void setFlexibleParams(FSArray<bool,6> const & flexParams);
 
      virtual double stress(int paramId) const;
 
   protected:

      bool isSymmetric_;
    
      bool isFlexible_;

      FSArray<bool,6> flexibleParams_;

      System<D> const & system() const
      {
         UTIL_CHECK(sysPtr_);  
         return *sysPtr_; 
      }

      System<D>& system() 
      {  
         UTIL_CHECK(sysPtr_);  
         return *sysPtr_; 
      }
 
   private:

      System<D>* sysPtr_;
      
   };
 
   // Inline member functions
 
   // Default constructor
   template <int D>
   inline Iterator<D>::Iterator()
    : isSymmetric_(false),
      isFlexible_(false),
      sysPtr_(nullptr)
   {  setClassName("Iterator"); }
 
   // Constructor
   template <int D>
   Iterator<D>::Iterator(System<D>& system)
    : isSymmetric_(false),
      isFlexible_(false),
      sysPtr_(&system)
   {  setClassName("Iterator"); }
 
   // Destructor
   template <int D>
   Iterator<D>::~Iterator()
   {}
 
   // Get the number of flexible lattice parameters
   template <int D>
   int Iterator<D>::nFlexibleParams() const
   {
      UTIL_CHECK(flexibleParams_.size() == 
                                 system().domain().unitCell().nParameter());
      int nFlexParams = 0;
      for (int i = 0; i < flexibleParams_.size(); i++) {
         if (flexibleParams_[i]) nFlexParams++;
      }
      return nFlexParams;
   }
 
   // Set the array indicating which lattice parameters are flexible.
   template <int D>
   void Iterator<D>::setFlexibleParams(FSArray<bool,6> const & flexParams)
   {  
      flexibleParams_ = flexParams; 
      if (nFlexibleParams() == 0) {
         isFlexible_ = false;
      } else {
         isFlexible_ = true;
      }
   }
 
   // Return the stress used by this Iterator, for one lattice parameter.
   template <int D>
   double Iterator<D>::stress(int paramId) const
   {
      // Parameter must be flexible to access the stress
      UTIL_CHECK(flexibleParams_[paramId]);
 
      if (system().hasEnvironment()) {
         return system().environment().stress(paramId);
      } else {
         return system().mixture().stress(paramId);
      }
   }
 
} // namespace Rpc
} // namespace Pscf
#endif