SnowMapPy 1.0.1__tar.gz → 1.0.2__tar.gz

snowmappy-1.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Haytam Elyoussfi
+
+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.

snowmappy-1.0.2/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: SnowMapPy
+Version: 1.0.2
+Summary: A comprehensive Python package for processing MODIS NDSI data from local files and Google Earth Engine
+Home-page: https://github.com/haytamelyo/SnowMapPy
+Author: Haytam Elyoussfi
+Author-email: Haytam Elyoussfi <haytam.elyoussfi@um6p.ma>, Hatim Bechri <Hatim.bechri@usms.ac.ma>
+License-Expression: MIT
+Project-URL: Bug Reports, https://github.com/haytamelyo/SnowMapPy/issues
+Project-URL: Source, https://github.com/haytamelyo/SnowMapPy
+Project-URL: Documentation, https://github.com/haytamelyo/SnowMapPy#readme
+Keywords: modis,snow,remote sensing,earth engine,gis,hydrology
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: xarray
+Requires-Dist: rasterio
+Requires-Dist: geopandas
+Requires-Dist: earthengine-api
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SnowMapPy 🌨️
+
+A Python package for processing MODIS NDSI (Normalized Difference Snow Index) data from local files and Google Earth Engine. Designed for hydrologists, geographers, and water resource managers, SnowMapPy simplifies snow cover analysis with minimal Python expertise required.
+
+---
+
+## 📋 Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+  - [Option 1: Install with Conda (Recommended)](#option-1-install-with-conda-recommended)
+  - [Option 2: Install with pip](#option-2-install-with-pip)
+  - [Option 3: Run with Docker](#option-3-run-with-docker)
+- [Quick Start](#quick-start)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## ✨ Features
+
+- **Cloud Processing**: Process MODIS NDSI data directly from Google Earth Engine.
+- **Local Processing**: Handle locally stored MODIS NDSI files.
+- **Quality Control**: Mask invalid data using advanced techniques.
+- **Temporal Interpolation**: Fill missing data points efficiently.
+- **Spatial Operations**: Clip data to regions of interest.
+- **Data Export**: Save processed data in Zarr format.
+
+---
+
+## 🚀 Installation
+
+SnowMapPy requires Python 3.8 or higher. We recommend using **Conda** for managing dependencies, especially for Windows users.
+
+### Option 1: Install with Conda (Recommended)
+
+Install SnowMapPy directly from Conda-Forge:
+```bash
+conda install -c conda-forge snowmappy
+```
+
+### Option 2: Install with pip
+
+1. **Create a Virtual Environment**  
+   ```bash
+   python -m venv snowmappy_env
+   source snowmappy_env/bin/activate  # macOS/Linux
+   snowmappy_env\Scripts\activate     # Windows
+   ```
+
+2. **Install SnowMapPy**  
+   ```bash
+   pip install SnowMapPy
+   ```
+
+### Option 3: Run with Docker
+
+1. **Pull the Docker Image**  
+   ```bash
+   docker pull your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+2. **Run the Container**  
+   ```bash
+   docker run -it your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+3. **Mount Local Data (Optional)**  
+   To process local files, mount your data directory:
+   ```bash
+   docker run -it -v /path/to/data:/app/data your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+---
+
+## 🎯 Quick Start
+
+### Cloud Processing Example
+
+```python
+from SnowMapPy.cloud.processor import process_modis_ndsi_cloud
+
+# Process MODIS NDSI data from Google Earth Engine
+result = process_modis_ndsi_cloud(
+    project_name="your-gee-project",
+    shapefile_path="path/to/roi.shp",
+    start_date="2023-01-01",
+    end_date="2023-01-31",
+    output_path="output/",
+    file_name="snow_cover"
+)
+```
+
+### Local Processing Example
+
+```python
+from SnowMapPy.local.processor import process_modis_ndsi_local
+
+# Process locally stored MODIS NDSI files
+result = process_modis_ndsi_local(
+    mod_dir="path/to/MOD/files/",
+    myd_dir="path/to/MYD/files/",
+    dem_file="path/to/dem.tif",
+    output_path="output/",
+    file_name="local_snow_cover"
+)
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. **GDAL or Proj Library Not Found**
+- **Solution for Conda**: Ensure you installed the package from Conda-Forge:
+  ```bash
+  conda install -c conda-forge snowmappy
+  ```
+
+#### 2. **Earth Engine Authentication Fails**
+- **Solution**: Re-authenticate:
+  ```bash
+  earthengine authenticate --force
+  ```
+
+#### 3. **Memory Errors During Processing**
+- **Solutions**:
+  - Reduce the date range or spatial extent.
+  - Increase virtual memory/swap space.
+  - Use a machine with more RAM.
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Commit your changes.
+4. Push to the branch.
+5. Open a Pull Request.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

snowmappy-1.0.2/README.md

@@ -0,0 +1,148 @@
+# SnowMapPy 🌨️
+
+A Python package for processing MODIS NDSI (Normalized Difference Snow Index) data from local files and Google Earth Engine. Designed for hydrologists, geographers, and water resource managers, SnowMapPy simplifies snow cover analysis with minimal Python expertise required.
+
+---
+
+## 📋 Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+  - [Option 1: Install with Conda (Recommended)](#option-1-install-with-conda-recommended)
+  - [Option 2: Install with pip](#option-2-install-with-pip)
+  - [Option 3: Run with Docker](#option-3-run-with-docker)
+- [Quick Start](#quick-start)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## ✨ Features
+
+- **Cloud Processing**: Process MODIS NDSI data directly from Google Earth Engine.
+- **Local Processing**: Handle locally stored MODIS NDSI files.
+- **Quality Control**: Mask invalid data using advanced techniques.
+- **Temporal Interpolation**: Fill missing data points efficiently.
+- **Spatial Operations**: Clip data to regions of interest.
+- **Data Export**: Save processed data in Zarr format.
+
+---
+
+## 🚀 Installation
+
+SnowMapPy requires Python 3.8 or higher. We recommend using **Conda** for managing dependencies, especially for Windows users.
+
+### Option 1: Install with Conda (Recommended)
+
+Install SnowMapPy directly from Conda-Forge:
+```bash
+conda install -c conda-forge snowmappy
+```
+
+### Option 2: Install with pip
+
+1. **Create a Virtual Environment**  
+   ```bash
+   python -m venv snowmappy_env
+   source snowmappy_env/bin/activate  # macOS/Linux
+   snowmappy_env\Scripts\activate     # Windows
+   ```
+
+2. **Install SnowMapPy**  
+   ```bash
+   pip install SnowMapPy
+   ```
+
+### Option 3: Run with Docker
+
+1. **Pull the Docker Image**  
+   ```bash
+   docker pull your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+2. **Run the Container**  
+   ```bash
+   docker run -it your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+3. **Mount Local Data (Optional)**  
+   To process local files, mount your data directory:
+   ```bash
+   docker run -it -v /path/to/data:/app/data your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+---
+
+## 🎯 Quick Start
+
+### Cloud Processing Example
+
+```python
+from SnowMapPy.cloud.processor import process_modis_ndsi_cloud
+
+# Process MODIS NDSI data from Google Earth Engine
+result = process_modis_ndsi_cloud(
+    project_name="your-gee-project",
+    shapefile_path="path/to/roi.shp",
+    start_date="2023-01-01",
+    end_date="2023-01-31",
+    output_path="output/",
+    file_name="snow_cover"
+)
+```
+
+### Local Processing Example
+
+```python
+from SnowMapPy.local.processor import process_modis_ndsi_local
+
+# Process locally stored MODIS NDSI files
+result = process_modis_ndsi_local(
+    mod_dir="path/to/MOD/files/",
+    myd_dir="path/to/MYD/files/",
+    dem_file="path/to/dem.tif",
+    output_path="output/",
+    file_name="local_snow_cover"
+)
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. **GDAL or Proj Library Not Found**
+- **Solution for Conda**: Ensure you installed the package from Conda-Forge:
+  ```bash
+  conda install -c conda-forge snowmappy
+  ```
+
+#### 2. **Earth Engine Authentication Fails**
+- **Solution**: Re-authenticate:
+  ```bash
+  earthengine authenticate --force
+  ```
+
+#### 3. **Memory Errors During Processing**
+- **Solutions**:
+  - Reduce the date range or spatial extent.
+  - Increase virtual memory/swap space.
+  - Use a machine with more RAM.
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Commit your changes.
+4. Push to the branch.
+5. Open a Pull Request.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

snowmappy-1.0.2/SnowMapPy.egg-info/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: SnowMapPy
+Version: 1.0.2
+Summary: A comprehensive Python package for processing MODIS NDSI data from local files and Google Earth Engine
+Home-page: https://github.com/haytamelyo/SnowMapPy
+Author: Haytam Elyoussfi
+Author-email: Haytam Elyoussfi <haytam.elyoussfi@um6p.ma>, Hatim Bechri <Hatim.bechri@usms.ac.ma>
+License-Expression: MIT
+Project-URL: Bug Reports, https://github.com/haytamelyo/SnowMapPy/issues
+Project-URL: Source, https://github.com/haytamelyo/SnowMapPy
+Project-URL: Documentation, https://github.com/haytamelyo/SnowMapPy#readme
+Keywords: modis,snow,remote sensing,earth engine,gis,hydrology
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: xarray
+Requires-Dist: rasterio
+Requires-Dist: geopandas
+Requires-Dist: earthengine-api
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SnowMapPy 🌨️
+
+A Python package for processing MODIS NDSI (Normalized Difference Snow Index) data from local files and Google Earth Engine. Designed for hydrologists, geographers, and water resource managers, SnowMapPy simplifies snow cover analysis with minimal Python expertise required.
+
+---
+
+## 📋 Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+  - [Option 1: Install with Conda (Recommended)](#option-1-install-with-conda-recommended)
+  - [Option 2: Install with pip](#option-2-install-with-pip)
+  - [Option 3: Run with Docker](#option-3-run-with-docker)
+- [Quick Start](#quick-start)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## ✨ Features
+
+- **Cloud Processing**: Process MODIS NDSI data directly from Google Earth Engine.
+- **Local Processing**: Handle locally stored MODIS NDSI files.
+- **Quality Control**: Mask invalid data using advanced techniques.
+- **Temporal Interpolation**: Fill missing data points efficiently.
+- **Spatial Operations**: Clip data to regions of interest.
+- **Data Export**: Save processed data in Zarr format.
+
+---
+
+## 🚀 Installation
+
+SnowMapPy requires Python 3.8 or higher. We recommend using **Conda** for managing dependencies, especially for Windows users.
+
+### Option 1: Install with Conda (Recommended)
+
+Install SnowMapPy directly from Conda-Forge:
+```bash
+conda install -c conda-forge snowmappy
+```
+
+### Option 2: Install with pip
+
+1. **Create a Virtual Environment**  
+   ```bash
+   python -m venv snowmappy_env
+   source snowmappy_env/bin/activate  # macOS/Linux
+   snowmappy_env\Scripts\activate     # Windows
+   ```
+
+2. **Install SnowMapPy**  
+   ```bash
+   pip install SnowMapPy
+   ```
+
+### Option 3: Run with Docker
+
+1. **Pull the Docker Image**  
+   ```bash
+   docker pull your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+2. **Run the Container**  
+   ```bash
+   docker run -it your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+3. **Mount Local Data (Optional)**  
+   To process local files, mount your data directory:
+   ```bash
+   docker run -it -v /path/to/data:/app/data your-dockerhub-username/snowmappy:1.0.2
+   ```
+
+---
+
+## 🎯 Quick Start
+
+### Cloud Processing Example
+
+```python
+from SnowMapPy.cloud.processor import process_modis_ndsi_cloud
+
+# Process MODIS NDSI data from Google Earth Engine
+result = process_modis_ndsi_cloud(
+    project_name="your-gee-project",
+    shapefile_path="path/to/roi.shp",
+    start_date="2023-01-01",
+    end_date="2023-01-31",
+    output_path="output/",
+    file_name="snow_cover"
+)
+```
+
+### Local Processing Example
+
+```python
+from SnowMapPy.local.processor import process_modis_ndsi_local
+
+# Process locally stored MODIS NDSI files
+result = process_modis_ndsi_local(
+    mod_dir="path/to/MOD/files/",
+    myd_dir="path/to/MYD/files/",
+    dem_file="path/to/dem.tif",
+    output_path="output/",
+    file_name="local_snow_cover"
+)
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. **GDAL or Proj Library Not Found**
+- **Solution for Conda**: Ensure you installed the package from Conda-Forge:
+  ```bash
+  conda install -c conda-forge snowmappy
+  ```
+
+#### 2. **Earth Engine Authentication Fails**
+- **Solution**: Re-authenticate:
+  ```bash
+  earthengine authenticate --force
+  ```
+
+#### 3. **Memory Errors During Processing**
+- **Solutions**:
+  - Reduce the date range or spatial extent.
+  - Increase virtual memory/swap space.
+  - Use a machine with more RAM.
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Commit your changes.
+4. Push to the branch.
+5. Open a Pull Request.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

{snowmappy-1.0.1 → snowmappy-1.0.2}/SnowMapPy.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
+LICENSE
 MANIFEST.in
 README.md
 TESTING.md
+pyproject.toml
 requirements.txt
 setup.py
 SnowMapPy.egg-info/PKG-INFO

snowmappy-1.0.2/SnowMapPy.egg-info/requires.txt

@@ -0,0 +1,11 @@
+numpy
+pandas
+xarray
+rasterio
+geopandas
+earthengine-api
+
+[dev]
+pytest>=6.0
+flake8>=3.8
+black>=21.0

snowmappy-1.0.2/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=40.8.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "SnowMapPy"
+version = "1.0.2"
+description = "A comprehensive Python package for processing MODIS NDSI data from local files and Google Earth Engine"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Haytam Elyoussfi", email = "haytam.elyoussfi@um6p.ma" },
+    { name = "Hatim Bechri", email = "Hatim.bechri@usms.ac.ma" }
+]
+keywords = ["modis", "snow", "remote sensing", "earth engine", "gis", "hydrology"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Scientific/Engineering :: Atmospheric Science"
+]
+dependencies = [
+    "numpy",
+    "pandas",
+    "xarray",
+    "rasterio",
+    "geopandas",
+    "earthengine-api"
+]
+requires-python = ">=3.8"
+urls = { "Bug Reports" = "https://github.com/haytamelyo/SnowMapPy/issues", "Source" = "https://github.com/haytamelyo/SnowMapPy", "Documentation" = "https://github.com/haytamelyo/SnowMapPy#readme" }
+optional-dependencies = { dev = ["pytest>=6.0", "flake8>=3.8", "black>=21.0"] }
+dynamic = []

{snowmappy-1.0.1 → snowmappy-1.0.2}/requirements.txt

@@ -3,8 +3,13 @@ numpy==2.1.0
 scipy==1.15.2
 pandas==2.2.3
 
+# Python packaging and utilities
+setuptools==75.1.0
+pycrs==1.0.2
+
 # Geospatial processing
 rasterio==1.4.3
+rioxarray==0.19.0
 geopandas==1.0.1
 pyproj==3.7.1
 shapely==2.1.0
@@ -20,6 +25,7 @@ netCDF4==1.7.2
 # Google Earth Engine
 earthengine-api==1.5.9
 geemap==0.35.3
+xee==0.0.20
 
 # Progress bars and utilities
 tqdm==4.66.4

{snowmappy-1.0.1 → snowmappy-1.0.2}/setup.py

@@ -8,27 +8,14 @@ with open("requirements.txt", "r", encoding="utf-8") as fh:
 
 setup(
     name="SnowMapPy",
-    version="1.0.1",  # Updated version
+    version="1.0.2",  # Updated version
     author="Haytam Elyoussfi",
     author_email="haytam.elyoussfi@um6p.ma",
     description="A comprehensive Python package for processing MODIS NDSI data from local files and Google Earth Engine",
     long_description=long_description,
     long_description_content_type="text/markdown",
-    url="https://github.com/Hbechri/SnowMapPy",
+    url="https://github.com/haytamelyo/SnowMapPy",
     packages=find_packages(),
-    classifiers=[
-        "Development Status :: 4 - Beta",
-        "Intended Audience :: Science/Research",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Topic :: Scientific/Engineering :: GIS",
-        "Topic :: Scientific/Engineering :: Atmospheric Science",
-    ],
     python_requires=">=3.8",
     install_requires=requirements,
     extras_require={
@@ -40,8 +27,8 @@ setup(
     },
     keywords="modis, snow, remote sensing, earth engine, gis, hydrology",
     project_urls={
-        "Bug Reports": "https://github.com/Hbechri/SnowMapPy/issues",
-        "Source": "https://github.com/Hbechri/SnowMapPy",
-        "Documentation": "https://github.com/Hbechri/SnowMapPy#readme",
+        "Bug Reports": "https://github.com/haytamelyo/SnowMapPy/issues",
+        "Source": "https://github.com/haytamelyo/SnowMapPy",
+        "Documentation": "https://github.com/haytamelyo/SnowMapPy#readme",
     },
 )