back

OxyScope Help

discussion
SimHub supports plotting property values over time:
    • select Properties in left margin
    • enter search term
    • right-click property, select Plot value

    OxyScope plugin collects samples for plotting relationships
    among up to 4 SimHub properties.

    At least for me, evaluating scatter plots while driving is NOT productive.
    Instead, using SimHub's button at the upper right,
    first record some driving, then analyze during
    Replay...

    Color-coded samples for up to 3 properties may be plotted vs values of another.
    These may subsequently be scatter plotted in 3D.
    Intuitively, this works when color-coded property values are correlated.

    3D plots of sample values for nominally "dependent" properties
    more likely fill ellipsoids than boxes.
    Supposing that 2% increments suffice for precision,
    that amounts to 51 samples along each "dependent" property axis,
    or a sphere with radius 25 and volume of about 65,500 samples.
    Sim racing property sample value distributions are unlikely to be uniform.
    Indeed, many sample sequences collected at 60Hz are nearly redundant,
    tracing trajectories.

    OxyScope Cumulative range mode mitigates data clustering by:

    • ignoring successive samples with all "dependent" values
      differing by less than 2% of properties' current range.
    • at suitable intervals, calculate StdDev for each property,
      then subsequently ignore samples not well beyond.
    • ideally, StdDev thresholding should based on radii...

Refresh Modes
OxyScope collects 180 (nominally 3 second) property value sample sets,
discarding duplicates and those at very slow speed.
  • 3 second refresh - plots always replaced by more recently collected sets
  • Increasing range - replaceable by sets with greater range of selected property
  • Cumulative range - continues supplementing an initial sample set collection
      initially with samples having larger value variances of selected property,
      as the sample buffer fills.
    This works better with more tightly clustered initial collections.
    Delays between updates increase as samples with greater variances become rarer.
    Accumulation may eventually switch to histogram mode,
    backfilling gaps until the buffer is full.
User Interfacetop to bottom
top row:  Controls left-to-right

Help - link to this page

Current property sample set statistics, updated every 180 samples;
  may not get plotted, depending on buttons to the right...

Refresh mode button:  3 second / Cumulative range / Hold max range

Property selection button
  • For 3 second refresh mode, just selects which Y property
    to least-square fit line and monotonic cubic curve.
  • for Increasing and Cumulative refresh modes,
    also selects the property controlling sample set collection.

Manual / Auto Replot button:  for 3 second and Increasing range snapshots
  • Auto:  OxyScope updates plots as new collections are available
  • Manual:  currently displayed plot remains until selecting  REPLOT 

 REPLOT  button:  appears when appropriate for Manual snapshots
row 2: Properties XY plotOxyPlots of X, Y property sample sets

row 3:  two optional Y property names
row 4:  Y, X plot required property names
  Copy property names of interest from SimHub's Available properties window

rows 5, 6:  Current plotted property notes and statistics
typically reports coefficients for fitted lines, cubic fits

bottom row:  filters (1 == no filtering)
Some properties affect others, but with delay.
Increasing filter value for property affecting another
  may improve correlation visibility..

3D scatter plot visualization

maintained by blekenbleu