Plots of functions of two variables (which can be mapped to discretely-spaced scalar fields), and matrix visualization (per se).
#x-y-fv versions
#(main argument is a matrix)
plot_dfield (x, y, fv, fb, …,
grid.lines, contours=TRUE, heatmap=TRUE,
bin.labels=FALSE, contour.labels=FALSE,
main, xlab="x", ylab="y", xat, yat, xlabs, ylabs,
xyrel = test.xyrel (x, y, fv), transpose=FALSE,
add=FALSE, axes=TRUE, reverse=FALSE,
ncontours=2, clabs, blabs,
grid.color, contour.color="#000000",
color.function, color.fit, colors, hcv=FALSE)plot_bar (x, y, fv, …,
main, xlab="x", ylab="y", xat, yat, xlabs, ylabs,
zlim,
axes=TRUE, arrows=TRUE,
color.function, colors)
plot_matrix (x, y, fv, fb, …,
grid.lines, contours=FALSE, heatmap=TRUE,
bin.labels=FALSE, contour.labels=FALSE,
main, xlab="col", ylab="row", xat, yat, xlabs, ylabs,
xyrel = test.xyrel (x, y, fv), transpose=TRUE,
add=FALSE, axes=TRUE, reverse = c (FALSE, transpose),
ncontours=2, clabs, blabs,
grid.color, contour.color="#000000",
color.function, color.fit, colors, hcv=TRUE)
#functional versions
#(which call the x-y-fv versions above)
plotf_dfield (f, xlim, ylim=xlim, …)
plotf_bar (f, xlim, ylim=xlim, zlim, …)
Optional sorted numeric vectors of x and y midpoints or breakpoints, refer to details.
A numeric matrix (representing a discretely-spaced scalar field), which may include NAs.
Optional numeric vector of function values (or "levels"), for contours.
Logical, include grid lines. Defaults to true, if is.matrix is true and both the number of rows and columns don't exceed 20.
Logical, include contour lines.
Logical, include heatmap.
Logical, include bin labels.
Logical, include contour labels.
Optional strings, main/axes titles.
Optional numeric vectors, the x and y axes tick points.
Optional character vectors, the x and y axes tick labels. In 3D plots, ignored unless axes is true and arrows is false.
Single character, either "f", "s" or "m". "f" produces a plot with a fixed aspect ratio of one, "s" produces a square plot, and "m" a maximized plot.
Logical, if true transpose fv. Note that x, y, etc have the same interpretation, regardless of whether the matrix is tranposed or not. (i.e. x values always apply to values on the horizontal axis).
Logical, if true add contours/heatmap to an existing plot.
Logical vector of length one or two, if true plot reference arrows or axis ticks with labels.
Logical vector of length one or two, (subject to axes, above) if true, plot reference arrows, if false, use axis ticks with labels.
Logical vector of one or two, to reverse the x and y axes. Note that this argument could change.
Integer, the number of contour lines. Ignored if fb supplied.
Optional character vector of contour labels.
Optional character matrix of bin labels. Defaults to the values of fv.
String, giving the grid line color.
Character vector of length one or with the same length as the number of contours, giving the contour line colors.
Optional color function, such as a barface object (for plot_bar) or an opaque litmus object (for the other plots), refer to details.
Optional color fitting function, such as a litmus.fit wrapper, refer to details.
Optional character matrix of R colors, for the heatmap bins. For plot_bar, this may also be a list with two matrices, one for tops and one for sides.
Logical, use the high color variation option.
A numeric-valued function of two variables (x and y), suitable for use with base::outer.
Length-2 numeric vectors, the x and y ranges. Currently, these need to be ascending.
Length length-2 numeric vector, the vertical range, corresponding to the value of the function or matrix.
In the x-y-fv versions ignored.
These functions produce combined contour-heat plots and 3d bar plots, for discretely-spaced scalar fields.
This can be used to plot numeric matrices (here, labelled as fv), and functions that can be mapped to numeric matrices.
In these plots, each heatmap bin represents one element from fv.
Increasing rows in fv correspond to increasing x values and increasing columns in fv correspond to increasing y values. If an x vector is supplied its length needs to equal the number of rows (exact-match case) or the number of rows plus one (plus-one case). Likewise, if a y vector is supplied its length needs to equal the number of columns or the number of columns plus one. In the exact-match cases, the vectors give the midpoints of bins, and in the plus-one cases, vectors give the breakpoints of bins, including the outermost coordinates.
By default, the plot_matrix function calls the plot_dfield function with fv transposed, such that increasing rows in fv correspond to increasing y values and increasing columns in fv correspond to increasing x values. Also by default, it reverses the y axis, such that increasing y values (increasing rows) go from top to bottom. This means that the resulting plots have the same orientation as standard matrices, in text form.
Currently, bar plots use a diamond-based projection with a fixed viewing angle, such that the origin is at the bottom center.
With the exception of plot_bar, if none of color.function, color.fit and colors are supplied, then: (1) A color.fit function is determined by global options. (2) The color.fit function is used to compute a color.function from fv. (3) The color.function is used to compute a color matrix from fv.
The color function can be any function that maps a numeric vector/matrix to a character vector/matrix of R colors, however, I recommend using litmus objects. The color fit function can be any function that maps a numeric vector to a valid color function, however, I recommend using a litmus.fit wrapper.
In plot_bar, the color function is a function that maps a logical (true or false) to an R color.
If there are missing values, the bars are omitted. (So, the plot_bar color function is never called with missing values).
Note that: (1) In the plot_* functions (not the plotf_* functions) the only argument that's required is fv. (2) There's no guarantee that default contour lines will be suitable. (3) Only opaque color functions should be used in heatmaps, that is, color functions that produce opaque colors with no transparency. However, bar plots may use semitransparent colors.
Refer to the vignette for an overview, references and better examples.
Continuously-spaced versions: plot_cfield
Plots of scalar fields over three variables: plot_contour_3d, plot_cfield_3d
Other functions: barface, litmus, litmus.fit
# NOT RUN {
fv <- matrix (sample (1:100), 10, 10)
plot_dfield (,,fv)
plot_bar (,,fv)
plot_matrix (,,fv)
# }
Run the code above in your browser using DataLab