physics.relativistic_velocity_summation
=======================================

.. py:module:: physics.relativistic_velocity_summation

.. autoapi-nested-parse::

   The relativistic velocity summation formula calculates the combined velocity v2 of
   an object moving at speed v1 relative to a frame that is itself moving at velocity v
   relative to an observer. I take the last one to be strictly lower than the speed of
   light.
   The formula is v2 = (v1 + v)/(1 + v1 * v / c**2)
   v1 - speed of the object relative to a moving frame
   v - speed of the moving frame
   c - speed of light in a vacuum
   v2 - speed of the object relative to an observer

   https://en.wikipedia.org/wiki/Velocity-addition_formula



Attributes
----------

.. autoapisummary::

   physics.relativistic_velocity_summation.c


Functions
---------

.. autoapisummary::

   physics.relativistic_velocity_summation.relativistic_velocity_summation


Module Contents
---------------

.. py:function:: relativistic_velocity_summation(object_velocity: float, frame_velocity: float) -> float

   >>> relativistic_velocity_summation(200000000, 200000000)
   276805111.0636436
   >>> relativistic_velocity_summation(299792458, 100000000)
   299792458.0
   >>> relativistic_velocity_summation(100000000, 299792458)
   Traceback (most recent call last):
       ...
   ValueError: Speeds must not exceed light speed...


.. py:data:: c
   :value: 299792458