pfc5-servo-calibration
Design and audit PFC 5.0 wall servo, loading-rate control, equilibrium checks, micro-to-macro calibration, two-target local solves, DOE campaigns, and independent confirmation for asphalt models.
SKILL.mdskills/pfc5-servo-calibration/SKILL.md
GitHubPFC5 Servo And Calibration
Use this skill for compaction pressure, confining/load control, Marshall/rutting reaction control, Burger fitting, or multi-target PFC5 calibration.
Required Inputs
- controlled axis, actuator, sign convention, target and tolerance;
- effective stiffness estimate, timestep/update interval, velocity limits;
- active micro-parameters with units/bounds;
- macro targets, tolerances, experimental provenance and run budget;
- baseline save, seed policy and evaluator output schema.
Workflow
- Prove wall/axis/reaction sign with a short motion probe.
- Estimate effective stiffness and choose a conservative dimensionless gain.
- Clamp actuator velocity and record target, reaction, error, gain and velocity.
- Require equilibrium/inertia checks before accepting a stage.
- Calibrate in sequence: elastic response, strength/interface, time dependence, then post-peak/rutting behavior.
- Use the two-target solver only when exactly two active levers produce a well-conditioned local response matrix.
- For larger problems use DOE with real PFC5 runs; treat regression/surrogates as proposal tools only.
- Confirm the final parameters on an independent seed or loading condition.
Use scripts/servo_gain.py for a bounded proportional step and
scripts/dual_target_solver.py for a guarded local 2x2 solve. Read
calibration-contract.md before campaigns.
Working Rules
- Do not prescribe reaction force by writing a read-only contact-force quantity.
- Do not tune more parameters than the data can identify.
- Reject near-singular local solves; do not hide them with huge parameter jumps.
- Every proposed parameter set needs a true PFC5 confirmation run.
Output Contract
Return controller equations/signs, gain and clamp, histories, parameter/target tables, run manifest, conditioning diagnostics, confirmation result and runtime status.
Local Contents
references/calibration-contract.md— servo and campaign gates.scripts/servo_gain.py— bounded controller-step calculator.scripts/dual_target_solver.py— conditioned two-target update.agents/openai.yaml— interface metadata.