generic_daily_report: Funzioni per produrre i bollettini quotidiani per un...

In jobonaf/arpautils: R utility functions for Arpae ER air quality data

Description

Funzioni per produrre i bollettini quotidiani per una singola stazione per NO2, C6H6, SO2, CO, PM10: estrazione, calcoli, scrittura su DB.

Usage

prepare.daily_report(con, id.staz, id.param,
                       Date=NULL, tstep, ...)
calculate.daily_report(data, id.param,
                       thr.daily.ave=NULL,
                       thr.ave8h.max=NULL,
                       thr.hourly=NULL,
                       thr.multihourly=NULL,
                       NH=3)
write.daily_report(con, DR, id.param,
                       verbose=F, ...)

Arguments

con	identificativo della connessione al DB (stringa)
id.staz	codice numerico identificativo della stazione
Date	data per cui si richiede il report. Se lasciata NULL prende la giornata di ieri, facendo riferimento a Sys.Date().
data	dati estratti da prepare.daily_report
DR	lista di data.frame prodotta da calculate.daily_report (vedi Value)
verbose	scrive a video alcune informazioni utili per il debug
...	parametri opzionali. La funzione prepare.daily_report li passa a dbqa.get.datastaz; la funzione write.daily_report li passa a dbqa.insert.

Value

La funzione calculate.daily_report restituisce una lista di due oggetti:

daily.report è un data.frame di un sola riga con le seguenti colonne (NB i superamenti sono calcolati solo se in input è fornita la corrispondente soglia):

mean.day	media giornaliera
max.day	massima giornaliera
hour.max.day	ora del massimo
max.ave.8h	massimo della media su 8 ore
nexc.hourly	numero di superamenti orari nella giornata
hourly.nValid	numero di dati orari validi nella giornata
cumul.daily.nexc	numero di superamenti della media giornaliera dall'inizio dell'anno
cumul.daily.nValid	numero di dati validi della media giornaliera dall'inizio dell'anno
cumul.ave8h.nexc	numero di superamenti del massimo della media su 8 ore dall'inizio dell'anno
cumul.ave8h.yave	media del massimo della media su 8 ore dall'inizio dell'anno
cumul.ave8h.nValid	numero di massimi giornalieri della media su 8 ore validi dall'inizio dell'anno
cumul.hourly.nValid	numero di dati orari validi dall'inizio dell'anno
cumul.hourly.nexc	numero di superamenti orari dall'inizio dell'anno

events è una lista contenente un data.frame avente colonne start.time e duration, contenente gli eventi orari di superamento della soglia

Examples

## Not run: 
## report di ieri per Cittadella
day <- format(Sys.Date()-1,format='%Y-%m-%d')
con <- dbqa.connect()
Dat <- prepare.daily_report(con,id.staz="2000003",Date=day)
ODR <- calculate.daily_report(Dat)
dbDisconnect(con)


## End(Not run)

jobonaf/arpautils documentation built on May 19, 2019, 2:58 p.m.