Appearance
Getting Started with ErgoPlanner
Welcome to ErgoPlanner, the comprehensive wastewater treatment plant simulation platform. This section will help you get up and running quickly.
What is ErgoPlanner?
ErgoPlanner is a modern, web-based simulation platform for wastewater treatment plants that combines:
- Process Design: Drag-and-drop interface for building treatment plant diagrams
- Advanced Simulation: Steady-state and dynamic simulation with multiple biokinetic models
- Carbon Footprint: Comprehensive Scope 1/2/3 emissions tracking
- Results Analysis: Interactive charts, tables, and data export capabilities
Quick Navigation
Essential First Steps
- Installation - Browser requirements and deployment options (5 min)
- First-Simulation - Complete your first simulation (15 min)
- Interface-Overview - Learn the UI layout and navigation (10 min)
Reference Materials
- Keyboard-Shortcuts - Productivity shortcuts reference
- Account-Setup - Preferences and settings configuration
- Finding-Things - What the top-bar search box searches, and what it does not
Learning Path
For New Users
- Start with Installation to ensure your environment is ready
- Follow First-Simulation step-by-step to understand the workflow
- Review Interface-Overview to learn where everything is located
- Explore User-Guide for detailed workflow documentation
For Experienced Engineers
- Skim Installation and Interface-Overview
- Jump directly to Creating-Projects
- Review Biokinetic-Models for advanced model configuration
- Check Model-Calibration for optimization techniques
What You'll Learn
Basic Skills (30 minutes)
- Creating and managing projects
- Building process diagrams using drag-and-drop
- Running steady-state simulations
- Viewing and interpreting results
Intermediate Skills (1-2 hours)
- Configuring biokinetic models (ASM1, ASM2d, ASM3)
- Setting up dynamic simulations with time-series data
- Using controllers for automated process control
- Exporting data and generating reports
Advanced Skills (2-4 hours)
- Model calibration and parameter tuning
- Multi-scenario sensitivity analysis
- Carbon footprint analysis and optimization
- Performance optimization for large models
System Requirements
Minimum Requirements
- Modern web browser (Chrome 90+, Firefox 88+, Edge 90+, Safari 14+)
- 4 GB RAM
- 1280x720 screen resolution
- Stable internet connection (for cloud deployment)
Recommended Requirements
- Chrome 120+ or Edge 120+ (best performance)
- 8 GB RAM or more
- 1920x1080 or higher resolution
- Modern GPU for smooth canvas rendering
Browser Compatibility
| Browser | Minimum Version | Recommended | Notes |
|---|---|---|---|
| Chrome | 90+ | 120+ | Best performance and feature support |
| Firefox | 88+ | 115+ | Full feature support |
| Edge | 90+ | 120+ | Chromium-based, excellent support |
| Safari | 14+ | 17+ | Limited testing, some features may vary |
Getting Help
Documentation Resources
- User-Guide - Complete workflow documentation
- Tutorials - Step-by-step advanced tutorials
- Best-Practices - Expert tips and techniques
- Troubleshooting - Common issues and solutions
Support Channels
- Technical Documentation: This wiki
- API Reference: API-Reference for developers
- Issue Tracker: Report bugs and request features
- Community Forum: Ask questions and share knowledge
Common First-Time Questions
"Do I need to install anything?"
No! ErgoPlanner runs entirely in your web browser. Just navigate to the deployment URL and start working. See Installation for browser requirements.
"Can I try it without creating an account?"
Yes, you can explore demo projects and run simulations without an account. However, creating an account is recommended to save your work. See Account-Setup.
"What if I've never used simulation software before?"
Perfect! Start with First-Simulation which guides you through a complete example. No prior experience needed.
"How long does it take to learn?"
Most users can run their first simulation within 15 minutes. Building proficiency with advanced features typically takes 4-8 hours of practice.
"Can I import data from other software?"
ErgoPlanner supports various import formats including CSV for time-series data and JSON for project templates. See Exporting-Data for details.
Next Steps
Ready to get started? Choose your path:
Path 1: Guided Tutorial (Recommended)
Follow our complete getting started sequence:
- Installation - Set up your environment
- First-Simulation - Run your first simulation
- Interface-Overview - Learn the interface
Path 2: Jump Right In
For experienced users who want to start immediately:
- Check Installation requirements (2 min)
- Go to Creating-Projects (start building)
- Reference Keyboard-Shortcuts as needed
Path 3: Explore Examples
Want to see what's possible first?
- Browse Templates for pre-built examples
- Open a template project
- Explore the interface using Interface-Overview
Estimated Time to Complete This Section: 30-45 minutes
Difficulty Level: Beginner
Prerequisites: None - start here!
Last updated: December 2025