Wolfram Language & System Documentation Center

Export   

Listing of Formats »

Export["dest.ext",expr]

exports data to a file, converting it to the format corresponding to the file extension ext.

Export[dest,expr,"fmt"]

exports data in the specified format "fmt".

Export[dest,exprs,elements]

exports data by treating exprs as elements.

Export[dest,exprs,elements,options]

uses the specified options.

Details

Export handles a large number of formats, each typically with many different possible elements. The possible formats are given in the list $ExportFormats, and in the "Listing of All Formats".
By default, Export creates a file in the current directory given by Directory[].
In Export[dest,…], dest can be any of the following:
"file" or File["file"] explicit file name

"!prog" export data to a pipe

CloudObject[…] a cloud object

LocalObject[…] a local object
The following combinations of exprs and elements can be given:

expr	elem	export expr as elem
{expr₁,expr₂,…}	{{elem₁,elem₂,…}}	export expr_i as elem_i
{expr₁,expr₂,…}	{elem₁,subelem₁,…}	export expr_i as sublement subelem_i of elem₁
rules	"Rules"	export elements and expressions rules

When specifying the format, the following elements specifications can be given:

	{"format",elem}	a single element
	{"format",{elem₁,elem₂,…}}	multiple elements
	{"format",elem₁,sublelem₁,…}	subelements of subelements of elem₁
	{"format",rules}	export elements and expressions rules

When exporting using the "Rules" element, rules can have the following forms:

	elem->val	a value for a single element
	{elem₁->val₁,elem₂->val₂,…}	values for several elements
	elem₁->val₁,elem₂->val₂,…	an association for several elements
	elem₁->{elem₁₁->val₁₁,…}	values for subelements

Export takes an OverwriteTarget option for all formats. Possible settings include:

	False	do not overwrite an existing file
	True	overwrite an existing file (default)
	"KeepBoth"	keep the existing file, automatically choosing a name for the new file

Use Export[dest,…,options] to provide format-specific options that control the behavior of the export.
Export[file,NotebookObject[…],…] when possible exports the content of the notebook referenced by the NotebookObject.
New formats can be manually registered in the Wolfram Language. See the tutorial for "Developing an Export Converter".

Examples

open all close all

Basic Examples (4)

Export an image object:

Wolfram Language code: Export["landscape.jpg", [image]]

Export a plot as a GIF:

Wolfram Language code: Export["test.gif", Plot[Sin[x], {x, 0, 10}]]

Export a formula as a GIF:

Wolfram Language code: Export["test.gif", Integrate[1 / (x ^ 4 - 1), x]]

Wolfram Language code: Import[%]

Export a sound as a MIDI file:

Wolfram Language code: Export["middlec.mid", Sound[{SoundNote["C"], SoundNote["G"]}]]

Scope (13)

Basic Uses (5)

Export a SparseArray to a Matrix Market file:

Wolfram Language code: s = SparseArray[{{1, 1} -> 1, {2, 2} -> 2, {3, 3} -> 3, {1, 3} -> 4}]

Wolfram Language code: Export["file.mtx", s]

Export a Dataset to a "JSONLines" file:

Wolfram Language code: ds = Dataset[Table[<|"a" -> 3i, "b" -> 3i + 2, "c" -> 3i + 5|>, {i, 3}]]

Wolfram Language code: Export["file.jsonl", ds]

Export a Tabular object to a "Parquet" file:

Wolfram Language code: tabular = Import["ExampleData/USstates.orc"]

Wolfram Language code: Export["file.parquet", tabular]

Export "MP3" data to a "WAV" file:

Wolfram Language code: Export["file", \!$\*AudioBox["![Audio Player: ExampleData/car.mp3](audio://content-9mvbu)"]$, "WAV"]

Verify the format of the resulting file:

Wolfram Language code: FileFormat["file"]

Export data using an option in "MP3" to exclude metadata:

Wolfram Language code:

Export["car.mp3", \!\(\*AudioBox["![Audio Player: ExampleData/car.mp3](audio://content-9mvbu)"]\), "MP3", IncludeMetaInformation -> False]

Verify that there is no metadata in the resulting file:

Wolfram Language code: Import["car.mp3", "MetaInformation"]

Types of Formats (8)

Audio (1)

Export an Audio object to an "MP3" file:

Wolfram Language code: audio = AudioGenerator["Sin"]

Wolfram Language code: Export["file.mp3", \!$\*AudioBox["![Embedded Audio Player](audio://content-491zl)"]$]

Graphics (1)

Export a Graphics object to an "SVG" file:

Wolfram Language code: graphics = Graphics[{Red, Disk[], Green, Rectangle[{0, 0}, {2, 2}], Blue, Disk[{2, 2}]}]

Wolfram Language code: Export["file.svg", graphics]

Wolfram Language code: FilePrint[%]

3D Graphics (1)

Export a 3D model to an "X3D" file:

Wolfram Language code: Export["model.x3d", [image]]

Wolfram Language code: FilePrint[%]

Image (1)

Export an Image object to a "JPEG" file:

Wolfram Language code: Export["file.jpeg", [image]]

Spreadsheet (1)

Export a Tabular object to an "XLSX" file:

Wolfram Language code:

tabular = Tabular[{<|"name" -> "John", "age" -> 25|>, <|"name" -> "Anne", "age" -> 20|>, <|"name" -> "Rob", "age" -> Missing[]|>}]

Wolfram Language code: Export["file.xlsx", tabular]

Text (2)

Export some text to a text file:

Wolfram Language code: (text = Import["ExampleData/USConstitution.txt"])//Snippet

Wolfram Language code: Export["file.txt", text]

Export a matrix to a "Markdown" file:

Wolfram Language code: matrix = {{a, b}, {c, d}, {e, f}}

Wolfram Language code: Export["file.md", matrix]//FilePrint

Video (1)

Export an animation to an "MP4" file:

Wolfram Language code: animation = Manipulate[Plot[Sin[a x], {x, 0, 10}], {a, 1, 5}]

Wolfram Language code: Export["file.mp4", animation]

Generalizations & Extensions (2)

Local objects can be used with Export and Import to store data persistently:

Wolfram Language code: Export[LocalObject["plot"], Plot[Sin[x], {x, 0, 10}], "PNG"]

Wolfram Language code: Import[%]

Cloud objects can be used with Export and Import to store data persistently:

Wolfram Language code: Export[CloudObject["plot"], Plot[Sin[x], {x, 0, 10}], "PNG"]

Wolfram Language code: Import[%]

Options (1)

OverwriteTarget (1)

Create a file:

Wolfram Language code: Export["file.png", RandomImage[]]

By default, Export overwrites an existing file:

Wolfram Language code: Export["file.png", RandomImage[]]

Use OverwriteTargetFalse to avoid overwriting:

Wolfram Language code: Export["file.png", RandomImage[], OverwriteTarget -> False]

Properties & Relations (1)

The first format returned by FileNameToFormatList is used by default in Export:

Wolfram Language code: FileNameToFormatList["file.cdf"]

Wolfram Language code: Export["data.cdf", RandomInteger[100, 10]]

Wolfram Language code: FileFormat[%]

Specify a different export format:

Wolfram Language code: Export["data.cdf", RandomInteger[100, 10], "NASACDF"]

Wolfram Language code: FileFormat[%]

Top

More Learning

Tech Support

Wolfram Solutions

Wolfram Solutions For Education

Get Started

Grow Your Skills

Work with Us

Educational Programs for Adults

Educational Programs for Youth

Read

Export

Details

Examples

Basic Examples (4)