Cogitan
Documentation menu

Quickstart

Radiation

One assessment returns the correlated-error footprint, burst rate and logical-error floor for a die in an environment. Read the card first: it is calibrated on two published devices and graded out of sample on four more, and it fails one of them. RAD has no CLI command; the API is its only surface.
Each step is a CLI command and the same request with curl. The curl lines read $FLUXUS_API and $COGITAN_API_KEY; set them as in Getting started. The CLI runs the engine in-process and needs neither.

  1. Read the radiation card

    Fidelity, validation, envelope, refusals and known misses for rad_assess.

    CLI
    fluxus capabilities
    curl
    curl -s "$FLUXUS_API/capabilities" -H "Authorization: Bearer $COGITAN_API_KEY"
    GET/v1/fluxus/capabilitiesfluxus capabilities reference

  2. Assess a die

    Muon source, a 300 um silicon die and a detection threshold. The threshold is a device property: without it the burst rate is refused rather than invented.

    No CLI command.

    curl
    curl -s "$FLUXUS_API/rad/assess" -H "Authorization: Bearer $COGITAN_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"detection_threshold_keV": 180, "thickness_um": 300, "source": "muon"}'
    POST/v1/fluxus/rad/assess

  3. See a refusal

    The same request without a detection threshold: the burst rate comes back refused, with the reason, and the top-level refusals list repeats it.

    No CLI command.

    curl
    curl -s "$FLUXUS_API/rad/assess" -H "Authorization: Bearer $COGITAN_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"thickness_um": 300, "source": "muon"}'
    POST/v1/fluxus/rad/assess

  4. Your own layout

    Real qubit positions on the die, in mm from its lower-left corner.

    No CLI command.

    curl
    curl -s "$FLUXUS_API/rad/assess" -H "Authorization: Bearer $COGITAN_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"detection_threshold_keV": 180, "die_mm": 5, "qubit_xy_mm": [[1, 1], [1, 2], [2, 1], [2, 2]]}'
    POST/v1/fluxus/rad/assess

  5. Compare mitigations

    Two designs in one call: bare, and half the backside covered in copper.

    No CLI command.

    curl
    curl -s "$FLUXUS_API/rad/assess/batch" -H "Authorization: Bearer $COGITAN_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"items": [{"detection_threshold_keV": 180}, {"detection_threshold_keV": 180, "backside_cu_coverage": 0.5}]}'
    POST/v1/fluxus/rad/assess/batch

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