PySAD v0.3.1 Release Notes

Release Date: June 4, 2025
Version: 0.3.1
Previous Version: 0.3.0 (May 23, 2025)

🚀 What's New in v0.3.1

This release focuses on significant documentation enhancements and community engagement improvements, along with important bug fixes to enhance the user experience and project visibility.

📚 Major Documentation Enhancements

Community Engagement Section

• Added comprehensive community engagement section highlighting PySAD's growing impact:
  • Academic recognition with 50+ citations to the arXiv version
  • GitHub community growth with 260+ stars
  • Strong PyPI download statistics (2K+ monthly downloads)
  • Educational content integration across multiple platforms

Educational Content Integration

• Featured educational content across multiple platforms:
  • Medium articles covering real-time anomaly detection applications
  • Comprehensive resource collections and guides
  • Industrial AI implementation challenges

Third-Party Integrations

• Documented major framework integrations:
  • TurboML Integration: PySAD example documentation in ML workflow platforms
  • Apache Beam Integration: PySAD modules adapted into Apache Beam's ML package (zscore, robust_zscore detectors)
  • River ML Integration: StandardAbsoluteDeviation detector with explicit PySAD references

Developer Community Highlights

• Widespread GitHub usage statistics:
  • 50+ files using import pysad across repositories
  • 200+ files using from pysad implementations
• External projects showcase:
  • Online Isolation Forest implementations
  • Academic final projects
  • Natural gas wells anomaly detection
  • EuroPython 2024 conference materials

🐛 Bug Fixes and Improvements

Documentation Formatting

• Fixed sublist formatting in README.rst: Corrected reStructuredText nested list syntax for proper rendering
• Enhanced reStructuredText compliance: Improved indentation and spacing for better documentation display

Error Handling Improvements

• Enhanced Inqmad model import handling: Improved error handling to cover undefined names and import edge cases
• Better error messages: More informative error handling for optional dependencies

🔧 Technical Changes

Version Management

• Updated version from 0.3.0 to 0.3.1 in pysad/version.py
• Updated changelog in CHANGES.txt with comprehensive release notes

Code Quality

• Maintained backward compatibility with all existing APIs
• No breaking changes introduced
• Enhanced code documentation and comments

📊 Community Impact Highlights

This release showcases PySAD's significant community impact:

• Academic Recognition: Growing adoption in streaming data research
• Industry Usage: Integration with major ML frameworks and platforms
• Educational Impact: Featured in educational content and tutorials
• Developer Adoption: Widespread usage across GitHub repositories
• Download Growth: Consistent weekly usage with growing PyPI statistics

🔗 Quick Links

• GitHub Repository: https://github.com/selimfirat/pysad
• Documentation: https://pysad.readthedocs.io/
• PyPI Package: https://pypi.org/project/pysad/
• Google Scholar: Citation metrics and academic impact

📦 Installation

Install or upgrade to v0.3.1:

pip install -U pysad==0.3.1

Or install from source:

git clone https://github.com/selimfirat/pysad.git
cd pysad
git checkout v0.3.1
pip install .

🔄 Migration Guide

No migration steps required. This release maintains full backward compatibility with v0.3.0.

📝 Files Changed

• pysad/version.py - Version bump to 0.3.1
• CHANGES.txt - Added changelog entry for v0.3.1
• README.rst - Enhanced with community engagement sections and fixed formatting

🙏 Acknowledgments

Special thanks to the community for continued support and feedback. The growing adoption across academia and industry demonstrates PySAD's value in the streaming anomaly detection ecosystem.

Full Changelog: v0.3.0...v0.3.1

For questions or support, please visit our GitHub repository or check our documentation.