{"id":16608400,"url":"https://github.com/ufechner7/kiteviewer","last_synced_at":"2026-03-06T08:02:41.204Z","repository":{"id":45136463,"uuid":"323230078","full_name":"ufechner7/KiteViewer","owner":"ufechner7","description":"3D viewer and simulator for airborne wind energy systems","archived":false,"fork":false,"pushed_at":"2022-05-26T07:53:35.000Z","size":4872,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-17T13:12:27.227Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ufechner7.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}},"created_at":"2020-12-21T04:28:03.000Z","updated_at":"2024-12-09T15:10:11.000Z","dependencies_parsed_at":"2022-09-24T20:22:27.869Z","dependency_job_id":null,"html_url":"https://github.com/ufechner7/KiteViewer","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ufechner7/KiteViewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufechner7%2FKiteViewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufechner7%2FKiteViewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufechner7%2FKiteViewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufechner7%2FKiteViewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ufechner7","download_url":"https://codeload.github.com/ufechner7/KiteViewer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ufechner7%2FKiteViewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30166867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-10-12T01:26:05.101Z","updated_at":"2026-03-06T08:02:41.155Z","avatar_url":"https://github.com/ufechner7.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KiteViewer\n3D viewer and simulator for to visualize the flight path and power production of tethered wind drones and kites for airborne wind energy applications\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"./doc/KiteViewer.png\" /\u003e\u003c/p\u003e\n\n## Requirements\n\nJulia 1.6.x or 1.7.x must be installed. You can download it at https://www.julialang.org/\n\nOn Linux or MAC you can install the latest Julia version with the following command:\n```\nbash -ci \"$(curl -fsSL https://raw.githubusercontent.com/abelsiqueira/jill/master/jill.sh)\"\n```\n\nAt least a dual core PC or MAC with 4 GB RAM (min. 2 GB) is required. \nOpenGL, version 3.3 or higher must be working.\n\nIt should work on Windows, Linux and Mac, but until now only tested on Linux\n(Ubuntu 18.04 and Ubuntu 20.04) and Windows 10.\n\nIf you are using Windows, read [Windows.md](./doc/Windows.md) first.\n\n## Installation\n\nAfter installing julia, create a work folder:\n\n```Bash\ncd\nmkdir repos\ncd repos\n```\nCheck out the source code:\n```Bash\ngit clone https://github.com/ufechner7/KiteViewer.git\ncd KiteViewer\n```\n\nCreate a pre-compiled system image (needed for good performance):\n```\n./create_sys_image.sh\n```\nThis takes about 10 to 15 minutes and needs to be done at least once, but also after important package updates because it freezes the package versions.\n\n\nRun the program and show the GUI:\n\n```Julia\n./run_julia.sh\ninclude(\"src/KiteViewer.jl\")\nmain()\n```\n\nClick on PLAY to play the log file (and wait until the flight data import is finished when you do it the first time.) Use the right mouse button to zoom and the left mouse button to pan the 3D view. \n\n## Import flight data\nWhen you run KiteViewer for the first time the flight data is imported\nand converted to the .arrow format.\n\nWith the following commands you can import csv flight data manually:\n```Julia\n./run_julia.sh\ninclude(\"src/Importer.jl\")\n```\nIf you have your own .csv log files you need to extend the importer\nfor your data format.\n\n## Run the one point kite model\nTo start the simulation, click the button \"START\". To steer the kite, use the right and left cursor keys.\nFor a first test, after pressing the START button press the right cursor twice and wait. If you started the main function\nfrom a Julia console you can see the setting of the steering as numbers in the console.\n\nTo test the 4-point simulator and steer the kite with a joystick, look at [KiteSimulators](https://github.com/aenarete/KiteSimulators.jl) .\n\n## Hacking the code\nUse the package [Revise](https://timholy.github.io/Revise.jl/stable/) to speed up testing of code changes:\n```Julia\n./run_julia.sh\nincludet(\"src/KiteViewer.jl\")\n```\nPlease don't forget the t at end of the includet command.\n\nNow make changes to KiteViewer.jl and then execute\n```\nmain()\n```\nRevise is watching the file KiteViewer.jl, and each time a changed version is saved any changed function is recompiled, but only the function that was changed and nothing else, therefore this is much faster than restarting Julia after a change.\n\n## Reducing the startup time\nOn Linux it can help to activate the \"performance\" governor. This can be done with the command: ``` sudo ./performance.sh```\n\nIf you use the script ./run_julia.sh the system image with the precompiled packages will be used.\nIf you do not want to make changes to the code you can also run the app by typing ```./kiteviewer.sh```.\n\nMore detailed explaination here: [SystemImage.md](./doc/SystemImage.md)\n(Tested on Windows10 and Linux.)\n\n## Tests of the Simulator\nThe simulator is tested against the results of the paper [Dynamic Model of a Pumping Kite Power System](http://arxiv.org/abs/1406.6218). For details of the tests see:  [Tests.md](./doc/Tests.md)\n\n## NEWS\nI am currently moving the code of this repository into a set of Julia packages, called \"Julia Kite Power Tools\". Advantages:\n- more modular code, use only the packages you need\n- automated unit tests\n- better, auto-generated documentation\n- easier installation, only Julia required, not git any more\n\nThe code for viewing log files will be found in the package KiteViewers, the code for running simulations in the package KiteSimulators.\n\n### Overview Julia Kite Power Tools\n\u003cp align=\"center\"\u003e\u003cimg src=\"./doc/kite_power_tools.png\" width=\"500\" /\u003e\u003c/p\u003e\n\n\n\n## See also\n- [Research Fechner](https://research.tudelft.nl/en/publications/?search=Uwe+Fechner\u0026pageSize=50\u0026ordering=rating\u0026descending=true) for the scientic background of this code\n- The metapackage [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 [KitePodModels](https://github.com/aenarete/KitePodModels.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\nAuthor: Uwe Fechner (uwe.fechner.msc@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fufechner7%2Fkiteviewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fufechner7%2Fkiteviewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fufechner7%2Fkiteviewer/lists"}