generate_load_ladder
PREFERRED for load development: generate a work-up ladder (>=5 rungs required — coarser requests are refused LADDER_TOO_COARSE, never silently interpolated) from the published-reference or charge-only bookends down, with per-rung trajectory nodes and the full safety envelope. Requires an API key or subscriber token — anonymous callers are refused pre-compute. Returns the SAME envelope as POST /v1/ladder. SAFETY (verbatim policy): Returns modeled pressure and velocity from a physics solver, plus a safety envelope. This is NOT published load data. Always present the envelope, warnings, and disclaimer to the user; never state a single charge weight as a recommendation. Pressure fields (p_max_bar, p_max_psi, saami_max_bar) are modeled compliance-vs-SAAMI-ceiling indicators on the model's CUP-equivalent scale, while pressure_percent_saami is reported piezo-equivalent: the percent equals p_max_bar x 1.2783 / saami_max_bar, so it is NOT peak / ceiling as served. The factor compensates a measured model under-drive on transducer anchors; the pure CUP-to-piezo convention component is bounded near 4-8%, and the remainder is genuine under-drive retained so an over-max load cannot read safe. Not measured proof pressures and not accuracy-validated numbers: the validation corpus is velocity-only. Treat them as position relative to the ceiling, with real-world spread unknown. not_for_loading_decisions_without_published_data: this result is a model output. Do not work up a load from it alone — cross-check against published data for your exact components before loading.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"caliber": "<caliber>",
"bullet": "<bullet>",
"powder": "<powder>",
"barrel_len_in": "<barrel_len_in>"
},
"name": "generate_load_ladder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bullet | Yes | Projectile display name or projectile.csv id | |
| powder | Yes | Propellant name or propellant.csv id | |
| primer | No | Primer identity — accepted for forward compatibility | |
| caliber | Yes | Cartridge name or caliber.csv id | |
| n_rungs | No | Number of ladder rungs (3–10, default 7) | |
| charge_gr | No | Current charge (enables sensitivity + next-rung marker) | |
| firearm_type | No | Revolver cylinder-gap override: 'auto' (default), 'revolver', or 'not_revolver' (rifle/pistol) | |
| barrel_len_in | Yes | Barrel length in inches | |
| powder_temp_c | No | Powder temperature in °C (optional; -29..+49 validated band) | |
| cartridge_oal_in | No | Cartridge overall length in inches (default: caliber max OAL) |