etomica.nbr.site
Class Api1ASite

java.lang.Object
  etomica.nbr.site.Api1ASite

All Implemented Interfaces:

AtomLeafsetIterator, AtomsetIterator, AtomsetIteratorBoxDependent, AtomsetIteratorDirectable, AtomsetIteratorPDT, AtomsetIteratorTargetable, Serializable

public class Api1ASite
extends Object
implements AtomsetIteratorPDT, Serializable

Iteration is performed using site lists. Direction is related to ordering of sites.

See Also:

Serialized Form

Field Summary

protected boolean[]

periodicity

Constructor Summary

Api1ASite(int D, BoxAgentManager agentManager)
Constructor makes iterator that must have box specified and then be reset() before iteration.

Method Summary

int	nBody() Returns 2, indicating that this is a pair iterator.
IAtomList	next() Returns the next AtomSet iterate, or null if hasNext() is false.
void	reset() Resets the iterator to loop through its iterates again.
void	setBox(IBox box) Sets the Box to pull iterates from
void	setDirection(IteratorDirective.Direction direction) Indicates allowed direction for iteration, relative to specified target atom.
void	setTarget(IAtom newTargetAtom) Sets the target molecule with which all pairs are formed.
int	size() Returns the number of atom pairs the iterator will return if reset and iterated in its present state.
void	unset() Puts iterator in a state in which hasNext() returns false.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

periodicity

protected final boolean[] periodicity

Constructor Detail

Api1ASite

public Api1ASite(int D,
                 BoxAgentManager agentManager)

Constructor makes iterator that must have box specified and then be reset() before iteration.

Parameters:

D - the dimension of the space of the simulation (used to construct cell iterators)

species - length = 2 array with the (different) species whose molecules are interacting

Method Detail

setBox

public void setBox(IBox box)

Description copied from interface: AtomsetIteratorBoxDependent

Sets the Box to pull iterates from

Specified by:

setBox in interface AtomsetIteratorBoxDependent

size

public int size()

Returns the number of atom pairs the iterator will return if reset and iterated in its present state.

Specified by:

size in interface AtomsetIterator

next

public IAtomList next()

Description copied from interface: AtomLeafsetIterator

Returns the next AtomSet iterate, or null if hasNext() is false.

Specified by:

next in interface AtomLeafsetIterator

unset

public void unset()

Description copied from interface: AtomsetIterator

Puts iterator in a state in which hasNext() returns false.

Specified by:

unset in interface AtomsetIterator

nBody

public int nBody()

Returns 2, indicating that this is a pair iterator.

Specified by:

nBody in interface AtomsetIterator

Returns:

reset

public void reset()

Description copied from interface: AtomsetIterator

Resets the iterator to loop through its iterates again.

Specified by:

reset in interface AtomsetIterator

setDirection

public void setDirection(IteratorDirective.Direction direction)

Indicates allowed direction for iteration, relative to specified target atom. Specification of a null direction indicates iteration in both directions relative to the target. Direction is determined by ordering within occupant list of cell of target atom, and then by the cell ordering of neighboring cells.

Specified by:

setDirection in interface AtomsetIteratorDirectable

setTarget

public void setTarget(IAtom newTargetAtom)

Sets the target molecule with which all pairs are formed. Molecule is determined from the first atom of the array, which may be the molecule itself or an atom that is part of it. If the atom is null or is not in one of the species given at construction, no iterates will be returned.

Specified by:

setTarget in interface AtomsetIteratorTargetable