deepgee 0.1.0__tar.gz

deepgee-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 DeepGEE Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deepgee-0.1.0/PKG-INFO

@@ -0,0 +1,325 @@
+Metadata-Version: 2.4
+Name: deepgee
+Version: 0.1.0
+Summary: Earth Observation with Google Earth Engine and Deep Learning
+Author: Pulakesh Pradhan
+Author-email: pulakesh.mid@gmail.com
+Project-URL: Documentation, https://github.com/pulakeshpradhan/deepgee#readme
+Project-URL: Source, https://github.com/pulakeshpradhan/deepgee
+Project-URL: Bug Reports, https://github.com/pulakeshpradhan/deepgee/issues
+Keywords: earth-observation gee google-earth-engine deep-learning remote-sensing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: earthengine-api>=0.1.300
+Requires-Dist: geemap>=0.20.0
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: rasterio>=1.2.0
+Requires-Dist: matplotlib>=3.4.0
+Requires-Dist: seaborn>=0.11.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: joblib>=1.0.0
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow>=2.10.0; extra == "tensorflow"
+Provides-Extra: pytorch
+Requires-Dist: torch>=1.12.0; extra == "pytorch"
+Requires-Dist: torchvision>=0.13.0; extra == "pytorch"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: sphinx>=4.5.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DeepGEE: Earth Observation with Google Earth Engine and Deep Learning
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A comprehensive Python package for integrating **Google Earth Engine (GEE)** with **Deep Learning** for advanced Earth observation analysis.
+
+## 🌟 Features
+
+- **🔐 Easy GEE Authentication**: Simple authentication and initialization
+- **📥 Data Download**: Direct download using geemap
+- **📊 Spectral Indices**: Calculate NDVI, EVI, NDWI, NDBI, NBR, and more
+- **🧠 Deep Learning Models**: Pre-built classifiers for land cover classification
+- **🗺️ Change Detection**: Temporal analysis and change detection
+- **📈 Visualization**: Built-in plotting and mapping functions
+- **🎯 Multiple Use Cases**: Land cover, crop monitoring, disaster response
+
+## 📦 Installation
+
+### Basic Installation
+
+```bash
+pip install deepgee
+```
+
+### With TensorFlow (for deep learning)
+
+```bash
+pip install deepgee[tensorflow]
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/your-repo/deepgee.git
+cd deepgee
+pip install -e .[dev]
+```
+
+## 🚀 Quick Start
+
+### 1. Authenticate and Initialize GEE
+
+```python
+import deepgee
+
+# Authenticate (first time only)
+deepgee.authenticate_gee()
+
+# Initialize with your project
+deepgee.initialize_gee(project='your-project-id')
+```
+
+### 2. Download Satellite Data
+
+```python
+from deepgee import GEEDataDownloader
+
+# Create downloader
+downloader = GEEDataDownloader()
+
+# Define region of interest
+roi = [85.0, 20.0, 87.0, 22.0]  # [lon_min, lat_min, lon_max, lat_max]
+
+# Create composite
+composite = downloader.create_composite(
+    roi=roi,
+    start_date='2023-01-01',
+    end_date='2023-12-31',
+    sensor='landsat8',
+    add_indices=True,
+    add_elevation=True
+)
+
+# Download to local file
+downloader.download_image(
+    composite,
+    output_path='composite.tif',
+    roi=roi,
+    scale=30
+)
+```
+
+### 3. Train Deep Learning Model
+
+```python
+from deepgee import LandCoverClassifier
+import pandas as pd
+
+# Load training data
+samples = pd.read_csv('training_samples.csv')
+X = samples[feature_columns].values
+y = samples['class'].values
+
+# Create classifier
+classifier = LandCoverClassifier(n_classes=9, architecture='dense')
+
+# Build model
+classifier.build_model(input_shape=(14,))
+
+# Prepare data
+X_train, X_test, y_train, y_test = classifier.prepare_data(X, y)
+
+# Train
+history = classifier.train(X_train, y_train, epochs=50)
+
+# Evaluate
+results = classifier.evaluate(X_test, y_test, class_names=class_names)
+print(f"Accuracy: {results['accuracy']:.4f}")
+```
+
+### 4. Apply to Full Image
+
+```python
+from deepgee import load_geotiff, save_geotiff
+
+# Load image
+image, meta = load_geotiff('composite.tif')
+
+# Reshape for prediction
+n_bands, height, width = image.shape
+image_reshaped = image.reshape(n_bands, -1).T
+
+# Predict
+predictions = classifier.predict(image_reshaped)
+classified = predictions.reshape(height, width)
+
+# Save result
+save_geotiff(classified, 'classified.tif', meta, nodata=255)
+```
+
+## 📚 Examples
+
+See the `examples/` directory for complete workflows:
+
+- **Land Cover Classification**: `examples/land_cover_classification.py`
+- **Change Detection**: `examples/change_detection.py`
+- **Crop Monitoring**: `examples/crop_monitoring.py`
+- **Disaster Assessment**: `examples/disaster_assessment.py`
+
+## 🛠️ Main Components
+
+### Authentication (`deepgee.auth`)
+
+```python
+import deepgee
+
+# Authenticate
+deepgee.authenticate_gee()
+
+# Initialize
+deepgee.initialize_gee(project='your-project-id')
+
+# Check status
+status = deepgee.auth.check_gee_status()
+```
+
+### Data Download (`deepgee.data`)
+
+```python
+from deepgee import GEEDataDownloader, SpectralIndices
+
+downloader = GEEDataDownloader()
+
+# Create composite
+composite = downloader.create_composite(roi, '2023-01-01', '2023-12-31')
+
+# Add spectral indices
+composite = SpectralIndices.add_all_indices(composite, sensor='landsat8')
+
+# Download
+downloader.download_image(composite, 'output.tif', roi=roi)
+```
+
+### Deep Learning Models (`deepgee.models`)
+
+```python
+from deepgee import LandCoverClassifier, ChangeDetector
+
+# Land cover classification
+classifier = LandCoverClassifier(n_classes=9)
+classifier.build_model(input_shape=(14,))
+classifier.train(X_train, y_train)
+
+# Change detection
+detector = ChangeDetector(method='difference')
+changes = detector.detect_changes(image1, image2, threshold=0.2)
+```
+
+### Utilities (`deepgee.utils`)
+
+```python
+from deepgee import (
+    load_geotiff, save_geotiff, calculate_area_stats,
+    plot_confusion_matrix, plot_classification_map
+)
+
+# Load/save data
+image, meta = load_geotiff('input.tif')
+save_geotiff(output, 'output.tif', meta)
+
+# Calculate statistics
+stats = calculate_area_stats(classified, class_names, pixel_size=30)
+
+# Visualize
+plot_classification_map(classified, class_names, class_colors)
+```
+
+## 📖 Documentation
+
+Full documentation available at: [https://deepgee.readthedocs.io/](https://deepgee.readthedocs.io/)
+
+## 🎯 Use Cases
+
+### 1. Land Cover Classification
+
+Classify satellite imagery into multiple land cover types using deep learning.
+
+### 2. Crop Monitoring
+
+Monitor crop health and predict yields using time series analysis.
+
+### 3. Change Detection
+
+Detect changes in land cover over time for deforestation, urbanization, etc.
+
+### 4. Disaster Response
+
+Rapid assessment of flood extent, fire damage, or other disasters.
+
+### 5. Urban Planning
+
+Extract building footprints and monitor urban growth.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+This project is licensed under the MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Google Earth Engine team for the amazing platform
+- geemap developers for the excellent Python package
+- TensorFlow/Keras teams for deep learning frameworks
+
+## 📧 Contact
+
+- **Issues**: [GitHub Issues](https://github.com/your-repo/deepgee/issues)
+- **Email**: <pulakesh.mid@gmail.com>>
+- **Documentation**: [ReadTheDocs](https://deepgee.readthedocs.io/)
+
+## 🌟 Citation
+
+If you use DeepGEE in your research, please cite:
+
+```bibtex
+@software{deepgee2024,
+  title={DeepGEE: Earth Observation with Google Earth Engine and Deep Learning},
+  author={Pulakesh Pradhan},
+  year={2024},
+  url={https://github.com/pulakeshpradhan/deepgee}
+}
+```
+
+---
+
+**Made with ❤️ for the Earth Observation community**

deepgee-0.1.0/README.md

@@ -0,0 +1,270 @@
+# DeepGEE: Earth Observation with Google Earth Engine and Deep Learning
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A comprehensive Python package for integrating **Google Earth Engine (GEE)** with **Deep Learning** for advanced Earth observation analysis.
+
+## 🌟 Features
+
+- **🔐 Easy GEE Authentication**: Simple authentication and initialization
+- **📥 Data Download**: Direct download using geemap
+- **📊 Spectral Indices**: Calculate NDVI, EVI, NDWI, NDBI, NBR, and more
+- **🧠 Deep Learning Models**: Pre-built classifiers for land cover classification
+- **🗺️ Change Detection**: Temporal analysis and change detection
+- **📈 Visualization**: Built-in plotting and mapping functions
+- **🎯 Multiple Use Cases**: Land cover, crop monitoring, disaster response
+
+## 📦 Installation
+
+### Basic Installation
+
+```bash
+pip install deepgee
+```
+
+### With TensorFlow (for deep learning)
+
+```bash
+pip install deepgee[tensorflow]
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/your-repo/deepgee.git
+cd deepgee
+pip install -e .[dev]
+```
+
+## 🚀 Quick Start
+
+### 1. Authenticate and Initialize GEE
+
+```python
+import deepgee
+
+# Authenticate (first time only)
+deepgee.authenticate_gee()
+
+# Initialize with your project
+deepgee.initialize_gee(project='your-project-id')
+```
+
+### 2. Download Satellite Data
+
+```python
+from deepgee import GEEDataDownloader
+
+# Create downloader
+downloader = GEEDataDownloader()
+
+# Define region of interest
+roi = [85.0, 20.0, 87.0, 22.0]  # [lon_min, lat_min, lon_max, lat_max]
+
+# Create composite
+composite = downloader.create_composite(
+    roi=roi,
+    start_date='2023-01-01',
+    end_date='2023-12-31',
+    sensor='landsat8',
+    add_indices=True,
+    add_elevation=True
+)
+
+# Download to local file
+downloader.download_image(
+    composite,
+    output_path='composite.tif',
+    roi=roi,
+    scale=30
+)
+```
+
+### 3. Train Deep Learning Model
+
+```python
+from deepgee import LandCoverClassifier
+import pandas as pd
+
+# Load training data
+samples = pd.read_csv('training_samples.csv')
+X = samples[feature_columns].values
+y = samples['class'].values
+
+# Create classifier
+classifier = LandCoverClassifier(n_classes=9, architecture='dense')
+
+# Build model
+classifier.build_model(input_shape=(14,))
+
+# Prepare data
+X_train, X_test, y_train, y_test = classifier.prepare_data(X, y)
+
+# Train
+history = classifier.train(X_train, y_train, epochs=50)
+
+# Evaluate
+results = classifier.evaluate(X_test, y_test, class_names=class_names)
+print(f"Accuracy: {results['accuracy']:.4f}")
+```
+
+### 4. Apply to Full Image
+
+```python
+from deepgee import load_geotiff, save_geotiff
+
+# Load image
+image, meta = load_geotiff('composite.tif')
+
+# Reshape for prediction
+n_bands, height, width = image.shape
+image_reshaped = image.reshape(n_bands, -1).T
+
+# Predict
+predictions = classifier.predict(image_reshaped)
+classified = predictions.reshape(height, width)
+
+# Save result
+save_geotiff(classified, 'classified.tif', meta, nodata=255)
+```
+
+## 📚 Examples
+
+See the `examples/` directory for complete workflows:
+
+- **Land Cover Classification**: `examples/land_cover_classification.py`
+- **Change Detection**: `examples/change_detection.py`
+- **Crop Monitoring**: `examples/crop_monitoring.py`
+- **Disaster Assessment**: `examples/disaster_assessment.py`
+
+## 🛠️ Main Components
+
+### Authentication (`deepgee.auth`)
+
+```python
+import deepgee
+
+# Authenticate
+deepgee.authenticate_gee()
+
+# Initialize
+deepgee.initialize_gee(project='your-project-id')
+
+# Check status
+status = deepgee.auth.check_gee_status()
+```
+
+### Data Download (`deepgee.data`)
+
+```python
+from deepgee import GEEDataDownloader, SpectralIndices
+
+downloader = GEEDataDownloader()
+
+# Create composite
+composite = downloader.create_composite(roi, '2023-01-01', '2023-12-31')
+
+# Add spectral indices
+composite = SpectralIndices.add_all_indices(composite, sensor='landsat8')
+
+# Download
+downloader.download_image(composite, 'output.tif', roi=roi)
+```
+
+### Deep Learning Models (`deepgee.models`)
+
+```python
+from deepgee import LandCoverClassifier, ChangeDetector
+
+# Land cover classification
+classifier = LandCoverClassifier(n_classes=9)
+classifier.build_model(input_shape=(14,))
+classifier.train(X_train, y_train)
+
+# Change detection
+detector = ChangeDetector(method='difference')
+changes = detector.detect_changes(image1, image2, threshold=0.2)
+```
+
+### Utilities (`deepgee.utils`)
+
+```python
+from deepgee import (
+    load_geotiff, save_geotiff, calculate_area_stats,
+    plot_confusion_matrix, plot_classification_map
+)
+
+# Load/save data
+image, meta = load_geotiff('input.tif')
+save_geotiff(output, 'output.tif', meta)
+
+# Calculate statistics
+stats = calculate_area_stats(classified, class_names, pixel_size=30)
+
+# Visualize
+plot_classification_map(classified, class_names, class_colors)
+```
+
+## 📖 Documentation
+
+Full documentation available at: [https://deepgee.readthedocs.io/](https://deepgee.readthedocs.io/)
+
+## 🎯 Use Cases
+
+### 1. Land Cover Classification
+
+Classify satellite imagery into multiple land cover types using deep learning.
+
+### 2. Crop Monitoring
+
+Monitor crop health and predict yields using time series analysis.
+
+### 3. Change Detection
+
+Detect changes in land cover over time for deforestation, urbanization, etc.
+
+### 4. Disaster Response
+
+Rapid assessment of flood extent, fire damage, or other disasters.
+
+### 5. Urban Planning
+
+Extract building footprints and monitor urban growth.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+This project is licensed under the MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Google Earth Engine team for the amazing platform
+- geemap developers for the excellent Python package
+- TensorFlow/Keras teams for deep learning frameworks
+
+## 📧 Contact
+
+- **Issues**: [GitHub Issues](https://github.com/your-repo/deepgee/issues)
+- **Email**: <pulakesh.mid@gmail.com>>
+- **Documentation**: [ReadTheDocs](https://deepgee.readthedocs.io/)
+
+## 🌟 Citation
+
+If you use DeepGEE in your research, please cite:
+
+```bibtex
+@software{deepgee2024,
+  title={DeepGEE: Earth Observation with Google Earth Engine and Deep Learning},
+  author={Pulakesh Pradhan},
+  year={2024},
+  url={https://github.com/pulakeshpradhan/deepgee}
+}
+```
+
+---
+
+**Made with ❤️ for the Earth Observation community**

deepgee-0.1.0/deepgee/__init__.py

@@ -0,0 +1,36 @@
+"""
+DeepGEE: Earth Observation with Google Earth Engine and Deep Learning
+=====================================================================
+
+A Python package for integrating Google Earth Engine with deep learning
+for advanced Earth observation analysis.
+
+Features:
+- GEE authentication and initialization
+- Data download using geemap
+- Spectral indices calculation
+- Deep learning model training
+- Land cover classification
+- Change detection
+- And more...
+"""
+
+__version__ = "0.1.0"
+__author__ = "Pulakesh Pradhan"
+
+from .auth import authenticate_gee, initialize_gee
+from .data import GEEDataDownloader, SpectralIndices
+from .models import LandCoverClassifier, ChangeDetector
+from .utils import load_geotiff, save_geotiff, calculate_area_stats
+
+__all__ = [
+    'authenticate_gee',
+    'initialize_gee',
+    'GEEDataDownloader',
+    'SpectralIndices',
+    'LandCoverClassifier',
+    'ChangeDetector',
+    'load_geotiff',
+    'save_geotiff',
+    'calculate_area_stats',
+]