openlamb/README

Software per il recupero delle informazioni dei dati dei sensori ambientali pubblicati dall'arpa sul portale opendata della regione lombardia

la lista delle stazioni e dai sensori si trova qui':
https://www.dati.lombardia.it/Ambiente/Stazioni-qualit-dell-aria/ib47-atvt
lo script stazioni.py  stampa la lista delle stazioni e dei sensori recuperando i dati da link qui' sopra,
se si salva invece il contenuto di quel link come stazioni.csv la ricerca viene fatta offline in questo file.

il portale contiene due tipi di documenti: i dataset e i files.
i dataset esistono solo dal 2017 in avanti, sono annuali, e non contengono i dati dei sensori che ad oggi risultano non piu' attivi,
(ad es. per un sensore che ha smesso di funzionare nel 2018 non sono piu' disponibili i dati del 2017).
Sono interrogabili da remoto richiedendo solo i dati di sensori specifici, senza necessita' di scaricare tutto il dataset.

I files invece sono disponibilli in formato csv (non compressi o zippati),  la lista attuale e' questa:
sensori_aria_1968-1995.zip - 47M
sensori_aria_1996-2000.zip - 67M
sensori_aria_2001-2004.zip - 70M
sensori_aria_2005-2007.zip - 62M
sensori_aria_2008-2010.zip - 69M
sensori_aria_2011.zip - 24M
sensori_aria_2012.zip - 23M
sensori_aria_2013.zip - 23M
sensori_aria_2014.zip - 21M
sensori_aria_2015.zip - 21M
sensori_aria_2016.zip - 21M
sensori_aria_2017.zip - 13M
sensori_aria_2018.zip - 13M
sensori_aria_2019.zip - 13M

per visualizzarne i dati e' necessario scaricare l'intero file in una cartella, che di default e' csv/
ma puo' essere modificata nel file openlamb.py
lo script se non trova i files necessari nella cartella specificata li scarica in formato .zip
non e' necessario decomprimerli, lo script legge direttamente i .zip

per l'analisi dei dati recenti e' piu' comodo lavorare con i dataset, per analisi storiche invece bisogna usare i csv

ogni volta che si lancia lo script viene salvato un file export.csv che contiene i dati richiesti



requisiti:
  python3
  pip3 install sodapy matplotlib pandas


sintassi:

  python openlamb.py --dataset 2018 2019 --sensori 6956 10320
    mostra i grafico per il dataset degli anni 2018 e 2019 per i sensori indicati

  python openlamb.py --csv sensori_aria_2018.zip sensori_aria_2019.zip  --sensori 6956 10320
    mostra i grafico dei dati contenuti nei file 2018.csv e 2019.csv per i sensori indicati

  python openlamb.py --dataset 2019 --csv sensori_aria_2019.zip --sensori 6956
    mostra il grafico del confronto dei dati nel dataset e nel file csv per il sensore indicato