KiteModels.jl

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

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)

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)

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

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

KiteModels v0.6.3

Diff since v0.6.2

Changed

• the function copy_examples() copies now all examples
• updated the documentation
• improved the scripts in the bin folder, not relevant for most users

KiteModels v0.6.2

Diff since v0.6.1

Changed

• renamed the example simulate.jl to simulate_simple.jl
• renamed the example simulate_ii.jl to simulate_steering.jl
• add the script menu.jl that provides a menu with all the examples
• bump ControlPlots to 0.1.4
• bump KiteUtils to 0.7.4

KiteModels v0.6.1

Diff since v0.6.0

KiteModels v0.6.0

Diff since v0.5.16

Changed

• use new version of Winchmodels.jl which provides an additional, torque controlled winch
• add many new winch parameters to settings.jl
• BREAKING change: rename v_ro to set_speed in function step()

Merged pull requests:

• Add torque controlled winch model (#59) (@ufechner7)

KiteModels v0.5.16

Diff since v0.5.15

KiteModels v0.5.16 - 2024-06-25

Changed

• bump KiteUtils to version 0.6.16
• bump ControlPlots to version 0.0.12

KiteModels v0.5.15

Diff since v0.5.14

Changed

• bump KiteUtils to version 0.6.12
• drop support for Julia 1.9

Merged pull requests:

• Bump julia-actions/cache from 1 to 2 (#54) (@dependabot[bot])

KiteModels v0.5.14

Diff since v0.5.13

Changed

• replace Plots with ControlPlots in the examples

Merged pull requests:

• Replace Plots.jl with ControlPlots.jl (#52) (@ufechner7)

KiteModels v0.5.13

Diff since v0.5.12

Changed

• use rel_compr_stiffness and rel_damping from settings.yaml

KiteModels v0.5.12

Diff since v0.5.11

Changed

• update KiteUtils to v0.6.7
• update Documenter to v1.0

Added

• add type KPS4_3L, which is now only a copy of KPS4, but shall implement a kite with the steering
  lines going to the ground

Merged pull requests:

• Add 3 line kite power system model (#50) (@ufechner7)

KiteModels v0.5.11

Diff since v0.5.10

Added

• document the support for the DImplicitEuler solver, which is not very accurate,
  but because it is well known it can serve as reference
• support changing max_order for the DFBDF
• further reduced the memory usage

KiteModels v0.5.10

Diff since v0.5.9

Improvements

• it is now possible (and suggested) to use the DAE solver DFBDF.

This requires to add the following line to the settings.yaml file: solver: "DFBDF"

The new solver is much faster, has a lot less memory allocations and is also much more stable in difficult situations.

Merged pull requests:

• New solver (#48) (@ufechner7)

KiteModels v0.5.9

Diff since v0.5.8

KiteModels v0.5.8

Diff since v0.5.7

Improvements

• add non-allocating function update_sys_state!()

KiteModels v0.5.7

Diff since v0.5.6

Improvements

• improve performance by 10%

KiteModels v0.5.6

Diff since v0.5.5

Fixes:

• fix the method clear!() which failed for models with less than 6 tether segments