Time range plot showing the lifespan of individual PurpleAir sensors

Source: R/pas_lifespanPlot.R

Plots the lifespan of PurpleAir sensors – the time range between `pas$date_created` and `pas$last_seen`. You can use `dplyr::filter` and `dplyr::arrange()` to pre-process the `pas` dataframe to generate informative results

When `showSensor = TRUE`, typical values for `sensorIdentifier` would be either `sensorIndex` or `locationName`.

pas_lifespanPlot(
  pas,
  showSensor = FALSE,
  sensorIdentifier = "sensor_index",
  moreSpace = 0,
  ...
)

Arguments

pas

PurpleAir Synoptic *pas* object.

showSensor

Logical specifying inclusion of `pas$sensor_index` in the plot.

sensorIdentifier

Name of the column to use when identifying a sensor.

moreSpace

Fractional amount which to expand the time axis so as to allow more room for sensorIdentifiers.

...

Additional arguments to be passed to graphics::plot.default().

Value

No return value. This function is called to create a plot on the active graphics device.

Examples

library(AirSensor2)

# Plot all lifespans
example_pas_historical %>%
  pas_lifespanPlot()


# Methow Valley Clean Air Ambassador sensors
example_pas_historical %>%
  pas_filter(stringr::str_detect(locationName, "Ambassador")) %>%
  pas_lifespanPlot(
    showSensor = TRUE,
    sensorIdentifier = "locationName",
    cex = .6,
    lwd = 2,
    moreSpace = .3
  )


# Arrange by lifespan
example_pas_historical %>%
  pas_filter(stringr::str_detect(locationName, "Ambassador")) %>%
  dplyr::mutate(lifespan = last_seen - date_created) %>%
  dplyr::arrange(lifespan) %>%
  pas_lifespanPlot(
    showSensor = TRUE,
    sensorIdentifier = "locationName",
    cex = .6,
    lwd = 2,
    moreSpace = .3
  )