random_reidemeister_move

random_reidemeister_move(k: PlanarDiagram | OrientedPlanarDiagram, allow_increase=True, inplace=False)

Performs a random Reidemeister move on a given planar diagram.

Args:

k (PlanarDiagram | OrientedPlanarDiagram): The planar diagram on which to perform the Reidemeister move. allow_increase (str, optional): Allow to increase the number of crossings. Defaults to True. inplace (bool, optional): Determines whether the move alters the original diagram or creates a new instance. Defaults to False.

Returns:

PlanarDiagram | OrientedPlanarDiagram | None: The modified planar diagram after

applying the move. Returns None if no applicable move is performed.

Raises:

ValueError: If an unknown move type is encountered.