Data

Table 7-27: Valid Properties 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.
config	configuration name		The configuration to use for the solution times or parameters, if solutionparams is set to configuration.
const	String array of property/value pairs	Empty	Parameters to use in the expressions.
data	none \| dataset name	First compatible dataset	The name of the dataset 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.
exporttype	text \| vtu	text	File type for the export: a text file or a VTU file.
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	positive 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 dataset is 1D: x-coordinates to evaluate in.
gridx2	double array		If location is grid and the dataset is 2D: x-coordinates to evaluate in.
gridy2	double array		If location is grid and the dataset is 2D: y-coordinates to evaluate in.
gridx3	double array		If location is grid and the dataset is 3D: x-coordinates to evaluate in.
gridy3	double array		If location is grid and the dataset is 3D: y-coordinates to evaluate in.
gridz3	double array		If location is grid and the dataset 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.
includenan	true \| false	true	Include data points whose values are NaN in the data export.
innerinput	all \| first \| last \| manual \| manualindices \| interp	all	How to input the solution to use. manual indicates that solnum is used. manualindices indicates that solnumindices is used. interp indicates that t is used.
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.
looplevel	integer row matrix	All solutions on all levels	The solutions to use, per level
looplevelindices	integer row matrix	Empty	An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when looplevelinput is manualindices on a level.
looplevelinput	String array with all \| first \| last \| manual \| manualindices \| interp on each level	all on all levels	How to input the solution to use, per level. manual on a level indicates that looplevel is used on that level. manualindices on a level indicates that looplevelindices is used on that level. interp on a level indicates that interp is used on that level.
outerinput	all \| first \| last \| manual \| manualindices	all	How to input the outer solutions to use. Applicable only for parametric sweep models. manual indicates that outersolnum is used. manualindices indicates that outersolnumindices is used.
outersolnum	nonnegative integer array	1	The index of the outer solutions to use. Applicable only for parametric sweep models. Since the various outer solutions can have different number of solnum, the solnum property is not used.
outersolnumindices	String or integer array	Empty	An alternative way to specify the outer solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when outerinput is manualindices.
pattern	gauss \| lagrange	lagrange	If the dataset 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	String	10	If location is regulargrid and the dataset is 1D: The number of grid points along the x-axis.
regulargridx2	String	10	If location is regulargrid and the dataset is 2D: The number of grid points along the x-axis.
regulargridy2	String	10	If location is regulargrid and the dataset is 2D:The number of grid points along the y-axis.
regulargridx3	String	10	If location is regulargrid and the dataset is 3D: The number of grid points along the x-axis.
regulargridy3	String	10	If location is regulargrid and the dataset is 3D: The number of grid points along the y-axis.
regulargridz3	String	10	If location is regulargrid and the dataset is 3D: The number of grid points along the z-axis.
resolution	normal \| fine \| finer \| custom		The evaluation resolution.
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.
sdim	fromdataset \| 0 \| 1 \| 2 \| 3	fromdataset	The space dimension to evaluate the underlying dataset in.
solnum	integer array		Solution number to take values from.
solnumindices	String or integer array	Empty	An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when innerinput is manualindices.
solutionparams	manual \| configuration	manual	Specify solution parameters directly (manual) or from a configuration.
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	double array	Empty	The times to use. Available when the underlying solution is transient.

Table 7-27: Valid Properties for Data Export.

Property

Value

on | 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.

config

configuration name

The configuration to use for the solution times or parameters, if solutionparams is set to configuration.

const

String array of property/value pairs

Empty

Parameters to use in the expressions.

data

none | dataset name

First compatible dataset

The name of the dataset to export.

descr

String array

Descriptions of the expressions in expr.

differential

on | off

Whether the expression should be linearized at the linearization point. Applicable only if evalmethod is harmonic.

evalmethod

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.

exporttype

text | vtu

text

File type for the export: a text file or a VTU file.

expr

String array

The expressions to evaluate and export.

on | off

If on, floating-point numbers are written in full precision, otherwise they are written with six significant digits.

gporder

positive integer

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 dataset is 1D: x-coordinates to evaluate in.

gridx2

double array

If location is grid and the dataset is 2D: x-coordinates to evaluate in.

gridy2

double array

If location is grid and the dataset is 2D: y-coordinates to evaluate in.

gridx3

double array

If location is grid and the dataset is 3D: x-coordinates to evaluate in.

gridy3

double array

If location is grid and the dataset is 3D: y-coordinates to evaluate in.

gridz3

double array

If location is grid and the dataset 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.

includenan

true | false

true

Include data points whose values are NaN in the data export.

innerinput

all

How to input the solution to use. manual indicates that solnum is used. manualindices indicates that solnumindices is used. interp indicates that t is used.

lagorder

integer

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.

looplevel

integer row matrix

All solutions on all levels

The solutions to use, per level

looplevelindices

integer row matrix

Empty

An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when looplevelinput is manualindices on a level.

looplevelinput

all on all levels

How to input the solution to use, per level. manual on a level indicates that looplevel is used on that level. manualindices on a level indicates that looplevelindices is used on that level. interp on a level indicates that interp is used on that level.

outerinput

all | first | last | manual | manualindices

all

How to input the outer solutions to use. Applicable only for parametric sweep models. manual indicates that outersolnum is used. manualindices indicates that outersolnumindices is used.

outersolnum

nonnegative integer array

The index of the outer solutions to use. Applicable only for parametric sweep models. Since the various outer solutions can have different number of solnum, the solnum property is not used.

outersolnumindices

String or integer array

Empty

An alternative way to specify the outer solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when outerinput is manualindices.

pattern