BioSimSpace.Gateway.Temperature#

class BioSimSpace.Gateway.Temperature(help=None, default=None, unit=None, minimum=None, maximum=None, allowed=None)[source]#

A temperature requirement.

Examples

Create a temperature requirement with a default of 300 kelvin.

>>> import BioSimSpace as BSS
>>> my_temperature = BSS.Gateway.Temperature(help="A temperature requirement", default=300, unit="kelvin")

The same, but explicitly passing a Temperature for the default.

>>> import BioSimSpace as BSS
>>> my_temperature = BSS.Gateway.Temperature(help="A temperature requirement", default=300*BSS.Units.Temperature.kelvin)

Create a temperature requirement with a default of 300 Kelvin and a maximum of 100 Celsius. Note that the unit is taken from the default value.

>>> import BioSimSpace as BSS
>>> my_temperature = BSS.Gateway.Temperature(help="A temperature requirement",
...                                          default=300*BSS.Units.Temperature.kelvin,
...                                          maximum=100*BSS.Units.Temperature.celsius)
__init__(help=None, default=None, unit=None, minimum=None, maximum=None, allowed=None)[source]#

Constructor.

Parameters:
  • help (str) – The help string.

  • default (Temperature) – The default value.

  • unit (str) – The unit.

  • minimum (Temperature) – The minimum allowed value.

  • maximum (Temperature) – The maximum allowed value.

  • allowed ([Temperature]) – A list of allowed values.

Methods

__init__([help, default, unit, minimum, ...])

Constructor.

getAllowedValues()

Return the allowed values.

getArgType()

The command-line argument type.

getDefault()

Return the default value.

getHelp()

Return the documentation string.

getMax()

Return the maximum allowed value.

getMin()

Return the minimum allowed value.

getUnit()

Return the unit.

getValue()

Return the value.

isMulti()

Whether the requirement has multiple values.

isOptional()

Whether the requirement is optional.

setValue(value[, name])

Validate and set the value.

getAllowedValues()#

Return the allowed values.

Returns:

allowed – The list of allowed values that the requirement can take.

Return type:

list

getArgType()#

The command-line argument type.

Returns:

arg_type – The command-line argument type.

Return type:

bool, int, float, str

getDefault()#

Return the default value.

getHelp()#

Return the documentation string.

Returns:

help – The help string.

Return type:

str

getMax()#

Return the maximum allowed value.

getMin()#

Return the minimum allowed value.

getUnit()#

Return the unit.

Returns:

unit – The unit associated with the requirement.

Return type:

str

getValue()[source]#

Return the value.

Returns:

value – The value of the requirement.

Return type:

Temperature

isMulti()#

Whether the requirement has multiple values.

Returns:

is_multi – Whether the requirement has multiple values.

Return type:

bool

isOptional()#

Whether the requirement is optional.

Returns:

is_optional – Whether the requirement is optional.

Return type:

bool

setValue(value, name=None)#

Validate and set the value.

Parameters:
  • value – The value of the input requirement.

  • name (str) – The name of the requirement.