Skip to content

ColumnType

Bases: ABC

Abstract base class for column types.

Source code in src/safeds/data/tabular/typing/_column_type.py 
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
class ColumnType(ABC):
    """Abstract base class for column types."""

    _is_nullable: bool  # This line is just here so the linter doesn't throw an error

    @abstractmethod
    def __init__(self, is_nullable: bool = False) -> None:
        """
        Abstract initializer for ColumnType.

        Parameters
        ----------
        is_nullable
            Whether the columntype is nullable.
        """

    @staticmethod
    def _data_type(data: pd.Series) -> ColumnType:
        """
        Return the column type for a given `Series` from `pandas`.

        Parameters
        ----------
        data : pd.Series
            The data to be checked.

        Returns
        -------
        column_type : ColumnType
            The ColumnType.

        Raises
        ------
        NotImplementedError
            If the given data type is not supported.
        """

        def column_type_of_type(cell_type: Any) -> ColumnType:
            if cell_type == int or cell_type == np.int64 or cell_type == np.int32:
                return Integer(is_nullable)
            if cell_type == float or cell_type == np.float64 or cell_type == np.float32:
                return RealNumber(is_nullable)
            if cell_type == bool:
                return Boolean(is_nullable)
            if cell_type == str:
                return String(is_nullable)
            if cell_type is NoneType:
                return Nothing()
            else:
                message = f"Unsupported numpy data type '{cell_type}'."
                raise NotImplementedError(message)

        result: ColumnType = Nothing()
        is_nullable = False
        for cell in data:
            if result == Nothing():
                result = column_type_of_type(type(cell))
                if type(cell) is NoneType:
                    is_nullable = True
                    result._is_nullable = is_nullable
            if result != column_type_of_type(type(cell)):
                if type(cell) is NoneType:
                    is_nullable = True
                    result._is_nullable = is_nullable
                elif (isinstance(result, Integer) and isinstance(column_type_of_type(type(cell)), RealNumber)) or (
                    isinstance(result, RealNumber) and isinstance(column_type_of_type(type(cell)), Integer)
                ):
                    result = RealNumber(is_nullable)
                else:
                    result = Anything(is_nullable)
            if isinstance(cell, float) and np.isnan(cell):
                is_nullable = True
                result._is_nullable = is_nullable

        if isinstance(result, RealNumber) and all(
            data.apply(lambda c: bool(isinstance(c, float) and np.isnan(c) or c == float(int(c)))),
        ):
            result = Integer(is_nullable)

        return result

    @abstractmethod
    def is_nullable(self) -> bool:
        """
        Return whether the given column type is nullable.

        Returns
        -------
        is_nullable : bool
            True if the column is nullable.
        """

    @abstractmethod
    def is_numeric(self) -> bool:
        """
        Return whether the given column type is numeric.

        Returns
        -------
        is_numeric : bool
            True if the column is numeric.
        """

__init__(is_nullable=False) abstractmethod

Abstract initializer for ColumnType.

Parameters:

Name Type Description Default
is_nullable bool

Whether the columntype is nullable.

 False
Source code in src/safeds/data/tabular/typing/_column_type.py 
19
20
21
22
23
24
25
26
27
28
@abstractmethod
def __init__(self, is_nullable: bool = False) -> None:
    """
    Abstract initializer for ColumnType.

    Parameters
    ----------
    is_nullable
        Whether the columntype is nullable.
    """

is_nullable() abstractmethod

Return whether the given column type is nullable.

Returns:

Name Type Description
is_nullable bool

True if the column is nullable.
Source code in src/safeds/data/tabular/typing/_column_type.py 
 95
 96
 97
 98
 99
100
101
102
103
104
@abstractmethod
def is_nullable(self) -> bool:
    """
    Return whether the given column type is nullable.

    Returns
    -------
    is_nullable : bool
        True if the column is nullable.
    """

is_numeric() abstractmethod

Return whether the given column type is numeric.

Returns:

Name Type Description
is_numeric bool

True if the column is numeric.
Source code in src/safeds/data/tabular/typing/_column_type.py 
106
107
108
109
110
111
112
113
114
115
@abstractmethod
def is_numeric(self) -> bool:
    """
    Return whether the given column type is numeric.

    Returns
    -------
    is_numeric : bool
        True if the column is numeric.
    """