Flight Data Recorder

From Resonite Wiki
Revision as of 00:21, 31 March 2024 by TheAutopilot (talk | contribs) (fixed spelling of Fire On Local Change)

Flight Data Recorder is a ProtoFlux logging tool made by TheAutopilot. It consists of an interactive UIX window that you can connect to multiple “probes” which mimic ProtoFlux nodes.

Overview

Log Window

After setting up the probe links this is where you will look most at during logging.

Do you want to get the most up-to-date version of this tool? Grab the Public Folder from the backside of this window!

Alternatively paste this into Resonite: resrec:///U-TheAutopilot/R-15a4b80b-d8d9-4502-92df-61b7c2bf3355

Title Bar

The title bar contains 3 buttons:

Gear
opens/closes the settings
Pin
parents the window to the user
X
destroys the logging tool (This also deletes all collected log data!)

Log

The log area is a table displaying a list of recorded events.

Event Column

This always is the first column of the table. Each event cell is made up of 3 rows:

  1. row
    • an indicator for the event type (Σ for value changes, » for impulse events)
    • the ID of the event source
    • a button to show the event source in an inspector panel
  2. row
    • a decorative clock symbol
    • the world time of the event in millisecond precision
    • the UTC time of the event without date in millisecond precision
    • a button to restore the logged values to the state logged in the line (More details in section Restore Values)
  3. row
Value Column

These columns can be moved around with primary. (internally uses a UIX Slider) Each value cell consists of two rows:

  1. row
    • a Σ if the value exists
    • the type of the value (if not null)
    • an indicator to tell if the raw value has been stored (green: can be applied to restore values)
    • a button to show the value source in an inspector panel
  2. row with one of the following
Scroll Bar

The scroll bar allows quick navigation through the log. (implemented by connecting a Slider with a ScrollRect)

Due to UI limitations some rendering issues are to be expected while quickly moving through the list.

Log Config/Actions

Recording

This is a checkbox to enable/disable creation of new log items.

Show Rich Text

This checkbox toggles if the values are displayed with text formatting.

Clear Log

This deletes all log entries

Export

This action is still in development. (goal: CSV or JSON export)

Settings Window

The main responsibility of the Settings window is to manage probes. Additionally a few general settings are available.

Probe Management

Probes

This is a table of linked probes, grouped by probe type. (also scrollable with a scroll bar) The header of a group can be clicked to collapse the list of probes.

The displayed colums are:

  • a checkbox to enable/disable the probe/group as a trigger for log lines.
  • an indicator for the group type (Σ for value probes, » for impulse probes)
  • ID of the probe/type of the group
  • version of the probe
    • A yellow arrow indicates that the probe can be updated to a newer version by clicking the version.
  • a button to show the probe in an inspector panel
  • a button (trashcan) to unlink the probe (This will NOT delete the probe itself.)
  • a checkbox to show/hide the columns of a single/all value probes
    • This is a way to generate a missing column after renaming a probe.

In a freshly spawned logger the empty probe list will be occupied by a quick start guide.

Link Probes

This action will ensure links to all probes within the given target hierarchy.

It will also ensure a matching column exists for the ID of each linked value probe.

Unlink All Probes

This action unlinks all probes.

As a side effect this will enable

General Settings

Multiline Data

This option enables extra handling of duplicate data IDs which will generate additional log lines to display the extra values. (disable to improve performance)

Reset Columns

This action removes all unused value columns and generates all that are referenced by linked probes or log entries.

This may be necessary after changing the ID of already linked value probes.

Record Restore Data

This option enables recording the raw values. (enable to support restoring values, disable to improve performance)

Raw values are internally stored within duplicated Stores of Object type and communicated via additional Dynamic Impulses. They cannot be transmitted via the network. Once the logging user left the session the values are not recoverable. Duplication or saving also fails to preserve the raw values.

max. log size

This setting will limit the number of log lines stored within the log. The oldest lines will be deleted first after reaching this limit.

max. per frame

This setting will limit the number of log lines that can be added per frame. Once hitting the limit one additional line will be added with the number of skipped event lines.

Impulse Probe

Impulse Probe
*
Next
ID
null
Flight Data Recorder

Impulse probes add log lines for each impulse that goes through them.

Without a connected logger they behave like Continuation Relays. This includes their behaviour on deletion. (maintains connection) With connected loggers they will first trigger log line generation and then continue execution.

Inputs

Value (Object)

This is the value that will be added to the log table.

Outputs

OnRestore (Call)

This impulse will be triggered to restore the measured value.

Globals

ID (String)

This is the ID of events triggered by this probe. It will be displayed with text formatting. (unlike the IDs of value probes)

Value Probe

Value Probe
Value
OnRestore
RestoredValue
ID
null
Flight Data Recorder

Value probes add additional columns to the log and can also trigger log lines on local value changes.

Additionally they have outputs that can be used to restore values.

Inputs

Value (Object)

This is the value that will be added to the log table.

Outputs

OnRestore (Call)

This impulse will be triggered to restore the measured value.

RestoredValue (Object)

This is the original value that should be restored during the impulse.

Globals

ID (String)

This is the ID of the value column and events triggered by this probe. It will be displayed without text formatting. (unlike the IDs of impulse probes)

Usage

Integration into ProtoFlux

Linking Probes

Recording Events

Restore Values

Version History

Protocols