plm-electrical 0.1.0__py3-none-any.whl

plm_electrical/__init__.py

@@ -0,0 +1 @@
+"""Electrical engineering pack: level rules and tiers; the rest is plm.numeric."""

plm_electrical/claims.py

@@ -0,0 +1,28 @@
+"""Which tasks the electrical pack claims, and how strongly."""
+
+import re
+
+from plm.numeric.checks import requested_unit
+from plm.pack import evidence
+
+# An electrical calculation names something electrical (a term, or a unit symbol
+# after a number) and gives numbers or asks for a unit. Conceptual questions
+# ("Explain Ohm's law") have neither and go to the general pack.
+ELECTRICAL_TERM = re.compile(
+    # "air resistance" (and wind, rolling) is mechanics, not a resistor
+    r"\b(?:volts?|voltage|amps?|amperes?|amperage|current|ohms?|(?<!air )(?<!wind )(?<!rolling )resist(?:or|ors|ance)"
+    r"|capacit(?:or|ors|ance)"
+    r"|inductors?|inductance|watts?|kilowatts?|kWh|transformers?|circuits?|hertz|batter(?:y|ies)|LEDs?"
+    r"|op-amps?|amplifiers?|impedance|reactance|three-phase|RMS|farads?|henr(?:y|ies)|siemens|coulombs?"
+    r"|power factor|electricity|diodes?)\b",
+    re.IGNORECASE)
+UNIT_SYMBOL = re.compile(r"\d\s*(?:k|m|M|u|µ|μ|n)?(?:V|A|W|Ω|Hz|F|H|VA|var|Ah|Wh)\b")  # case-sensitive on purpose
+NUMBER = re.compile(r"\d")
+
+
+def claims(text):
+    """Distinct electrical terms and unit symbols, when there are numbers or a unit is asked for."""
+    if ((ELECTRICAL_TERM.search(text) or UNIT_SYMBOL.search(text))
+            and (NUMBER.search(text) or requested_unit(text) is not None)):
+        return evidence(ELECTRICAL_TERM, text, UNIT_SYMBOL)
+    return 0

plm_electrical/controller.py

@@ -0,0 +1,35 @@
+"""Electrical pack: tiers and level rules on top of the shared numeric controller.
+
+The defaults are the best policy from evals/simulate_routing.py: calm and alert
+problems go to the small model with the calculator, intensive ones to the large
+model, and any answer that fails plm.numeric.checks moves to the next step.
+Agreement checks (a second model's opinion) are not used: in the simulation they
+cost more compute than they saved.
+
+Model names can be overridden with PLM_SMALL_MODEL and PLM_LARGE_MODEL.
+"""
+
+import os
+
+from plm.numeric import controller as numeric
+
+from plm_electrical.levels import classify
+
+MODELS = {
+    "small": os.environ.get("PLM_SMALL_MODEL", "hf.co/bartowski/Qwen_Qwen3-4B-GGUF:Q4_K_M"),
+    "large": os.environ.get("PLM_LARGE_MODEL", "qwen3:8b"),
+}
+
+# Per level: token budget and the escalation chain of (model, strategy) steps.
+# Budgets are >2.5x the longest calculator answer seen in the eval runs.
+LEVELS = {
+    "calm": {"num_predict": 384, "chain": [("small", "tool"), ("large", "tool")]},
+    "alert": {"num_predict": 512, "chain": [("small", "tool"), ("large", "tool")]},
+    "intensive": {"num_predict": 1024, "chain": [("large", "tool"), ("large", "bare")]},
+}
+
+
+def solve(task, level=None, timeout=300):
+    """Answer one electrical task. Returns the answer plus a record of every model call."""
+    return numeric.solve(task, pack="electrical", classify=classify, levels=LEVELS, models=MODELS,
+                         level=level, timeout=timeout)

plm_electrical/levels.py

@@ -0,0 +1,26 @@
+"""Electrical pack: chain cues for the shared numeric level rules (plm/numeric/levels.py).
+
+The cues are written from the level definitions there, not fitted per question.
+Evaluate them with:  .venv/bin/python evals/eval_levels.py --pack electrical
+"""
+
+from plm.numeric import levels as numeric_levels
+
+# Each family is a sign that the answer needs a chain: compute X, then use X.
+CHAIN_CUES = {
+    "losses": r"efficien|internal resistance|\blost\b|\bloss|voltage drop|voltage at the",
+    "sizing": r"\bmaximum\b|\bminimum\b|needed to|required to|\braise\b|must run",
+    "topology": r"\bbridge\b|\bnode\b|\bdelta\b|\bwye\b|in series with a parallel|connected in parallel\b.*\bto the\b|"
+                r"through the \d|same circuit|\bthen\b|stage",
+    "ac-chain": r"power factor.*(capacit|reactive)|series RLC|series RC.*across|three-phase.*(real|total) power|line current",
+    "accumulate": r"\bcost\b|per day|a day|all day|surplus|deficit|\bfalls to\b",
+}
+
+
+def features(text):
+    return numeric_levels.features(text, CHAIN_CUES)
+
+
+def classify(text):
+    """Return (level, reason)."""
+    return numeric_levels.classify(text, CHAIN_CUES)

plm_electrical/manifest.py

@@ -0,0 +1,23 @@
+"""The electrical pack's manifest: what the router needs to know about it."""
+
+from plm.pack import Pack
+
+from plm_electrical import controller
+from plm_electrical.claims import claims
+
+UNIT_WORDS = {
+    "volts": "V", "millivolts": "mV", "kilovolts": "kV",
+    "amperes": "A", "amps": "A", "milliamperes": "mA",
+    "milliwatts": "mW", "var": "V*A", "volt-amperes": "V*A",
+    "ohms": "ohm", "kilohms": "kohm", "ohm-meters": "ohm*m",
+    "hertz": "Hz", "kilohertz": "kHz",
+    "watt-hours": "Wh", "kilowatt-hours": "kWh", "coulombs": "C",
+    "farads": "F", "microfarads": "uF", "nanofarads": "nF", "farads per meter": "F/m",
+    "henries": "H", "millihenries": "mH",
+    "siemens": "S", "millisiemens": "mS",
+    "decibels": "dB",
+}
+
+PACK = Pack(name="electrical", version="0.1.0", claims=claims, priority=60, solve=controller.solve,
+            levels=controller.LEVELS, models=controller.MODELS, unit_words=UNIT_WORDS,
+            eval_set="evals/electrical/problems.jsonl")

plm_electrical-0.1.0.dist-info/METADATA

@@ -0,0 +1,20 @@
+Metadata-Version: 2.5
+Name: plm-electrical
+Version: 0.1.0
+Summary: plm pack: Electrical engineering calculations, checked by units and sanity rules
+Project-URL: Homepage, https://github.com/ro-rbl/plm-orchestrator
+Project-URL: Source, https://github.com/ro-rbl/plm-orchestrator
+Project-URL: Issues, https://github.com/ro-rbl/plm-orchestrator/issues
+Author: ro-rbl
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: plm-core<0.2,>=0.1
+Description-Content-Type: text/markdown
+
+# plm-electrical
+
+Plm pack: Electrical engineering calculations, checked by units and sanity rules.
+
+A domain pack for [plm-core](https://github.com/ro-rbl/plm-orchestrator): install it with `plm packs install electrical`, which also pulls the
+models it needs into Ollama. Documentation, benchmark results and caveats: https://github.com/ro-rbl/plm-orchestrator

plm_electrical-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+plm_electrical/__init__.py,sha256=7I1SgizGAHMoQfi9HyPMWj005NPQIWHkP68HlevUyu8,83
+plm_electrical/claims.py,sha256=4rCXbYChpwqXqp_B9AhnnfR4nXbqW_wE9bh2UAjf1Oo,1383
+plm_electrical/controller.py,sha256=kB2NaAJv-_H9acxagUCI4Eu_HAg3soWmNt9MAgcDP-E,1494
+plm_electrical/levels.py,sha256=eZSWRCBy5OonHPLijiBwQcqNwIM9AhEFr5FMoWFRKUA,1149
+plm_electrical/manifest.py,sha256=e8c5w2gkIJFCnYtK4HiCM_oFTkh-dWBhKy4IKqYBRRU,979
+plm_electrical-0.1.0.dist-info/METADATA,sha256=jHbp4cjg3dM8fE6C9kPUwQM1Dufppb7GpZZrb8YsWBE,871
+plm_electrical-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+plm_electrical-0.1.0.dist-info/entry_points.txt,sha256=JGkpE6RN8fY0zYp8KrMbTLx5JGtmBrel2WTxxnAWD_A,54
+plm_electrical-0.1.0.dist-info/licenses/LICENSE,sha256=KcrxZgcJO8eG0MOaibWc_3Pxvh6U_KruTKPaGwV6-vA,1063
+plm_electrical-0.1.0.dist-info/RECORD,,

plm_electrical-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

plm_electrical-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[plm.packs]
+electrical = plm_electrical.manifest:PACK

plm_electrical-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ro-rbl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.