Dashboard Produzione Olio d'Oliva

Questa dashboard interattiva permette di simulare e analizzare la produzione di olio d'oliva basandosi su diversi parametri ambientali e varietali.

Requisiti di Sistema

Python 3.8 o superiore
Git LFS (per i file di grandi dimensioni)
Conda (consigliato) o pip

Configurazione dell'Ambiente

Utilizzando Conda (Consigliato)

Clona il repository:

Crea e attiva l'ambiente conda:

conda env create -f src/environment.yml
conda activate olive-dashboard

Utilizzando pip

Clona il repository:

Crea e attiva un ambiente virtuale:

python -m venv venv
source venv/bin/activate  # Linux/MacOS
# oppure
.\venv\Scripts\activate  # Windows

Installa le dipendenze:
```
pip install -r src/requirements.txt
```

Esecuzione della Dashboard

Assicurati di essere nella directory src:
```
cd src
```

Avvia la dashboard:

python olive-oil-dashboard.py [options]

Opzioni disponibili:

port PORT: Specifica la porta su cui avviare il server (default: 8888)
debug : Attiva la modalità debug con auto-reload (default: False)

Esempio:

python olive-oil-dashboard.py --port 8888 --debug

Apri un browser e vai all'indirizzo:
```
http://localhost:8888
```

Struttura del Progetto

src/
├── dashboard/               # Componenti della dashboard
├── sources/                # Dati e modelli
├── utils/                  # Utility functions
├── olive-oil-dashboard.py  # Main application
├── olive_config.json       # Configuration file
└── requirements.txt        # Python dependencies

Funzionalità Principali

La dashboard offre diverse funzionalità:

Configurazione Oliveto
- Gestione delle varietà di olive
- Configurazione delle tecniche di coltivazione
- Impostazione delle percentuali di mix varietale
Simulazione Ambientale
- Simulazione degli effetti delle condizioni meteorologiche
- Analisi dell'impatto sulla produzione
- Visualizzazione KPI
Analisi Economica
- Gestione dei costi di produzione
- Analisi dei margini
- Proiezioni finanziarie
Produzione
- Monitoraggio della produzione
- Analisi del fabbisogno idrico
- Dettagli per varietà

Risoluzione Problemi Comuni

ModuleNotFoundError

Se riscontri errori del tipo "ModuleNotFoundError", verifica di:

Aver attivato l'ambiente virtuale corretto

Aver installato tutte le dipendenze:

pip install -r requirements.txt  # se usi pip
# oppure
conda env update -f environment.yml  # se usi conda

Errori di Importazione dei Modelli

Se riscontri errori nell'importazione dei modelli:

Verifica che DEV_MODE=True nel file .env
Controlla che tutti i file necessari siano presenti nella directory sources/

Supporto

Per problemi o domande, aprire una issue nel repository del progetto.

3.0 KiB Executable File Raw Permalink Blame History