Usage
GoogleMapsPlot(mydata,
latitude = "latitude", longitude = "longitude",
type = "default", xlim, ylim, pollutant = NULL, labels = NULL,
cols = "default", limits = c(0, 100), cex = pollutant,
pch = NULL, cex.range =c(2,10), xlab = longitude,
ylab = latitude, main = "", map = NULL, map.raster = TRUE,
map.cols = NULL, aspect = 1, as.table = TRUE,
plot.type = "xy", plot.transparent = FALSE, key = NULL,
key.position = "right", key.header = "",
key.footer = pollutant, auto.text = TRUE,
...
)
panel.GoogleMaps(map)
panel.GoogleMapsRaster(map)Arguments
mydata
The openair data frame to use to generate the GoogleMapsPlot plot.
latitude, longitude
The names of the data series in mydata giving the
latitudes and longitudes, respectively, of measurements.
type
The type of data conditioning to apply before plotting. The
default is will produce a single plot using the entire data. Other type
options include "hour" (for hour of the day), "weekday" (for day of the
week) and "month" (for month of the yea
xlim, ylim
The x-axis and y-axis size ranges. By default these
sized on the basis of latitude and longitude, but can
be forced as part of the plot call.
pollutant
If supplied, the name of a pollutant or variable in
mydata that is to be evaluated at the each measurement
point. Depending on settings, nominally cols and cex,
the evaluation can be by colour, size or bo
labels
If supplied, either the name of mydata
column/field containing the labels to be used or a list, containing
that field name (as labels), and any other label properties,
e.g. cex, col, etc, req
cols
The colour set to use to colour scaled data. Typically,
cols is passed to openColours for evaluation, but can
be forced to one colour using e.g. col = "red". The special
case cols = "greyscale"
limits
By default, the data colour scale is fitted to the total
data range. However, there are circumstances when the user may
wish to set different ones. In such cases limits can be set
in the form c(lower, upper) to modify
cex
The size of data points plotted on maps. By default this
NULL or pollutant if supplied. If NULL all points
are plotted an equal size. If pollutant or the name of another
variable in myd
pch
The plot symbol to be used when plotting data. By default this
is a solid circle (pch = 20), but can be any predefined symbol,
e.g. pch = 1 is the open circle symbol used in most standard R
plots. pch may
cex.range
The range to rescale cex values to if cex
is supplied as a mydata variable name. This is intended to
provide sensible data point points regardless of the variable value range
but may be require fine-tunin
xlab, ylab, main
The x-axis, y-axis and main title labels to be
added to the plot. All labels are passed via quickText to
handle formatting if enabled (auto.text = TRUE). By default
GoogleMapsPlot uses latitude
map
If supplied, an RgoogleMaps output, to be used as a
background map. If NULL (as in default), a map is produced using
the RgoogleMaps function MapBackground, the supplied
latitude
map.raster
Should the map be plotted as a raster object? The
default TRUE uses panel.GoogleMapsRaster to produce
the map layer, while the alternative (FALSE) uses
panel.GoogleMaps. (NOTE: The raster ver
map.cols
Like cols a colour scale, but, if supplied,
used to recolour the map layer before plotting. (NOTE: If set, this
will override cols = "greyscale".)
aspect
The aspect ratio of the plot.
as.table
as.table is a lattice option that
controls the order in which multiple panels are displayed. The
default (TRUE) produces layouts similar to other openair
plot.
plot.type
The method to use to produce the data layer for the plot.
By default (plot.type = "xy"), this is an x-y style scatter plot, but
can also be other pre-defined options (e.g. "level" for a levelplot)
or a user-defined panel of a si
plot.transparent
Data layer transparency control. When enabled, this
forces colours used in the data layer to transparent, and can be a numeric
setting the colour density, from invisible (0) to solid (1), or a logical
(TRUE applying default 0.5).
key
Fine control for the color scale key. By default (key = NULL)
the key is generated is a colour range exists, but can be forced
(key = TRUE/FALSE) or controlled at a higher level (via
drawOpenKey).
key.position
Location where the scale key should be plotted.
Allowed arguments currently include "top", "right",
"bottom" and "left".
key.header, key.footer
Header and footer labels to add to colour
key, if drawn. If enabled (auto.text = TRUE), these arguments are
passed to the scale key (drawOpenKey) via quickText
to handle formatting.
auto.text
Automatic routine text formatting. auto.text = TRUE allows labels
(xlab, ylab, main, etc.) to be passed to the plot via quickText.
auto.text = FALSE turns this option of
...
Addition options are passed on to cutData for type handling,
MapBackground in RgoogleMaps for map layer production, and
xyplot in lattice for data layer production.