# javanmardi/textilecalculator_python architecture

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

- Interactive diagram: https://gitdiagram.com/javanmardi/textilecalculator_python
- Repository: https://github.com/javanmardi/textilecalculator_python

## Overview

This archived Tkinter desktop calculator lets a textile-production user enter process measurements, choose a formula, and read a calculated value in the interface. Its main entry point organizes formulas into melt spinning, texturing, twisting, and weaving; calculation handlers read the entered values, compute results, and display them. The README documents all 15 formulas, while sampled source confirms the categorized interface and several handlers. Formula-level wiring in unsampled sections is not inferred beyond the documented category and capability structure.

Main entry points: [`formula_calculator_categ.py`](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py) (Melt-spinning formulas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Desktop application"]
  node_categorized_app["Calculator interface"]
  node_simple_app["Four-formula interface"]
end

subgraph group_melt["Melt spinning"]
  node_melt_formulas["Melt-spinning formulas"]
  node_melt_speed["Production per minute"]
  node_melt_active["Active-time production"]
  node_melt_product["Product weight"]
  node_melt_bobbins["Full bobbin count"]
  node_melt_waste["Total waste"]
  node_melt_efficiency["Production efficiency"]
end

subgraph group_texturing["Texturing"]
  node_texture_formulas["Texturing formulas"]
  node_texture_weight["Theoretical production weight"]
  node_texture_count["Output yarn count"]
  node_texture_production["Production efficiency"]
  node_texture_quality["Quality efficiency"]
end

subgraph group_twisting["Twisting"]
  node_twist_formulas["Twisting formulas"]
  node_twist_rate["Twists per meter"]
  node_twist_count["Output yarn count"]
end

subgraph group_weaving["Weaving"]
  node_weave_formulas["Weaving formulas"]
  node_weave_density["Fabric areal density"]
  node_weave_linear["Weight per linear meter"]
  node_weave_beam["Warp beam ends"]
end

node_user(("Textile user"))

node_user -->|"runs and enters"| node_categorized_app
node_categorized_app -->|"opens category"| node_melt_formulas
node_categorized_app -->|"opens category"| node_texture_formulas
node_categorized_app -->|"opens category"| node_twist_formulas
node_categorized_app -->|"opens category"| node_weave_formulas
node_melt_formulas -->|"offers formula"| node_melt_speed
node_melt_formulas -->|"offers formula"| node_melt_active
node_melt_formulas -->|"offers formula"| node_melt_product
node_melt_formulas -->|"offers formula"| node_melt_bobbins
node_melt_formulas -->|"offers formula"| node_melt_waste
node_melt_formulas -->|"offers formula"| node_melt_efficiency
node_texture_formulas -->|"offers formula"| node_texture_weight
node_texture_formulas -->|"offers formula"| node_texture_count
node_texture_formulas -->|"offers formula"| node_texture_production
node_texture_formulas -->|"offers formula"| node_texture_quality
node_twist_formulas -->|"offers formula"| node_twist_rate
node_twist_formulas -->|"offers formula"| node_twist_count
node_weave_formulas -->|"offers formula"| node_weave_density
node_weave_formulas -->|"offers formula"| node_weave_linear
node_weave_formulas -->|"offers formula"| node_weave_beam

click node_categorized_app "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_simple_app "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator.py"
click node_melt_formulas "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_speed "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_active "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_product "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_bobbins "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_waste "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_melt_efficiency "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_texture_formulas "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_texture_weight "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_texture_count "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_texture_production "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_texture_quality "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_twist_formulas "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_twist_rate "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_twist_count "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_weave_formulas "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_weave_density "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_weave_linear "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py"
click node_weave_beam "https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.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_categorized_app,node_simple_app,node_user toneBlue
class node_melt_formulas,node_melt_speed,node_melt_active,node_melt_product,node_melt_bobbins,node_melt_waste,node_melt_efficiency toneAmber
class node_texture_formulas,node_texture_weight,node_texture_count,node_texture_production,node_texture_quality toneMint
class node_twist_formulas,node_twist_rate,node_twist_count toneRose
class node_weave_formulas,node_weave_density,node_weave_linear,node_weave_beam toneIndigo
```

## Components

### Desktop application

- [Calculator interface](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Four-formula interface](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator.py): `formula_calculator.py`

### Melt spinning

- [Melt-spinning formulas](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Production per minute](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Active-time production](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Product weight](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Full bobbin count](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Total waste](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Production efficiency](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`

### Texturing

- [Texturing formulas](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Theoretical production weight](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Output yarn count](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Production efficiency](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Quality efficiency](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`

### Twisting

- [Twisting formulas](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Twists per meter](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Output yarn count](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`

### Weaving

- [Weaving formulas](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Fabric areal density](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Weight per linear meter](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`
- [Warp beam ends](https://github.com/javanmardi/textilecalculator_python/blob/main/formula_calculator_categ.py): `formula_calculator_categ.py`

### Other components

- **Textile user**

## Connections

- Textile user → Calculator interface: runs and enters (evidence: `README.md`)
- Calculator interface → Melt-spinning formulas: opens category (evidence: `formula_calculator_categ.py`)
- Calculator interface → Texturing formulas: opens category (evidence: `formula_calculator_categ.py`)
- Calculator interface → Twisting formulas: opens category (evidence: `formula_calculator_categ.py`)
- Calculator interface → Weaving formulas: opens category (evidence: `formula_calculator_categ.py`)
- Melt-spinning formulas → Production per minute: offers formula (evidence: `README.md`)
- Melt-spinning formulas → Active-time production: offers formula (evidence: `README.md`)
- Melt-spinning formulas → Product weight: offers formula (evidence: `README.md`)
- Melt-spinning formulas → Full bobbin count: offers formula (evidence: `README.md`)
- Melt-spinning formulas → Total waste: offers formula (evidence: `README.md`)
- Melt-spinning formulas → Production efficiency: offers formula (evidence: `README.md`)
- Texturing formulas → Theoretical production weight: offers formula (evidence: `README.md`)
- Texturing formulas → Output yarn count: offers formula (evidence: `README.md`)
- Texturing formulas → Production efficiency: offers formula (evidence: `README.md`)
- Texturing formulas → Quality efficiency: offers formula (evidence: `README.md`)
- Twisting formulas → Twists per meter: offers formula (evidence: `README.md`)
- Twisting formulas → Output yarn count: offers formula (evidence: `README.md`)
- Weaving formulas → Fabric areal density: offers formula (evidence: `README.md`)
- Weaving formulas → Weight per linear meter: offers formula (evidence: `README.md`)
- Weaving formulas → Warp beam ends: offers formula (evidence: `README.md`)
