FlightGear wiki - User contributions [en]

Fr/YASim

2016-05-23T07:27:50Z

Favdb: /* stall */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' Le poids à vide (sans fuel) exprimé en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

=== Surfaces ===
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

=== Motorisation ===
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

=== Atterrisseurs ===
===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raidisseur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilisé pour une lancement au treuil (pour les planeurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
Note au sujet de la première étape (step (0)) concernant les utilisateur M$: le chemin du répertoire indiqué est situé dans le répertoire dans lequel Blender est installé, quelque chose comme <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-05-23T07:23:29Z

Favdb: Small corrections

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' Le poids à vide (sans fuel) exprimé en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

=== Surfaces ===
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

=== Motorisation ===
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

=== Atterrisseurs ===
===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raidisseur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilisé pour une lancement au treuil (pour les planeurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
Note au sujet de la première étape (step (0)) concernant les utilisateur M$: le chemin du répertoire indiqué est situé dans le répertoire dans lequel Blender est installé, quelque chose comme <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/Glossaire

2016-05-09T07:16:47Z

Favdb: /* T */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche par un mouvement avant/arrière. 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. Il se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur la dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''Tab :''' voir Trim. 
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
'''Throttle :''' manette des gaz. Manette permettant au pilote de commander la puissance délivrée par le(s) moteur(s) et contrôlant ainsi la vitesse de l'aéronef. 
'''Trim (Trim Tab or Tab) :''' compensateur. Système aérodynamique ou mécanique qui permet de maintenir une gouverne (surface de contrôle) dans une position assurant l'équilibre de l'avion. 
 

=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Glossaire

2016-05-09T07:08:55Z

Favdb: /* P */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche par un mouvement avant/arrière. 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. Il se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur la dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
'''Throttle :''' manette des gaz. Manette permettant au pilote de commander la puissance délivrée par le(s) moteur(s) et contrôlant ainsi la vitesse de l'aéronef. 
 

=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Glossaire

2016-05-09T07:08:07Z

Favdb: /* T */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche par un mouvement avant/arrière. 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. IL se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur la dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
'''Throttle :''' manette des gaz. Manette permettant au pilote de commander la puissance délivrée par le(s) moteur(s) et contrôlant ainsi la vitesse de l'aéronef. 
 

=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Glossaire

2016-05-09T07:02:45Z

Favdb: /* E */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche par un mouvement avant/arrière. 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. IL se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur la dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
 
=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Glossaire

2016-05-09T06:59:49Z

Favdb: /* R */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche a vec un mouvement avant/arrière). 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. IL se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur la dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
 
=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Glossaire

2016-05-09T06:59:16Z

Favdb: /* S */

Plus qu'un glossaire, cette liste donne également la traduction de l'anglais au français des termes techniques et des abréviations utiles lors de l'usage de FlightGear. Ce glossaire peut s'enrichir au fur et à mesure. 
Les entrées en anglais précédées d'une astérisque concernent soit des termes utilisés pour les entrées de menu de FlightGear, ou pour des termes non spécifiques à l'aviation. 
 
Les entrées se présentent comme suit : 
'''Expression en anglais''' : traduction ou équivalent en français. Définition, illustration ou explication, le cas échéant. 
 
=== A ===
'''Aircraft :''' appareil volant, aéronef. Tout appareil capable de se déplacer dans les airs. Voir l'article [https://fr.wikipedia.org/wiki/A%C3%A9ronef Aéronef] sur Wikipédia. 
'''Airport :''' aéroport, aérodrome. Lieu où sont des pistes et des aires pour l'évolution, le décollage et l'atterrissage des appareils, ainsi que construits des bâtiments pour l'accueil de passagers ou l'entretien des appareils. 
'''Airspeed :''' vitesse Air. Le badin (en anglais, "airspeed indicator") indique la vitesse de l'air autour de l'avion, différente de la vitesse par rapport au sol (en fonction du vent notamment). 
'''Airway :''' couloir aérien. Voie de communication aérienne permettant de sécuriser la circulation aérienne. 
'''Air Traffic Control :''' contrôle du trafic aérien. Les contrôleurs aériens assistent les pilotes. Ils fournissent de nombreux renseignements comme des données météorologique, les positions des autres avions, les informations au sol, etc. L'expression se rencontre fréquemment en abréviation, soit ATC en anglais, soit CTA en français. 
'''Altimeter :''' altimètre. Baromètre permettant d'indiquer l'altitude de l'appareil. 
'''Altitude''' : altitude. Elévation verticale d'un lieu ou d'un objet par rapport à un niveau de référence. 
'''Approach''' : approche (procédure). La procédure d'approche d'un avion définit les trajectoires et altitudes à respecter avant l'atterrissage. Elle peut s'effectuer à vue ou aux instruments. 
'''Arrival :''' : arrivée. 
'''Autobrake''' : freinage automatique. Freins hydrauliques actionnés, par exemple, lors d'un atterrissage. Lorsque l'avion touche la piste, il freine automatiquement. 
'''Auto-pilot''' : pilote automatique. Le pilote automatique permet au pilote de maintenir automatiquement l'avion en vol dans des conditions exactes correspondant aux critères choisis. 
'''Autothrottle''' : manette des gaz automatique. Fonction du pilote automatique permettant le maintien d'une vitesse définie par le pilote. 
'''APU (Auxiliary Power Unit)''' : groupe auxiliaire de puissance. Il produit l'électricité utilisée pour démarrer les moteurs, ou lorsqu'ils sont à l'arrêt. 
'''*Average :''' moyenne. 
 

=== B ===
'''Brakes''' : freins. 
 

=== C ===
'''*Calculated :''' calculé. 
'''Cabin :''' cabine. 
'''Carrier :''' porte-avion. Un navire spécialement équipé pour l'appontage, l'entreposage, l'entretien et le décollage d'avions spécifiquement adaptés. 
'''*Center :''' centre. 
'''*Clear : ''' clair. Le temps, peut être clair, une communication radio aussi. 
'''Climb :''' montée. Phase suivant le décollage de l'avion. 
'''Communications :''' communications. Dans un avion les communications se font à l'aide de fréquences radio. 
'''Control :''' contrôle. 
'''Controlled :''' contrôlé. En aviation des zones peuvent être controlées. 
'''Controller :''' contrôleur. 
'''Cruise :''' croisière. Un avion vole à une altitude de croisière et une vitesse de croisière, des propriétés définies par le pilote en fonction de la météo, des vents... 
 
=== D ===
'''Direction :''' direction. un avion suit une direction, appelée aussi cap. 
'''*Distance :''' distance. 
 
=== E ===
'''*Electronic :''' électronique. 
'''Elevation :''' altitude. 
'''Elevators :''' gouvernes de profondeur. Elles agissent sur le tangage, et sont contrôlées par le manche a vec un mouvement avant/arrière). 
'''Engine(s) :''' moteur(s). 
'''*Estimated :''' estimé. 
 

=== F ===
'''Feet (ft) : ''' pieds. Unité de mesure anglo-saxonne très utilisée en aéronautique surtout en altimétrie et équivalent à 0,3048m. [http://unit-converter.org/fr/quick/1ft Convertisseur] 
'''*FDM :''' acronyme de "Flight Dynamic Model", modèle dynamique de vol. Il s'agit d'un programme qui modélise le comportement d'un avion en vol, en prenant en entrée différents paramètres. Selon le FDM les entrées sont différentes, et leur philosophie est différente. Il existe deux grands FDM dans FlightGear : YASim (faisant partie intégrante de FlightGear) et JSBSim (régulièrement importé). D'autres modèles sont présents, mais réservés à des utilisations particulières (UFO, external), ou simplement "obsolètes"(LARCSim, UIUC). Un nouveau FDM est en cours de création et cherche à améliorer les problèmes connus des autres FDM, notamment concernant la friction au sol : OpenFDM. 
'''*File :''' fichier. Le menu "File" correspond au menu "Fichiers" des programmes en français. 
'''Flaps :''' volets. Il peut s'agir des volets de sustentation, de courbure et en générale des dispositifs hypersustentateurs. Ces dispositifs amovibles ou mobiles modifient la portance des ailes. Ainsi, à basse vitesse, l'avion ne décroche pas. Ils sont obligatoires à l'atterrissage et au décollage. Voir [http://fr.wikipedia.org/wiki/Dispositif_hypersustentateur#Volets Dispositif hypersustentateur(volets)] sur Wikipédia. 
'''Flight :'''vol (d'avion). 
 
=== G ===
'''Gear(s) :''' train(s) d'atterrissage. A noter que, dans FlightGear, "gear" n'a pas la même signification, mais plutôt celle de "mécanisme" (roues dentées). Voir [http://fr.wikipedia.org/wiki/Train_d%27atterrissage Train d'atterrissage] sur Wikipédia. 
'''*Go-Around :''' partir de votre position, aller ailleurs. 
 
=== H ===
'''Heading :''' cap. C'est la direction suivie par l'appareil par rapport au nord géographique. C'est également une fonction de l'auto-pilote. 
 
=== I ===
'''ILS (Instrument Landing System) :''' système d'atterrissage aux instruments. C'est le moyen de radio-navigation le plus précis utilisé pour l'atterrissage. 
'''*inhg :''' pouce de mercure. Unité de mesure de pression très utilisée dans l'indication de la pression de fluides. [http://unit-converter.org/fr/quick/inHg Convertisseur inHg]. 
'''Initial approach :''' approche initiale. 
'''Instruments :''' instruments. Les instruments sont primordiaux dans le pilotage des avions : ils donnent des indications capitales. Voir partie instruments de l'article [http://fr.wikipedia.org/wiki/Pilotage_d%27un_avion Pilotage d'un avion] sur Wikipédia. 
 
=== J ===
'''Jomo :''' controleur à l'aéroport de Francfort (EDDF) (Air Traffic Control). 
 
=== K ===
'''Knot (kt ou kn):''' noeud, ou mile nautique. Unité de mesure anglo-saxonne très utilisée surtout pour l'indication de la vitesse-air. Un noeud correspond à une vitesse de 1,852 km/h au niveau de la mer. [http://unit-converter.org/fr/quick/knot Convertisseur knot]. 
 
=== L ===
'''Landing :''' atterrissage. 
'''*Light :''' lumière. 
'''LNAV (Lateral Navigation):''' navigation latérale. Fonction de l'auto-pilote consistant à suivre "une route" grâce à des balises. 
'''Localizer :''' localiseur. Fonction de l'auto-pilote permettant de localiser la fréquence ILS. 
 
=== M ===
'''METAR :''' données météorologiques. Acronyme de METeorological Airport Report. Voir [http://fr.wikipedia.org/wiki/Metar Metar] sur Wikipédia. 
'''*Middle :''' milieu. Le middle marker est utilisé lors de l'activation de l'ILS. 
 
=== N ===
'''Navaid :''' navigation. Elle peut se faire soit librement soit par le pilote automatique ; il passe par des points précis (des balises) et plusieurs autres paramètres. 
 
=== O ===
'''*Outside :''' à l'extérieur . Exemple : température extérieure. 
 
=== P ===
'''Pitch :''' tangage. ce mouvement de l'avion affecte son assiette. IL se contrôle avec les gouvernes de profondeur (voir "elevator" ci-dessus). 
'''PAPI (Precision Approach Path Indicator ) :''' indicateur de trajectoire d'approche de précision. Ce système d'éclairage placé à côté de la piste se compose de deux, trois, ou quatre boîtes de lumineuses et donne à l'avion une indication visuelle de sa position verticale sur la trajectoire idéale de descente associée à la piste. Selon le nombre de lumières au blanc ou au rouge, la position de l'avion doit être rectifiée : 4 lumières blanches = Trop haut, 3 lumières blanches et 1 lumière rouge = Un peu haut , 2 lumières blanches et 2 lumières rouges = parfait , 3 lumières rouges et 1 lumière blanche = Un peu bas , 4 lumières rouges = Trop bas. 
 
'''Propeller :''' hélice. 
 

=== Q ===
// 
 
=== R ===
'''Radio :''' radiocommunication. 
'''Roll :''' roulis. Contrôlé par les ailerons. 
'''Route :''' route aérienne. 
'''Rudder :''' gouverne de direction. Place généralement sur lla dérive, elle agit sur les mouvements en lacet de l'avion (~ cap). 
'''Runway :''' piste de décollage et d'atterrissage. 
 

=== S ===
'''Short take off :''' décollage court (longueur de piste). Généralement couplé avec atterrissage court, on parle alors d'avions STOL (short take off and landing). 
'''Speed brake :''' aérofrein. c'est un dispositif générateur de turbulences aérodynamiques servant à augmenter la traînée ou diminuer la portance. Voir [http://fr.wikipedia.org/wiki/A%C3%A9rofrein Aérofreins] sur Wikipédia. 
'''Stall :''' décrochage. En simplifiant, le décrochage se produit si le flux d'air se décolle du profil de l'aile, annihilant la portance: l'avion tombe. Le décrochage se ressent avant de se produire, notamment par le manche qui se met à vibrer. Cet effet permet au pilote de rétablir son appareil dans une configuration de vol convenable. Il existe des instruments indiquant au pilote l'approche du décrochage, soit par une alarme sonore (stall horn), soit par une alarme lumineuse, ou une combinaison des deux: "stall warning". 
'''*Storm :''' orage, tempête. 
 

=== T ===
'''TACAN (Tactical Air Navigation) :''' navigation aérienne tactique. Système de navigation utilisé par les avions militaires. Il fournit, au pilote par exemple, une distance entre lui et son porte-avion. 
'''Take Off :''' décollage. 
'''Touch down :''' atterrir. 
 
=== U ===
// 
 
=== V ===
'''VOR''' : radiobalises. Ce sont des balises permettant de se guider à l'aidee de la radio. Voir l'article [[Fr/Radiobalises|Radiobalises]]. 
 
=== W ===
'''*Weather :''' temps (météo). L'expression "Weather report" désigne les prévisions météo. 
'''Wheel :''' roue. 
'''Wing :''' aile d'avion. 
'''*WOW :''' abréviation de "Weight On Wheel", littéralement "poids sur la roue". C'est une propriété qui permet de détecter si la roue touche le sol. 
 
=== X ===
/// 
 
=== Y ===
'''Yaw :''' lacet. Contrôlé par la gouverne de direction. 
 

=== Z ===
//

Fr/Comment fonctionne le projet Flightgear

2016-04-17T17:00:29Z

Favdb:

{{Working together}}
Comme d'années en années FlightGear devient de plus en plus populaire, nous avons pu voir nombre de controverses sur les rouages du projet FlightGear. Il est un fait bien connu parmi les contributeurs de longue date que le modèle de développement de FlightGear peut sembler irritant au premier abord et il est connu pour provoquer des confusions ou même des frustrations parmi les nouveaux contributeurs qui peuvent déjà avoir une expérience de contribution dans d'autres communautés de Flight Sim ou même d'autres logiciels Open Source. Alors, voici une collection de réponses destinées à clarifier pourquoi les choses sont mises en place de cette façon. Les personnes qui désirent s'impliquer dans la communauté FlightGear et contribuer d'une manière ou d'une autre, sont encouragés à lire ceci et comprendre comment FlightGear a pu être couronnée de succès, malgré le fait qu'il n'a pas de support commercial ni un modèle de développement vraiment structuré.

Une version plus succincte de cet article peut être trouvée à: http://forum.flightgear.org/viewtopic.php?f=42&t=15267 (c'est une très bonne introduction, les personnes intéressées par plus de détails, peuvent lire le texte qui suit).

== Contexte ==
Comme FlightGear devient de plus en plus populaire, nous voyons, chaque semaine, de nouveaux utilisateurs fréquenter notre forum et suivre la liste de diffusion. Beaucoup d'entre eux souhaitent contribuer à FlightGear d'une manière ou d'une autre et s'impliquer dans notre communauté.

Ceci est quelque chose que nous apprécions tous, parce qu'il est important pour maintenir le projet en vie et dynamique, de sorte à mieux accueillir les nouveaux membres de la communauté, et parce que c'est une part importante de la popularité de FlightGear.

Il y a de multiples façons de vous impliquer dans FlightGear, ainsi les compétences de chacun peuvent s'exprimer.

S'il vous plaît, ne pensez pas que vous ne pouvez pas participer au projet, parce que vous ne savez pas programmer ou parce que vous ne pouvez pas concevoir des modèles 3D. La création d'un simulateur de vol est une entreprise énorme et il y a beaucoup de tâches qui peuvent sembler moins évidente pour les étrangers, comme aider à maintenir le wiki, modérer le forum, signaler des spam, trier le bug tracker, examiner les rapports de bugs, aider d'autres utilisateurs et ainsi de suite.

== Irritations et frustrations ==
Parfois, on peut constater quelques irritations entre les nouveaux membres de la communauté et les membres les plus expérimentés. Les gens peuvent avoir certaines attentes pour contribuer à FlightGear. Cette situation a souvent causé quelques discussions passionnées, parfois même des batailles rangées, à la fois sur la liste de diffusion de développement et les forums.

Apparemment, cela se produit fréquemment avec des gens qui ont déjà une expérience en développement logiciel ou de contribution à des logiciels libres, que ce soit à titre professionnel ou comme un hobby.

Au fil des ans, ces discussions ont eu lieu de plus en plus souvent et ils sont fortement consommateurs de ressources, étant donné que le temps libre est notre ressource la plus précieuse pour contribuer au projet.

Il semble que certaines personnes essaient d'appliquer leurs propres expériences et leurs habitudes à FlightGear, comme dans tout projet de développement de logiciels. C'est parfois à l'origine de désillusion et colère parce FlightGear semble si différent de tout ce qu'ils peuvent déjà connaître.

La meilleure approche en rencontrant ces problèmes consiste à prendre du recul, évaluer les objectifs et les moyens disponibles, et de revenir avec des solutions ou des propositions valables. Plusieurs développeurs ont pris de longues pauses, puis reviennent contribuer à de nombreuses fonctionnalités.

[[Category:Development]]
[[Category:Développement collaboratif]]
[[en:How the FlightGear project works]]

Fr/YASim

2016-03-23T09:44:58Z

Favdb: /* Surfaces */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

=== Surfaces ===
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

=== Motorisation ===
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

=== Atterrisseurs ===
===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:42:34Z

Favdb: /* gear */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

=== Motorisation ===
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

=== Atterrisseurs ===
===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:40:45Z

Favdb: /* Engine */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

=== Motorisation ===
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:40:07Z

Favdb: /* Fuel */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

=== Fuel ===
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:39:40Z

Favdb: /* Treuillage et Remorquage */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

=== Treuillage et Remorquage ===
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:39:16Z

Favdb: /* Controls */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

=== Contrôles ===
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T09:38:33Z

Favdb: /* Centre de gravité */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

=== Centre de gravité ===

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-03-23T06:29:19Z

Favdb: /* control-input */

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-27T09:59:07Z

Favdb:

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
== Notes à propos du système de coordonnées ==
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

== Élements [[XML]] ==
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-27T09:57:33Z

Favdb:

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le modèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaissez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-27T09:56:20Z

Favdb:

'''YASim''' est l'un des deux moteurs de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le mdèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaîssez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-27T09:55:40Z

Favdb:

'''YASim''' est l'un des deux moteur de simulation dans [[FlightGear]]. Les modèles de vol dynamiques (flight dynamics model en anglais, soit FDM en abrégé) déterminent comment l'aéronef ([[aircraft]]) se déplace et vole.

Gary Neely écrivait dans [http://www.buckarooshangar.com/flightgear/ introduction to YASim]:

:''Le FDM est le mdèle mathématique qui contrôle le vol dans le simulateur. La physique du modèle d'avion 3D n'a rien à voir avec les principes de la physique dynamique, ça n'en est qu'une simple une représentation virtuelle. C'est le FDM qui détermine comment le modèle vole.''

:''Pourquoi YASim? YASim utilise la géométrie de l'avion pour générer les caractéristiques de base du vol. Il suggère une approche réaliste en mode prêt à l'emploi (out-of-the-box), il s'agit d'une approximation grossière qui exigera beaucoup de peaufinage avant d'obtenir un résultat qui se rapproche de la réalité. Si vous avez des données de vol solides pour votre avion, tels que les données en soufflerie, ou si vous êtes à la recherche, à terme, d'une simulation hyper-réaliste, JSBSim aura probablement une meilleure approche. Si vous ne disposez pas de ces données, mais que vous connaîssez la géométrie de l'avion et que vous connaissez les caractéristiques de vol, et de leurs limites, comme un vrai pilote, alors YASim peut fournir une solution qui est plus que suffisant pour la plupart des besoins de simulation.''
'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:15:55Z

Favdb: /* Treuil et Remorquage */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuillage et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:14:59Z

Favdb:

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités métriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:14:21Z

Favdb:

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mÉtriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:11:07Z

Favdb: /* Elements XML */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Élements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:08:25Z

Favdb: /* Visualization */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualisation ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]Pour rendre l'appareil programmé visible, il est possible de charger et de le comparer avec le modèle 3D dans [[Blender]]. Les acclamations pour ce script "très" utile iront à M. Franz, merci beaucoup!

Le script est situé dans le code source de FlightGears [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

La mise en oeuvre est indiqué dans le script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:04:35Z

Favdb: /* winch */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
Câble utilisé pour le remorquage ou le treuillage. Doit être un élément d'un sous élément <hitch>
* '''max-tow-length:''' en mètre
* '''min-tow-length''': en mètre
* '''initial-tow-length:''' en mètre. La longueur de remorquage initiale définit également le rayon longueur/recherche utilisé pour la mp-auto-connect
* '''max-winch-speed:''' en m/s
* '''power:''' en kW
* '''max-force:''' en N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T11:00:57Z

Favdb: /* tow */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
La remorque utilisée pour le remorquage ou le treuillage. Ceci doit être un sous élément inclus dans un <hitch>.
* '''length:''' Longueur au repos, en mètres
* '''weight-per-meter:''' Poids en kg/mètre
* '''elastic-constant:''' Des valeurs plus faibles donnent une plus grande élasticité
* '''break-force:''' en N
* '''mp-auto-connect-period:''' Toutes les x secondes un avion remorqué en multijoueur est recherché. Si trouvé, ce câble est automatiquement connecté, les paramètres sont copiés à partir de l'autre aéronef. Il doit être défini que dans l'avion motorisé, pas dans le planeur.

===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:55:00Z

Favdb: /* Winch and Aerotow */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Treuil et Remorquage ====
===== hitch =====
Un attelage peut être utilise pour une lancement au treuil (pour les planneurs) ou pour le remorquage (planeurs par un avion motorisé) ou pour un chargement externe avec un hélicoptère. Vous pouvez utiliser le remorquage via le réseau en multi-joueurs (voir j3 et bocian pour un exemple).
* '''name:''' Nom de l'attelage. Doit être un remorquage si vous voulez l'utiliser pour un remorquage multi-joueurs. Vous trouverez plusieurs propriétés dans /sim/hitches/name. La plupart d'entre elles sont directement liés aux variables internes, vous pouvez les modifier à votre convenance. Vous pouvez ajouter un listener à la propriété "broken", par exemple pour jouer un son.
* '''x,y,z:''' Position de l'attelage.
* '''force-is-calculated-by-other:''' Si vous voulez simuler un remorquage via le réseau, mettez cette valeur à "1" dans le moteur de l'avion. Ne l'utilisez pas et ne mettez pas une valeur zéro pour les planeurs. Dans un réseau local le délai pourrait être assez petit pour le mettre sur les deux appareils à "0". L'objectif est que cela se fasse automatiquement à l'avenir.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:37:53Z

Favdb: /* control-setting */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:37:16Z

Favdb: /* control-setting */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
Ce paramètre est utilisé pour définir une valeur spéciale pour un contrôle d'axe dans les parties <cruise> ou <approach>, lorsque l'accès à cette propriété n'est pas disponible. Vous pouvez l'utiliser, par exemple, pour indiquer au solver que les valeurs de l'approche doivent vérifier que la position des volets, etc...
* '''axis:''' Nom de l'axe du contrôle à vérifier (par exemple un nom de propriété)
* '''value:''' Valeur du contrôle d'axe.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:32:52Z

Favdb: /* control-speed */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est à moitié obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:31:11Z

Favdb: /* control-input */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Élément qui gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide pour le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Nom de la valeur double du paramètre FGFS "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel contrôle d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - Manette des gaz sur un jet ou une hélice.
** MIXTURE - Mélange sur une hélice.
** REHEAT - Post-combustion pour un jet
** PROP - Avance pour une hélice
** BRAKE - Frein sur une roue.
** STEER - Angle de braquage sur une roue.
** INCIDENCE - Angle d'incidence d'une aile.
** FLAP0 - Déflexion du flap0 d'une aile.
** FLAP1 - Déflexion du flap1 d'une aile.
** SLAT - Extension d'une lamelle d'une aile.
** SPOILER - Extension de spoiler pour une aile.
** CYCLICAIL - Entrée cyclique "aileron" d'un rotor
** CYCLICELE - Entrée cyclique "elevator" d'un rotor
** COLLECTIVE - Entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - Vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:26:42Z

Favdb: /* Weight */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
Masse ajoutée, qui ne fait pas partie de la masse à vide de l'avion, tel que passager(s), fret, emport externe. La masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de contrôler cette masse (charger du fret, larguer des bombes, etc...).
* '''x,y,z:''' Comme d'habitude :)
* '''mass-prop:''' Nom de la propriété contenant la masse, en livres (pounds), de ce poids.
* '''size:''' Taille aérodynamique, en mètres, de cet objet. Ceci est important pour les magasins externes, ce qui entraînera une traînée. Pour des trucs assez aérodynamique comme des bombes, la taille devrait être à peu près la largeur de l'objet. Pour d'autres choses, vous êtes libre de vos choix. La valeur par défaut est égale à zéro, ce qui se traduit par "aucune force aérodynamique" (exemple d'une charge cargo interne).
* '''solve-weight:''' Sous élément de paramètres d'approche et croisière. Utilisez une valeur différente de zéro pour indiquer au solveur un poids (<weight>). La valeur par défaut est permet de s'assurer que tous les poids sont à zéro aux nombres des performances données.
* '''idx:''' Indexe du poids dans le fichier (à partir de 0).
* '''weight:''' Poids en livres (pounds).

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:17:22Z

Favdb: /* Ballast */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
Mécanisme pour modifier la répartition des masses de l'avion, un "ballast" indique qu'une telle partie de la masse à vide de l'avion est placée à cet endroit. Le reste de la masse est distribuée "intelligemment" parmi les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi que le tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d'"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:16:02Z

Favdb: /* tank */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Réservoir d'essence. Les réservoirs de l'avion sont identifiés par des numéros (en commençant par 0, dans l'ordre de la définition dans le fichier de yasim - notez qu'un nom peut être affecté à chaque réservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du réservoir.
* '''capacity:''' Capacité maximum, en livres (pounds). -- YASim supportes plusieurs densités de fuel.
* '''jet:''' Valeur booléenne, si présent, le fuel est traité comme du "jet-A" sinon c'est la densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:13:47Z

Favdb: /* hook */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====
Spécifie un crochet d'arrêt pour les porte avions. (voir ci-dessus pour les définitions)
* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:13:07Z

Favdb: /* launchbar */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Définit une barre ou une sangle de catapultage.
* '''x,y,z:''' Emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' Longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' Angle maximum vers le bas que la barre peut atteindre.
* '''up-angle:''' Angle maximum vers le haut.
* '''holdback-{x,y,z}:''' Emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:11:54Z

Favdb: /* gear */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Définit un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au braquage. Peut aussi être utilisé pour simuler des flotteurs, même si les coefficients sont toujours appelés ..fric, ils sont calculés comme une traînée dans un fluide, (proportionnel au carré de la vitesse). Dans les fluides ils ne détectent pas les crashes, contrairement au sol.
* '''x,y,z:''' Position de la pointe du train à pleine extension.
* '''compression:''' Distance en mètres le long de l'axe de compression de laquelle le train se compresse.
* '''initial-load:''' Charge initiale du ressort, en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' Direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coefficient de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coefficient de friction dynamique, 0.7 par défaut.
* '''spring:''' Facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le monter trop haut, de hautes forces d'amortissement peuvent rendre instable les valeurs numériques. Si vous ne pouvez empêcher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' Si ceci est mis à "0" le train sera ignoré si dans l'eau, "0" par défaut.
* '''on-solid:''' Avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' Vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' Pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1. L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' À pleine extension, la friction est réduite de cette valeur relative. 0.7 donne 30% de friction à pleine extension. Si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. Valeur "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs ensembles de train pour un avion, si le solveur les prenait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. Valeur "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calcul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T10:04:44Z

Favdb: /* Propeller */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' Position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sous élément <actionpt>.
* '''mass:''' Masse de l'ensemble, en livres (pounds).
* '''moment:''' Moment, en kg*m^2, qu'il faut le calculer à la main et plus ou moins le deviner. Utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur). Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Rayon de l'hélice.
* '''cruise-speed:''' Vitesse d'efficacité maximum de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' Vitesse de rotation de l'hélice à efficacité maximum (rad/s).
* '''cruise-power:''' Puissance utilisée par l'hélice à efficacité maximum, en chevaux (hp).
* '''cruise-alt:''' Altitude de référence pour le "cruise" , en pieds (feet).
* '''takeoff-power:''' Puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' Vitesse de rotation minimale pour une hélice à vitesse constante. C'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au minimum. À noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' Vitesse de rotation maximum pour une hélice à vitesse constante, comme ci-dessus, c'est la butée de petit pas qui empêche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. Valeur de 0.25 par défaut. Une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas maximum de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale. Valeur 4.0 par défaut. Une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel il faut multiplier la vitesse des tours moteur pour obtenir la vitesse de rotation de l'hélice, optionnel (valeur de 1.0 par défaut).
* '''contra:''' Indique que l'hélice est une paire contra-rotative, si (contra="1"), il n'y aura pas d'influence sur le moment gyroscopique, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro-asymétrique.
* '''piston-engine:''' Définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance maximum du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:55:58Z

Favdb: /* Jet */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple ou double flux). Il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' Emplacement du réacteur (son centre de gravité), si on ne donne pas de "actionpt", c'est aussi le point d'application de la poussée.
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' Poussée maximum avec post combustion (PC), en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse maximum de l'étage haute pression [103].
* '''tsfc:''' Consommation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection maximum en noeuds (knots) [~1555].
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:52:30Z

Favdb: /* Thruster */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). Il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consomme pas de fuel.
* '''thrust:''' Poussée maximum en livres (pounds)
* '''x,y,z:''' Point d'application de la poussée.
* '''vx,vy,vy:''' Direction de la poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:51:17Z

Favdb: /* flap0, flap1, slat, spoiler */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
Sous éléments des objets "wing/hstab/vstab", qui précisent l'emplacement et l'efficacité des surfaces de contrôle.
* '''start:''' Position le long de l'aile où la surface commence, Zéro et l'emplanture, 1 le saumon d'aile.
* '''end:''' Fin de la surface, comme ci dessus.
* '''lift:''' Coefficient multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complètement sorti. 1 est sans effet. Un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler. Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente, ils ne détruisent que la portance "pré-décrochage". Il reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. C'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Coefficient de multiplication de la traînée, comme ci-dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement applicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à l'angle d'attaque de décrochage lorsque les becs sont complètement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:47:41Z

Favdb: /* stall */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Sous élément d'une aile (wing ou hstab, mstab et vstab) qui donne le comportement au décrochage.
* '''aoa:''' Angle de décrochage (portance maximum) en degrés. Notez que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' "Progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' Hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. Appelez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:45:16Z

Favdb: /* vstab */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. La surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche! Le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:44:11Z

Favdb: /* hstab */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en définir qu'une. Le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.

===== vstab =====
Un stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. la surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche ! le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:43:27Z

Favdb: /* wing */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Caractérise l'aile principale de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous). L'aile doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de contrôle (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de contrôle.

* '''x,y,z:''' Position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' Longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' Corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' Incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entraînement).
* '''twist:''' Différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche après l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' Fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur 1 par défaut.
* '''sweep:''' Flèche de l'aile , en degrés. Zéro correspond à une aile droite, un angle positif à une flèche vers l'arrière. Valeur 0 par défaut.
* '''dihedral:''' Dièdre de l'aile, un dièdre positif correspond à une aile qui part vers le haut à ses extrémités. Valeur 0 par défaut
* '''idrag:''' Facteur pour la traînée induite du profil (traînée proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de traînée induite que celles à fort allongement (comme les planeurs). Cette valeur n'est pas très bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la traînée "normale" de l'aile, valeur 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' Portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Ceci caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en definir qu'une. le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.
===== vstab =====
Un stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. la surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche ! le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:36:02Z

Favdb: /* fuselage */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée décimale en fraction de la largeur (width) (valeur entre 0 et 1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coefficient multiplicateur pour la traînée induite générée par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les traînées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 (surface visible deux fois plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Ceci caractérise l'aile principales de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous).l'ailes doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de control (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de controle.

* '''x,y,z:''' La position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' la longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' la corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' L'incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entrainements).
* '''twist:''' La différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche aprés l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' la fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur de 1 par défaut.
* '''sweep:''' La flèche de l'aile , en degrés. Zero correspond à une aile droite, un angle positif à une flèche vers l'arrière. valeur 0 par défaut.
* '''dihedral:''' le dièdre de l'aile, un diédre positif correspond à une aile qui part vers le haut à ses extrémités. 0 par défaut
* '''idrag:''' facteur pour la trainée induite du profil (trainé proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de trainée induite quecelles à fort allongement (planeurs).Cette valeur n'est pas trés bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la trainée "normale" de l'aile, 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' La portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Ceci caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en definir qu'une. le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.
===== vstab =====
Un stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. la surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche ! le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:33:09Z

Favdb: /* cockpit */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
Position dans le cockpit du point de vue du pilote.
* '''x,y,z:''' position du point de vue du pilote (voir note sur les coordonnées).

==== fuselage ====
Ceci défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée en fraction de la largeur (width) (0-1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coeff multiplicateur pour la trainée induite généré par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les trainées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 ( surface visible deux foix plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Ceci caractérise l'aile principales de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous).l'ailes doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de control (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de controle.

* '''x,y,z:''' La position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' la longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' la corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' L'incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entrainements).
* '''twist:''' La différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche aprés l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' la fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur de 1 par défaut.
* '''sweep:''' La flèche de l'aile , en degrés. Zero correspond à une aile droite, un angle positif à une flèche vers l'arrière. valeur 0 par défaut.
* '''dihedral:''' le dièdre de l'aile, un diédre positif correspond à une aile qui part vers le haut à ses extrémités. 0 par défaut
* '''idrag:''' facteur pour la trainée induite du profil (trainé proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de trainée induite quecelles à fort allongement (planeurs).Cette valeur n'est pas trés bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la trainée "normale" de l'aile, 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' La portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Ceci caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en definir qu'une. le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.
===== vstab =====
Un stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. la surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche ! le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]

Fr/YASim

2016-02-26T09:32:28Z

Favdb: /* cruise */

'''Notes à propos du système de coordonnées :'''
Toutes les positions spécifiées sont en unités mètriques (ce qui est étrange car toutes les autres unités appartiennent au système impérial). L'axe X pointe vers l'avant, le Y vers la gauche et le Z vers le haut. Prenez votre main droite et tenez là comme un pistolet. L'index est l'axe X, le majeur est l'axe Y et le pouce qui pointe vers le haut est l'axe Z. C'est légèrement différent du système de coordonnées utilisé par JSBSim, désolé :) . L'origine peut être placée n'importe où, mais doit être la même pour l'ensemble de l'appareil. J'utilise le nez de l'avion.

=== Elements [[XML]] ===
==== airplane ====
La balise racine du fichier ne contient qu'un seul attribut:
* '''mass:''' La masse à vide (sans fuel) en livres (une livre= 454gr). Ce poids inclus celui des moteurs, donc lorsqu'on ajoute le poids du moteur dans ses balises, il est considéré comme un ballast.

==== approach ====
Paramètres d'approche de l'avion, le solveur va générer un avion qui respecte ces valeurs. La balise peut (et devrait) contenir des éléments <control> qui indiquent la configuration de l'avion, tels que les volets ou les gaz, lors de l'approche.
* '''speed:''' Vitesse d'approche, en noeuds (knots) TAS. (1 noeud = 1 mile nautique/heure soit 1.852 km/h) (TAS = vitesse vraie)
* '''aoa:''' Angle d'attaque d'approche, exprimé en degrés
* '''fuel:''' Fuel restant dans les réservoirs, valeur décimale comprise entre 0 et 1 (0=0% et 1=100%). Par défaut la valeur est 0.2 (ce qui correspond à 20%).

==== cruise ====
Vitesse de croisière que doit utiliser le solveur. Comme pour l'approche, il devrait contenir des tags <control> qui donnent la configuration de l'avion. assurez vous particulièrement que les moteurs procurent assez de poussée!
* '''speed:''' Vitesse de croisière, en noeuds (knots) TAS
* '''alt:''' Altitude de croisière, en pieds MSL (1 pied = 0.3048m) (MSL=au desssus du niveau de la mer)
* '''fuel:''' Portion de fuel restant dans les réservoirs (valeur entre 0 et 1). Par défaut la valeur est 0.2 (soit 20%).

==== cockpit ====
position dans le cockpit (point de vue du pilote).
* '''x,y,z:''' position du point de vue du pilote (cf note sur les coordonnées).

==== fuselage ====
Ceci défini une structure en forme de tube. Le solveur va lui donner une masse et une distribution de force aérodynamiques également répartie vous pouvez en mettre autant que vous voulez dans toutes les positions possibles.
* '''ax,ay,az:''' Un bout du tube (en général l'avant).
* '''bx,by,bz:''' L'autre bout (l'arrière).
* '''width:''' La largeur du tube, en mètres.
* '''taper:''' Le rayon approximatif du tube à la pointe du fuselage, donnée en fraction de la largeur (width) (0-1).
* '''midpoint:''' La position de la partie la plus large du fuselage, donnée par une fraction de la distance entre A et B.
* '''idrag:''' coeff multiplicateur pour la trainée induite généré par cet objet, 1 par défaut. Si idrag=0, le fuselage ne crée que de la trainée (drag).

* '''cx,cy,cz:''' Facteurs de correction pour les trainées générées dans le système de coordonnées locales, par exemple un fuselage deux fois plus haut que large, on peux donner un cy=2 ( surface visible deux foix plus importante suivant y, l'axe des ailes), ainsi qu'un cx=2 (à cause du doublement de la surface frontale).

==== Surfaces ====
===== wing =====
Ceci caractérise l'aile principales de l'avion. Il ne peut y en avoir qu'une (mais vous pouvez ajouter d'autre surfaces portantes avec des fstab, voir ci-dessous).l'ailes doit avoir un élément <stall> qui indique le comportement au décrochage, ainsi que des sous éléments de surfaces de control (flap0, flap1, spoiler, slat) qui définissent les surfaces de contrôle. Enfin des <control> permettent d'affecter les propriétés aux surfaces de controle.

* '''x,y,z:''' La position de l'emplanture de l'aile, donnée par le point milieu de la corde à la racine de l'aile GAUCHE (!) (ce n'est pas le centre de poussée).
* '''length:''' la longueur de l'aile de son emplanture jusqu'au point milieu du saumon d'aile. A noter que ce n'est pas l'envergure.
* '''chord:''' la corde de l'aile à son emplanture, selon l'axe des X (et non pas perpendiculaire au bord d'attaque, comme on la trouve parfois définie).
* '''incidence:''' L'incidence de l'aile à son emplanture, en degrés. Zéro correspond à une aile alignée avec le fuselage (comme sur un avion de voltige). Une valeur positive indique que le bord d'attaque est plus haut que le bord de fuite (comme sur les avions d'entrainements).
* '''twist:''' La différence d'incidence entre l'emplanture et le saumon. Ceci est typiquement négatif, de telle sorte que le saumon ait un plus petit angle d'attaque, et décroche aprés l'emplanture (washout). Ceci permet de garder les ailerons effectifs et limite le départ en vrille.
* '''taper:''' la fraction qui donne le "pointu" de l'aile, donné par la longueur de la corde au saumon divisé par celle de l'emplanture. Un "taper" de 1 donne une aile rectangle, alors que 0 forme une aile se terminant par un point. Valeur de 1 par défaut.
* '''sweep:''' La flèche de l'aile , en degrés. Zero correspond à une aile droite, un angle positif à une flèche vers l'arrière. valeur 0 par défaut.
* '''dihedral:''' le dièdre de l'aile, un diédre positif correspond à une aile qui part vers le haut à ses extrémités. 0 par défaut
* '''idrag:''' facteur pour la trainée induite du profil (trainé proportionnelle à l'angle d'attaque de l'aile). En général, les ailes de faible allongement ont plus de trainée induite quecelles à fort allongement (planeurs).Cette valeur n'est pas trés bien prise en compte par le solveur, et peut demander du réglage pour avoir les gaz corrects à de hauts angles d'attaque (approches).
* '''effectiveness:''' Multiplicateur pour la trainée "normale" de l'aile, 1 par défaut, facteur arbitraire sans dimension.
* '''camber:''' La portance produite par l'aile pour un angle d'attaque nul, donné par la fraction par rapport à la portance maximale à l'angle d'attaque de décrochage. se déduit de la courbe portance/aoa, nulle pour les ailes d'avions de voltige à profil symétriques.

===== hstab =====
Ceci caractérise le stabilisateur horizontal de l'avion. C'est une aile aussi et elle utilise donc les mêmes paramètres. Vous ne pouvez en definir qu'une. le solveur doit savoir avec quelle incidence jouer pour trimmer l'avion correctement.
===== vstab =====
Un stabilisateur "vertical", comme le hstab, il s'agit d'une aile, avec quelques propriétés spéciales. la surface n'est pas symétrisée en miroir, si vous ne définissez qu'une aile gauche, vous n'avez qu'une aile gauche ! le dièdre par défaut est égal à 90 degré (aile verticale vers le haut), mais tous ses paramètres sont modifiables, donc elle n'a pas d'obligation à être verticale. Il est possible de l'utiliser pour ce que vous voulez, comme une aile supplémentaire pour les biplans. Attention, ces surfaces ne sont pas utilisées par le solveur, donc vous pouvez n'en avoir aucune, ou autant que faire se peut.

===== mstab =====
une aile en miroir horizontale, exactement comme une aile, sauf qu'elle n'est pas utilisée par le solveur. possibilité de l'utiliser sans limite...

===== stall =====
Un sous élément d'un "wing" (ou hstab, mstab et vstab) qui donne le comportement du décrochage.
* '''aoa:''' l'angle de décrochage (portance maximum) en degrés. prenez note que c'est l'angle d'attaque de l'aile, et non pas du fuselage (si l'aile à une incidence non nulle/fuselage).
* '''width:''' La "progressivité" du décrochage, en degrés. Une valeur haute donne un décrochage progressif. Les valeurs basses sont traîtres pour des ailes non vrillées, mais conviennent pour des ailes à variation d'incidence, (l'aile ne décroche alors pas de partout en même temps).
* '''peak:''' la hauteur du pic de portance secondaire après décrochage vers les 45 degrés, 1.5 par défaut. Ceci sort d'un chapeau, et n'a probablement pas besoin de trop bouger. appellez moi pour une explication si vous êtes curieux (NDT: le rédacteur original de l'aide, pas moi, je ne suis pas fort en magie :) )).

===== flap0, flap1, slat, spoiler =====
ce sont des sous éléments des objets "wing/hstab/vstab, qui précisent l'emplacement et l'efficacité des surfaces de controle.
* '''start:''' La position le long de l'aile où la surface commence, Zéro et l'amplenture, 1 le saumon d'aile.
* '''end:''' la fin de la surface, comme ci dessus.
* '''lift:''' Le coeff multiplicateur de la portance pour un aileron, un volet (flap), ou un spoiler complétement sorti. Un est sans effet, un aileron typique est autour de 1.2, des volets de jumbo-jet 2.0, et 0.0 pour un spoiler . Pour les spoilers (destructeurs de portance) l'interprétation est légèrement différente: Ils ne détruisent que la portance "pré-décrochage". IL reste la portance due à "l'effet de plaque". Les ailes qui décrochent à faible angle d'attaque ont la majorité de la portance pré-décrochage, et la portance non détruite est faible. c'est l'inverse pour les jets de combat qui n'ont souvent pas de spoilers pour ces raisons. Le "lift" ne s'applique pas aux "slat" qui changent seulement l'angle d'attaque du décrochage.
* '''drag:''' Le coeff de multiplication de la trainée, comme dessus, doit être plus grand que le "lift" pour des volets.
* '''aoa:''' seulement aplicables aux "slat" (bec de bord d'attaque), cette valeur donne l'angle ajouté à langle d'attaque de décrochage lorsque les becs sont complétement sortis.

==== Engine ====
===== Thruster =====
Un simple objet qui produit juste une poussée, utile pour des trucs comme les jets vectoriels ou pour simuler une poussée inverse sur les avions à hélice (ainsi par exemple la simulation d'effet de flux d'air d'hélice sur le rudder à l'arrêt NdT). il se contente de mapper son entrée "THROTTLE" sur son taux de poussée, il ne consome pas de fuel.
* '''thrust:''' La poussée max en livres (pounds)
* '''x,y,z:''' Le point d'application de la poussée.
* '''vx,vy,vy:''' La direction de poussée dans les coordonnées de l'avion, ce vecteur est normalisé automatiquement, du coup tout vecteur non nul fait l'affaire.

===== Jet =====
Un turboréacteur (simple/double flux). il accepte un <control> pour utiliser une propriété à son réglage de puissance, et un <actionpt> pour placer le point de poussée à un autre endroit que la masse du réacteur.
* '''x,y,z:''' L'emplacement du réacteur, ( son centre de gravité), si on ne donne pas de "actionpt", c'est ausssi le point d'application de la poussée.
* '''mass:''' La masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''rotate:''' Angle de la poussée en degrés sur l'axe des Y [0].
* '''n1-idle:''' Vitesse au ralenti de l'étage basse pression /ventilateur (pour un turbofan) en pourcentage de la vitesse max [55].
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''tsfc:''' comsomation spécifique de la poussée [0.8]. elle est bien plus basse pour les turbofan de dernière génération.
* '''egt:''' Température des gaz d'échapement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''spool-time:''' Temps , en secondes, pour que le réacteur réponde à 90% de la commande des gaz.

===== Propeller =====
Une hélice, il lui faut un sous élément de moteur, actuellement <piston-engine> and <turbine-engine> sont disponibles.
* '''x,y,z:''' La position de la masse de l'ensemble moteur-propulsion, si le point d'application de la force est différent, il faut un sousélément <actionpt>.
* '''mass:''' La masse de l'ensemble , en livres.
* '''moment:''' Le moment, en kg*m^2, il faut le calculer à la main et plus ou moins le deviner.utilisez un moment négatif pour les hélices tournant dans le sens anti-horaire ("européennes": hélices tournant en sens anti horaire vue de l'arrière du moteur. Une bonne estimation est obtenue par le rayon de l'hélice (en m) mis au carré multiplié par la masse, le tout divisé par 3, c'est le moment d'un bout de bois plein monté sur l'axe d'hélice.
* '''radius:''' Le rayon de l'hélice.
* '''cruise-speed:''' La vitesse d'efficacité max de l'hélice, en général différente de de la "cruise speed" de l'avion.
* '''cruise-rpm:''' La vitesse de rotation de l'hélice a efficacité max (rad/s).
* '''cruise-power:''' La puissance utilisée par l'hélice à eff max, en chevaux.
* '''cruise-alt:''' l'altitude de référence pour le "cruise" , en pieds.
* '''takeoff-power:''' La puissance prise par l'hélice au décollage ...
* '''takeoff-rpm:''' ...à cette vitesse de rotation (rad/s).
* '''min-rpm:''' La vitesse de rotation minimale pour une hélice à vitesse constante, c'est la vitesse que le régulateur de vitesse cherchera à atteindre lorsque l'on met le levier bleu au mini. à noter que la butée de grand pas limite le gestionnaire pour atteindre cette valeur, si trop de puissance est disponible. (rad/s)
* '''max-rpm:''' La vitesse de rotation max pour une hélice à vitesse constante, comme ci dessus, c'est la butée de petit pas qui empèche le gestionnaire d'atteindre cette vitesse, si il n'y a pas assez de puissance. (rad/s)
* '''fine-stop:''' Butée petit pas: le pas minimum de l'hélice (à haut RPM) en pourcentage du pas de vitesse idéale. 0.25 par défaut, une valeur plus haute donne une vitesse de rotation plus faible pour les faibles puissances (taxi, ralenti et approche).
* '''coarse-stop:''' Butée de grand pas: pas max de l'hélice (bas RPM) en pourcentage du pas de vitesse idéale, 4.0 par défaut, une valeur plus basse donne plus de RPM pour des réglages à haute puissance.
* '''gear-ratio:''' Facteur par lequel multiplier la vitesse des tour moteur, pour obtenir la vitesse de rotation de l'hélice, optionnel (défaut de 1.0).
* '''contra:''' Indique que l'hélice est une paire contra rotative, si (contra="1"), il n'aura pas d'influence sur le moment gyroscopic, et ne produira pas un couple asymétrique sur la cellule de l'avion, ni un effet aéro asymétrique.
* '''piston-engine:''' une définition d'un moteur à piston, ceci doit être un sous élément d'un tag <propeller> .
* '''eng-power:''' Puissance max du moteur au niveau de la mer (cheval vapeur - BHP).
* '''eng-rpm:''' Vitesse de rotation du moteur qui correspond à "eng-power".
* '''displacement:''' Volume du moteur (en pouce cubique).
* '''compression:''' Taux de compression du moteur.

===== gear =====
Défini un train d'atterrissage, accepte des sous éléments <control> pour mapper des propriétés au freinage et au bracage.peut aussi être utilisé pour simuler des flotteurs, même si les coeffs sont toujours appellées ..fric, ils sont calculés comme une trainée dans un fluide, (proportionnel au carré de la vitesse). dans les fluides ils ne detectent pas les crashes, contrairement au sol.
* '''x,y,z:''' La position de la pointe du train à pleine extension.
* '''compression:''' La distance en mètres le long de l'axe de compression, de laquelle le train se compresse.
* '''initial-load:''' La charge initiale du ressort , en multiple de la "compression", 0 par défaut, (Avec ce paramètre une valeur plus basse de raideur de ressort est utilisée, ce qui peut réduire des problèmes numériques '''Note:''' la raideur du ressort varie de 0% à 20% de compression, pour avoir un comportement cohérent autour de 0 de compression, ce qui peut être expliqué par la déformation du pneu).
* '''upx/upy/upz:''' direction de la compression, vertical par défaut (0,0,1) le vecteur n'as pas besoin d'être normalisé, la longueur étant donnée par "compression".
* '''sfric:''' Coeff de friction statique (sans glissement), 0.8 par défaut.
* '''dfric:''' Coeff de friction dynamique, 0.7 par défaut.
* '''spring:''' Un facteur sans dimension, pour la constante de raideur générée automatiquement, l'augmenter rend le train plus raide, la diminuer le rend plus souple.
* '''damp:''' Facteur sans dimension, pour la constante d'amortissement générée automatiquement, le diminuer rend le train plus "rebondissant", l'augmenter rend le train plus "lent". Attention à ne pas le le monter trop haut, de hautes forces de damping peuvent rendre instable les valeurs numériques. Si vous ne pouvez empecher le train de rebondir avec cette valeur, essayez plutôt d'augmenter la "compression".
* '''on-water:''' si ceci est mis à "0" le train sera ignoré si dans l'eau."0" par défaut.
* '''on-solid:''' avec ceci à "0" le train sera ignoré si pas dans l'eau, "1" par défaut.
* '''speed-planing:''' vitesse utilisé par "spring-factor-not-planing"
* '''spring-factor-not-planing:''' pour une vitesse nulle, la raideur du ressort est multipliée par "spring-factor-not-planing", au dessus de la vitesse "speed-planing", le facteur est égal à 1, L'idée est d'utiliser ça pour simuler le passage des flotteurs au "plané", speed-planing vaut 0 par défaut, spring-factor-not-planing vaut 1 par défaut.
* '''reduce-friction-by-extension:''' à pleine extension, la friction est réduite de cette valeur relative, 0.7 donne 30% de friction à pleine extension. si vous donnez une valeur plus grande que 1, la friction sera à 0 avant la pleine extension. "0" par défaut.
* '''ignored-by-solver:''' Avec les tags "on-water"/"on-solid", vous pouvez avoir plusieurs set de trainpour un avion, si le solveur les prennait tous en compte, le résultat serait faux, par exemple, donnez cette prop = "1" pour tous les trains inactifs sur la piste. "0" par défaut, à noter que l'on ne peut pas virer tous les trains du calul du solveur :).

===== launchbar =====
Pemet de définir une barre ou une sangle de catapultage.
* '''x,y,z:''' L'emplacement du point de montage de la barre/sangle sur l'avion.
* '''length:''' La longueur de la barre du point de montage à son autre extrémité.
* '''down-angle:''' L'angle max vers le bas que la barre peut atteindre.
* '''up-angle:''' L'angle max vers le haut.
* '''holdback-{x,y,z}:''' L'emplacement sur l'avion du point de montage de la barre de retenue.
* '''holdback-length:''' Longueur de la barre de retenue, Note: les angle "up-angle" et "down-angle" sont les même que ceux de la barre de lancement.

===== hook =====

spécifie un crochet d'arrêt pour les porte avions. (cf ci-dessus pour les définitions)

* '''x,y,z:'''
* '''length:'''
* '''down-angle:'''
* '''up-angle:'

*** traduction en cours***

==== Fuel ====
===== tank =====
Un reservoir d'essence. Les reservoirs de l'avion sont identifiés par des numéros(en commençant par 0, dans l'ordre de la définition dans le fichierde yasim - notez qu'un nom peut être affecté à chaque reservoir dans le fichier -set.xml voir [[Howto: Name fuel tanks]])
* '''x,y,z:''' Emplacement du reservoir.
* '''capacity:''' Capacité max, en livresThe maximum contents of the tank, in pounds. -- YASim supports fuels of varying densities.
* '''jet:''' Un booléen, si présent, le fuel est traité comme du "jet-A" sinon,c'estla densité du kérosène.

==== Centre de gravité ====

===== Ballast =====
C'es un mécanismepour modifier la répartition des masses de l'avion, un ""ballast" indique qu'une telle partie de la masse à vide de l'avion est placé à cet endroit.le reste de la masse est distribuée "intelligemment parmis les fuselages et les ailes. Notez bien que cela ne change pas la masse à vide de l'avion, mais permet de corriger la position du centre de gravité, ainsi quele tenseur d'inertie.
* '''x,y,z:''' Position du ballast.
* '''mass:''' Quelle masse placer ici, elle peut être négative, j'ai souvent besoin d"alléger" la queue de l'avion.

===== Weight =====
C'est une masse ajouté, qui ne fait pas partie de la masse à vide de l'avion, tel que passager, fret, emport externe. la masse n'est pas donnée ici, on donne à la place le chemin d'une propriété, ce qui permet à du code externe de controler cette masse.(charger du fret, larguer des bombesetc...)
* '''x,y,z:''' Comme d'hab :)
* '''mass-prop:''' The name of the fgfs property containing the mass, in pounds, of this weight.
* '''size:''' The aerodynamic "size", in metres, of the object. This is important for external stores, which will cause drag. For reasonably aerodynamic stuff like bombs, the size should be roughly the width of the object. For other stuff, you're on your own. The default is zero, which results in no aerodynamic force (internal cargo).
* '''solve-weight:''' Subtag of approach and cruise parameters. Used to specify a non-zero setting for a <weight> tag during solution. The default is to assume all weights are zero at the given performance numbers.
* '''idx:''' Index of the weight in the file (starting with zero).
* '''weight:''' Weight setting in pounds.

==== Controls ====
===== control-input =====
Cet élément gère une correspondance des propriétés de FGFS (entrée utilisateur) pour définir des valeurs du tableau sur les objets de l'avion. Notez que la valeur à régler DOIT (!) être valide sur le type d'objet donné. Elles ne sont pas vérifiées par l'analyseur, et pourraient causer un plantage d'exécution si vous l'essayez. Ainsi, les ailes n'ont pas de commande de puissance, etc ... Notez que plusieurs axes peuvent être définis pour la même valeur. Elles sont évaluées avant le réglage.
* '''axis:''' Le nom de la valeur double du paramètre fgfs "axis" à utiliser en entrée, comme "/controls/flight/aileron".
* '''control:''' Quel control d'axe à positionner sur les objets. Peut avoir les valeurs suivantes:
** THROTTLE - La manette des gaz sur un jet ou une hélice.
** MIXTURE - Le mélange sur une hélice.
** REHEAT - La post-combustion pour un jet
** PROP - L'avance pour une hélice
** BRAKE - Le frein sur une roue.
** STEER - L'angle de braquage sur une roue.
** INCIDENCE - L'angle d'incidence d'une aile.
** FLAP0 - La déflection du flap0 d'une aile.
** FLAP1 - La déflection du flap1 d'une aile.
** SLAT - L'extension d'une lamelle d'une aile.
** SPOILER - L'extension de spoiler pour une aile.
** CYCLICAIL - L'entrée cyclique "aileron" d'un rotor
** CYCLICELE - L'entrée cyclique "elevator" d'un rotor
** COLLECTIVE - L'entrée collecteur d'un rotor
** ROTORENGINEON - Si non égal à zéro le rotor est en rotation
** WINCHRELSPEED - La vitesse relative de winch
** {... et bien d'autres, voir FGFDM.cpp ...}
* '''invert:''' Valeur négative de la propriété avant positionnement de l'objet.
* '''split:''' Applicable au contrôle des surfaces de l'aile. Positionnez la valeur normale pour l'aile gauche, et la valeur négative pour l'aile droite.
* '''square:''' Carrés de la valeur avant le réglage. Utile pour les contrôles comme la direction qui ont besoin d'une large gamme, avec beaucoup de sensibilité dans le centre. De toute évidence applicable uniquement aux valeurs qui ont une gamme de [-1: 1] ou [0: 1].
* '''src0/src1/dst0/dst1:''' Si elles sont présentes, ces valeurs définissent une application linéaire de la source vers la valeur de sortie. Les valeurs d'entrée dans la gamme src0-src1 sont mappés linéairement vers dst0-dst1, avec réduction pour les valeurs d'entrée qui se trouvent en dehors de la plage.

===== control-output =====
Peut être utilisé pour donner la valeur à un contrôle d'axe YASim (après affectation et mise en correspondance) sur l'arbre des propriétés.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''prop:''' Noeud de propriété devant recevoir la valeur.
* '''side:''' Option, pour les contrôles partagés. Comme "right" ou "left"
* '''min/max:''' Limites à appliquer à la valeur de sortie.

===== control-speed =====
Certains contrôles (plus particulièrement les volets et hydrauliques) ont une vitesse de réaction maximale et ne peuvent pas répondre instantanément aux sollicitations du pilote. Ceci peut être réalisé avec une balise control-speed, qui définit une "période de transition" nécessaire pour parcourir entièrement la plage de valeurs. Notez que cette balise est semi-obsolète, le filtrage de l'entrée de commande complexe peut être réalisé plus efficacement depuis un script Nasal.
* '''control:''' Nom du contrôle d'axe. Voir ci-dessus.
* '''transition-time:''' Temps, en secondes, pour parcourir la plage de valeurs.

===== control-setting =====
This tag is used to define a particular setting for a control axis inside the <cruise> or <approach> tags, where obviously property input is not available. It can be used, for example, to inform the solver that the approach performance values assume full flaps, etc...
* '''axis:''' Name of the control input (i.e. a property name)
* '''value:''' Value of the control axis.

==== Winch and Aerotow ====
===== hitch =====
A hitch, can be used for winch-start (in gliders) or aerotow (in gliders and motor aircraft) or for external cargo with helicopter. You can do aerotow over the net via multiplayer (see j3 and bocian as an example).
* '''name:''' the name of the hitch. must be aerotow if you want to do aerotow via multiplayer. You will find many properties at /sim/hitches/name. Most of them are directly tied to the internal variables, you can modify them as you like. You can add a listener to the property "broken", e. g. for playing a sound.
* '''x,y,z:''' The position of the hitch
* '''force-is-calculated-by-other:''' if you want to simulate aerotowing over the internet, set this value to "1" in the motor aircraft. Don't specify or set this to zero in gliders. In a LAN the time lag might be small enough to set it on both aircraft to "0". It's intended, that this is done automatically in the future.
===== tow =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''length:''' upstretched length in metres
* '''weight-per-meter:''' in kg/metre
* '''elastic-constant:''' lower values give higher elasticity
* '''break-force:''' in N
* '''mp-auto-connect-period:''' the every x seconds a towed multiplayer aircraft is searched. If found, this tow is connected automatically, parameters are copied from the other aircraft. Should be set only in the motor aircraft, not in the glider
===== winch =====
The tow used for aerotow or winch. This must be a subelement of an enclosing <hitch> tag.
* '''max-tow-length:''' in m
* '''min-tow-length''': in m
* '''initial-tow-length:''' in m. The initial tow length also defines the length/search radius used for the mp-autoconnect feature
* '''max-winch-speed:''' in m/s
* '''power:''' in kW
* '''max-force:''' in N

=== Visualization ===
[[File:Yasim_visualisation_dc6.png|thumb|dc6 fdm in Blender]]To make the programmed aircraft visable it is possible to load and compare it with the 3D model within [[Blender]]. The applaud for this ''very'' usefull script goes to M. Franz, thank you very much!

The script is located in FlightGears source code [http://mapserver.flightgear.org/git/?p=flightgear;a=blob_plain;f=utils/Modeller/yasim_import.py;hb=HEAD utils/Modeller/yasim_import.py].

The howto, taken from inside the script:

yasim_import.py loads and visualizes a YASim FDM geometry
=========================================================

It is recommended to load the model superimposed over a greyed out and immutable copy of the aircraft model:

(0) put this script into ~/.blender/scripts/
(1) load or import aircraft model (menu -> "File" -> "Import" -> "AC3D (.ac) ...")
(2) create new *empty* scene (menu -> arrow button left of "SCE:scene1" combobox -> "ADD NEW" -> "empty")
(3) rename scene to yasim (not required)
(4) link to scene1 (F10 -> "Output" tab -> arrow button left of text entry "No Set Scene" -> "scene1")
(5) now load the YASim config file (menu -> "File" -> "Import" -> "YASim (.xml) ...")

This is good enough for simple checks. But if you are working on the YASim configuration, then you need a
quick and convenient way to reload the file. In that case continue after (4):

(5) switch the button area at the bottom of the blender screen to "Scripts Window" mode (green python snake icon)
(6) load the YASim config file (menu -> "Scripts" -> "Import" -> "YASim (.xml) ...")
(7) make the "Scripts Window" area as small as possible by dragging the area separator down
(8) optionally split the "3D View" area and switch the right part to the "Outliner"
(9) press the "Reload YASim" button in the script area to reload the file

If the 3D model is displaced with respect to the FDM model, then the <offsets> values from the
model animation XML file should be added as comment to the YASim config file, as a line all by
itself, with no spaces surrounding the equal signs. Spaces elsewhere are allowed. For example:

<offsets>
<x-m>3.45</x-m>
<z-m>-0.4</z-m>
<pitch-deg>5</pitch-deg>
</offsets>

becomes:



Possible variables are:

x ... <x-m>
y ... <y-m>
z ... <z-m>
h ... <heading-deg>
p ... <pitch-deg>
r ... <roll-deg>

Of course, absolute FDM coordinates can then no longer directly be read from Blender's 3D view.
The cursor coordinates display in the script area, however, shows the coordinates in YASim space.
Note that object names don't contain XML indices but element numbers. YASim_hstab#2 is the third
hstab in the whole file, not necessarily in its parent XML group. A floating point part in the
object name (e.g. YASim_hstab#2.004) only means that the geometry has been reloaded that often.
It's an unavoidable consequence of how Blender deals with meshes.

Elements are displayed as follows:

cockpit -> monkey head
fuselage -> blue "tube" (with only 12 sides for less clutter); center at "a"
vstab -> red with yellow flaps
wing/mstab/hstab -> green with yellow flaps/spoilers/slats (always 20 cm deep);
symmetric surfaces are only displayed on the left side
thrusters (jet/propeller/thruster) -> dashed line from center to actionpt;
arrow from actionpt along thrust vector (always 1 m long);
propeller circle
rotor -> radius and rel_len_blade_start circle, direction arrow,
normal and forward vector, one blade at phi0
gear -> contact point and compression vector (no arrow head)
tank -> cube (10 cm side length)
weight -> inverted cone
ballast -> cylinder
hitch -> circle (10 cm diameter)
hook -> dashed line for up angle, T-line for down angle
launchbar -> dashed line for up angles, T-line for down angles
A note about step (0) for M$ users: the mentioned path is inside the folder where Blender lives, something like <code>C:\Program Files\Blender Foundation\Blender\.blender\scripts</code>.

{{FDM}}

[[en:YASim]]