Spec-Zone.ru › NumPy 1.17

numpy.ma.MaskedArray.astype

метод

MaskedArray.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 всегда возвращает новый выделенный массив. Если это установлено в ложь, и требования dtype, order, и subok удовлетворены, массив-вход возвращается вместо копии.

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

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

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

Spec-Zone.ru

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