View source: R/polar_freqMap.R
freqMapStatic | R Documentation |
freqMapStatic()
creates a ggplot2
map using polar frequency plots as
markers. As this function returns a ggplot2
object, further customisation
can be achieved using functions like ggplot2::theme()
and
ggplot2::guides()
.
freqMapStatic(
data,
pollutant = NULL,
ggmap,
statistic = "mean",
breaks = "free",
latitude = NULL,
longitude = NULL,
facet = NULL,
cols = "turbo",
alpha = 1,
key = FALSE,
facet.nrow = NULL,
d.icon = 150,
d.fig = 3,
...
)
data |
A data frame. The data frame must contain the data to plot the
directional analysis marker, which includes wind speed ( |
pollutant |
The column name(s) of the pollutant(s) to plot. If multiple pollutants are specified, they will each form part of a separate panel. |
ggmap |
A |
statistic |
The statistic that should be applied to each wind
speed/direction bin. Can be "frequency", "mean", "median", "max" (maximum),
"stdev" (standard deviation) or "weighted.mean". The option "frequency" is
the simplest and plots the frequency of wind speed/direction in different
bins. The scale therefore shows the counts in each bin. The option "mean"
(the default) will plot the mean concentration of a pollutant (see next
point) in wind speed/direction bins, and so on. Finally, "weighted.mean"
will plot the concentration of a pollutant weighted by wind
speed/direction. Each segment therefore provides the percentage overall
contribution to the total concentration. Note that for options other than
"frequency", it is necessary to also provide the name of a pollutant. See
function |
breaks |
One of:
|
latitude, longitude |
The decimal latitude/longitude. If not provided, will be automatically inferred from data by looking for a column named "lat"/"latitude" or "lon"/"lng"/"long"/"longitude" (case-insensitively). |
facet |
Used for splitting the input data into different panels, passed
to the |
cols |
The colours used for plotting. See |
alpha |
The alpha transparency to use for the plotting surface (a value between 0 and 1 with zero being fully transparent and 1 fully opaque). |
key |
Should a key for each marker be drawn? Default is |
facet.nrow |
Passed to the |
d.icon |
The diameter of the plot on the map in pixels. This will affect
the size of the individual polar markers. Alternatively, a vector in the
form |
d.fig |
The diameter of the plots to be produced using |
... |
Arguments passed on to
|
a ggplot2
plot with a ggmap
basemap
As the outputs of the static directional analysis functions are ggplot2
figures, further customisation is possible using functions such as
ggplot2::theme()
, ggplot2::guides()
and ggplot2::labs()
.
If multiple pollutants are specified, subscripting (e.g., the "x" in "NOx")
is achieved using the ggtext package. Therefore if you
choose to override the plot theme, it is recommended to use
[ggplot2::theme()]
and [ggtext::element_markdown()]
to define the
strip.text
parameter.
When arguments like limits
, percentile
or breaks
are defined, a
legend is automatically added to the figure. Legends can be removed using
ggplot2::theme(legend.position = "none")
, or further customised using
ggplot2::guides()
and either color = ggplot2::guide_colourbar()
for
continuous legends or fill = ggplot2::guide_legend()
for discrete
legends.
the original openair::polarFreq()
freqMap()
for the interactive leaflet
equivalent of
freqMapStatic()
Other static directional analysis maps:
annulusMapStatic()
,
diffMapStatic()
,
percentileMapStatic()
,
polarMapStatic()
,
pollroseMapStatic()
,
windroseMapStatic()
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.