o *ήcL#@sxdZddlmZddlmZddlmZddlmZddl m Z ddl m Z m Z mZGdd d eZGd d d eZd S) z Physical quantities. ) AtomicExpr)Symbol)sympify)_QuantityMapper)Prefix)sympy_deprecation_warningSymPyDeprecationWarningignore_warningsc@seZdZdZdZdZdZdZdZdZ    d,ddZ d-dd Z d-d d Z d d Z ddZeddZeddZeddZeddZddZddZddZddZed-d d!Zed-d"d#Zd$d%Zd-d&d'Zed(d)Zed*d+ZdS).QuantityzX Physical quantity: can be a unit of measure, a constant or a generic quantity. TFNc Ks:t|ts t|}t|tst|ts|||}}}|dur&tdddd|dur1tdddd|dur8|}n t|trAt|}| |_t|||} || _|| _|| _ || _ || _ || _ | | _|dur}t t | |Wdn1sxwY|durt t| |Wd| S1swY| S)Nz The 'dimension' argument to to Quantity() is deprecated. Instead use the unit_system.set_quantity_dimension() method. z1.3z*deprecated-quantity-dimension-scale-factordeprecated_since_versionactive_deprecations_targetz The 'scale_factor' argument to to Quantity() is deprecated. Instead use the unit_system.set_quantity_scale_factors() method. ) isinstancerstrr _is_prefixedr__new___name_abbrev _latex_repr _unicode_repr _ascii_repr _mathml_reprr r set_dimensionset_scale_factor) clsnameabbrev dimension scale_factor latex_reprpretty_unicode_reprpretty_ascii_reprmathml_presentation_repr is_prefixed assumptionsobjr&E/tmp/pip-target-vg8gfxp4/lib/python/sympy/physics/units/quantities.pyrsT          zQuantity.__new__SIcC<td|ddddddlm}||}|||dS)Nz Quantity.set_dimension() is deprecated. Use either unit_system.set_quantity_dimension() or z-.set_global_dimension() instead. 1.5deprecated-quantity-methodsr r UnitSystem)rsympy.physics.unitsr-get_unit_systemset_quantity_dimension)selfr unit_systemr-r&r&r'r\ zQuantity.set_dimensioncCr))Nz Quantity.set_scale_factor() is deprecated. Use either unit_system.set_quantity_scale_factors() or z9.set_global_relative_scale_factor() instead. r*r+r rr,)rr.r-r/set_quantity_scale_factor)r1rr2r-r&r&r'rjr3zQuantity.set_scale_factorcCs|tj|<dSN)r_quantity_dimension_global)r1rr&r&r'set_global_dimensionxszQuantity.set_global_dimensioncCs\ddlm}t|}t|trd|_|dddd}t|}||f|j|<||j|<dS)zN Setting a scale factor that is valid across all unit system. rr,TcSs t|tSr5)rrxr&r&r's z;Quantity.set_global_relative_scale_factor..cS|jSr5)rr8r&r&r'r:sN) r.r-rrrrreplace_quantity_scale_factors_global,_quantity_dimensional_equivalence_map_global)r1rreference_quantityr-r&r&r' set_global_relative_scale_factor{s  z)Quantity.set_global_relative_scale_factorcCr;r5)rr1r&r&r'rsz Quantity.namecCddlm}|}||S)Nrr,)r.r-get_default_unit_systemget_quantity_dimensionr1r-r2r&r&r'rs  zQuantity.dimensioncCr;)z Symbol representing the unit name. Prepend the abbreviation with the prefix symbol if it is defines. )rrAr&r&r'rszQuantity.abbrevcCrB)zW Overall magnitude of the quantity as compared to the canonical units. rr,)r.r-rCget_quantity_scale_factorrEr&r&r'rs  zQuantity.scale_factorcCdSNTr&rAr&r&r'_eval_is_positivezQuantity._eval_is_positivecCrGrHr&rAr&r&r'_eval_is_constantrJzQuantity._eval_is_constantcCs|Sr5r&rAr&r&r' _eval_AbsrJzQuantity._eval_AbscCst|tr ||kr |SdSdSr5)rr )r1oldnewr&r&r' _eval_subsszQuantity._eval_subscC.tddddddlm}||}||S)Na Quantity.get_dimensional_expr() is deprecated. It is now associated with UnitSystem objects. The dimensional relations depend on the unit system used. Use unit_system.get_dimensional_expr() instead. r*r+r rr,)rr.r-r/get_dimensional_exprexprr2r-r&r&r'rQs  zQuantity.get_dimensional_exprcCrP)zCReturn tuple with scale factor expression and dimension expression.z Quantity._collect_factor_and_dimension() is deprecated. This method has been moved to the UnitSystem class. Use unit_system._collect_factor_and_dimension(expr) instead. r*r+r rr,)rr.r-r/_collect_factor_and_dimensionrRr&r&r'rTs  z&Quantity._collect_factor_and_dimensioncCs6|jr|jSdt|jdkr|jdS|jdS)Nz \text{{{}}}r)rformatlenargs)r1printerr&r&r'_latexs zQuantity._latexcCsddlm}||||S)a Convert the quantity to another quantity of same dimensions. Examples ======== >>> from sympy.physics.units import speed_of_light, meter, second >>> speed_of_light speed_of_light >>> speed_of_light.convert_to(meter/second) 299792458*meter/second >>> from sympy.physics.units import liter >>> liter.convert_to(meter**3) meter**3/1000 rV) convert_to)utilr\)r1otherr2r\r&r&r'r\s  zQuantity.convert_tocCstS)z"Return free symbols from quantity.)setrAr&r&r' free_symbolszQuantity.free_symbolscCr;)zWWhether or not the quantity is prefixed. Eg. `kilogram` is prefixed, but `gram` is not.)rrAr&r&r'r#razQuantity.is_prefixed)NNNNNNNF)r()__name__ __module__ __qualname____doc__is_commutativeis_real is_number is_nonzerois_physical_constant _diff_wrtrrrr7r@propertyrrrrrIrKrLrO staticmethodrQrTr[r\r`r#r&r&r&r'r sN A         r c@seZdZdZdZdS)PhysicalConstantzLRepresents a physical constant, eg. `speed_of_light` or `avogadro_constant`.TN)rbrcrdrerjr&r&r&r'rnsrnN)resympy.core.exprrsympy.core.symbolrsympy.core.sympifyrsympy.physics.units.dimensionsrsympy.physics.units.prefixesrsympy.utilities.exceptionsrrr r rnr&r&r&r's     l