HR-e0:ddlZddlmZddlmZmZdgZGddZe ddZ e ddZ e d d Z e d d Z dS) N)deprecated_attributedeprecated_renamed_argument Parameterc.eZdZdZiZedddddgdddd d Zd Zed Z ed Z edZ e ddZ edZddZdZedZdZdZeddZddZdZdZdZdS)raCosmological parameter (descriptor). Should only be used with a :class:`~astropy.cosmology.Cosmology` subclass. Parameters ---------- derived : bool (optional, keyword-only) Whether the Parameter is 'derived', default `False`. Derived parameters behave similarly to normal parameters, but are not sorted by the |Cosmology| signature (probably not there) and are not included in all methods. For reference, see ``Ode0`` in ``FlatFLRWMixin``, which removes :math:`\Omega_{de,0}`` as an independent parameter (:math:`\Omega_{de,0} \equiv 1 - \Omega_{tot}`). unit : unit-like or None (optional, keyword-only) The `~astropy.units.Unit` for the Parameter. If None (default) no unit as assumed. equivalencies : `~astropy.units.Equivalency` or sequence thereof Unit equivalencies for this Parameter. fvalidate : callable[[object, object, Any], Any] or str (optional, keyword-only) Function to validate the Parameter value from instances of the cosmology class. If "default", uses default validator to assign units (with equivalencies), if Parameter has units. For other valid string options, see ``Parameter._registry_validators``. 'fvalidate' can also be set through a decorator with :meth:`~astropy.cosmology.Parameter.validator`. fmt : str (optional, keyword-only) `format` specification, used when making string representation of the containing Cosmology. See https://docs.python.org/3/library/string.html#formatspec .. deprecated:: 5.1 doc : str or None (optional, keyword-only) Parameter description. Examples -------- For worked examples see :class:`~astropy.cosmology.FLRW`. fmtNz5.1)sinceFdefault)derivedunit equivalencies fvalidaterdoccdx|_|_||_t||_||_|t j|nd|_||_ ||_ t|rn~||j vr|j |}ngt|tr)td|j t!d|j ||_dS)Nz `fvalidate`, if str, must be in z"`fvalidate` must be a function or ) _attr_name_attr_name_private_derivedstr _format_spec__doc__uUnit_unit_equivalencies _fvalidate_incallable_registry_validators isinstance ValueErrorkeys TypeError _fvalidate)selfr r r rrrs ;lib/python3.11/site-packages/astropy/cosmology/parameter.py__init__zParameter.__init__6s598$1 HH &*%5QVD\\\4 +' I     $3 3 31)> 5* % % ( NNN ' ' '  42E:::::r&c|jS)z9Function to validate a potential value of this Parameter.)r"r-s r$rzParameter.fvalidater.r&c.||S)aoMake new Parameter with custom ``fvalidate``. Note: ``Parameter.fvalidator`` must be the top-most descriptor decorator. Parameters ---------- fvalidate : callable[[type, type, Any], Any] Returns ------- `~astropy.cosmology.Parameter` Copy of this Parameter but with custom ``fvalidate``. r)clone)r#rs r$ validatorzParameter.validatorszzIz...r&c0||||S)afRun the validator on this Parameter. Parameters ---------- cosmology : `~astropy.cosmology.Cosmology` instance value : Any The object to validate. Returns ------- Any The output of calling ``fvalidate(cosmology, self, value)`` (yes, that parameter order). rFrAs r$r=zParameter.validates~~iu555r&cjjvrtdd| |j<|Sfd}|S)aDecorator to register a new kind of validator function. Parameters ---------- key : str fvalidate : callable[[object, object, Any], Any] or None, optional Value validation function. Returns ------- ``validator`` or callable[``validator``] if validator is None returns a function that takes and registers a validator. This allows ``register_validator`` to be used as a decorator. z validator z# already registered with Parameter.Nc|j<|S)zRegister validator function. Parameters ---------- fvalidate : callable[[object, object, Any], Any] Validation function. Returns ------- ``validator`` )r)rclskeys r$registerz.Parameter.register_validator..registers-6C $S ) r&)rKeyError)rLrMrrNs`` r$register_validatorzParameter.register_validatorsn" #* * *RRRRSS S  ,5C $S )       r&c||j|j|j|r|jn|j|jd}|jr |j|d<|S)aInitialization arguments. Parameters ---------- processed : bool Whether to more closely reproduce the input arguments (`False`, default) or the processed arguments (`True`). The former is better for string representations and round-tripping with ``eval(repr())``. Returns ------- dict[str, Any] )r r r rrr)r r r rrrr)r# processedkws r$_get_init_argumentszParameter._get_init_argumentssV |I!/,5L$:L<     *)BuI r&c i||}t|di|}|j|_|j|_|S)adClone this `Parameter`, changing any constructor argument. Parameters ---------- **kw Passed to constructor. The current values, eg. ``fvalidate`` are used as the default values, so an empty ``**kw`` is an exact copy. Examples -------- >>> p = Parameter() >>> p Parameter(derived=False, unit=None, equivalencies=[], fvalidate='default', doc=None) >>> p.clone(unit="km") Parameter(derived=False, unit=Unit("km"), equivalencies=[], fvalidate='default', doc=None) )rTtyperr)r#rSkwargscloneds r$rGzParameter.clonesV*6D,,..5"5d%%f%%!O$($;! r&ct|tstS|d|dko|j|jkS)aCheck Parameter equality. Only equal to other Parameter objects. Returns ------- NotImplemented or True `True` if equal, `NotImplemented` otherwise. This allows `other` to be check for equality with ``other.__eq__``. Examples -------- >>> p1, p2 = Parameter(unit="km"), Parameter(unit="km") >>> p1 == p2 True >>> p3 = Parameter(unit="km / s") >>> p3 == p1 False >>> p1 != 2 True T)rrNotImplementedrTr*)r#others r$__eq__zParameter.__eq__&sX,%++ "! !((..%2K2KD2Q2QQ I # r&cddd|DS)zString representation. ``eval(repr())`` should work, depending if contents like ``fvalidate`` can be similarly round-tripped. z Parameter({})z, c3*K|]\}}|d|VdS)=NrV).0kvs r$ z%Parameter.__repr__..Ls0RRtq!llQllRRRRRRr&)formatjoinrTitemsr-s r$__repr__zParameter.__repr__EsR %% IIRRt/G/G/I/I/O/O/Q/QRRR R R   r&r4)F)__name__ __module__ __qualname__rrrr%r+propertyr*r r rr1r r7rCrrHr= classmethodrPrTrGr]rhrVr&r$rr s&&P  E:::   %$%$%$%$;:%$N--- XX##X#'&}EBBBK X;;;;;;;&X/// 666"((([(X<>   >     r&r c|jKtj|j5tj||j}dddn #1swxYwY|S)z] Default Parameter value validator. Adds/converts units if Parameter has a unit. N)r radd_enabled_equivalenciesr Quantityr6paramrBs r$_validate_with_unitrsTs  z  ()< = = 2 2Juej11E 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 LsAA A floatcBt|||}t|S)z=Parameter value validator with units, and converted to float.)rsrtrqs r$_validate_to_floatrv`s! 5% 8 8E <<r&scalarcdt|||}|jst|jd|S)r z is a non-scalar quantity)rsisscalarrr*rqs r$_validate_to_scalarrzgs> 5% 8 8E >CEJAAABBB Lr&z non-negativecbt|||}|dkrt|jd|S)z:Parameter value validator where value is a positive float.gz cannot be negative.)rvrr*rqs r$_validate_non_negativer|ps< y% 7 7E s{{EJ<<<=== Lr&)r> astropy.unitsunitsrastropy.utils.decoratorsrr__all__rrPrsrvrzr|rVr&r$rs$ VVVVVVVV -B B B B B B B B R  i(()( g&&'&  h''(' n--.-r&