{"id":25977073,"url":"https://github.com/aenarete/kitepodmodels.jl","last_synced_at":"2026-02-24T20:43:29.645Z","repository":{"id":37279844,"uuid":"469710396","full_name":"aenarete/KitePodModels.jl","owner":"aenarete","description":"Models of control pods of remote controlled kites","archived":false,"fork":false,"pushed_at":"2024-03-25T16:48:17.000Z","size":525,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-04-25T20:03:54.074Z","etag":null,"topics":["airborne","control","kite","wind"],"latest_commit_sha":null,"homepage":"https://aenarete.github.io/KitePodModels.jl/","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"ufechner7/KitePodSimulator.jl","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aenarete.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-14T11:50:01.000Z","updated_at":"2024-07-24T19:43:20.459Z","dependencies_parsed_at":"2024-03-25T18:06:22.267Z","dependency_job_id":null,"html_url":"https://github.com/aenarete/KitePodModels.jl","commit_stats":{"total_commits":75,"total_committers":2,"mean_commits":37.5,"dds":"0.10666666666666669","last_synced_commit":"97cc91ceac904f017728f3165c195e786667c63b"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aenarete%2FKitePodModels.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aenarete%2FKitePodModels.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aenarete%2FKitePodModels.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aenarete%2FKitePodModels.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aenarete","download_url":"https://codeload.github.com/aenarete/KitePodModels.jl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241966442,"owners_count":20050316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airborne","control","kite","wind"],"created_at":"2025-03-05T04:30:14.942Z","updated_at":"2026-02-24T20:43:29.616Z","avatar_url":"https://github.com/aenarete.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KitePodModels\n\n[![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://aenarete.github.io/KitePodModels.jl/stable)\n[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://aenarete.github.io/KitePodModels.jl/dev)\n[![Build Status](https://github.com/aenarete/KitePodModels.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/aenarete/KitePodModels.jl/actions/workflows/CI.yml?query=branch%3Amain)\n[![Coverage](https://codecov.io/gh/aenarete/KitePodModels.jl/branch/main/graph/badge.svg)](https://codecov.io/gh/aenarete/KitePodModels.jl)\n\nModels of control pods for kite power systems.\n\nThis package is part of Julia Kite Power Tools, which consist of the following packages:\n\u003cp align=\"center\"\u003e\u003cimg src=\"./docs/kite_power_tools.png\" width=\"500\" /\u003e\u003c/p\u003e\n\n## Background\nA kite pod or kite control unit consists of one or two electric miniature winches, that pull on two or three lines (attached to the kite) and allow to steer the kite and to change the angle of attack and thus the lift.\n\nThis software acts as controller: It has two inputs, the set values, and two outputs, the actual values.\n\nTwo P controllers are used. \n\nThe geometric nonlinearity due to the change of the effective drum diameter of the drum with the depower tape is taken into account.\n\n## Installation\nFollow the instructions at [Installation of Julia](https://ufechner7.github.io/2024/08/09/installing-julia-with-juliaup.html), using Julia 1.10 or later. Then you can add `KitePodModels` from  Julia's package manager, by typing \n```julia\nusing Pkg\npkg\"add KitePodModels\"\n``` \nat the Julia prompt.\n\n## Testing\nYou can run the unit test suite with the following command:\n```julia\npkg\"test KitePodModels\"\n```\n\n## Provides\n- functions to initialize the model, update the set values and read the actual values\n- a function KitePodModels.on_timer() that needs to be called once per time step\n- a function to convert the actual depower value into change of angle of attack\n\n### Configuration\nThere are two types of kite control unit models, called KCU1 and KCU2. \nFor KCU1 the following parameters are used:\n```yaml\nkcu:\n    kcu_model: \"KCU1\"            # name of the kite control unit model, KCU1 or KCU2\n    kcu_mass: 8.4                # mass of the kite control unit                      [kg]\n    power2steer_dist: 1.3        #                                                     [m]\n    depower_drum_diameter: 0.069 #                                                     [m]\n    tape_thickness: 0.0006       #                                                     [m]\n    v_depower: 0.075 # max velocity of depowering in units per second (full range: 1 unit)\n    v_steering: 0.2  # max velocity of steering in units per second  (full range: 2 units)\n    depower_gain: 3.0            # 3.0 means: more than 33% error -\u003e full speed\n    steering_gain: 3.0\n\n```\n\nFor KCU2 the following parameters are used:\n```yaml\nkcu:\n    kcu_model: \"KCU2\"              # name of the kite control unit model, KCU1 or KCU2\n    kcu_mass: 15.0                 # mass of the kite control unit                    [kg]\n    kcu_diameter: 0.4              # diameter of the KCU for drag calculation          [m]\n    depower_zero: 38.0             # depower setting for alpha_zero = 0                [%]\n    degrees_per_percent_power: 1.0 # linear approximation                      [degrees/%]\n    v_depower: 0.053  # max velocity of depowering in units per second (full range: 1 unit)\n    v_steering: 0.212 # max velocity of steering in units per second (full range: 2 units)\n    depower_gain: 3.0              # 3.0 means: more than 33% error -\u003e full speed\n    steering_gain: 3.0\n```\n\n## Nomenclature\n- depower: a value between 0% and 100%; zero corresponds to the power line being fully reeled-in\n- rel_depower: a value between 0.0 and 1.0\n- depower_offset: 23.6   # at rel_depower=0.236 the kite is fully powered [%]\n- alpha_depower: the change of the angle between the kite and the last tether segment [rad]\n\n## Testing\nPlease, have a look at the four examples in the examples folder.\n\n## Licence\nThis project is licensed under the MIT License. Please see the below WAIVER in association with the license.\n\n## WAIVER\nTechnische Universiteit Delft hereby disclaims all copyright interest in the package “KitePodModels.jl” (models for airborne wind energy systems) written by the Author(s).\n\n## Related\n- The meta-package  [KiteSimulators](https://github.com/aenarete/KiteSimulators.jl)\n- the package [KiteUtils](https://github.com/ufechner7/KiteUtils.jl)\n- the packages [KiteModels](https://github.com/ufechner7/KiteModels.jl) and [WinchModels](https://github.com/aenarete/WinchModels.jl) and [AtmosphericModels](https://github.com/aenarete/AtmosphericModels.jl)\n- the packages [KiteControllers](https://github.com/aenarete/KiteControllers.jl) and[KiteViewers](https://github.com/aenarete/KiteViewers.jl)\n\n**Documentation** [Stable Version](https://aenarete.github.io/KitePodModels.jl/stable) [Development Version](https://aenarete.github.io/KitePodModels.jl/dev)\n\nAuthor: Uwe Fechner (uwe.fechner.msc@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faenarete%2Fkitepodmodels.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faenarete%2Fkitepodmodels.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faenarete%2Fkitepodmodels.jl/lists"}