FIX documentation issues (#886)

Author: Gui-FernandesBR

docs/user/environment/1-atm-models/standard_atmosphere.rst

@@ -22,8 +22,7 @@ Other profiles can be derived from it, however, winds are automatically set to
 
     env.plots.atmospheric_model()
 
-.. skip one line with |
-| 
+|
 
 The International Standard Atmosphere can also be reset at any time by using the
 :meth:`rocketpy.Environment.set_atmospheric_model` method. For example:

docs/user/first_simulation.rst

@@ -90,6 +90,7 @@ regarding the launch site:
 
 | This roughly corresponds to the location of Spaceport America, New Mexico.
 
+
 Next, we need to specify the atmospheric model to be used. In this example,
 we will get GFS forecasts data from tomorrow.
 
@@ -110,6 +111,7 @@ of tomorrow:
 
 | Now we set the atmospheric model to be used:
 
+
 .. jupyter-execute::
 
     env.set_atmospheric_model(type="Forecast", file="GFS")
@@ -189,6 +191,7 @@ to specify several parameters:
 
 | We can see its characteristics by calling the info method:
 
+
 .. jupyter-execute::
 
     Pro75M1670.info()
@@ -637,8 +640,9 @@ and the rocket Mach number (see :meth:`rocketpy.Flight.mach_number`) to the file
     )
 
 | As you can see, the first argument is the file name to be created. The following
-arguments are the attributes to be exported. We can check the file by reading it
-with :func:`pandas.read_csv`:
+  arguments are the attributes to be exported. We can check the file by reading it
+  with :func:`pandas.read_csv`:
+
 
 .. jupyter-execute::
 
@@ -647,8 +651,9 @@ with :func:`pandas.read_csv`:
     pd.read_csv("calisto_flight_data.csv")
 
 | The file header specifies the meaning of each column. The time samples are
-obtained from the simulation solver steps. To export the data at a different
-sampling rate, use the ``time_step`` argument:
+  obtained from the simulation solver steps. To export the data at a different
+  sampling rate, use the ``time_step`` argument:
+
 
 .. jupyter-execute::
 

docs/user/three_dof_simulation.rst

@@ -67,7 +67,7 @@ The environment setup is identical to standard simulations:
         elevation=1400
     )
 
-    env.set_atmospheric_model(type="StandardAtmosphere")
+    env.set_atmospheric_model(type="standard_atmosphere")
 
 Step 2: Create a PointMassMotor
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -123,7 +123,7 @@ Or use a custom thrust function:
 .. seealso::
 
     For detailed information about :class:`rocketpy.PointMassMotor` parameters,
-    see the :ref:`API reference <api_reference>`.
+    see the :class:`rocketpy.PointMassMotor` class documentation.
 
 Step 3: Create a PointMassRocket
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -279,6 +279,14 @@ Export trajectory data to CSV:
         "vz",
     )
 
+
+.. jupyter-execute::
+    :hide-code:
+
+    import os
+    os.remove("trajectory_3dof.csv")
+
+
 Complete Example
 ----------------
 
@@ -294,7 +302,7 @@ Here's a complete 3-DOF simulation from start to finish:
         longitude=-8.2889,
         elevation=100
     )
-    env.set_atmospheric_model(type="StandardAtmosphere")
+    env.set_atmospheric_model(type="standard_atmosphere")
 
     # 2. Motor
     motor = PointMassMotor(
@@ -412,7 +420,6 @@ See Also
 - :ref:`First Simulation <firstsimulation>` - Standard 6-DOF simulation tutorial
 - :ref:`Rocket Class Usage <rocketusage>` - Full rocket modeling capabilities
 - :ref:`Flight Class Usage <flightusage>` - Complete flight simulation options
-- :doc:`../examples/3_dof_trial_sim` - Jupyter notebook example
 
 Further Reading
 ---------------

rocketpy/rocket/parachute.py

@@ -25,27 +25,27 @@ class Parachute:
         system. It can be one of the following:
 
         - A callable function that takes three arguments:
-        1. Freestream pressure in pascals.
-        2. Height in meters above ground level.
-        3. The state vector of the simulation, which is defined as:
+          1. Freestream pressure in pascals.
+          2. Height in meters above ground level.
+          3. The state vector of the simulation, which is defined as:
 
-           `[x, y, z, vx, vy, vz, e0, e1, e2, e3, wx, wy, wz]`.
+             `[x, y, z, vx, vy, vz, e0, e1, e2, e3, wx, wy, wz]`.
 
-        4. A list of sensors that are attached to the rocket. The most recent
-           measurements of the sensors are provided with the
-           ``sensor.measurement`` attribute. The sensors are listed in the same
-           order as they are added to the rocket.
+          4. A list of sensors that are attached to the rocket. The most recent
+             measurements of the sensors are provided with the
+             ``sensor.measurement`` attribute. The sensors are listed in the same
+             order as they are added to the rocket.
 
-        The function should return ``True`` if the parachute ejection system
-        should be triggered and False otherwise. The function will be called
-        according to the specified sampling rate.
+          The function should return ``True`` if the parachute ejection system
+          should be triggered and False otherwise. The function will be called
+          according to the specified sampling rate.
 
         - A float value, representing an absolute height in meters. In this
-        case, the parachute will be ejected when the rocket reaches this height
-        above ground level.
+          case, the parachute will be ejected when the rocket reaches this height
+          above ground level.
 
         - The string "apogee" which triggers the parachute at apogee, i.e.,
-        when the rocket reaches its highest point and starts descending.
+          when the rocket reaches its highest point and starts descending.
 
 
     Parachute.triggerfunc : function

rocketpy/rocket/rocket.py

@@ -1667,12 +1667,11 @@ def add_air_brakes(
             6. `interactive_objects` (list): A list containing the objects that
                the controller function can interact with. The objects are
                listed in the same order as they are provided in the
-               `interactive_objects`
+               `interactive_objects` argument.
             7. `sensors` (list): A list of sensors that are attached to the
-                rocket. The most recent measurements of the sensors are provided
-                with the ``sensor.measurement`` attribute. The sensors are
-                listed in the same order as they are added to the rocket
-               ``interactive_objects``
+               rocket. The most recent measurements of the sensors are provided
+               with the ``sensor.measurement`` attribute. The sensors are
+               listed in the same order as they are added to the rocket.
 
             This function will be called during the simulation at the specified
             sampling rate. The function should evaluate and change the observed

rocketpy/tools.py

@@ -1312,7 +1312,7 @@ def find_obj_from_hash(obj, hash_, depth_limit=None):
     Returns
     -------
     object
-        The object whose '__rpy_hash' matches hash_, or None if not found.
+        The object whose '__rpy_hash' matches ``hash_``, or None if not found.
     """
 
     stack = [(obj, 0)]