From 9278d0c6cdaa30115dbfef510e31a805bd3027dd Mon Sep 17 00:00:00 2001
From: Dima I <79413560+DIvkov575@users.noreply.github.com>
Date: Sun, 30 Oct 2022 06:54:23 -0400
Subject: [PATCH] Added archimedes principle (physics) (#7143)

* Added archimedes principle (physics)

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* reformated

* reformatted archimedes principles

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 physics/archimedes_principle.py | 49 +++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 physics/archimedes_principle.py

diff --git a/physics/archimedes_principle.py b/physics/archimedes_principle.py
new file mode 100644
index 000000000..6ecfc65e7
--- /dev/null
+++ b/physics/archimedes_principle.py
@@ -0,0 +1,49 @@
+"""
+Calculates buoyant force on object submerged within static fluid.
+Discovered by greek mathematician, Archimedes. The principle is named after him.
+
+Equation for calculating buoyant force:
+Fb = ρ * V * g
+
+Source:
+- https://en.wikipedia.org/wiki/Archimedes%27_principle
+"""
+
+
+# Acceleration Constant on Earth (unit m/s^2)
+g = 9.80665
+
+
+def archimedes_principle(
+    fluid_density: float, volume: float, gravity: float = g
+) -> float:
+    """
+    Args:
+        fluid_density: density of fluid (kg/m^3)
+        volume: volume of object / liquid being displaced by object
+        gravity: Acceleration from gravity. Gravitational force on system,
+            Default is Earth Gravity
+    returns:
+        buoyant force on object in Newtons
+
+    >>> archimedes_principle(fluid_density=997, volume=0.5, gravity=9.8)
+    4885.3
+    >>> archimedes_principle(fluid_density=997, volume=0.7)
+    6844.061035
+    """
+
+    if fluid_density <= 0:
+        raise ValueError("Impossible fluid density")
+    if volume < 0:
+        raise ValueError("Impossible Object volume")
+    if gravity <= 0:
+        raise ValueError("Impossible Gravity")
+
+    return fluid_density * gravity * volume
+
+
+if __name__ == "__main__":
+    import doctest
+
+    # run doctest
+    doctest.testmod()