timeInfo: Get time related information

Description Usage Arguments Details Value Examples

View source: R/timeInfo.R

Description

Calculate the local time at the target location, as well as sunrise, sunset and solar noon times, and create several temporal masks.

If the timezone is provided it will be used. Otherwise, the MazamaSpatialUtils package will be used to determine the timezone from longitude and latitude.

The returned dataframe will have as many rows as the length of the incoming UTC time vector and will contain the following columns:

Usage

1
timeInfo(time = NULL, longitude = NULL, latitude = NULL, timezone = NULL)

Arguments

time

POSIXct vector with specified timezone,

longitude

Longitude of the location of interest.

latitude

Latitude of the location of interest.

timezone

Olson timezone at the location of interest.

Details

While the lubridate package makes it easy to work in local timezones, there is no easy way in R to work in "Local Standard Time" (LST) as is often required when working with air qualitiy data. EPA regulations mandate that daily averages be calculated based on LST.

The localStdTime_UTC column in the returned dataframe is primarily for internal use and provides an important tool for creating LST daily averages and LST axis labeling.

Value

A dataframe with times and masks.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
carmel <- monitor_subset(Carmel_Valley, tlim = c(20160801,20160810))

# Create timeInfo object for this monitor
ti <- timeInfo(
  carmel$data$datetime,
  carmel$meta$longitude,
  carmel$meta$latitude,
  carmel$meta$timezone
)

# Subset the data based on day/night masks
data_day <- carmel$data[ti$day,]
data_night <- carmel$data[ti$night,]

# Build two monitor objects
carmel_day <- list(meta = carmel$meta, data = data_day)
carmel_night <- list(meta = carmel$meta, data = data_night)

# Plot them
monitor_timeseriesPlot(carmel_day, shadedNight = TRUE, pch = 8, col = 'goldenrod')
monitor_timeseriesPlot(carmel_night, pch = 16, col = 'darkblue', add = TRUE)

PWFSLSmoke documentation built on July 8, 2020, 7:19 p.m.