B d!@sddlZddlZddlZddlZddlmZmZddlm Z ddl m Z ddl m Z ddgZGdd d eZGd dde ed ZGd ddeZdS) N)Unit UnitsError)Quantity) lazyproperty)AstropyUserWarningConstant EMConstantcs eZdZdZfddZZS) ConstantMetaaIMetaclass for `~astropy.constants.Constant`. The primary purpose of this is to wrap the double-underscore methods of `~astropy.units.Quantity` which is the superclass of `~astropy.constants.Constant`. In particular this wraps the operator overloads such as `__add__` to prevent their use with constants such as ``e`` from being used in expressions without specifying a system. The wrapper checks to see if the constant is listed (by name) in ``Constant._has_incompatible_units``, a set of those constants that are defined in different systems of units are physically incompatible. It also performs this check on each `Constant` if it hasn't already been performed (the check is deferred until the `Constant` is actually used in an expression to speed up import times, among other reasons). csdd}tddddddd d d d d ddddg}xLttD]<\}}t|tjr<|dr<|dr<||kr<||||<q0szGConstantMeta.__new__..wrap..wrapper..zConstant {!r} does not have physically compatible units across all systems of units and cannot be combined with other values without specifying a system (eg. {}.{})r)namelower _registry_checked_unitsvaluesunittor_has_incompatible_unitsaddsystemsorted TypeErrorformatabbrev)selfargskwargs name_lower instancesinstZsystems)methr r wrapper"s"    z3ConstantMeta.__new__..wrap..wrapper) functoolswraps)r#r$r )r#r wrap!sz"ConstantMeta.__new__..wrap__new____array_finalize__Z__array_wrap____dir__ __getattr____init____str____repr____hash____iter__ __getitem____len____bool____quantity_subclass__ __setstate____) setvarsritems isinstancetypes FunctionType startswithendswithsuperr()mclsrbasesdr'excludeattrvalue) __class__r r r( s zConstantMeta.__new__)__name__ __module__ __qualname____doc__r( __classcell__r r )rFr r sr cseZdZdZiZeZd!ddZddZddZ fd d Z d d Z e Z Z ed dZeddZeddZeddZeddZeddZfddZeddZeddZdd ZZS)"rzA physical or astronomical constant. These objects are quantities that are meant to represent physical constants. Nc Cs|dkr*t|dd}|dkr*t|d|}|j|i} t||} || krnt d |||t xV| D]J} |dk rt | j|st| || | jdk rxt | j| jsxt| | j| qxW| | |<|| _|| _|| _|| _|| _|| _|| _d| _| S)NZdefault_referencez requires a reference.zMConstant {!r} already has a definition in the {!r} system from {!r} referenceF)getattrrrr setdefaultnparrayviewwarningswarnrrrhasattrrFsetattrr_abbrev_name_value _unit_string _uncertainty _reference_systemr) clsrrrEr uncertainty referencerr r!r"cr r r r(Us2  zConstant.__new__cCs$d|j|j|j|jt|j|jS)Nz?<{} name={!r} value={} uncertainty={} unit={!r} reference={!r}>)rrFrrEr]strrr^)rr r r r.xs  zConstant.__repr__cCsd|j|j|j|j|jS)NzM Name = {} Value = {} Uncertainty = {} Unit = {} Reference = {})rrrEr]rr^)rr r r r-~szConstant.__str__cst|ddfS)NrF)r?r4)rr)rFr r r4szConstant.__quantity_subclass__cCs|S)z Return a copy of this `Constant` instance. Since they are by definition immutable, this merely returns another reference to ``self``. r )rr r r copysz Constant.copycCs|jS)zA typical ASCII text abbreviation of the constant, also generally the same as the Python variable used for this constant. )rU)rr r r rszConstant.abbrevcCs|jS)zThe full name of the constant.)rV)rr r r rsz Constant.namecCs t|jS)z.The unit(s) in which this constant is defined.)rrX)rr r r _unitszConstant._unitcCs|jS)z8The known absolute uncertainty in this constant's value.)rY)rr r r r]szConstant.uncertaintycCs|jS)z/The source used for the value of this constant.)rZ)rr r r r^szConstant.referencecCs|jS)zThe system of units in which this constant is defined (typically `None` so long as the constant's units can be directly converted between systems). )r[)rr r r rszConstant.systemcs6|j|j}||}|dk r&|Stt|SdS)N)rrrgetrLr?)rkeyr!r")rFr r _instance_or_supers  zConstant._instance_or_supercCs |dS)zIf the Constant is defined in the SI system return that instance of the constant, else convert to a Quantity in the appropriate SI units. si)re)rr r r rfsz Constant.sicCs |dS)zIf the Constant is defined in the CGS system return that instance of the constant, else convert to a Quantity in the appropriate CGS units. cgs)re)rr r r rgsz Constant.cgscCs4x dD]}t||t||dqWt|dd|_dS)N)rUrVrWrXrYrZr[rF)rTrLr)robjrDr r r r)s zConstant.__array_finalize__)NN)rGrHrIrJrr7rr(r.r-r4ra __deepcopy____copy__propertyrrrrbr]r^rrerfrgr)rKr r )rFr rLs& "         ) metaclassc@seZdZdZeddZdS)rzAn electromagnetic constant.cCs tddS)z{Overridden for EMConstant to raise a `TypeError` emphasizing that there are multiple EM extensions to CGS. zCannot convert EM constants to cgs because there are different systems for E.M constants within the c.g.s system (ESU, Gaussian, etc.). Instead, directly use the constant with the appropriate suffix (e.g. e.esu, e.gauss, etc.).N)r)rr r r rgszEMConstant.cgsN)rGrHrIrJrkrgr r r r rs)r%r;rQnumpyrNZastropy.units.corerrZastropy.units.quantityrZ astropy.utilsrZastropy.utils.exceptionsr__all__typer rrr r r r s   <