Add default_turbulence (#61)

- [x] Add functions get_default_turbulence() and set_default_turbulence()
- [x] Add default_turbulence to gui.yaml file
- [x] Add support for Kaimon.jl in run_julia and in copilot_instructions.md
- [x] Add the menu entry set_turbulence to menu.jl
- [x] run_julia uses `Revise` now by default; Revise must be installed globally
- [x] the example parking_wind_dir and all other relevant examples using the default turbulence now
- [x] the install script now installs Revise globally
- [x] add script install_kaimon_database

Author: ufechner7

.github/copilot-instructions.md

@@ -61,6 +61,12 @@ include("test/runtests.jl")
 ```
 Tests include Aqua.jl quality checks.
 
+## Documentation
+To test if building the docs works locally, use:
+```
+using Pkg; Pkg.activate("docs"); include("docs/make.jl"); Pkg.activate(".")
+```
+
 ## System Image
 A precompiled system image can be built with:
 ```bash

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## Unreleased
+### Added
+- the functions set_default_turbulence and get_default_turbulence
+- the menu entry set_turbulence
+- run_julia uses `Revise` now by default; Revise must be installed globally
+
+### Changed
+- the example parking_wind_dir is using the default turbulence now
+- the install script now installs Revise globally
+
 ## KiteControllers v0.2.24 - 2026-05-02
 ### Added
 - the function `menu_learning()` and the script `menu_learning.jl`

bin/install

@@ -74,6 +74,22 @@ juliaup default "${_desired_julia}"
 echo "Julia ${_desired_julia} is now the default."
 echo
 
+echo "Checking whether Revise is installed in the global Julia environment..."
+julia -e '
+using Pkg
+
+shared_env = Base.load_path_expand("@v#.#")
+Pkg.activate(shared_env; io=devnull)
+
+if haskey(Pkg.project().dependencies, "Revise")
+    println("Revise is already installed in $(shared_env).")
+else
+    println("Installing Revise in $(shared_env)...")
+    Pkg.add("Revise")
+end
+'
+echo
+
 # Detect Julia version
 julia_version=$(julia --version | awk '{print($3)}')
 julia_major=${julia_version:0:3}

bin/install_kaimon_database

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# This script starts the Qdrant vector database in a Docker container. It creates a Docker 
+# volume named "qdrant_data" to persist the data and runs the container with the appropriate 
+# port mapping and restart policy.
+
+# It needs to be executed only once. After that, the Qdrant container will automatically 
+# restart on system reboot or if it crashes.
+
+# The data is stored in /var/lib/docker/volumes/qdrant_data/_data/collections
+
+if docker volume inspect qdrant_data &>/dev/null; then
+  echo "Volume 'qdrant_data' already exists, skipping setup."
+  exit 0
+fi
+
+docker volume create qdrant_data
+
+docker run -d \
+  --name qdrant \
+  --restart unless-stopped \
+  -p 6333:6333 \
+  -v qdrant_data:/qdrant/storage \
+  qdrant/qdrant

bin/run_julia

@@ -7,6 +7,17 @@ fi
 export NO_AT_BRIDGE=1
 export JULIA_PKG_SERVER_REGISTRY_PREFERENCE=eager
 
+USE_KAIMON=false
+if command -v ss &> /dev/null; then
+    if ss -ltn '( sport = :2828 )' | grep -q ':2828'; then
+        USE_KAIMON=true
+    fi
+elif command -v lsof &> /dev/null; then
+    if lsof -nP -iTCP:2828 -sTCP:LISTEN &> /dev/null; then
+        USE_KAIMON=true
+    fi
+fi
+
 if [[ "$(uname -s)" == "Darwin" ]]; then
     # Avoid Tk backend issues on macOS (e.g. non-responsive close button in PyPlot windows).
     # Keep user override if MPLBACKEND is already set.
@@ -46,11 +57,6 @@ fi
 if [[ $HOSTNAME == "ufryzen" || $HOSTNAME == "framework" ]]; then
     export NO_MTK=true
 fi
-if [ -d ".git" ]; then
-    branch=$(git rev-parse --abbrev-ref HEAD)
-else
-    branch=""
-fi
 
 script_file=""
 if [[ $# -gt 0 ]]; then
@@ -62,18 +68,24 @@ if [[ $# -gt 0 ]]; then
     fi
 fi
 
+julia_init='using Revise; '
+if [[ "$USE_KAIMON" == "true" ]]; then
+    julia_init+='using Kaimon; Gate.serve(); '
+fi
+julia_init+='using KiteControllers; test_menu() = Base.include(Main, joinpath(pkgdir(KiteControllers), "test", "test_menu.jl")); menu_learning() = Base.include(Main, joinpath(pkgdir(KiteControllers), "examples", "menu_learning.jl"))'
+
 if test -f "bin/kps-image-${julia_major}.so"; then
     echo "Found system image!"
     if [[ -n "$script_file" ]]; then
         PLOT=1 julia -J bin/kps-image-${julia_major}.so -t 1 $GCT --project "$script_file" "$@"
     else
-        PLOT=1 julia -J bin/kps-image-${julia_major}.so -t 1 $GCT --project -i -e 'using KiteControllers; test_menu() = Base.include(Main, joinpath(pkgdir(KiteControllers), "test", "test_menu.jl")); menu_learning() = Base.include(Main, joinpath(pkgdir(KiteControllers), "examples", "menu_learning.jl"))'
+        PLOT=1 julia -J bin/kps-image-${julia_major}.so -t 1 $GCT --project -i -e "$julia_init"
     fi
 else
     if [[ -n "$script_file" ]]; then
         PLOT=1 julia --project -t 1 $GCT "$script_file" "$@"
     else
-        PLOT=1 julia --project -t 1 $GCT -i -e 'using KiteControllers; test_menu() = Base.include(Main, joinpath(pkgdir(KiteControllers), "test", "test_menu.jl")); menu_learning() = Base.include(Main, joinpath(pkgdir(KiteControllers), "examples", "menu_learning.jl"))'
+        PLOT=1 julia --project -t 1 $GCT -i -e "$julia_init"
     fi
     # julia --project
 fi

data/gui.yaml.default

@@ -1,3 +1,4 @@
 gui:
-    project: hydra20_600.yml         # or hydra20_600.yml
+    project: hydra20_600.yml             # or hydra20_600.yml
+    default_turbulence: 0.0              # default turbulence level for simulations, between 0.0 and 1.0
 

docs/make.jl

@@ -13,6 +13,7 @@ makedocs(
         "Types"     => "types.md",
         "Functions" => "functions.md",
         "Examples"  => "examples.md",
+        "Projects and Turbulence" => "projects.md",
         "Learning Control"  => "learning.md",
     ],
     checkdocs = :exports,

docs/src/functions.md

@@ -21,6 +21,9 @@ get_depower(::SystemStateControl)
 
 ```@docs
 read_project()
+get_default_turbulence()
+get_use_turbulence
+set_default_turbulence
 ```
 
 ## FlightPathPlanner