Cogitan
Documentation menu

CLI reference

AQFP

Fluxus v0 command line: analytic cQED oracle, QEM surrogate, frequency-collision yield Monte Carlo, inverse design, and the process registry. v0 numbers come from closed-form physics, not an EM solver. The CLI runs the engine in-process: no server and no key.

Exit codes

0 success, 2 bad input, 3 REFUSED (a well-formed request outside the engine's validity envelope -- a result, not an error). An out-of-envelope cell is not an error: it exits 0 with abstained set and the analytic oracle's answer.

fluxus aqfp

AQFP functional verdicts: majority and buffer cells

AQFP functional verdicts on the MIT-LL SFQ5ee AQFP process for the served cells (majority, buffer): the same answers as the /api/aqfp routes. Simulation, not silicon. Exit 3 means the head refused the design and says why.

usage
fluxus aqfp [-h] command ...

fluxus aqfp predict

functional verdict for one design

usage
fluxus aqfp predict [-h] [--cell {majority,buffer}] [--lin-ph X] [--l-arm-ph X] [--lq-ph X] [--lout-ph X] [--lx-ph X] [--kx X] [--kout X] [--ic-ua X] [--rshunt-ohm X] [--kd-over-kx X] [--iin UA] [--param NAME=VALUE] [--json]

Arguments

--cell
served cell (default majority)one of majority, buffer · default majority
--lin-ph X
pH (default 0.35)type float (finite)
--l-arm-ph X
pH (default 1.3)type float (finite)
--lq-ph X
pH (default 10)type float (finite)
--lout-ph X
pH (default 8)type float (finite)
--lx-ph X
pH (default 7.4)type float (finite)
--kx X
dimensionless (default 0.18)type float (finite)
--kout X
dimensionless (default -0.3)type float (finite)
--ic-ua X
uA (default 50)type float (finite)
--rshunt-ohm X
ohm (default 14)type float (finite)
--kd-over-kx X
dimensionless (default 1)type float (finite)
--iin, --iin-ua UA
input drive magnitude, uA (default 1.1 x ic_ua)type float (finite)
--param NAME=VALUE
any other request field, sent as given (e.g. a majority-only input, to see it refused)default [] · repeatable
--json
print the exact service output as JSONflag
example
fluxus aqfp predict --cell buffer --iin 55

fluxus aqfp cells

served cells, knobs, ranges, versions

usage
fluxus aqfp cells [-h] [--json]

Arguments

--json
print the exact service output as JSONflag
example
fluxus aqfp cells --json

fluxus aqfp batch

many designs from a .csv or .jsonl file

One design per CSV row (optional cell and iin_ua columns, the rest knobs) or JSONL line ({cell, params, iin_ua} or flat knobs). Writes one result per design: jsonl (the exact service slot) or csv (a summary row).

usage
fluxus aqfp batch [-h] [--cell {majority,buffer}] [-o PATH] [--format {jsonl,csv}] file

Arguments

FILE
input .csv or .jsonl
--cell
cell for rows that do not name one (default majority)one of majority, buffer · default majority
-o, --output PATH
write results here (default stdout)
--format
output format (default from -o, else jsonl)one of jsonl, csv
example
fluxus aqfp batch designs.csv -o results.jsonl

fluxus aqfp sweep

one or two knobs over a grid

usage
fluxus aqfp sweep [-h] [--cell {majority,buffer}] [--lin-ph X] [--l-arm-ph X] [--lq-ph X] [--lout-ph X] [--lx-ph X] [--kx X] [--kout X] [--ic-ua X] [--rshunt-ohm X] [--kd-over-kx X] [--iin UA] [--param NAME=VALUE] --knob KNOB --start START --stop STOP [--n N] [--knob2 KNOB2] [--start2 START2] [--stop2 STOP2] [--n2 N2] [--json]

Arguments

--cell
served cell (default majority)one of majority, buffer · default majority
--lin-ph X
pH (default 0.35)type float (finite)
--l-arm-ph X
pH (default 1.3)type float (finite)
--lq-ph X
pH (default 10)type float (finite)
--lout-ph X
pH (default 8)type float (finite)
--lx-ph X
pH (default 7.4)type float (finite)
--kx X
dimensionless (default 0.18)type float (finite)
--kout X
dimensionless (default -0.3)type float (finite)
--ic-ua X
uA (default 50)type float (finite)
--rshunt-ohm X
ohm (default 14)type float (finite)
--kd-over-kx X
dimensionless (default 1)type float (finite)
--iin, --iin-ua UA
input drive magnitude, uA (default 1.1 x ic_ua)type float (finite)
--param NAME=VALUE
any other request field, sent as given (e.g. a majority-only input, to see it refused)default [] · repeatable
--knobrequired
spec field or iin_ua
--startrequired
type float (finite)
--stoprequired
type float (finite)
--n
points (default 21; at most 201, or 41 per axis for two)type int
--knob2
second axis (optional)
--start2
type float (finite)
--stop2
type float (finite)
--n2
type int
--json
print the exact service output as JSONflag
example
fluxus aqfp sweep --cell buffer --knob lq_ph --start 4 --stop 30 --n 27

fluxus aqfp netlist

the circuit-test deck behind a verdict

Write the exact deck the label simulates for this design (label v2 for the majority, the buffer chain deck for the buffer) to stdout or -o; the read rule goes to stderr.

usage
fluxus aqfp netlist [-h] [--cell {majority,buffer}] [--lin-ph X] [--l-arm-ph X] [--lq-ph X] [--lout-ph X] [--lx-ph X] [--kx X] [--kout X] [--ic-ua X] [--rshunt-ohm X] [--kd-over-kx X] [--iin UA] [--param NAME=VALUE] [--leg {nominal,supplies_x0.9}] [--josim] [-o PATH] [--json]

Arguments

--cell
served cell (default majority)one of majority, buffer · default majority
--lin-ph X
pH (default 0.35)type float (finite)
--l-arm-ph X
pH (default 1.3)type float (finite)
--lq-ph X
pH (default 10)type float (finite)
--lout-ph X
pH (default 8)type float (finite)
--lx-ph X
pH (default 7.4)type float (finite)
--kx X
dimensionless (default 0.18)type float (finite)
--kout X
dimensionless (default -0.3)type float (finite)
--ic-ua X
uA (default 50)type float (finite)
--rshunt-ohm X
ohm (default 14)type float (finite)
--kd-over-kx X
dimensionless (default 1)type float (finite)
--iin, --iin-ua UA
input drive magnitude, uA (default 1.1 x ic_ua)type float (finite)
--param NAME=VALUE
any other request field, sent as given (e.g. a majority-only input, to see it refused)default [] · repeatable
--leg
one of nominal, supplies_x0.9 · default nominal
--josim
add .print lines for every gate's LQ currentflag
-o, --output PATH
--json
print the exact service output as JSONflag
example
fluxus aqfp netlist --cell buffer --josim -o buf.cir

fluxus aqfp interface

iface-1 interface margins and flag

usage
fluxus aqfp interface [-h] [--cell {majority,buffer}] [--lin-ph X] [--l-arm-ph X] [--lq-ph X] [--lout-ph X] [--lx-ph X] [--kx X] [--kout X] [--ic-ua X] [--rshunt-ohm X] [--kd-over-kx X] [--iin UA] [--param NAME=VALUE] [--json]

Arguments

--cell
served cell (default majority)one of majority, buffer · default majority
--lin-ph X
pH (default 0.35)type float (finite)
--l-arm-ph X
pH (default 1.3)type float (finite)
--lq-ph X
pH (default 10)type float (finite)
--lout-ph X
pH (default 8)type float (finite)
--lx-ph X
pH (default 7.4)type float (finite)
--kx X
dimensionless (default 0.18)type float (finite)
--kout X
dimensionless (default -0.3)type float (finite)
--ic-ua X
uA (default 50)type float (finite)
--rshunt-ohm X
ohm (default 14)type float (finite)
--kd-over-kx X
dimensionless (default 1)type float (finite)
--iin, --iin-ua UA
input drive magnitude, uA (default 1.1 x ic_ua)type float (finite)
--param NAME=VALUE
any other request field, sent as given (e.g. a majority-only input, to see it refused)default [] · repeatable
--json
print the exact service output as JSONflag
example
fluxus aqfp interface --lout-ph 2

fluxus aqfp status

whether each AQFP head can serve

usage
fluxus aqfp status [-h] [--json]

Arguments

--json
print the exact service output as JSONflag
example
fluxus aqfp status

Generated from Fluxus 0.3.0 at commit b9aa57d on 2026-10-20 by python -m fluxus.docs_bundle.