GitHub

KiteViewers.jl

This package provides different kinds of 2D and 3D viewers for kite power systems.

It is part of Julia Kite Power Tools, which consists of the following packages:

Kite Power Tools

What to install

If you want to run simulations and see the results in 3D, please install the meta package KiteSimulators. If you just want to replay log files or implement a real-time viewer for a system outside of Julia, this package will be sufficient. When you have KiteSimulators installed, please replace any statement using KiteViewers in the examples with using KiteSimulators.

Installation

Download and install Julia 1.11 or later, if you haven't already.

If you don't have a project yet, create one with:

mkdir MyProject
cd MyProject
julia --project="."

and then add the package KiteViewers to your project by executing:

using Pkg
pkg"add KiteViewers"

You can install the examples with:

using KiteViewers
KiteViewers.install_examples()

and get a menu with the examples by typing:

menu()

You can run the unit tests with the command:

using Pkg
pkg"test KiteViewers"

This package should work on Linux, Windows and Mac. If you find a bug, please file an issue.

Examples

using KiteViewers
viewer = Viewer3D(true);

After some time a window with the 3D view of a kite power system should pop up. If you keep the window open and execute the following code:

using KiteUtils
segments = 6
state = demo_state(segments + 1)
update_system(viewer, state)

you should see a kite on a tether.

The same example, but using the 4 point kite model:

using KiteViewers, KiteUtils
viewer = Viewer3D(true);
segments = 6
state = demo_state_4p(segments + 1)
update_system(viewer, state, kite_scale=0.25)

You can find more examples in the folder examples.

Advanced usage

For more examples see: KiteSimulators

See also