Data

Export data to a file.

Syntax

model.result().export().create(<ftag>,"Data");

model.result().export().create(<ftag>,<dtag>,"Data");

model.result().export(<ftag>).set(property, <value>);

model.result().export(<ftag>).run();

Description

model.result().export().create(<ftag>,"Data") creates a data export feature with the name <ftag>.

model.result().export().create(<ftag>,<dtag>,"Data") creates a data export feature with the name <ftag> for the data set <dtag>.

The following properties are available:

Table 7-19: Valid Property/Value Pairs for Data Export

Property	Value	Default	Description
alwaysask	on | off	off	Always ask for filename when saving. This property is ignored when running without a GUI.
coordfilename	String		If location is file: The file that contains coordinates to evaluate in.
const	String array of property/value pairs	Empty	Parameters to use in the expressions.
data	String		The name of the data set to export.
descr	String array		Descriptions of the expressions in expr.
differential	on | off	on	Whether the expression should be linearized at the linearization point. Applicable only if evalmethod is harmonic
evalmethod	linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak	harmonic	Applicable only for solutions with a stored linearization point. Controls if the linearization point, the perturbation, or a combination should be used when evaluating the expression.
expr	String array		The expressions to evaluate and export.
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.
gporder	poitive integer	1	If pattern is gauss: The Gauss point order.
gridstruct	grid | spreadsheet	spreadsheet	If location is grid or regulargrid: The format of the exported data.
gridx1	double array		If location is grid and the data set is 1D: x-coordinates to evaluate in.
gridx2	double array		If location is grid and the data set is 2D: x-coordinates to evaluate in.
gridy2	double array		If location is grid and the data set is 2D: y-coordinates to evaluate in.
gridx3	double array		If location is grid and the data set is 3D: x-coordinates to evaluate in.
gridy3	double array		If location is grid and the data set is 3D: y-coordinates to evaluate in.
gridz3	double array		If location is grid and the data set is 3D: z-coordinates to evaluate in.
header	on | off	off	Enable/disable a data header in the output file.
ifexists	append | overwrite	overwrite	If the file exists, append to or overwrite the file contents.
lagorder	integer	1	The Lagrange point order to use if resolution is custom.
level	fromdataset | volume | surface | line | point	fromdataset	The geometry level to evaluate on.
location	fromdataset | file | grid | regulargrid	fromdataset	The points evaluated in.
outersolnum	non-negative integer	1	The index of the outer solutions to use. Applicable only for parametric sweep models.
pattern	gauss | lagrange	lagrange	If the data set is a solution: Specifies if evaluation takes place in Lagrange points or in Gauss points.
recover	off | pprint | ppr	off	The derivative recovery method (off, within domains, or everywhere).
regulargridx1	positive integer	10	If location is regulargrid and the data set is 1D: The number of grid points along the x-axis.
regulargridx2	positive integer	10	If location is regulargrid and the data set is 2D: The number of grid points along the x-axis.
regulargridy2	positive integer	10	If location is regulargrid and the data set is 2D:The number of grid points along the y-axis.
regulargridx3	positive integer	10	If location is regulargrid and the data set is 3D: The number of grid points along the x-axis.
regulargridy3	positive integer	10	If location is regulargrid and the data set is 3D: The number of grid points along the y-axis.
regulargridz3	positive integer	10	If location is regulargrid and the data set is 3D: The number of grid points along the z-axis.
resolution	normal | fine | finer | custom		The evaluation resolution.
sdim	fromdataset | 0 | 1 | 2 | 3	fromdataset	The space dimension to evaluate the underlying data set in.
solnum	integer array		Solution number to take values from.
sort	on | off	off	Enable/disable sorting of the points with respect to the coordinates.
struct	sectionwise | spreadsheet		If location is fromdataset: Format of the exported data.
t	String		Time to evaluate in if timeinterp is on.
timeinterp	on | off	off	Enable/disable explicit time to evaluate in.

See Also

Height, HistogramHeight, TableHeight