aq-data-fusion

Data fusion for air quality data

Repository dedicato allo sviluppo di software per la combinazione di dati da modello e osservati

come contribuire al progetto

per cominciare

1. iscriversi a GitHub (indicate Nome e Cognome nel profilo, così ci riconosciamo)
2. aderire all'organizzazione SNPA-AQ
3. accedere al server RStudio di sviluppo (richiedere l'attivazione di un account personale a RAmorati di Arpae)
4. creare una copia personale del progetto (nel gergo di git: clonare il progetto)
   • da RStudio: con i comandi File > New project... > Version control > Git e indicando come Repository URL https://github.com/SNPA-AQ/aq-data-fusion.git
   • oppure in locale (per esperti, utile per testare la portabilità del codice su altre macchine): git clone https://github.com/SNPA-AQ/aq-data-fusion.git

strumenti di progetto

• per pianificare e monitorare lo sviluppo del codice: https://github.com/SNPA-AQ/aq-data-fusion/projects/1?fullscreen=true
• per segnalare problemi (issues), porre obiettivi intermedi (milestones), proporre soluzioni: https://github.com/SNPA-AQ/aq-data-fusion/issues
• per discutere l'impostazione del lavoro (tra sviluppatori): https://github.com/orgs/SNPA-AQ/teams/data-fusion-developers

link utili

• guida essenziale di git
• guida essenziale di RStudio
• un breve video su RStudio e GitHub

struttura del repository

cartella o file	descrizione	note
.gitignore	lista di file/cartelle da non caricare su github	p.es. dati voluminosi o riservati
README.md	README	formato RMarkdown
LICENSE	definisce la licenza	GPLv3
config	file di configurazione	p.es. definizione dei path
data	dati e metadati	conviene strutturarli in sotto-cartelle
bash	script di shell
python	script python
R	script R
log	log