g\dZddlmZmZddlmZGddeZGddZd S) zAParameter Vector Class to simplify management of parameter lists.)uuid4UUID) ParametercheZdZdZdZd fd ZedZedZfdZ fdZ xZ S) ParameterVectorElementaAn element of a :class:`ParameterVector`. .. note:: There is very little reason to ever construct this class directly. Objects of this type are automatically constructed efficiently as part of creating a :class:`ParameterVector`. )_vector_indexNct|jd|d|||_||_dS)N[])uuid)super__init__namer r )selfvectorindexr __class__s T/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/parametervector.pyrzParameterVectorElement.__init__sE FK22%222>>>  c|jS)z3Get the index of this element in the parent vector.)r rs rrzParameterVectorElement.index#s {rc|jS)zGet the parent vector instance.)r rs rrzParameterVectorElement.vector(s |rcbt|j|jfzSN)r __getstate__r r )rrs rrz#ParameterVectorElement.__getstate__-s'ww##%%t{(CCCrcr|^}}}t|||_||_dSr)r __setstate__r r )rstate super_staterrrs rrz#ParameterVectorElement.__setstate__0s9&+#fe [)))  rr) __name__ __module__ __qualname____doc__ ___slots__rpropertyrrrr __classcell__)rs@rrrs'J XXDDDDDrrcteZdZdZdZddZedZedZdZ dZ d Z d Z d Z d Zd ZdS)ParameterVectora<A container of many related :class:`Parameter` objects. This class is faster to construct than constructing many :class:`Parameter` objects individually, and the individual names of the parameters will all share a common stem (the name of the vector). For a vector called ``v`` with length 3, the individual elements will have names ``v[0]``, ``v[1]`` and ``v[2]``. The elements of a vector are sorted by the name of the vector, then the numeric value of their index. This class fulfill the :class:`collections.abc.Sequence` interface. )_name_params _root_uuidrc|_t_jjfdt |D_dS)Nc Tg|]$}t|t|z%S)intrr.0i root_uuid_intrs r z,ParameterVector.__init__..KsC   MN "4D]Q5F,G,G,G H H   r)r+rr-r1ranger,)rrlengthr6s` @rrzParameterVector.__init__Gs\ ''+      RWX^R_R_    rc|jS)z)The name of the :class:`ParameterVector`.)r+rs rrzParameterVector.nameOs zrc|jS)zoA list of the contained :class:`ParameterVectorElement` instances. It is not safe to mutate this list.)r,rs rparamszParameterVector.paramsTs |rc6|j|S)zFind the index of a :class:`ParameterVectorElement` within the list. It is typically much faster to use the :attr:`ParameterVectorElement.index` property.)r,r)rvalues rrzParameterVector.index[s|!!%(((rc|j|Sr)r<)rkeys r __getitem__zParameterVector.__getitem__as{3rc*t|jSr)iterr<rs r__iter__zParameterVector.__iter__dsDK   rc*t|jSr)lenr,rs r__len__zParameterVector.__len__gs4<   rc8|jdd|jDS)Nz, c,g|]}t|S)str)r4items rr7z+ParameterVector.__str__..ksBBBdD BBBr)rr<rs r__str__zParameterVector.__str__js))DDBBdkBBBDDDrcj|jjdt|jdt |dS)Nz(name=z , length=))rr"reprrrFrs r__repr__zParameterVector.__repr__ms4.)WWdiWW3t99WWWWrc|tjkrUjjjfdt tj|DdSj|d=dS)a3Resize the parameter vector. If necessary, new elements are generated. Note that the UUID of each :class:`.Parameter` element will be generated deterministically given the root UUID of the ``ParameterVector`` and the index of the element. In particular, if a ``ParameterVector`` is resized to be smaller and then later resized to be larger, the UUID of the later generated element at a given index will be the same as the UUID of the previous element at that index. This is to ensure that the parameter instances do not change. >>> from qiskit.circuit import ParameterVector >>> pv = ParameterVector("theta", 20) >>> elt_19 = pv[19] >>> rv.resize(10) >>> rv.resize(20) >>> pv[19] == elt_19 True c Tg|]$}t|t|z%Sr0r2r3s rr7z*ParameterVector.resize..sE+4D]Q=N4O4O4OPPrN)rFr,r-r1extendr8)rr9r6s` @rresizezParameterVector.resizeps& C %% % % O/M L  "3t|#4#4f==      VWW%%%rN)r)r"r#r$r% __slots__rr'rr<rrArDrGrMrQrUrJrrr*r*7s  3I    XX )))    !!!!!!EEEXXX&&&&&rr*N)r%rrr parameterrrr*rJrrrXsHG      Y   FU&U&U&U&U&U&U&U&U&U&r