solve_internal_ballistics
Solve one internal-ballistics point: modeled velocity/energy/pressure for an exact cartridge+bullet+powder+charge specification, wrapped in the non-removable safety envelope (charge range, closed-enum warnings, assumptions). Returns the SAME envelope as POST /v1/solve. Measured accuracy: velocity averages about 7.5% error against 30,327 published loads; the pressure a user sees displayed reads 7.38% low against printed CUP figures and 0.91% low against printed psi figures at the median, so verdicts are relative — start low and work up. For load DEVELOPMENT prefer generate_load_ladder (a work-up ladder with per-rung nodes). 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>",
"charge_gr": "<charge_gr>",
"barrel_len_in": "<barrel_len_in>"
},
"name": "solve_internal_ballistics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bullet | Yes | Projectile display name ('Mfr Product (W gr)') or projectile.csv id | |
| powder | Yes | Propellant name ('Alliant Blue Dot') or propellant.csv id | |
| primer | No | Primer identity — accepted for forward compatibility; the engine does not model primers yet | |
| caliber | Yes | Cartridge name or caliber.csv id | |
| charge_gr | Yes | Powder charge in grains (sanity bounds 0.1..200) | |
| weight_gr | No | Bullet weight override in grains (optional). For cast bullets: same mold, different alloy, different weight (a LEE C358-158-SWC can drop 137 gr in pewter/tin vs 158 gr catalog nominal). None = catalog nominal. >20% off nominal emits BULLET_WEIGHT_OUTLIER. | |
| firearm_type | No | Revolver cylinder-gap override: 'auto' (default, engine detects from caliber name), '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, clamped outside). None = ambient (default). | |
| cartridge_oal_in | No | Cartridge overall length in inches (default: caliber max OAL) |