BioSimSpace.Protocol.FreeEnergy

class BioSimSpace.Protocol.FreeEnergy(lam=0.0, lam_vals=None, min_lam=0.0, max_lam=1.0, num_lam=11, timestep=2.0000 fs, runtime=1.0000 ns, temperature=300.0000 K, pressure=1.0000 atm, report_interval=100, restart_interval=500)

A class for storing free energy protocols.

__init__(lam=0.0, lam_vals=None, min_lam=0.0, max_lam=1.0, num_lam=11, timestep=2.0000 fs, runtime=1.0000 ns, temperature=300.0000 K, pressure=1.0000 atm, report_interval=100, restart_interval=500)

Constructor.

Parameters
  • lam (float) – The perturbation parameter: [0.0, 1.0]

  • lam_vals ([float]) – The list of lambda parameters.

  • min_lam (float) – The minimum lambda value.

  • max_lam (float) – The maximum lambda value.

  • num_lam (int) – The number of lambda values.

  • timestep (Time) – The integration timestep.

  • runtime (Time) – The running time.

  • temperature (Temperature) – The temperature.

  • pressure (Pressure) – The pressure. Pass pressure=None to use the NVT ensemble.

  • report_interval (int) – The frequency at which statistics are recorded. (In integration steps.)

  • restart_interval (int) – The frequency at which restart configurations and trajectory

Methods

__init__([lam, lam_vals, min_lam, max_lam, …])

Constructor.

getLambda()

Get the value of the perturbation parameter.

getLambdaValues()

Get the list of lambda values.

getPressure()

Return the pressure.

getReportInterval()

Return the interval between reporting statistics.

getRestartInterval()

Return the interval between saving restart confiugrations, and/or trajectory frames.

getRunTime()

Return the running time.

getTemperature()

Return temperature.

getTimeStep()

Return the time step.

setLambdaValues(lam[, lam_vals, min_lam, …])

Set the list of lambda values.

setPressure(pressure)

Set the pressure.

setReportInterval(report_interval)

Set the interval at which statistics are reported.

setRestartInterval(restart_interval)

Set the interval between saving restart confiugrations, and/or trajectory frames.

setRunTime(runtime)

Set the running time.

setTemperature(temperature)

Set the temperature.

setTimeStep(timestep)

Set the time step.

getLambda()

Get the value of the perturbation parameter.

Returns

lam – The value of the perturbation parameter.

Return type

float

getLambdaValues()

Get the list of lambda values.

Returns

lam_vals – The list of lambda values.

Return type

[float]

getPressure()

Return the pressure.

Returns

pressure – The pressure.

Return type

Pressure

getReportInterval()

Return the interval between reporting statistics. (In integration steps.)

Returns

report_interval – The number of integration steps between reporting statistics.

Return type

int

getRestartInterval()

Return the interval between saving restart confiugrations, and/or trajectory frames. (In integration steps.)

Returns

restart_interval – The number of integration steps between saving restart configurations and/or trajectory frames.

Return type

int

getRunTime()

Return the running time.

Returns

runtime – The simulation run time.

Return type

Time

getTemperature()

Return temperature.

Returns

temperature – The simulation temperature.

Return type

Temperature

getTimeStep()

Return the time step.

Returns

timestep – The integration time step.

Return type

Time

setLambdaValues(lam, lam_vals=None, min_lam=None, max_lam=None, num_lam=None)

Set the list of lambda values.

Parameters
  • lam (float) – The perturbation parameter: [0.0, 1.0]

  • lam_vals ([float]) – A list of lambda values.

  • min_lam (float) – The minimum lambda value.

  • max_lam (float) – The maximum lambda value.

  • num_lam (int) – The number of lambda values.

setPressure(pressure)

Set the pressure.

Parameters

pressure (Pressure) – The pressure.

setReportInterval(report_interval)

Set the interval at which statistics are reported. (In integration steps.)

Parameters

report_interval (int) – The number of integration steps between reporting statistics.

setRestartInterval(restart_interval)

Set the interval between saving restart confiugrations, and/or trajectory frames. (In integration steps.)

Parameters

restart_interval (int) – The number of integration steps between saving restart configurations and/or trajectory frames.

setRunTime(runtime)

Set the running time.

Parameters

runtime (Time) – The simulation run time.

setTemperature(temperature)

Set the temperature.

Parameters

temperature (Temperature) – The simulation temperature.

setTimeStep(timestep)

Set the time step.

Parameters

timestep (Time) – The integration time step.