7.7
8 Plot and Renderer Parameters
Link to this section with
@secref["params" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["params" #:doc '(lib "plot/scribblings/plot.scrbl")]
8.1 Compatibility
Link to this section with
@secref["Compatibility" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Compatibility" #:doc '(lib "plot/scribblings/plot.scrbl")]
8.2 Output
Link to this section with
@secref["Output" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Output" #:doc '(lib "plot/scribblings/plot.scrbl")]
Users of command-line Racket, which cannot display image snips, should enter
The width and height of a plot, in logical drawing units (e.g. pixels for bitmap plots).
Used for default arguments of plotting procedures such as
plot and
plot3d.
8.3 General Appearance
Link to this section with
@secref["General_Appearance" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["General_Appearance" #:doc '(lib "plot/scribblings/plot.scrbl")]
Title and near axis labels.
A
#f value means the label is not drawn and takes no space.
A
"" value effectively means the label is not drawn, but it takes space.
Used as default keyword arguments of plotting procedures such as
plot and
plot3d.
Far axis labels.
A
#f value means the label is not drawn and takes no space.
A
"" value effectively means the label is not drawn, but it takes space.
See
plot-x-ticks for a discussion of near and far axes.
The angle and altitude of the camera in rendering 3D plots, in degrees.
Used as default keyword arguments of plotting procedures such as
plot3d.
Amount of ambient light, and whether 3D plots are rendered with diffuse and specular reflectance.
The plot foreground and background color.
That both are
0 by default is not a mistake: for foreground colors,
0 is interpreted as black; for background colors,
0 is interpreted as white.
See
->pen-color and
->brush-color for details on how Plot interprets integer colors.
The opacity of the background and foreground colors.
The font size (in drawing units), face, and family of the title, axis labels, tick labels, and other labels.
The placement of the legend and the opacity of its background.
The length of tick lines, in drawing units.
Anchor and angles for axis tick labels (2D only).
Angles are in degrees.
The anchor refers to the part of the label attached to the end of the tick line.
Set these when labels would otherwise overlap; for example, in histograms with long category names.
When any of these is #f, the corresponding axis is not drawn.
Use these along with x-axis and y-axis renderers if you want axes that intersect the origin or some other point.
When any of these is
#f, the corresponding labels for the ticks on the axis are not drawn.
These parameters work together with the parameters like
plot-x-axis? that control the drawing of the axes; i.e. tick labels won’t be drawn unless the axis itself is drawn.
When #t, certain renderers draw simplified plots to speed up drawing.
Plot sets it to #t, for example, when a user is clicking and dragging a 3D plot to rotate it.
Given a number of samples, returns the number of samples to use.
This returns
samples when
plot-animating? is
#f.
When #f, axes, axis labels, ticks, tick labels, and the title are not drawn.
Specify the color maps to be used by
->pen-color and
->brush-color respectively, for converting integer values into RGB
triplets, or when integer values are used with the
#:color keyword of
various plot renderers. You can determine the list of available color map
names using
color-map-names.
If name is not a valid color map name, the internal color map will be
used, this is the same as specifying #f.
When the color map value is set to #f, internal color maps will be
used, one for pen and one for brush colors. The internal color map used for
pen colors has darker and more saturated colors than the one used for brush
colors. These colors are chosen for good pairwise contrast, especially
between neighbors and they repeat starting with 128.
The color maps available by default are shown below and additional ones can be
added using register-color-map:
Added in version 7.3 of package plot-gui-lib.
8.4 Lines
Link to this section with
@secref["Lines" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Lines" #:doc '(lib "plot/scribblings/plot.scrbl")]
The pen color, pen width, pen style and opacity of lines in plots.
Used as default keyword arguments of
function,
inverse,
lines,
parametric,
polar,
density,
isoline,
lines3d,
parametric3d and
isoline3d.
8.5 Intervals
Link to this section with
@secref["Intervals" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Intervals" #:doc '(lib "plot/scribblings/plot.scrbl")]
8.6 Points and Point Labels
Link to this section with
@secref["Points_and_Point_Labels" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Points_and_Point_Labels" #:doc '(lib "plot/scribblings/plot.scrbl")]
The symbol, and its size and opacity, used in point plots.
Used as default keyword arguments of
points and
points3d.
When any of
x-jitter,
y-jitter, or
z-jitter are non-zero,
points and
points3d will produce points randomly translated from their
original position along the x, y, or z axis, respectively.
For instance, if each parameter is set to 0.5, then
points '(0 0) will produce a random point
in a square of area 1 centered at
'(0 0).
Likewise
points3d will make a random point within a unit cube centered at
'(0 0 0).
8.7 Vector Fields
Link to this section with
@secref["Vector_Fields" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Vector_Fields" #:doc '(lib "plot/scribblings/plot.scrbl")]
8.8 Error Bars
Link to this section with
@secref["Error_Bars" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Error_Bars" #:doc '(lib "plot/scribblings/plot.scrbl")]
The default width, pen color/width/style, and opacity used by
error-bars.
8.9 Candlesticks
Link to this section with
@secref["Candlesticks" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Candlesticks" #:doc '(lib "plot/scribblings/plot.scrbl")]
The default width, pen color/width/style, and opacity used by
candlesticks. Both the up (a candle whose
open value is lower than its close value) color and the down (a candle whose open value is higher than its close
value) color can be specified independently. The width parameter will be important to specify if your x-axis is
in units like days, weeks, or months. Because dates are actually represented as seconds from an epoch, your
width should take that into consideration. For example, a width of 86400 may be useful for x-axis values in days
as there are 86400 seconds in a day. This candle will be exactly one day in width.
8.10 Contours and Contour Intervals
Link to this section with
@secref["Contours_and_Contour_Intervals"
#:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Contours_and_Contour_Intervals"
#:doc '(lib "plot/scribblings/plot.scrbl")]
The opacities of
lines in contour plots.
Used as a default keyword argument in
contours and
contours3d.
8.11 Contour Surfaces
Link to this section with
@secref["Contour_Surfaces" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Contour_Surfaces" #:doc '(lib "plot/scribblings/plot.scrbl")]
The pen colors, widths, and styles of the sampling grid, where it intersects contour intervals.
Used as default keyword arguments of
contour-intervals3d.
8.12 Rectangles
Link to this section with
@secref["Rectangles" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Rectangles" #:doc '(lib "plot/scribblings/plot.scrbl")]
The default pen width of 3D rectangle edges is narrower for aesthetic reasons.
8.13 Non-Border Axes
Link to this section with
@secref["Non-Border_Axes" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Non-Border_Axes" #:doc '(lib "plot/scribblings/plot.scrbl")]
Number of polar axes, whether radius ticks (i.e. lines) are drawn, whether labels are drawn, and opacity.
Used as default keyword arguments of
polar-axes.
8.14 Surfaces
Link to this section with
@secref["Surfaces" #:doc '(lib "plot/scribblings/plot.scrbl")]
Link to this section with
@secref["Surfaces" #:doc '(lib "plot/scribblings/plot.scrbl")]
Surface brush color/style, pen color/width/style of the sampling grid where it intersects the surface, and opacity.
Used as default keyword arguments of
surface3d,
polar3d and
isosurface3d.
The number, brush colors/styles, pen colors/widths/styles, grid color/widths/styles, and opacities of
nested isosurfaces.
Used as default keyword arguments of
isosurfaces3d.
