v0.6.13

KiteModels v0.6.13

Diff since v0.6.12

Changed

• update the fields set_steering, bearing and attractor of the SysState struct
  in the function update_sys_state!
• add the parameters bearing and attractor to the function next_step! for logging

Fixed

• fix #88: the function init_sim!() has the new parameter upwind_dir to define the
  initial wind direction

Merged pull requests:

• Bump codecov/codecov-action from 4 to 5 (#98) (@dependabot[bot])

Closed issues:

• KPS4 Does not take into account the initial wind direction (#88)
• Add tests for creating a SysState from KPS3 (#97)

v0.6.12

KiteModels v0.6.12

Diff since v0.6.11

Changed

• update the fields set_torque, set_force, set_speed, alpha3, alpha4, roll, pitch, yaw
  of the SysState struct in the function update_sys_state!
• add the parameter set_force to the function next_step! for logging
• the four point kite model KPS4 was extended to include aerodynamic damping of pitch oscillations;
  for this purpose, the parameters cmq and cord_length must be defined in settings.yaml
• the four point kite model KPS4 was extended to include the impact of the deformation of the
  kite on the turn rate; for this, the parameter smc must be defined in settings.yaml
• improve examples
• add the packages JLD2 and Colors to the system image

Added

• add examples calc_spectrum.jl and plot_spectrum to plot the eigenfrequencies of the system
• the script calculate_rotational_inertia.jl for calculating the inertia matrix of the kite
• function menu2() which displays a menu with scripts for model verification

Merged pull requests:

• Fix/improve for mpc (#90) (@1-Bart-1)
• Fix the calc_acc method definition warning (#93) (@1-Bart-1)
• add rotational intertia calculation script (#94) (@dvanwolffelaar)

Closed issues:

• Add Cmq, the pitch rate dependand contribution ot the pitching moment to the model (#91)
• Add a script that calculates the rotational inertia around each of the three axis (#92)
• Add steering dependant turning moment coefficient (#96)

v0.6.11

KiteModels v0.6.11

Diff since v0.6.10

Fixed

• fixed bug in spring_forces(), it used 4000N hardcoded max force

Changed

• bump KiteUtils to 0.9.0
• the fields AoA, CL2, CD2 and the vectors v_wind_gnd, v_wind_200m and v_wind_kite are now updated
  when converting KPS3 or KPS4 to SysState

Added

• add example test_steady_state.jl

Merged pull requests:

• Update new fields in SysState (#89) (@ufechner7)

v0.6.10

KiteModels v0.6.10

Diff since v0.6.9

KiteModels v0.6.10 2024-11-01

• fixed the installation of the examples
• updated the documentation
• the package Rotations is now re-exported by KiteModels
• reduce number of dependencies of the examples

v0.6.9

KiteModels v0.6.9

Diff since v0.6.8

• added tests for calc_azimuth(s::AKM), the azimuth in wind reference frame
• re-enable logging of the angles of attack of the three plates
• steering_test_4p.jl now calculates both c1 and c2 of the turn-rate law
• the environment variable NO_MTK disables the pre-compilation of the KPS4_3L model
  to save time during development
• the script menu2.jl for model verification was added

Merged pull requests:

• azimuth wind tests (#86) (@dvanwolffelaar)
• remove naca.dat (#87) (@1-Bart-1)

v0.6.8

KiteModels v0.6.8

Diff since v0.6.7

Changed

• the sign of the steering signal was changed. Now, a positive steering signal causes a positive turn rate.
  The turn rate is the derivative of the heading angle.
• all orientation tests pass now (calculation of roll, pitch, yaw, azimuth_north, elevation, heading)
• add example steering_test_1p.jl
• improve steering_test_4p.jl, use fully powered kite now
• the logged steering signal is now divided by set.cs_4p, because the new version of KitePodModels.jl multiplies the steering value with this constant
• update documentation regarding steering and heading

v0.6.7

KiteModels v0.6.7

Diff since v0.6.6

Changed

• renamed test_init.jl to test_init_4p.jl
• by default, azimuth in wind reference frame is now used
• the orientation is now represented in NED reference frame
• the method calc_heading has two new, optional parameters: neg_azimuth=false, one_point=false
• the definition of heading and azimuth has changed, which will require adaptions in the controller

Added

• example plot_side_cl.jl
• example plot_cl_cd_plate.jl
• example steering_test.jl
• example test_init_1p.jl
• the test script test_orientation.jl was contributed by Daan van Wolffelaar; currently, some of these tests are still broken (error of about 2%)
• XFoil for calculating the polars

Fixed

• many of the examples; all examples of menu.jl now work

Merged pull requests:

• Feat/xfoil polars (#76) (@1-Bart-1)
• Stable branch, updated dependencies and examples (#79) (@ufechner7)
• Fix the orientation of the kite in KiteViewer (#80) (@ufechner7)
• Add unit tests for the orientation and heading (#81) (@dvanwolffelaar)
• Switch azimuth tests to use azimuth north (#83) (@dvanwolffelaar)
• Use azimuth in wind reference frame (#84) (@ufechner7)
• Fix kps3 (#85) (@ufechner7)

Closed issues:

• The function next_step! is using a confusing definition for the wind direction (#67)
• Use Xfoil polars to calculate c_l, c_d and steering tether forces (#72)
• Add test case for steering sensitivity (#74)
• Fix calc_heading (#77)
• Implement function q2qviewer (#82)

v0.6.6

KiteModels v0.6.6

Diff since v0.6.5

Changed

• the method next_step! uses now upwind_dir as parameter and not longer wind_dir
• install matplotlib if it is not already installed after user confirmation in a Julia specific environment
• replaced OrdinaryDiffEq with the three packages OrdinaryDiffEqCore, OrdinaryDiffEqBDF
  and OrdinaryDiffEqSDIRK. This should help to reduce the pre-compilation time.
• set the parameter delta in the examples
• always specify the system.yaml file to use in the examples, always use load_settings instead of se.
  This ensures that the settings are always freshly loaded from the file when the script is launched, so any changes
  to the settings become immediately effective.
• the KPS4_3L model was replaced by the pure ModelingToolkit (MTK) based version. This allows not only a much faster simulation, but the results are also much more accurate.

Merged pull requests:

• fix #65, use_max steering from configuration file (#66) (@ufechner7)
• Feat/find mtk steady state (#69) (@1-Bart-1)
• remove examples and change example name (#70) (@1-Bart-1)

Closed issues:

• Add drag of the KCU (#62)
• Use max_steering from configuration file (#65)

v0.6.5

KiteModels v0.6.5

Diff since v0.6.4

Changed

• bump KiteUtils to 0.7.7
• add new examples to menu
• major change to the function that finds the initial equilibrium; the function init_sim! has the new
  parameter delta which should be in the range of 0.01 to 0.03.
• better error message if init_sim!, but no exception any more. I just returns nothing.
• remove dependency StatProfilerHTML

Added

• add KCU drag, based on kcu_diameter and cd_kcu
• add function bridle_length (not exported)
• unit tests for the KPS3_3L model, based on ModelingToolkit
• script examples/plot_cl_cd.jl
• script examples/plot_cl_cd_plate.jl
• script torque_controlled_mtk.jl

Fixed

• correct tether drag based on l_bridle; if the kite has more than 7 bridle lines l_bridle must be larger than bridle_length(se)

Merged pull requests:

• Feat/faster tether (#63) (@1-Bart-1)
• Add mtk tests (#64) (@1-Bart-1)

To install, follow these instructions

v0.6.4

KiteModels v0.6.4

Diff since v0.6.3

Added

• a new kite model, KPS3_3L was contributed by Bart van de Lint. It uses three lines to the ground and three winches for steering a ram-air foil kite.
• caching for the initial equilibrium
• function KiteModels.install_examples() that copies the examples, the data folder and installs the required extra packages
• log alpha2, alpha3, alpha4; they must never become negative

Fixed

• the calculation of the call-backs per time step was fixed in all examples and the tests

Merged pull requests:

• Add a 3 line kite model. (#60) (@1-Bart-1)
• Add kps4 3 line example (#61) (@1-Bart-1)

Closed issues:

• Three-wire-kite (#45)

To install, follow these instructions