From 8838c0b8bfdccb1de948815c49c2262848ddf437 Mon Sep 17 00:00:00 2001 From: guisoares9 <55659910+guisoares9@users.noreply.github.com> Date: Mon, 18 Apr 2022 14:18:48 -0300 Subject: [PATCH] docs: CopterHack 2022: Swarm in Blocks (Atena - Grupo SEMEAR) (#398) * final article added but without assets * Assets added * Added information about the Clover Platform and Swarm in Blocks repository to the final article * Minor changes * Minor changes * Minor changes * Update swarm_in_blocks.md * Add video preview image to the repo * Some editing * Reduce image size * List article * Remove unused image * Replace huge animations with external links to save space Co-authored-by: Rafael-Saud <79988012+Rafael-Saud@users.noreply.github.com> Co-authored-by: Oleg Kalachev --- docs/assets/swarm_in_blocks/fpv.jpg | Bin 0 -> 38971 bytes docs/assets/swarm_in_blocks/swarm_preview.png | Bin 0 -> 61145 bytes docs/assets/swarm_in_blocks/vid.jpg | Bin 0 -> 22181 bytes docs/en/SUMMARY.md | 1 + docs/en/copterhack2022.md | 2 +- docs/en/swarm_in_blocks.md | 83 ++++++++++++++++++ docs/ru/copterhack2022.md | 2 +- 7 files changed, 86 insertions(+), 2 deletions(-) create mode 100644 docs/assets/swarm_in_blocks/fpv.jpg create mode 100644 docs/assets/swarm_in_blocks/swarm_preview.png create mode 100644 docs/assets/swarm_in_blocks/vid.jpg create mode 100644 docs/en/swarm_in_blocks.md diff --git a/docs/assets/swarm_in_blocks/fpv.jpg b/docs/assets/swarm_in_blocks/fpv.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5091c3d937127293f9fcc68686eb64a1b0a3fadc GIT binary patch literal 38971 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 F;$Quw*rosg literal 0 HcmV?d00001 diff --git a/docs/assets/swarm_in_blocks/vid.jpg b/docs/assets/swarm_in_blocks/vid.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f66530e595b89ac5229846b43460a105540ad23e GIT binary patch literal 22181 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 literal 0 HcmV?d00001 diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md index bb4d6911..8a2c7557 100644 --- a/docs/en/SUMMARY.md +++ b/docs/en/SUMMARY.md @@ -104,6 +104,7 @@ * [Video contest](video_contest.md) * [Educational contests](educational_contests.md) * [Clover-based projects](projects.md) + * [Swarm-in-blocks](swarm_in_blocks.md) * [Obstacle avoidance using artificial potential fields method](obstacle-avoidance-potential-fields.md) * [The Clover Rescue Project](clover-rescue-team.md) * [Autonomous valet parking drone assistance](djs_phoenix_ikshana.md) diff --git a/docs/en/copterhack2022.md b/docs/en/copterhack2022.md index 9c894cb1..f3d065e1 100644 --- a/docs/en/copterhack2022.md +++ b/docs/en/copterhack2022.md @@ -15,7 +15,7 @@ The proposed projects have to be open-source and be compatible with the Clover q ||🇧🇾 FTL|[Advanced Clover 2](../ru/advanced_clover_simulator.html)|| ||🇷🇺 Stereo|[Neural obstacle avoidance](obstacle-avoidance-potential-fields.md)|| ||🇷🇺 Space clowns|[Copter For Space](../ru/c4s.html)|| -||🇧🇷 Atena - Grupo SEMEAR|[Swarm in Blocks](https://github.com/Grupo-SEMEAR-USP/clover/blob/Swarm_in_Blocks/docs/en/swarm_in_blocks.md)|| +||🇧🇷 Atena - Grupo SEMEAR|[Swarm in Blocks](swarm_in_blocks.md)|| ||🇷🇺 Clover Rescue Team|[Rescue Clover](clover-rescue-team.md)|| ||🇷🇺 CopterCat|[CopterCat](../ru/copter_cat.html)|| ||🇮🇳 DJS Phoenix|[Autonomous valet parking drone assistance](djs_phoenix_ikshana.md)|| diff --git a/docs/en/swarm_in_blocks.md b/docs/en/swarm_in_blocks.md new file mode 100644 index 00000000..c768e481 --- /dev/null +++ b/docs/en/swarm_in_blocks.md @@ -0,0 +1,83 @@ +# Swarm-in-blocks + +## Final Video + + + +## Detailed Gitbook + +**Check our Gitbook, with the detailed information about all that was developed by Atena Team during CopterHack 2022: https://swarm-in-blocks.gitbook.io/swarm-in-blocks/introduction/swarm-in-blocks**. + +>The Clover Platform was forked and adapted to work with swarms. The Swarm in Blocks project is a separated repository with all our swarm manipulation tools for clover. Link of the fork of the Clover Platform: https://github.com/Grupo-SEMEAR-USP/clover . Link of the Swarm in Blocks repository: https://github.com/Grupo-SEMEAR-USP/swarm_in_blocks . + +## Introduction + +Nowadays, swarms of drones are getting more and more applications and being used in several different areas, from agriculture to surveillance, and rescues, but controlling a high amount of drones usually isn't a simple task, demanding a lot of studies and complex software. Swarm in Blocks was born looking to make a high-level interface based on the blocks language, to make simple handling swarms, without requiring advanced knowledge in all the necessary platforms, creating tools to allow a lot of applications based on the user needs and also using the Clover platform, which has a lot of advantages as being complete and intuitive, supporting all the project goals. + + + +## Usability + +### How it works + +The Swarm in Blocks can be programmed either with the blocks interface or directly in Python and we developed three main launch modes, each one focused on a different application of the project, they are: + +- **Planning Mode:** Its main goal is to allow the user to check the drones' layout, save and load formations, before starting the simulator or using real clovers. In order to need less computational power and avoid possible errors during the simulation. +- **Simulation Mode:** In this mode happens the simulation indeed, starting the Gazebo, the necessary ROS nodes and some other tools. It allows applying the developed features, which will be explained ahead and see how they would behave in real life. +- **Navigation Mode:** The last mode will support executing everything developed in real clovers so that it's possible to control a swarm with block programming. The biggest obstacle yet is the practical testing of this mode, due to the financial difficulty to afford a Clover swarm. + +### Blocks Interface + +The entire Swarm in Blocks project was designed so that the user was in an intuitive and comfortable environment within the manipulation of swarms, for this, the existing platform with clover packages was completely rethought and adapted. In our [gitbook](https://app.gitbook.com/s/C9O11TiXK1JPnlrpilLg/usability/blocks-api), we have more details about the front-end design, how the user can interact with it, and achieve our main goal: programming in blocks. + + + +### Features + +Along with the project, we developed some features, that can be used together or independently and also serve as base for the implementation of more specific and advanced innovations. Here are the list and a brief explanation of each tool, to see more details and instructions about their use, check our [gitbook](https://app.gitbook.com/s/C9O11TiXK1JPnlrpilLg/background-theory/system)! + +- **Formations:** There are some types of formation that were developed in order to create figures and other images, for uses in engineering and spectacles. They are: + + - 2D Formations: We made functions to generate some simple geometries, allowing the user to set the number of clovers used and the size of the figure, the geometries options made until now are *circle*, *empty square*, *full square* and *triangle*. + - 3D Formations: Besides the 2D figures, there are also some simple 3D geometries, which are *cube*, *sphere*, and *pyramid*. + - Alphabet: There is also the option to generate letters and words, using our Clover swarm. + - 3D Figures: Lastly, we have the alternative to make other more complex 3D formations, for this we use a library called Open3D that deals with 3D data, allowing the drones to create any 3D image the user inputs since it's in the supported formats. + +- **Transformations:** In addition to creating the formations, it's important to give the option of editing their disposition, so some operations were developed. It also makes possible to execute more complex actions and activities with the Clovers. The transformations operations are: + + - Scale: Changes the distance between the drones, increasing or decreasing the image. + - Translate: All the drones move the same distance in the chosen directions. + - Rotate: The formation rotates around a determined axis. + + + +- **LED effects:** Enjoying the LEDs included in the Clover, we made some functions to apply effects in all the swarm, creating figures and operations with the LEDs too. + + + +- **Swarm Preview:** The main goal of this feature is to help the user to visualize how the swarm will behave in the simulation or real life, without using a lot of computational power and avoiding some problems in the simulation. This way a 2D or 3D image illustrating the drones' disposition can pop up on the screen when using this function. + + + +- **First Person View (FPV):** The FPV node makes it a lot easier to visualize each drone's camera individually and also control each one of them at a time using keyboard bindings. + + + +All these features can be very useful for some applications and also be attractive to arouse the curiosity of the general public. + +## Conclusion + +Over the last months we studied a lot, grew, and surpassed our limits, trying to explore some swarm applications, all to deliver the best possible project: **Swarm in Blocks**. Our motivation was to facilitate such a complex task as the manipulation of swarms of drones, through block programming, and it delighted us a lot and we hope it will fascinate all our users. We tried to resume all the project and its features in this article, but as there are many details and needed explanations, it was made a [gitbook](https://swarm-in-blocks.gitbook.io/swarm-in-blocks/introduction/swarm-in-blocks), to explore them for those who are interested. + +For us, the results achieved were very expressive and positive, however, we believe that there is still room for improvement in the project, both considering the robustness of the swarm and the simplification of the usability of our platform. Improvement in the collision avoidance system, implementation of more formations and tests in real Clovers are some of the points that we hope to develop in future opportunities. + +Finally, we thank the entire COEX team that made it possible for CopterHack 2022 to take place and all the support given during the competition. We are **Atena Team**, creator of the **Swarm in Blocks** platform and we thank you for your attention! + +### The Atena Team members + +- Guilherme Soares Silvestre : [GitHub](https://github.com/guisoares9), [LinkedIn](https://www.linkedin.com/in/guilherme-soares-silvestre-76570118b/) +- Eduardo Morelli Fares: [GitHub](https://github.com/faresedu), [LinkedIn](https://www.linkedin.com/in/eduardo-fares-a271561a0/) +- Felipe Tommaselli: [GitHub](https://github.com/Felipe-Tommaselli), [LinkedIn](https://www.linkedin.com/in/felipe-tommaselli-385a9b1a4/) +- João Aires C. F. Marsicano: [GitHub](https://github.com/Playergeek181), [LinkedIn](https://www.linkedin.com/in/joao-aires-correa-fernandes-marciano-53b426195/) +- José Carlos Andrade do Nascimento: [GitHub](https://github.com/joseCarlosAndrade), [LinkedIn](https://www.linkedin.com/in/jos%C3%A9-carlos-andrade-do-nascimento-71186421a) +- Rafael Saud C. Ferro: [GitHub](https://github.com/Rafael-Saud), [LinkedIn](https://www.linkedin.com/in/rafael-saud/) diff --git a/docs/ru/copterhack2022.md b/docs/ru/copterhack2022.md index 40117ff6..b655214e 100644 --- a/docs/ru/copterhack2022.md +++ b/docs/ru/copterhack2022.md @@ -15,7 +15,7 @@ CopterHack 2022 — это международный конкурс по ра ||🇧🇾 FTL|[Advanced Clover 2](advanced_clover_simulator.md)|| ||🇷🇺 Stereo|[Neural obstacle avoidance](../en/obstacle-avoidance-potential-fields.html)|| ||🇷🇺 Space clowns|[Copter For Space](c4s.md)|| -||🇧🇷 Atena - Grupo SEMEAR|[Swarm in Blocks](https://github.com/Grupo-SEMEAR-USP/clover/blob/Swarm_in_Blocks/docs/en/swarm_in_blocks.md)|| +||🇧🇷 Atena - Grupo SEMEAR|[Swarm in Blocks](../en/swarm_in_blocks.html)|| ||🇷🇺 Clover Rescue Team|[Rescue Clover](../en/clover-rescue-team.html)|| ||🇷🇺 CopterCat|[CopterCat](copter_cat.md)|| ||🇮🇳 DJS Phoenix|[Autonomous valet parking drone assistance](../en/djs_phoenix_ikshana.html)||