Merge branch 'develop' into 'documentation/webpage-content'

# Conflicts:
#   .gitlab-ci.yml

.gitlab-ci.yml

@@ -30,6 +30,26 @@ clone:
   # Install necessary packages, including git, doxygen, and other dependencies
     - apk update && apk --no-cache add git doxygen graphviz ttf-freefont texmf-dist texmf-dist-latexextra texlive texlive-dvi
   script:
+    # clone repos
+    - git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@git.rwth-aachen.de/unicado/aircraft-design
+    - cd aircraft-design
+    - git clone --recurse-submodules https://gitlab-ci-token:${CI_JOB_TOKEN}@git.rwth-aachen.de/unicado/libraries libs/
+    # create aircraft design documentation
+    - cd propulsion_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../wing_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../empennage_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../ecological_assessment/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../cost_estimation/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../fuselage_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../initial_sizing/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../landing_gear_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../systems_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../tank_design/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../weight_and_balance_analysis/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    # create libraries documentation
+    - cd ../../libs/aircraftGeometry2/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd ../../engine/doc/ && ( cat Doxyfile ; echo "OUTPUT_DIRECTORY = $CI_PROJECT_DIR/docs/documentation/" ) | doxygen -
+    - cd $CI_PROJECT_DIR
 
   # Clone the aircraft-design repository, including its submodules
     - git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@git.rwth-aachen.de/unicado/aircraft-design

docs/tutorials/changing-design-specifications.md

@@ -67,3 +67,26 @@ Definition of constraints:
 
 Note that the parameters displayed here are relevant to the sizing of the entire aircraft. For module-specific adjustments, the relevant parameters can be found in the configuration file of the corresponding module. For instance, to modify the wing sweep angle, the parameter can be located in the wing_design configuration file under `program_settings/tube_and_wing/cantilever/calculation_methods/sweep`. For further details, consult the documentation of the corresponding module.
 
+## Good to know
+
+Some parameter require more explaination - this section provides the background.
+
+### delta_ISA
+
+As we learned in school, the Earth's atmosphere is not static. Different parameter like air density, pressure, and composition change depending on altitude, latitude, longitude, time of year and day. As an aircraft has to be designed for different routes and missions, but considering detailed atmospheric data would not be feasible, the **ISA** (International Standard Atmosphere) is used as a common reference. This model represents the Earth's atmosphere over altitude and was defined in thr 1920s primarly as pressure alitmeter calibration and later on published in 1975 as ISO2533<sup>[1]</sup>.
+
+Following assumptions are considered:
+
+- Mean sea level conditions of 288.25 K (15°C), 1013.25 hPa pressure, and 1.225 kg/m³ air density, 340.294 m/s speed of sound, 9.81 m/s<sup>2</sup> aacceleration of gravity.
+- A constant lapse rate of -6.5°C/km in the troposphere up to 11 km.
+- Isothermal or different lapse rates for layers above the troposphere.
+
+`delta_ISA` is therefore a mission related parameters which changes the starting point of ISA - commonly adapted over the temperature. The figure shows it examplary for ISA+10.
+
+<figure markdown>
+  ![ISA](../assets/images/tutorials/ISA.svg){width="500"}
+  <figcaption>Altitude over temperature for ISA and ISA+10</figcaption>
+</figure>
+
+---
+<sup>[1]</sup> International Organization for Standardization, Standard Atmosphere, ISO 2533:1975, 1975.<br>
\ No newline at end of file