Skip to navigation

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

stanza.routines.builtins.dqd_search.routine.logger

Value: getLogger(...)

stanza.routines.builtins.dqd_search.routine.compute_peak_spacing(
ctx: stanza.routines.core.RoutineContext,
gates: list[str],
measure_electrode: str,
min_search_scale: float,
max_search_scale: float,
current_trace_points: int,
max_number_of_samples: int = 30,
number_of_samples_for_scale_computation: int = 10,
seed: int = 42,
session: stanza.logger.session.LoggerSession | None = None,
barrier_voltages: dict[str, float] | None = None,
**kwargs: typing.Any
) -> 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

stanza.routines.builtins.dqd_search.routine.run_dqd_search_fixed_barriers(
ctx: stanza.routines.core.RoutineContext,
gates: list[str],
measure_electrode: str,
current_trace_points: int = 128,
low_res_csd_points: int = 16,
high_res_csd_points: int = 48,
max_samples: int | None = None,
num_dqds_for_exit: int = 1,
include_diagonals: bool = False,
seed: int = 42,
session: stanza.logger.session.LoggerSession | None = None,
barrier_voltages: dict[str, float] | None = None,
**kwargs: typing.Any
) -> 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

stanza.routines.builtins.dqd_search.routine.run_dqd_search(
ctx: stanza.routines.core.RoutineContext,
gates: list[str],
measure_electrode: str,
min_search_scale: float,
max_search_scale: float,
current_trace_points: int,
outer_barrier_points: int = 5,
inner_barrier_points: int = 5,
num_dqds_for_exit: int = 1,
session: stanza.logger.session.LoggerSession | None = None,
**kwargs: typing.Any
) -> 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