Samer AyadiandClaude Opus 5.5
550bdeb464
TRO-Typen an Kreisel-Beruehrpunkten (lib/kreisel_junctions.py, derive_tros Schritt 3c): jeder Kreisel als Stadion-Form mit Laufrichtung; jeder gleichlaufende Beruehrpunkt ist eine Weiche (exportierte ILS Weiche oder abgeleitet W<a>_<b>), Beruehrpunkte derselben Umlenkung bilden einen Knoten. Ein Separator steuert ihn, wenn er in Laufrichtung unmittelbar davor liegt (keine andere Weiche dazwischen). Typ = Separatoren x Weichen. export.csv: 1Sep1Swi (9/1, 9/8, 8/7), 2Sep1Swi (7/2), 2Sep2Swi (2/3/4), 3Sep2Swi (4/5/6). Neuer Katalogtyp 3Sep2Swi (nicht aus SCL belegt). Gegenlaeufige Beruehrpunkte (Mubea, Dematic) bleiben bei der alten Regel; Mubea/HundM05/Dematic unveraendert, Showroom 0018+0019 jetzt 2Sep1Swi. material_flow --track: Mouseover je Knoten mit Zugehoerigkeit zu Kreisel/VF/GF (Zuordnung, TrackIds-Kette, Lage laut Geometrie), Weiche mit beiden Kreiseln, Be-/Entladung mit ihrem Kreisel; Widersprueche mit "!". Zahlenwerte (Toleranzen, Schwellen, Massstaebe, Groessen) aus allen lib-Modulen nach cfg/parameter.ini (lib/parameter.py, Abschnitt je Modul, Ueberschreiben je Anlage ueber %SKEL_CFG%/parameter.ini). Ausgaben aller Anlagen bytegleich. tro_flow.py: Docstrings mit Parametern/Rueckgabe, fehlende Typangaben. Geprueft: 90 Tests gruen; tro_flow/material_flow/scl_skeleton auf 5 CSVs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
100 lines
3.3 KiB
Python
100 lines
3.3 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
parameter.py - Zahlenwerte der Bibliotheken aus cfg/parameter.ini.
|
|
|
|
Toleranzen, Schwellen, Massstaebe und Zeichnungsgroessen stehen nicht im Code,
|
|
sondern in einer INI-Datei: ein Abschnitt je Modul, der Schluessel ist der
|
|
Name der Konstanten in Kleinbuchstaben ([kreisel_junctions]
|
|
contact_tolerance -> kreisel_junctions.CONTACT_TOLERANCE).
|
|
|
|
Gelesen wird zuerst die Grunddatei des Repositorys (<Projekt>/cfg/
|
|
parameter.ini, versioniert, muss vollstaendig sein). Liegt in %SKEL_CFG% eine
|
|
weitere parameter.ini, ueberschreibt sie einzelne Werte - so kann eine Anlage
|
|
abweichende Toleranzen bekommen, ohne die Grunddatei zu aendern.
|
|
|
|
Fehlt die Grunddatei oder ein Schluessel, bricht der Import mit
|
|
ParameterError ab: einen stillen Ersatzwert im Code gibt es bewusst nicht,
|
|
sonst stuende die Zahl doch wieder im Code.
|
|
|
|
Unterste Schicht: importiert nichts aus lib/, damit jedes Modul es nutzen kann.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import configparser
|
|
import os
|
|
from functools import lru_cache
|
|
from pathlib import Path
|
|
|
|
PARAMETER_FILE = "parameter.ini"
|
|
|
|
__all__ = ["PARAMETER_FILE", "ParameterError", "files", "get_float", "get_int"]
|
|
|
|
|
|
class ParameterError(RuntimeError):
|
|
"""Grunddatei fehlt oder ein Wert fehlt bzw. ist keine Zahl."""
|
|
|
|
|
|
def _base_file() -> Path:
|
|
"""Grunddatei im Repository: <Projekt>/cfg/parameter.ini."""
|
|
return Path(__file__).resolve().parent.parent / "cfg" / PARAMETER_FILE
|
|
|
|
|
|
def files() -> list[Path]:
|
|
"""Gelesene Dateien in Lesereihenfolge (Grunddatei, ggf. %SKEL_CFG%)."""
|
|
result = [_base_file()]
|
|
cfg = os.environ.get("SKEL_CFG")
|
|
if cfg:
|
|
override = Path(cfg) / PARAMETER_FILE
|
|
if override.is_file() and override.resolve() != result[0].resolve():
|
|
result.append(override)
|
|
return result
|
|
|
|
|
|
@lru_cache(maxsize=1)
|
|
def _parser() -> configparser.ConfigParser:
|
|
"""Alle Parameterdateien einlesen (einmal je Prozess)."""
|
|
base = _base_file()
|
|
if not base.is_file():
|
|
raise ParameterError(f"Parameterdatei fehlt: {base}")
|
|
parser = configparser.ConfigParser(inline_comment_prefixes=(";", "#"))
|
|
for path in files():
|
|
with path.open(encoding="utf-8") as handle:
|
|
parser.read_file(handle, source=str(path))
|
|
return parser
|
|
|
|
|
|
def _raw(section: str, key: str) -> str:
|
|
"""Rohwert; ParameterError, wenn Abschnitt oder Schluessel fehlt."""
|
|
parser = _parser()
|
|
if not parser.has_option(section, key):
|
|
raise ParameterError(
|
|
f"[{section}] {key} fehlt in {', '.join(str(p) for p in files())}")
|
|
return parser.get(section, key)
|
|
|
|
|
|
def get_float(section: str, key: str) -> float:
|
|
"""Zahl aus [section] key.
|
|
|
|
Parameter:
|
|
section: Abschnitt, in der Regel der Modulname (z. B. "tro_flow").
|
|
key: Schluessel, der Konstantenname in Kleinbuchstaben.
|
|
|
|
Rueckgabe:
|
|
Der Wert als float.
|
|
"""
|
|
raw = _raw(section, key)
|
|
try:
|
|
return float(raw)
|
|
except ValueError:
|
|
raise ParameterError(f"[{section}] {key} = {raw!r} ist keine Zahl") from None
|
|
|
|
|
|
def get_int(section: str, key: str) -> int:
|
|
"""Ganze Zahl aus [section] key (Anzahlen, Schrittweiten)."""
|
|
raw = _raw(section, key)
|
|
try:
|
|
return int(raw)
|
|
except ValueError:
|
|
raise ParameterError(f"[{section}] {key} = {raw!r} ist keine ganze Zahl") from None
|