graphicalExtremes (version 0.2.0)

plotFlights: Plot flight data

Description

Plotting function to visualize the flight connections from the flights dataset. This function requires the package ggplot2 to be installed.

Usage

plotFlights(
  airportIndices = NULL,
  airports_sel = NULL,
  connections_sel = NULL,
  graph = NULL,
  plotAirports = TRUE,
  plotConnections = TRUE,
  returnGGPlot = FALSE,
  useAirportNFlights = FALSE,
  useConnectionNFlights = FALSE,
  minNFlights = 0,
  map = "state",
  vertexColors = NULL,
  vertexShapes = NULL,
  xyRatio = NULL,
  clipMap = FALSE,
  useLatex = FALSE,
  edgeAlpha = 0.2
)

Value

If returnGGPlot is TRUE, a ggplot2::ggplot object, otherwise NULL.

Arguments

airportIndices

The indices of the airports (w.r.t. airports_sel) to include.

airports_sel

The airports to plot. Might be further subset by arguments airportIndeices, graph. If NULL, then flights$aiports will be used.

connections_sel

A three columns data frame as output by flightCountMatrixToConnectionList(). If NULL, then flights$nFlights will be used to construct one.

graph

An optional igraph::graph object, containing a flight graph to plot. Vertices should either match the selected airports in number and order, or be named with the corresponding IATA codes of the airports they represent.

plotAirports

Logical. Whether to plot the airports specified.

plotConnections

Logical. Whether to plot the connections specified.

returnGGPlot

If TRUE, a ggplot2::ggplot object is returned and not plotted immediately.

useAirportNFlights

Logical. Whether to vary the size of the circles representing airports in the plot, according to the number of flights at that airport.

useConnectionNFlights

Logical. Whether to vary the size of the edges representing connections in the plot, according to the number of flights on that connection.

minNFlights

Numeric scalar. Only plot connections with at least this many flights.

map

String or NULL. What map to use as the background image. Is passed to ggplot2::map_data().

vertexColors

Optional vector, named with IATA codes, to be used as colors for the vertices/airports.

vertexShapes

Optional vector, named with IATA codes, to be used as shapes for the vertices/airports. Is coerced to character.

xyRatio

Approximate X-Y-ratio (w.r.t. distance on the ground) of the area shown in the plot.

clipMap

Logical or numeric scalar. Whether to ignore the map image when determining the axis limits of the plot. If it is a positive scalar, the plot limits are extended by that factor.

useLatex

Whether to format numbers etc. as latex code (useful when plotting to tikz).

edgeAlpha

Numeric scalar between 0 and 1. The alpha value to be used when plotting edges/connections.

Examples

# Plot all airports in the dataset
plotFlights(plotConnections = FALSE, map = 'world')

# Plot a selection of airports
plotFlights(c('JFK', 'SFO', 'LAX'), useConnectionNFlights = TRUE, useAirportNFlights = TRUE)

# Plot airports with a custom connections graph
IATAs <- c('ACV', 'BFL', 'EUG', 'SFO', 'MRY')
graph <- igraph::make_full_graph(length(IATAs))
plotFlights(IATAs, graph=graph, clipMap = 1.5)