numpy.ma.masked_array.astype

метод

masked_array.astype(dtype, order='K', casting='unsafe', subok=True, copy=True)

Копия массива, преобразованная к заданному типу.

Параметры

dtypestr or dtype

Код типа или тип данных, к которому преобразуется массив.

order{‘C’, ‘F’, ‘A’, ‘K’}, optional

Управляет порядком расположения памяти в результате. «C» означает порядок C, «F» означает порядок Fortran, «A» означает порядок «F», если все массивы имеют порядок Fortran, в противном случае порядок «C», а «K» означает как можно более близкий к порядку расположения элементов массива в памяти. По умолчанию — «K».

casting{‘no’, ‘equiv’, ‘safe’, ‘same_kind’, ‘unsafe’}, optional

Управляет тем, какие преобразования типов могут происходить. По умолчанию — «unsafe» для обратной совместимости.

• «no» означает, что типы данных не должны преобразовываться вообще.
• «equiv» означает, что разрешаются только изменения порядка байтов.
• «safe» означает, что разрешаются только преобразования, которые могут сохранить значения.
• «same_kind» означает, что разрешаются только безопасные преобразования или преобразования внутри вида, например, float64 в float32.
• «unsafe» означает, что могут быть выполнены любые преобразования данных.

subokbool, optional

Если True, то подклассы будут передаваться (по умолчанию), иначе возвращаемый массив будет принудительно преобразован в массив базового класса.

copybool, optional

По умолчанию astype всегда возвращает новый выделенный массив. Если это значение установлено в false, и требования dtype, order, и subok выполнены, вместо копии возвращается входной массив.

Возвращает

arr_tndarray

Если copy не равно False и выполняются другие условия для возврата входного массива (см. описание параметра copy), arr_t — это новый массив той же формы, что и входной массив, с типом данных, порядком, заданным dtype, order.

Возможные исключения

ComplexWarning

При преобразовании из комплексного в вещественный или целочисленный тип. Чтобы избежать этого, следует использовать a.real.astype(t).

Примечания

Изменено в версии 1.17.0: Преобразование между простым типом данных и структурированным типом возможно только для преобразования «unsafe». Преобразование к нескольким полям разрешено, но преобразование из нескольких полей не разрешено.

Изменено в версии 1.9.0: Преобразование из числового типа в строковый тип в режиме «safe» преобразования требует, чтобы длина строкового типа данных была достаточно большой для хранения максимального значения целого или вещественного числа, преобразованного.

Примеры

>>> x = np.array([1, 2, 2.5])
>>> x
array([1. ,  2. ,  2.5])

>>> x.astype(int)
array([1, 2, 2])