Plot
Export plots to files.
Syntax
model.result().export().create(<ftag>,"Plot");
model.result().export().create(<ftag>,<pgtag>,<plottag>, "Plot");
model.result().export(<ftag>).set(property, <value>);
model.result().export(<ftag>).run();
Description
model.result().export().create(<ftag>,"Plot") creates a plot export feature with the name <ftag>.
model.result().export().create(<ftag>,<pgtag>,<plottag>, "Plot") creates a plot export feature with the name <ftag> for the plot <plottag> in the plot group <pgtag>.
To export a 3D surface from a plot to an STL file, use .stl as the filename extension.
The following properties are available:
Table 7-101: Valid Property/Value Pairs for Plot Exports
Property
Value
Default
Description
alwaysask
on | off
off
Always ask for filename when saving. This property is ignored when running without a GUI.
color
Boolean
false
For PLY and 3MD files: include vertex colors in the data export.
exporttype
text | vtu | stlascii | stlbin | plyascii | plybin | 3mf | wav
text
File type for the export: a text file, VTU file, STL ASCII or binary file (3D surfaces only), PLY ASCII or binary file (3D surfaces only), 3MF file (3D surfaces only), or WAVE audio files (1D graph plots, function plots, table plots, and impulse response plots only).
ifexists
append | overwrite
overwrite
If the file exists, append to or overwrite the file contents. Not available for VTU files.
plotgroup
String
 
The name of the plot group containing the plot to export
plot
String
 
The name of the plot (in plotgroup) to export
compact
Boolean
false
Only applicable for streamline and particle tracing plots. If true, the exported data contains one line per streamline or particle rather than one line per point on a streamline or particle trajectory.
filename
String
 
The output file.
fullprec
on | off
on
If on, floating-point numbers are written in full precision, otherwise they are written with six significant digits. Not for STL files.
header
on | off
off
Enable/disable a data header in the output file (for text files only).
multiplecurves
asrows | ascolumns
asrows
For 1D plot groups with multiple curves using the same x-coordinates: Save as rows with two columns or save as columns, with one column for the x-coordinates and one column for the y-coordinates for each curve.
quantlevel
8bit | 16bit | 32bitfloat
 
The quantization level, if exporttype is wav.
repeat
on | off
off
Enable/disable repeated playing of the animation.
samplingfreq
integer
 
The sampling frequency, if samplingfreqmode is user.
samplingfreqmode
auto | user
auto
The sampling frequency mode (automatic or user defined), if exporttype is wav.
separator
C |   | \t | ,| ; | :| |
C
The column separator for the data in the output text file. C means column; the second option is a space, and the third option is a tab.
sort
on | off
off
Enable/disable sorting of the points with respect to the coordinates.
struct
sectionwise | spreadsheet
spreadsheet
Format of the exported data.
wavnorm
maxampl | user
maxampl
The normalization of WAVE audio data: maximum amplitude or a user-defined value, if exporttype is wav.
wavnormval
double
1
The normalization value, if wavnorm is user.
See Also
Height, AberrationHeight, HistogramHeight, TableHeight