Rotation ¶

def apply(self, to_item: np.ndarray) -> np.ndarray:
    """Applies the rotation to the given item (e.g. vector or matrix).

    Args:
        to_item: the item to rotate

    Returns:
        the rotated item
    """
    if self.rotation is None:
        self.rotation = self.face.to_rotation(self.n * -90)

    return self.rotation.apply(to_item)

@staticmethod
def from_string_notation(string: str) -> List['Rotation']:
    """Parses a list of cuber notation rotations and converts them to the internal representation.

    Args:
        string: the cuber notation formatted string

    Returns:
        a list of `Rotation` objects
    """
    from .. import cube

    items = string.strip().split(' ')
    rotations = []
    for item in items:
        face = cube.FacePosition.from_string_notation(item[0])
        n = 1
        if len(item) == 2:
            if item[1] == "'":
                n = -1
            elif item[1] == '2':
                n = 2

        rotations.append(Rotation(face, n))

    return rotations

@staticmethod
def reverse_multiple(rotations: List['Rotation']) -> List['Rotation']:
    """Reverse a list of rotations by reversing the order but also each rotation individually.
    This creates the inverse set of rotations to apply to a cube to bring it back to its initial state.

    Args:
        rotations: the rotations to reverse

    Returns:
        the resulting list of rotations
    """
    return list(map(lambda rotation: rotation.reversed(), reversed(rotations)))

def reversed(self) -> 'Rotation':
    """Returns a reversed `Rotation` which basically undoes the original one."""
    return Rotation(self.face, -self.n)