numpy.matrix.astype

метод

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

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

Параметры:

dtypestr или dtype

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

order{‘C’, ‘F’, ‘A’, ‘K’}, необязательно

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

casting{‘no’, ‘equiv’, ‘safe’, ‘same_kind’, ‘unsafe’}, необязательно

Управляет тем, какой вид преобразования типов может произойти. По умолчанию для обратной совместимости используется ‘unsafe’.

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

subokbool, необязательно

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

copybool, необязательно

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

Возвращаемое значение:

arr_tndarray

Если copy не равно False и удовлетворяются другие условия для возврата входного массива (см. описание параметра copy), то arr_t — это новый массив такой же формы, как входной массив, с dtype и order, заданными 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])