biW!dZddlZddlmZmZmZddlZddlm Z ddl m Z ddlmcmZddlmZddlmcmZddlmZddlmZdZGddeZy) a, Copyright 2013 Steven Diamond Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. N)ListOptionalTuple)Leaf)performance_utilszgInitializing a Constant with a nested list is undefined behavior. Consider using a numpy array instead.ceZdZdZddeeddffd ZdefdZdedfdZ de fdZ e d Z de fd Ze d Ze deed ffd ZdZdefdZde fdZde fdZde fdZej2de fdZej2de fdZej2de fdZddZddZde fdZej2de fdZ ej2de fdZ!xZ"S)ConstantaC A constant value. Raw numerical constants such as Python primitive types or NumPy ndarrays are implicitly cast to constants via Expression operator overloading. For example, if ``x`` is an expression and``c`` is a raw constant, then ``x + c`` creates an expression by casting ``c`` to a Constant. NnamereturncDtj|r.tjj|d|_d|_nft |tr+td|Drtjttjj||_d|_d|_ d|_d|_d|_d|_d|_d|_d|_d|_||_t.t0|gtj4|j6y)NT)convert_scalarsc3<K|]}t|tywN) isinstancelist).0is _/home/cdr/jupyterlab/.venv/lib/python3.12/site-packages/cvxpy/expressions/constants/constant.py z$Constant.__init__..3s.Rqz!T/B.RsF)intf is_sparseDEFAULT_SPARSE_INTFconst_to_matrix_value_sparserranywarningswarnNESTED_LIST_WARNING DEFAULT_INTF_imag_nonneg_nonpos_symm_herm _psd_test _nsd_test_cached_is_pos _skew_symm_namesuperr __init__shapevalue)selfr.r __class__s rr,zConstant.__init__,s >>% 22BBtC-DKDL%&3.RE.R+R 12++;;EBDK DL%) '+ '+ %) %) )-)-"  h&tzz$**'=>c>|jt|jdk(rYdt|jvrBt j |jtjtjddiSt|jS|jS)z9 The value of the constant as a string.  floatc |dS)Nz.2f)xs rzConstant.name..Ms #wr1) edgeitems threshold formatter) r*lenr-strr.np array2stringsPRINT_EDGEITEMSPRINT_THRESHOLDr/s rr z Constant.nameDs{ :: 4::!#DJJ(?tzz121B1B121B1B29;O1PRRtzz? ":: r1c|gS)z$Returns self as a constant. r7rDs r constantszConstant.constantsRs v r1cy)NTr7rDs r is_constantzConstant.is_constantWsr1c|jS)zBNumPy.ndarray or None: The numeric value of the constant. )rrDs rr.zConstant.valueZ{{r1c|jYtj|jrd|_|jSt j |jdkD|_|jS)z>Returns whether the constant is elementwise positive. Fr)r(spissparserr?allrDs ris_poszConstant.is_pos`s_    &{{4;;'',#"""')ffT[[1_&=#"""r1ciS)zGives the (sub/super)gradient of the expression w.r.t. each variable. Matrix expressions are vectorized, so the gradient is a matrix. Returns: A map of variable to SciPy CSC sparse matrix or None. r7rDs rgradz Constant.gradls  r1.c|jS)z=Returns the (row, col) dimensions of the expression. )_shaperDs rr-zConstant.shapewrJr1cttj|j|j|j}|gfS)zReturns the graph implementation of the object. Returns: A tuple of (affine expression, [constraints]). )lu create_constr.r-r)r/objs r canonicalizezConstant.canonicalize}s, oodjj$**dllCRyr1cVd|jd|jd|jdS)z@Returns a string with information about the expression. z Constant(z, )) curvaturesignr-rDs r__repr__zConstant.__repr__s#*.)-)-5 5r1cR|j|j|jS)z'Is the expression nonnegative? )r" _compute_attrrDs r is_nonnegzConstant.is_nonneg$ <<     ||r1cR|j|j|jS)z'Is the expression nonpositive? )r#r_rDs r is_nonposzConstant.is_nonposrar1cR|j|j|jS)zIs the Leaf imaginary? )r!r_rDs ris_imagzConstant.is_imags$ ::     zzr1c@tj|jS)z$Is the Leaf complex valued? )r? iscomplexobjr.rDs r is_complexzConstant.is_complexstzz**r1c|jry|jdk(rG|jd|jdk(r(|j|j |jSy)z%Is the expression symmetric? Tr3rF) is_scalarndimr-r$_compute_symm_attrrDs r is_symmetriczConstant.is_symmetricsV >>  YY!^ 1 A >zz!''):: r1c|jr|jry|jdk(rG|jd|jdk(r(|j|j |jSy)z.Is the expression a Hermitian matrix? Tr3rrjF)rkis_realrlr-r%rmrDs r is_hermitianzConstant.is_hermitians^ >>   YY!^ 1 A >zz!''):: r1ctj|j\}}|jrdx}}n"tj|j\}}|xr| |_||_||_y)zNCompute the attributes of the constant related to complex/real, sign. FN)rrhr.r\r!r#r")r/rprer`rcs rr_zConstant._compute_attrsb ??4::6 ?? $) )I #'99TZZ#8 Iy-g+     r1cdtj|j\}}||_||_y)z?Determine whether the constant is symmetric/Hermitian. N)rrqr.r$r%)r/is_symmis_herms rrmzConstant._compute_symm_attrs+ ,,TZZ8  r1cz|j$tj|j|_|jSr)r)ris_skew_symmetricr.rDs rrwzConstant.is_skew_symmetrics, ?? ""44TZZ@DOr1c|jr|jry|jry|jdk(ry|jdk(r |jd|jdk7ry|j sy|j 3t j|jtj|_|j S)z:Is the expression a positive semidefinite matrix? TFrjr3r) rkr`rlr-rqr&eig_utilis_psd_within_tolr.rA EIGVAL_TOLrDs ris_psdzConstant.is_psds >>  0 ^^  YY!^ YY!^ 1 A >""$ >> !%77 ALLQDN~~r1c|jr|jry|jry|jdk(ry|jdk(r |jd|jdk7ry|j sy|j 4t j|j tj|_|j S)z:Is the expression a negative semidefinite matrix? TFrjr3r) rkrcrlr-rqr'ryrzr.rAr{rDs ris_nsdzConstant.is_nsds >>  0 ^^  YY!^ YY!^ 1 A >""$ >> !%77 Q\\RDN~~r1r)r N)#__name__ __module__ __qualname____doc__rr>r,r rrFboolrHpropertyr.rOrQrintr-rXr]r`rcreperf compute_oncerhrnrqr_rmrwr|r~ __classcell__)r0s@rr r "s?HSM?T?0 c 4 + T # #uS#X 5#544 +D++   d    d   !4  * r1r ) rrtypingrrrnumpyr? scipy.sparsesparserLcvxpy.interface interfacercvxpy.lin_ops.lin_utilslin_ops lin_utilsrUcvxpy.settingssettingsrAcvxpy.utilities.linalg utilitieslinalgrycvxpy.expressions.leafrcvxpy.utilitiesrrrr r7r1rrsJ (($$))'5Rdtdr1