# jonatas-soares-gama/pine_eucalyptus_analysis architecture

> Architecture diagram of the GitHub repository jonatas-soares-gama/pine_eucalyptus_analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jonatas-soares-gama/pine_eucalyptus_analysis
- Repository: https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis

## Overview

##### Project type and purpose
- This is a Python‐based data analysis/ETL pipeline for forestry production data (Pinus and Eucalipto), not a web app or microservice.
- It ingests raw CSVs (IBGE PEVS data), normalizes/cleans them, creates silver datasets, computes gold‐level aggregates, and runs market/demand and comparative analyses.

##### File structure
- Top‐level “data” directory with three zones:
- raw: untouched IBGE CSV exports
- silver: standardized, cleaned per‐species files
- gold: final aggregate tables (annual prices, production, regional breakdowns, forecasts)
- src/ folder: Python scripts broken into
- raw_rename_columns.py – renaming/aligning raw data columns
- silver_data.py – building silver datasets
- analysis/ – modules for actual analysis (comparative_analysis.py, market_demand_analysis.py)
- No web or service layers, purely batch scripts.

##### README insights
- Uses Pandas for ETL, Matplotlib and seaborn for visualization, possibly scikit‐learn or custom code for predictive modeling.
- Objectives cover trend analysis, geospatial patterns, forecasting, recommendations.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Sources
    RawZone(("Raw Zone\n(data/raw/)")):::raw
    click RawZone "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/tree/main/data/raw/"

    %% ETL Layer
    RawRename["raw_rename_columns.py"]:::script
    click RawRename "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/src/raw_rename_columns.py"
    SilverBuilder["silver_data.py"]:::script
    click SilverBuilder "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/src/silver_data.py"

    %% Silver Tier
    SilverZone(("Silver Zone\n(data/silver/)")):::silver
    click SilverZone "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/tree/main/data/silver/"
    EspecieCSV["especie_pinus_eucalipto.csv"]:::silver
    click EspecieCSV "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/silver/especie_pinus_eucalipto.csv"

    %% Gold Tier
    GoldZone(("Gold Zone\n(data/gold/)")):::gold
    click GoldZone "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/tree/main/data/gold/"
    Precos["precos_anuais.csv"]:::gold
    click Precos "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/precos_anuais.csv"
    ProducaoAnuais["producao_anuais.csv"]:::gold
    click ProducaoAnuais "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/producao_anuais.csv"
    ProducaoRegional["producao_regional.csv"]:::gold
    click ProducaoRegional "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/producao_regional.csv"
    ProducaoRegionalEuc["producao_regional_Eucalipto.csv"]:::gold
    click ProducaoRegionalEuc "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/producao_regional_Eucalipto.csv"
    ProducaoRegionalPinus["producao_regional_pinus.csv"]:::gold
    click ProducaoRegionalPinus "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/producao_regional_pinus.csv"
    UpdateComp["update_values_comparative_analysis_2025.csv"]:::gold
    click UpdateComp "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/data/gold/update_values_comparative_analysis_2025.csv"

    %% Analysis Layer
    Comparative["comparative_analysis.py"]:::analysis
    click Comparative "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/src/analysis/comparative_analysis.py"
    Market["market_demand_analysis.py"]:::analysis
    click Market "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/src/analysis/market_demand_analysis.py"

    %% Visualization & Output
    Visualization["Visualizations & Forecast Outputs"]:::analysis
    README["README.md"]:::script
    click README "https://github.com/jonatas-soares-gama/pine_eucalyptus_analysis/blob/main/README.md"

    %% Data Flow
    RawZone -->|"CSV"| RawRename --> SilverBuilder --> SilverZone --> EspecieCSV
    SilverBuilder -->|"aggregates"| GoldZone
    SilverZone -->|"cleaned data"| Comparative
    SilverZone -->|"cleaned data"| Market
    GoldZone -->|"aggregates"| Comparative
    GoldZone -->|"aggregates"| Market
    Comparative --> Visualization
    Market --> Visualization
    README -.-> RawZone

    %% Styles
    classDef raw fill:#cdf0fa,stroke:#333,stroke-width:1px
    classDef silver fill:#fff3bf,stroke:#333,stroke-width:1px
    classDef gold fill:#d3f9d8,stroke:#333,stroke-width:1px
    classDef analysis fill:#ffd8a8,stroke:#333,stroke-width:1px
    classDef script fill:#e0e0e0,stroke:#333,stroke-width:1px
```
