akcli-design-calclisted

# akcli-design-calc — standards-backed calculators for circuit design Never do component-value math "from memory": run `akcli calc` and read the answer **with its citation**. Every result prints the formal source (standard, datasheet, or textbook) the formula comes from. ``` akcli calc list # all calculators, grouped akcli calc info <name> # parameters, defaults, the reference akcli calc <name> k=v ... [--json] ``` Inputs accept engineering notation: `4k7`, `100n`, `35u`, `2M2`, `1e-7`. `--json` returns `{calc, inputs, results{value,unit,note}, reference}`. **Input-suffix rule — already-milli units take a bare number.** When a parameter's declared unit is itself milli-denominated (`battery-life`'s `capacity` in **mAh**, `i_avg` in **mA**), pass the plain datasheet number: `battery-life capacity=2500 i_avg=10` means 2500 mAh @ 10 mA. A trailing engineering `m` there is **rejected** (`ERROR: capacity is already in mAh — write capacity=2500`) rather than silently applying a compounding 1000× milli. The generic length unit `m` (meters) is unaffected — `width=5m` still means 5 mm via the milli prefix. (`battery-life`'s default `derating` is 0.8, aligned with `battery`; override with `derating=`.) ## When to reach for which calculator | Design moment | Calculator | Source of the formula | |---|---|---| | Any resistor/cap value you are about to place | `eseries` (snap to E24/E96) | IEC 60063:2015 | | Value not purchasable → synthesize from 2–4 parts |