Metadata-Version: 2.4
Name: formelsammlung
Version: 1.0.0
Summary: Interaktive Formelsammlung Werkstofftechnik (Tkinter)
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sympy>=1.12
Requires-Dist: pyyaml>=6
Requires-Dist: pillow>=10
Dynamic: license-file

# Formelsammlung Werkstofftechnik v3.3

Interaktive Formelsammlung für die Werkstoffprüfung – Werte eingeben,
Ergebnis mit Einheit erhalten, Formeln automatisch umgestellt.

Für alle, die sich für Werkstofftechnik interessieren
(Berufsschule, Ausbildung, Praxis, Studium).

Paket-Version: **pak-v1.0.0** · Programmversion: **v3.3**

---

## Funktionen

- Formeln nach Prüfkategorien sortiert (z. B. Zugversuch, Härteprüfung, Ultraschall)
- Jede Formel ist umstellbar: gewünschte Zielgröße wählen, übrige Werte eingeben
- Einheiten werden mit ausgewertet (z. B. `12.5 mm`, `1.5 kN`, `20 %`)
- Mehrere Lösungen werden angezeigt, wenn möglich
- Skizzen zu den Prüfverfahren (per Klick vergrößerbar)
- Werkstoffdaten-Tabellen als PDF
- Bedienungsanleitung im Programm: Menü **Hilfe → Bedienungsanleitung**

## Voraussetzungen

**Windows (EXE):** keine – die `Formelsammlung.exe` enthält alles Benötigte.

**Linux (Python-Paket):**

- Python 3.9 oder neuer (inkl. Tkinter)
- `pip`

Die Python-Pakete `sympy`, `pyyaml` und `pillow` werden bei der Installation
automatisch mitgeladen.

## Installation

### Windows (einfach)

1. ZIP-Archiv `Formelsammlung-v3.3-win64.zip` entpacken
2. Doppelklick auf `Formelsammlung.exe` im entpackten Ordner

Hinweis: Die EXE benötigt den **gesamten Ordner** (mit `_internal`) –
immer den kompletten Ordner kopieren, nie nur die EXE allein.

### Linux (Python-Paket)

Tkinter und pip einmalig bereitstellen (Debian/Ubuntu/Mint):

```bash
sudo apt update
sudo apt install python3 python3-tk python3-pip
```

Dann das Wheel installieren:

```bash
pip install --user formelsammlung-1.0.0-py3-none-any.whl
```

(Deaktivierung der Standard-Python-Umgebung nötig: `sudo apt install python3-full`
bzw. über die pip-Konfiguration `export PIP_BREAK_SYSTEM_PACKAGES=1` – oder
Installation innerhalb einer virtuellen Umgebung.)

## Start

**Linux** – nach der Installation zwei Konsolenbefehle:

```bash
formelsammlung            # Hauptprogramm
formelsammlung-editor     # Daten-Editor (Formeln pflegen)
```

Alternativ als Python-Modul:

```bash
python3 -m guipy.gui_formelsammlung     # Hauptprogramm
python3 -m guipy.daten_editor          # Daten-Editor
```

**Windows:** `Formelsammlung.exe` per Doppelklick.

## Bedienung

Eine vollständige Anleitung befindet sich **im Programm** unter
Menü **Hilfe → Bedienungsanleitung**.

Kurzform:

1. Prüfkategorie im Menü wählen
2. Formel anklicken → Berechnungsdialog öffnet sich
3. Zielgröße auswählen, Werte mit Einheit eingeben
4. Ergebnis ablesen (inkl. umgestellter Formel)

## Projektstruktur (Paket-Quellcode)

```
formelsammlung-paket/
├── guipy/                    ← GUI (Hauptfenster, Daten-Editor, pfade.py)
│   └── daten/                ← Formeldatenbank, Skizzen, PDF-Tabellen
├── app_formelsammlung/       ← Logik (Engine, Einheiten, Formatierung)
├── pyproject.toml            ← Paket-Konfiguration (Build)
├── Formelsammlung.spec       ← Bauanleitung für die Windows-EXE (PyInstaller)
├── README.md
└── LICENSE
```

## Formeln pflegen / erweitern

Die Formeln stehen in `guipy/daten/formeln.yaml`.
Zum Bearbeiten gibt es den Daten-Editor:

```bash
formelsammlung-editor          # nach der Installation
```

oder im Quellcode-Projekt: `python3 -m guipy.daten_editor`

## Neuaufbau (für Entwickler)

**Linux-Wheel:**

```bash
python3 -m build
```

**Windows-EXE** (auf Windows, im Projektordner):

```bat
py -3.12 -m PyInstaller --noconfirm --windowed --name Formelsammlung ^
  --add-data "guipy\daten;daten" ^
  --paths app_formelsammlung ^
  --hidden-import validierung --hidden-import formatting ^
  --hidden-import einheiten --hidden-import formel_datenbank ^
  --hidden-import formel_engine ^
  guipy\gui_formelsammlung.py
```

Ergebnis liegt danach in `dist\Formelsammlung\`.

## Version

Programmversion: **v3.3** (November 2026)
Paket-Version: **pak-v1.0.0**

## Changelog

- **v3.3 / pak-v1.0.0**: Installierbares Python-Paket (Wheel), eigenständige
  Windows-EXE, zentrale Pfadverwaltung (`guipy/pfade.py`), Konsolenbefehle
  `formelsammlung` und `formelsammlung-editor`
- **v3.2**: Ursprungsversion als Python-Projekt mit Startskripten

## Lizenz

MIT License – siehe Datei `LICENSE`.

---

*Hobbyprojekt von Gerd Kurzhals – Anregungen und Feedback willkommen.*
