tgrover24/baghouse-simulator repository overview

⁠Baghouse Simulator

A comprehensive web-based simulation tool for modeling material flow through baghouse dust collector systems. This application helps engineers and operators visualize material distribution, analyze residence times, and optimize system performance under various operating conditions.

⁠🎯 What It Does

The Baghouse Simulator models the complete material flow cycle in industrial dust collection systems:

• Material Input: Configurable flow rates with custom distribution patterns
• Bag Filtration: Simulates dust accumulation on filter bags with customizable pulsing cycles
• Screw Conveyor: Models material movement with adjustable progression times
• Rotary Valve Discharge: Simulates material exit with configurable discharge rates
• Particle Tracking: Advanced residence time analysis with mass-weighted statistics

⁠🚀 Key Features

⁠Interactive Web Interface

• Real-time Parameter Adjustment: Modify simulation settings through an intuitive Streamlit interface
• Multiple Visualization Modes: Animation, current state plots, time-series analysis, and heatmaps
• Residence Time Analysis: Comprehensive statistics including percentiles and cumulative distribution functions

⁠Advanced Analytics

• Material Flow Tracking: Individual particle tracking with entry position and residence time data
• Statistical Analysis: Weighted mean/standard deviation calculations and percentile analysis
• Visual Analytics: Interactive charts, animated GIFs, and distribution heatmaps

⁠Batch Processing

• Excel Integration: Run multiple simulations from Excel parameter files
• Automated Reporting: Generate comprehensive reports with embedded plots and statistics
• Bulk Animation: Optional GIF generation for multiple simulation runs

⁠Configuration Management

• Save/Load Configurations: Persistent storage of simulation parameters
• Template Support: Pre-configured templates for common scenarios
• Export Capabilities: Download configurations and results for external analysis

⁠🛠️ Quick Start

⁠Using Docker (Recommended)

1. Download the deployment files:

   • docker-compose.yml
   • .env.example
   • Platform-specific start/stop scripts

2. Configure your environment:

   cp .env.example .env
   # Edit .env with your settings:
   # DOCKER_IMAGE=your-dockerhub-username/baghouse-simulator:latest
   # HOST_PORT=8501
   # HOST_SAVE_DIR=./saved_configs_host
   

   Copy

3. Create the save directory:

   mkdir -p ./saved_configs_host
   

   Copy

4. Start the application:

   • Linux/macOS: ./start.sh
   • Windows: Double-click start.bat

5. Access the interface: Open http://localhost:8501 in your browser

⁠Configuration Parameters

⁠📊 Output & Analysis

⁠Visualization Options

• Real-time Animation: Watch material flow through the system
• Current State Plots: Snapshot views at any time step
• Time Series Analysis: Material accumulation and discharge over time
• Distribution Heatmaps: Spatial and temporal material distribution patterns
• Residence Time Histograms: Both count-based and mass-weighted distributions

⁠Statistical Outputs

• Residence Time Statistics: Mean, standard deviation, and percentiles
• Mass Balance: Track material input, accumulation, and discharge
• System Performance: Efficiency metrics and bottleneck identification

⁠🔧 Advanced Features

⁠Custom Pulse Patterns

Define complex bag cleaning sequences:

# Example: Alternating outside-in pattern
[[0,49], [1,48], [2,47], [24,25]]

⁠Material Distribution

Configure non-uniform input distributions:

# Example: Higher concentration at center positions
[2, 4, 6, 8, 10, 8, 6, 4, 2]  # Must sum to 100%

⁠Batch Processing

Process multiple scenarios from Excel files with automatic report generation including:

• Parameter summaries
• Statistical analysis
• Embedded plots
• Optional animation GIFs

⁠🏭 Use Cases

• System Design: Optimize baghouse configurations before construction
• Performance Analysis: Identify bottlenecks and efficiency improvements
• Maintenance Planning: Predict cleaning cycle requirements
• Training: Educational tool for understanding dust collection principles
• Research: Academic studies on particle flow and residence time distributions

⁠📋 System Requirements

• Docker: Latest version with Docker Compose
• Memory: 2GB+ RAM recommended for complex simulations
• Storage: Minimal (configurations and results are small files)
• Browser: Modern web browser with JavaScript enabled

⁠🔄 Updates & Versioning

This image is regularly updated with:

• Performance improvements
• New visualization features
• Enhanced statistical analysis
• Bug fixes and stability improvements

Use version tags for production deployments:

• latest: Most recent stable release
• v1.x.x: Specific version releases
• develop: Latest development features (may be unstable)

⁠📞 Support & Documentation

• Issues: Report bugs and feature requests on the project repository
• Documentation: Comprehensive user guide included in the container
• Examples: Sample configuration files and batch templates provided

Tags: simulation, engineering, dust-collection, baghouse, material-flow, industrial, streamlit, python, analytics