Derating analysis
run_deratingGrade every rated part of a design against a derating standard — NASA GSFC (EEE-INST-002 factors, 105 °C junction cap) or IPC-9592 (115 °C cap) — after one nominal solve. Solved server-side through the signed-in account: unmetered on Pro and Team; on the Free plan each solve counts toward its 10 a month through connected apps (meta.solvesRemaining says how many are left), and a design has 1 sheet. The same evaluator the editor's Derating panel runs, so the person sees exactly this report. Give a design document, a templateId or a saved design's designId, and the standard (required: which table a part is held to is the engineer's call). Returns, per graded component, its stress checks — parameter, actual, rated, the derated limit, stressPct (actual over RATED) and status — its worst status and mitigation text; summary counts compliant / warning / overstressed; thresholds is the factor table used. Status: GREEN inside the limit, ORANGE within the last 20 % under it, RED over it. A rating left at 0 or blank is UNSTATED, not a 0 limit: the parameter is skipped and named in the component's unrated list — tell the engineer what to enter rather than reporting a pass. Sources, loads and the BMS have no abs-max ratings and are not graded. A Motor's "Rated Power" check grades SHAFT power (electrical input × efficiency) against ratedPower, its rated mechanical output; an Inverter's "VA Loading" grades its output apparent power against vaRating. Read solve.converged first: a report on a solve that did not converge grades numbers that mean nothing. Unmetered on Pro and Team; on the Free plan it counts as one of the month's solves.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| design | No | The design document. Give this, `templateId` or `designId`. | |
| designId | No | A saved design's id from create_design or list_designs — needs the signed-in account. Give this, `design` or `templateId`. | |
| standard | Yes | The derating standard to grade against. Required. | |
| templateId | No | A shipped template id from list_templates. Give this, `design` or `designId`. | |
| ambientTemperature | No | Ambient in °C for the solve and the thermal stress figure. Default 25. |