Fr/YASim: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
Line 81: Line 81:


===== Jet =====
===== 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.
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:''' 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.
* '''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:''' La masse du réacteur, en livres (pounds).
* '''mass:''' Masse du réacteur, en livres (pounds).
* '''thrust:''' La poussée max au niveau de la mer, en livres (pounds).
* '''thrust:''' Poussée maximum au niveau de la mer, en livres (pounds).
* '''afterburner:''' poussée max avec post combustion, en livres (pounds), aucune PC par défaut.
* '''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].
* '''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-idle:''' Vitesse au ralenti de l'étage basse pression/ventilateur (pour un turbofan) en pourcentage de la vitesse maximum [55].  
* '''n1-max:''' Vitesse max basse pression (%) [102].
* '''n1-max:''' Vitesse maximum basse pression (%) [102].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-idle:''' Vitesse au ralenti de l'étage haute pression (%) [73].
* '''n2-max:''' Vitesse max de l'étage haute pression [103].
* '''n2-max:''' Vitesse maximum 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.
* '''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'échapement au décollage [1050].
* '''egt:''' Température des gaz d'échappement au décollage [1050].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''epr:''' Taux de compression du réacteur au décollage [3.0].
* '''exhaust-speed:''' Vitesse d'éjection max en knots [~1555].
* '''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.
* '''spool-time:''' Temps, en secondes, pour que le réacteur réponde à 90% de la commande des gaz.
 


===== Propeller =====
===== Propeller =====

Revision as of 09:55, 26 February 2016

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

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 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 C:\Program Files\Blender Foundation\Blender\.blender\scripts.