# skinnypigeon/isaac-levelgen architecture

> Architecture diagram of the GitHub repository skinnypigeon/isaac-levelgen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skinnypigeon/isaac-levelgen
- Repository: https://github.com/skinnypigeon/isaac-levelgen

## Overview

Key Components to Include:

##### Core Components
- Level Generator Module
- Visualization Module
- Monte Carlo Simulation Module
- Route Calculator

##### Data Flow Architecture

A. Input Layer:
- Configuration Parameters (room count, simulation iterations)

B. Processing Layer (Core Logic):
- Level Generation Engine
- Room placement algorithm
- Path validation
- Route Calculator
- Start-to-boss pathfinding
- Monte Carlo Simulator
- Statistics collection
- Average route calculation

C. Output Layer:
- Matplotlib Visualization
- Statistical Results Output

##### Component Relationships
- Configuration → Level Generator
- Level Generator → Route Calculator
- Route Calculator → Visualization/Statistics
- Monte Carlo Simulator → Statistics Output

Key Technical Elements to Highlight:

##### File-specific roles
- .py: Visualization controller
- grid_coords.py: Core generation & simulation logic
- requirements.txt: External dependencies

##### Integration points
- Matplotlib integration for visualization
- Configuration parameter inputs
- Statistics output

Additional Considerations:

##### Notes about
- Level generation rules
- Path calculation methodology
- Monte Carlo simulation parameters

Level of Detail:

- Room generation logic
- Path calculation algorithms
- Visualization pipeline
- Statistical analysis flow

Remember to include a note about potential future extensions:
- Image recognition integration
- Shop/item/curse room handling
- Isaac-loop implementation

This will help communicate both the current architecture and the planned evolution of the system.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef input fill:#b3d9ff,stroke:#333
    classDef processing fill:#90EE90,stroke:#333
    classDef output fill:#FFB366,stroke:#333
    classDef external fill:#E0E0E0,stroke:#333

    %% Input Layer
    Config[Configuration Parameters]:::input
    
    %% Processing Layer
    subgraph Processing
        LevelGen[Level Generator Engine]
        RouteCalc[Route Calculator]
        MonteCarloSim[Monte Carlo Simulator]
    end
    
    %% Output Layer
    subgraph Output
        MatplotVis[Matplotlib Visualization]:::output
        Stats[Statistical Results]:::output
    end
    
    %% External Dependencies
    MatplotLib[Matplotlib Library]:::external
    
    %% Relationships
    Config --> LevelGen
    LevelGen --> RouteCalc
    RouteCalc --> MonteCarloSim
    MonteCarloSim --> Stats
    MonteCarloSim --> MatplotVis
    MatplotLib --> MatplotVis
    
    %% Future Extensions
    subgraph Future[Future Extensions]
        ImgRecog[Image Recognition]
        ShopRooms[Shop/Item/Curse Rooms]
        IsaacLoop[Isaac-Loop Implementation]
    end
    
    %% Legend
    subgraph Legend
        Start((Start Room))
        Boss[[Boss Room]]
        Regular[Regular Room]
        Path["--> Direct Flow"]
        Optional["-.-> Optional Flow"]
    end

    %% Click Events
    click LevelGen "https://github.com/SkinnyPigeon/isaac-levelgen/blob/main/grid_coords.py"
    click RouteCalc "https://github.com/SkinnyPigeon/isaac-levelgen/blob/main/grid_coords.py"
    click MonteCarloSim "https://github.com/SkinnyPigeon/isaac-levelgen/blob/main/grid_coords.py"
    click MatplotVis "https://github.com/SkinnyPigeon/isaac-levelgen/blob/main/display.py"
    click MatplotLib "https://github.com/SkinnyPigeon/isaac-levelgen/blob/main/requirements.txt"

    %% Notes
    note1[Level generation follows<br>Isaac-style rules]
    note2[Path calculation uses<br>shortest path algorithm]
    note3[Monte Carlo simulates<br>multiple iterations]
```
