Appearance
Common Issues
Solutions to frequently encountered problems
Simulation Issues
Simulation Not Converging
Symptoms:
- Progress bar stuck
- "Max iterations reached" message
- Oscillating residual values
Solutions:
| Cause | Fix |
|---|---|
| Disconnected stream | Check all units connected |
| Missing influent data | Complete influent composition |
| Unrealistic parameters | Review unit settings |
| Large recycle ratio | Reduce IRR/RAS, add initial guess |
| Stiff system | Reduce time step, relax tolerance |
Step-by-step fix:
- Simplify to basic mode
- Remove recycle streams temporarily
- Verify each section converges
- Add recycles back one at a time
Negative Concentrations
Symptoms:
- Negative COD, TSS, or N values
- Solver warnings
- Unrealistic results
Solutions:
- Check kinetic parameters (especially yields)
- Verify stoichiometry settings
- Reduce time step for dynamic simulation
- Use appropriate solver settings
Mass Balance Not Closing
Symptoms:
- Balance column shows >1% error
- Unexplained mass loss/gain
Solutions:
- Check for disconnected streams
- Verify all splitter ratios sum to 100%
- Look for missing WAS/effluent streams
- Ensure all recycles are connected
Unit Configuration Issues
Can't Add Units to Canvas
Check:
- Browser zoom at 100%
- Canvas not locked
- Stencil panel visible
- Mouse/trackpad working
Fix:
- Refresh browser
- Clear browser cache
- Try different browser
Units Won't Connect
Possible causes:
| Issue | Solution |
|---|---|
| Wrong port types | Match liquid/sludge/gas types |
| Unit locked | Unlock in properties |
| Connection exists | Delete existing connection first |
| Port occupied | Use available port |
Properties Not Saving
Solutions:
- Click outside field after editing
- Press Enter to confirm
- Check for validation errors (red outline)
- Ensure valid number format
Results Issues
Results Not Updating
Try:
- Re-run simulation
- Click refresh button
- Clear browser cache
- Check for errors in simulation log
Unexpected Effluent Quality
Common causes:
| Symptom | Likely Cause | Check |
|---|---|---|
| High NH4 | Low SRT | Increase sludge age |
| High NO3 | Low IRR | Increase internal recycle |
| High TSS | Clarifier overloaded | Check SOR, SLR |
| High COD | Insufficient treatment | Check HRT, MLSS |
| High TP | EBPR failure | Check anaerobic zone, VFA |
Missing Stream Labels
Enable labels:
- View > Show Stream Labels
- Select streams
- Right-click > Show Labels
- Choose parameters to display
Performance Issues
Application Running Slowly
Immediate fixes:
- Close other browser tabs
- Reduce canvas zoom
- Disable mini-map
- Hide results panel during editing
Longer-term solutions:
- Use supported browser (Chrome recommended)
- Increase system RAM
- Clear browser cache
- Split large projects
Browser Crashes
Prevent crashes:
- Save frequently (
Ctrl + S) - Export backups regularly
- Limit project complexity
- Update browser to latest version
Memory Warnings
Reduce memory usage:
- Close unused projects
- Reduce output parameters in dynamic simulation
- Use shorter simulation durations
- Export and clear old results
Export Issues
PDF Export Failed
Solutions:
- Reduce diagram size
- Simplify annotations
- Try smaller page size
- Export sections separately
Excel Export Incomplete
Check:
- All parameters selected
- Simulation completed successfully
- Sufficient disk space
- Valid file path
DXF Import Problems
Compatibility:
- Use DXF R2013 or R2018 format
- Avoid complex geometry
- Check layer mapping settings
- Simplify before export
Account Issues
Can't Log In
Try:
- Check email/password
- Reset password
- Clear browser cookies
- Try incognito mode
- Contact support
Project Not Saving
Check:
- Internet connection
- Account permissions
- Storage quota
- Browser permissions
Sharing Not Working
Verify:
- Collaborator email correct
- Permissions set appropriately
- Collaborator has account
- Email not in spam
Browser-Specific Issues
Chrome
| Issue | Solution |
|---|---|
| Slow rendering | Enable hardware acceleration |
| Memory leaks | Clear cache, restart browser |
| Extension conflicts | Try incognito mode |
Firefox
| Issue | Solution |
|---|---|
| Canvas issues | Update to latest version |
| Session lost | Disable tracking protection |
| Print problems | Use Chrome for PDF export |
Safari
| Issue | Solution |
|---|---|
| Login issues | Enable all cookies |
| Display problems | Update macOS |
| Touch issues | Disable gestures |
Edge
| Issue | Solution |
|---|---|
| Compatibility | Use Chromium-based Edge |
| Extensions | Disable conflicting add-ons |
Error Messages
"Connection Failed"
- Check internet connection
- Verify firewall settings
- Try different network
"Session Expired"
- Log in again
- Enable cookies
- Don't use incognito for long sessions
"Invalid Parameter"
- Check value is numeric
- Verify units are correct
- Stay within valid range
"File Too Large"
- Reduce project complexity
- Export in sections
- Contact support for limits
Getting More Help
If your issue isn't listed:
- Check FAQ: Frequently Asked Questions
- Search documentation: Use the search function
- Community forum: Ask other users
- GitHub Issues: Report bugs
- Contact support: For account issues