# Changelog

All notable changes to `gdptools` are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## Current Version: 0.2.21

```{include} ../HISTORY.md
:start-after: "# History"
```

**→ [View complete version history](https://code.usgs.gov/wma/nhgf/toolsteam/gdptools/-/blob/main/HISTORY.md)**

## Quick Version Info

```{eval-rst}
.. currentmodule:: gdptools

Current version: |version|
```

## Recent Highlights

### New Features

- Enhanced parallel processing capabilities
- Improved STAC catalog integration
- Better error handling and validation
- Expanded statistical functions

### Performance Improvements

- Optimized spatial indexing
- Reduced memory footprint for large datasets
- Faster coordinate transformations
- Improved Dask integration

### Documentation Enhancements

- Comprehensive API documentation
- Interactive examples and tutorials
- Better error message explanations
- Enhanced getting started guide

## Installation Matrix

| Python Version | Status       | Installation             |
| :------------- | :----------- | :----------------------- |
| 3.9            | ✅ Supported | `conda install gdptools` |
| 3.10           | ✅ Supported | `conda install gdptools` |
| 3.11           | ✅ Supported | `conda install gdptools` |
| 3.12           | ✅ Supported | `conda install gdptools` |
| 3.13           | ⚠️ Testing   | `pip install gdptools`   |

## Dependencies

### Core Dependencies

- `geopandas >= 0.12.0`
- `pandas >= 1.5.0`
- `numpy >= 1.21.0`
- `xarray >= 2022.6.0`
- `shapely >= 2.0.0`
- `pyproj >= 3.4.0`

### Optional Dependencies

- `dask[distributed]` for distributed computing
- `exactextract` for high-performance zonal statistics
- `bokeh` for interactive visualizations
- `holoviews` for advanced plotting

## Platform Support

| Platform | Status          | Notes                         |
| :------- | :-------------- | :---------------------------- |
| Linux    | ✅ Full Support | Recommended for production    |
| macOS    | ✅ Full Support | Intel and Apple Silicon       |
| Windows  | ⚠️ Limited      | Some features may require WSL |

## Getting Help

- **Documentation**: You're reading it! 📚
- **Examples**: Check out our [tutorials](getting_started.md)
- **Issues**: [Report bugs](https://code.usgs.gov/wma/nhgf/toolsteam/gdptools/-/issues)
- **Discussions**: [Ask questions](https://code.usgs.gov/wma/nhgf/toolsteam/gdptools/-/discussions)

## Contributing

We welcome contributions! See our [contributing guide](contributing.md) for:

- How to set up development environment
- Code style guidelines
- Testing requirements
- Documentation standards