Title stata.com

graph export — Export current graph

Description Quick start Syntax Options Remarks and examples

Reference Also see

Description

graph export exports to a file the graph displayed in a Graph window.

Quick start

Save the graph displayed in the Graph window as mygraph.pdf

graph export mygraph.pdf

Save the graph displayed in the Graph window as mygraph.png specifying the graph width and

height in pixels

graph export mygraph.png, width(600) height(450)

Save the current graph as mygraph.ps setting the top and left margins to half an inch

graph export mygraph.ps, tmargin(.5) lmargin(.5)

Same as above, but suppress the Stata logo

graph export mygraph.ps, tmargin(.5) lmargin(.5) logo(off)

Specify that graph be printed on a page in landscape format

graph export mygraph.ps, orientation(landscape)

Convert the graph saved to disk as mygraph.gph to a PDF

graph export newfilename.suffix



, options

options Description

name(windowname) name of Graph window to export

as(fileformat) desired format of output

replace newfilename may already exist

override options override defaults in conversion

If as() is not specified, the output format is determined by the suffix of newfilename.suffix:

suffix option Output format

tif as(tif) TIFF (Tagged Image File Format)

gif as(gif) GIF (Graphics Interchange Format)

jpg as(jpg) JPEG (Joint Photographic Experts Group)

other must specify as()

tif is not available for Stata(console); emf is available only for Stata for Windows; and

gif is available only for Stata for Mac.

override options Description

ps options when exporting to ps

eps options when exporting to eps

svg options when exporting to svg

name(windowname) specifies which window to export from when exporting a graph. Omitting the

name() option exports the topmost graph (Stata for Unix(GUI) users: see Technical note for Stata

for Unix(GUI) users). The name for a window is displayed inside parentheses in the window title.

For example, if the title for a Graph window is Graph (MyGraph), the name for the window

is MyGraph. If a graph is an asis or graph7 graph where there is no name in the window title,

specify "" for windowname.

specified because, by default, graph export determines the format from the suffix of the file

being created.

replace specifies that it is okay to replace filename.suffix if it already exists.

Remarks are presented under the following headings:

If your interest is simply in printing a graph, see [G-2] graph print.

There are three ways to export the graph displayed in a Graph window:

1. Right-click on the Graph window, select Save Graph..., and choose the appropriate Save as

By default, graph export determines the output type by the suffix. If we wanted to create an

Encapsulated PostScript file, we might type

To export a graph stored on disk, type

Do not specify graph use’s nodraw option; see [G-2] graph use.

window and cannot see what has just been “displayed”. Use the graph, and then export it.

window and cannot see what has just been “displayed”. Display the graph, and then export it.

Stata for Unix(GUI) users should note that X-Windows does not have a concept of a window

z-order, which prevents Stata from determining which window is the topmost window. Instead, Stata

determines which window is topmost based on which window has the focus. However, some window

managers will set the focus to a window without bringing the window to the top. What Stata considers

the topmost window may not appear topmost visually. For this reason, you should always use the

name() option to ensure that the correct Graph window is exported.

Reference

[G-2] graph display — Display graph stored in memory

[G-2] graph set — Set graphics options

[G-2] graph use — Display graph stored on disk

[G-2] graph print — Print a graph