Package etomica.integrator.mcmove

Class MCMoveVolumeExchange

java.lang.Object

etomica.integrator.mcmove.MCMove

etomica.integrator.mcmove.MCMoveStep

etomica.integrator.mcmove.MCMoveVolumeExchange

All Implemented Interfaces:

MCMoveStepDependent

Direct Known Subclasses:

MCMoveVolumeExchangeVLE

public class MCMoveVolumeExchange
extends MCMoveStep

Elementary Monte Carlo trial that exchanges volume between two boxes. Trial consists of a volume increase in one box (selected at random) and an equal volume decrease in the other. Used in Gibbs ensemble simulations.

Field Summary

Fields

Modifier and Type	Field	Description
protected Box	firstBox
protected Box	secondBox

Fields inherited from class etomica.integrator.mcmove.MCMove

moveTracker, nominalFrequency, potential

Fields inherited from class etomica.integrator.mcmove.MCMoveStep

stepSize, stepSizeMax, stepSizeMin

Constructor Summary

Constructors

Constructor	Description
MCMoveVolumeExchange(PotentialMaster potentialMaster, IRandom random, Space space, IntegratorBox integrator1, IntegratorBox integrator2)

Method Summary

Modifier and Type	Method	Description
void	acceptNotify()	Method called by IntegratorMC in the event that the most recent trial is accepted.
AtomIterator	affectedAtoms(Box box)	Returns an iterator that yields the atoms that were affected by the trial move the last time doTrial was invoked (regardless of whether the move was accepted).
boolean	doTrial()	Method to perform trial move.
double	energyChange(Box box)	Returns the change in the energy of the given box that results from the trial move.
double	getChi(double temperature)	Chi is the parameter within standard Metropolis Monte Carlo.
void	rejectNotify()	Method called by IntegratorMC in the event that the most recent trial move is rejected.

Methods inherited from class etomica.integrator.mcmove.MCMove

getNominalFrequency, getTracker, setTracker, toString

Methods inherited from class etomica.integrator.mcmove.MCMoveStep

getStepSize, getStepSizeDimension, getStepSizeMax, getStepSizeMaxDimension, getStepSizeMin, getStepSizeMinDimension, setStepSize, setStepSizeMax, setStepSizeMin

Methods inherited from class java.lang.Object

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

Field Detail

firstBox

protected final Box firstBox

secondBox

protected final Box secondBox

Constructor Detail

MCMoveVolumeExchange

public MCMoveVolumeExchange(PotentialMaster potentialMaster,
                            IRandom random,
                            Space space,
                            IntegratorBox integrator1,
                            IntegratorBox integrator2)

Method Detail

doTrial

public boolean doTrial()

Description copied from class: MCMove

Method to perform trial move. Returns false if the trial could not be attempted, for example if there were no molecules in the box and the trial is designed to displace an atom; returns true otherwise.

Specified by:

doTrial in class MCMove

getChi

public double getChi(double temperature)

Description copied from class: MCMove

Chi is the parameter within standard Metropolis Monte Carlo. The probability of accepting the move is given by min(1,chi).

Specified by:

getChi in class MCMove

Parameters:

temperature - used to compute chi

Returns:

chi

acceptNotify

public void acceptNotify()

Description copied from class: MCMove

Method called by IntegratorMC in the event that the most recent trial is accepted.

Specified by:

acceptNotify in class MCMove

rejectNotify

public void rejectNotify()

Description copied from class: MCMove

Method called by IntegratorMC in the event that the most recent trial move is rejected. This method should cause the system to be restored to the condition before the most recent call to doTrial.

Specified by:

rejectNotify in class MCMove

energyChange

public double energyChange(Box box)

Description copied from class: MCMove

Returns the change in the energy of the given box that results from the trial move. Should be called only after lnProbabilityRatio(); returns Double.NaN if invoked between calls to doTrial and lnProbabilityRatio.

Specified by:

energyChange in class MCMove

affectedAtoms

public final AtomIterator affectedAtoms(Box box)

Description copied from class: MCMove

Returns an iterator that yields the atoms that were affected by the trial move the last time doTrial was invoked (regardless of whether the move was accepted). This information usually is not needed, but it is available in cases where required by objects that perform some activity while the move is in progress, or need to update after the move is completed. Such objects can receive notification of the move's completion by registering with the IntegratorMC as MCMoveEventListeners. If the move caused an atom to be removed from the box, it will not be returned because that Atom is not considered an affected Atom.

Specified by:

affectedAtoms in class MCMove