Cce::InterfaceManagers::GhLockstep Class Reference

Simple implementation of a GhInterfaceManager that only provides boundary data on matching TimeStepIds. More...

#include <GhLockstep.hpp>

Public Types
using	options = tmpl::list<>
using	gh_variables = Variables< tmpl::list< gr::Tags::SpacetimeMetric< DataVector, 3 >, gh::Tags::Pi< DataVector, 3 >, gh::Tags::Phi< DataVector, 3 > > >
Public Types inherited from Cce::InterfaceManagers::GhInterfaceManager
using	gh_variables = Variables< tmpl::list< gr::Tags::SpacetimeMetric< DataVector, 3 >, gh::Tags::Pi< DataVector, 3 >, gh::Tags::Phi< DataVector, 3 > > >

Public Member Functions
	GhLockstep (CkMigrateMessage *)
	WRAPPED_PUPable_decl_template (GhLockstep)
std::unique_ptr< GhInterfaceManager >	get_clone () const override
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)
	Store a provided data set in a std::deque. More...
void	request_gh_data (const TimeStepId &time_id) override
auto	retrieve_and_remove_first_ready_gh_data () -> std::optional< std::tuple< TimeStepId, gh_variables > > override
	Return a std::optional<std::tuple> of the least recently submitted generalized harmonic boundary data if any exists and removes it from the internal std::deque, otherwise returns std::nullopt. More...
size_t	number_of_pending_requests () const override
	This class ignores requests to ensure a one-way communication pattern, so the number of requests is always 0. More...
size_t	number_of_gh_times () const override
	The number of times at which data from a GH evolution have been stored and not yet retrieved. More...
void	pup (PUP::er &p) override
	Serialization for Charm++.
Public Member Functions inherited from Cce::InterfaceManagers::GhInterfaceManager
	WRAPPED_PUPable_abstract (GhInterfaceManager)
virtual std::unique_ptr< GhInterfaceManager >	get_clone () const =0
virtual void	request_gh_data (const TimeStepId &)=0
virtual auto	retrieve_and_remove_first_ready_gh_data () -> std::optional< std::tuple< TimeStepId, gh_variables > >=0
virtual size_t	number_of_pending_requests () const =0
virtual size_t	number_of_gh_times () const =0

Static Public Attributes
static constexpr Options::String	help

Detailed Description

Simple implementation of a GhInterfaceManager that only provides boundary data on matching TimeStepIds.

Details

This version of the interface manager assumes that the CCE system and the generalized harmonic system that it communicates with evolve with an identical time stepper and on identical time step intervals (they evolve in 'lock step'). As a result, and to streamline communications, new data is always immediately 'ready' and requests are ignored to produce the behavior of just immediately gauge-transforming and sending the data to the CCE component as soon as it becomes available from the GH system.

Warning

Using this interface manager when the GH components and the CCE evolution are not identically stepped is considered undefined behavior. For current implementations involving dense output and local time-stepping, this interface manager can only be used during self-start.

Member Function Documentation

get_clone()

std::unique_ptr< GhInterfaceManager > Cce::InterfaceManagers::GhLockstep::get_clone ( ) const

overridevirtual

Implements Cce::InterfaceManagers::GhInterfaceManager.

insert_gh_data()

void Cce::InterfaceManagers::GhLockstep::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
	)

Store a provided data set in a std::deque.

Details

The lock-step constraint ensures that only the generalized harmonic variables spacetime_metric, phi, and pi are used. The remaining variables are accepted to comply with the more general abstract interface.

number_of_gh_times()

size_t Cce::InterfaceManagers::GhLockstep::number_of_gh_times ( ) const

inlineoverridevirtual

The number of times at which data from a GH evolution have been stored and not yet retrieved.

Implements Cce::InterfaceManagers::GhInterfaceManager.

number_of_pending_requests()

size_t Cce::InterfaceManagers::GhLockstep::number_of_pending_requests ( ) const

inlineoverridevirtual

This class ignores requests to ensure a one-way communication pattern, so the number of requests is always 0.

Implements Cce::InterfaceManagers::GhInterfaceManager.

request_gh_data()

void Cce::InterfaceManagers::GhLockstep::request_gh_data ( const TimeStepId &  time_id )

overridevirtual

Implements Cce::InterfaceManagers::GhInterfaceManager.

retrieve_and_remove_first_ready_gh_data()

auto Cce::InterfaceManagers::GhLockstep::retrieve_and_remove_first_ready_gh_data ( ) -> std::optional< std::tuple< TimeStepId, gh_variables > >

overridevirtual

Return a std::optional<std::tuple> of the least recently submitted generalized harmonic boundary data if any exists and removes it from the internal std::deque, otherwise returns std::nullopt.

Implements Cce::InterfaceManagers::GhInterfaceManager.

Member Data Documentation

help

constexpr Options::String Cce::InterfaceManagers::GhLockstep::help

staticconstexpr

Initial value:

{
      "Pass data between GH and CCE systems on matching timesteps only."}

---

The documentation for this class was generated from the following file:

• src/Evolution/Systems/Cce/InterfaceManagers/GhLockstep.hpp