Cst Run And Score

Determine:

1. Version label — from user or auto-increment
2. Parameter overrides — which params to change from baseline
3. Material overrides — any material property changes (e.g., tanδ)
4. Extra VBA — topology changes (cross patches, resistive film, etc.)
5. Note — human-readable description of what this run tests

Step 3: Execute the Simulation

cd D:/Claude/auto_cst && python -c "
import sys, json
sys.path.insert(0, '.')
from engine.config import TargetConfig
from engine.runner import GeneralRunner

config = TargetConfig.from_json('configs/CONFIG_FILE.json')
runner = GeneralRunner(config)
result = runner.run(
    version='VERSION',
    param_overrides=PARAMS_DICT,
    material_overrides=MATERIALS_LIST_OR_NONE,
    extra_vba='''EXTRA_VBA_OR_EMPTY''',
    note='NOTE',
)
print(json.dumps(result, indent=2))
"

Parameter override example:

param_overrides={'p1s': 76.0, 'sp1': 24.0, 'st': 30.0}

Material override example (change polyimide tanδ):

material_overrides=[{'name': 'Polyimide', 'type': 'Normal', 'epsilon': 3.5, 'tand': 0.42, 'colour_r': '0.94', 'colour_g': '0.82', 'colour_b': '0.0'}]

Cross-patch VBA example:

extra_vba = build_cross_patch_vba(arm_ratio=0.55)  # from engine.vba_builder

Step 4: Score the Result

If the runner returned status="success", score the exported CSV:

cd D:/Claude/auto_cst && python -c "
import sys, json
sys.path.insert(0, '.')
from engine.config import TargetConfig
from engine.evaluator import GeneralEvaluator

config = TargetConfig.from_json('configs/CONFIG_FILE.json')
evaluator = GeneralEvaluator(config)
result = evaluator.evaluate_csv('exports/EXPORT_DIR/METRIC.csv')
print(json.dumps(result, indent=2))
"

Step 5: Report Results

Present to the user:

1. Score (0 = perfect, lower is better)
2. Summary line (mean, min, worst freq)
3. Sub-band breakdown table showing which bands are above/below target
4. Comparison to previous best if available

Example output format:

Version v37: Score = 0.0283
  Mean absorption: 88.4%
  Min absorption:  87.0% @ 4.773 THz

  Band        Mean     Min    Shortfall
  1.0-1.5    88.6%   87.1%      2.9% !!
  1.5-2.0    89.2%   88.2%      1.8% !!
  ...

VBA Topology Transforms

Available topology transforms (import from engine.vba_builder):

Cross-Shaped Patches

Replaces square patches with crosses. Each cross has two coupled resonances, providing ~1.4× bandwidth per layer.

from engine.vba_builder import build_cross_patch_vba
vba = build_cross_patch_vba(arm_ratio=0.55)  # arm_ratio: 0.3-0.7

Resistive Film

Adds a thin lossy metal layer between ground plane and first spacer. Provides uniform baseline absorption lift.

from engine.vba_builder import build_resistive_film_vba
vba = build_resistive_film_vba(sigma=500, thickness=0.1)  # sigma: 50-2000 S/m

Combining Transforms

from engine.vba_builder import build_cross_patch_vba, build_resistive_film_vba
vba = build_resistive_film_vba(500) + '\n' + build_cross_patch_vba(0.55)

Error Handling

• If CST fails to open: check license at E:\cst\license.dat
• If solver times out: reduce frequency range or increase solver_timeout_s in config
• If export fails: check that solver completed (status="success")
• If score is 999.0: no valid data in target frequency band