#settings

Per-file simulator options. Each line overrides one key; omitted keys keep their defaults. The Settings modal and gear menu write the same lines back into your source when you save.

Reference

Key	Default	Type	What it does
`Scheduling`	`"always"`	enum	Gate packing mode. See Scheduling.
`MaxQubits`	`12`	int (2-20)	Highest wire index is MaxQubits − 1.
`VisibleQubits`	`2`	int	How many qubit rows the circuit builder shows.
`Zoom`	`100%`	percent or multiplier	Circuit builder zoom: 50%, 1, 1.5, 2.
`AutoAdjustVisibleQubits`	`true`	bool	Grow visible rows when code uses higher indices.
`DecimalPlaces`	`2`	int (0-12)	Digits for amplitudes and probabilities.
`AutoRun`	`true`	bool	Re-run the circuit when code changes.
`UseOptimizedGates`	`true`	bool	Use optimized decompositions where available.
`UseOptimizedSweep`	`true`	bool	Faster sweep runs when stepping combos or running the full sweep batch.
`StepByStep`	`false`	bool	Circuit builder step scrubber and play controls.
`ShowGateParams`	`true`	bool	Angle labels on rotation tiles.
`ShowEvaluatedLabels`	`true`	bool	Show evaluated LOOP counts and wire lists on blocks.
`GateParamAngleUnit`	`"degrees"`	degrees \| radians \| piradians	Unit for labels drawn on gates.
`CodeAngleUnit`	`"piradians"`	degrees \| radians \| piradians	Default unit for bare numbers in source code.
`SymbolicNotation`	`false`	bool	Prefer √(½) style in state displays.
`HideNegligibles`	`true`	bool	Drop near-zero amplitudes from the state vector.
`SortBy`	`"probability"`	probability \| label	Basis-state sort key.
`SortOrder`	`"desc"`	asc \| desc	Sort direction for basis states.

Full header example

Only non-default lines need to appear in practice - the block below shows every key for copy/paste:

#settings Scheduling "always"
#settings MaxQubits 12
#settings VisibleQubits 2
#settings Zoom 100%
#settings AutoAdjustVisibleQubits true
#settings DecimalPlaces 2
#settings AutoRun true
#settings UseOptimizedGates true
#settings UseOptimizedSweep true
#settings StepByStep false
#settings ShowGateParams true
#settings ShowEvaluatedLabels true
#settings GateParamAngleUnit "degrees"
#settings CodeAngleUnit "piradians"
#settings SymbolicNotation false
#settings HideNegligibles true
#settings SortBy "probability"
#settings SortOrder "desc"

Scheduling

See the dedicated Scheduling page. Quick version: "always" packs gates aggressively; "never" puts every gate in its own column.

StepByStep

Off by default. When true, the circuit builder shows the step scrubber, play button, and editable step counter (0 / N through N / N). Data Analysis always has its own step timeline regardless of this flag.