estimate_resources
Estimate physical qubits and runtime required to execute quantum algorithms on fault-tolerant hardware. Provide algorithm as template, counts, or Q# code and specify qubit model and error correction.
Instructions
Estimate the physical quantum resources needed to run a quantum algorithm.
Provide the algorithm as EXACTLY ONE of:
algorithm_template: ID of a predefined algorithm (e.g. 'shor_2048', 'grover_aes128', 'chemistry_femo', 'qpe_generic'). Use list_algorithm_templates() for the full list.
logical_counts: JSON string with algorithm counts, e.g.: '{"numQubits": 100, "tCount": 200, "rotationCount": 50}'
qsharp_code: Q# source code string with a parameterless entry point operation.
Hardware parameters:
qubit_model: Physical qubit technology. Default 'qubit_gate_ns_e3' (superconducting). Use list_qubit_models() for all options.
qec_scheme: Error correction scheme. 'surface_code' (default) or 'floquet_code' (Majorana qubits only).
error_budget: Acceptable failure probability (0-1). Default 0.001.
qubit_model_overrides: JSON string to override specific qubit parameters while keeping a named model as the base. E.g. '{"twoQubitGateTime": "10 ns"}'. Valid keys: oneQubitGateTime, twoQubitGateTime, oneQubitMeasurementTime, oneQubitGateErrorRate, twoQubitGateErrorRate, tGateErrorRate, readoutErrorRate, idleErrorRate.
Optional QEC scheme overrides (override individual parameters of the named qec_scheme):
qec_crossing_prefactor: float > 0. Error-suppression prefactor (default ~0.03).
qec_error_correction_threshold: float in (0,1). Error correction threshold (default ~0.01).
qec_logical_cycle_time: Formula string for logical cycle duration, e.g. '1000 ns' for a fixed 1 µs cycle (replicates Gidney-Ekerå assumption).
qec_physical_qubits_per_logical: Formula string for qubits per logical qubit.
Optional constraints (use at most one of max_duration or max_physical_qubits):
max_duration: e.g. '1 hour', '500 ms', '1 s'
max_physical_qubits: integer upper bound on qubit count
max_t_factories: limit T-factory copies (reduces qubits, increases runtime)
logical_depth_factor: multiplier on circuit depth (default 1.0)
Returns: summary (physical_qubits, runtime, logical_qubits, code_distance, t_factory_copies) plus full details breakdown.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qsharp_code | No | ||
| algorithm_template | No | ||
| logical_counts | No | ||
| qubit_model | No | qubit_gate_ns_e3 | |
| qec_scheme | No | surface_code | |
| error_budget | No | ||
| max_duration | No | ||
| max_physical_qubits | No | ||
| max_t_factories | No | ||
| logical_depth_factor | No | ||
| error_budget_logical | No | ||
| error_budget_t_states | No | ||
| error_budget_rotations | No | ||
| qubit_model_overrides | No | ||
| qec_crossing_prefactor | No | ||
| qec_error_correction_threshold | No | ||
| qec_logical_cycle_time | No | ||
| qec_physical_qubits_per_logical | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||