class_docstr: Cables are structures in engineering that support
  the applied transverse loads through the tensile
  resistance developed in its members.
  
  Cables are widely used in suspension bridges, tension
  leg offshore platforms, transmission lines, and find
  use in several other engineering applications.
  
  Examples
  ========
  A cable is supported at (0, 10) and (10, 10). Two point loads
  acting vertically downwards act on the cable, one with magnitude 3 kN
  and acting 2 meters from the left support and 3 meters below it, while
  the other with magnitude 2 kN is 6 meters from the left support and
  6 meters below it.
  
  >>> from sympy.physics.continuum_mechanics.cable import Cable
  >>> c = Cable(('A', 0, 10), ('B', 10, 10))
  >>> c.apply_load(-1, ('P', 2, 7, 3, 270))
  >>> c.apply_load(-1, ('Q', 6, 4, 2, 270))
  >>> c.loads
  {'distributed': {}, 'point_load': {'P': [3, 270], 'Q': [2, 270]}}
  >>> c.loads_position
  {'P': [2, 7], 'Q': [6, 4]}
class_docstr_tok: ["Cables","are","structures","in","engineering","that","support","the","applied","transverse","loads","through","the","tensile","resistance","developed","in","its","members",".","Cables","are","widely","used","in","suspension","bridges",",","tension","leg","offshore","platforms",",","transmission","lines",",","and","find","use","in","several","other","engineering","applications",".","Examples","========","A","cable","is","supported","at","(","0",",","10",")","and","(","10",",","10",")",".","Two","point","loads","acting","vertically","downwards","act","on","the","cable",",","one","with","magnitude","3","kN","and","acting","2","meters","from","the","left","support","and","3","meters","below","it",",","while","the","other","with","magnitude","2","kN","is","6","meters","from","the","left","support","and","6","meters","below","it",".",">",">",">","from","sympy.physics.continuum_mechanics.cable","import","Cable",">",">",">","c","=","Cable","(","(","'","A","'",",","0",",","10",")",",","(","'","B","'",",","10",",","10",")",")",">",">",">","c.apply_load","(","-1",",","(","'","P","'",",","2",",","7",",","3",",","270",")",")",">",">",">","c.apply_load","(","-1",",","(","'","Q","'",",","6",",","4",",","2",",","270",")",")",">",">",">","c.loads","{","'distributed","'",":","{","}",",","'point_load","'",":","{","'","P","'",":","[","3",",","270","]",",","'","Q","'",":","[","2",",","270","]","}","}",">",">",">","c.loads_position","{","'","P","'",":","[","2",",","7","]",",","'","Q","'",":","[","6",",","4","]","}"]
docstr: This method specifies the length of the cable
  
  Parameters
  ==========
  
  length : Sympifyable
      The length of the cable
  
  Examples
  ========
  
  >>> from sympy.physics.continuum_mechanics.cable import Cable
  >>> c = Cable(('A', 0, 10), ('B', 10, 10))
  >>> c.apply_length(20)
  >>> c.length
  20
docstr_tok: ["This","method","specifies","the","length","of","the","cable","Parameters","==========","length",":","Sympifyable","The","length","of","the","cable","Examples","========",">",">",">","from","sympy.physics.continuum_mechanics.cable","import","Cable",">",">",">","c","=","Cable","(","(","'","A","'",",","0",",","10",")",",","(","'","B","'",",","10",",","10",")",")",">",">",">","c.apply_length","(","20",")",">",">",">","c.length","20"]
code: def apply_length(self, length):
      """
      This method specifies the length of the cable
  
      Parameters
      ==========
  
      length : Sympifyable
          The length of the cable
  
      Examples
      ========
  
      >>> from sympy.physics.continuum_mechanics.cable import Cable
      >>> c = Cable(('A', 0, 10), ('B', 10, 10))
      >>> c.apply_length(20)
      >>> c.length
      20
      """
      dist = (
          (self._left_support[0] - self._right_support[0]) ** 2
          - (self._left_support[1] - self._right_support[1]) ** 2
      ) ** (1 / 2)
  
      if length < dist:
          raise ValueError(
              "length should not be less than the distance between the supports"
          )
  
      self._length = length
  
file_path: sympy/sympy/physics/continuum_mechanics/cable.py
imports: from sympy.core.sympify import sympify
  from sympy.core.symbol import Symbol
label_desc: Use image node_id 9 for calling the Cable obj's underlying member method code with example usage: obj.apply_length(length) without return types