plotOptions2d
-- scene
options for 2D plotsThis page describes the scene options that may be used when
generating 2D graphics via plot2d
, plotfunc2d
, plot::Scene
, or plot
. Scene options are attributes that
determine the general appearance of a graphical scene such as
background color, title, axes style etc.
plot2d( <SceneOpt1, SceneOpt2, ...>, graphical
objects)
plotfunc2d( <SceneOpt1, SceneOpt2, ...>, graphical
objects)
plot::Scene(graphical objects, <SceneOpt1, SceneOpt2,
...>)
plot(graphical objects, <SceneOpt1, SceneOpt2,
...>)
plot
, plot::Scene
, plot
, plot2d
, plotfunc2d
, plot3d
, plotfunc3d
, plotOptions3d
graphical objects |
- | see the help pages of plot2d , plotfunc2d , plot::Scene , and plot for details |
SceneOpt1, SceneOpt2, ... |
- | scene options: each is an equation of the form
OptionName = value . |
OptionName |
admissible values | default value |
Arrows | TRUE , FALSE |
FALSE |
Axes | Box, Corner, None, Origin | Origin |
AxesOrigin | Automatic, [x0, y0]
|
Automatic |
AxesScaling | [Lin/Log, Lin/Log] | [Lin, Lin] |
BackGround | [r, g, b] |
RGB::White |
Discont | TRUE , FALSE |
FALSE (plot2d ) |
TRUE (plotfunc2d ) |
||
FALSE (plot ) |
||
FALSE (plot::Scene ) |
||
FontFamily | "helvetica" , "lucida" ,
.. |
"helvetica" |
FontSize | positive integers | 8 |
FontStyle | "bold" , .. |
"bold" |
ForeGround | [r, g, b] |
RBG::Black |
GridLines | Automatic, None or [xValue, yValue] . Admissible values
for xValue , yValue are Automatic, integers, Steps =
d or Steps = [d,
n] . |
None |
GridLinesColor | [r, g, b] |
RGB::Gray |
GridLinesWidth | positive integers | 5 |
GridLinesStyle | SolidLines, DashedLines | DashedLines |
Labeling | TRUE , FALSE |
TRUE |
Labels | [string, string] |
["x", "y"] |
LineStyle | SolidLines, DashedLines | SolidLines |
LineWidth | positive integers | 1 |
PlotDevice | Screen, "filename" ,
["filename",Ascii] ,
["filename",Binary] |
Screen |
PointStyle | Circles, FilledCircles, FilledSquares, Squares | FilledSquares |
PointWidth | positive integers | 30 |
RealValuesOnly | TRUE , FALSE |
FALSE (plot2d ) |
TRUE (plotfunc2d ) |
||
FALSE (plot::Scene ) |
||
FALSE (plot ) |
||
Scaling | Constrained, UnConstrained | UnConstrained |
Ticks | Automatic, None, an integer or [xValue, yValue] .
Admissible values for xValue , yValue are Automatic, an integer, Steps =
d , Steps = [d, n] , or a
list of user defined ticks. |
Automatic |
Title | strings | "" (plot2d ) |
"f(x)" (plotfunc2d ) |
||
"" (plot::Scene ) |
||
"" (plot ) |
||
TitlePosition | Above, Below, [x, y] |
Above |
ViewingBox | Automatic or [xValue,
yValue] . Admissible values for xValue ,
yValue are Automatic or a range
a..b . |
Automatic |
value
TRUE
or
FALSE
; the default is Arrows =
FALSE
. This option is ignored if Axes = None or Axes = Box.value
value
[x0,
y0]
; the default is AxesOrigin = Automatic.
x-y
-plane, provided it is
inside the viewing range of the plot. If this not the case, then the
axes cross at the point of the viewing range that is closest to the
mathematical origin.[x0, y0]
, the
coordinate axes cross at the specified point. Admissible values for the
coordinates are real numerical expressions
as well as the identifiers XMin, XMax, YMin, YMax. These are the extremal coordinates of the scene
which are determined internally when the plot is evaluated.[xScale, yScale]
xScale
and yScale
are either Lin for a linear scale or Log for a
logarithmic scale. The default is AxesScaling =
[Lin,Lin]
.TRUE
, negative coordinate
ranges are clipped from logarithmic plots. With RealValuesOnly = FALSE
, such values cause an
error.[r, g, b]
r
, g
, b
must
be real numbers between 0
and 1
. They
represent the red, green, and blue contributions according to the RGB
color model. Pre-defined colors are provided by MuPAD's RGB
data structure. The default is
BackGround = [1, 1, 1]
=
RGB::White
.value
TRUE
and
FALSE
; the default is Discont =
FALSE
for plot2d
, plot::Scene
, plot
, and Discont
= TRUE
in plotfunc2d
, respectively.
TRUE
enables symbolic
checking of discontinuities. If found, unwanted graphical effects such
as spurious lines at the discontinuities are eliminated.FALSE
disables the
check.FALSE
when the objects are
known to be continuous!plot
library also have an
object attribute Discont which overrides
the value of the scene option Discont.
In particular, for plot::Function2d
and plot::Curve2d
, the default of the
object attribute is Discont = TRUE
,
which overrides the default scene option Discont = FALSE
in calls to plot::Scene
and plot
.FontFamilyString
FontFamilyString
may be one of
"helvetica"
, "lucida"
etc. The default is FontFamily = "helvetica"
.n
n
may have values
between 7 and 36. The default is FontSize = 8.FontStyleString
FontStyleString
may be
one of "bold"
, ... . The default is FontStyle = "bold"
.[r, g, b]
r
, g
, b
must
be real numbers between 0
and 1
. They
represent the red, green, and blue contributions according to the RGB
color model. Pre-defined colors are provided by MuPAD's RGB
data structure. The default is
ForeGround = [0, 0, 0]
=
RGB::Black
.value
[xValue, yValue]
; the default is GridLines = None.
[xValue,
yValue]
the grid lines can be specified separately for each
direction.xValue
and yValue
may be Automatic, a nonnegative integer, Steps = d
or Steps =
[d, n]
.
n
is
equivalent to GridLines = [n,
n]
.d
produces grid lines at
the positions j*d with all integer values j
leading to gridlines inside the viewing range of the plot. The distance
d
between two grid lines must be a real positive
value.[d, n]
is equivalent to
Steps = d/(n+1)
, i.e., further
n
grid lines are placed between the grid lines produced by
Steps = d
. The parameter
n
must be a nonnegative integer.[r, g, b]
r
, g
, b
must be real numbers
between 0
and 1
. They represent the red,
green, and blue contributions according to the RGB color model.
Pre-defined colors are provided by MuPAD's RGB
data structure. The default is GridLines = RGB::Gray
.n
n
are nonnegative integers; the default is GridLinesWidth = 5.value
value
TRUE
or
FALSE
; the default is Labeling =
TRUE
.[xString, yString]
xString
and yString
. The default is
Labels = ["x", "y"]
.value
[Mode
= Curve, ..]
, and polygons generated
via [Mode = List, [..polygons..]]
. You can use the option
LineStyle in the graphical objects to override
this scene option and display each line object in its individual line
style.n
n
are nonnegative integers; the
default is LineWidth = 1.[Mode
= Curve, ..]
, and polygons generated
via [Mode = List, [..polygons..]]
. You can use the option
LineWidth in the graphical objects to override
this scene option and display each line object in its individual line
style.value
"filename"
,
["filename", Ascii]
or
["filename", Binary]
. The default is
PlotDevice = Screen.
["filename",
format]
, the plot is written to the file named
filename
in the specified graphical format. Available
formats are Ascii and Binary. These are mupad specific formats understood by
MuPAD's graphical tool VCam. A file in such a format can later
be opened and rendered by VCam."filename"
is the
same as PlotDevice = ["filename", Binary]
.value
point
. They can
be displayed via plot2d
using objects of the type [Mode = List, [..points..]]
. You
can use the object option PointStyle to override
this scene option and display each point with its individual
style.n
n
are positive integers; the
default is PointWidth = 30.point
. They can
be displayed via plot2d
using objects of the type [Mode = List, [..points..]]
. You
can use the object option PointWidth to override
this scene option and display each point with its individual
width.value
TRUE
, such errors are
trapped. Only those parts of the objects producing real values are
plotted. E.g., with this option the function sqrt(x)
can
be plotted over the interval x = -1..1: the plot only
displays the real function values for x >=0.
With RealValuesOnly = FALSE
no
internal check is performed. The renderer produces an error, when it
encounters a complex value.
The default is RealValuesOnly =
FALSE
in plot2d
, plot::Scene
, and plot
, while it is RealValuesOnly = TRUE
in plotfunc2d
.
FALSE
when the objects are known
to be real valued!plot
library also have an
object attribute RealValuesOnly which
overrides the value of the scene option RealValuesOnly. In particular, for plot::Function2d
and plot::Curve2d
, the default of the
object attribute is RealValuesOnly =
TRUE
, which overrides the default scene option RealValuesOnly = FALSE
in calls to plot::Scene
and plot
.value
value
[xValue, yValue]
. The default is Ticks = Automatic.
n
, the minimum
value for the ticks on both axes is specified by the nonnegative
integer n
. Note that more ticks than specified may be
drawn in order to place them at reasonable positions.[xValue, yValue]
,
the ticks can be specified separately for each axis.xValue
and yValue
may be Automatic, a nonnegative integer, Steps = d
, Steps =
[d, n]
, or a list of user-defined ticks.
[Automatic, Automatic]
.n
is equivalent to
Ticks = [n, n]
.d
produces ticks at the
positions j*d with all integer values j leading
to ticks inside the viewing range of the plot. The distance
d
between two ticks must be a real positive value.[d, n]
produces the same
``large'' ticks as Steps = d
.
Between such ticks further n
smaller ticks are positioned.
The parameter n
must be a nonnegative integer. The
``large'' ticks carry labels if Labeling =
TRUE
. The ``small'' ticks do not carry labels.[t1, t2,
..]
. Admissible values for t1
, t2
etc.
are real numerical expressions defining the
positions of the ticks. Alternatively, any element of the list may be
an equation of the form t = label
, where t
is
a numerical value and label
is a string. This produces a
tick at the position t
with the string as label. The label
is diplayed if Labeling = TRUE
is
specified. E.g.,
Ticks = [[0.2, PI = "PI"], [sqrt(2), 2,
3]]
produces two ticks on the x-axis at the positions x
= 0.2 and x = PI. The second tick carries the label
"PI"
. On the y-axis, three ticks without lables
are produced.
If ticks outside the viewing range of the plot are specified, then the viewing range is extended automatically such that all ticks are visible.
TitleString
TitleString
to the scene. In plot2d
, plot::Scene
, and plot
, the default is the empty string
Title = , i.e., no title. In plotfunc2d
, the expressions
defining the functions to be plotted are converted to title
strings.value
[x, y]
; the default is TitlePosition
= Above.
[x, y]
, the
title may be placed at any position in the scene. The parameters
x, y
must be real numerical values between 0
and 10
. The position [0, 0]
denotes the upper
left corner of the scene, the position [10, 10]
denotes
the lower right corner.value
[xValue, yValue]
; the default is ViewingBox = Automatic.
xValue
and yValue
may be Automatic or a range a..b
. Admissible
values for a
and b
are real numerical expressions as well as the identifiers XMin, XMax, YMin, YMax. These are the extremal
coordinates of the scene which are determined internally when the plot
is evaluated.