o o hfb@sddlmZddlmZddlmZmZmZmZm Z ddl m Z m Z m Z mZmZddlmZddlmZddlmZddlmZmZmZmZmZmZmZdd lmZdd l m!Z"m#Z$dd l%m&Z&gd Z'e Z(e Z)e Z*eZ+d dZ,ej-e,_-d9ddZ!ddZ#ddZ.ddZ/ddZ0ddZ1ddZ2ddZ3dd Z4d:d"d#Z5d$d%d&d'Z6d(d)Z7d*d+Z8d,d-Z9d.d/Z:d0d1Z;d2d3Z< 4 !d;d5d6Z=d7d8Z>d!S)<) dict_merge)iterable)DyadicVectorReferenceFramePointdynamicsymbols)vprintvsprintvpprintvlatexinit_vprinting)Particle) RigidBody)simplify)MatrixMul DerivativesincostanS) AppliedUndef)inertiainertia_of_point_mass)sympy_deprecation_warning) linear_momentumangular_momentumkinetic_energypotential_energy Lagrangianmechanics_printingmprintmsprintmpprintmlatexmsubsfind_dynamicsymbolscKstdi|dS)z] Initializes time derivative printing for all SymPy objects in mechanics module. N)r )kwargsr(r(u/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/sympy/physics/mechanics/functions.pyr!&sr!cCs"tddddt|||||||S)Nzh The inertia function has been moved. Import it from "sympy.physics.mechanics". 1.13moved-mechanics-functionsdeprecated_since_versionactive_deprecations_target)r_inertia)frameixxiyyizzixyiyzizxr(r(r*r1s rcCstddddt|||S)Nzv The inertia_of_point_mass function has been moved. Import it from "sympy.physics.mechanics". r+r,r-)r_inertia_of_point_mass)masspos_vecr1r(r(r*r=s  rcGsLt|ts tdtd}|D]}t|ttfr |||7}qtd|S)aLinear momentum of the system. Explanation =========== This function returns the linear momentum of a system of Particle's and/or RigidBody's. The linear momentum of a system is equal to the vector sum of the linear momentum of its constituents. Consider a system, S, comprised of a rigid body, A, and a particle, P. The linear momentum of the system, L, is equal to the vector sum of the linear momentum of the particle, L1, and the linear momentum of the rigid body, L2, i.e. L = L1 + L2 Parameters ========== frame : ReferenceFrame The frame in which linear momentum is desired. body1, body2, body3... : Particle and/or RigidBody The body (or bodies) whose linear momentum is required. Examples ======== >>> from sympy.physics.mechanics import Point, Particle, ReferenceFrame >>> from sympy.physics.mechanics import RigidBody, outer, linear_momentum >>> N = ReferenceFrame('N') >>> P = Point('P') >>> P.set_vel(N, 10 * N.x) >>> Pa = Particle('Pa', P, 1) >>> Ac = Point('Ac') >>> Ac.set_vel(N, 25 * N.y) >>> I = outer(N.x, N.x) >>> A = RigidBody('A', Ac, N, 20, (I, Ac)) >>> linear_momentum(N, A, Pa) 10*N.x + 500*N.y z%Please specify a valid ReferenceFramer**body must have only Particle or RigidBody) isinstancer TypeErrorrrrr)r1bodylinear_momentum_syser(r(r*rIs )rcGs`t|ts tdt|tstdtd}|D]}t|ttfr*||||7}qtd|S)aAngular momentum of a system. Explanation =========== This function returns the angular momentum of a system of Particle's and/or RigidBody's. The angular momentum of such a system is equal to the vector sum of the angular momentum of its constituents. Consider a system, S, comprised of a rigid body, A, and a particle, P. The angular momentum of the system, H, is equal to the vector sum of the angular momentum of the particle, H1, and the angular momentum of the rigid body, H2, i.e. H = H1 + H2 Parameters ========== point : Point The point about which angular momentum of the system is desired. frame : ReferenceFrame The frame in which angular momentum is desired. body1, body2, body3... : Particle and/or RigidBody The body (or bodies) whose angular momentum is required. Examples ======== >>> from sympy.physics.mechanics import Point, Particle, ReferenceFrame >>> from sympy.physics.mechanics import RigidBody, outer, angular_momentum >>> N = ReferenceFrame('N') >>> O = Point('O') >>> O.set_vel(N, 0 * N.x) >>> P = O.locatenew('P', 1 * N.x) >>> P.set_vel(N, 10 * N.x) >>> Pa = Particle('Pa', P, 1) >>> Ac = O.locatenew('Ac', 2 * N.y) >>> Ac.set_vel(N, 5 * N.y) >>> a = ReferenceFrame('a') >>> a.set_ang_vel(N, 10 * N.z) >>> I = outer(N.z, N.z) >>> A = RigidBody('A', Ac, a, 20, (I, Ac)) >>> angular_momentum(O, N, Pa, A) 10*N.z #Please enter a valid ReferenceFramezPlease specify a valid Pointrr;)r<rr=rrrrr)pointr1r>angular_momentum_sysr@r(r(r*r~s / rcGsJt|ts tdtj}|D]}t|ttfr|||7}qtd|S)aKinetic energy of a multibody system. Explanation =========== This function returns the kinetic energy of a system of Particle's and/or RigidBody's. The kinetic energy of such a system is equal to the sum of the kinetic energies of its constituents. Consider a system, S, comprising a rigid body, A, and a particle, P. The kinetic energy of the system, T, is equal to the vector sum of the kinetic energy of the particle, T1, and the kinetic energy of the rigid body, T2, i.e. T = T1 + T2 Kinetic energy is a scalar. Parameters ========== frame : ReferenceFrame The frame in which the velocity or angular velocity of the body is defined. body1, body2, body3... : Particle and/or RigidBody The body (or bodies) whose kinetic energy is required. Examples ======== >>> from sympy.physics.mechanics import Point, Particle, ReferenceFrame >>> from sympy.physics.mechanics import RigidBody, outer, kinetic_energy >>> N = ReferenceFrame('N') >>> O = Point('O') >>> O.set_vel(N, 0 * N.x) >>> P = O.locatenew('P', 1 * N.x) >>> P.set_vel(N, 10 * N.x) >>> Pa = Particle('Pa', P, 1) >>> Ac = O.locatenew('Ac', 2 * N.y) >>> Ac.set_vel(N, 5 * N.y) >>> a = ReferenceFrame('a') >>> a.set_ang_vel(N, 10 * N.z) >>> I = outer(N.z, N.z) >>> A = RigidBody('A', Ac, a, 20, (I, Ac)) >>> kinetic_energy(N, Pa, A) 350 rAr;)r<rr=rZerorrr)r1r>ke_sysr@r(r(r*rs 0rcGs4tj}|D]}t|ttfr||j7}qtd|S)aPotential energy of a multibody system. Explanation =========== This function returns the potential energy of a system of Particle's and/or RigidBody's. The potential energy of such a system is equal to the sum of the potential energy of its constituents. Consider a system, S, comprising a rigid body, A, and a particle, P. The potential energy of the system, V, is equal to the vector sum of the potential energy of the particle, V1, and the potential energy of the rigid body, V2, i.e. V = V1 + V2 Potential energy is a scalar. Parameters ========== body1, body2, body3... : Particle and/or RigidBody The body (or bodies) whose potential energy is required. Examples ======== >>> from sympy.physics.mechanics import Point, Particle, ReferenceFrame >>> from sympy.physics.mechanics import RigidBody, outer, potential_energy >>> from sympy import symbols >>> M, m, g, h = symbols('M m g h') >>> N = ReferenceFrame('N') >>> O = Point('O') >>> O.set_vel(N, 0 * N.x) >>> P = O.locatenew('P', 1 * N.x) >>> Pa = Particle('Pa', P, m) >>> Ac = O.locatenew('Ac', 2 * N.y) >>> a = ReferenceFrame('a') >>> I = outer(N.z, N.z) >>> A = RigidBody('A', Ac, a, M, (I, Ac)) >>> Pa.potential_energy = m * g * h >>> A.potential_energy = M * g * h >>> potential_energy(Pa, A) M*g*h + g*h*m r;)rrDr<rrrr=)r>pe_sysr@r(r(r*rs . rcGs*ddlm}tdddd||g|RS)Nr)gravityzn The gravity function has been moved. Import it from "sympy.physics.mechanics.loads". r+r,r-)sympy.physics.mechanics.loadsrGr) accelerationbodies_gravityr(r(r*rG-s rGcGsb|stdd}td}|D]}||j7}t|dd}|dur"|j}||j||7}q||S)a Returns the position vector from the given point to the center of mass of the given bodies(particles or rigidbodies). Example ======= >>> from sympy import symbols, S >>> from sympy.physics.vector import Point >>> from sympy.physics.mechanics import Particle, ReferenceFrame, RigidBody, outer >>> from sympy.physics.mechanics.functions import center_of_mass >>> a = ReferenceFrame('a') >>> m = symbols('m', real=True) >>> p1 = Particle('p1', Point('p1_pt'), S(1)) >>> p2 = Particle('p2', Point('p2_pt'), S(2)) >>> p3 = Particle('p3', Point('p3_pt'), S(3)) >>> p4 = Particle('p4', Point('p4_pt'), m) >>> b_f = ReferenceFrame('b_f') >>> b_cm = Point('b_cm') >>> mb = symbols('mb') >>> b = RigidBody('b', b_cm, b_f, mb, (outer(b_f.x, b_f.x), b_cm)) >>> p2.point.set_pos(p1.point, a.x) >>> p3.point.set_pos(p1.point, a.x + a.y) >>> p4.point.set_pos(p1.point, a.y) >>> b.masscenter.set_pos(p1.point, a.y + a.z) >>> point_o=Point('o') >>> point_o.set_pos(p1.point, center_of_mass(p1.point, p1, p2, p3, p4, b)) >>> expr = 5/(m + mb + 6)*a.x + (m + mb + 3)/(m + mb + 6)*a.y + mb/(m + mb + 6)*a.z >>> point_o.pos_from(p1.point) 5/(m + mb + 6)*a.x + (m + mb + 3)/(m + mb + 6)*a.y + mb/(m + mb + 6)*a.z z:No bodies(instances of Particle or Rigidbody) were passed.r masscenterN)r=rr9getattrrBpos_from)rBrJ total_massvecirLr(r(r*center_of_mass:s!  rRcGsJt|ts td|D] }t|ttfstdq t|g|Rt|S)aLagrangian of a multibody system. Explanation =========== This function returns the Lagrangian of a system of Particle's and/or RigidBody's. The Lagrangian of such a system is equal to the difference between the kinetic energies and potential energies of its constituents. If T and V are the kinetic and potential energies of a system then it's Lagrangian, L, is defined as L = T - V The Lagrangian is a scalar. Parameters ========== frame : ReferenceFrame The frame in which the velocity or angular velocity of the body is defined to determine the kinetic energy. body1, body2, body3... : Particle and/or RigidBody The body (or bodies) whose Lagrangian is required. Examples ======== >>> from sympy.physics.mechanics import Point, Particle, ReferenceFrame >>> from sympy.physics.mechanics import RigidBody, outer, Lagrangian >>> from sympy import symbols >>> M, m, g, h = symbols('M m g h') >>> N = ReferenceFrame('N') >>> O = Point('O') >>> O.set_vel(N, 0 * N.x) >>> P = O.locatenew('P', 1 * N.x) >>> P.set_vel(N, 10 * N.x) >>> Pa = Particle('Pa', P, 1) >>> Ac = O.locatenew('Ac', 2 * N.y) >>> Ac.set_vel(N, 5 * N.y) >>> a = ReferenceFrame('a') >>> a.set_ang_vel(N, 10 * N.z) >>> I = outer(N.z, N.z) >>> A = RigidBody('A', Ac, a, 20, (I, Ac)) >>> Pa.potential_energy = m * g * h >>> A.potential_energy = M * g * h >>> Lagrangian(N, Pa, A) -M*g*h - g*h*m + 350 z$Please supply a valid ReferenceFramer;)r<rr=rrrr)r1r>r@r(r(r*r ks 4r Ncsrtjh|rt|rt|}ntdt}t|tr*|dur%td|||}fdd| t t D|S)aFind all dynamicsymbols in expression. Explanation =========== If the optional ``exclude`` kwarg is used, only dynamicsymbols not in the iterable ``exclude`` are returned. If we intend to apply this function on a vector, the optional ``reference_frame`` is also used to inform about the corresponding frame with respect to which the dynamic symbols of the given vector is to be determined. Parameters ========== expression : SymPy expression exclude : iterable of dynamicsymbols, optional reference_frame : ReferenceFrame, optional The frame with respect to which the dynamic symbols of the given vector is to be determined. Examples ======== >>> from sympy.physics.mechanics import dynamicsymbols, find_dynamicsymbols >>> from sympy.physics.mechanics import ReferenceFrame >>> x, y = dynamicsymbols('x, y') >>> expr = x + x.diff()*y >>> find_dynamicsymbols(expr) {x(t), y(t), Derivative(x(t), t)} >>> find_dynamicsymbols(expr, exclude=[x, y]) {Derivative(x(t), t)} >>> a, b, c = dynamicsymbols('a, b, c') >>> A = ReferenceFrame('A') >>> v = a * A.x + b * A.y + c * A.z >>> find_dynamicsymbols(v, reference_frame=A) {a(t), b(t), c(t)} zexclude kwarg must be iterableNzJYou must provide reference_frame when passing a vector expression, got %s.csh|] }|jkr|qSr() free_symbols).0rQt_setr(r* s z&find_dynamicsymbols..) r_trsetr=r<r ValueError to_matrixatomsrr) expressionexcludereference_frame exclude_setr(rUr*r's*   r'F)smartcs\t||r tnt|dr|Sddt|tttfr)|fddS|S)a%A custom subs for use on expressions derived in physics.mechanics. Traverses the expression tree once, performing the subs found in sub_dicts. Terms inside ``Derivative`` expressions are ignored: Examples ======== >>> from sympy.physics.mechanics import dynamicsymbols, msubs >>> x = dynamicsymbols('x') >>> msubs(x.diff() + x, {x: 1}) Derivative(x(t), t) + 1 Note that sub_dicts can be a single dictionary, or several dictionaries: >>> x, y, z = dynamicsymbols('x, y, z') >>> sub1 = {x: 1, y: 2} >>> sub2 = {z: 3, x.diff(): 4} >>> msubs(x.diff() + x + y + z, sub1, sub2) 10 If smart=True (default False), also checks for conditions that may result in ``nan``, but if simplified would yield a valid expression. For example: >>> from sympy import sin, tan >>> (sin(x)/tan(x)).subs(x, 0) nan >>> msubs(sin(x)/tan(x), {x: 0}, smart=True) 1 It does this by first replacing all ``tan`` with ``sin/cos``. Then each node is traversed. If the node is a fraction, subs is first evaluated on the denominator. If this results in 0, simplification of the entire fraction is attempted. Using this selective simplification, only subexpressions that result in 1/0 are targeted, resulting in faster performance. r&cSs t|t|SN)_crawl _sub_funcexprsub_dictr(r(r*s zmsubs..cs |Srbr()xfuncrgr(r*rhs ) r _smart_subshasattrr&r<rrr applyfunc)rfra sub_dictsr)r(rjr*r&s(   r&csD|gRi}|dur|Sfdd|jD}|j|S)z8Crawl the expression tree, and apply func to every node.Nc3s(|]}t|gRiVqdSrb)rcrTargargsrkr)r(r* s&z_crawl..)rsrk)rfrkrsr)valnew_argsr(rrr*rcs  rccCs$||vr||S|jr|jr|SdS)z;Perform direct matching substitution, ignoring derivatives.N)rs is_Derivativerer(r(r*rd!s  rdcCs2t|trt|jt|jS|jr|jr|SdS)zReplace tan with sin/cos.N)r<rrrsrrw)rfr(r(r*_tan_repl_func)s  rxcs t|t}fdd||S)aPerforms subs, checking for conditions that may result in `nan` or `oo`, and attempts to simplify them out. The expression tree is traversed twice, and the following steps are performed on each expression node: - First traverse: Replace all `tan` with `sin/cos`. - Second traverse: If node is a fraction, check if the denominator evaluates to 0. If so, attempt to simplify it out. Then if node is in sub_dict, sub in the corresponding value. cs|t|\}}|dkr#|}|dkrt|}n |}||St|}|dur.|Sfdd|jD}|j|S)Nrc3s|]}|VqdSrbr(rp) _recurserrgr(r*rtSsz1_smart_subs.._recurser..)_fraction_decompevalfrrdrsrk)rfrgnumden denom_subbed num_subbedrurvrz)rgr*rzAs       z_smart_subs.._recurser)rcrxrer(rr*rl1s   rlcCsxt|ts |dfSg}g}|jD]}|jr$|jddkr$|d|q||q|s0|dfSt|}t|}||fS)z)Return num, den such that expr = num/den.ryr)r<rrsis_Powappend)rfr}r~ar(r(r*r{Xs   r{csDfdd}sd\}}||fSdd}|t|\}}||fS)aIParses the provided forcelist composed of items of the form (obj, force). Returns a tuple containing: vel_list: The velocity (ang_vel for Frames, vel for Points) in the provided reference frame. f_list: The forces. Used internally in the KanesMethod and LagrangesMethod classes. c3sVD]%}|\}}t|tr||fVqt|tr%||fVqtddS)Nz.flist_iter)r(r(cSs|dr tt|SddgS)Nrr()listzip)lr(r(r*rhsz _f_list_parser..)r)rrrvel_listf_listunzipr(rr*_f_list_parserjs  rTcstjh}|dur g}nt|s|g}|durg}nt|s |g}|dur'g}nt|s.|g}g}|rtfdd|D}tfdd|D}tfdd|D} t||} t|||} |rr|d|d|r}|d|d | r|d | d | r|| d | r|d | d |r|D]} t| tt fr| j |ks|d| dq|D]} t| tt fr| j |ks|d| dq|D]}t|tt fr|j |ks|d|dq|rt d |dS)aValidate the generalized coordinates and generalized speeds. Parameters ========== coordinates : iterable, optional Generalized coordinates to be validated. speeds : iterable, optional Generalized speeds to be validated. check_duplicates : bool, optional Checks if there are duplicates in the generalized coordinates and generalized speeds. If so it will raise a ValueError. The default is True. is_dynamicsymbols : iterable, optional Checks if all the generalized coordinates and generalized speeds are dynamicsymbols. If any is not a dynamicsymbol, a ValueError will be raised. The default is True. u_auxiliary : iterable, optional Auxiliary generalized speeds to be validated. Nc"h|] }|vs |r|qSr(addrTriseenr(r*rW"z(_validate_coordinates..crr(rrrr(r*rWrcrr(rrrr(r*rWrzThe generalized coordinates z> are duplicated, all generalized coordinates should be unique.zThe generalized speeds z9 are duplicated, all generalized speeds should be unique.zThe auxiliary speeds z7 are duplicated, all auxiliary speeds should be unique.zD are defined as both generalized coordinates and generalized speeds.zC are also defined as generalized coordinates or generalized speeds.zGeneralized coordinate "z" is not a dynamicsymbol.zGeneralized speed "zAuxiliary speed " ) rrXrrY intersectionunionrr<rrrSrZjoin) coordinatesspeedscheck_duplicatesis_dynamicsymbols u_auxiliaryrVmsgscoord_duplicatesspeed_duplicatesaux_duplicatesoverlap_coords overlap_aux coordinatespeedauxr(rr*_validate_coordinatessp     rcstrSfddS)z6Helper function to retrieve a specified linear solver.cstj||dS)N)method)rsolve)Ab linear_solverr(r*rhsz&_parse_linear_solver..)callablerr(rr*_parse_linear_solvers r)rrr)NN)NNTTN)?sympy.utilitiesrsympy.utilities.iterablesrsympy.physics.vectorrrrrrsympy.physics.vector.printingr r r r r sympy.physics.mechanics.particler!sympy.physics.mechanics.rigidbodyrsympy.simplify.simplifyrsympyrrrrrrrsympy.core.functionrsympy.physics.mechanics.inertiarr0rr8sympy.utilities.exceptionsr__all__r"r#r$r%r!__doc__rrrrrGrRr r'r&rcrdrxrlr{rrrr(r(r(r*sN    $     5=;7 1 <<5 ' S