Usage
GoogleMapsPlot(mydata,
latitude = "latitude", longitude = "longitude",
type = "default", xlim, ylim, pollutant = NULL,
cols = "default", limits = c(0, 100), cex = pollutant,
pch = NULL, cex.range =c(1,10), xlab = longitude,
ylab = latitude, main = "", map = NULL, map.raster = TRUE,
map.cols = NULL, aspect = 1, as.table = TRUE,
plot.type = "xy", 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
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
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.