Welcome to the MORPHE2US documentation!

MORPHE2US (Municipal Optimization for Renewable Projects in Hydrogen & Energy Efficient Utility Solutions) is a techno-economic modeling tool that takes human-readable inputs and converts them into a format suitable for energy system optimization using SpineOpt. It thereby supports municipalities in identifying possible pathways toward net-zero emissions through optimal investments and operation of energy technologies.

This guide will help you install, configure, run, and analyze models using MORPHE2US and the Spine Toolbox.

Note

This documentation is a work in progress. Feedback and contributions are welcome! The sections from Building a model to Analyzing a model are still in progress.

Contents:

User Guide

• About
  • Purpose
  • Key Features
  • Architecture
  • Where to go next
• Getting Started
  • Software Requirements
  • Installation Steps
• Building a Model
  • 🧰 Step 1: Prepare Your Input Files
  • ⚙️ Step 2: Generate the Model
  • 🧩 Step 3: Load the Model into Spine Toolbox
  • 🔍 Step 4: Verify and Validate
  • ✅ Step 5: Ready to Run
• Running a Model
  • 🛠️ Step x: Select and Configure a Solver for MIP problems
  • ▶️ Step 1: Run the Model
  • 📁 Step 2: View and Export Results
  • 🧰 Troubleshooting
  • ✅ Next Step: Analyze Your Results
• Analyzing Model Results
  • 📈 1. View Results in Spine Toolbox
  • 🧠 2. Common Questions to Ask
  • 📤 3. Export and Report
• Tutorials
• Tutorial 1
• Tutorial 2