FAQ

Reference for everything outside the modeling tutorials: install errors, dev workflow, styling and citation, and AI-assisted coding guidance.

Note

Looking for modeling-time surprises (a number that looks wrong, a unit that sized weirdly, a sim that won’t converge)? See Modeling Notes & Pitfalls.

• AI-Assisted Development
  • Why AI Tools for Contributors?
  • Setup
  • Development environment
  • Key Concepts for Contributors
  • Skills in practice: Superpowers
  • MCP in practice: NotebookLM
  • QSDsan/EXPOsan Architecture Tour with AI
  • Contributor Workflow
  • Going Deeper
• Common Errors
  • Graphviz Installation
  • ModuleNotFoundError
  • underlying object has vanished
  • UnicodeDecodeError
  • Version compatibility
• Tips
  • Setting up a development environment
  • Archive Branch
  • Pickle Protocol
  • Private Fork
  • Upgrade Python
  • EXPOsan orientation
• Styling and Citation
  • QSDsan vs. qsdsan
  • Citing QSDsan