Spec-Zone.ru › NumPy 1.16

numpy.ndarray.astype

метод

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

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

Параметры:
dtype : str 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’ означает, что любые преобразования данных могут быть выполнены.
subok : bool, optional

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

copy : bool, optional

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

Возвращает:
arr_t : ndarray

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

Исключения:
ComplexWarning

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

Примечания

Начиная с NumPy 1.9, метод astype теперь возвращает ошибку, если строковый тип данных, к которому нужно преобразовать, недостаточно длинный в режиме «безопасного» преобразования, чтобы содержать максимальное значение целочисленного/вещественного массива, который преобразуется. Ранее преобразование разрешалось даже если результат был усечен.

Примеры

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

© 2005–2019 NumPy Developers
Licensed under the 3-clause BSD License.
https://docs.scipy.org/doc/numpy-1.16.1/reference/generated/numpy.ndarray.astype.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API