g<dZddlmZddlZddlmZdd ZdddZdS)zSI unit utilities) annotationsN)ParameterExpressionvaluefloat | ParameterExpressionunitstrreturnc dddddddddd d d }|rt|d kr|S|d |vrtd|||d }|d kr|td| z S|td|zS)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)rr prefactorspow10s H/granary/edev/quantum/lib/python3.11/site-packages/qiskit/utils/units.py apply_prefixr(s*           J 3t99>>  Awj  =t==>>> tAw E qyys2v&& 3r5>> !!floatdecimal int | Nonetuple[float, str]c "ddddddddd d d d }tj|std |dtj|dkrLt tjtjtj|dz dz}nd}|dkr|td|z }n|td| z}|%tj||}|dkr |dz}|dz }||vrtd||||fS)a 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) r r r rrrrrrrrz,Input should be real number. Cannot convert .rrr!NizValue is out of range: ) npisrealr#absintfloorlog10r$round)rr+r%r&mants r' detach_prefixr9GsGD           J 9U  RPPPPQQQ ve}}BHRXbfUmm44q899A=>> qyys2u~~%s2v&xg&& 4<< DLD QJE J:5::;;; E" ""r))rrrrr r)N)rr*r+r,r r-) __doc__ __future__rnumpyr1"qiskit.circuit.parameterexpressionrr(r9r)r'r?s|""""""BBBBBB/"/"/"/"dH#H#H#H#H#H#H#r)