🌍 EcoEnv

Environmental variables for biodiversity research in a single Python library.

Part of the EcoToolBox ecosystem 🌿

---

✨ Overview

EcoEnv is a Python library that simplifies the retrieval of environmental variables for ecological and biodiversity research.

It provides a unified interface for collecting satellite imagery and climate variables from multiple sources, eliminating the need to manually interact with different APIs.

Currently supported data include:

• 🌿 NDVI
• 💧 NDWI
• 🌡️ Mean Temperature
• 🌧️ Precipitation

The library integrates Google Earth Engine, Sentinel-2, and WorldClim into a single workflow.

---

🚀 Features

• 🌎 Google Earth Engine integration
• 🛰️ Sentinel-2 imagery
• 🌿 NDVI extraction
• 💧 NDWI extraction
• 🌡️ WorldClim temperature
• 🌧️ WorldClim precipitation
• ⚡ Automatic data retrieval
• 📊 GeoPandas support
• 🐍 Simple Python API

---

📦 Installation

pip install ecoenv

---

⚡ Quick Start

import geopandas as gpd
import ecoenv

ecoenv.authenticateEE("your-project")

gdf = gpd.read_file("points.geojson")

result = ecoenv.get_environment_data(
    gdf,
    ndvi=True,
    ndwi=True,
    temperature=True,
    precipitation=True
)

print(result.head())

---

📚 Examples

NDVI only

ecoenv.get_environment_data(
    gdf,
    ndvi=True
)

---

Climate variables

ecoenv.get_environment_data(
    gdf,
    temperature=True,
    precipitation=True
)

---

Everything

ecoenv.get_environment_data(
    gdf,
    ndvi=True,
    ndwi=True,
    temperature=True,
    precipitation=True
)

---

📖 Available Variables

Variable	Source
NDVI	Sentinel-2
NDWI	Sentinel-2
Temperature	WorldClim
Precipitation	WorldClim

---

🔄 Workflow

GeoDataFrame
      │
      ▼
 EcoEnv
      │
      ├────────► Sentinel-2
      │
      ├────────► WorldClim
      │
      ▼
Environmental Variables
      │
      ▼
Machine Learning / SDM

---

🌿 EcoToolBox Ecosystem

Project	Description
🖥️ EcoLab	Species Distribution Modeling
🌍 EcoEnv	Environmental variables
🦋 EcoObs	Species occurrences
🌿 EcoInteract	Ecological interactions

---

📄 Citation

If EcoEnv contributes to your research, please cite this software.

---

🤝 Contributing

Pull requests are welcome.

---

📜 License

MIT License.