LineSegments
Create a line segments plot.
Syntax
model.result(<pgtag>).create(<ftag>,"LineSegments");
model.result(<pgtag>).feature(<ftag>).set(property,<value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
 model.result(<pgtag>).create(<ftag>,"LineSegments") creates a line plot feature named <ftag> belonging to the plot group <pgtag>.
Line segments plots display line segments in 1D plots.
The following properties are available:
Table 7-82: Valid Properties for LineSegments Plots.
Property
Value
Default
Description
autoplotlabel
true | false
false
Whether the automatic legends should include the plot label.
autosolution
true | false
true
Whether the automatic legends should include the solution.
bottomcolor
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
black
The bottom color to use for a color gradient. Active when linecolor is cyclegradient.
colorcycle
default | long
default
The color cycle, when linecolor is set to cycle. With default, it contains 7 colors; with long, it contains 19 colors.
colortable
color table name
Rainbow
The color table to use when linecolor is set to cyclecolortable. See Color Tables for a list of color tables.
custombottomcolor
RGB-triplet
{1,0,0} or last used color
The uniform color to use. Active when bottomcolor 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.
cyclelength
auto | manual
auto
The length of color cycle when linecolor is cyclegradient.
data
none | parent | dataset name
parent
The dataset this feature refers to.
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.
legend
on | off
off
Whether to show legends.
legendmethod
automatic | manual
automatic
Whether to use the automatic legends or the legends supplied in the legends property.
legendprefix
String
 
A prefix added to the automatic legend.
legends
String array
The last computed automatic legends.
Manual legends active when legendmethod is set to manual.
legendsuffix
String
 
A suffix added to the automatic legend.
linecolor
custom | cycle | cyclereset | cyclecolortable | cyclegradient | fromtheme | black | blue | cyan | gray | green | magenta | red | white | yellow
cycle
How to color the lines in the graph. Cycle indicates that the colors is different for each line segments feature in a 1D plot. Use cyclereset to restart the cycling of colors from the first color. Use fromtheme to take the color from the selected color theme.
linewidth
double | preference
1
The line width.
linemarker
none | cycle | asterisk | circle | diamond | plus | point | square | star | triangle
none
The line markers, if any. Cycle indicates that the marker is different for each line.
linestyle
none | cycle | solid | dotted | dashed | dashdot
solid
The line style, if any. Cycle indicates that the line style is different for each line.
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 or last, but only for transient solutions. Available when data is not parent and the underlying data has multiple solutions.
markerpos
interp | datapoints
interp
Controls whether the positions of the markers are in the data points of the plot, or interpolated depending on the number (set in markers). Markers are visible when linemarker is set.
markers
integer
8
The number of markers to show. Markers are visible when linemarker is set.
numberofcolors
integer
7
The number of colors in the color cycle when cyclelength is manual.
outersolnum
nonnegative integer
1
The index of the outer solutions to use. Applicable only for parametric sweep models.
reversecolortable
boolean
false
Whether to reverse the order of the colors in the color table. Active when linecolor is cyclecolortable.
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.
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 | 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 bottom color to use for a color gradient. Active when linecolor is cyclegradient.
xdescr
String array
 
Descriptions for the x-coordinates. Specify them using the setIndex method.
xexpr
Expression array
 
Expressions for the x-coordinates. Specify them using the setIndex method.
xunit
String array
 
Units for the x-coordinates. Specify them using the setIndex method.
ydescr
String array
 
Descriptions for the y-coordinates. Specify them using the setIndex method.
yexpr
Expression array
 
Expressions for the y-coordinates. Specify them using the setIndex method.
yunit
String array
 
Units for the y-coordinates. Specify them using the setIndex method.
Attributes
None.
See Also
Line