SIMOBJECT DEBUG MENU

This page explains the different debug options available to you when using The SimObject Editor (or when debugging an aircraft using the Aircraft menu from the DevMode Debug menu).

SimObject Editor Debug Window

For additional details on using the information provided here, please see the section on Tuning The Flight Model.

 

 

Aircraft Data

The Debug Aircraft Data Window

This window is designed so that you can load in a CSV file with real aircraft data and compare it to the performance of the aircraft in the simulation. When you start a flight, the data for specific items will be recorded - the items being set by the various "Data Feed" parameters - and a sample of the data will also be graphed over time at the bottom of the window. The available options here are as follows:

 

  • Pause Recording: when checked, all data recording will be paused.

 

  • Pause At Event: when checked, specific timed events will automatically pause the data recording. The exact moment that the pause will occur will depend on the data feed parameter, with the pause happening when the sample data goes above a specific threshold, as shown in the following table.
    Parameter Threshold Units
    None N/A N/A
    AoA Alpha 20 Degrees
    Pitch 25 Degrees
    Roll 60 Degrees
    Yaw Sideslip Beta 25 Degrees
    Elevator Deflection 35 Degrees
    Aileron Deflection 30 Degrees
    Rudder Deflection 30 Degrees
    Load Factor 5 G
    Vertical Speed 3000 ft per minute
    Vertical Wind 3000 ft per minute
    True Air Speed 200 ktas
    Elevator Force 50 lbs, Kg, or Newton
    Aileron Force 50 lbs, Kg, or Newton
    Rudder Force 50 lbs, Kg, or Newton
    From .CSV 25 N/A

    Note that this threshold value is calculated as 10% of the maximum value permitted for the parameter.

 

  • Data Feed 1 - 4: Here you can select which parameter to use as the data feed(s).

 

  • Colour 1 - 4: Colours to be used when graphing the data are pre-assigned to the different parameters and will change as you select them. However you can click on this to open a list of colours and choose one to override the preset.

 

  • Units 1 - 4: This lets you select the unit to use for displaying the data feed values. Note that the list will be filtered to only permit those unit types appropriate for the data feed parameter.

 

  • Feed Offset: This slider permits you to offset the data visually in the graph view by +/- 20 frames.

 

  • Load .csv Into Feed 1 - 4: Clicking this will automatically load the CSV file from the given Filename location.

 

  • Save Feed 1 - 4 To .csv: Clicking this will automatically save a CSV file with the feed parameter data to the location given as the Filename location.
    WARNING! This will overwrite any existing file with the same name at that location!

 

  • Filename 1 - 4: Gives the path and filename for the CSV file to be loaded/saved.

 

  • Max Time 5s, 15s, 30s, 60s: These option can be used to expand/contract the visual sample shown in the graph view at the bottom.

 

 

Flight Controls

The Debug Aircraft Flight Controls Window

This window can be used to check the way that the flight controls affect the Pitch, Roll and Rudder.

 

 

AP (Autopilot)

The Debug Aircraft AP WindowThis window displays debug information related to the aircraft AutoPilot. In general this is split into 4 major sections:

  • Elevator
  • Ailerons
  • Rudder
  • Throttle

Most of the information in this window is defined through the AI Config file for the aircraft.

 

 

Attachments

The Debug Aircraft Attachments WindowThis option will open the debug window specific to attached objects used in the Modular SimObjects pipeline. You can find full information on this window from the following page:

 

 

Cabin Services

The Debug Cabin Services Window

From this window you can see and debug any of the Navigation Services assigned to the aircraft.

 

 

Camera Blend

This debug feature is for cameras and will enable an overlay with multiple points of information related to the current camera and the cameras available.

The Camera Blend Overlay

 

 

CFD

The Debug Aircraft CFD WindowThis option will open the CFD (Computational Fluid Dynamics) Debug window. This is used to computationally simulate the flow of air around the aircraft and is designed to help you better understand the and improve the aerodynamics and handling of the aircraft.

 

You can find full information on this window, how to use it, and how it works, from the following page:

 

 

Covers And Chocks

This option will toggle the following menu window on or off:

The Debug Covers And Chocks Menu Window

This menu will only be applicable when:

  • the aircraft is in pre-flight.
  • the aircraft is stationary.
  • the aircraft engines are off.

Under the above conditions, you can then use the menu do show/hide the various covers and chocks that are applicable ot the aircraft (assuming that the model has these items included and set up correctly).

Example showing the Debug Covers And Chocks Options Being Used

 

 

Debug Dirt And Scratches

The Debug Aircraft Dirt And Scratches Options

From this window you can fade in/out a number of detail masks for dirt and scratches on the current aircraft. Not all aircraft have these masks, but when they do, you can click on a slider and drag it to show the mask, or hold Ctrl then click to enter a value. Mouse over the image below to see how these change the aircraft display:

Card Back Example Showing The Effect Of The Dirt And Scratches Sliders

 

 

Drag

The Debug Aircraft Drag WindowThis window shows the different values that are associated with - and will affect - the different drag formulas for the aircraft. Values are measured on the aircraft in flight as it is currently being simulated.

 

 

Engines

The Debug Aircraft Engines WindowThis window displays information about the different engine(s) for the aircraft as well as their position. The data shown in this window can be changed by editing the Engine Config file.

 

 

Flight Performance

This window is used to create a flight_performance.cfg file, which can then be compared with the POH and manufacturer data for the aircraft, then used to tweak the flight model. The output data is also useful for calculating a vertical navigation profile and the take-off and landing distances required when creating flight plans.

IMPORTANT! Currently this file and debug window are only useable by planes with turbine/turbofan engines.

For full information on this window and how to use it, please see the following page:

 

 

Ground Effect

The Debug Aircraft Ground Effect Window

This debug window can be used to display various different values associated with the ground effect and how it affects various aircraft parameters.

 

 

Input Forces

 

 

Interactive Points

The Interactive Points OverlayWhen this option is selected, the aircraft will show the interactive points overlay. When active, each interactive point will be displayed - colour coded to show which type of point it is - along with it's position relative to the Datum Reference Point. This position, and other values, can be edited from the section in. The colours used are as follows:

  • Green: Main Exit
  • Orange: Cargo Exit
  • Red: Emergency Exit
  • Yellow: Gas Trap / Fuel Hose
  • Brown: Ground Power Unit
  • Dark Blue: Air Start Unit

 

 

Legacy

The Legacy Debug WindowThis debug window is designed to help you update any legacy FSX and Microsoft Flight Simulator 2020 aircraft to work with the updated, modern flight model in Microsoft Flight Simulator 2024. When opened, this window will create a "virtual wind tunnel" and essentially place the aircraft in it and use the legacy values to generate a comparative set of modern flight model values, which can then be added into the [CONTACT_POINTS] section of the Flight Model Config file.

 

The window is split into two parts:

  • the legacy parameter values on the right
  • the modern flight model values on the left

The idea here is that you use this comparison to update the aircraft CFG files by changing the parameters listed on the right with the values listed on the left. For example, in the image above the legacy parameter lift_coef_delta_elevator has a value of -1.806. However on the left this is represented as the \(C_{LDe}\) value which is -1.334. So you should take this value and in the CFG file edit the lift_coef_delta_elevator to be -1.334 to update the legacy values to suit the modern flight model. Doing this for all the listed values should bring the legacy aircraft parameters close to the values required for Microsoft Flight Simulator 2024.

 

 

Lights

The Debug Aircraft Lights OverlayWhen this is enabled, all the lights that have been defined for the aircraft will be signaled by an overlay of coloured text, and some may also show the name of any emissive effects that have been assigned to them, as well as the range and area over which they will be visible. Note that this overlay will also be automatically enabled when you select the [LIGHTS] section in the SimObject Editor.

 

Each colour used in the overlay represents a type of light, specifically:

  • White: Strobe
  • Red: Beacon
  • Dark Blue: Navigation
  • Yellow: Panel
  • Green: Landing

 

 

Pitch

The Debug Pitch WindowThis debug window is used for debugging the various parameters related to pitch from the section of The SimObject Editor. When this debug window is enabled, the simulation will be overlaid with a virtual "wind tunnel" showing a schematic of the aircraft from the side:
The Debug Pitch OverlayThis visualisation can be used to help visually balance out the different forces that affect the aircraft pitch. In this simulation:

  • the blue lines that cross the screen represent the airflow so you can visually see your incidence by comparing it to the white schematic of the aircraft.
  • the green line on the wing schematic indicates the lift + drag forces acting on the wing
  • the red line on the wing schematic indicates the gravity force and direction
  • the blue line on the elevator schematic indicates the lift force on the elevator

The three line graph on the left is also used to represent the active roll (red), pitch(green) and yaw(blue) torques.

 

 

Sim

The Debug Sim WindowsThese windows are used to show some "general" information about the simulation as well as activate certain overlays. This option acts as a quick way to enable the Sim Dimensions, Sim Info and Sim Forces overlays, since activating the Sim option will also show the overlays associated with those individual debug options.

 

In general, the graphic represents the following:

  • Green: Lift coefficient vs AoA.
  • Red: Drag coefficient vs AoA.
  • Blue: \(C_m / {AoA}\) (pitch moment vs AoA).
  • Other Colours: Roll and sideslip.

 

As well as activating those other overlays, this option will open a Sim Curves window with some values and a graph.

NOTE: This window is a work in progress and currently has little practical application.

 

 

Sim Dimensions

Simulation Geometry Being Debugged In The SimObject Editor

With this option you can enable the dimensions overlay which will show the approximate dimensions of the aircraft based on the values input in the Airplane Geometry section of The SimObject Editor. With this overlay you can see the fuselage "shell" in orange and the basic aircraft shape in white, and the Datum Reference Point is marked along with the Static Center Of Gravity Height. When this overlay is active, you will also be shown coloured lines that represent some of the forces acting upon the aircraft geometry. This overlay is also activated automatically if you enable the Sim option from the debug menu.

 

 

Sim Info

The Debug Sim Info WindowThis window shows some general information about the actual state of the simulation for the aircraft. The window is also shown automatically if you enable the Sim option from the debug menu.

 

 

Sim Forces

Visualisation Of The Forces On An Aircraft In The SimObject Editor

With this overlay enabled, you can see a visual representation of the forces that are active on each of the "sample points" used by the flight model to determine how the aircraft flies. The sample points are generated automatically based on the parameters setup in the flight_model.cfg for the different surfaces (fuselage, wings, aileron, etc...) and are shown using green rectangles. In the center of each sample point is a series of crossed lines which show the surface normal where the yellow line is always set at 90° to the surface plane. Some of the sample points will also have a red rectangle associated with them, and these are used to illustrate the rigidity of the surface (so they may not aline perfectly with the sample points depending on the flexibility settings for that surface of the aircraft). The blue lines that radiate from the sample points are force markers that are updated in real-time as you fly the aircraft and show a visual representation of the forces that are active on the surface, where the magnitude of the force is reflected by the length of the line. Note that this overlay is also activated if you enable the Sim option from the debug menu.

 

 

Sim Polar ClCd

The Sim Polar ClCd WindowWhen activated this option will open a Sim Curves window with a graph that plots the variation of the \(C_D\) (drag coefficient) as a function of \(C_L\) (lift coefficient) for you to study - this is the blue line on the graph, also called the drag/lift polar. This graph will show as well the tangent to the curve - the red line on the graph - starting from the axis origin and demonstrating the best AoA for the best \(C_L / C_D\) ratio on the polar curve.

WARNING! Activating this window will require Microsoft Flight Simulator 2024 to use a lot more processing power, and as such may lag the simulation.

 

 

Sim Polar Power

The Debug Sim Polar Power WindowWhen activated this option will open a Sim Curves window with a graph that plots various curves related to the engine power and speed, essentially allowing you to see how much power is required versus how much power you have.

 

WARNING! Activating this window will require Microsoft Flight Simulator 2024 to use a lot more processing power, and as such may lag the simulation.

 

 

Sim Polar VhVs

The Debug Sim Polar VhVs WindowWhen activated this option will open a Sim Curves window with a graph that plots curves related to the polar \(V_h\) and \(V_s\) values. This allows you to see how much height you lose when gliding and at what speed.

WARNING! Activating this window will require Microsoft Flight Simulator 2024 to use a lot more processing power, and as such may lag the simulation.

 

 

Sim Tuning

The Sim Tuning WindowThis window lists a number of important parameters related to the aircraft that can be studied as the aircraft flies. This window will also open automatically when the [WEIGHT_AND_BALANCE] section is selected in The SimObject Editor.

 

 

Speed

The Sim Speed WindowThis window lists a number of important parameters related to the speed at which the aircraft is flying, as well as some parameters that will affect how speed is calculated, the maximum speed, etc...

 

Stall

The Debug Aircraft Stall WindowThis window shows information that can be used to debug and resolve issues related to the aircraft stall speeds and AoA.

 

Tracking

The Debug Tracking WindowThis window shows a combination of common parameters that can be used to track the performance and behaviour of the aircraft. The following parameters are worth noting:

  • Simulated stall speed: computed from the sum of all lift forces the aircraft can produce in its current configuration (weight, gear landing), taking all control surfaces into account. That's the real stall speed of the flight model.
  • Estimated stall speed: computed from the values provided in the [REFERENCE SPEEDS] section, taking only flaps position and weight into account. So basically an interpolation based on POH values you provided
  • Lowest selectable speed: Set to 1.23 x Estimated Stall Speed

 

 

Weight

The Debug Weight Window

This window can be used to display the different weight parameters as well as the parameters that affect the weight. At the same time, this option will show an overlay on the aircraft displaying all the parts of the aircraft that can be modified to affect the weight and balance, including the landing gear, the engine, the pilot and copilot, etc...

The Weight Debug Overlay
This overlay and window will also be automatically activated when you select the [WEIGHT_AND_BALANCE] tab in The SimObject Editor.

 

 

Wheels

 

The Debug Wheels WindowWhen you select this option, the debug wheels window will open and display information related to each of the wheels/landing gear defined for the aircraft. Enabling this option will also enable the wheels and contact points overlay:

The Wheel And Contact Point Overlay

In this overlay, each contact point (wheels are also considered as contact points) will be shown with a coloured square at the point of contact which has been defined for it in the aircraft parameters. Each point will also be projected along a white line onto the ground. The colours used are as follows:

  • Green: Wheel
  • Dark Blue: Scrape Point
  • Black: Skid
  • Light Blue: Float
  • Cyan: Water Rudder
  • Light Grey: Ski
  • Orange: Propeller

This window and the overlay will also be automatically activated when you select the flight_model.cfg - [CONTACT POINTS] section in The SimObject Editor.