z ijSrSSKJr SSKrSSKr\R (aSSKJr SSjr SS Sjjr g) zSI unit utilities) annotationsN)ParameterExpressionc SSSSSSSSSS S S . nU(a[U5S :XaU$US U;a[SU35eX!S nUS :aU[SU*5- $U[SU5-$)a Given a SI unit prefix and value, apply the prefix to convert to standard SI unit. Args: value: The number to apply prefix to. unit: String prefix. Returns: Converted value. .. note:: This may induce tiny value error due to internal representation of float object. See https://docs.python.org/3/tutorial/floatingpoint.html for details. Raises: ValueError: If the ``units`` aren't recognized.  ) fpnuµmkMGTPrzCould not understand unit: )len ValueErrorpow)valueunit prefactorspow10s L/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/utils/units.py apply_prefixr%s*          J 3t9>  Awj 6tf=>> Aw E qys2v&& 3r5> !!c SSSSSSSSS S S S . n[R"U5(d[S US35e[R"U5S:waN[ [R "[R "[R"U55S- 5S-5nOSnUS:aU[SU5- nOU[SU*5-nUb&[R"XA5nUS:a US-nUS- nX2;a[SU35eXBU4$)ah Given a SI unit value, find the most suitable prefix to scale the value. For example, the ``value = 1.3e8`` will be converted into a tuple of ``(130.0, "M")``, which represents a scaled value and auxiliary unit that may be used to display the value. In above example, that value might be displayed as ``130 MHz`` (unit is arbitrary here). Example: >>> value, prefix = detach_prefix(1e4) >>> print(f"{value} {prefix}Hz") 10 kHz Args: value: The number to find prefix. decimal: Optional. An arbitrary integer number to represent a precision of the value. If specified, it tries to round the mantissa and adjust the prefix to rounded value. For example, 999_999.91 will become 999.9999 k with ``decimal=4``, while 1.0 M with ``decimal=3`` or less. Returns: A tuple of scaled value and prefix. .. note:: This may induce tiny value error due to internal representation of float object. See https://docs.python.org/3/tutorial/floatingpoint.html for details. Raises: ValueError: If the ``value`` is out of range. ValueError: If the ``value`` is not real number. rrrrrrrrrr) rrrr r rr r r rrz,Input should be real number. Cannot convert .rr rizValue is out of range: ) npisrealrabsintfloorlog10rround)r decimalr"r#mants r$ detach_prefixr3JsD          J 99U  GwaPQQ vve}BHHRXXbffUm4q89A=> qys2u~%s2v&xx& 4< DLD QJE 25':;; E" ""r&)r float | ParameterExpressionr!strreturnr4)N)r floatr1z int | Noner6ztuple[float, str]) __doc__ __future__rtypingnumpyr* TYPE_CHECKING"qiskit.circuit.parameterexpressionrr%r3r&r$r?s+"  F/"dH#r&