Update volume.py

Author: kvadrik

maths/volume.py

@@ -509,6 +509,30 @@ def vol_torus(torus_radius: float, tube_radius: float) -> float:
         raise ValueError("vol_torus() only accepts non-negative values")
     return 2 * pow(pi, 2) * torus_radius * pow(tube_radius, 2)
 
+def vol_octahedron(oct_side: float) -> float:
+    """
+    | Calculate the Volume of an Octahedron.
+    | Wikipedia reference: https://en.wikipedia.org/wiki/Regular_octahedron
+
+    >>> from math import isclose
+    >>> isclose(vol_octahedron(2.5), 7.36569563735987)
+    True
+    >>> isclose(vol_octahedron(10), 471.40452079103168)
+    True
+    >>> isclose(vol_octahedron(5), 58.92556509887896)
+    True
+    >>> isclose(vol_octahedron(3.5), 20.21146882891548)
+    True
+    >>> vol_octahedron(0)
+    0.0
+    >>> vol_octahedron(-1)
+    Traceback (most recent call last):
+        ...
+    ValueError: vol_octahedron() only accepts non-negative values
+    """
+    if oct_side < 0:
+        raise ValueError("vol_octahedron() only accepts non-negative values")
+    return oct_side**3 * 2**0.5 / 3
 
 def vol_icosahedron(tri_side: float) -> float:
     """
@@ -560,6 +584,7 @@ def main():
     print(
         f"Hollow Circular Cylinder: {vol_hollow_circular_cylinder(1, 2, 3) = }"
     )  # ~= 28.3
+    print(f"Octahedron: {vol_octahedron(2.5) = }") # ~=7.37
     print(f"Icosahedron: {vol_icosahedron(2.5) = }")  # ~=34.09