Difference between revisions of "Simulation"

From PaparazziUAV
Jump to navigation Jump to search
m (Added hint to use of the gazibo optinn)
 
(12 intermediate revisions by 4 users not shown)
Line 6: Line 6:
== Available Simulators ==
== Available Simulators ==


Paparazzi currently has three different simulator "backends" for a '''F'''light '''D'''ynamic '''M'''odel (FDM) with varying degrees of realism and intended purpose:
Paparazzi currently has two different simulator targets with different degrees of realism and intended purpose:
A FDM is a set of mathimatical equations used to calculate the physical forces acting on a simulated aircraft, such as thrust, lift, and drag.


The three are:  
# '''sim''': The basic fixedwing simulator written in OCaml without IMU simulation or any sensor models (noise, bias, etc) and mainly intended to validate your [[Flight_Plans|flight plan]] logic.
# '''nps''': [[NPS]] is a more advanced rotorcraft and fixedwing simulator with sensor models and commonly uses [[JSBSim]] as FDM ('''F'''light '''D'''ynamic '''M'''odel). Other FDM's can be integrated easily. At the moment CRRCSIM, YASIM and JSBSIM are tried as FDM backend.
# '''gazebo''': [[gazebo]] . There is someting brand new developed going, using laters '''Master''' you can start using the Gazebo engine in Paparazzi. Take a look on that page to see if it offers what you are looking for.


# '''sim''': The basic fixedwing simulator written in OCaml.
A FDM is a set of mathematical equations used to calculate the physical forces acting on a simulated aircraft, such as thrust, lift, and drag.
# '''jsbsim''': More advanced fixedwing simulator using [[JSBSim]] for the FDM. More details [[Simulation#JSBSim|further down on this page]].
# '''nps''': [[NPS]] is an advanced rotorcraft simulator with sensor models and currently also uses [[JSBSim]] as FDM. Other FDM's can be integrated easily. At the moment CRRCSIM, YASIM and JSBSIM are tried as FDM backend.


== Compiling and starting ==
== Compiling and starting ==
'''This describes the basic fixedwing sim, for rotorcraft or advanced fixedwing simulation, see [[NPS]].'''


From the [[Paparazzi_Center|Paparazzi Center]] select the Microjet aircraft (from the '''A/C''' combo box) which is configured with the <tt>basic.xml</tt> flight plan. From the '''Target''' combo box, select <tt>sim</tt> and click the '''Build''' button to compile the airbone code to be run on your Linux box. From the '''Session''' combo box, select <tt>Simulation</tt> entry and click '''Execute''' to start the simulation. It will start  
From the [[Paparazzi_Center|Paparazzi Center]] select the Microjet aircraft (from the '''A/C''' combo box) which is configured with the <tt>basic.xml</tt> flight plan. From the '''Target''' combo box, select <tt>sim</tt> and click the '''Build''' button to compile the airbone code to be run on your Linux box. From the '''Session''' combo box, select <tt>Simulation</tt> entry and click '''Execute''' to start the simulation. It will start  
Line 27: Line 28:
The aircraft has automatically been booted, as if the autopilot board had been powered. Its position and its flight parameters are displayed in the GCS window. If you omit the -boot option of the sim the aircraft is not automatically booted and you can first place the aircraft where you want it to start from and then boot.
The aircraft has automatically been booted, as if the autopilot board had been powered. Its position and its flight parameters are displayed in the GCS window. If you omit the -boot option of the sim the aircraft is not automatically booted and you can first place the aircraft where you want it to start from and then boot.


The map widget is able use many map formats and display them according to many projections. To make things simple, we start by using images from [http://maps.google.com Google]. From the toolbar in the top right corner of the GCS, click the Google Earth icon ('''Google maps fill'''). The program attempts to download the required satellite images from the Google servers. If it succeeds, you should now see the nice countryside of Muret (a city close to Toulouse, France). Navigation and other features of the map are described on the [[GCS#map|GCS]] page.
If the --norc option is ommited, a window for a virtual remote control (including on/off switch and a mode-switch) is started, see: [https://wiki.paparazziuav.org/wiki/Joystick#Virtual_Joystick_.28only_for_SIM_targets.29  Virtual Joystick]
 
In the GCS the map widget is able to use many map formats and display them according to many projections. To make things simple, we start by using images from [http://maps.google.com Google]. From the toolbar in the top right corner of the GCS, click the Google Earth icon ('''Google maps fill'''). The program attempts to download the required satellite images from the Google servers. If it succeeds, you should now see the nice countryside of Muret (a city close to Toulouse, France). Navigation and other features of the map are described on the [[GCS#map|GCS]] page.


The lower part of the GCS displays the flight plan in a tree view. You see that the current flight plan is composed of several ''blocks'':
The lower part of the GCS displays the flight plan in a tree view. You see that the current flight plan is composed of several ''blocks'':
Line 71: Line 74:
Launch the '''Environment Simulator''' from the '''Tools' menu in the '''Paparazzi Center'''.
Launch the '''Environment Simulator''' from the '''Tools' menu in the '''Paparazzi Center'''.


This interface (also called'''Gaia''') allows the user to change:
[[file:PPRZ_Environment_settings_Gaia_GUI_up.png]]
* The wind: Set up a wind speed of 5m/s and observe the trajectory and the speed evolution (in the aircraft strip and in the '''PFD''' page of the notebook).
 
* The GPS coverage: Shut down the GPS ('''GPS OFF''') and observe the resulting mode ('''NO_GPS''') and trajectory. In this mode, the autopilot uses the failsafe roll, pitch and throttle settings defined in the airframe file. Note that in a real flight, an aircraft without GPS won't be able to send its position ... The simulation is cheating here !
This interface, also known as '''Gaia''', allows the user to change:
* The time scale: If you are in a hurry ... Do not use a time higher than 2 for this first demonstration.
 
* The time-scale: This make the simulation of the flight speed up time, good if you have a extensive flightpland and you do not want to wait the real time it would taketo fly the aircraft in a real life flight. It is best not use a times-cale higher than 2x for a first tryout.
* The Wind speed: Set the wind speed while simulating. Try to set it to e.g. 5m/s and observe the trajectory and the speed evolution in the aircraft strip and in the '''PFD''' page of the notebook
* The Wind direction: Set the direction the wind comse from. For fun try to take of with stong wind from the side.
* Wind up: Simulates updraft (e.g. by thermals) or downdraft wind (beside thunderstorms or in mountains), which could e.g. shift the UAS higher than permitted, which can be counteracted by exceptions in the flightplan.
* A GPS failure: Simulate GPS loss on the aircraft ('''GPS OFF''') and observe the resulting mode ('''NO_GPS''') and trajectory. In this mode, the autopilot can for example use a the failsafe roll, pitch and throttle settings defined in the airframe file. Note that in a real flight, an aircraft without GPS won't be able to send it's position ... The simulation is cheating here! It must, otherwise not possible to show the path in the simulator ofcourse.
 
Environment Simulator, Gaia can also be started with initial values set by command line option.
 
  -b Bus Default is 127.255.255.255:2010
  -t Set time scale (default: 1.0)
  -w Set wind speed (0-30m/s)
  -d Set wind direction 0-359 deg
  -g Turn off GPS
  -help  Display this list of options
  --help  Display this list of options
 
If you are in the testfield and forgot the parameters, just use the "help"
 
$ ./gaia --help
 
This make testing more convienient since on can save a session with this parameters and on restart imidately have the same settings again.
 
=== Example ===
 
Starting gaia with the following parameters on the command line:
 
$ sw/simulator/gaia -t 3 -d 340 -w 11
 
This sets a 3x speedup of the time with wind coming from 340 degrees with a windspeed of 11m/s


== Other navigation patterns ==
== Other navigation patterns ==
Line 117: Line 149:
}}
}}


== JSBSim ==
Paparazzi can work with [http://jsbsim.sourceforge.net/ JSBSim], a great open source flight dynamics library.


==== For a fixed wing aircraft: ====
=== Obtain Screenshots from FlightGear into PaparazziUAV ===
 
[[JSBSim|Install JSBSim]].
 
In your airframe file add the following section:
 
{{Box Code|conf/airframes/myplane.xml|
<source lang="xml">
  <section name="SIMU">
    <define name="JSBSIM_INIT" value="&quot;Malolo1-IC&quot;"/>
    <define name="JSBSIM_IR_ROLL_NEUTRAL" value="RadOfDeg(0.)"/>
    <define name="JSBSIM_IR_PITCH_NEUTRAL" value="RadOfDeg(0.)"/>
  </section>
</source>
}}
 
In this case, the JSBSim model used is <tt>conf/simulator/Malolo1</tt>. To create your own model make a new directory under <tt>conf/simulator</tt> and put your JSBSim model there, and adapt the <tt>"JSBSIM_MODEL"</tt> in the <tt>SIMU</tt> section accordingly.
 
Add another target to the <tt>"fixedwing"</tt> <tt>firmware</tt> section of your airframe file:
  <source lang="xml"><target name="jsbsim"  board="pc" /></source>
 
Now you can can compile the airframe for the jsbsim target. Launch the simulator as normal, but add the option <tt>-jsbsim</tt>. Note that FlightGear visualization can be used in conjunction with the JSBSim simulation, just be sure to add the <tt>-fg 127.0.0.1</tt> option as described [[Simulation#View_the_simulation_in_Flight_Gear|above]]. Using both JSBSim and FlightGear, it would be:
  <source lang="xml"><paparazzi home directory>/sw/simulator/launchsitl -a <aircraft_name> -jsbsim -boot -norc -fg 127.0.0.1</source>
 
You will notice the default control parameters do not fly the Malolo1 airframe particularly well.
 
The Microjet aircraft can be used as an example; it has the right target and <tt>"SIMU"</tt> section added.
 
==== Using Optional Parameters ====
 
There are a few optional parameters that can be used with a JSBSim simulation.
 
The initial body-aligned forward speed of the aircraft in m/s can be specified in the <tt>"SIMU"</tt> section of the airframe file:
{{Box Code|conf/airframes/myplane.xml|
<source lang="xml">
  <section name="SIMU">
    ...
    <define name="JSBSIM_LAUNCHSPEED" value="15.0"/>
    ...
  </section>
</source>
}}
 
The '''i'''nitial '''c'''onditions for the simulation can be set with an initialization xml document. Add the following to the <tt>"SIMU"</tt> section of the airframe file:
{{Box Code|conf/airframes/myplane.xml|
<source lang="xml">
  <section name="SIMU">
    ...
    <define name="JSBSIM_INIT" value="&quot;Malolo1-IC&quot;"/>
    ...
  </section>
</source>
}}
In this case, the initialization file for the Malolo1 used is <tt>conf/simulator/Malolo1/Malolo1-IC.xml</tt>. To create your own initialization file, use this file as an example, place the file into your JSBSim model directory, and adapt <tt>"JSBSIM_INIT"</tt> in the <tt>SIMU</tt> section accordingly.


These options are demonstrated in the jsbsim.xml example airframe file in <tt>/conf/airframes/jsbsim.xml</tt>. The control parameters in this example are much better in controlling the Malolo1 airframe.
One can write a relatively simple module in order to obtain screenshots of the FlightGear world into the PaparazziUAV software. This can be useful to simulate low fidelity computer vision tasks with UAVs. The module requires libcurl and libpng to make the screenshot data available to PaparazziUAV. Detailed instructions are available in [[Load Screenshots from FlightGear]].


[[Category:Simulation]] [[Category:Software]] [[Category:User_Documentation]]
[[Category:Simulation]] [[Category:Software]] [[Category:User_Documentation]]

Latest revision as of 02:00, 6 February 2018

This page describes the steps needed to run a simulated flight with an UAS.

Available Simulators

Paparazzi currently has two different simulator targets with different degrees of realism and intended purpose:

  1. sim: The basic fixedwing simulator written in OCaml without IMU simulation or any sensor models (noise, bias, etc) and mainly intended to validate your flight plan logic.
  2. nps: NPS is a more advanced rotorcraft and fixedwing simulator with sensor models and commonly uses JSBSim as FDM (Flight Dynamic Model). Other FDM's can be integrated easily. At the moment CRRCSIM, YASIM and JSBSIM are tried as FDM backend.
  3. gazebo: gazebo . There is someting brand new developed going, using laters Master you can start using the Gazebo engine in Paparazzi. Take a look on that page to see if it offers what you are looking for.

A FDM is a set of mathematical equations used to calculate the physical forces acting on a simulated aircraft, such as thrust, lift, and drag.

Compiling and starting

This describes the basic fixedwing sim, for rotorcraft or advanced fixedwing simulation, see NPS.

From the Paparazzi Center select the Microjet aircraft (from the A/C combo box) which is configured with the basic.xml flight plan. From the Target combo box, select sim and click the Build button to compile the airbone code to be run on your Linux box. From the Session combo box, select Simulation entry and click Execute to start the simulation. It will start three processes which are listed in the window below:

  • Microjet is the interface of a simulator program. It runs the same code as the one for the autopilot processor plus a rudimentary flight dynamic model. it allows you to test the interactions with the UAV and the flight plan execution.
  • GCS (Ground Control Station) is the main window. It displays the track of the aircraft, as well as informations about the execution of its flight plans. This program provide menus for the datalink functions and is able to edit a flight plan.
  • Server is a hidden process which won't be described here (see the architecture of the system)

Start the Simulation

The aircraft has automatically been booted, as if the autopilot board had been powered. Its position and its flight parameters are displayed in the GCS window. If you omit the -boot option of the sim the aircraft is not automatically booted and you can first place the aircraft where you want it to start from and then boot.

If the --norc option is ommited, a window for a virtual remote control (including on/off switch and a mode-switch) is started, see: Virtual Joystick

In the GCS the map widget is able to use many map formats and display them according to many projections. To make things simple, we start by using images from Google. From the toolbar in the top right corner of the GCS, click the Google Earth icon (Google maps fill). The program attempts to download the required satellite images from the Google servers. If it succeeds, you should now see the nice countryside of Muret (a city close to Toulouse, France). Navigation and other features of the map are described on the GCS page.

The lower part of the GCS displays the flight plan in a tree view. You see that the current flight plan is composed of several blocks:

  • wait GPS and geo init which are instructions to run this flight plan anywhere in the world, by translating the waypoints around the current location of aircraft as soon as it is reported by the GPS.
  • Holding point (it should be the current active block) which instructs the autopilot to wait for launch.
  • Takeoff which will instruct the aircraft to climb full throttle to a security altitude
  • Standby which is a simple circle around the STDBY waypoint.

Switch to the Takeoff block by a double click on the line or using the corresponding button (an icon figuring an airway) on the left side of the strip.

Fly

In the Simulator (Microjet window), press the Launch button to simulate a hand launch or click the launch button in the GCS (the green aircraft icon). The autopilot detects the launch by monitoring the groundspeed. The flight time (in the aircraft label on the GCS) then starts to count.

Position of the aircraft is displayed on the map: the aircraft goes to the CLIMB waypoint (to the norht-west) and then around the STDBY waypoint. Current block also changes accordingly in the flight plan display.

The orange triangle (the carrot) on the map is the point that the aircraft is navigating toward.

Line

Jump to this block with double-click on the Line 1-2 line in the flight plan or using the corresponding button in the strip (figuring a blue line between two white points). The aircraft will try to follow a line joining the waypoints 1 and 2, doing nice U-turns at both ends.

Move waypoints

While the aircraft is flying (or here while the simulator is integrating differential equations), you can move the waypoints on the GCS interface by cliking and dragging (with the left button). When the mouse button is released, a popup window allows you to change the altitude of the waypoint. After validation, the waypoint changes are sent to the autopilot and the followed track is changed accordingly.

Coming back around

Select the Standby block (the home blue icon) to instruct the aircraft to fly around the STDBY waypoint.

Fly too far

If you unzoom the map (using the PageDown key or he mouse wheel), you will see a large circle around the waypoints. This circle show the allowed flying zone that the autopilot must not leave or it will enter an emergency navigation mode and circles the HOME waypoint until the further direction is received.

Move the waypoint 2 out of this circle (close to the circle in the north-east corner) and switch back to the 'Line 1-2 block to force the plane to get out of this safety zone.

The aircraft flies to the 2 waypoint, cross the protection enveloppe and switches to home mode: the AP mode in the aircraft strip switches from AUTO2 to HOME.

To get out of this mode and switch back to the default AUTO2, click on the AUTO2 button in the aircraft strip. The aircraft then flies again towards too far and again swithes to HOME mode.

Change the environment

Launch the Environment Simulator from the Tools' menu in the Paparazzi Center.

PPRZ Environment settings Gaia GUI up.png

This interface, also known as Gaia, allows the user to change:

  • The time-scale: This make the simulation of the flight speed up time, good if you have a extensive flightpland and you do not want to wait the real time it would taketo fly the aircraft in a real life flight. It is best not use a times-cale higher than 2x for a first tryout.
  • The Wind speed: Set the wind speed while simulating. Try to set it to e.g. 5m/s and observe the trajectory and the speed evolution in the aircraft strip and in the PFD page of the notebook
  • The Wind direction: Set the direction the wind comse from. For fun try to take of with stong wind from the side.
  • Wind up: Simulates updraft (e.g. by thermals) or downdraft wind (beside thunderstorms or in mountains), which could e.g. shift the UAS higher than permitted, which can be counteracted by exceptions in the flightplan.
  • A GPS failure: Simulate GPS loss on the aircraft (GPS OFF) and observe the resulting mode (NO_GPS) and trajectory. In this mode, the autopilot can for example use a the failsafe roll, pitch and throttle settings defined in the airframe file. Note that in a real flight, an aircraft without GPS won't be able to send it's position ... The simulation is cheating here! It must, otherwise not possible to show the path in the simulator ofcourse.

Environment Simulator, Gaia can also be started with initial values set by command line option.

  -b Bus Default is 127.255.255.255:2010
  -t Set time scale (default: 1.0)
  -w Set wind speed (0-30m/s)
  -d Set wind direction 0-359 deg
  -g Turn off GPS
  -help  Display this list of options
  --help  Display this list of options

If you are in the testfield and forgot the parameters, just use the "help"

$ ./gaia --help

This make testing more convienient since on can save a session with this parameters and on restart imidately have the same settings again.

Example

Starting gaia with the following parameters on the command line:

$ sw/simulator/gaia -t 3 -d 340 -w 11

This sets a 3x speedup of the time with wind coming from 340 degrees with a windspeed of 11m/s

Other navigation patterns

Using the buttons in the strip, you can play with other navigation patterns: figure of eights, oval, survey of a rectangle (with a north-south sweeping), Circle around here (which sets a waypoint to the current location of the plane and flies a circle around).

Landing

To automatically land the aircraft:

  • Set the TD (Touch Down) waypoint where you want to land. Be sure that the waypoint is on the ground (185m in Muret)
  • Set the AF (Approach Fix) waypoint where you want to start the final descent (the glide). If you have set some wind with Gaia, you probably want to fly AF-TD upwind (an estimation of the wind experienced by the aircraft is displayed in the left-upper corner of the map).
  • Switch to the Land right or the Land left block (icons in the strip) according to the direction of the last turn you want to do (for example, if AF is on the east side of TD and you want to maneuvre from the north, choose a Land right)

Multiple UAV Simulation

To simulate multiple aircrafts, you just have to launch a second simulator (tools->simulator, then -a yourairframe) and the server and the GCS should take care of the rest.

View the simulation in Flight Gear

To view the simulation in FlightGear, do the following:

  • install Flight Gear
  • In Paparazzi Center, add the option --fg_host 127.0.0.1 (replace the IP address if FG is running on another host as appropriate) to the Simulator line and restart it, e.g.:
<path_to_paparazzi>/sw/simulator/pprzsim-launch --aircraft <your_ac_name> -t sim --boot --norc --fg_host 127.0.0.1

Prior to v5.0 launchsitl was used instead of pprzsim-launch. Click expand to see the details.

<path_to_paparazzi>/sw/simulator/launchsitl -a <your_ac_name> -boot -norc -fg 127.0.0.1
  • Launch Flight Gear with the following command:
fgfs --fdm=null --native-gui=socket,in,30,,5501,udp

Old version

For Flight Gear visualization, version 2.12 or greater with rembrand visualisation options switched on is the nicest. If you wish to use a very old version, Flightgear v2.4 or lower, you must add the following to the firmware section of your airframe file:

File: conf/airframes/myplane.xml
  <firmware name="fixedwing or rotorcraft">
     ...
     <define name="FG_2_4" value="1"/>
     ...
  </firmware>


Obtain Screenshots from FlightGear into PaparazziUAV

One can write a relatively simple module in order to obtain screenshots of the FlightGear world into the PaparazziUAV software. This can be useful to simulate low fidelity computer vision tasks with UAVs. The module requires libcurl and libpng to make the screenshot data available to PaparazziUAV. Detailed instructions are available in Load Screenshots from FlightGear.