g3n2(dZddlZddlZddlZddlZddlmZddlmZmZm Z m Z ddl Z ddl mZddlmZddlmZmZmZddlmZdd lmZdd lmZmZmZmZdd lmZdd l m!Z!m"Z"m#Z#dd l$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ej+e,Z-dZ.e(dddddddddddddde%j/e&j0dddddddfde eeeeeeeeefde ede e1de e e#efde e2de e3de e2de ee4d e ee4d!e ee4d"e ee4d#e e ee eee4fefe eee4feffd$e e2e%fd%e e1e&fd&e eeed'e2d(e e2d)e e4d*e eeee4fd+e ee1d,e3d-ed.e e!e"ff.d/Z5ddddddddddde%j/e&j0dddddddfde eeeeeeeeefde ede e1de e e#efde e2de e3de e2de ee4d e ee4d!e ee4d"e ee4d#e e ee eee4fefe eee4feffd$e e2e%fd%e e1e&fd&e eeed'e2d(e e2d)e e4d*e eeee4fd+e ee1d,e3d-ed.e e!e"ff.d0Z6 d$(FRRRRG KKz1.2zin the 2.0 releasezThe `Qobj` class and related functionality are part of the deprecated `BackendV1` workflow, and no longer necessary for `BackendV2`. If a user workflow requires `Qobj` it likely relies on deprecated functionality and should be updated to use `BackendV2`.)sinceremoval_timelineadditional_msgFdT experimentsbackendqobj_id qobj_headershotsmemoryseed_simulator qubit_lo_freq meas_lo_freqqubit_lo_range meas_lo_range schedule_los meas_level meas_returnmeas_mapmemory_slot_sizerep_time rep_delayparameter_bindsparametric_pulses init_qubits run_configreturnc Dt|||||||||| | | | | |||||||fi|S)aAssemble a list of circuits or pulse schedules into a ``Qobj``. This function serializes the payloads, which could be either circuits or schedules, to create ``Qobj`` "experiments". It further annotates the experiment payload with header and configurations. NOTE: ``Backend.options`` is not used within assemble. The required values (previously given by backend.set_options) should be manually extracted from options and supplied directly when calling. Args: experiments: Circuit(s) or pulse schedule(s) to execute backend: If set, some runtime options are automatically grabbed from ``backend.configuration()`` and ``backend.defaults()``. If any other option is explicitly set (e.g., ``rep_time``), it will override the backend's. If any other options is set in the run_config, it will also override the backend's. qobj_id: String identifier to annotate the ``Qobj`` qobj_header: User input that will be inserted in ``Qobj`` header, and will also be copied to the corresponding Result header. Headers do not affect the run. shots: Number of repetitions of each circuit, for sampling. Default: 1024 or ``max_shots`` from the backend configuration, whichever is smaller memory: If ``True``, per-shot measurement bitstrings are returned as well (provided the backend supports it). For OpenPulse jobs, only measurement level 2 supports this option. seed_simulator: Random seed to control sampling, for when backend is a simulator qubit_lo_freq: List of job level qubit drive LO frequencies in Hz. Overridden by ``schedule_los`` if specified. Must have length ``n_qubits.`` meas_lo_freq: List of measurement LO frequencies in Hz. Overridden by ``schedule_los`` if specified. Must have length ``n_qubits.`` qubit_lo_range: List of job level drive LO ranges each of form ``[range_min, range_max]`` in Hz. Used to validate ``qubit_lo_freq``. Must have length ``n_qubits.`` meas_lo_range: List of job level measurement LO ranges each of form ``[range_min, range_max]`` in Hz. Used to validate ``meas_lo_freq``. Must have length ``n_qubits.`` schedule_los: Experiment level (ie circuit or schedule) LO frequency configurations for qubit drive and measurement channels. These values override the job level values from ``default_qubit_los`` and ``default_meas_los``. Frequencies are in Hz. Settable for OpenQASM 2 and pulse jobs. meas_level: Set the appropriate level of the measurement output for pulse experiments. meas_return: Level of measurement data for the backend to return. For ``meas_level`` 0 and 1: * ``single`` returns information from every shot. * ``avg`` returns average measurement output (averaged over number of shots). meas_map: List of lists, containing qubits that must be measured together. memory_slot_size: Size of each memory slot if the output is Level 0. rep_time (int): Time per program execution in seconds. Must be from the list provided by the backend (``backend.configuration().rep_times``). Defaults to the first entry. rep_delay (float): Delay between programs in seconds. Only supported on certain backends (if ``backend.configuration().dynamic_reprate_enabled=True``). If supported, ``rep_delay`` will be used instead of ``rep_time`` and must be from the range supplied by the backend (``backend.configuration().rep_delay_range``). Default is given by ``backend.configuration().default_rep_delay``. parameter_binds: List of Parameter bindings over which the set of experiments will be executed. Each list element (bind) should be of the form {Parameter1: value1, Parameter2: value2, ...}. All binds will be executed across all experiments; e.g., if parameter_binds is a length-n list, and there are m experiments, a total of m x n experiments will be run (one for each experiment/bind pair). parametric_pulses: A list of pulse shapes which are supported internally on the backend. Example:: ['gaussian', 'constant'] init_qubits: Whether to reset the qubits to the ground state for each shot. Default: ``True``. **run_config: Extra arguments used to configure the run (e.g., for Aer configurable backends). Refer to the backend documentation for details on these arguments. Returns: A ``Qobj`` that can be run on a backend. Depending on the type of input, this will be either a ``QasmQobj`` or a ``PulseQobj``. Raises: QiskitError: if the input cannot be interpreted as either circuits or schedules ) _assemble)r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=s r!assemblerA,set  +  , -  r#c t}t|tr|n|g}td|D}t j5t jdtdt||||||||||| | | f d|i|\}}}dddn #1swxYwYtd|Drt j5t jdtddt||| | |fi|}dddn #1swxYwYt|| \}}t}t||t|||| Std |DrDt|| | ||||fi|}t}t||t|||| St!d )Nc3ZK|]&}t|tttfV'dSN isinstancerrr.0exps r! z_assemble..s4ddQTZmX{%KLLddddddr#ignoreqiskitcategorymodule pulse_qobjc3@K|]}t|tVdSrD)rFr rGs r!rJz_assemble..s, B Bs:c> * * B B B B B Br#zD.+\.basic_provider\.basic_simulator\.BasicSimulator\.configuration.+)rNmessagerO)circuitsr=)rSr*r+r=c3ZK|]&}t|tttfV'dSrDrErGs r!rJz_assemble..&s3 \ \ZmX{C D D \ \ \ \ \ \r#) schedulesr*r+r=zFbad input to assemble() function; must be either circuits or schedules)rrFlistanywarningscatch_warningsfilterwarningsDeprecationWarning_parse_common_argsall_parse_circuit_args_expand_parametersr"r_parse_pulse_argsrr )r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=rrPrun_config_common_dictbound_experimentsrs r!r@r@sHJ!+K!>!>Q++[MKddXcdddddJ  " "  3EhWWWW7I             8 8 "8 8 8 44               , B Bk B B BBB2d  $ & &    #+_      -!  ) J               $); Z) ) ) %:66:x000!&#!      \ \P[ \ \ \ \ \d&          %   66:x000!!7 Xb    bcccs$z&_parse_common_args..sVVVA 1 r# max_shotsiz(Argument 'shots' should be of type 'int'zNumber of shots specified: z, exceeds max_shots property of the backend: .dynamic_reprate_enabledFdefault_rep_delayrep_delay_rangezFDynamic rep rates not supported on this backend, cannot use rep_delay.qubit_freq_est meas_freq_estr1r2qubitmeascZg|](}t|tr|nt|)Srg)rFr)rH lo_configs r! z&_parse_common_args..sC  844M (9:M:Mr#) r,r-r.r<r9r/r0r1r2r3n_qubitsrg) configurationrxr-r rd open_pulsedefaultsAttributeErrorstruuiduuid4rFrto_dictgetattritemsminintnpinteger_parse_rep_delayrXwarnRuntimeWarning_check_lo_freqsrdict)r)r*r+r,r-r.r<r9r/r0r1r2r3rPr=backend_configbackend_defaultsrxpulse_param_setrdrerlrnrorprun_config_dicts r!r\r\=sNNH ..00!*  `./ `^A\^^__ _  % (4' (T) (D( (4'   .3   #*#3#3#5#5  !    *TZ\\**G#K+z**,!))++ >>4@@Ln.?FFO$* K WWVV1B1B1D1DVVVWWK T::I }  i((EEEE RZ0 1 1 DEEE  y5(( %) % %! % % %   &n6OQVWW #N4GNN!.2CTJJ$Y0A?SS  I MX    "VW-=?OQU%V%VMS7+;_d#S#SL#Vw~?OQU'V'VN!SW^_d%S%SMM>7;;;L-888 %2L,4 011&$~ %L("&$(&$    O K 00s$A99 BBlo_freqlo_rangelo_typec|r|rt|t|krt|D]\}}||}t|trt|dkst d|d||dks ||dkr+t d|d|d|d |dd |dd d Sd Sd Sd S) aCheck that LO frequencies are within the perscribed LO range. NOTE: Only checks if frequency/range lists have equal length. And does not check that the lists have length ``n_qubits``. This is because some backends, like simulator backends, do not require these constraints. For real hardware, these parameters will be validated on the backend. Args: lo_freq: List of LO frequencies. lo_range: Nested list of LO frequency ranges. Inner list is of the form ``[lo_min, lo_max]``. lo_type: The type of LO value--"qubit" or "meas". Raises: QiskitError: - If each element of the LO range is not a 2d list. - If the LO frequency is not in the LO range for a given qubit. zEach element of z LO range must be a 2d list.rzQubit  z LO frequency is z. The range is [z, z].N)len enumeraterFrVr )rrrifreq freq_ranges r!rrs>, 8 G H = = ))  GAt!!Jz400 \S__5I5I!"ZW"Z"Z"Z[[[jm##tjm';';!HQHHHH4HH%/]HH6@mHHH(<     = =  r#c Ld}|rU|}|t|dtjgvr#t d|d|jd|jd|pt|dd}t|dd } |pt|d d}|rK| rtjd tt|tr|d }t|d z}|t|dg}||||||d|} tdid| D}|S)aBuild a pulse RunConfig replacing unset arguments with defaults derived from the `backend`. See `assemble` for more information on the required arguments. Returns: RunConfig: a run config, which is a standardized object that configures the qobj and determines the runtime environment. Raises: QiskitError: If the given meas_level is not allowed for the given `backend`. N meas_levelsz meas_level = z not supported for backend z, only z is supportedr6rnF rep_timesz`Dynamic rep rates are supported on this backend. 'rep_delay' will be used instead of 'rep_time'.r.Ar;)r4r5r6r7r8r;ci|] \}}||| SrDrgrhs r!rkz%_parse_pulse_args..+XXXtq!!-a---r#rg)ryrr CLASSIFIEDr rdrrXrrrFrVrr r) r)r4r5r6r7r8r;r=rrnrs r!r`r`s(N ..00 W^]YEYDZ[[ [ [a aa!.aa7E7Qaaa  D7>:tDDH%n6OQVWWE7>;EEH ' "  M.    h % % #{Hx#~&& #N4GLL!",.  OYYXX/D/D/F/FXXXYYJ r#c |pg}d|i|}|v|rntj5tjdtdt |dg|d<dddn #1swxYwYn g|d<n||d<|r||d<|t jkr||d<td id | D}|S) a@Build a circuit RunConfig replacing unset arguments with defaults derived from the `backend`. See `assemble` for more information on the required arguments. Returns: RunConfig: a run config, which is a standardized object that configures the qobj and determines the runtime environment. r:NrKrLrMr;r4r5ci|] \}}||| SrDrgrhs r!rkz'_parse_circuit_args..Orr#rg) rXrYrZr[rryrrr r)r:r)r4r5r;r=rs r!r^r^0sL&+O(/HZHO  6(**  ';MV^____7>))++-@"88 34               46O/ 0 0/@+,9(2 % - - --8OM *YYXX/D/D/F/FXXXYYJ sAA11A58A5rorpc||}|r|kt|trVt|dkrtd|d|d|cxkr |dksntd|d||d z}|S) aParse and set ``rep_delay`` parameter in runtime config. Args: rep_delay: Initial rep delay. default_rep_delay: Backend default rep delay. rep_delay_range: Backend list defining allowable range of rep delays. Raises: QiskitError: If rep_delay is not in the backend rep_delay_range. Returns: float: Modified rep delay after parsing. NrzBackend rep_delay_range z! must be a list with two entries.rrzSupplied rep delay z$ not in the supported backend range r)rFrVrr )r9rorps r!rrTs%   &:ot+L+L &?##q((!aaaa#1%HHHHoa6HHHHH!7)77%477O r#c|jrtstd|DrdD}d|D}d||zD|r8|r6tfd|Dstfd|Dr#td||fd|D}t j|}g|_||fS) aVerifies that there is a single common set of parameters shared between all circuits and all parameter binds in the run_config. Returns an expanded list of circuits (if parameterized) with all parameters bound, and a copy of the run_config with parameter_binds cleared. If neither the circuits nor the run_config specify parameters, the two are returned unmodified. Raises: QiskitError: if run_config parameters are not compatible with circuit parameters Returns: Tuple(List[QuantumCircuit], RunConfig): - List of input circuits expanded and with parameters bound - RunConfig with parameter_binds removed c3$K|] }|jV dSrD parametersrHcircuits r!rJz%_expand_parameters..s%6b6bgw7I6b6b6b6b6b6br#ctg|]5}t|6Srg)r _unroll_param_dictkeys)rHbinds r!rwz&_expand_parameters..sE   AEN   / / 5 5 : : < <   r#cg|] }|j Srgrrs r!rwz&_expand_parameters..s!M!M!M'"4!M!M!Mr#ch|] }|D]}| Srgrg)rH param_listparams r! z%_expand_parameters..s?   #       r#c3$K|] }|kV dSrDrg)rH bind_paramsunique_parameterss r!rJz%_expand_parameters..s)[[ $ 3[[[[[[r#c3$K|] }|kV dSrDrg)rHrrs r!rJz%_expand_parameters..s)\\z$ 2\\\\\\r#zrMismatch between run_config.parameter_binds and all circuit parameters. Parameter binds: {} Circuit parameters: {}cDg|]}D]}||Srg)assign_parameters)rHrbindsr:s r!rwz&_expand_parameters..sI   18Ra  ING % %e , ,    r#)r:rWr formatcopydeepcopy)rSr=all_bind_parametersall_circuit_parametersr:rs @@r!r_r_wsy"!0O%(3//%(36b6bYa6b6b6b3b3b%(  IX   "N!MH!M!M!M  14JJ   $ ) [[[[GZ[[[[[ \\\\E[\\\\\  /&,.DEE      rsFE  ............//////111111;;;;;;;;;;)))))),,,,,,GGGGGGGGGGGG......777777777777777777''''''AAAAAA  8 $ $  ),""&!59"$(+/*.,0+/ (1(<.<.D,0"!%>B-1CII ^ X ]  Ig Ic]I% D 012I C=I TNISMIDK(I 4;'!I"T%[)#I$DK(%I& tL%/0(:; < $|U*+X5 6 8 'I2c9n%3I4sN*+5I6tDK()7I89I:sm;I<=I>d4 5(8#9:;?I@ S *AIBCIDEIF 8Y GIIII~"&!59"$(+/*.,0+/ (1(<.<.D,0"!%>B-1Codod ^ X ]  odg odc]od% D 012od C=od TNodSModDK(od 4;'!od"T%[)#od$DK(%od& tL%/0(:; < $|U*+X5 6 8 'od2c9n%3od4sN*+5od6tDK()7od89od:sm;od<=od>d4 5(8#9:;?od@ S *AodBCodDEodF 8Y GododododBP1P1P1P1f 4;$ %DK%&D;;;|!!!H  ). AEe      F: : : : : r#