Interval Scale

Instructions on how to install LabBench

Represents a numerical rating scale with discrete, equally spaced values. Used to collect interval-based responses such as Likert or numerical rating scales.

Availability:

context.Instruments.<IntervalScaleName>

Properties

Name Type Description
Maximum int Maximum value of the scale.
Minimum int Minimum value of the scale.

Methods

Name Signature Description
GetCurrentRating GetCurrentRating()int Returns the current rating selected on the scale.
GetIntervalRating GetIntervalRating()int Returns the current rating value (same scale domain as Minimum to Maximum).
SetIntervalRating SetIntervalRating(rating: int)None Sets the current rating on the scale. Updates the device state.

Typical usage example

scale = context.Instruments.IntervalScale

# Read current rating
rating = scale.GetCurrentRating()

# Set rating programmatically
scale.SetIntervalRating(5)

# Access scale bounds
min_val = scale.Minimum
max_val = scale.Maximum

Notes / gotchas

  • Valid rating values are within [Minimum, Maximum]; behavior outside this range is undefined.
  • SetIntervalRating directly modifies the device state and may affect participant interaction.
  • GetCurrentRating and GetIntervalRating return integer values; no fractional ratings are supported.