Skip to content

JSBSim properties

Gombaris edited this page Jun 24, 2024 · 2 revisions

Warning: Not all properties, listed in the JSBSim reference manual, work in Outerra. You can find verified JSBSim properties on this page.

Propulsion

/engine[0] - First engine. Replace "0" with desired engine number.
/tank[0] - First fuel tank. Replace "0" with desired fuel tank number.

Commands needed to start aircraft

Property Description Usage Type
propulsion/magneto_cmd Command to activate/deactivate magneto this.jsbsim['propulsion/magneto_cmd'] Setter
propulsion/starter_cmd Command to activate/deactivate starter this.jsbsim['propulsion/starter_cmd'] Setter

Other commands

Property Description Usage Type
propulsion/refuel Command to refuel (6000 lbs per minute) this.jsbsim['propulsion/refuel'] Setter
propulsion/fuel_dump Command to dump fuel from all tanks this.jsbsim['propulsion/fuel_dump'] Setter

General

Property Description Units Usage Type
propulsion/engine[0]/thrust-lbs Thrust lbs this.jsbsim['propulsion/engine[0]/thrust-lbs'] Getter
propulsion/tank[0]/contents-lbs Fuel content in selected tank lbs this.jsbsim['propulsion/tank[0]/contents-lbs'] Getter
propulsion/total-fuel-lbs Total amount of fuel lbs this.jsbsim['propulsion/total-fuel-lbs'] Getter
propulsion/tat-r Total temperature, isentropic flow ºR this.jsbsim['propulsion/tat-r'] Getter
propulsion/tat-c Total temperature, isentropic flow ºC this.jsbsim['propulsion/tat-c'] Getter
propulsion/pt-lbs_sqft Total pressure sqft this.jsbsim['propulsion/pt-lbs_sqft'] Getter

Piston engine specific

Property Description Units Usage Type
propulsion/engine[0]/engine-rpm Engine revolutions RPM this.jsbsim['propulsion/engine[0]/engine-rpm'] Getter
propulsion/engine[0]/propeller-rpm Propeller revolutions RPM this.jsbsim['propulsion/engine[0]/propeller-rpm'] Getter
propulsion/engine[0]/power-hp Engine power HP this.jsbsim['propulsion/engine[0]/power-hp'] Getter
propulsion/engine[0]/map-pa Manifold absolute pressure pa this.jsbsim['propulsion/engine[0]/map-pa'] Getter
propulsion/engine[0]/map-inhg Manifold absolute pressure inHg this.jsbsim['propulsion/engine[0]/map-inhg'] Getter
propulsion/engine[0]/oil-pressure-psi Oil pressure psi this.jsbsim['propulsion/engine[0]/oil-pressure-psi'] Getter
propulsion/engine[0]/oil-temperature-degF Oil temperature ºF this.jsbsim['propulsion/engine[0]/oil-temperature-degF'] Getter
propulsion/engine[0]/egt-degF Exhaust gas temperature ºF this.jsbsim['propulsion/engine[0]/egt-degF'] Getter
propulsion/engine[0]/cht-degF Cylinder head temperature ºF this.jsbsim['propulsion/engine[0]/cht-degF'] Getter

Turbine & Turboprop engine specific

Property Description Units Usage Type
propulsion/engine[0]/n1 Nozzle 1 - this.jsbsim['propulsion/engine[0]/n1'] Getter
propulsion/engine[0]/n2 Nozzle 2 - this.jsbsim['propulsion/engine[0]/n2'] Getter

Velocities

Property Description Units Usage Type
velocities/vc-kts Airspeed kts this.jsbsim['velocities/vc-kts'] Getter
velocities/v-down-fps Vertical speed fps this.jsbsim['velocities/v-down-fps'] Getter
velocities/p-rad_sec Roll speed rad/s this.jsbsim['velocities/p-rad_sec'] Getter
velocities/q-rad_sec Pitch speed rad/s this.jsbsim['velocities/q-rad_sec'] Getter
velocities/r-rad_sec Yaw speed rad/s this.jsbsim['velocities/r-rad_sec'] Getter

Attitude

Property Description Units Usage Type
attitude/pitch-rad Pitch rad this.jsbsim['attitude/pitch-rad'] Getter
attitude/roll-rad Roll rad this.jsbsim['attitude/roll-rad'] Getter
attitude/heading-true-rad True heading rad this.jsbsim['attitude/heading-true-rad'] Getter

Position

Property Description Units Usage Type
position/h-sl-ft Altitude above sea level ft this.jsbsim['position/h-sl-ft'] Getter
position/h-sl-meters Altitude above sea level m this.jsbsim['position/h-sl-meters'] Getter
position/h-agl-ft Altitude above ground level ft this.jsbsim['position/h-agl-ft'] Getter

Gears

gear/unit[0] - First wheel. Replace "0" with desired wheel number.

Commands

Property Description Usage Type
gear/gear-cmd-norm Gear retract/extend command this.jsbsim['gear/gear-cmd-norm'] Setter

Positions

Property Description Units Usage Type
gear/unit[0]/steering-angle-deg Angle of the first wheel deg this.jsbsim['gear/unit[0]/steering-angle-deg'] Getter
gear/gear-pos-norm Gear position (retracted/extended) deg this.jsbsim['gear/gear-pos-norm'] Getter

Other

Property Description Units Usage Type
gear/num-units Number of gear units ("BOGEY" + "STRUCTURE" types) deg this.jsbsim['gear/num-units'] Getter

FCS

Commands

Property Description Usage Type
fcs/steer-cmd-norm Steer command this.jsbsim['fcs/steer-cmd-norm'] Setter
fcs/mixture-cmd-norm Mixture command this.jsbsim['fcs/mixture-cmd-norm'] Setter
fcs/throttle-cmd-norm Throttle command this.jsbsim['fcs/throttle-cmd-norm'] Setter
fcs/elevator-cmd-norm Elevator command this.jsbsim['fcs/elevator-cmd-norm'] Setter
fcs/rudder-cmd-norm Rudder command this.jsbsim['fcs/rudder-cmd-norm'] Setter
fcs/aileron-cmd-norm Aileron command this.jsbsim['fcs/aileron-cmd-norm'] Setter
fcs/flap-cmd-norm Flaps command this.jsbsim['fcs/flap-cmd-norm'] Setter
fcs/center-brake-cmd-norm Center brake command this.jsbsim['fcs/center-brake-cmd-norm'] Setter
fcs/left-brake-cmd-norm Left brake command this.jsbsim['fcs/left-brake-cmd-norm'] Setter
fcs/right-brake-cmd-norm Right brake command this.jsbsim['fcs/right-brake-cmd-norm'] Setter

Adding properties to separate engines

You can set property to only one engine, by adding [x] at the end of property name, where "x" is the index of the engine.

Note: for now, it was only tested with mixture and throttle.

Property Description Usage Type
fcs/mixture-cmd-norm[0] Mixture command for engine with index 0 this.jsbsim['fcs/mixture-cmd-norm[0]'] Setter
fcs/throttle-cmd-norm[0] Throttle command for engine with index 0 this.jsbsim['fcs/throttle-cmd-norm[0]'] Setter

Positions

Property Description Units Usage Type
fcs/throttle-pos-norm Throttle position norm this.jsbsim['fcs/throttle-pos-norm'] Getter
fcs/mixture-pos-norm Mixture position norm this.jsbsim['fcs/mixture-pos-norm'] Getter
fcs/elevator-pos-norm Elevator position norm this.jsbsim['fcs/elevator-pos-norm'] Getter
fcs/elevator-pos-rad Elevator position rad this.jsbsim['fcs/elevator-pos-rad'] Getter
fcs/mag-elevator-pos-rad Elevator position using magnitude (radian based absolute version) +rad this.jsbsim['fcs/mag-elevator-pos-rad'] Getter
fcs/rudder-pos-norm Rudder position norm this.jsbsim['fcs/rudder-pos-norm'] Getter
fcs/rudder-pos-rad Rudder position rad this.jsbsim['fcs/rudder-pos-rad'] Getter
fcs/mag-rudder-pos-rad Rudder position using magnitude +rad this.jsbsim['fcs/mag-rudder-pos-rad'] Getter
fcs/left-aileron-pos-norm Left aileron position norm this.jsbsim['fcs/left-aileron-pos-norm'] Getter
fcs/left-aileron-pos-rad Left aileron position rad this.jsbsim['fcs/left-aileron-pos-rad'] Getter
fcs/mag-left-aileron-pos-rad Left aileron position using magnitude +rad this.jsbsim['fcs/mag-left-aileron-pos-rad'] Getter
fcs/right-aileron-pos-norm Right aileron position norm this.jsbsim['fcs/right-aileron-pos-norm'] Getter
fcs/right-aileron-pos-rad Right aileron position rad this.jsbsim['fcs/right-aileron-pos-rad'] Getter
fcs/mag-right-aileron-pos-rad Right aileron position using magnitude +rad this.jsbsim['fcs/mag-right-aileron-pos-rad'] Getter
fcs/flap-pos-rad Flaps position norm this.jsbsim['fcs/flap-pos-rad'] Getter

Aero

Property Description Units Usage Type
aero/alpha-rad Angle between X body axis and X wind axis measured on UV plane rad this.jsbsim['aero/alpha-rad'] Getter
aero/beta-rad Angle between X body axis and X wind axis measured on UW plane rad this.jsbsim['aero/beta-rad'] Getter
aero/mag-beta-rad Angle between X body axis and X wind axis measured on UW plane using magnitude +rad this.jsbsim['aero/mag-beta-rad'] Getter
aero/qbar-psf Dynamic pressure - product of velocity^2*(air density)/2 rad this.jsbsim['aero/qbar-psf'] Getter
aero/qbarUV-psf Value of QBar restricted to the vertical plane (use for formula involving Alpha) rad this.jsbsim['aero/qbarUV-psf'] Getter
aero/qbarUW-psf Value of QBar restricted to the horizontal plane (use for formula involving Beta) rad this.jsbsim['aero/qbarUW-psf'] Getter

Atmosphere

Property Description Units Usage Type
atmosphere/P-psf Atmospheric pressure psf this.jsbsim['atmosphere/P-psf'] Getter

Further readings

https://github.com/Outerra/anteworld/wiki/Aircraft

Test

Clone this wiki locally