DOC: StochasticAirBrakes related documentation added

Documentation related to the StochasticAirBrakes implementation has been added in StochasticAirBrakes, StochasticRocket and Rocket classes.

Author: kevin-alcaniz

rocketpy/rocket/rocket.py

@@ -1539,9 +1539,21 @@ def set_air_brakes(
         air_brakes,
         controller,
     ):
-        
+        """Adds an air brake with a controller to the rocket.
+
+        Parameters
+        ----------
+        air_brakes : AirBrakes
+            Air brake to be added to the rocket.
+        controller : _Controller
+            Air brake controller
+
+        Returns
+        -------
+        None
+        """
         self.air_brakes.append(air_brakes)
-        self._add_controllers(controller)  
+        self._add_controllers(controller)
 
     def add_air_brakes(
         self,

rocketpy/stochastic/stochastic_aero_surfaces.py

@@ -447,14 +447,24 @@ class StochasticAirBrakes(StochasticModel):
     ----------
     object : AirBrakes
         AirBrakes object to be used for validation.
-    drag_coefficient_curve : list
+    drag_coefficient_curve : list, str
         The drag coefficient curve of the air brakes can account for 
         either the air brakes' drag alone or the combined drag of both
         the rocket and the air brakes.
     drag_coefficient_curve_factor : tuple, list, int, float
         The drag curve factor of the air brakes.
     reference_area : tuple, list, int, float
         Reference area used to non-dimensionalize the drag coefficients.
+    clamp : bool
+        If True, the simulation will clamp the deployment level to 0 or 1 if
+        the deployment level is out of bounds. If False, the simulation will
+        not clamp the deployment level and will instead raise a warning if
+        the deployment level is out of bounds.
+    override_rocket_drag : bool
+        If False, the air brakes drag coefficient will be added to the
+        rocket's power off drag coefficient curve. If True, during the
+        simulation, the rocket's power off drag will be ignored and the air
+        brakes drag coefficient will be used for the entire rocket instead.
     deployment_level : tuple, list, int, float
         Initial deployment level, ranging from 0 to 1.
     name : list[str]
@@ -481,14 +491,24 @@ def __init__(
         ----------
         air_brakes : AirBrakes
             AirBrakes object to be used for validation.
-        drag_coefficient_curve : list, optional
+        drag_coefficient_curve : list, str, optional
             The drag coefficient curve of the air brakes can account for 
             either the air brakes' drag alone or the combined drag of both
             the rocket and the air brakes.
         drag_coefficient_curve_factor : tuple, list, int, float, optional
             The drag curve factor of the air brakes.
         reference_area : tuple, list, int, float, optional
             Reference area used to non-dimensionalize the drag coefficients.
+        clamp : bool, optional
+            If True, the simulation will clamp the deployment level to 0 or 1 if
+            the deployment level is out of bounds. If False, the simulation will
+            not clamp the deployment level and will instead raise a warning if
+            the deployment level is out of bounds.
+        override_rocket_drag : bool, optional
+            If False, the air brakes drag coefficient will be added to the
+            rocket's power off drag coefficient curve. If True, during the
+            simulation, the rocket's power off drag will be ignored and the air
+            brakes drag coefficient will be used for the entire rocket instead.
         deployment_level : tuple, list, int, float, optional
             Initial deployment level, ranging from 0 to 1.
         """

rocketpy/stochastic/stochastic_rocket.py

@@ -398,7 +398,15 @@ def add_air_brakes(
         air_brakes,
         controller
     ):
-        
+        """Adds an air brake to the stochastic rocket.
+
+        Parameters
+        ----------
+        air_brakes : StochasticAirBrakes or Airbrakes
+            The air brake to be added to the stochastic rocket.
+        controller : _Controller
+            Deterministic air brake controller.
+        """
         # checks if input is a StochasticAirbrakes type
         if not isinstance(air_brakes, (AirBrakes, StochasticAirBrakes)):
             raise TypeError(