Hornfolding Alpha v0.69

Faltung gerader Horn- und Tapped-Horn-Simulationen aus Hornresp in ein rechteckiges Gehäuse – inklusive Rückspiegelung der realen Faltungsgeometrie zur Nachsimulation
Folding straight horn and tapped-horn simulations from Hornresp into a rectangular enclosure – reflecting accurate folded parameters back for re-simulation

Hornfolding_v0.69.py Python-Skript (Python 3.8+) README.md Anleitung & Dokumentation CHANGELOG.md Versionshistorie (0.13 – 0.69) License.md GNU AGPL v3.0 Lizenz

1. Idee & Workflow / Concept & Workflow

DE: Hornfolding schlägt die Brücke zwischen der akustischen Simulation und dem realen Gehäusebau: Ausgangspunkt ist die Simulation eines geraden Horns oder Tapped-Horns (THAM) in der kostenlosen Simulationssoftware Hornresp (von David McBean). Hornfolding versucht, diesen Hornverlauf mit konstanter Innenbreite und linear wachsender Höhe (Segmenttyp Par, nicht Con) nach der Advanced Centerline Method (ACM) sauber in eine Kiste mit vorgegebenen Außenmaßen zu falten. Da eine reale Faltung mit Umlenkungen und festen Außenmaßen nie exakt dem idealisierten geraden Horn entspricht, berechnet das Skript anschließend die tatsächlichen Flächen (S1–S5) und Pfadlängen (L12–L45) der Faltung, sodass man diese Parameter wieder in Hornresp zurückspiegeln und die reale Konstruktion dort akustisch nachsimulieren kann.

EN: Hornfolding bridges acoustic simulation and physical enclosure design: starting from a straight horn or tapped-horn (THAM) model in Hornresp (by David McBean), the tool folds the channel (constant width, linearly expanding height — flare type Par, never Con) into a rectangular box of given outer dimensions using the Advanced Centerline Method (ACM). Because physical folds and fixed box dimensions inevitably alter the idealised straight path, Hornfolding calculates the resulting effective areas (S1–S5) and segment lengths (L12–L45) so you can feed them back into Hornresp for an accurate re-simulation of the folded enclosure.

Alpha-Hinweis / Alpha Release: Das Programm befindet sich in aktiver Entwicklung. Die Berechnungen wurden noch nicht systematisch an gebauten Prototypen messtechnisch validiert – bitte Geometrie und Zuschnittliste vor dem Sägen prüfen. / Under active development. Always verify geometry and cut lists before cutting wood.

2. Voraussetzungen & Start / Requirements & How to Run

Benötigt werden Hornresp (für den akustischen Entwurf und die Nachsimulation) sowie Python 3.8 oder neuer (nutzt ausschließlich die Standardbibliothek, keine Zusatzpakete erforderlich). Lege Hornfolding_v0.69.py in einen eigenen Ordner, in dem das Skript alle Ausgabedateien speichert.
Requires Hornresp (for acoustic design and re-simulation) and Python 3.8+ (standard library only, no external packages needed). Place the script in a dedicated folder where output files will be saved.

Windows Python über den Microsoft Store oder python.org installieren (im Installer „Add python.exe to PATH“ anhaken). Im Skript-Ordner Rechtsklick → „In Terminal öffnen“ und starten mit:
python Hornfolding_v0.69.py
macOS & Linux Auf Linux meist vorinstalliert; unter macOS via python.org oder Homebrew installieren. Terminal im Skript-Ordner öffnen und starten mit:
python3 Hornfolding_v0.69.py
iOS & Android (Mobil) Da keine externen Bibliotheken nötig sind, läuft das Skript auch mobil – z. B. mit Pydroid 3 (Android) oder Pythonista 3 / a-Shell (iOS/iPadOS).

Weiterführende Anleitungen / Guides: Python-Skripte ausführen (DE) · Official Python Beginner's Guide (EN) · Experimenteller Textdatei-Import (aktuell noch eher „ToDo“ als praktikabel): python Hornfolding_v0.69.py export.txt

3. Eingabeparameter / Input Parameters

Einheiten / Units: Standardmäßig alle Längen in cm und Flächen in cm² (für mm / mm² oben im Skript UNIT = "mm" setzen). Komma oder Punkt als Dezimaltrennzeichen möglich.
Default units: cm and cm² (change UNIT = "mm" at the top of the script for millimeters).

Parameter Beschreibung (DE) Description (EN)
WoodThickness (a)
BraceWidth
Materialstärke des Holzes sowie Gesamtbreite der Versteifungen (wird von der Innenbreite abgezogen). Wood panel thickness and total width of internal bracing (deducted from net channel width).
Width, Height, Depth Außenmaße des Gehäuses (Breite, Höhe, Tiefe). Outer enclosure dimensions (Width, Height, Depth).
S1, S2 Querschnittsfläche am geschlossenen Ende (auto = gleiche Steigung durchgehend) und am Treiber (S2) aus Hornresp. Cross-sectional area at closed end (auto = continuous slope) and at the driver (S2) from Hornresp.
Mode
(S3 & L23 / Slope)
Modus 1: Ziel-Fläche S3 und Hornlänge L23 (S2–S3) aus Hornresp vorgeben.
Modus 2: Steigung b direkt eingeben (z. B. 0.1 = 10 cm/m).
Mode 1: Specify target area S3 and path length L23 (S2–S3) from Hornresp.
Mode 2: Enter slope b directly (e.g. 0.1).
S4, S5 Optionale Hornresp-Vergleichswerte der Ausgangssimulation (auto = ohne Vorgabe). Optional Hornresp comparison targets from the initial simulation (auto = none).
DriverOffset Abstand der Treibermitte (S2 + S4) von der linken Außenkante (Schallwand-Vorderseite). Distance of driver centre (S2 + S4) from the left outer edge.
Slope2 (b') Steigung nach S3 (auto = wird passend zur Box berechnet, oder manueller Wert). Slope after S3 (auto = calculated from box geometry, or manual value).
S3Position Position des Steigungswechsels an einer Umlenkung (1–7 oder auto für beste Annäherung an L23). Bend position where slope changes from b to b' (1–7 or auto).
DriverDiameter
MagnetDiameter
DriverDepth
Optionale Treibermaße für die Einbau- und Freigängigkeitsprüfung (auto = unbekannt; Magnet = 0,5 × Korbdurchmesser). Optional driver dimensions for physical fit & clearance checks (auto = unknown; magnet = 0.5 × frame).
Kink / SVG Kink (y/n): Brett a bei abweichendem S1 knicken (in a1/a2 teilen). SVG (y/n): Zeichnung erzeugen. Kink (y/n): Split baffle a into a1/a2 if S1 differs. SVG (y/n): Generate SVG drawing.

4. Was wird ausgegeben? / Output Files & Preview

Nach der Berechnung legt das Skript im selben Verzeichnis die folgenden Dateien an und gibt die ermittelten Flächen (S1–S5) und Längen (L12–L45) zur direkten Übertragung in Hornresp aus:
After calculation, the script writes the following files to the same directory and prints the resulting areas (S1–S5) and lengths (L12–L45) for re-simulation in Hornresp:

Ausgabedatei Inhalt (DE) Content (EN)
horn_folding.svg Maßstäbliche Schnittzeichnung (Seitenansicht) mit allen Brettern, ACM-Umlenkungskonstruktionen, roter Mittellinie, Querschnitten S1–S5, Zuschnittliste sowie dem abgewickelten Flächenverlauf (Soll vs. Ist). Scaled cross-section drawing (side view) showing all boards, ACM bend constructions, red centreline, cross-sections S1–S5, cut list, and unfolded area profile (reference vs. actual).
horn_cutlist.csv Werkstattfertige Zuschnittliste im CSV-Format mit Bruttolängen der längsten Seite und Innenwinkeln (90,0° = rechtwinkliger Schnitt). Workshop-ready cut list in CSV format with gross length of the longest face and interior end angles (90.0° = square cut).
Hornfolding_Input.txt Automatisch gespeicherte Eingabeparameter des letzten Durchlaufs (werden beim nächsten Start als Standardwerte angeboten). Automatically saved parameters of the last run (offered as defaults on the next start).
Beispielausgabe horn_folding.svg – Schnittzeichnung und abgewickelter Hornverlauf
Beispielausgabe / Sample Output (horn_folding.svg): Klick auf die Grafik öffnet die Vektorgrafik in voller Auflösung zum Zoomen. / Click image to open full-resolution vector graphic for zooming.