Line
Create a line plot.
Syntax
model.result(<pgtag>).create(<ftag>,"Line");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
 model.result(<pgtag>).create(<ftag>,"Line") creates a line plot feature named <ftag> belonging to the plot group <pgtag>.
Line plots display a quantity on lines, curves and edges in 2D or 3D.
The following properties are available:
Table 7-68: Valid Property/Value Pairs for Line Plots
Property
Value
Default
Description
bottomcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
black
The bottom color to use for a color gradient. Active when coloring is gradient.
color
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
red
The uniform color to use. Active when coloring is uniform.
coloring
colortable | uniform | gradient
colortable
How to color the plot: using a color table, a uniform color, or a color gradient.
colorlegend
on | off
on
Whether to show color legend, when coloring is set to colortable.
colorscalemode
linear | linearsymmetric | logarithmic
linear
Scaling of the color table: linear, linear symmetric around 0, or logarithmic, when coloring is set to colortable or gradient.
colortable
color table name
Rainbow
The color table to use when coloring is set to colortable. See Color Tables for a list of color tables.
colortabletrans
none | reverse | nonlinear | nonlinearsymmetric
none
Transformation of the color table, when coloring is set to colortable or gradient.
const
String array of property/value pairs
Empty
Parameters to use in the expressions.
custombottomcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when bottomcolor is set to custom.
customcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when color is set to custom.
customtopcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when topcolor is set to custom.
data
none | parent | dataset name
parent
The dataset this feature refers to.
descr
String
Model dependent
The description of the expression in expr. Is used in the automatic title.
descriptionintitle
on | off
on
Whether the title contribution should contain the description when titletype is custom.
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
Model dependent
The expression to plot.
expressionintitle
on | off
off
Whether the title contribution should contain the expression when titletype is custom.
inheritcolor
Boolean
true
If inheritplot is not none: Determines if the color is inherited.
inheritdeformscale
Boolean
true
If inheritplot is not none: Determines if the deformation scale is inherited.
inheritplot
none | plot name
none
The plot that color, color range, tube scale, and deformation scale are inherited from.
inheritrange
Boolean
true
If inheritplot is not none: Determines if the color and data ranges are inherited.
inherittransparency
Boolean
true
If inheritplot is not none: Determines if the transparency settings are inherited.
inherittubescale
Boolean
true
If inheritplot is not none and linetype is tube: Determines if the tube scale is inherited.
interp
double array
Time corresponding to last selected solnum for transient levels
The time to use, for transient levels. Available when data is not parent and the underlying data is transient.
linetype
line | tube
line
Plot lines or tubes.
looplevel
array of nonnegative integers and strings
Last solution for transient or parametric solution for each level. Otherwise, first solution for each level.
The index of the solution to use, per level, or interp, but only for transient solutions. Available when data is not parent and the underlying data has multiple solutions.
nonlinearcolortablerev
on | off
off
Whether to reverse to color table or gradient when coloring is set to colortable or gradient and colortabletrans is set to nonlinear or nonlinearsymmetric.
outersolnum
nonnegative integer
1
The index of the outer solutions to use. Applicable only for parametric sweep models.
prefixintitle
String
Empty
Added prefix to contribution to title.
radiusexpr
String
1
The tube radius. Active when linetype is tubes.
rangecoloractive
on | off
off
Whether to use the manual color range specified in rangecolormin and rangecolormax. The color range specifies the minimum and maxim value in the plotted colors. Default is the minimum and maximum data values.
rangecolormax
double
Plot dependent
The maximum color range value. Active when rangecoloractive is on.
rangecolormin
double
Plot dependent
The minimum color range value. Active when rangecoloractive is on.
rangedatactive
on | off
off
Whether to use the manual data range specified in rangedatamin and rangedatamax. Values outside the data range is not plotted.
rangedatamax
double
Plot dependent
The maximum data value. Active when rangedataactive is on.
rangedatamin
double
Plot dependent
The minimum data value. Active when rangedataactive is on.
recover
off | pprint | ppr
off
The derivative recovery method (off, within domains, or everywhere).
refine
nonnegative integer
1
The element refinement to use, if resolution is set to manual. Bear in mind that this is the refinement used for the base dataset, so the number of elements in the model can increase radically if the plot uses, for example, a revolve dataset.
resolution
norefine | coarse | normal | fine | finer | extrafine | custom
normal
Controls the plot’s resolution. A finer setting results in a higher resolution by modifying the internally computed default refinement. Use custom to enter your own refinement in the refine property.
smooth
none | material | internal | everywhere | expression
material
Smoothing settings. With material, smoothing is done inside domains with the same material. With internal, smoothing is done inside geometry domains. With expression, the smoothing is based on the expression in smoothexpr.
smoothexpr
String
dom
The expression to use for smoothing when smooth is set to expression.
solnum
nonnegative integer
Last solution for transient or parametric solution. Otherwise, first solution.
The index of the solution to use. Available when data is not parent and the underlying data has multiple solutions.
solrepresentation
solnum | solutioninfo
solutioninfo
Indicates which method of selecting solutions is active.
solutionparams
manual | parent
manual
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
suffixintitle
String
Empty
Added suffix to contribution to title.
t
double
Time corresponding to last selected solnum.
The time to use, for transient problems. Available when data is not parent and the underlying data is transient.
threshold
manual | none
none
Use a smoothing threshold.
thresholdvalue
double
0.1
Threshold value (0–1), if threshold is set to manual.
timeinterp
on | off
off
on if t is used to determine time steps; off if solnum is used.
title
String
The auto-title
The title to use when titletype is manual.
titletype
auto | custom | label | manual | none
auto
auto, if the title should be computed automatically. custom, if the title should be computed automatically, but customized. label, if the title should be the plot group’s label. manual, if the manual title should be used (the title property). none, if no title should be displayed.
topcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
white
The top color to use for a color gradient. Active when coloring is gradient.
tubeendcaps
true | false
true
Use rounded end caps for tubes, when linetype is set to tube.
tuberadiusscale
double
1
The scale factor applied to the tube radii if tuberadiusscaleactive is true.
tuberadiusscaleactive
Boolean
false
If true, tuberadiusscale is used, otherwise the scale factor is computed automatically.
typeintitle
on | off
on
Whether the title contribution should contain the type when titletype is custom.
unit
String
Model dependent
The unit to use for the expression in expr. If the old unit is not valid when the expression changes, the unit property is reset to default.
unitintitle
on | off
on
Whether the title contribution should contain the unit when titletype is custom.
wireframe
on | off
off
Whether to plot filled elements or only their edges.
Attributes
Deform; Filter (Plot Attribute), Height, AberrationHeight, HistogramHeight, TableHeight (2D only); Marker, MaterialAppearance; Selection (Dataset Attribute); Translation; Transparency (3D only)
Examples
Line plot on 2D solution:
Code for Use with Java
DatasetFeature ds = model.result().dataset().create("dset1", "Solution");
ds.set("solution", "sol1");
ResultFeature pg = model.result().create("pg1",2);
pg.set("data","dset1");
pg.create("line1","Line");
pg.feature("line1").set("expr", "3*u");
Code for Use with MATLAB
ds = model.result.dataset.create('dset1', 'Solution');
ds.set('solution', 'sol1');
pg = model.result.create('pg1',2);
pg.set('data','dset1');
pg.create('line1','Line');
pg.feature('line1').set('expr', '3*u');
Line plot on cut plane in 3D, using the Thermal color table:
Code for Use with Java
DatasetFeature ds2 = model.result().dataset().create("cp1", "CutPlane");
ds2.set("data", "dset2");
 
ResultFeature pg2 = model.result().create("pg2",3);
pg2.create("line2","Line");
pg2.feature("line2").set("data", "cp1");
pg2.feature("line2").set("expr", "2*u");
pg2.feature("line2").set("colortable", "Thermal");
 
pg2.run();
Code for Use with MATLAB
ds2 = model.result.dataset.create('cp1', 'CutPlane');
ds2.set('data', 'dset2');
 
pg2 = model.result.create('pg2',3);
pg2.create('line2','Line');
pg2.feature('line2').set('data', 'cp1');
pg2.feature('line2').set('expr', '2*u');
pg2.feature('line2').set('colortable', 'Thermal');
 
pg2.run;
See Also
LineGraph