Water Quality Analyzer 🌊

A Python tool for analyzing and visualizing water quality data to support environmental monitoring and community awareness.

Overview

The Water Quality Analyzer helps environmental scientists, researchers, and activists analyze water quality datasets. It provides statistical analysis, trend detection, and professional visualizations to support data-driven environmental decisions.

Features

• 📊 Statistical Analysis: Calculate mean, median, standard deviation, and percentiles
• 📈 Trend Visualization: Plot time-series data with automatic trend lines
• 🎯 Standards Compliance: Compare measurements against EPA water quality standards
• 📍 Location Comparison: Compare water quality across multiple monitoring sites
• 🔍 Outlier Detection: Identify unusual measurements using box plots
• 📁 Flexible Input: Supports both CSV and Excel file formats

Installation

Prerequisites

• Python 3.7 or higher
• pip package manager

Setup

1. Clone this repository:

git clone https://github.com/yourusername/water-quality-analyzer.git
cd water-quality-analyzer

2. Install required dependencies:

pip install -r requirements.txt

Usage

Basic Example

from water_quality_analyzer import WaterQualityAnalyzer

# Initialize the analyzer with your data file
analyzer = WaterQualityAnalyzer('water_data.csv')

# Explore your dataset
columns = analyzer.explore_data()

# Generate a comprehensive report
analyzer.generate_report(
    parameter_column='pH',
    date_column='ActivityStartDate',
    location_column='MonitoringLocationName'
)

Step-by-Step Guide

1. Prepare Your Data: Ensure your CSV or Excel file contains:

   • Water quality measurements (pH, dissolved oxygen, temperature, etc.)
   • Date/time stamps
   • Location identifiers (optional)

2. Explore the Dataset:

analyzer = WaterQualityAnalyzer('your_data.csv')
columns = analyzer.explore_data()

3. Analyze Specific Parameters:

# Clean and analyze data
df = analyzer.clean_data('pH', date_column='Date')
stats = analyzer.analyze_parameter(df, 'pH')

4. Create Visualizations:

# Distribution plots
analyzer.plot_distribution(df, 'pH')

# Time series trends
analyzer.plot_trends(df, 'pH', 'Date')

# Location comparisons
analyzer.plot_comparison(df, 'pH', 'Location')

Data Format

Your input file should contain columns such as:

Column Name	Description	Example
pH	pH measurement	7.2
Temperature	Water temperature (°C)	18.5
Dissolved Oxygen	DO level (mg/L)	8.3
ActivityStartDate	Measurement date	2024-01-15
MonitoringLocationName	Sample location	River Site A

Water Quality Standards

The analyzer includes EPA water quality standards for:

• pH: 6.5 - 8.5
• Dissolved Oxygen: ≥ 5.0 mg/L
• Temperature: 0 - 30°C
• Turbidity: 0 - 5 NTU
• Nitrate: 0 - 10 mg/L
• Phosphorus: 0 - 0.1 mg/L

These can be customized in the standards dictionary.

Output Files

The analyzer generates high-resolution PNG images:

• {parameter}_distribution.png - Histogram and box plot
• {parameter}_trend.png - Time series with trend line
• {parameter}_comparison.png - Multi-location comparison

All images are saved at 300 DPI for publication quality.

Example Visualizations

The tool creates three types of plots:

1. Distribution Analysis: Shows the frequency distribution and identifies outliers
2. Trend Analysis: Displays changes over time with regression lines
3. Location Comparison: Compares measurements across different monitoring sites

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Data Setup

This repository includes example_data.csv for demonstration purposes. To analyze your own water quality data:

1. Place your CSV file in the project directory
2. The .gitignore file will prevent your data from being committed to GitHub
3. Run the analyzer with your filename: WaterQualityAnalyzer('your_data.csv')

Note: Only example_data.csv is tracked in this repository. Your actual data files remain private on your local machine.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• EPA water quality standards documentation
• Environmental monitoring community
• Open source data visualization libraries

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Check existing issues for solutions
• Review the documentation

Roadmap

• Add support for more water quality parameters
• Implement seasonal analysis
• Add interactive dashboard
• Export reports to PDF
• Integration with real-time monitoring systems
• Multi-language support

Citation

If you use this tool in your research, please cite:

Water Quality Analyzer (2024). Available at: https://github.com/yourusername/water-quality-analyzer

---

Made with 💙 for environmental conservation