Skip to content

ShdwSpde/guyana-development-analysis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Guyana Development Analysis: A Multi-Dimensional Perspective

A comprehensive data science project analyzing Guyana's development across economic, social, and environmental dimensions spanning 100+ years.

Overview

This project uses machine learning, satellite imagery analysis, and data visualization to tell the compelling story of Guyana's development from the 1920s to present day. It covers 12 key dimensions:

Economic Indicators

  • 🏦 GDP & wealth trends (100 years)
  • πŸ“¦ Export economy evolution (50 years)
  • ⛏️ Gold & diamond production
  • πŸ›’οΈ Oil production (2019-present)

Social Development

  • 😊 Happiness index
  • πŸ“Š Economic inequality (Gini coefficient)
  • πŸ“š Literacy rates and education

Environmental Analysis

  • 🌿 Biodiversity metrics
  • 🌳 Forest cover & deforestation
  • πŸ’§ Water resources dynamics

Features

  • Time Series Forecasting: ARIMA, Prophet, VAR, LSTM models for economic predictions
  • Clustering Analysis: K-means, DBSCAN for pattern recognition
  • Satellite Imagery: Google Earth Engine integration for forest and water analysis
  • Computer Vision: U-Net CNN for deforestation detection
  • Interactive Visualizations: Plotly, Folium maps
  • Correlation & Causal Analysis: Multi-dimensional relationship exploration

Installation

Prerequisites

Setup

  1. Clone the repository:
git clone <your-repo-url>
cd guyana-development-analysis
  1. Create and activate virtual environment:
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install core dependencies:
pip install -r requirements.txt
  1. (Optional) Install geospatial packages:

First install GDAL:

# On macOS
brew install gdal

# On Ubuntu/Debian
sudo apt-get install gdal-bin libgdal-dev

Then install geospatial requirements:

pip install -r requirements-geo.txt
  1. Authenticate with Google Earth Engine:
earthengine authenticate

Project Structure

guyana-development-analysis/
β”‚
β”œβ”€β”€ README.md                          # This file
β”œβ”€β”€ requirements.txt                   # Core Python dependencies
β”œβ”€β”€ requirements-geo.txt               # Geospatial dependencies
β”œβ”€β”€ .gitignore                         # Git ignore rules
β”‚
β”œβ”€β”€ guyana_analysis.ipynb              # MAIN COMPREHENSIVE NOTEBOOK
β”‚
β”œβ”€β”€ data/                              # Data directory (gitignored)
β”‚   β”œβ”€β”€ raw/                           # Original downloaded data
β”‚   β”‚   β”œβ”€β”€ economic/                  # GDP, exports, wealth
β”‚   β”‚   β”œβ”€β”€ social/                    # Happiness, literacy
β”‚   β”‚   β”œβ”€β”€ resources/                 # Gold, diamond, oil
β”‚   β”‚   β”œβ”€β”€ environmental/             # Biodiversity
β”‚   β”‚   └── satellite/                 # GEE downloads, rasters
β”‚   β”œβ”€β”€ processed/                     # Cleaned data
β”‚   └── metadata/                      # Data source documentation
β”‚
β”œβ”€β”€ outputs/                           # Generated artifacts (gitignored)
β”‚   β”œβ”€β”€ figures/                       # Static plots (PNG, SVG)
β”‚   β”œβ”€β”€ interactive/                   # Interactive HTML plots
β”‚   β”œβ”€β”€ models/                        # Saved ML models
β”‚   └── reports/                       # Summary statistics
β”‚
└── src/                               # Helper modules
    β”œβ”€β”€ data_fetchers.py              # API/data download functions
    β”œβ”€β”€ preprocessing.py               # Data cleaning utilities
    β”œβ”€β”€ satellite_utils.py             # GEE and raster processing
    └── visualization.py               # Reusable plot functions

Data Sources

All data comes from free, publicly available sources:

Economic Data

  • World Bank Open Data: GDP, exports, poverty indicators
  • UN Comtrade: Export composition by commodity
  • IMF: Historical economic estimates

Resource Production

  • USGS Minerals Yearbook: Gold & diamond production
  • U.S. EIA: Oil production statistics
  • World Bank Commodity Prices: Price data for context

Social Indicators

  • World Happiness Report: Happiness scores and components
  • UNESCO: Literacy rates and education statistics
  • World Bank Poverty & Equity: Gini, income distribution

Environmental Data

  • GBIF: Species occurrence records
  • IUCN Red List: Threatened species
  • Living Planet Index: Population trends

Satellite Imagery (Google Earth Engine)

  • Hansen Global Forest Change: Tree cover (2000-2023)
  • MODIS: NDVI vegetation indices
  • JRC Global Surface Water: Water occurrence (1984-2024)
  • Sentinel-2: High-resolution imagery

Usage

  1. Start Jupyter Notebook:
jupyter notebook
  1. Open guyana_analysis.ipynb

  2. Run cells sequentially (first run will download data - may take time)

  3. Outputs will be saved to outputs/ directory

Machine Learning Techniques

The notebook implements:

  • Time Series: ARIMA, SARIMAX, Prophet, VAR, LSTM
  • Clustering: K-means, DBSCAN, Hierarchical
  • Classification: Random Forest, XGBoost
  • Regression: Random Forest, GWR (Geographically Weighted)
  • Computer Vision: U-Net for satellite image segmentation
  • Anomaly Detection: Isolation Forest, LSTM Autoencoder
  • Causal Inference: Difference-in-Differences, Granger Causality

Expected Outputs

Figures (~50 plots)

  • GDP trajectories and forecasts
  • Export composition changes
  • Production trends
  • Deforestation risk maps
  • Biodiversity hotspots
  • Correlation heatmaps

Interactive Visualizations (~15)

  • GDP forecast with confidence intervals
  • Animated GDP vs happiness scatter
  • Forest change maps
  • Flood risk maps

ML Models (~10)

  • ARIMA (GDP forecasting)
  • Prophet (exports)
  • Random Forest (deforestation risk, happiness drivers)
  • XGBoost (flood risk)
  • U-Net weights (forest change detection)

Development Timeline

  • Week 1: Project setup βœ“
  • Weeks 2-3: Data acquisition
  • Week 4: Data preprocessing
  • Week 5: Exploratory data analysis
  • Weeks 6-7: ML analysis
  • Week 8: Integrated analysis
  • Week 9: Narrative & polish
  • Week 10: Documentation & testing

Contributing

This is a personal/research project. If you'd like to contribute or have suggestions, please open an issue.

License

MIT License - See LICENSE file for details

Citation

If you use this analysis in your research, please cite:

Guyana Development Analysis: A Multi-Dimensional Perspective (2026)
Repository: <your-repo-url>

Acknowledgments

  • Data Providers: World Bank, UN, IMF, NASA, ESA, USGS, UNESCO, GBIF, IUCN
  • Tools: Python, Jupyter, scikit-learn, TensorFlow, Google Earth Engine, Plotly
  • Inspiration: Showcasing Guyana's rich heritage and development journey

Contact

For questions or collaboration opportunities, please open an issue on GitHub.


Note: This project requires significant computational resources for satellite imagery analysis. Consider using cloud platforms (Google Colab, Kaggle) for GPU-accelerated tasks.

About

looking at the last 75 years with Claude Code & Perplexity Pro

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors