class_docstr: A particle.
  
  Explanation
  ===========
  
  Particles have a non-zero mass and lack spatial extension; they take up no
  space.
  
  Values need to be supplied on initialization, but can be changed later.
  
  Parameters
  ==========
  
  name : str
      Name of particle
  point : Point
      A physics/mechanics Point which represents the position, velocity, and
      acceleration of this Particle
  mass : Sympifyable
      A SymPy expression representing the Particle's mass
  potential_energy : Sympifyable
      The potential energy of the Particle.
  
  Examples
  ========
  
  >>> from sympy.physics.mechanics import Particle, Point
  >>> from sympy import Symbol
  >>> po = Point('po')
  >>> m = Symbol('m')
  >>> pa = Particle('pa', po, m)
  >>> # Or you could change these later
  >>> pa.mass = m
  >>> pa.point = po
class_docstr_tok: ["A","particle",".","Explanation","===========","Particles","have","a","non-zero","mass","and","lack","spatial","extension",";","they","take","up","no","space",".","Values","need","to","be","supplied","on","initialization",",","but","can","be","changed","later",".","Parameters","==========","name",":","str","Name","of","particle","point",":","Point","A","physics\/mechanics","Point","which","represents","the","position",",","velocity",",","and","acceleration","of","this","Particle","mass",":","Sympifyable","A","SymPy","expression","representing","the","Particle","'s","mass","potential_energy",":","Sympifyable","The","potential","energy","of","the","Particle",".","Examples","========",">",">",">","from","sympy.physics.mechanics","import","Particle",",","Point",">",">",">","from","sympy","import","Symbol",">",">",">","po","=","Point","(","'po","'",")",">",">",">","m","=","Symbol","(","'m","'",")",">",">",">","pa","=","Particle","(","'pa","'",",","po",",","m",")",">",">",">","#","Or","you","could","change","these","later",">",">",">","pa.mass","=","m",">",">",">","pa.point","=","po"]
code: def set_potential_energy(self, scalar):
      sympy_deprecation_warning(
          """
  The sympy.physics.mechanics.Particle.set_potential_energy()
  method is deprecated. Instead use
  
      P.potential_energy = scalar
              """,
          deprecated_since_version="1.5",
          active_deprecations_target="deprecated-set-potential-energy",
      )
      self.potential_energy = scalar
  
file_path: sympy/sympy/physics/mechanics/particle.py
imports: from sympy import S
  from sympy.physics.vector import cross, dot
  from sympy.physics.mechanics.body_base import BodyBase
  from sympy.physics.mechanics.inertia import inertia_of_point_mass
  from sympy.utilities.exceptions import sympy_deprecation_warning
label_desc: Use image node_id 5 for calling the Particle obj's underlying member method code with example usage: obj.set_potential_energy(scalar) without return types