# rino-cs50/circuitjs architecture

> Architecture diagram of the GitHub repository rino-cs50/circuitjs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rino-cs50/circuitjs
- Repository: https://github.com/rino-cs50/circuitjs

## Overview

CircuitJS1 is a browser-based electronic circuit simulator. Users build and edit a circuit, run its simulation, and inspect component values and plotted waveforms. The graph centers on CirSim as the simulator and interaction coordinator, with circuit elements and scopes as distinct domain stages. The README establishes the browser product; source-index references and excerpts support the internal links shown. Other documented capabilities and integrations are not expanded where their runtime connections were not evidenced.

Main entry points: [`src/com/lushprojects/circuitjs1/client/CircuitElm.java`](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java) (Element model), [`src/com/lushprojects/circuitjs1/client/CirSim.java`](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java) (Simulator), [`src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java) (Power loss), [`src/com/lushprojects/circuitjs1/client/Scope.java`](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Scope.java) (Waveform scope)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation core"]
  node_sim["Simulator<br/>[CirSim.java]"]
  node_element["Element model<br/>[CircuitElm.java]"]
  node_tokenizer["Circuit tokenizer"]
end

subgraph group_components["Circuit components"]
  node_resistor["Resistor<br/>[ResistorElm.java]"]
  node_capacitor["Capacitor<br/>[CapacitorElm.java]"]
  node_inductor["Inductor<br/>[InductorElm.java]"]
  node_diode["Diode<br/>[DiodeElm.java]"]
  node_transistor["Transistor<br/>[TransistorElm.java]"]
  node_customlogic["Custom logic"]
end

subgraph group_interaction["Editing and display"]
  node_edit["Edit dialogs<br/>[EditDialog.java]"]
  node_toolbar["Component toolbar<br/>[Toolbar.java]"]
  node_graphics["Canvas graphics<br/>[Graphics.java]"]
  node_color["Color utilities<br/>[Color.java]"]
  node_rectangle["Canvas geometry<br/>[Rectangle.java]"]
  node_editinfo["Edit values<br/>[EditInfo.java]"]
end

subgraph group_analysis["Measurements and plots"]
  node_loss["Power loss"]
  node_scope["Waveform scope<br/>[Scope.java]"]
  node_probe["Probe viewer<br/>[ProbeViewer.java]"]
end

node_user(("Circuit designer"))

node_user -->|"uses in browser"| node_sim
node_sim -->|"coordinates"| node_element
node_sim -->|"manages plots"| node_scope
node_sim -->|"reads averages"| node_loss
node_element -->|"references"| node_resistor
node_element -->|"references"| node_capacitor
node_element -->|"references"| node_inductor
node_element -->|"draws through"| node_graphics
node_element -->|"uses for parsing"| node_tokenizer
node_resistor -->|"provides edit values"| node_editinfo
node_sim -->|"opens dialogs"| node_edit
node_sim -->|"references"| node_rectangle
node_scope -->|"plots element values"| node_element
node_scope -->|"uses plot bounds"| node_rectangle
node_scope -->|"renders plots"| node_graphics
node_probe -->|"uses scope data"| node_scope
node_probe -->|"reads component data"| node_element
node_loss -->|"samples losses"| node_element
node_loss -->|"models losses"| node_capacitor
node_loss -->|"models losses"| node_resistor
node_loss -->|"models losses"| node_diode
node_loss -->|"models losses"| node_transistor
node_graphics -->|"uses colors"| node_color
node_toolbar -->|"offers component"| node_resistor

click node_sim "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java"
click node_element "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java"
click node_resistor "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ResistorElm.java"
click node_capacitor "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CapacitorElm.java"
click node_inductor "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/InductorElm.java"
click node_diode "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/DiodeElm.java"
click node_transistor "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/TransistorElm.java"
click node_customlogic "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomLogicModel.java"
click node_edit "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditDialog.java"
click node_toolbar "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Toolbar.java"
click node_graphics "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Graphics.java"
click node_color "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Color.java"
click node_rectangle "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Rectangle.java"
click node_editinfo "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditInfo.java"
click node_loss "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java"
click node_scope "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Scope.java"
click node_probe "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ProbeViewer.java"
click node_tokenizer "https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/StringTokenizer.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sim,node_element,node_tokenizer toneBlue
class node_resistor,node_capacitor,node_inductor,node_diode,node_transistor,node_customlogic toneAmber
class node_edit,node_toolbar,node_graphics,node_color,node_rectangle,node_editinfo toneMint
class node_loss,node_scope,node_probe toneRose
class node_user toneIndigo
```

## Components

### Simulation core

- [Simulator](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java): `src/com/lushprojects/circuitjs1/client/CirSim.java`
- [Element model](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java): `src/com/lushprojects/circuitjs1/client/CircuitElm.java`
- [Circuit tokenizer](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/StringTokenizer.java): `src/com/lushprojects/circuitjs1/client/StringTokenizer.java`

### Circuit components

- [Resistor](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ResistorElm.java): `src/com/lushprojects/circuitjs1/client/ResistorElm.java`
- [Capacitor](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CapacitorElm.java): `src/com/lushprojects/circuitjs1/client/CapacitorElm.java`
- [Inductor](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/InductorElm.java): `src/com/lushprojects/circuitjs1/client/InductorElm.java`
- [Diode](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/DiodeElm.java): `src/com/lushprojects/circuitjs1/client/DiodeElm.java`
- [Transistor](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/TransistorElm.java): `src/com/lushprojects/circuitjs1/client/TransistorElm.java`
- [Custom logic](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomLogicModel.java): `src/com/lushprojects/circuitjs1/client/CustomLogicModel.java`

### Editing and display

- [Edit dialogs](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditDialog.java): `src/com/lushprojects/circuitjs1/client/EditDialog.java`
- [Component toolbar](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Toolbar.java): `src/com/lushprojects/circuitjs1/client/Toolbar.java`
- [Canvas graphics](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Graphics.java): `src/com/lushprojects/circuitjs1/client/Graphics.java`
- [Color utilities](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Color.java): `src/com/lushprojects/circuitjs1/client/Color.java`
- [Canvas geometry](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Rectangle.java): `src/com/lushprojects/circuitjs1/client/Rectangle.java`
- [Edit values](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditInfo.java): `src/com/lushprojects/circuitjs1/client/EditInfo.java`

### Measurements and plots

- [Power loss](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java): `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`
- [Waveform scope](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Scope.java): `src/com/lushprojects/circuitjs1/client/Scope.java`
- [Probe viewer](https://github.com/rino-cs50/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ProbeViewer.java): `src/com/lushprojects/circuitjs1/client/ProbeViewer.java`

### Other components

- **Circuit designer**

## Connections

- Circuit designer → Simulator: uses in browser
- Simulator → Element model: coordinates (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator → Waveform scope: manages plots (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator → Power loss: reads averages (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Element model → Resistor: references (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Element model → Capacitor: references (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Element model → Inductor: references (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Element model → Canvas graphics: draws through (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Element model → Circuit tokenizer: uses for parsing (evidence: `src/com/lushprojects/circuitjs1/client/ResistorElm.java`)
- Resistor → Edit values: provides edit values (evidence: `src/com/lushprojects/circuitjs1/client/ResistorElm.java`)
- Simulator → Edit dialogs: opens dialogs (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator → Canvas geometry: references (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Waveform scope → Element model: plots element values (evidence: `src/com/lushprojects/circuitjs1/client/Scope.java`)
- Waveform scope → Canvas geometry: uses plot bounds (evidence: `src/com/lushprojects/circuitjs1/client/Scope.java`)
- Waveform scope → Canvas graphics: renders plots (evidence: `src/com/lushprojects/circuitjs1/client/Scope.java`)
- Probe viewer → Waveform scope: uses scope data (evidence: `src/com/lushprojects/circuitjs1/client/ProbeViewer.java`)
- Probe viewer → Element model: reads component data (evidence: `src/com/lushprojects/circuitjs1/client/ProbeViewer.java`)
- Power loss → Element model: samples losses (evidence: `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`)
- Power loss → Capacitor: models losses (evidence: `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`)
- Power loss → Resistor: models losses (evidence: `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`)
- Power loss → Diode: models losses (evidence: `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`)
- Power loss → Transistor: models losses (evidence: `src/com/lushprojects/circuitjs1/client/AveragePowerLoss.java`)
- Canvas graphics → Color utilities: uses colors (evidence: `src/com/lushprojects/circuitjs1/client/Graphics.java`)
- Component toolbar → Resistor: offers component (evidence: `src/com/lushprojects/circuitjs1/client/Toolbar.java`)
