compilation

Compiler for the quantify_scheduler.

Module Contents

Classes

_ControlFlowReturn

An operation that signals the end of the current control flow statement.

Functions

_determine_absolute_timing(...)	Determine the absolute timing of a schedule based on the timing constraints.
determine_absolute_timing(...)	Determine the absolute timing of a schedule based on the timing constraints.
_get_start_time(→ float)
resolve_control_flow(...)	If control flow is used, insert virtual operations before and after the schedulable.
flatten_schedule(...)	Recursively flatten subschedules based on the absolute timing.
_insert_op_at_time(→ None)
validate_config(→ bool)	Validate a configuration using a schema.
_move_to_end(→ None)	Moves the element with key to the end of the dict.

Attributes

logger

logger

class _ControlFlowReturn(t0: float = 0)

Bases: quantify_scheduler.operations.operation.Operation

An operation that signals the end of the current control flow statement.

Cannot be added to Schedule manually.

Parameters:

t0 (float, optional) – time offset, by default 0

_determine_absolute_timing(schedule: quantify_scheduler.schedules.schedule.Schedule, time_unit: Literal[physical, ideal, None] = 'physical', config: quantify_scheduler.backends.graph_compilation.CompilationConfig | None = None) → quantify_scheduler.schedules.schedule.Schedule

Determine the absolute timing of a schedule based on the timing constraints.

This function determines absolute timings for every operation in the schedulables. It does this by:

1. iterating over all and elements in the schedulables.

2. determining the absolute time of the reference operation - reference point "ref_pt" of the reference operation defaults to "end" in case it is not set (i.e., is None).

3. determining the start of the operation based on the rel_time and duration of operations - reference point "ref_pt_new" of the added operation defaults to "start" in case it is not set.

Parameters:

• schedule – The schedule for which to determine timings.

• config – Compilation config for QuantifyCompiler.

• time_unit – Whether to use physical units to determine the absolute time or ideal time. When time_unit == "physical" the duration attribute is used. When time_unit == "ideal" the duration attribute is ignored and treated as if it is 1. When time_unit == None it will revert to "physical".

Returns:

The modified schedule where the absolute time for each operation has been determined.

Raises:

NotImplementedError – If the scheduling strategy is not “asap”

determine_absolute_timing(schedule: quantify_scheduler.schedules.schedule.Schedule, time_unit: Literal[physical, ideal, None] = 'physical', config: quantify_scheduler.backends.graph_compilation.CompilationConfig | None = None) → quantify_scheduler.schedules.schedule.Schedule

Determine the absolute timing of a schedule based on the timing constraints.

_get_start_time(schedule: quantify_scheduler.schedules.schedule.Schedule, t_constr: dict[str, str | float], curr_op: quantify_scheduler.operations.operation.Operation | quantify_scheduler.schedules.schedule.Schedule, time_unit: str) → float

resolve_control_flow(schedule: quantify_scheduler.schedules.schedule.Schedule, config: quantify_scheduler.backends.graph_compilation.CompilationConfig | None = None, port_clocks: set | None = None) → quantify_scheduler.schedules.schedule.Schedule

If control flow is used, insert virtual operations before and after the schedulable.

Parameters:

• schedule – The schedule for which to fill relative timings.

• config – Compilation config for QuantifyCompiler, which is currently not used in this compilation step.

• port_clocks – Port-clock combinations to be used for control flow. Determined automatically for the outermost schedule.

Returns:

a new schedule object where the timing constraints for each operation have been determined.

flatten_schedule(schedule: quantify_scheduler.schedules.schedule.Schedule, config: quantify_scheduler.backends.graph_compilation.CompilationConfig | None = None) → quantify_scheduler.schedules.schedule.Schedule

Recursively flatten subschedules based on the absolute timing.

Parameters:

• schedule (Schedule) – schedule to be flattened

• config (CompilationConfig | None, optional) – Compilation config for QuantifyCompiler, which is currently not only used to detect if the function is called directly. by default None

Returns:

Equivalent schedule without subschedules

Return type:

Schedule

_insert_op_at_time(schedule: quantify_scheduler.schedules.schedule.Schedule, operation: quantify_scheduler.operations.operation.Operation, abs_time: float) → None

validate_config(config: dict, scheme_fn: str) → bool

Validate a configuration using a schema.

Parameters:

• config – The configuration to validate

• scheme_fn – The name of a json schema in the quantify_scheduler.schemas folder.

Returns:

True if valid

_move_to_end(ordered_dict: dict, key: Any) → None

Moves the element with key to the end of the dict.

Note: dictionaries from Python 3.7 are ordered.