MaskTmpl.tpp

#ifndef PRDC_MASK_TMPL_TPP
#define PRDC_MASK_TMPL_TPP
 
/*
* 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 "MaskTmpl.h"
#include <prdc/field/fieldIoUtil.h> 
#include <prdc/crystal/Basis.h> 
#include <prdc/crystal/UnitCell.h> 
#include <pscf/mesh/Mesh.h> 
#include <util/signal/Signal.h>
#include <util/misc/FileMaster.h> 
 
namespace Pscf {
namespace Prdc {
 
   using namespace Util;
 
   /*
   * Constructor.
   */
   template <int D, class RFT, class FIT>
   MaskTmpl<D,RFT,FIT>::MaskTmpl()
    : basis_(),
      rgrid_(),
      meshDimensions_(),
      meshSize_(0),
      nBasis_(0),
      readUnitCellPtr_(nullptr),
      writeUnitCellPtr_(nullptr),
      fieldIoPtr_(nullptr),
      signalPtr_(nullptr),
      isAllocatedBasis_(false),
      isAllocatedRGrid_(false),
      hasData_(false),
      isSymmetric_(false)
   {
      signalPtr_ = new Signal<void>();
   }
 
   /*
   * Destructor.
   */
   template <int D, class RFT, class FIT>
   MaskTmpl<D,RFT,FIT>::~MaskTmpl()
   {
      delete signalPtr_;
   }
 
   /*
   * Create an association with a FieldIo object.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::setFieldIo(FIT const & fieldIo)
   {  fieldIoPtr_ = &fieldIo; }
 
   /*
   * Set the unit cell that is modified by reading a field file.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::setReadUnitCell(UnitCell<D>& cell)
   {
      UTIL_CHECK(!readUnitCellPtr_);
      readUnitCellPtr_ = &cell;
   }
 
   /*
   * Set the unit cell that whose parameters are written to a field header.
   */
   template <int D, class RFT, class FIT>
   void 
   MaskTmpl<D,RFT,FIT>::setWriteUnitCell(UnitCell<D> const & cell)
   {
      UTIL_CHECK(!writeUnitCellPtr_);
      writeUnitCellPtr_ = &cell;
   }
 
   /*
   * Allocate memory for a field in basis format.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::allocateBasis(int nBasis)
   {
      UTIL_CHECK(!isAllocatedBasis_);
 
      // Set basis dimensions
      nBasis_ = nBasis;
  
      // Allocate field array, basis format 
      basis_.allocate(nBasis);
      isAllocatedBasis_ = true;
   }
 
   /*
   * Allocate memory for field in basis format.
   */
   template <int D, class RFT, class FIT>
   void 
   MaskTmpl<D,RFT,FIT>::allocateRGrid(IntVec<D> const & meshDimensions)
   {
      UTIL_CHECK(!isAllocatedRGrid_);
 
      // Set mesh dimensions
      meshDimensions_ = meshDimensions;
      meshSize_ = 1;
      for (int i = 0; i < D; ++i) {
         UTIL_CHECK(meshDimensions[i] > 0);
         meshSize_ *= meshDimensions[i];
      }
  
      // Allocate field array, rgrid format
      rgrid_.allocate(meshDimensions);
      isAllocatedRGrid_ = true;
   }
 
   /*
   * Set new field values, in basis form.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::setBasis(DArray<double> const & field)
   {
      // Allocate fields as needed
      if (!isAllocatedRGrid_) {
         Mesh<D> const & mesh = fieldIo().mesh();
         UTIL_CHECK(mesh.size() > 0);
         allocateRGrid(mesh.dimensions());
      }
      if (!isAllocatedBasis_) {
         Basis<D> const & basis = fieldIo().basis();
         UTIL_CHECK(basis.isInitialized());
         allocateBasis(basis.nBasis());
      }
      UTIL_CHECK(isAllocatedRGrid_);
      UTIL_CHECK(isAllocatedBasis_);
 
      // Set components in basis form (array basis_)
      UTIL_CHECK(field.capacity() == nBasis_);
      for (int j = 0; j < nBasis_; ++j) {
         basis_[j] = field[j];
      }
 
      // Convert to r-grid form (update array rgrid_)
      fieldIo().convertBasisToRGrid(basis_, rgrid_);
 
      hasData_ = true;
      isSymmetric_ = true;
 
      // Notify observers of field modification
      signal().notify();
   }
 
   /*
   * Set new field values, in r-grid form.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::setRGrid(RFT const & field,
                                             bool isSymmetric)
   {
      // Allocate rgrid_ field as needed
      if (!isAllocatedRGrid_) {
         Mesh<D> const & mesh = fieldIo().mesh();
         allocateRGrid(mesh.dimensions());
      }
      UTIL_CHECK(isAllocatedRGrid_);
   
      // Copy input field data to member variable rgrid_
      rgrid_ = field; // deep copy by assignment operator
 
      // Optionally convert to basis form
      if (isSymmetric) {
         if (!isAllocatedBasis_) {
            Basis<D> const & basis = fieldIo().basis();
            UTIL_CHECK(basis.isInitialized());
            allocateBasis(basis.nBasis());
         }
         UTIL_CHECK(isAllocatedBasis_);
         fieldIo().convertRGridToBasis(rgrid_, basis_);
      }
 
      hasData_ = true;
      isSymmetric_ = isSymmetric;
 
      // Notify observers of field modification
      signal().notify();
   }
 
   /*
   * Read field from an input stream in basis format.
   *
   * This function also computes and stores the corresponding r-grid
   * representation. On return, hasData and isSymmetric are both true.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::readBasis(std::istream& in)
   {
      // Preconditions
      UTIL_CHECK(readUnitCellPtr_);
 
      // Read field file header
      int nMonomerIn;
      bool isSymmetricIn;
      fieldIo().readFieldHeader(in, nMonomerIn, *readUnitCellPtr_, 
                                isSymmetricIn);
      UTIL_CHECK(1 == nMonomerIn);
      UTIL_CHECK(isSymmetricIn);
      UTIL_CHECK(fieldIo().basis().isInitialized());
      // Note: FIT::readFieldHeader will initialize basis if needed
      int nBasisIn = readNBasis(in);
 
      // Local references to mesh and basis
      Mesh<D> const & mesh = fieldIo().mesh();
      Basis<D> const & basis = fieldIo().basis();
      UTIL_CHECK(mesh.size() > 0);
      UTIL_CHECK(basis.isInitialized());
 
      // If necessary, allocate fields
      if (!isAllocatedRGrid_) {
         allocateRGrid(mesh.dimensions());
      }
      if (!isAllocatedBasis_) {
         allocateBasis(basis.nBasis());
      }
      UTIL_CHECK(isAllocatedRGrid_);
      UTIL_CHECK(isAllocatedBasis_);
 
      // Read field data in basis form (array basis_)
      Prdc::readBasisData(in, basis_, *readUnitCellPtr_, 
                          mesh, basis, nBasisIn);
 
      // Convert r-grid form (array rgrid_)
      fieldIo().convertBasisToRGrid(basis_, rgrid_);
 
      hasData_ = true;
      isSymmetric_ = true;
 
      // Notify observers of field modification
      signal().notify();
   }
 
   /*
   * Read field components from a file basis format, by filename.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::readBasis(std::string filename)
   {
      std::ifstream file;
      fieldIo().fileMaster().openInputFile(filename, file);
      readBasis(file);
      file.close();
   }
 
   /*
   * Reads field from an input stream in r-grid format.
   *
   * If the isSymmetric parameter is true, this function assumes that 
   * the field is known to be symmetric and so computes and stores
   * the corresponding basis format. If isSymmetric is false, it
   * only sets the values in the r-grid format.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::readRGrid(std::istream& in, 
                                              bool isSymmetric)
   {
      // Preconditions
      UTIL_CHECK(readUnitCellPtr_);
 
      // If necessary, allocate rgrid_ fields
      if (!isAllocatedRGrid_) {
         Mesh<D> const & mesh = fieldIo().mesh();
         UTIL_CHECK(mesh.size() > 0);
         allocateRGrid(mesh.dimensions());
      }
      UTIL_CHECK(isAllocatedRGrid_);
  
      // Read field file in r-grid format (array rgrid_)
      fieldIo().readFieldRGrid(in, rgrid_, *readUnitCellPtr_);
 
      // Optionally convert to basis form
      if (isSymmetric) {
         if (!isAllocatedBasis_) {
            Basis<D> const & basis = fieldIo().basis();
            UTIL_CHECK(basis.isInitialized());
            allocateBasis(basis.nBasis());
         }
         fieldIo().convertRGridToBasis(rgrid_, basis_);
      }
 
      hasData_ = true;
      isSymmetric_ = isSymmetric;
 
      // Notify observers of field modification
      signal().notify();
   }
 
   /*
   * Read field from a file in r-grid format, by filename.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::readRGrid(std::string filename, 
                                              bool isSymmetric)
   {
      std::ifstream file;
      fieldIo().fileMaster().openInputFile(filename, file);
      readRGrid(file, isSymmetric);
      file.close();
   }
 
   /*
   * Return volume fraction of the unit cell occupied by the 
   * polymers/solvents.
   */
   template <int D, class RFT, class FIT>
   double MaskTmpl<D,RFT,FIT>::phiTot() const
   {
      if (isSymmetric() && hasData()) {
         // Data in basis format is available
         return basis()[0];
      } else if (!hasData()) {
         // system does not have a mask
         return 1.0;
      } else { // Data is only available in r-grid format
         return rGridAverage();
      }
   }
 
   // Field output to file
 
   /*
   * Write fields to an output stream in basis format.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::writeBasis(std::ostream& out) const
   {
      // Preconditions
      UTIL_CHECK(fieldIoPtr_);
      UTIL_CHECK(writeUnitCellPtr_);
      UTIL_CHECK(isAllocatedBasis_);
      UTIL_CHECK(hasData_);
      UTIL_CHECK(isSymmetric_);
 
      fieldIo().writeFieldBasis(out, basis_, *writeUnitCellPtr_);
   }
 
   /*
   * Write fields to a file in basis format, by filename.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::writeBasis(std::string filename) const
   {
      std::ofstream file;
      fieldIo().fileMaster().openOutputFile(filename, file);
      writeBasis(file);
      file.close();
   }
 
   /*
   * Write fields to an output stream in real-space (r-grid) format.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::writeRGrid(std::ostream& out) const
   {
      // Preconditions
      UTIL_CHECK(writeUnitCellPtr_);
      UTIL_CHECK(fieldIoPtr_);
      UTIL_CHECK(isAllocatedRGrid_);
      UTIL_CHECK(hasData_);
 
      fieldIo().writeFieldRGrid(out, rgrid_,
                                *writeUnitCellPtr_,
                                isSymmetric_);
   }
 
   /*
   * Write fields to a file in r-grid format, by filename.
   */
   template <int D, class RFT, class FIT>
   void MaskTmpl<D,RFT,FIT>::writeRGrid(std::string filename) const
   {
      std::ofstream file;
      fieldIo().fileMaster().openOutputFile(filename, file);
      writeRGrid(file);
      file.close();
   }
 
   // Signal accessor
 
   /*
   * Get a signal that is triggered by field modification.
   */
   template <int D, class RFT, class FIT>
   Signal<void>& MaskTmpl<D,RFT,FIT>::signal()
   {
      UTIL_CHECK(signalPtr_);
      return *signalPtr_;
   }
 
} // namespace Prdc
} // namespace Pscf
#endif