ReVISit Documentation

website·Indexed 33 days ago

https://revisit.dev

Documentation for ReVISit, a framework for designing studies and experiments. Includes API references for versions v2.0.2 through v2.4.4, covering study configuration, UI components, data export to Tidy CSV, and specialized libraries like the Graph Literacy Scale and Mini-VLAT.

Tokens
465.7K
Snippets
2K
Records
3.3K
Agent score
55%

What's inside ReVISit

  1. Overview of the Ishihara color blindness test library

    v2.1.1
    The Ishihara color blindness test library (v2.1.1) provides components that render Ishihara plates. Each plate component includes a meta attribute describing what individuals with normal vision, red color blindness, green color blindness, and total color blindness perceive. The library is used to ask users to identify numbers or patterns within these images.
  2. Overview of the User Experience Questionnaire (UEQ) library

    The User Experience Questionnaire (UEQ) library (v2.4.4) provides a standardized tool to measure the user experience of interactive products. It consists of a single component that implements the full UEQ questionnaire containing 26 questions.
  3. Overview of NASA-TLX implementation in revisit.dev

    v2.3.2
    The NASA-TLX is a subjective workload assessment tool used to evaluate the perceived workload of a task across six subscales: Mental Demand, Physical Demand, Temporal Demand, Performance, Effort, and Frustration. The library provides components for the assessment and a sequence that includes the pairwise weighting procedure for load evaluation.
  4. Overview of NASA-TLX Workload Assessment

    The NASA-TLX (Task Load Index) is a subjective workload assessment tool used in human factors and ergonomics research to assess the perceived workload of a task. It evaluates workload across six subscales: Mental Demand, Physical Demand, Temporal Demand, Performance, Effort, and Frustration.
  5. Overview of reVISit study components

    v2.3.2

    Components are the building blocks of a study containing the actual content shown to participants. Most components are defined by referencing an external file or URL, except for survey questions which are defined directly in the spec. Supported component types include:

    • Markdown Files: Formatted text, links, images, and videos (ideal for consent forms or introductions).
    • Images and Videos: Used directly as stimuli.
    • Web Pages: Custom interactive stimuli developed with JavaScript.
    • React Components: Sophisticated interactive stimuli with simplified communication with reVISit.
    • Vega and Vega-lite Components: Declarative visualizations that integrate with reVISit's provenance system to track user interactions.
    • Survey Questions: Used to elicit structured responses.
  6. Overview of the CALVI library

    v2.4.3
    The Critical Thinking Assessment for Literacy in Visualizations (CALVI) library (v2.4.3) provides a collection of visualizations (such as line graphs, bar charts, and pie charts) and associated questions. It is designed to assess and test a user's ability to interpret data visualizations using critical thinking skills.
  7. Overview of reVISit Study Components

    v1.0.6

    Components are the building blocks of a study containing the content shown to participants. reVISit supports five primary component types:

    • Markdown Files: Formatted text, links, images, and videos (ideal for introductions or consent forms).
    • Images: Used directly as stimuli.
    • Web Pages: Custom stimuli, including interactive JavaScript-based content.
    • React Components: Sophisticated interactive stimuli with simplified communication with reVISit.
    • Survey Questions: Used to elicit structured responses (these are specified directly in the spec without external files).

    Most components can be paired with responses (form elements) to capture participant data.

  8. Overview of the Usability Metric for User Experience (UMUX)

    v2.3.2
    The Usability Metric for User Experience (UMUX) is a short, standardized usability questionnaire used as a concise alternative to the System Usability Scale (SUS). It consists of four statements designed to assess the effectiveness, efficiency, and satisfaction of a system.
  9. Overview of the UMUX Usability Metric

    The Usability Metric for User Experience (UMUX) is a short, standardized usability questionnaire used as a concise alternative to the System Usability Scale (SUS). It consists of four statements designed to measure a system's perceived effectiveness, efficiency, and satisfaction.
  10. Overview of the Ishihara color blindness test library

    v2.3.2
    The Ishihara color blindness test library provides components that render images of Ishihara plates. Each plate component includes a meta attribute describing what individuals with normal vision, red color blindness, green color blindness, and total color blindness perceive. Users are tasked with identifying the number or pattern within the image.
  11. Overview of the reVISit study creation workflow

    v2.3.2

    reVISit is a framework for creating interactive, web-based studies. The workflow consists of the following steps:

    1. Study Specification: Define the study using the reVISit DSL (a JSON-based domain-specific language), specifying components, data collection requirements, and the sequence of events.
    2. Stimuli Definition: Stimuli are contained in components, which can be images, videos, interactive HTML pages, React components, or Vega code. Users can use the built-in reVISit library or create custom components.
    3. Compile & Deploy: The DSL specification and components are compiled into an interactive study web app and deployed to a web server.
    4. Participant Recruitment: Recruit participants via platforms (e.g., Prolific, Mechanical Turk) or other channels.
    5. Data Storage: Participant responses are automatically stored in a data store, supporting local storage or cloud-based options like Firebase or Supabase.
    6. Monitoring: Use reVISit's replay tools and participant overviews to review preliminary results.
    7. Data Analysis: Download the collected data for analysis in environments such as R or Python.
  12. Overview of the CALVI library

    v2.2.0
    The Critical Thinking Assessment for Literacy in Visualizations (CALVI) library (v2.2.0) provides a collection of visualizations (such as line graphs, bar charts, and pie charts) and corresponding questions designed to assess and test a user's ability to interpret data visualizations using critical thinking skills.