LineGraph
Create a line graph plot.
Syntax
model.result(<pgtag>).create(<ftag>,"LineGraph");
model.result(<pgtag>).feature(<ftag>).selection(...);
model.result(<pgtag>).feature(<ftag>).set(property,<value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"LineGraph") creates a line graph plot feature named <ftag> belonging to the plot group <pgtag>.
A line graph plot is used to visualize quantities on lines, either cut lines or boundaries (2D) and edges (3D) in a geometry. Line graph plots can be added to 1D plot groups.
The following properties are available:
true | false
true | false
true | false
true | false
true | false
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
default | long
The color cycle, when linecolor is set to cycle. With default, it contains 7 colors; with long, it contains 19 colors.
The color table to use when linecolor is set to cyclecolortable. See Color Tables for a list of color tables.
Parameters to use in the expressions as an N‑by‑3 matrix containing name, value, and description. Only parameters provided by the physics interfaces in the model can be set.
{1,0,0} or last used color
The uniform color to use. Active when bottomcolor is set to custom.
{0,0,1} or last used edgecolor
{1,0,0} or last used color
The uniform color to use. Active when topcolor is set to custom.
auto | manual
The length of color cycle when linecolor is cyclegradient.
none | parent | dataset name
The description of the expression in expr. Is used in the automatic title.
on | off
on | off
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
parent | manual
on | off
all | first | last | manual | manualindices | interp
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.
The times to use, for transient levels. Available when data is not parent and the underlying data is transient.
on | off
The precision for the evaluated expression when legendmethod is set to evaluated.
automatic | manual | evaluated
A legend string to be evaluated when legendmethod is set to evaluated.
Manual legends active when legendmethod is set to manual.
custom | cycle | cyclereset | cyclecolortable | cyclegradient | fromtheme | black | blue | cyan | gray | green | magenta | red | white | yellow
double | preference
none | cycle | asterisk | circle | diamond | plus | point | square | star | triangle
The local z-coordinates, when locdef is set to physical.
The local relative z-coordinates, when locdef is set to relative.
reference | physical | relative
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.
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.
interp | datapoints
none | cycle | solid | dotted | dashed | dashdot
on | off
Normalize the arc length when xdata is arc or reversedarc.
all | first | last | manual | manualindices
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.
Plot on secondary y-axis, if twoyaxes is set to true in the parent plot group.
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 dataset, so the number of elements in the model can increase radically if the plot uses, for example, a revolve dataset.
norefine | coarse | normal | fine | finer | extrafine | custom
Controls the plot’s resolution, when evaluationsettings is set to manual. 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.
none | material | internal | everywhere | expression
Smoothing settings, when evaluationsettings is set to manual. 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.
The expression to use for smoothing when smooth is set to expression.
The solutions to plot. Available when data is not parent and the underlying data has multiple solutions.
An alternative way to specify the solutions to use, allowing you to enter, for example, range(1,1,20). Applicable when innerinput is manualindices.
solnum | solutioninfo
manual | parent
If data is a local dataset with nontrivial data, specify solutions manually or take them from the parent plot group.
The times to plot. Available when data is not parent and the underlying solution is transient.
manual | none
Threshold value (0-1), if threshold is set to manual.
The title to use when titletype is manual.
auto | custom | label | manual | none
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.
custom | black | blue | cyan | gray | green | magenta | red | white | yellow
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
arc | reversedarc | spacevar | expr
x-axis data. expr uses the expression in xdataexpr. arc uses the curve’s arc length, reversedarc uses the arc length measured from the curve’s endpoint, and spacevar uses the space variable from the dataset specified with the data property.
The unit to use for the expression in xdataexpr. If the old unit is not valid when the expression changes, the unit property is reset to default.
Attributes
Color, Comparison, Filter (Plot Attribute), GraphMarker
See Also
Global (Plot), Line, PointGraph