Hi fellow wiki editors!

To help newly registered users get more familiar with the wiki (and maybe older users too) there is now a {{Welcome to the wiki}} template. Have a look at it and feel free to add it to new users discussion pages (and perhaps your own).

I have tried to keep the template short, but meaningful. /Johan G

Difference between revisions of "YASim Development Tools"

From FlightGear wiki
Jump to: navigation, search
(Initial version)
(Add keyboard commands to "usage")
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{Infobox addon
 +
|name=YASim Development Tools
 +
|started=02/2018
 +
|desc= addon for Flightgear to visualize the internals of a YASim FDM in-sim
 +
|status=under active development as of 02/2018
 +
|contributors={{Usr|jsb}}
 +
}}
 
{{Stub}}
 
{{Stub}}
A first version of the YASim development tools is availabel on [https://sourceforge.net/p/flightgear/fgaddon/HEAD/tree/trunk/Addons/YASimDevel/ SourceForge]
+
 
 +
= Description =
 +
YASim development tools are an addon for Flightgear to visualize the internals of a YASim FDM while running the simulator. Minimum required version is FG 2018.1
 +
 
 +
= Installation =
 +
YASim development tools are availabel for download on [https://sourceforge.net/p/flightgear/fgaddon/HEAD/tree/trunk/Addons/YASimDevel/ SourceForge]
  
 
In order to load the add-on, start FlightGear (fgfs) with the option --addon,
 
In order to load the add-on, start FlightGear (fgfs) with the option --addon,
Line 9: Line 21:
 
then look at the menubar. :)
 
then look at the menubar. :)
  
You will get a canvas window showing the airplane viewed from top with markers for the CG (the diamond), the desired range as given by the cg-min and cg-max attributes in the XML file and the hard limits for the CG (given by the gear positions). Also displayed are the centerlines of the wings and the MAC. Last but not least a colored chord line is drawn per surface element (yasim generates several surface elements  per wing). They will show green for positiv lift and magenta for negative lift. The red part indicates drag.
+
= Usage =
 +
Select an entry from the YASim development menu. A canvas window will open, use left mouse click to zoom in, right click to zoom out. Left click+hold to drag.
 +
You can also use "+" and "-" on the keyboard to zoom, and <Esc> key to close the canvas window.
 +
 
 +
== displayMasses ==
 +
You will get a canvas window showing the airplane mass points viewed from top with markers for the CG (the diamond), the desired range as given by the cg-min and cg-max attributes in the XML file and the hard limits for the CG (given by the gear positions).
 +
 
 +
== displayForces ==
 +
Similar output as for displayMasses. Also displayed are the centerlines of the wings and the MAC. Last but not least a colored chord line is drawn per surface element (yasim generates several surface elements  per wing). They will show green for positive lift and magenta for negative lift. The red part indicates drag.
 
[[File:Yasim-forces-nochords.jpg|thumb|Canvas showing yasim internals]]
 
[[File:Yasim-forces-nochords.jpg|thumb|Canvas showing yasim internals]]
  
Line 16: Line 36:
  
 
Since FG version 2018.1 you can build the main wing by using multiple <wing> elements (refer to the [[Yasim|Yasim main page]] for details).
 
Since FG version 2018.1 you can build the main wing by using multiple <wing> elements (refer to the [[Yasim|Yasim main page]] for details).
Now the MAC is calculated for each wing section and then is combinded to a MAC for the wing and CG is expressed relativly to this overall MAC.
+
Now the MAC is calculated for each wing section and then is combinded to a MAC for the wing and CG is expressed relatively to this overall MAC.
 
[[File:Yasim-forces-with-sections.jpg|thumb|Canvas showing yasim internals. CG green, correct MAC calculation using wing sections.]]
 
[[File:Yasim-forces-with-sections.jpg|thumb|Canvas showing yasim internals. CG green, correct MAC calculation using wing sections.]]

Latest revision as of 11:16, 22 February 2018

YASim Development Tools
Started in 02/2018
Description addon for Flightgear to visualize the internals of a YASim FDM in-sim
Contributor(s) jsb
Status under active development as of 02/2018
This article is a stub. You can help the wiki by expanding it.

Description

YASim development tools are an addon for Flightgear to visualize the internals of a YASim FDM while running the simulator. Minimum required version is FG 2018.1

Installation

YASim development tools are availabel for download on SourceForge

In order to load the add-on, start FlightGear (fgfs) with the option --addon, like this:

 fgfs <your_usual_arguments> --addon=/path/to/the/YASimDevel/folder

then look at the menubar. :)

Usage

Select an entry from the YASim development menu. A canvas window will open, use left mouse click to zoom in, right click to zoom out. Left click+hold to drag. You can also use "+" and "-" on the keyboard to zoom, and <Esc> key to close the canvas window.

displayMasses

You will get a canvas window showing the airplane mass points viewed from top with markers for the CG (the diamond), the desired range as given by the cg-min and cg-max attributes in the XML file and the hard limits for the CG (given by the gear positions).

displayForces

Similar output as for displayMasses. Also displayed are the centerlines of the wings and the MAC. Last but not least a colored chord line is drawn per surface element (yasim generates several surface elements per wing). They will show green for positive lift and magenta for negative lift. The red part indicates drag.

Canvas showing yasim internals

Old models (before FG version 2018.1) often use <wing> + <mstab> to build complex wing geometry. The CG position in %MAC refers to the MAC of the <wing> element and is most likely wrong, when combining <wing> and <mstab> to build the main wing of the airplane.

Canvas showing yasim internals. CG out of range, incorrect MAC due to old model description.

Since FG version 2018.1 you can build the main wing by using multiple <wing> elements (refer to the Yasim main page for details). Now the MAC is calculated for each wing section and then is combinded to a MAC for the wing and CG is expressed relatively to this overall MAC.

Canvas showing yasim internals. CG green, correct MAC calculation using wing sections.