MirrorSymmetry

class baybe.symmetries.mirror.MirrorSymmetry

Bases: Symmetry

Class for representing mirror symmetries.

A mirror symmetry expresses that certain parameters can be inflected at a mirror point without affecting the outcome of the model. For instance, when specified for parameter x and mirror point c, the symmetry expresses that $f(…, c+x, …) = f(…, c-x, …)$.

Public methods

__init__(parameter_name, *[, ...])	Method generated by attrs for class MirrorSymmetry.
augment_measurements(measurements[, parameters])	Augment the given measurements according to the symmetry.
from_dict(dictionary)	Create an object from its dictionary representation.
from_json(source, /)	Create an object from its JSON representation.
summary()	Return a custom summarization of the symmetry.
to_dict()	Create an object's dictionary representation.
to_json([sink, overwrite])	Create an object's JSON representation.
validate_searchspace_context(searchspace)	See base class.

Public attributes and properties

mirror_point	The mirror point.
parameter_names	The names of the parameters affected by the symmetry.
use_data_augmentation	Flag indicating whether data augmentation is to be used.

__init__(parameter_name: str, *, use_data_augmentation: bool = True, mirror_point=0.0)

Method generated by attrs for class MirrorSymmetry.

For details on the parameters, see Public attributes and properties.

augment_measurements(measurements: pd.DataFrame, parameters: Iterable[Parameter] | None = None)

Augment the given measurements according to the symmetry.

Parameters:

• measurements (pd.DataFrame) – The dataframe containing the measurements to be augmented.

• parameters (Iterable[Parameter] | None) – Optional parameter objects carrying additional information. Only required by specific augmentation implementations.

Return type:

pd.DataFrame

Returns:

The augmented dataframe including the original measurements.

classmethod from_dict(dictionary: dict)

Create an object from its dictionary representation.

Parameters:

dictionary (dict) – The dictionary representation.

Return type:

TypeVar(_T, bound= SerialMixin)

Returns:

The reconstructed object.

classmethod from_json(source: str | Path | SupportsRead[str], /)

Create an object from its JSON representation.

Parameters:

source (str | Path | SupportsRead[str]) –

The JSON source. Can be:

• A string containing JSON content.

• A file path or Path object pointing to a JSON file.

• A file-like object with a read() method.

Raises:

ValueError – If source is not one of the allowed types.

Return type:

_T

Returns:

The reconstructed object.

summary()

Return a custom summarization of the symmetry.

Return type:

dict

to_dict()

Create an object’s dictionary representation.

Return type:

dict

Returns:

The dictionary representation of the object.

to_json(sink: str | Path | SupportsWrite[str] | None = None, /, *, overwrite: bool = False, **kwargs: Any)

Create an object’s JSON representation.

Parameters:

• sink (str | Path | SupportsWrite[str] | None) –

  The JSON sink. Can be:

  • None (only returns the JSON string).

  • A file path or Path object pointing to a location where to write the JSON content.

  • A file-like object with a write() method.

• overwrite (bool) – Boolean flag indicating if to overwrite the file if it already exists. Only relevant if sink is a file path or Path object.

• **kwargs (Any) – Additional keyword arguments to pass to json.dumps().

Raises:

FileExistsError – If sink points to an already existing file but overwrite is False.

Return type:

str

Returns:

The JSON representation as a string.

validate_searchspace_context(searchspace: SearchSpace)

See base class.

Parameters:

searchspace (SearchSpace) – The searchspace to validate against.

Raises:

TypeError – If the affected parameter is not numerical.

Return type:

None

mirror_point: float

The mirror point.

property parameter_names: tuple[str]

The names of the parameters affected by the symmetry.

use_data_augmentation: bool

Flag indicating whether data augmentation is to be used.