Initial commit: idd-spatial-analysis package

Author: bcreiner

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11"]
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install poetry
+        poetry install
+    
+    - name: Run tests
+      run: |
+        poetry run pytest
+    
+    - name: Check code formatting
+      run: |
+        poetry run black --check src/
+        poetry run isort --check-only src/

.gitignore

@@ -0,0 +1,72 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# Poetry
+poetry.lock
+
+# Jupyter
+.ipynb_checkpoints
+*.ipynb
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Data files
+*.shp
+*.shx
+*.dbf
+*.prj
+*.tif
+*.tiff
+*.nc
+*.zarr
+*.csv
+*.parquet
+
+# Exclude data directories but keep structure
+data/*
+!data/.gitkeep
+
+# Logs
+*.log
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Documentation
+docs/_build/

DESCRIPTION.yaml

@@ -0,0 +1,16 @@
+name: idd-spatial-analysis
+version: 0.1.0
+description: Geospatial analysis tools for IDD research
+authors:
+  - name: Your Name
+    email: your.email@uw.edu
+license: MIT
+repository: https://github.com/ihmeuw/idd-spatial-analysis
+keywords:
+  - geospatial
+  - gis
+  - spatial-analysis
+  - geopandas
+  - climate
+  - epidemiology
+python_requires: ">=3.10"

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Institute for Health Metrics and Evaluation (IHME)
+
+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.

README.md

@@ -0,0 +1,87 @@
+# IDD Spatial Analysis
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Poetry](https://img.shields.io/badge/poetry-managed-blue.svg)](https://python-poetry.org/)
+
+Repository for IDD geospatial analysis tools and utilities in Python.
+
+## 🚀 Quick Start
+
+### Local Installation
+
+#### Option 1: Using Conda (Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/ihmeuw/idd-spatial-analysis.git
+cd idd-spatial-analysis
+
+# Create and activate the conda environment
+conda env create -f environment.yml
+conda activate idd-spatial-analysis
+```
+
+#### Option 2: Using Poetry
+
+```bash
+# Clone the repository
+git clone https://github.com/ihmeuw/idd-spatial-analysis.git
+cd idd-spatial-analysis
+
+# Install dependencies with poetry
+poetry install
+poetry shell
+```
+
+#### Option 3: Install as a Python package (from GitHub)
+
+You can install and use `idd_spatial_analysis` in other projects/environments:
+
+```bash
+pip install git+https://github.com/ihmeuw/idd-spatial-analysis.git
+```
+
+Then, in your Python code:
+
+```python
+from idd_spatial_analysis import spatial_utils
+
+# Your geospatial analysis code here
+```
+
+## 📦 Package Structure
+
+```
+idd-spatial-analysis/
+├── src/
+│   └── idd_spatial_analysis/    # Main package
+│       ├── __init__.py
+│       └── spatial_utils.py     # Core spatial utilities
+├── notebooks/                   # Example notebooks
+├── tests/                       # Unit tests
+├── pyproject.toml              # Poetry configuration
+├── environment.yml             # Conda environment
+└── README.md
+```
+
+## 🛠️ Development
+
+### Running Tests
+
+```bash
+poetry run pytest
+```
+
+### Code Formatting
+
+```bash
+# Format with black
+poetry run black src/
+
+# Sort imports
+poetry run isort src/
+```
+
+## 📝 License
+
+MIT License - see LICENSE file for details.