Pscf::PropagatorTmpl< TP > Class Template Reference

Template for propagator classes. More...

#include <PropagatorTmpl.h>

Public Member Functions
	PropagatorTmpl ()
	Constructor.
Mutators
void	setDirectionId (int directionId)
	Associate this propagator with a direction index.
void	setPartner (const TP &partner)
	Set the partner of this propagator.
void	addSource (const TP &source)
	Add a propagator to the list of sources for this one.
void	setIsSolved (bool isSolved)
	Set the isSolved flag to true or false.
Accessors
const TP &	source (int id) const
	Get a source propagator.
const TP &	partner () const
	Get partner propagator.
int	directionId () const
	Get direction index for this propagator.
int	nSource () const
	Number of source / prerequisite propagators.
bool	hasPartner () const
	Does this have a partner propagator?
bool	isSolved () const
	Has the modified diffusion equation been solved?
bool	isReady () const
	Are all source propagators solved?

Detailed Description

template<class TP>
class Pscf::PropagatorTmpl< TP >

Template for propagator classes.

The template argument TP should be a concrete propagator class that is derived from the template PropagatorTmpl<TP>. By convention, each implementation of SCFT is defined in a different sub-namespace of namespace Pscf. For each such implementation, there is a concrete propagator class, named Propagator by convention, that is a subclass of the template instance PropagatorTmpl<Propagator>, using the syntax shown below:

class Propagator : public PropagatorTmpl<Propagator>
{
 ...
}; 

This usage is an example of the so-called "curiously recurring template pattern" (CRTP). It is used here to allow the template PropagatorTmpl<Propagator> to have a member variables that store pointers to other instances of derived class Propagator (or TP).

The concrete Propagator class is used in templates BlockTmpl, PolymerTmpl and SystemTmpl. The usage in those templates require that this class define typedefs named WField and CField and member functions named solve() and computeQ(), neither of which takes any arguments.

The typedefs WField and CField must be aliases for a type container used represent chemical potential and concentration fields, respectively.

The function void solve() must solve the modified diffusion equation for this propapagator, using information that is accessible to the concrete propagator class. Upon return, the solution must be stored in internal data structures that store the propagator field at different values of a contour variable, and the function isSolved() must return true.

The function computeQ() must compute and return the molecular partition function Q using information available to this propagator. An example of the required interface is shown below:

class Propagator : public PropagatorTmpl<Propagator> 
{
public:
 
    // Chemical potential field type.
    typedef DArray<double> WField;
 
    // Monomer concentration field type.
    typedef DArray<double> CField;
 
    // Solve the modified diffusion equation for this direction.
    void solve();
 
    // Compute and return the molecular partition function Q.
    double computeQ();
 
};

In the above example, the field container typenames WField and CField are defined to be synonyms for DArrray<double>, i.e., for dynamically allocated arrays of double precision floating point numbers. Other implementations may use more specialized types.

Definition at line 92 of file PropagatorTmpl.h.

Constructor & Destructor Documentation

PropagatorTmpl()

template<class TP >

Pscf::PropagatorTmpl< TP >::PropagatorTmpl

(

)

Constructor.

Definition at line 242 of file PropagatorTmpl.h.

Member Function Documentation

setDirectionId()

template<class TP >

void Pscf::PropagatorTmpl< TP >::setDirectionId

(

int

directionId

)

Associate this propagator with a direction index.

Parameters

directionId

direction = 0 or 1.

Definition at line 253 of file PropagatorTmpl.h.

setPartner()

template<class TP >

void Pscf::PropagatorTmpl< TP >::setPartner

(

const TP &

partner

)

Set the partner of this propagator.

The partner of a propagator is the propagator for the same block that propagates in the opposite direction.

Parameters

partner

reference to partner propagator

Definition at line 260 of file PropagatorTmpl.h.

addSource()

template<class TP >

void Pscf::PropagatorTmpl< TP >::addSource

(

const TP &

source

)

Add a propagator to the list of sources for this one.

A source is a propagator that terminates at the root vertex of this one and is needed to compute the initial condition for this one, and that thus must be computed before this.

Parameters

source

reference to source propagator

Definition at line 267 of file PropagatorTmpl.h.

setIsSolved()

template<class TP >

void Pscf::PropagatorTmpl< TP >::setIsSolved

(

bool

isSolved

)

Set the isSolved flag to true or false.

Definition at line 285 of file PropagatorTmpl.h.

source()

template<class TP >

const TP & Pscf::PropagatorTmpl< TP >::source ( int id ) const

inline

Get a source propagator.

Parameters

id	index of source propagator, < nSource

Definition at line 218 of file PropagatorTmpl.h.

partner()

template<class TP >

const TP & Pscf::PropagatorTmpl< TP >::partner

(

)

const

Get partner propagator.

Definition at line 274 of file PropagatorTmpl.h.

References UTIL_CHECK.

directionId()

template<class TP >

int Pscf::PropagatorTmpl< TP >::directionId ( ) const

inline

Get direction index for this propagator.

Definition at line 203 of file PropagatorTmpl.h.

nSource()

template<class TP >

int Pscf::PropagatorTmpl< TP >::nSource ( ) const

inline

Number of source / prerequisite propagators.

Definition at line 210 of file PropagatorTmpl.h.

References Util::GArray< Data >::size().

hasPartner()

template<class TP >

bool Pscf::PropagatorTmpl< TP >::hasPartner ( ) const

inline

Does this have a partner propagator?

Definition at line 226 of file PropagatorTmpl.h.

isSolved()

template<class TP >

bool Pscf::PropagatorTmpl< TP >::isSolved ( ) const

inline

Has the modified diffusion equation been solved?

Definition at line 233 of file PropagatorTmpl.h.

isReady()

template<class TP >

bool Pscf::PropagatorTmpl< TP >::isReady

(

)

const

Are all source propagators solved?

Definition at line 292 of file PropagatorTmpl.h.

Referenced by pscfpp.text.FileEditor::__init__(), pscfpp.text.RecordEditor::__init__(), pscfpp.text.FileEditor::editFile(), pscfpp.text.RecordEditor::editFile(), pscfpp.text.FileEditor::editFileBlocks(), pscfpp.text.FileEditor::editFiles(), pscfpp.text.FileEditor::setFilter(), pscfpp.text.RecordEditor::setFilter(), pscfpp.text.FileEditor::setNew(), pscfpp.text.RecordEditor::setNew(), and pscfpp.text.FileEditor::setOld().

---

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

• PropagatorTmpl.h