ozone_daily_report: Funzioni per produrre i bollettini quotidiani per l'ozono...

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

Description

Funzioni per produrre i bollettini quotidiani per una singola stazione di ozono: estrazione, calcoli, scrittura su DB.

Usage

prepare.ozone_daily_report(con, id.staz, Date=NULL, ...)
calculate.ozone_daily_report(data)
write.ozone_daily_report(con, ODR, empty=F, 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.ozone_daily_report
ODR	lista di data.frame prodotta da calculate.ozone_daily_report (vedi Value)
empty	svuota tutta la tabella del DB prima di scriverci
verbose	scrive a video alcune informazioni utili per il debug
...	parametri opzionali. La funzione prepare.ozone_daily_report li passa a dbqa.get.datastaz; la funzione write.ozone_daily_report li passa a dbqa.insert.

Value

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

daily.report ? un data.frame di un sola riga con le seguenti colonne:

max.day	massimo giornaliero
hour.max.day	ora in cui si e' verificato il massimo (inizio dell'intervallo orario)
max.ave.8h	massimi giornaliero della media mobile su 8 ore
cumul.nexc.180	numero di superamenti orari della soglia 180, dall'inizio dell'anno
cumul.nexc.240	numero di superamenti orari della soglia 240, dall'inizio dell'anno
cumul.nexc.120	numero di superamenti di max.ave.8h della soglia 120, dall'inizio dell'anno

events ? una lista contenente i due data.frame, ciascuno dei quali avente colonne start.time e duration:

exc.180	contenente gli eventi orari di superamento della soglia 180
exc.240	contenente gli eventi orari di superamento della soglia 240

Warning

Usare l'opzione empty=TRUE solo se strettamente necessario: svuota tutta la tabella delle statistiche giornaliere dell'ozono sul DB.

Examples

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


## End(Not run)

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