seams-core v2.14.0
libyodaLib, the C++ engine of d-SEAMS
Loading...
Searching...
No Matches
primitive::RingUpdater Class Reference

Exact frame-to-frame maintenance of the primitive ring network. More...

#include <src/include/internal/franzblau.hpp>

Public Member Functions

 RingUpdater (int maxDepth)
 ~RingUpdater ()
 RingUpdater (RingUpdater &&) noexcept
RingUpdater & operator= (RingUpdater &&) noexcept
 RingUpdater (const RingUpdater &)=delete
RingUpdater & operator= (const RingUpdater &)=delete
const std::vector< std::vector< int > > & update (const std::vector< std::vector< int > > &nList)
int lastRecomputedSources () const
int lastBallsRefreshed () const
 Vertices whose bounded balls were rebuilt on the last update.
int lastChangedBonds () const
double lastChangedBondFraction () const
 Changed bonds per molecule on the last update.
void setFullPassFraction (double fraction)
void setBondCrossover (double changedBondsPerMolecule)

Detailed Description

Exact frame-to-frame maintenance of the primitive ring network.

Consecutive trajectory frames share almost all of their bond topology. A ring of at most maxDepth members can appear or vanish between frames only if it passes within (maxDepth/2 - 2)/2 bonds of a vertex whose neighbour row changed, which is on the ring itself up to maxDepth

  1. On a new frame the stored rings that meet that set are dropped and the rings through it are enumerated afresh. The output equals ringNetwork element by element, at a cost that scales with the number of changed rows rather than with system size.

Definition at line 226 of file franzblau.hpp.

Constructor & Destructor Documentation

◆ RingUpdater() [1/3]

primitive::RingUpdater::RingUpdater ( int maxDepth)
explicit

◆ ~RingUpdater()

primitive::RingUpdater::~RingUpdater ( )

◆ RingUpdater() [2/3]

primitive::RingUpdater::RingUpdater ( RingUpdater && )
noexcept

◆ RingUpdater() [3/3]

primitive::RingUpdater::RingUpdater ( const RingUpdater & )
delete

Member Function Documentation

◆ lastBallsRefreshed()

int primitive::RingUpdater::lastBallsRefreshed ( ) const
nodiscard

Vertices whose bounded balls were rebuilt on the last update.

◆ lastChangedBondFraction()

double primitive::RingUpdater::lastChangedBondFraction ( ) const
nodiscard

Changed bonds per molecule on the last update.

◆ lastChangedBonds()

int primitive::RingUpdater::lastChangedBonds ( ) const
nodiscard

Undirected bonds whose endpoints differ from the previous frame. Zero on the first frame and when the bond set is unchanged. The fraction below is this count divided by the molecule count, maintained while the rows are compared and readable in constant time afterwards.

◆ lastRecomputedSources()

int primitive::RingUpdater::lastRecomputedSources ( ) const
nodiscard

Vertices the last update enumerated rings through; the full vertex count on a whole-frame pass, zero when nothing changed

◆ operator=() [1/2]

RingUpdater & primitive::RingUpdater::operator= ( const RingUpdater & )
delete

◆ operator=() [2/2]

RingUpdater & primitive::RingUpdater::operator= ( RingUpdater && )
noexcept

◆ setBondCrossover()

void primitive::RingUpdater::setBondCrossover ( double changedBondsPerMolecule)

Kept for callers that used to force a whole-frame pass from the changed-bond rate. The default is negative. The rate does not replace the search of T.

◆ setFullPassFraction()

void primitive::RingUpdater::setFullPassFraction ( double fraction)

Kept for callers that used to force a whole-frame pass. The update enumerates the sources in T and no others, so a whole-frame pass happens only when T is every vertex. The stored fraction does not replace that search. The result equals a rebuild at every fraction.

◆ update()

const std::vector< std::vector< int > > & primitive::RingUpdater::update ( const std::vector< std::vector< int > > & nList)

Primitive rings for this frame's neighbour list (row-ordered, by index, first element of each row the vertex itself)


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