+ =ix^RIHt^RIHt^RIHt^RIHtHtH t ^RI t ^RI H t H t RHRlt/tRR R R R R RRR^ RRRRRRRRR^/ t/^RR.b^RR.b^RR.b^RR.b^ R R!.b^ R"R#.b^R$R%.b^R&R'.b^R R .bRIR(R).bRJR*R+.bRKR,R-.bRLR.R/.bRMR0R1.bRNR2R3.bROR4R5.bRPR6R7.bt^R8R9.^R:R;.RQRR?./t!R@RA4tRBtRCtRDtREtRFtRGtR#)S)Decimal)deepcopy) SortedDict)warnfilterwarnings resetwarningsN) currentframegetfilec^p\4pVe\V4\8wdV#VPpV^, pK2 Tu#;i)anHelper function to associate warnings with caller outside this module. Args: best_guess: stack depth estimate in case the Python interpreter doesn't support stack introspection. Returns: integer stack level for warnings.warn() function. Note: - Python 3.12 should simplify this process with 'skip_file_prefixes' once the path normalization bugs are fixed. )r r __file__f_back) best_guess stacklevelframes& p/Users/tonyclaw/.openclaw/workspace/scripts/youtube-playlists/venv/lib/python3.14/site-packages/sigfig/sigfig.py_warn_stacklevelr sMJ}( :!!LLE !OJs$AAAspacing皙?spacerdecimal. separator ± cutoffprefixFexponentEround_by_sigfigsround_by_decimalsT given_sigfigsY septillionZ sextillion quintillionP quadrillionTtrillionGbillionMmillionkthousandm thousandthuμ millionthn billionthp trillionthf quadrilliontha quintillionthz sextillionthy septillionthhhundreddatendtenthc hundredthcxa]tRt^FtoRtRtRRltRtRtRt Rt RR lt ] R 4t R tR tR tRtVtR#)_Numbera+ Private data structure for storing & manipulating numbers Attributes: .map: - dict for number storage - maps 10's power (key) to numeric value (value) - i.e. 3.14 => .map = {0:3, -1: 1, -2: 4} Attributes/Mehtods for inspection (getting values): .sign: string of either '+' or '-', denoting sign of stored number .nan: bool True/False depending on whether number is NaN .positive: bool True/False depending on number's sign .negative: bool True/False depending on number's sign .has_uncertainty: bool True/False depending on whether there is an associated uncertainty with this number .max_power(): returns integer corresponding to number's highest populated 10's power .min_power(): returns integer corresponding to number's lowest populated 10's power .decimate(dict, _Number, bool, bool): returns string of all digits in given format specifying spacing and non-standard decimal point, optional sign optionally embedded uncertainty, and optional leading/trailing zeros .output(type): returns number in given type Methods for manipulation (changing the value): .set_sign(str): function used to change/set the number's sign by passing '-' or '+' so that .positive, .negative, .sign don't need manual updating .increment_power_by(int): (de)increments all keys in .map by given value .round_by_decimals(int): performs rounding operation to the given 10's power .prefixify(str): converts to Scientific or Engineering notation with optional SI prefix c~VPR4RVnRVn\4VnRVnRVnR#)+rFN)set_signrhas_uncertaintyrmapzeronanselfs&r__init___Number.__init__as4 c $< c VR8XdRVnRVnRVnR#VR8XdRVnRVnRVnR#\R\ ^4R7RVnRVnVP R4R#)zsets the number's signrKFT-z*sign must be "+" or "-", assuming positiverN)negativepositivesignrrrL)rRr[s&&rrL_Number.set_signhsf 3;!DM DMDI S[ DM!DMDI =JZ[\J] ^!DM DM MM# rUc ,\VP4#)zFreturns integer corresponding to number's highest populated 10's power)maxrNrQs&r max_power_Number.max_powerw488}rUc ,\VP4#)zEreturns integer corresponding to number's lowest populated 10's power)minrNrQs&r min_power_Number.min_powerzrarUc \4pVPFpVPV,W#V,&K! W nR#)z(de)increments all keys in .mapN)rrN)rRr4tmpkeys&& rincrement_power_by_Number.increment_power_by}s/l88C88C=CaLrUc V)p\VP4^/4p\V^/4pVP4p\VP4\V)^, R4R4FDpWR8dV^8gWPP9d\ ^4K-TpVPV,W5&KF W P4^,8XdRVPVP4,^8d^W2&MRVn\V^/4pVPR4MW P48d'RVn\V^/4pVPR4MV^, VP9drVPV^, ,^8dSW4;;,^, uu&TpW6,^ 8Xd0^W6&V^, pWc9d^W6&K&W6;;,^, uu&K<W0nR#)z3performs rounding operation to the given 10's powerTrKN)rr_rangercrNfloatrOrL)rRdecimals last_powertmp_maplast_tmp_powerrh tmp_powers&& rr _Number.round_by_decimalssY dnn.23j!_-))3y1}b+A2FCC1H880Ca "%#xx} G )A- -xx()Q.&'#  $j^4 c" ..* *DI *Q0G MM#  a 488 +!9K0LPQ0Q  #q ( #&I$*%&"Q +)*G&&!+& =rUNc  VVP4pVP4pV'd\V^4p\V^4pVP'dV'g V^8d^p.pV'd$VP 'dVP R4\Wg^, R 4Fp VP \VPV ,44YP48Xd:T'd2TP RTPTRRR7,R,4Y8wgKT ^8XdTP TR,4KYR,,^8XgKTP TR ,4K R PV4V,# TP R4L;i) z returns string of all digits in given format {spacing, spacer, decimal}, with unc=_Number for embedded uncertainty, and optional leading/trailing zeros & sign rW0(F zeropaddingr[)rrrrrl) r_rdr^rcrOrYappendrmstrrNdecimatejoin) rRformatuncryr[unitstopbotoutputr6s &&&&&& rr}_Number.decimates7 nnnn c1+Cc1+C 999SS1WC DMMM MM# s!GR(A # c$((1+./NN$$ c#,,v5u,"UUVYYZx6MM&"34 **a/MM&"23)wwv&& # c"s (+FF(c*\\V44#)N)intrn)nums&r_int _Number._ints5:rUc RRRRRR/pVPVRR7;'gRpV\8Xd VPMTpV!V R VP4 24#) zreturns number in given typerrrrrF)ryrvr)r}rrrd)rR output_type no_formattingrs&& rr_Number.outputs^"B"iE mmMum=DD#.##5dii; cU!DNN$4#5677rUcVP4VP48dR#\VP4VP4^, R4FpW!P9dVPV,'gK.R#VPV,VPV,8dR#VPV,VPV,8gKR# VP4VP48dR#R#)TFrl)r_rmrdrN)rRotherr6s&& r__gt___Number.__gt__s >> eoo/ /t~~')9A)=rBA !xx{{xx{UYYq\)xx{UYYq\)C ?? t~~/ /rUc RVn^pVR8XdEVP4pV\V4,VnVPV)4W4), pV#VR8Xd|^pVP4^8d^p\ VP4V, ^, 4^,pV\V4,VnVPV)4W4), pV#VR9dP\ \ \,4pVP4pV\V48dWF9dEMuV^,pK#EMh\ pVP4pV\V4^,8dsV;PV\V4,^,, unVP\V4)4V\V4), pV\V4,pKV\V48dsV;PV\V4,^,, unVP\V4)4V\V4), pV\V4,pK^pVP4^8d^p\ VP4V, ^, 4^,pWd,^,VP,VnVPV)4W4), pV#)zCconverts to Engineering/Scientific notation with optional SI prefixrscieng)allminor) rr_r|rirr_major_prefixes_minor_prefixesrdrcr^)rRrr power_shiftr6p0prefixess&&& r prefixify_Number.prefixifysC  U? A"SV+DK  # #QB ' 2 K  u_B~~!#T^^%*A-.q0A"SV+DK  # #QB ' 2 K  ' '!//"ABH As8}$=Q% 'H Ac(mAo% xH 6q99 ''X7H ~- S]"c(m# xH 6q99 ''X7H ~- S]"B~~!#T^^%*A-.q0Ak!nt{{2  #r rU)rMrNrPrYrZrr[rO)rK)NTTr)__name__ __module__ __qualname____firstlineno____doc__rSrLr_rdrir r} staticmethodrrrr__static_attributes____classdictcell__) __classdict__s@rrIrIFsV4 -=\'88 22rUrIcXRR/p\RFUu.uFq3V9NK up4'dVPR4;'g+VPR4;'gVPR4pV'g \R4M6VR8Xd \4M$\4\ RV R 2\ ^4R 7RVR&\ P\\\\R 43p\V^,4VR &\V^,V4'g"\R \V^,4 RV 24h\V^,4VR&\V4^8d\V^,4\ 8Xd7V^,VR&VR,^8d\ R\ ^4R 7^VR&MUV^,V^,8wd#\ RV^, R2\ ^4R 7M\V^,4VR&\VR &\V4^8d4\ R\!\V4^, 4 R2\ ^4R 7\"Fp\"V,W&&K 0RGmpVEFpW,pWg9d\ R"V R#V 2\ ^4R 7K0Wb9d V\"9dVRH9dRRRR/p Wi9d W,MTpVR!8XdRp\V\ P$4'g\ R$V R%2\ ^4R 7VRI9d)\!V4^ 8d\ R&\ ^4R 7^ pVR8Xd)\!V4^8d\ R\ ^4R 7^p\!V4W&&EKVRJ9d$W8XgQh\V4VR&\VR &EK;VR 8Xd`\V4\&8XgVRK9dWV&M3VRL9dR-VR &M&0RMmp \ R'V R#V R.V 2\ ^4R 7EK\VR &EKVRN9d\V4W&&\VR &EKVR8Xd\!V4VR&\VR &EKVRO9dVR/8XdR0VR&RVR/&EKVR08XdR0VR&MvV\(\*09dWR&\V^,4VR &MKVR18Xd \(VR&\V^,4VR &M%VR28Xd\*VR&\V^,4VR &\V4VR&EKVRP9Edx\VR &.RQOp R3.RROR6.RSOR7.RTOR8.RUOR9.RVOR+.RWOR,.RXOR:.RYO/p R;R<0p 0RZmpW9dFVR=,pVR>8XdR:p\-V 4F!wppVV9dKW,V,VV&K# EKW9d>\-V 4F+wppVV9d V\"9dW,V,VV&K- EK^\V\4'd&\/W4'dWR &R V9dVR EKEKW9dVR;8Xd R5VR&EKWR&EK\ R?V Uu.uFpVNK upV Uu.uFpVNK up, R@V 2\ ^4R 7\V^,4VR &EKWV&EK RV9d!RV9d\ RA\ ^4R 7VRRV9dP\R[Uu.uFpVV9NK up4'd,\ RC\ ^4R 7R[FpVV9gK VVK RBV9dURV9gRV9d\ RD\ ^4R 7M,\0RE,'dVRB,VR&M VRB,VR&VRB\/VR ,\ P2\\34'gz/VR&RV9d RV9d^VR&RV9d RV9dR4VR&R\FHpVV9dVV,pVVM&V\"9d\"V,pM \0V,pWR,V&KJ R]F9pVV9dK V\"9d\"V,VV&K)\0V,VV&K; V#uupi \ R'T R#T R(\T4 R)2\ ^4R 7EK;i \ R'T R#T R*2\ ^4R 7EK7;iuupiuupiuupi)^zPrivate function for use only in round() function: Deciphers user intent based on given inputs along with preset defaults which returns actionable and summarized useful variables in a dict. reset_warningsFrwarningwarningsignoreTz>warnings argument expected to be True, False, or "once". Got ""rXNrzInvalid input type of z, expecting 1 of rsigfigsz8cannot have less that 1 significant figure, setting to 1zIgnoring 2nd argument "z(". invalid uncertainty, expecting number uncertaintyzlast z argument(s) discarded/ignoredrrsrorDrrrrrcropz unrecognized argument, skipping =zuse integer type for z argumentz'cutoff/crop cannot be < 9, setting to 9z Ignoring z, invalid type of z, expecting integer typez'. invalid uncertainty, expecting numberrrrz*, invalid prefix setting, expecting 1 of: external_bracketsbracketstuplelistEnglish,rFrenchrPDGDrakestd+-rN:NNstazexpected format of z, ignoring format of zDCannot round by both sigfigs & decimals, ignoring decimal constraintarg2zCannot round by both uncertainty & decimals/sigfigs simultaneously, ignoring decimals &/or sigfigs. Use seperate calls to round() function for seperate roundings.zRInvalid 2nd argument, ignoring. "sigfigs" or "decimals" given in keyword argumentsr)rrr>rDruseprformtypestylerrrrrrrrrornotationr separationrr>rDrrrrro>rr>rr>rrmajor)rr>FTrrrrr>rr>rrr)rrrrrrr)rrrrrrr)rrrr Fu#,###,###.## ± 0.#)r rrcFu# ### ###,## ± 0,##)rrrrrFu#.###.###,## ± 0,##)rrrr#F# ### ###.##(##))rrrrFr)rrrrrrr)rrrrrrr)rrrrrFr>rrrstandard scientific engineering)rror>rrr)rrr)anygetrrrrnumbersNumberr|rrIr isinstance TypeError _num_parselenr_manual_settingsIntegralboolrr enumerate issubclass_default_settingsReal)argskwargsgivenwrtypesrhkeysval shortcutsr propertiesformatsoutputs notationsipropr8oxs&& r_arguments_parsers u %E !@ A!@AK!@ ABB**V$WW 9(=WWJAW 8 $ _ O O QRYQZZ[\iyz{i| }"& ^^S'7DJ ?EQ=E- d1gu % %0d1g?PQVPWXYYd1g&E%L 4yA~ Q=C #AwE) Y!#O\lmn\op#$i !WQ  *47)3[\iyz{i| }#-d1g#6E- #&E-  4y1} uSTQ'((F GTdefTgh%c*   sDk ? 3C5#?L\]^L_ `  .As QcUl 8EUVWEX YFJJqMFK Vy 8EUVWEX YFJJqMFK c"gJ Vt^ OOCF # c"gJ Vs] c"gJ Vv  FA Q[FJJrN c"gJHQP\]^\__ijk krUc*<\^, sV'g\P\4R#V^,S9d+\P\4S!VR,4R#V^,R9d-\P\4^sS!VR,4R#V^,S9dG\^, s\ V^,4\P \)&S!VR,4R#\ RV^, R\ R24h)rNrr#parsing failed: invalid Character "rz , state B))rrrir4rrNrrs&rr_num_parse..Bs Q  % %a ( Vy  % %a ( c"gJ Vs]  % %a (A c"gJ Vv  FA Q[FJJrN c"gJB3q6(,WXVYYcde erUcR<\^, sV'gR#V^,S9dS!VR,4R#V^,S9dG\^, s\V^,4\P\)&S!VR,4R#\ RV^, R\ R24h)rNrrrz , state C))rr4rrrNr)rrrrrs&rr_num_parse..C)s Q Vy c"gJ Vv  FA Q[FJJrN c"gJB3q6(,WXVYYcde erUc<\^, sV'g\R\^4R7R#V^,R9dIV^,R8XdRsVR,'g\R\^4R7^sS!VR,4R#V^,S9d$\ V^,4sS!VR,4R#\ RV^, R \ R 24h) rz"exponent expected but not providedrXNrrWTrinvalid Character "rz , state D))rrr negative_expexprr)rrrs&rr_num_parse..D6s Q 5BRSTBU V Vt^1v}# r779FVWXFYZC c"gJ Vv c!f+C c"gJ23q6(,qcTU UrUcR<\^, sV'g3^p\'dRp\PV\,4R#V^,S9d6^ \,\ V^,4,sS!VR,4R#\ RV^, R\ R24h)rNrr rz , state E)rl)rr rrir rr)rr[rrs& rr_num_parse..EIs QD|  % %d3h / Vv S&3s1v;&C c"gJ23q6(,qcTU UrU)rerrDQq)rIrrr4r r rrrrrNrOrPr|setrmr_) rr:rr6rrrrrrs & @@@@@@rrrsdYF A AL C CyDL } { 4AQRSATU 1    z 01  5 c(C %),)Q#a&), -F23Ill0ff& f fV& VcFA vzz/fjjmq0 JJqM Q ::: 1  MQ-sGc  V'g\R\^4R7R#\W4pVR,pVP'dVPR,#RV9dVP VR,4EMRV9dVR,\ VP48d7\VR, R\ VP4 R 2\^4R7VP4VR,, ^,pVP V)4\ VP4VR,8dVPVP4K>EMDR V9Ed=R Vn R V9d\VR ,4pM8R \9d\\R ,4pM\\R ,4p\VR ,\ V4R R7p\VR,\VP44,4pWg8dp\VR ,\ V4^, R R7pVPVP4,^8Xd%^VPVP4^, &VP VP4)4VR,'d9VPVR,VR,4pR V9dXP!V4VR,'d \#4\%VR,\&P(\*34'dRV9dVR,\,\.09dkR V9d'VR,!VP1VR,4.4#VR,!VP1VR,4XP1VR,4.4#VP1VR,4#RV9dVR,R 8XdV#R V9dEVR,R8Xd7XP4^8d"RV9dVP3VR,VR7#VP3VR,4p VR,'d VP4MRp RV9dfVR,\.\,09dNR V9d1VR,!W,XP3VR,RV R7.4#VR,!W,.4#R V9EdVR,R8XdMXP4^8d8V RVP3VR,RR7,R,, p W,#VR,R8Xd9V RXP3VR,RRR 7,R,, p W,#VR,'d!VR,R!9dWP4, p WR,XP3VR,RR7,, p VR,R 8XdV 'dRV R2p W,#)"u round a given number to either - a given number of significant figures/significant digits, - a given number of decimals, or - a given uncertainty and optionally output the number with given formatting along with its uncertainty Key usage examples: round('2.675', sigfigs=2) => '2.7' round(2.675, decimals=2) => 2.68 round('2.675', '0.00197') => '2.675 ± 0.002' round('123456.789099', '-1.15E-4', output='Drake') => '123 456.789 10(12) For detailed usage instructions see https://pypi.org/project/sigfig/ z(no input number given, nothing to returnrXNrrrorz5 significant figures requested from number with only z significant figuresrTrrN)rrrrrrrrrrrr)rrF)r[rrw)r[rzrx>Trrr)rrrrPrNr rr_rdrMr|rrroundrrrirrrrrrrrr}r) rrrrrprrcutrrrs *, rrres  7DTUVDWX T *E ,C wwwwwu~U eJ/0 e   c#''l * #$$YZ]^a^e^eZfYgg{|+A. ]]_uY'77!;  zk*#''lU9-- (. % " u x)F ) ))(34F*845FE-(#f+eL#CMMO(<<= 9m,c&k!mERCwws}}'1,/0 !+, s}}./ XmmE(OU:5FG E !  " "; / % &(ABB u xUDM!AE)X 53G(H'IJJ?CJJu]/C$D$'JJu]/C$D$FG Gzz% .// U uX%7 % "4 "Bs}}YZGZ_rz_||E(O|55 \\%/ *F//CJJrE5U8_u = E !?FNCLLxW\diL4j#kl lX/00   + !0C c#,,uXU,CCCG GF >; : - c#,,uXEPU,VVWZZ ZF > X5?:Y#Y**$ K(3<<he<+TT TFX$&5VHA >rUc \R\\^4R7RRR^RRR\/pTpR V9d$VR ,R 8XdR VR&M VR ,VR&VR R V9dVR ;;,^,uu&VF pW,W4&K \ V/VB#) :Depreciated version of round() function with limited scope?Depreciated Usage: Migrate code to use round() function insteadrXrrrrrrr plusminus +/- r)rDeprecationWarningrr|r)rrdefaultsfinal_parametersrhs*, rrounditrs JL^k{|}k~#y![*mVYZH  &>[ (")F; "(.F;  6N v! &  $ +* ++rUcD\R\\^4R7R\/pTpRV9dVR,R8Xd RVR&VRRV9dVR;;,^,uu&VF pW,W4&K \ VUu.uFp\ V4NK up/VB^,#uupi) rrrXrrrrrr)rrrrrr|)rrrrrhargs*, r round_uncr!s JL^k{|}k~u~H F6Nk9%{ 6N v! &  t,t3s8t, A0@ A! DD,s;Bcd\R\\^4R7\\ V4VR7#)rrrX)r)rrrrr|)rrs&&rround_sfr#s( JL^k{|}k~ VW --rU)iiiiiiirl)rrcopyrsortedcontainersrrrrrrinspectr r rrrrrrIrrrrr!r#rUrr+s'88), s b s a eQ  l l m m  j  Y  Y Z 2w l { k #|  #  #  #~ ! "#~ # &Ye}gk  QQfADHT\|, E.rU