Getting Started Tutorial

This tutorial walks you through using Claude Code to explore and understand FUSION.

Step 1: Understand the Project Structure

Start by getting an overview of how FUSION is organized:

> What are the main modules in FUSION and what does each one do?

Claude will explain the directory structure and the purpose of each major component.

Step 2: Learn a Core Concept

FUSION deals with optical networking concepts that may be unfamiliar. Ask Claude to explain:

> Explain what RSA (Routing and Spectrum Assignment) means and how FUSION implements it.
> What is spectrum fragmentation and why does it matter?

Step 3: Find Specific Code

When you need to locate specific functionality:

> Where is the main simulation loop? Show me the key functions.
> Which file handles network topology loading?

Step 4: Understand How to Run a Simulation

Learn the practical aspects of using the simulator:

> How do I run a basic simulation with FUSION? Walk me through the steps.
> What configuration options are available and where do I set them?

Step 5: Make a Change

When you’re ready to contribute or modify the code:

> I want to add a new routing algorithm. What files do I need to modify and what interfaces should I implement?
> Show me an example of an existing routing algorithm so I can follow the same pattern.

Step 6: Debug an Issue

If you encounter problems:

> The simulation is giving high blocking probability. What should I check?
> I'm getting an error in the spectrum assignment module. Help me understand this traceback.

Next Steps

Once you’re comfortable with these basics, explore more advanced topics:

  • Ask about the reinforcement learning integration

  • Learn about the failure injection and survivability features

  • Understand the metrics and reporting system