Spec-Zone.ru › NumPy 1.10

numpy.savetxt

numpy.savetxt(fname, X, fmt='%.18e', delimiter=' ', newline='\n', header='', footer='', comments='# ') [source]

Сохранение массива в текстовый файл.

Параметры:

fname : имя файла или дескриптор файла

Если имя файла заканчивается на .gz, файл автоматически сохраняется в сжатом формате gzip. loadtxt прозрачно понимает сжатые файлы.

X : массив_подобный

Данные, которые необходимо сохранить в текстовый файл.

fmt : str или последовательность строк, необязательно

Один формат (%10.5f), последовательность форматов или строка с несколькими форматами, например, «Итерация %d – %10.5f», в этом случае delimiter игнорируется. Для комплексных X, допустимые варианты для fmt:

  1. один спецификатор, fmt=’%.4e’, в результате числа форматируются

    как ‘ (%s+%sj)’ % (fmt, fmt)

  2. полная строка, задающая каждый действительный и мнимый компонент, например

    ‘ %.4e %+.4j %.4e %+.4j %.4e %+.4j’ для 3 столбцов

  3. список спецификаторов, по одному для каждого столбца – в этом случае действительная

    и мнимая части должны иметь отдельные спецификаторы, например, [‘%.3e + %.3ej’, ‘(%.15e%+.15ej)’] для 2 столбцов

delimiter : str, необязательно

Строка или символ, разделяющий столбцы.

newline : str, необязательно

Строка или символ, разделяющий строки.

Добавлена в версии 1.5.0.

header : str, необязательно

Строка, которая будет записана в начале файла.

Добавлена в версии 1.7.0.

footer : str, необязательно

Строка, которая будет записана в конце файла.

Добавлена в версии 1.7.0.

comments : str, необязательно

Строка, которая будет добавлена перед строками header и footer, чтобы отметить их как комментарии. По умолчанию: «# «, как ожидается, например, numpy.loadtxt.

Добавлена в версии 1.7.0.

См. также

save
Сохранение массива в двоичный файл в формате NumPy .npy
savez
Сохранение нескольких массивов в нескомпрессированном .npz архиве
savez_compressed
Сохранение нескольких массивов в сжатом .npz архиве

Примечания

Дополнительное объяснение параметра fmt (%[flag]width[.precision]specifier):

флаги:

- : выравнивание влево

+ : Принудительное предшествование результата знаком «+» или «-».

0 : Заполнение числа нулями слева вместо пробелов (см. ширину).

ширина:
Минимальное количество символов для печати. Значение не усекается, если оно имеет больше символов.
точность:
  • Для целочисленных спецификаторов (например, d,i,o,x), минимальное количество цифр.
  • Для e, E и f спецификаторов, количество цифр для печати после десятичной точки.
  • Для g и G, максимальное количество значащих цифр.
  • Для s, максимальное количество символов.
спецификаторы:

c : символ

d или i : целое десятичное число со знаком

e или E : научная запись с e или E.

f : десятичное число с плавающей точкой

g,G : использование более короткого из e,E или f

o : восьмеричное число со знаком

s : строка символов

u : целое десятичное число без знака

x,X : целое шестнадцатеричное число без знака

Это объяснение fmt неполное, для исчерпывающего описания см. [R280].

Ссылки

[R280] (1, 2) Мини-язык спецификации формата, документация Python.

Примеры

>>> x = y = z = np.arange(0.0,5.0,1.0)
>>> np.savetxt('test.out', x, delimiter=',')   # X is an array
>>> np.savetxt('test.out', (x,y,z))   # x,y,z equal sized 1D arrays
>>> np.savetxt('test.out', x, fmt='%1.4e')   # use exponential notation

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

Spec-Zone.ru

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