raindance: Summarize precipitation data

View source: R/raindance.R

raindanceR Documentation

Summarize precipitation data

Description

This function summarizes precipitation data from Onset event loggers used in Onset tipping bucket precipitation gauges.

Usage

raindance(my_data)

Arguments

my_data

A data frame with from import_hobo_2008 or import_hobo. If not from these functions, the columns must include the following:

Element

The element the data represent. Onset tipping bucket event loggers record an event when 0.254 mm of precipitation tips the bucket inside the raingauge.

PlotID

The unique plot identification number (e.g., A03 or I06).

DateTime

The date-time of the precipitation event

Value

Event data value recorded by the data logger.

Details

This function summarizes precipitation data from Onset event loggers used in Onset tipping bucket precipitation gauges. It uses the data_raw data frame produced from import_hobo_2008 or import_hobo and returns a data frame of hourly precipitation totals, number of tips per hour, and maximum tips per minute.

Value

This function returns a tibble.

DateTime

The date and hour of the data. Hours are the from 0 min 00 sec to 59 min 59 sec. For example 2009-04-15 00:00:00 is from 00:00:00 to 00:59:59 on April 15, 2009.

PlotID

The unique ID number for the long-term monitoring plot.

PRCP_mm

The recorded total precipitation for that hour in millimeters.

Tips

The number of tips recorded for that hour.

MaxTips_min

The maximum tips per minute recorded. This is intended to calculate intensity of precipitation event.

See Also

import_hobo_2008, import_hobo

Examples

## Not run: 
library("raindancer")

# Generate list of files
file_list <- list.files(path = system.file("extdata", package = "raindancer"),
                        pattern = ".csv", full.names = TRUE, recursive = FALSE)

# Read data into R
my_prcp <- import_hobo_2008(file_list[3])$data_raw

# Process precipitation data
raindance(my_prcp)

## End(Not run)


scoyoc/rainDanceR documentation built on Jan. 10, 2023, 3:29 p.m.