Global (Plot)
Create a global plot for 1D plot groups and polar plot groups.
Syntax
model.result(<pgtag>).create(<ftag>,"Global");
model.result(<pgtag>).feature(<ftag>).set(property, <value>);
model.result(<pgtag>).feature(<ftag>).run();
Description
model.result(<pgtag>).create(<ftag>,"Global") creates a plot feature named <ftag> belonging to the plot group <pgtag>.
Global plot is used to visualize defined variables, such as solutions to ODEs or coupling operators with a destination. Global plots can be added to 1D and polar plot groups.
The following properties are available:
on | off
on | off
on | off
Whether to use the automatically computed legends or the legends defined in the legends property. The automatic legends display the solution, description, and expression for each line.
on | off
on | off
default | long
The color cycle, when linecolor is set to cycle. With default, it contains 7 colors; with long, it contains 19 colors.
{0,0,1} or last used edgecolor
none | parent | dataset name
Reference value for display in dB, if dbref is manual (and indb is true).
maximum | manual
10log | 20log
The description of the expressions in expr. Is used in the automatic legends.
on | off
on | off
linpoint | harmonic | lintotal | lintotalavg | lintotalrms | lintotalpeak
on | off
real | imaginary | amplitude | phase | spectrum
When xdata is fourier: Show the DFT as real or imaginary part, amplitude, phase, or frequency spectrum.-
If fouriershow is spectrum and freqrangeactive is true: The upper frequency bound.
If fouriershow is spectrum and freqrangeactive is true: The lower frequency bound.
true | false
If fouriershow is spectrum: Controls whether a manual frequency range is used.
true | false
If fouriershow is not spectrum: ignore last sample.
true | false
Display the amplitude or frequency spectrum in dB when fouriershow is amplitude or spectrum.
true | false
If fouriershow is not spectrum: inverse the discrete Fourier transform.
continuous | discrete
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 | fromtheme | black | blue | cyan | gray | green | magenta | red | white | yellow
double | preference
none | cycle | asterisk | circle | diamond | plus | point | square | star | triangle
none | cycle | solid | dotted | dashed | dashdot
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
true | false
If fouriershow is not spectrum: set the DC value (zero frequency component) to zero.
If fouriershow is spectrum and nfreqsactive is true: The number of frequencies to plot.
true | false
If fouriershow is spectrum: Controls whether the number of frequencies is set manually.
If fouriershow is not spectrum and nsamplesactive is true: The number of uniform samples to use.
true | false
If fouriershow is not spectrum: Controls whether the number of uniform samples is set manually.
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.
none | multiplyperiod | dividenfreq
If fouriershow is spectrum, use no scaling, multiply by sampling period, or divide by number of frequencies.
true | false
If fouriershow is not spectrum: scale with sampling period.
true | false
If fouriershow is not spectrum: shift zero frequency.
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.
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.
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
expr | solution | fourier | phase
x-axis data. expr uses the expression in xdataexpr. solution uses the available solutions in the underlying dataset, such as time steps. fourier uses a discrete Fourier transform (DFT). phase uses a phase range, and rearranged phase plots.
The unit in which xdataphaserange is described.
all | inner | outer | valid level
Whether the expression should be evaluated for every inner or every outer solution, or for a specific level (level1, level2, and so on). Applicable only for models containing multiple levels.
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, ErrorBars, Filter (Plot Attribute), GraphMarker
See Also
LineGraph, PointGraph