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:
custom | black | blue | cyan | gray | green |magenta | red | white | yellow
colortable | uniform
on | off
Whether to show color legend, when coloring is set to colortable.
The color table to use when colormethod is set to colortable. See Color Tables for a list of color tables.
on | off
Whether to reverse to color table when colormethod is set to colortable.
on | off
{1,0,0} or last used color.
none | parent | data set name
The description of the expression in expr. Is used in the automatic title.
on | off
on | off
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
on | off
If inheritplot is not none: Determines if the color is inherited.
If inheritplot is not none: Determines if the deformation scale is inherited.
none | plot name
If inheritplot is not none: Determines if the color and data ranges are inherited.
If inheritplot is not none and linetype is tube: Determines if the tube scale is inherited.
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.
line | tube
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.
on | 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.
on | off
Whether to use the manual data range specified in rangedatamin and rangedatamax. Values outside the data range is not plotted.
off | pprint | ppr
The element refinement to use, if resolution is set to manual. Bear in mind that this is the refinement used for the base data set, so the number of elements in the model can increase radically if the plot uses, for example, a revolve data set.
norefine | coarse | normal | fine | finer | extrafine | custom
none | material | internal | everywhere | expression
Smoothing settings. With material, smoothing is done inside material domains With internal, smoothing is done inside geometry domains. With expression, the smoothing is based on the expression in smoothexpr.
The expression to use for smoothing when smooth is set to expression.
The index of the solution to use. Available when data is not parent and the underlying data has multiple solutions.
solnum | solutioninfo
The time to use, for transient problems. Available when data is not parent and the underlying data is transient.
manual | none
Threshold value (0-1), if threshold is set to manual.
on | off
on if t is used to determine time steps, off if solnum is used.
The title to use when titletype is manual.
auto | custom | manual | none
auto if the title contribution should be computed automatically, possibly using the group’s customization. custom if the title contribution should be computed automatically, but customized. manual if the manual title contribution should be used (the title property). none if no title contribution should be used.
on | off
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.
on | off
on | off
Attributes
Deform, Filter, Height, AberrationHeight, HistogramHeight, TableHeight
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