Skip to content

Main content

Gaze Region Support Share Tool

Calculate gaze region support share from explicit caller-supplied inputs.

Loading tool…

Description

Return region-looking support within valid visible tracking time.

Cognitive research records can encode stimuli, response timing, probability assumptions and observation support. Local differences and caller-defined tolerance labels do not establish perceptual validity, a cognitive mechanism, statistical equivalence or a clinical assessment.

Return region-looking support within valid visible tracking time.

When to use this tool

Use Gaze Region Support Share when checking a supplied cognitive-task timing, stimulus, probability or evidence convention.

How to use the tool and how it works

  1. Enter durations, validTracking, inRegion, regionVisible. Keep parallel arrays aligned. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read validVisibleDuration, supportedRegionDuration, share, defined. Inspect defined before interpreting the associated values.

Return region-looking support within valid visible tracking time. Require aligned nonnegative durations and flags; denominator sums validTracking AND regionVisible, numerator also requires inRegion; divide or return zero with defined false.1

Input fieldMeaning and unitsAccepted input
durationsDurationsRequired. Array of finite number; minimum 0; maximum items 256.
validTrackingValid TrackingRequired. Array of boolean; maximum items 256.
inRegionIn RegionRequired. Array of boolean; maximum items 256.
regionVisibleRegion VisibleRequired. Array of boolean; maximum items 256.
Output fieldInterpretationReturned shape
validVisibleDurationValid Visible DurationRequired. Finite number.
supportedRegionDurationSupported Region DurationRequired. Finite number.
shareDimensionless numerator/denominator ratio under the explicit basis above.Required. Finite number.
definedWhether the stated denominator or information basis permits interpretation of the associated value; inspect before using a placeholder.Required. Boolean.
json
{
  "input": {
    "durations": [
      2,
      3,
      5
    ],
    "validTracking": [
      true,
      true,
      true
    ],
    "inRegion": [
      true,
      false,
      true
    ],
    "regionVisible": [
      true,
      true,
      false
    ]
  },
  "output": {
    "validVisibleDuration": 5,
    "supportedRegionDuration": 2,
    "share": 0.4,
    "defined": true
  }
}

Limitations and assumptions

  • Intervals and flags are supplied, without overlap removal or actual gaze/attention inference.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Use a validated study design, calibrated measurements and appropriate statistical/professional interpretation for cognitive or health conclusions.

References

  1. Calculation and input contract: cognitive-science/gaze-region-support-share — tool.io

Similar or alternative tools