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[source]#
class _ControlFlowReturn(t0: float = 0)[source]#

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[source]#

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[source]#

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[source]#
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[source]#

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[source]#

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[source]#
validate_config(config: dict, scheme_fn: str) bool[source]#

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[source]#

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

Note: dictionaries from Python 3.7 are ordered.