Difference between revisions of "New Gaia"

From PaparazziUAV
Jump to navigation Jump to search
(internal link label for test)
 
(33 intermediate revisions by 5 users not shown)
Line 6: Line 6:


= Presentation =
= Presentation =
== Functionalities ==
Fully connected to the Paparazzi simulator through the IVY middleware, New Gaia allows the user to add elements of a realistic meteorological environment to the current simulation thanks to an adapted GUI. The initial version of the program proposes three meteorological phenomena : thermal columns, turbulences and a vertical profile. Also are all the parameters of the simulation taken into account in order to offer the most complete customization capability : several UAVs, geographic coordinates, the background map, etc.
The models of the phenomena have been chosen based on two characteristics that are the way they can represent reality and a low resources need. For more details, please check the documentation.
Finally some misc have been implemented to reuse the functionalities of the current gaia agent like the simulation speed control.
== The project ==
It has been a two-month long project proposed by the ENAC micro-drones lab to the 2nd year of the IENAC S formation, and designed within the ENAC infrastructures in Toulouse. To know more about us, please check [[New_Gaia#About_us|About us]].


= How to get New Gaia ? =
= How to get New Gaia ? =
Line 12: Line 24:


== Requirements ==
== Requirements ==
In order to compile the files with the included makefile, you need JDK 1.6.0_24. And in order to run the file, you need the JRE 1.6.0_24 (included in the JDK). They can be found at [http://www.oracle.com/technetwork/java/javase/downloads/jdk6-downloads-1637591.html].
Please note that New_Gaia uses JDOM version 2.0.1 to generate XML files and the ivy package designed for java. They are included as jar files in the application, so you don't have to download them.


== The source code ==
== The source code ==
Get the [https://github.com/paparazzi/new_gaia source code] from our Github repository.


== Compilation ==
== Compilation ==
To compile the files, we wrote a makefile for you. Simply enter "make" to do so.


= How to use New Gaia ? =
= How to use New Gaia ? =


== Finding the maps files ==
== Finding the maps files ==
 
New_Gaia can display a background that helps (a lot) to set the thermal columns where one wants. To do so, New_Gaia uses the same files that Paparazzi. That's why the background must be filled thanks to Paparazzi before it can be used by New_Gaia. (These .jpg files are located in the /var/maps directory of Paparazzi)
Like Paparazzi, Ipodrom can show the plane on a map with aerial pictures. The images are not downloaded automatically from the internet, we use the ones downloaded by Paparazzi (they are located in $PAPARAZZI_HOME/var/maps).


== Finding the SRTM files ==
== Finding the SRTM files ==
The SRTM files used to determine the influence of the terrain on the meteorological phenomena can be found at [http://dds.cr.usgs.gov/srtm/version2_1/SRTM3/]
The SRTM files used to determine the influence of the terrain on the meteorological phenomena can be found at [http://dds.cr.usgs.gov/srtm/version2_1/SRTM3/]


== Executing the applications ==
== Executing the application ==
Once the application is compiled, you can run it with the command "make run". As a student project, this application doesn't appear in the "Tools" menu of Paparazzi, that's why it's necessary to run it manually in a terminal.
 
New_Gaia handles three main meteorological phenomena : thermal columns, the wind and turbulences. Each phenomenon can be customized thanks to the interface :
 
[[File:Phenomenes.png|900px]]
 
=== Thermal Columns ===
 
Let's begin with the thermal columns. To create a thermal column, click on the appropriate button and click somewhere on the map : a column with its initial parameters is created.
As you can see on the properties panel on the right, a lateral view of the column is displayed. Two areas are shown : a gray one, in which up-wind blows and a white one in which down-wind blows. Please note that the "radius" of a column refers to the radius of its up-wind area.
 
[[File:Thermal_column.png|900px]]
 
The "Maximum Vertical Speed" property refers to the speed of the wind at the center of the thermal column, this speed decreases then and becomes negative (down-wind area).
 
You can set the radius of the thermal column thanks to the handler on the left of the column. The height of the column is then calculated : the larger the column is, the higher it is.
 
=== Vertical Profile ===
 
The second meteorological phenomenon that can be set to customize the state of the weather is the vertical profile. It represents the speed and direction of the wind functions of height.
 
[[File:Vertical profile1.png|900px]]
 
The wind speed consists in a polylinear function linking the highest point (or handler), the lowest point and the points you may create. Each point represents a height, a speed and a direction used to determine the wind functions of the heigth.
To create a new point, simply left click in the vertical profile area. To erase a point, right click on it. Please note that the highest and lowest points can't be erased. Except of the highest point, a point's height can't be modified. If the height of a point doesn't satisfy you, erase it and create a new one. Nevertheless, a point's speed can be modified. To do so, move the point with a drag'n'drop.
 
[[File:Vertical profile2.png|900px]]
 
Finally, the layer of the atmosphere between 0 and 150m is influenced by the terrain and thus can't be modified.
 
The following image is an example of a wind turning along the altitude from East to West :
 
[[File:Vertical profile3.png|900px]]
 
=== Turbulences ===
 
The last meteorological phenomenon represents turbulences. This one is quite simple : it consists in random components added to the wind on the three axis. The level of turbulences is depicted by 4 values :
 
*  0 = no turbulences
*  1 = low turbulences
*  2 = medium turbulences
*  3 = severe turbulences
 
[[File:Turbulences.png|900px]]
 
= About us =
 
The team is composed by four students from the IENAC10S promo :
 
* BENREJEB Ons, developer,
* OTT Alexandra, developer,
* CARRIERE Sébastien, developer,
* EBRO Hugo, project lead, developer.

Latest revision as of 13:41, 22 November 2018

(Webpage currently incomplete)

New Gaia is an update of the current gaia agent.

This system has been developed by an ENAC team of 4 students from the IENAC10S promo. It enables one to generate a complex environment with several meteorological phenomena.

Presentation

Functionalities

Fully connected to the Paparazzi simulator through the IVY middleware, New Gaia allows the user to add elements of a realistic meteorological environment to the current simulation thanks to an adapted GUI. The initial version of the program proposes three meteorological phenomena : thermal columns, turbulences and a vertical profile. Also are all the parameters of the simulation taken into account in order to offer the most complete customization capability : several UAVs, geographic coordinates, the background map, etc.

The models of the phenomena have been chosen based on two characteristics that are the way they can represent reality and a low resources need. For more details, please check the documentation.

Finally some misc have been implemented to reuse the functionalities of the current gaia agent like the simulation speed control.

The project

It has been a two-month long project proposed by the ENAC micro-drones lab to the 2nd year of the IENAC S formation, and designed within the ENAC infrastructures in Toulouse. To know more about us, please check About us.

How to get New Gaia ?

The installation described here is for debian-like systems (typically Ubuntu). Thank you for sharing your experience on others systems!

Requirements

In order to compile the files with the included makefile, you need JDK 1.6.0_24. And in order to run the file, you need the JRE 1.6.0_24 (included in the JDK). They can be found at [1].

Please note that New_Gaia uses JDOM version 2.0.1 to generate XML files and the ivy package designed for java. They are included as jar files in the application, so you don't have to download them.

The source code

Get the source code from our Github repository.

Compilation

To compile the files, we wrote a makefile for you. Simply enter "make" to do so.

How to use New Gaia ?

Finding the maps files

New_Gaia can display a background that helps (a lot) to set the thermal columns where one wants. To do so, New_Gaia uses the same files that Paparazzi. That's why the background must be filled thanks to Paparazzi before it can be used by New_Gaia. (These .jpg files are located in the /var/maps directory of Paparazzi)

Finding the SRTM files

The SRTM files used to determine the influence of the terrain on the meteorological phenomena can be found at [2]

Executing the application

Once the application is compiled, you can run it with the command "make run". As a student project, this application doesn't appear in the "Tools" menu of Paparazzi, that's why it's necessary to run it manually in a terminal.

New_Gaia handles three main meteorological phenomena : thermal columns, the wind and turbulences. Each phenomenon can be customized thanks to the interface :

Phenomenes.png

Thermal Columns

Let's begin with the thermal columns. To create a thermal column, click on the appropriate button and click somewhere on the map : a column with its initial parameters is created. As you can see on the properties panel on the right, a lateral view of the column is displayed. Two areas are shown : a gray one, in which up-wind blows and a white one in which down-wind blows. Please note that the "radius" of a column refers to the radius of its up-wind area.

Thermal column.png

The "Maximum Vertical Speed" property refers to the speed of the wind at the center of the thermal column, this speed decreases then and becomes negative (down-wind area).

You can set the radius of the thermal column thanks to the handler on the left of the column. The height of the column is then calculated : the larger the column is, the higher it is.

Vertical Profile

The second meteorological phenomenon that can be set to customize the state of the weather is the vertical profile. It represents the speed and direction of the wind functions of height.

Vertical profile1.png

The wind speed consists in a polylinear function linking the highest point (or handler), the lowest point and the points you may create. Each point represents a height, a speed and a direction used to determine the wind functions of the heigth. To create a new point, simply left click in the vertical profile area. To erase a point, right click on it. Please note that the highest and lowest points can't be erased. Except of the highest point, a point's height can't be modified. If the height of a point doesn't satisfy you, erase it and create a new one. Nevertheless, a point's speed can be modified. To do so, move the point with a drag'n'drop.

Vertical profile2.png

Finally, the layer of the atmosphere between 0 and 150m is influenced by the terrain and thus can't be modified.

The following image is an example of a wind turning along the altitude from East to West :

Vertical profile3.png

Turbulences

The last meteorological phenomenon represents turbulences. This one is quite simple : it consists in random components added to the wind on the three axis. The level of turbulences is depicted by 4 values :

  • 0 = no turbulences
  • 1 = low turbulences
  • 2 = medium turbulences
  • 3 = severe turbulences

Turbulences.png

About us

The team is composed by four students from the IENAC10S promo :

  • BENREJEB Ons, developer,
  • OTT Alexandra, developer,
  • CARRIERE Sébastien, developer,
  • EBRO Hugo, project lead, developer.