stanza.routines.builtins.dqd_search.routine

Module Contents

Functions

NameDescription
compute_peak_spacingCompute peak spacing by analyzing Coulomb blockade patterns in random sweeps.
run_dqd_search_fixed_barriersRun DQD search with fixed barrier voltages using adaptive grid sampling.
run_dqd_searchRun peak spacing and DQD search over barrier voltage sweeps.

Data

logger

API

1stanza.routines.builtins.dqd_search.routine.logger

Value: getLogger(...)

1stanza.routines.builtins.dqd_search.routine.compute_peak_spacing(
2 ctx: stanza.routines.core.RoutineContext,
3 gates: list[str],
4 measure_electrode: str,
5 min_search_scale: float,
6 max_search_scale: float,
7 current_trace_points: int,
8 max_number_of_samples: int = 30,
9 number_of_samples_for_scale_computation: int = 10,
10 seed: int = 42,
11 session: stanza.logger.session.LoggerSession | None = None,
12 barrier_voltages: dict[str, float] | None = None,
13 **kwargs: typing.Any
14) -> dict[str, float]

Compute peak spacing by analyzing Coulomb blockade patterns in random sweeps.

Parameters:

ctx
stanza.routines.core.RoutineContext

Routine context with device and models client

gates
list[str]

Gate electrode names

measure_electrode
str

Current measurement electrode

min_search_scale
float

Minimum voltage scale to test (V)

max_search_scale
float

Maximum voltage scale to test (V)

current_trace_points
int

Points per sweep trace

max_number_of_samples
intDefaults to 30

Maximum sweep attempts per scale

number_of_samples_for_scale_computation
intDefaults to 10

Target successful samples per scale

seed
intDefaults to 42

Random seed for reproducibility

session
stanza.logger.session.LoggerSession | None

Logger session for telemetry

barrier_voltages
dict[str, float] | None

Barrier voltages to use

Returns:

Median peak spacing in volts

Raises:

ValueError: If no valid peak spacings detected

1stanza.routines.builtins.dqd_search.routine.run_dqd_search_fixed_barriers(
2 ctx: stanza.routines.core.RoutineContext,
3 gates: list[str],
4 measure_electrode: str,
5 current_trace_points: int = 128,
6 low_res_csd_points: int = 16,
7 high_res_csd_points: int = 48,
8 max_samples: int | None = None,
9 num_dqds_for_exit: int = 1,
10 include_diagonals: bool = False,
11 seed: int = 42,
12 session: stanza.logger.session.LoggerSession | None = None,
13 barrier_voltages: dict[str, float] | None = None,
14 **kwargs: typing.Any
15) -> dict[str, list[dict[str, typing.Any]]]

Run DQD search with fixed barrier voltages using adaptive grid sampling.

Parameters:

ctx
stanza.routines.core.RoutineContext

Routine context with device and models client

gates
list[str]

Gate electrode names

measure_electrode
str

Current measurement electrode

current_trace_points
intDefaults to 128

Points in diagonal current trace

low_res_csd_points
intDefaults to 16

Points per axis in low-res charge stability diagram

high_res_csd_points
intDefaults to 48

Points per axis in high-res CSD

max_samples
int | None

Maximum grid squares to sample (default: 50% of grid)

num_dqds_for_exit
intDefaults to 1

Exit after finding this many DQDs

include_diagonals
boolDefaults to False

Use 8-connected neighborhoods vs 4-connected

seed
intDefaults to 42

Random seed for reproducibility

session
stanza.logger.session.LoggerSession | None

Logger session for telemetry

barrier_voltages
dict[str, float] | None

Barrier voltages to use

Returns:

Dictionary with “dqd_squares” key containing list of all DQD squares found

1stanza.routines.builtins.dqd_search.routine.run_dqd_search(
2 ctx: stanza.routines.core.RoutineContext,
3 gates: list[str],
4 measure_electrode: str,
5 min_search_scale: float,
6 max_search_scale: float,
7 current_trace_points: int,
8 outer_barrier_points: int = 5,
9 inner_barrier_points: int = 5,
10 num_dqds_for_exit: int = 1,
11 session: stanza.logger.session.LoggerSession | None = None,
12 **kwargs: typing.Any
13) -> dict[str, typing.Any]

Run peak spacing and DQD search over barrier voltage sweeps.

Sweeps outer barriers (0, 2) from global turn-on to mean transition voltage. Sweeps inner barrier (1) from transition to global turn-on voltage. Runs compute_peak_spacing and run_dqd_search_fixed_barriers at each point.

Parameters:

ctx
stanza.routines.core.RoutineContext

Routine context

gates
list[str]

Gate electrode names

measure_electrode
str

Current measurement electrode

outer_barrier_points
intDefaults to 5

Number of sweep points for outer barriers

inner_barrier_points
intDefaults to 5

Number of sweep points for inner barrier

min_search_scale
float

Minimum search scale for compute_peak_spacing

max_search_scale
float

Maximum search scale for compute_peak_spacing

num_dqds_for_exit
intDefaults to 1

Number of DQDs for exit

current_trace_points
int

Points per current trace

session
stanza.logger.session.LoggerSession | None

Logger session

Returns:

Dict with run_dqd_search results