Update area.py

maths/area.py

@@ -135,6 +135,32 @@ def surface_area_cone(radius: float, height: float) -> float:
     return pi * radius * (radius + (height**2 + radius**2) ** 0.5)
 
 
+def lateral_surface_cone(radius: float, height: float) -> float:
+    """
+    Calculate the Lateral Surface Area of a Cone.
+    Wikipedia reference: https://en.wikipedia.org/wiki/Cone
+    Formula: pi * r * (h ** 2 + r ** 2) ** 0.5
+
+    >>> lateral_surface_cone(10, 20)
+    702.4814731040726
+    >>> lateral_surface_cone(6, 8)
+    188.49555921538757
+    >>> lateral_surface_cone(0, 0)
+    0.0
+    >>> lateral_surface_cone(1, -2)
+    Traceback (most recent call last):
+          ...
+    ValueError: lateral_surface_cone() only accepts non-negative values
+    >>> lateral_surface_cone(-1, 2)
+    Traceback (most recent call last):
+          ...
+    ValueError: lateral_surface_cone() only accepts non-negative values
+    """
+    if radius < 0 or height < 0:
+        raise ValueError("lateral_surface_cone() only accepts non-negative values")
+    return pi * radius * (height**2 + radius**2) ** 0.5
+
+
 def surface_area_conical_frustum(
     radius_1: float, radius_2: float, height: float
 ) -> float:
@@ -202,6 +228,32 @@ def surface_area_cylinder(radius: float, height: float) -> float:
     return 2 * pi * radius * (height + radius)
 
 
+def lateral_surface_cylinder(radius: float, height: float) -> float:
+    """
+    Calculate the Lateral Surface Area of a Cylinder.
+    Wikipedia reference: https://en.wikipedia.org/wiki/Cylinder
+    Formula: 2 * pi * r * h
+
+    >>> lateral_surface_cylinder(10, 20)
+    702.4814731040726
+    >>> lateral_surface_cylinder(6, 8)
+    301.59289474462014
+    >>> lateral_surface_cylinder(0, 0)
+    0.0
+    >>> lateral_surface_cylinder(1, -2)
+    Traceback (most recent call last):
+      ...
+    ValueError: lateral_surface_cylinder() only accepts non-negative values
+    >>> lateral_surface_cylinder(-1, 2)
+    Traceback (most recent call last):
+      ...
+    ValueError: lateral_surface_cylinder() only accepts non-negative values
+    """
+    if radius < 0 or height < 0:
+        raise ValueError("lateral_surface_cylinder() only accepts non-negative values")
+    return 2 * pi * radius * height
+
+
 def surface_area_torus(torus_radius: float, tube_radius: float) -> float:
     """Calculate the Area of a Torus.
     Wikipedia reference: https://en.wikipedia.org/wiki/Torus
@@ -576,8 +628,10 @@ def area_reg_polygon(sides: int, length: float) -> float:
     print(f"Sphere: {surface_area_sphere(20) = }")
     print(f"Hemisphere: {surface_area_hemisphere(20) = }")
     print(f"Cone: {surface_area_cone(10, 20) = }")
+    print(f"Cone, lateral: {lateral_surface_cone(10, 20) = }")
     print(f"Conical Frustum: {surface_area_conical_frustum(10, 20, 30) = }")
     print(f"Cylinder: {surface_area_cylinder(10, 20) = }")
+    print(f"Cylinder, lateral: {lateral_surface_cylinder(10, 20) = }")
     print(f"Torus: {surface_area_torus(20, 10) = }")
     print(f"Equilateral Triangle: {area_reg_polygon(3, 10) = }")
     print(f"Square: {area_reg_polygon(4, 10) = }")