SpECTRE  2021.08.02
Public Types | Public Member Functions | List of all members
Cce::InterfaceManagers::GhInterfaceManager Class Referenceabstract

Abstract base class for storage and retrieval of generalized harmonic quantities communicated from a Cauchy simulation to the Cce system. More...

#include <GhInterfaceManager.hpp>

Public Types

using gh_variables = Variables< tmpl::list< gr::Tags::SpacetimeMetric< 3, ::Frame::Inertial, DataVector >, GeneralizedHarmonic::Tags::Pi< 3, ::Frame::Inertial >, GeneralizedHarmonic::Tags::Phi< 3, ::Frame::Inertial > > >
 
using creatable_classes = tmpl::list< GhLocalTimeStepping, GhLockstep >
 

Public Member Functions

 WRAPPED_PUPable_abstract (GhInterfaceManager)
 
virtual std::unique_ptr< GhInterfaceManager > get_clone () const noexcept=0
 
virtual void insert_gh_data (TimeStepId time_id, const tnsr::aa< DataVector, 3 > &spacetime_metric, const tnsr::iaa< DataVector, 3 > &phi, const tnsr::aa< DataVector, 3 > &pi, const tnsr::aa< DataVector, 3 > &dt_spacetime_metric, const tnsr::iaa< DataVector, 3 > &dt_phi, const tnsr::aa< DataVector, 3 > &dt_pi) noexcept=0
 
virtual void insert_next_gh_time (TimeStepId time_id, TimeStepId next_time_id) noexcept=0
 
virtual void request_gh_data (const TimeStepId &) noexcept=0
 
virtual auto retrieve_and_remove_first_ready_gh_data () noexcept -> std::optional< std::tuple< TimeStepId, gh_variables > >=0
 
virtual size_t number_of_pending_requests () const noexcept=0
 
virtual size_t number_of_gh_times () const noexcept=0
 
virtual InterpolationStrategy get_interpolation_strategy () const noexcept=0
 

Detailed Description

Abstract base class for storage and retrieval of generalized harmonic quantities communicated from a Cauchy simulation to the Cce system.

Details

The functions that are required to be overriden in the derived classes are:

  • GhInterfaceManager::get_clone(): should return a std::unique_ptr<GhInterfaceManager> with cloned state.
  • GhInterfaceManager::insert_gh_data(): should store the portions of the provided generalized harmonic data that are required to provide useful boundary values for the CCE evolution at requested timesteps.
  • GhInterfaceManager::request_gh_data(): should register requests from the CCE evolution for boundary data.
  • GhInterfaceManager::retrieve_and_remove_first_ready_gh_data(): should return a std::optional<std::tuple<TimeStepId, tnsr::aa<DataVector, 3>, tnsr::iaa<DataVector, 3>, tnsr::aa<DataVector, 3>>> containing the boundary data associated with the oldest requested timestep if enough data has been supplied via insert_gh_data() to determine the boundary data. Otherwise, return a std::nullopt to indicate that the CCE system must continue waiting for generalized harmonic input.
  • GhInterfaceManager::number_of_pending_requests(): should return the number of requests that have been registered to the class that do not yet been retrieved via retrieve_and_remove_first_ready_gh_data().
  • GhInterfaceManager::number_of_gh_times(): should return the number of time steps sent to insert_gh_data() that have not yet been retrieved via retrieve_and_remove_first_ready_gh_data().

Member Function Documentation

◆ insert_gh_data()

virtual void Cce::InterfaceManagers::GhInterfaceManager::insert_gh_data ( TimeStepId  time_id,
const tnsr::aa< DataVector, 3 > &  spacetime_metric,
const tnsr::iaa< DataVector, 3 > &  phi,
const tnsr::aa< DataVector, 3 > &  pi,
const tnsr::aa< DataVector, 3 > &  dt_spacetime_metric,
const tnsr::iaa< DataVector, 3 > &  dt_phi,
const tnsr::aa< DataVector, 3 > &  dt_pi 
)
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLocalTimeStepping, and Cce::InterfaceManagers::GhLockstep.

◆ insert_next_gh_time()

virtual void Cce::InterfaceManagers::GhInterfaceManager::insert_next_gh_time ( TimeStepId  time_id,
TimeStepId  next_time_id 
)
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLockstep.

◆ number_of_gh_times()

virtual size_t Cce::InterfaceManagers::GhInterfaceManager::number_of_gh_times ( ) const
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLocalTimeStepping, and Cce::InterfaceManagers::GhLockstep.

◆ number_of_pending_requests()

virtual size_t Cce::InterfaceManagers::GhInterfaceManager::number_of_pending_requests ( ) const
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLocalTimeStepping, and Cce::InterfaceManagers::GhLockstep.

◆ request_gh_data()

virtual void Cce::InterfaceManagers::GhInterfaceManager::request_gh_data ( const TimeStepId &  )
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLockstep, and Cce::InterfaceManagers::GhLocalTimeStepping.

◆ retrieve_and_remove_first_ready_gh_data()

virtual auto Cce::InterfaceManagers::GhInterfaceManager::retrieve_and_remove_first_ready_gh_data ( ) -> std::optional< std::tuple< TimeStepId, gh_variables > >
pure virtualnoexcept

Implemented in Cce::InterfaceManagers::GhLocalTimeStepping, and Cce::InterfaceManagers::GhLockstep.