cuda/RField.h

#ifndef PRDC_CUDA_R_FIELD_H
#define PRDC_CUDA_R_FIELD_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 <pscf/cuda/DeviceArray.h>    // base class template
#include <pscf/cuda/cudaTypes.h>      // base class argument
#include <pscf/math/IntVec.h>         // member
 
#include <pscf/cuda/HostDArray.h>     
#include <util/global.h>
 
namespace Pscf {
namespace Prdc {
namespace Cuda {
 
   using namespace Util;

   template <int D>
   class RField : public DeviceArray<cudaReal>
   {
 
   public:

      RField();

      RField(IntVec<D> const & meshDimensions);

      RField(RField<D> const& other);

      virtual ~RField();

      void allocate(IntVec<D> const & meshDimensions);

      void associate(DeviceArray<cudaReal>& arr, int beginId, 
                     IntVec<D> const & meshDimensions);

      RField<D>& operator = (const RField<D>& other);

      RField<D>& operator = (const HostDArray<cudaReal>& other);

      IntVec<D> const & meshDimensions() const;

      template <class Archive>
      void serialize(Archive& ar, const unsigned int version);
 
   private:
 
      // Vector containing number of grid points in each direction.
      IntVec<D> meshDimensions_;
 
      // Make private to prevent allocation without mesh dimensions.
      using DeviceArray<cudaReal>::allocate;
 
      // Make private to prevent association without mesh dimensions.
      using DeviceArray<cudaReal>::associate;
 
      // Make private to prevent assignment without mesh dimensions.
      using DeviceArray<cudaReal>::operator=;
 
   };
 
   /*
   * Return mesh dimensions by constant reference.
   */
   template <int D>
   inline const IntVec<D>& RField<D>::meshDimensions() const
   {  return meshDimensions_; }
 
   /*
   * Serialize a Field to/from an Archive.
   */
   template <int D>
   template <class Archive>
   void RField<D>::serialize(Archive& ar, const unsigned int version)
   {
      int capacity;
      if (Archive::is_saving()) {
         capacity = capacity_;
      }
      ar & capacity;
      if (Archive::is_loading()) {
         if (!isAllocated()) {
            if (capacity > 0) {
               allocate(capacity);
            }
         } else {
            if (capacity != capacity_) {
               UTIL_THROW("Inconsistent Field capacities");
            }
         }
      }
 
      if (isAllocated()) {
         HostDArray<cudaReal> tempData(capacity);
         tempData = this; // copy this object's data from device to host
         for (int i = 0; i < capacity_; ++i) {
            ar & tempData[i];
         }
      }
      ar & meshDimensions_;
   }
 
   #ifndef PRDC_CUDA_R_FIELD_TPP
   extern template class RField<1>;
   extern template class RField<2>;
   extern template class RField<3>;
   #endif
 
}
}
}
#endif