Spec-Zone.ru › NumPy 1.11

numpy.matrix.astype

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

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

Параметры:

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

subok : bool, необязательно

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

copy : bool, необязательно

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

Возвращает:

arr_t : ndarray

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

Исключения:

ComplexWarning

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

Замечания

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

Примеры

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

© 2008–2016 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.11.0/reference/generated/numpy.matrix.astype.html

Spec-Zone.ru

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