Skip to content

ConvolutionalTranspose2DLayer

Bases: Convolutional2DLayer

Source code in src/safeds/ml/nn/_convolutional2d_layer.py
class ConvolutionalTranspose2DLayer(Convolutional2DLayer):

    def __init__(
        self,
        output_channel: int,
        kernel_size: int,
        *,
        stride: int = 1,
        padding: int = 0,
        output_padding: int = 0,
    ):
        """
        Create a Convolutional Transpose 2D Layer.

        Parameters
        ----------
        output_channel:
            the amount of output channels
        kernel_size:
            the size of the kernel
        stride:
            the stride of the transposed convolution
        padding:
            the padding of the transposed convolution
        output_padding:
            the output padding of the transposed convolution
        """
        super().__init__(output_channel, kernel_size, stride=stride, padding=padding)
        self._output_padding = output_padding

    def _get_internal_layer(self, **kwargs: Any) -> nn.Module:
        if self._input_size is None:
            raise ValueError(
                "The input_size is not yet set. The internal layer can only be created when the input_size is set.",
            )
        if "activation_function" not in kwargs:
            raise ValueError(
                "The activation_function is not set. The internal layer can only be created when the activation_function is provided in the kwargs.",
            )
        if kwargs.get("activation_function") not in ["sigmoid", "relu", "softmax"]:
            raise ValueError(
                f"The activation_function '{kwargs.get('activation_function')}' is not supported. Please choose one of the following: ['sigmoid', 'relu', 'softmax'].",
            )
        else:
            activation_function: Literal["sigmoid", "relu", "softmax"] = kwargs["activation_function"]
        return _create_internal_model(
            self._input_size.channel,
            self._output_channel,
            self._kernel_size,
            activation_function,
            self._padding,
            self._stride,
            transpose=True,
            output_padding=self._output_padding,
        )

    @property
    def output_size(self) -> ImageSize:
        if self._input_size is None:
            raise ValueError(
                "The input_size is not yet set. The layer cannot compute the output_size if the input_size is not set.",
            )
        if self._output_size is None:
            new_width = (
                (self.input_size.width - 1) * self._stride
                - 2 * self._padding
                + self._kernel_size
                + self._output_padding
            )
            new_height = (
                (self.input_size.height - 1) * self._stride
                - 2 * self._padding
                + self._kernel_size
                + self._output_padding
            )
            self._output_size = ImageSize(new_width, new_height, self._output_channel, _ignore_invalid_channel=True)
        return self._output_size

    def __hash__(self) -> int:
        """
        Return a deterministic hash value for this convolutional transpose 2d layer.

        Returns
        -------
        hash:
            the hash value
        """
        return _structural_hash(super().__hash__(), self._output_padding)

    def __eq__(self, other: object) -> bool:
        """
        Compare two convolutional transpose 2d layer.

        Parameters
        ----------
        other:
            The convolutional transpose 2d layer to compare to.

        Returns
        -------
        equals:
            Whether the two convolutional transpose 2d layer are the same.
        """
        if not isinstance(other, ConvolutionalTranspose2DLayer):
            return NotImplemented
        return (self is other) or (
            self._output_channel == other._output_channel
            and self._kernel_size == other._kernel_size
            and self._stride == other._stride
            and self._padding == other._padding
            and self._input_size == other._input_size
            and self._output_size == other._output_size
            and self._output_padding == other._output_padding
        )

    def __sizeof__(self) -> int:
        """
        Return the complete size of this object.

        Returns
        -------
        size:
            Size of this object in bytes.
        """
        return sys.getsizeof(self._output_padding) + super().__sizeof__()

output_size: ImageSize property