Damasoumana1/Conflict_monitoring_dataset

🌍 Academic project — Automated collection and preprocessing of conflict event data in West Africa using the GDELT V2 API. Filters events by country, date range, and conflict type (CAMEO codes). Outputs clean CSV/Parquet datasets ready for geospatial analysis. # 🌍 Conflict Monitoring Dataset > **Projet académique** — Collecte et analyse des données de conflits en Afrique de l'Ouest. > Sources : GDELT Project · ACLED · UCDP · ReliefWeb · UN OCHA --- ## 📁 Structure du projet ``` Conflict_monitoring_dataset/ │ ├── main.py ← Point d'entrée principal (lancer ici) ├── config.py ← ⚙️ Configuration (dates, pays, filtres...) ├── requirements.txt ← Dépendances Python │ ├── collectors/ │ ├── __init__.py │ ├── gdelt_collector.py ← Collecteur GDELT V2 ✅ (implémenté) │ ├── acled_collector.py ← Collecteur ACLED 🔜 (à implémenter) │ └── ucdp_collector.py ← Collecteur UCDP 🔜 (à implémenter) │ ├── utils/ │ ├── __init__.py │ └── helpers.py ← Fonctions utilitaires │ ├── data/ │ ├── raw/ ← Données brutes (ignorées par git) │ └── processed/ ← Données nettoyées (CSV + Parquet) │ └── logs/ ← Logs d'exécution ``` --- ## 🚀 Installation & Démarrage rapide ### 1. Cloner le dépôt ```bash git clone github.com cd Conflict_monitoring_dataset ``` ### 2. Créer un environnement virtuel Python ```bash # Windows python -m venv venv venv\Scripts\activate # macOS / Linux python3 -m venv venv source venv/bin/activate ``` ### 3. Installer les dépendances ```bash pip install -r requirements.txt ``` ### 4. Configurer la collecte Ouvrez `config.py` et ajustez selon vos besoins : | Paramètre | Description | Valeur par défaut | |---|---|---| | `date_start` | Début de la période | `"2024-01-01"` | | `date_end` | Fin de la période | `"2024-03-31"` | | `max_files` | Limite de fichiers | `10` | | `country_filter` | Codes pays ISO (Afrique de l'Ouest) | 15 pays pré-configurés | | `file_types` | Types de données GDELT | `["events"]` | ### 5. Lancer la collecte ```bash # Collecte standard (selon config.py) python main.py # Mode test rapide (3 fichiers seulem …