numpy.savetxt

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

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

Параметры

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

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

Xодномерный или двумерный массив_like

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

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

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

• один спецификатор, fmt=’%.4e’, в результате числа форматируются как ‘ (%s+%sj)’ % (fmt, fmt)
• полная строка, определяющая каждый реальный и мнимый элемент, например, ‘ %.4e %+.4ej %.4e %+.4ej %.4e %+.4ej’ для 3 столбцов
• список спецификаторов, по одному на столбец — в этом случае реальная и мнимая часть должны иметь отдельные спецификаторы, например, [‘%.3e + %.3ej’, ‘(%.15e%+.15ej)’] для 2 столбцов

delimiterстрока, необязательно

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

newlineстрока, необязательно

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

Введено в версии 1.5.0.

headerстрока, необязательно

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

Введено в версии 1.7.0.

footerстрока, необязательно

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

Введено в версии 1.7.0.

commentsстрока, необязательно

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

Введено в версии 1.7.0.

encoding{None, str}, необязательно

Кодировка, используемая для кодирования выходного файла. Не применяется к выходным потокам. Если кодировка отличается от ‘bytes’ или ‘latin1’, вы не сможете загрузить файл в версиях NumPy < 1.14. По умолчанию — ‘latin1’.

Введено в версии 1.14.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 неполное, для исчерпывающей спецификации см. [1].

Ссылки

1

Форматная спецификация Мини-язык, документация 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