# producedbysavant/simintech-code architecture

> Architecture diagram of the GitHub repository producedbysavant/simintech-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/producedbysavant/simintech-code
- Repository: https://github.com/producedbysavant/simintech-code

## Overview

SimInTech Code is primarily a Python API for automating SimInTech models through its Windows COM server, with a script bridge for operations unavailable through COM. The main workflow connects to the server, opens a project, edits pages and blocks, runs a simulation, and saves or reads results. The repository also includes catalog, layout, topology, language, and project-file utilities. Edges reflect shown calls, imports listed in the SOURCE INDEX, or README statements; unsampled relationships are omitted.

Main entry points: [`simintech_api/core/com_client.py`](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/com_client.py) (COM client), [`simintech_api/core/project.py`](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/project.py) (Project), [`simintech_api/core/page.py`](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/page.py) (Diagram page), [`simintech_api/core/block.py`](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/block.py) (Diagram blocks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["COM connection"]
  node_client["COM client<br/>[com_client.py]"]
  node_converters["COM converters<br/>[converters.py]"]
  node_model["COM data model<br/>[model.py]"]
  node_errors["API errors<br/>[exceptions.py]"]
end

subgraph group_modeling["Model construction"]
  node_project["Project<br/>[project.py]"]
  node_page["Diagram page<br/>[page.py]"]
  node_block["Diagram blocks<br/>[block.py]"]
  node_port["Block ports<br/>[port.py]"]
  node_wire["Connections<br/>[wire.py]"]
  node_catalog["Block catalog<br/>[catalog.py]"]
end

subgraph group_execution["Execution and results"]
  node_simulation["Simulation control<br/>[simulation.py]"]
  node_signal["Signal access<br/>[signal.py]"]
  node_scriptbridge["Script bridge<br/>[script_bridge.py]"]
  node_probe["Script probing<br/>[script_probe.py]"]
end

subgraph group_utilities["Model utilities"]
  node_topology["Topology reader<br/>[topology.py]"]
  node_layout["Diagram layout"]
  node_router["Wire router<br/>[router.py]"]
  node_language["Embedded language<br/>[language.py]"]
  node_csl["CSL library<br/>[csl_library.py]"]
  node_pak["PAK projects<br/>[pak.py]"]
end

node_user(("Python user"))
node_simintec["SimInTech COM server"]

node_user -->|"connects through"| node_client
node_client -->|"calls COM API"| node_simintec
node_user -->|"creates or opens"| node_project
node_project -->|"uses"| node_client
node_project -->|"gets pages"| node_page
node_page -->|"creates blocks"| node_client
node_page -->|"creates"| node_block
node_block -->|"gets ports"| node_port
node_block -->|"reads properties from"| node_catalog
node_block -->|"sets properties through"| node_client
node_page -->|"creates connections"| node_wire
node_project -->|"creates controller"| node_simulation
node_project -->|"exposes signal access"| node_signal
node_simulation -->|"controls calculation"| node_client
node_user -->|"runs embedded code"| node_scriptbridge
node_scriptbridge -->|"uses"| node_client
node_scriptbridge -->|"uses probes"| node_probe
node_user -->|"reads topology"| node_topology
node_user -->|"arranges diagrams"| node_layout
node_router -.->|"supports routing"| node_layout
node_user -->|"uses language reference"| node_language
node_user -.->|"uses CSL resources"| node_csl
node_user -.->|"handles project packages"| node_pak
node_client -->|"converts COM values"| node_converters
node_converters -->|"converts descriptors"| node_model
node_client -->|"uses data types"| node_model
node_client -->|"raises API errors"| node_errors

click node_client "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/com_client.py"
click node_project "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/project.py"
click node_page "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/page.py"
click node_block "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/block.py"
click node_port "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/port.py"
click node_wire "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/wire.py"
click node_catalog "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/catalog.py"
click node_simulation "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/simulation.py"
click node_signal "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/signal.py"
click node_scriptbridge "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/script_bridge.py"
click node_probe "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/script_probe.py"
click node_topology "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/topology.py"
click node_layout "https://github.com/producedbysavant/simintech-code/tree/main/simintech_api/layout"
click node_router "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/layout/router.py"
click node_language "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/language.py"
click node_csl "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/csl_library.py"
click node_pak "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/pak.py"
click node_converters "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/utils/converters.py"
click node_model "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/model.py"
click node_errors "https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/exceptions.py"

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_client,node_converters,node_model,node_errors,node_user toneBlue
class node_project,node_page,node_block,node_port,node_wire,node_catalog toneAmber
class node_simulation,node_signal,node_scriptbridge,node_probe,node_simintec toneMint
class node_topology,node_layout,node_router,node_language,node_csl,node_pak toneRose
```

## Components

### COM connection

- [COM client](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/com_client.py): `simintech_api/core/com_client.py`
- [COM converters](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/utils/converters.py): `simintech_api/utils/converters.py`
- [COM data model](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/model.py): `simintech_api/model.py`
- [API errors](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/exceptions.py): `simintech_api/exceptions.py`

### Model construction

- [Project](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/project.py): `simintech_api/core/project.py`
- [Diagram page](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/page.py): `simintech_api/core/page.py`
- [Diagram blocks](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/block.py): `simintech_api/core/block.py`
- [Block ports](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/port.py): `simintech_api/core/port.py`
- [Connections](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/wire.py): `simintech_api/core/wire.py`
- [Block catalog](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/catalog.py): `simintech_api/catalog.py`

### Execution and results

- [Simulation control](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/simulation.py): `simintech_api/core/simulation.py`
- [Signal access](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/signal.py): `simintech_api/core/signal.py`
- [Script bridge](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/core/script_bridge.py): `simintech_api/core/script_bridge.py`
- [Script probing](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/script_probe.py): `simintech_api/script_probe.py`

### Model utilities

- [Topology reader](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/topology.py): `simintech_api/topology.py`
- [Diagram layout](https://github.com/producedbysavant/simintech-code/tree/main/simintech_api/layout): `simintech_api/layout`
- [Wire router](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/layout/router.py): `simintech_api/layout/router.py`
- [Embedded language](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/language.py): `simintech_api/language.py`
- [CSL library](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/csl_library.py): `simintech_api/csl_library.py`
- [PAK projects](https://github.com/producedbysavant/simintech-code/blob/main/simintech_api/pak.py): `simintech_api/pak.py`

### Other components

- **Python user**
- **SimInTech COM server**

## Connections

- Python user → COM client: connects through (evidence: `README.md`)
- COM client → SimInTech COM server: calls COM API (evidence: `README.md`)
- Python user → Project: creates or opens (evidence: `README.md`)
- Project → COM client: uses (evidence: `simintech_api/core/project.py`)
- Project → Diagram page: gets pages (evidence: `simintech_api/core/project.py`)
- Diagram page → COM client: creates blocks (evidence: `simintech_api/core/page.py`)
- Diagram page → Diagram blocks: creates (evidence: `simintech_api/core/page.py`)
- Diagram blocks → Block ports: gets ports (evidence: `simintech_api/core/block.py`)
- Diagram blocks → Block catalog: reads properties from (evidence: `simintech_api/core/block.py`)
- Diagram blocks → COM client: sets properties through (evidence: `simintech_api/core/block.py`)
- Diagram page → Connections: creates connections (evidence: `simintech_api/core/page.py`)
- Project → Simulation control: creates controller (evidence: `simintech_api/core/project.py`)
- Project → Signal access: exposes signal access (evidence: `simintech_api/core/project.py`)
- Simulation control → COM client: controls calculation (evidence: `simintech_api/core/simulation.py`)
- Python user → Script bridge: runs embedded code (evidence: `README.md`)
- Script bridge → COM client: uses (evidence: `simintech_api/core/script_bridge.py`)
- Script bridge → Script probing: uses probes (evidence: `simintech_api/core/script_bridge.py`)
- Python user → Topology reader: reads topology
- Python user → Diagram layout: arranges diagrams (evidence: `README.md`)
- Wire router → Diagram layout: supports routing (evidence: `simintech_api/layout/router.py`)
- Python user → Embedded language: uses language reference (evidence: `README.md`)
- Python user → CSL library: uses CSL resources
- Python user → PAK projects: handles project packages
- COM client → COM converters: converts COM values (evidence: `simintech_api/core/com_client.py`)
- COM converters → COM data model: converts descriptors (evidence: `simintech_api/utils/converters.py`)
- COM client → COM data model: uses data types (evidence: `simintech_api/core/com_client.py`)
- COM client → API errors: raises API errors (evidence: `simintech_api/core/com_client.py`)
