@decidables/detectable-elements 0.1.2 → 0.2.1

package/README.md

@@ -33,199 +33,6 @@ for use in HTML.
 
 Building blocks for interactive visualizations of SDT
 
-#### `RDKTask` / `<rdt-task>`
-
-Displays stimuli for random dot kinematogram signal detection task
-
-When run, a block of trials is presented. Before each trial is an inter-trial interval (ITI). Each
-trial then consists of a stimulus followed by a period of waiting for a response. The stimulus
-consists of a circle with a collection of small dots moving about. Some trials are *signal* trials
-and others are *noise* trials. On *noise* trials, the directions of the dots is independent and
-random. On *signal* trials, a subset of the dots move coherently in the same direction. The task can
-be paused and then resumed, and it can also be reset and run again. 
-
-##### Attributes
-
-- `coherence: number = 0.5`
-  - Proportion of dots moving coherently
-- `count: number = 100`
-  - Number of dots
-- `probability: number = 0.5`
-  - Probability of signal (as opposed to noise)
-- `duration: number = 2000`
-  - Duration of stimulus in milliseconds
-- `wait: number = 2000`
-  - Duration of wait period for response in milliseconds
-- `iti: number = 2000`
-  - Duration of inter-trial interval in milliseconds
-- `trials: number = 5`
-  - Number of trials per block
-- `running: boolean = false`
-  - Currently executing block of trials
-
-##### Methods
-
-- `reset()`
-  - Stops a currently running or ended block of trials and resets everything to be ready to run
-    again
-
-##### Custom Events
-
-- `rdk-block-start`
-  - Indicates the beginning of a block of trials
-- `rdk-block-end`
-  - Indicates the completion of a block of trials
-  - `detail` for `rdk-block-start` and `rdk-block-end`
-    - `trials: number`
-      - Number of trials in the block
-- `rdk-trial-start`
-  - Indicates the beginning of a trial (iti is over and stimulus is about to start)
-- `rdk-trial-middle`
-  - Indicates the middle of a trial (stimulus is over and the wait is about to start)
-- `rdk-trial-end`
-  - Indicates the end of a trial (wait is over and iti is about to start)
-  - `detail` for `rdk-trial-start`, `rdk-trial-middle`, and `rdk-trial-end`
-    - `trials: number` 
-      - Number of trials in the block
-    - `duration: number`
-      - Duration of stimulus in milliseconds
-    - `wait: number`
-      - Duration of wait period in milliseconds
-    - `iti: number`
-      - Duration of inter-trial interval in milliseconds
-    - `trial: number`
-      - Count of trial in block (one-based)
-    - `signal: string`
-      - Whether the signal is `present` or `absent` in this trial
-
-##### Example
-
-```html
-<rdt-task coherence="0.1" count="50" probability="0.5" duration="1000" wait="1000" iti="500" trials="10" running></rdt-task>
-```
-
-#### `ROCSpace` / `<roc-space>`
-
-Interactive receiver operating characteristic (ROC) plot
-
-An ROC plot that can show one or more locations in ROC space or zROC space. Each location can be
-shown with a point, and/or with intersecting iso-sensitivity and iso-bias curves. In interactive
-mode, the points can be moved via direct manipulation with the mouse, touch, or keyboard arrows. The
-plot can also display the topography of the space with contour lines indicating iso-sensitivity,
-iso-bias, or iso-accuracy.
-
-##### Attributes
-
-- `interactive: boolean = false`
-  - Allow direct manipulation of points in the plot
-- `contour: string = undefined`
-  - Show contour lines on plot
-  - Options
-    - `undefined`
-      - Show no contours
-    - `'sensitivity'`
-      - Show iso-sensitivity contours
-    - `'bias'`
-      - Show iso-bias contours
-    - `'accuracy'`
-      - Show iso-accuracy contours
-- `point: string = 'all'`
-  - Show a point on the plot for each *location*
-  - Options:
-    - `'all'`
-      - Show points for all *locations*
-    - `'first'`
-      - Only show a point for the first (`'default'`) *location*
-    - `'rest'`
-      - Show points for all except the first (`'default'`) *location*
-    - `'none'`
-      - Show no points
-- `iso-d: string = 'first'`
-  - Show an iso-sensitivity line for each *location*
-  - Options:
-    - `'all'`
-      - Show contours for all *locations*
-    - `'first'`
-      - Only show a contour for the first (`'default'`) *location*
-    - `'rest'`
-      - Show contours for all except the first (`'default'`) *location*
-    - `'none'`
-      - Show no contours
-- `iso-c: string = 'first'`
-  - Show an iso-bias line for each *location*
-  - Options:
-    - `'all'`
-      - Show contours for all *locations*
-    - `'first'`
-      - Only show a contour for the first (`'default'`) *location*
-    - `'rest'`
-      - Show contours for all except the first (`'default'`) *location*
-    - `'none'`
-      - Show no contours
-- `z-roc: boolean = false`
-  - Plot in zROC space instead of ROC space
-- `far: number = 0.25`
-  - False alarm rate for the first (`'default'`) *location*
-- `hr: number = 0.75`
-  - Hit rate for the first (`'default'`) *location*
-
-##### Methods
-
-- `set(hr, far, name = 'default', label = '', s = 1)`
-  - Create or update the *location* identified by `name`
-  - The `name` `'default'` is reserved for the first location
-  - Parameters
-    - `hr: number`
-      - Hit rate
-    - `far: number`
-      - False alarm rate
-    - `name: string = 'default'`
-      - A unique name to identify the *location* being set
-    - `label: string = ''`
-      - A visual label to use in the plot for this location
-    - `s: number = 1`
-      - Unequal variance parameter (default of `1` is equal variance)
-- `setWidthSDT(d, c, name = 'default', label = '', s = 1)`
-  - Create or update the *location* identified by `name`
-  - The `name` `'default'` is reserved for the first location
-  - Parameters
-    - `d: number`
-      - Sensitivity
-    - `c: number`
-      - Bias
-    - `name: string = 'default'`
-      - A unique name to identify the *location* being set
-    - `label: string = ''`
-      - A visual label to use in the plot for this location
-    - `s: number = 1`
-      - Unequal variance parameter (default of `1` is equal variance)
-
-##### Custom Events
-
-- `roc-point-change`
-  - Indicates a location on the plot has been moved
-  - `detail`
-    - `name: string`
-      - A unique name to identify the *location*
-    - `far: number`
-      - False alarm rate
-    - `hr: number`
-      - Hit rate
-    - `d: number`
-      - Sensitivity
-    - `c: number`
-      - Bias
-    - `s: number`
-      - Variance
-    - `label: string`
-      - Display label
-
-##### Example
-
-```html
-<roc-space interactive contour="bias" point="all" isoD="first" isoC="first" z-roc far="0.2" hr="0.9"></roc-space>
-```
-
 #### `DetectableControl` / `<detectable-control>`
 
 Control panel for SDT demos
@@ -268,7 +75,9 @@ block of trials.
     - `'response'`
       - Color based on *'signal'* or *'noise'* response
     - `'outcome'`
-      - Color based on outcome of hit, miss, false alarm or correct rejection 
+      - Color based on outcome of *hit*, *miss*, *false alarm* or *correct rejection*
+    - `'all'`
+      - Color based on stimulus, response, and outcome
 - `zRoc: boolean = undefined`
   - Show a switch to set whether to use z-transformed ROC coordinates (`true`) or ROC coordinates
     (`false`)
@@ -329,159 +138,32 @@ block of trials.
 <detectable-control trials="15" duration="1500" coherence="0.2" payoff="75" color="outcome" z-roc run pause reset></detectable-control>
 ```
 
-#### `SDTModel` / `<sdt-model>`
-
-Interactive visualization of SDT in terms of signal and noise distributions
-
-This widget provides a visualization of signal detection theory. It can show *signal* and *noise*
-distributions and a threshold. The distributions can have unequal variance. The sensitivity, bias,
-and *signal* variance can be set and optionally displayed. In interactive mode, the bias can be
-adjusted by directly moving the threshold horizontally with mouse, touch, or keyboard, the
-sensitivity can be adjusted by directly moving a distribution horizontally with mouse, touch, or
-keyboard, and the variance can be adjusted by directly moving the *signal* distribution vertically
-with mouse, touch, or keyboard.
+#### `DetectableResponse` / `<detectable-response>`
 
-In addition, the observation of stimuli can be visualized as blocks arriving at particular evidence
-levels, and stacking with previous stimuli to form a histogram. In interactive mode, when the model
-is adjusted, the blocks in the histogram will rearrange accordingly.
+Response buttons, feedback, and payoffs for signal detection tasks
 
-The thresholded distributions and the histogram blocks can be colored based on the stimuli, the
-responses, or the outcomes.
+This element provides 'present' and 'absent' response buttons. It can also display a running count
+of the trials, display feedback in terms of accuracy or SDT outcome, and display the current trial
+and total payoff.
 
 ##### Attributes
 
 - `interactive: boolean = false`
-  - Allow direct manipulation of threshold and distributions
-- `color: string = 'outcome'`
-  - Set how to color distributions and trials
+  - Allow user to respond, instead of just displaying simulated model responses
+- `feedback: string = 'outcome'`
+  - What type of feedback to display
   - Options
+    - `'none'`
+      - No feedback
+    - `'accuracy'`
+      - Feedback in terms of accuracy, i.e. 'correct' or 'error'
     - `'outcome'`
-      - Color based on outcome of the hit, miss, false alarm, or correct rejection
-    - `'response'`
-      - Color based on the `'present'` or `'absent'` response provided
-    - `'stimulus'`
-      - Color based on the `present` or `absent` stimulus displayed
-    - `'none'`
-      - No coloring
-- `distributions: boolean = false`
-  - Show distributions
-- `threshold: boolean = false`
-  - Show threshold
-- `unequal: boolean = false`
-  - Allow unequal variance
-- `sensitivity: boolean = false`
-  - Show the sensitivity as *d'* with a measurement bar
-- `bias: boolean = false`
-  - Show the bias as *c* with a measurement bar
-- `variance: boolean = false`
-  - Show the variance as *s* with a measurement bar
-- `histogram: boolean = false`
-  - Show a histogram with a block for each trial/stimulus
-- `d: number = 1`
-  - Set the sensitivity, *d`*
-- `c: number = 0`
-  - Set the bias, *c*
-- `s: number = 1`
-  - Set the variance of the *signal* distribution, *s*
-
-##### Methods
-
-- `reset()`
-  - Reset the histogram to have no trials
-- `trial(trialNumber, signal, duration, wait, iti)`
-  - Add a trial to the histogram
-  - Parameters
-    - `trialNumber: number`
-      - Numerical count of the trial in the block
-    - `signal: string`
-      - Whether this is a signal `'present'` or `'absent'` trial 
-    - `duration: number`
-      - The stimulus duration on this trial in milliseconds
-    - `wait: number`
-      - The wait duration on this trial in milliseconds
-    - `iti: number`
-      - The inter-trial interval duration after this trial in milliseconds
-- `pauseTrial()`
-  - Pause the animation of trials in the histogram
-- `resumeTrial()`
-  - Resume the animation of trials in the histogram
-
-##### Custom Events
-
-- `sdt-model-change`
-  - Indicates that one or more model parameters have been changed
-  - `detail`
-    - `d: number`
-      - Sensitivity
-    - `c: number`
-      - Bias
-    - `s: number`
-      - Variance
-    - `far: number`
-      - False alarm rate
-    - `hr: number`
-      - Hit rate
-    - `h: number`
-      - Hits
-    - `m: number`
-      - Misses
-    - `fa: number`
-      - False alarms
-    - `cr: number`
-      - Correct rejections
-- `detectable-response`
-  - Indicates that an animated histogram trial has generated a response 
-  - `detail`
-    - `stimulus: string`
-      - Whether the signal was actually `'present'` or `'absent'`
-    - `response: string`
-      - Whether the response was `'present'` or `'absent'`
-    - `outcome: string`
-      - The outcome of the trial as a hit (`'h'`), miss (`'m'`), correct rejection (`'cr'`), or
-        false alarm (`'fa'`)
-    - `h: number`
-      - Total hits in this block
-    - `m: number`
-      - Total misses in this block
-    - `fa: number`
-      - Total false alarms in this block
-    - `cr: number`
-      - Total correct rejections in this block
-    - `nr: number`
-      - Total no responses in this block
-
-##### Example
-
-```html
-<sdt-model interactive color="outcome" distributions threshold unequal sensitivity bias variance histogram d="2" c="1" s="1.5"></sdt-model>
-```
-
-#### `DetectableResponse` / `<detectable-response>`
-
-Response buttons, feedback, and payoffs for signal detection tasks
-
-This element provides 'present' and 'absent' response buttons. It can also display a running count
-of the trials, display feedback in terms of accuracy or SDT outcome, and display the current trial
-and total payoff.
-
-##### Attributes
-
-- `interactive: boolean = false`
-  - Allow user to respond, instead of just displaying simulated model responses
-- `feedback: string = 'outcome'`
-  - What type of feedback to display
-  - Options
-    - `'none'`
-      - No feedback
-    - `'accuracy'`
-      - Feedback in terms of accuracy, i.e. 'correct' or 'error'
-    - `'outcome'`
-      - Feedback in terms of outcome, i.e. 'hit, 'miss', 'false alarm', or 'correct rejection'
-- `trial: boolean = false`
-  - Display the running count of trials, i.e. 'Trial: 2 of 10'
-- `payoff: string = 'none'`
-  - What payoff information to display
-  - Options
+      - Feedback in terms of outcome, i.e. 'hit, 'miss', 'false alarm', or 'correct rejection'
+- `trial: boolean = false`
+  - Display the running count of trials, i.e. 'Trial: 2 of 10'
+- `payoff: string = 'none'`
+  - What payoff information to display
+  - Options
     - `'none'`
       - No payoff information displayed
     - `'trial'`
@@ -555,74 +237,386 @@ and total payoff.
 ##### Example
 
 ```html
-<detectable-response interactive feedback="outcome" trial payoff="total" hit-payoff="60" miss-payoff="-60" false-alarm-payoff="-40" correct-rejection-payoff="40" no-response-payoff="-100"></detectable-response>
+<detectable-response interactive feedback="outcome" trial payoff="total" hit-payoff="60" miss-payoff="-60" false-alarm-payoff="-40" correct-rejection-payoff="40" no-response-payoff="-100"></detectable-response>
+```
+
+#### `DetectableTable` / `<detectable-table>`
+
+Interactive table of SDT outcomes
+
+A results table for signal detection tasks. The results are presented in a two by two table
+organized by stimuli (signal present or absent) and responses ('present' or 'absent') leading to
+four possible outcomes: hits, misses, false alarms, and correct rejections. Results on signal
+present trials are optionally marginalized with the hit rate and those on signal absent trials with
+the false alarm rate. Results on response 'present' trials are optionally marginalized with the
+positive predictive value and those on response 'absent' trials with the false omission rate. And
+overall results are optionally marginalized with accuracy.
+
+##### Attributes
+
+- `interactive: boolean = false`
+  - Allow user to change values in the table
+- `numeric: boolean = false`
+  - Show numeric values instead of just labelling the cells
+- `summary: Set = <empty>`
+  - Which marginals to display
+  - Expressed in HTML as a space-separated list
+  - Options
+    - `'stimulusRates'`
+      - Display hit rate and false alarm rate
+    - `'responseRates'`
+      - Display positive predictive value and false omission rate
+    - `'accuracy'`
+      - Display overall accuracy
+- `color: string = 'outcome'`
+  - How to color the cells
+  - Options
+    - `'none'`
+      - No colors
+    - `'accuracy'`
+      - Color based on accuracy, i.e. *correct* or *error*
+    - `'stimulus'`
+      - Color based on stimulus *present* or *absent*
+    - `'response'`
+      - Color based on response *'present'* or *'absent'*
+    - `'outcome'`
+      - Color based on *hits*, *misses*, *false alarms* and *correct rejections*
+    - `'all'`
+      - Color based on stimulus, response, and outcome
+- `hits: number = 40`
+  - Number of hits
+- `misses: number = 60`
+  - Number of misses
+- `false-alarms: number = 75`
+  - Number of false alarms
+- `correct-rejections: number = 25`
+  - Number of correct rejections
+- `payoff: boolean = false`
+  - Whether to display payoffs
+- `hit-payoff: number = undefined`
+  - Payoff for hits
+- `miss-payoff: number = undefined`
+  - Payoff for misses
+- `correct-rejection-payoff: number = undefined`
+  - Payoff for correct rejections
+- `false-alarm-payoff: number = undefined`
+  - Payoff for false alarms
+
+##### Custom Events
+
+- `detectable-table-change`
+  - One or more values in the table have changed
+  - `detail`
+    - `h: number`
+      - Hits
+    - `m: number`
+      - Misses
+    - `fa: number`
+      - False alarms
+    - `cr: number`
+      - Correct rejections
+    - `hr: number`
+      - Hit rate
+    - `far: number`
+      - False alarm rate
+    - `ppv: number`
+      - Positive predictive value
+    - `fomr: number`
+      - False omission rate
+    - `acc: number`
+      - Accuracy
+
+##### Example
+
+```html
+<detectable-table interactive numeric summary="stimulusRates responseRates accuracy" = color="outcome" hits="80" misses="20" false-alarms="35" correct-rejections="65" payoff hit-payoff="60" miss-payoff="-60" false-alarm-payoff="-40" correct-rejection-payoff="40"></detectable-table>
+```
+
+#### `RDKTask` / `<rdt-task>`
+
+Displays stimuli for random dot kinematogram signal detection task
+
+When run, a block of trials is presented. Before each trial is an inter-trial interval (ITI). Each
+trial then consists of a stimulus followed by a period of waiting for a response. The stimulus
+consists of a circle with a collection of small dots moving about. Some trials are *signal* trials
+and others are *noise* trials. On *noise* trials, the directions of the dots is independent and
+random. On *signal* trials, a subset of the dots move coherently in the same direction. The task can
+be paused and then resumed, and it can also be reset and run again. 
+
+##### Attributes
+
+- `coherence: number = 0.5`
+  - Proportion of dots moving coherently
+- `count: number = 100`
+  - Number of dots
+- `probability: number = 0.5`
+  - Probability of signal (as opposed to noise)
+- `duration: number = 2000`
+  - Duration of stimulus in milliseconds
+- `wait: number = 2000`
+  - Duration of wait period for response in milliseconds
+- `iti: number = 2000`
+  - Duration of inter-trial interval in milliseconds
+- `trials: number = 5`
+  - Number of trials per block
+- `running: boolean = false`
+  - Currently executing block of trials
+
+##### Methods
+
+- `reset()`
+  - Stops a currently running or ended block of trials and resets everything to be ready to run
+    again
+
+##### Custom Events
+
+- `rdk-block-start`
+  - Indicates the beginning of a block of trials
+- `rdk-block-end`
+  - Indicates the completion of a block of trials
+  - `detail` for `rdk-block-start` and `rdk-block-end`
+    - `trials: number`
+      - Number of trials in the block
+- `rdk-trial-start`
+  - Indicates the beginning of a trial (iti is over and stimulus is about to start)
+- `rdk-trial-middle`
+  - Indicates the middle of a trial (stimulus is over and the wait is about to start)
+- `rdk-trial-end`
+  - Indicates the end of a trial (wait is over and iti is about to start)
+  - `detail` for `rdk-trial-start`, `rdk-trial-middle`, and `rdk-trial-end`
+    - `trials: number` 
+      - Number of trials in the block
+    - `duration: number`
+      - Duration of stimulus in milliseconds
+    - `wait: number`
+      - Duration of wait period in milliseconds
+    - `iti: number`
+      - Duration of inter-trial interval in milliseconds
+    - `trial: number`
+      - Count of trial in block (one-based)
+    - `signal: string`
+      - Whether the signal is `present` or `absent` in this trial
+
+##### Example
+
+```html
+<rdt-task coherence="0.1" count="50" probability="0.5" duration="1000" wait="1000" iti="500" trials="10" running></rdt-task>
+```
+
+#### `ROCSpace` / `<roc-space>`
+
+Interactive receiver operating characteristic (ROC) plot
+
+An ROC plot that can show one or more locations in ROC space or zROC space. Each location can be
+shown with a point, and/or with intersecting iso-sensitivity and iso-bias curves. In interactive
+mode, the points can be moved via direct manipulation with the mouse, touch, or keyboard arrows. The
+plot can also display the topography of the space with contour lines indicating iso-sensitivity,
+iso-bias, or iso-accuracy.
+
+##### Attributes
+
+- `interactive: boolean = false`
+  - Allow direct manipulation of points in the plot
+- `contour: string = undefined`
+  - Show contour lines on plot
+  - Options
+    - `undefined`
+      - Show no contours
+    - `'sensitivity'`
+      - Show iso-sensitivity contours
+    - `'bias'`
+      - Show iso-bias contours
+    - `'accuracy'`
+      - Show iso-accuracy contours
+- `point: string = 'all'`
+  - Show a point on the plot for each *location*
+  - Options:
+    - `'all'`
+      - Show points for all *locations*
+    - `'first'`
+      - Only show a point for the first (`'default'`) *location*
+    - `'rest'`
+      - Show points for all except the first (`'default'`) *location*
+    - `'none'`
+      - Show no points
+- `iso-d: string = 'first'`
+  - Show an iso-sensitivity line for each *location*
+  - Options:
+    - `'all'`
+      - Show contours for all *locations*
+    - `'first'`
+      - Only show a contour for the first (`'default'`) *location*
+    - `'rest'`
+      - Show contours for all except the first (`'default'`) *location*
+    - `'none'`
+      - Show no contours
+- `iso-c: string = 'first'`
+  - Show an iso-bias line for each *location*
+  - Options:
+    - `'all'`
+      - Show contours for all *locations*
+    - `'first'`
+      - Only show a contour for the first (`'default'`) *location*
+    - `'rest'`
+      - Show contours for all except the first (`'default'`) *location*
+    - `'none'`
+      - Show no contours
+- `z-roc: boolean = false`
+  - Plot in zROC space instead of ROC space
+- `far: number = 0.25`
+  - False alarm rate for the first (`'default'`) *location*
+- `hr: number = 0.75`
+  - Hit rate for the first (`'default'`) *location*
+
+##### Methods
+
+- `set(hr, far, name = 'default', label = '', s = 1)`
+  - Create or update the *location* identified by `name`
+  - The `name` `'default'` is reserved for the first location
+  - Parameters
+    - `hr: number`
+      - Hit rate
+    - `far: number`
+      - False alarm rate
+    - `name: string = 'default'`
+      - A unique name to identify the *location* being set
+    - `label: string = ''`
+      - A visual label to use in the plot for this location
+    - `s: number = 1`
+      - Unequal variance parameter (default of `1` is equal variance)
+- `setWidthSDT(d, c, name = 'default', label = '', s = 1)`
+  - Create or update the *location* identified by `name`
+  - The `name` `'default'` is reserved for the first location
+  - Parameters
+    - `d: number`
+      - Sensitivity
+    - `c: number`
+      - Bias
+    - `name: string = 'default'`
+      - A unique name to identify the *location* being set
+    - `label: string = ''`
+      - A visual label to use in the plot for this location
+    - `s: number = 1`
+      - Unequal variance parameter (default of `1` is equal variance)
+
+##### Custom Events
+
+- `roc-point-change`
+  - Indicates a location on the plot has been moved
+  - `detail`
+    - `name: string`
+      - A unique name to identify the *location*
+    - `far: number`
+      - False alarm rate
+    - `hr: number`
+      - Hit rate
+    - `d: number`
+      - Sensitivity
+    - `c: number`
+      - Bias
+    - `s: number`
+      - Variance
+    - `label: string`
+      - Display label
+
+##### Example
+
+```html
+<roc-space interactive contour="bias" point="all" isoD="first" isoC="first" z-roc far="0.2" hr="0.9"></roc-space>
 ```
 
-#### `DetectableTable` / `<detectable-table>`
+#### `SDTModel` / `<sdt-model>`
 
-Interactive table of SDT outcomes
+Interactive visualization of SDT in terms of signal and noise distributions
 
-A results table for signal detection tasks. The results are presented in a two by two table
-organized by stimuli (signal present or absent) and responses ('present' or 'absent') leading to
-four possible outcomes: hits, misses, false alarms, and correct rejections. Results on signal
-present trials are optionally marginalized with the hit rate and those on signal absent trials with
-the false alarm rate. Results on response 'present' trials are optionally marginalized with the
-positive predictive value and those on response 'absent' trials with the false omission rate. And
-overall results are optionally marginalized with accuracy.
+This widget provides a visualization of signal detection theory. It can show *signal* and *noise*
+distributions and a threshold. The distributions can have unequal variance. The sensitivity, bias,
+and *signal* variance can be set and optionally displayed. In interactive mode, the bias can be
+adjusted by directly moving the threshold horizontally with mouse, touch, or keyboard, the
+sensitivity can be adjusted by directly moving a distribution horizontally with mouse, touch, or
+keyboard, and the variance can be adjusted by directly moving the *signal* distribution vertically
+with mouse, touch, or keyboard.
+
+In addition, the observation of stimuli can be visualized as blocks arriving at particular evidence
+levels, and stacking with previous stimuli to form a histogram. In interactive mode, when the model
+is adjusted, the blocks in the histogram will rearrange accordingly.
+
+The thresholded distributions and the histogram blocks can be colored based on the stimuli, the
+responses, or the outcomes.
 
 ##### Attributes
 
 - `interactive: boolean = false`
-  - Allow user to change values in the table
-- `numeric: boolean = false`
-  - Show numeric values instead of just labelling the cells
-- `summary: Set = <empty>`
-  - Which marginals to display
-  - Expressed in HTML as a space-separated list
-  - Options
-    - `'stimulusRates'`
-      - Display hit rate and false alarm rate
-    - `'responseRates'`
-      - Display positive predictive value and false omission rate
-    - `'accuracy'`
-      - Display overall accuracy
+  - Allow direct manipulation of threshold and distributions
 - `color: string = 'outcome'`
-  - How to color the cells
+  - Set how to color distributions and trials
   - Options
-    - `'none'`
-      - No colors
-    - `'accuracy'`
-      - Color based on accuracy, i.e. correct or error
-    - `'stimulus'`
-      - Color based on stimulus present or absent
-    - `'response'`
-      - Color based on response 'present' or 'absent'
     - `'outcome'`
-      - Full coloration based on hits, misses, false alarms and correct rejections
-- `hits: number = 40`
-  - Number of hits
-- `misses: number = 60`
-  - Number of misses
-- `false-alarms: number = 75`
-  - Number of false alarms
-- `correct-rejections: number = 25`
-  - Number of correct rejections
-- `payoff: boolean = false`
-  - Whether to display payoffs
-- `hit-payoff: number = undefined`
-  - Payoff for hits
-- `miss-payoff: number = undefined`
-  - Payoff for misses
-- `correct-rejection-payoff: number = undefined`
-  - Payoff for correct rejections
-- `false-alarm-payoff: number = undefined`
-  - Payoff for false alarms
+      - Color based on outcome of the hit, miss, false alarm, or correct rejection
+    - `'response'`
+      - Color based on the `'present'` or `'absent'` response provided
+    - `'stimulus'`
+      - Color based on the `present` or `absent` stimulus displayed
+    - `'none'`
+      - No coloring
+- `distributions: boolean = false`
+  - Show distributions
+- `threshold: boolean = false`
+  - Show threshold
+- `unequal: boolean = false`
+  - Allow unequal variance
+- `sensitivity: boolean = false`
+  - Show the sensitivity as *d'* with a measurement bar
+- `bias: boolean = false`
+  - Show the bias as *c* with a measurement bar
+- `variance: boolean = false`
+  - Show the variance as *s* with a measurement bar
+- `histogram: boolean = false`
+  - Show a histogram with a block for each trial/stimulus
+- `d: number = 1`
+  - Set the sensitivity, *d`*
+- `c: number = 0`
+  - Set the bias, *c*
+- `s: number = 1`
+  - Set the variance of the *signal* distribution, *s*
+
+##### Methods
+
+- `reset()`
+  - Reset the histogram to have no trials
+- `trial(trialNumber, signal, duration, wait, iti)`
+  - Add a trial to the histogram
+  - Parameters
+    - `trialNumber: number`
+      - Numerical count of the trial in the block
+    - `signal: string`
+      - Whether this is a signal `'present'` or `'absent'` trial 
+    - `duration: number`
+      - The stimulus duration on this trial in milliseconds
+    - `wait: number`
+      - The wait duration on this trial in milliseconds
+    - `iti: number`
+      - The inter-trial interval duration after this trial in milliseconds
+- `pauseTrial()`
+  - Pause the animation of trials in the histogram
+- `resumeTrial()`
+  - Resume the animation of trials in the histogram
 
 ##### Custom Events
 
-- `detectable-table-change`
-  - One or more values in the table have changed
+- `sdt-model-change`
+  - Indicates that one or more model parameters have been changed
   - `detail`
+    - `d: number`
+      - Sensitivity
+    - `c: number`
+      - Bias
+    - `s: number`
+      - Variance
+    - `far: number`
+      - False alarm rate
+    - `hr: number`
+      - Hit rate
     - `h: number`
       - Hits
     - `m: number`
@@ -631,21 +625,31 @@ overall results are optionally marginalized with accuracy.
       - False alarms
     - `cr: number`
       - Correct rejections
-    - `hr: number`
-      - Hit rate
-    - `far: number`
-      - False alarm rate
-    - `ppv: number`
-      - Positive predictive value
-    - `fomr: number`
-      - False omission rate
-    - `acc: number`
-      - Accuracy
+- `detectable-response`
+  - Indicates that an animated histogram trial has generated a response 
+  - `detail`
+    - `stimulus: string`
+      - Whether the signal was actually `'present'` or `'absent'`
+    - `response: string`
+      - Whether the response was `'present'` or `'absent'`
+    - `outcome: string`
+      - The outcome of the trial as a hit (`'h'`), miss (`'m'`), correct rejection (`'cr'`), or
+        false alarm (`'fa'`)
+    - `h: number`
+      - Total hits in this block
+    - `m: number`
+      - Total misses in this block
+    - `fa: number`
+      - Total false alarms in this block
+    - `cr: number`
+      - Total correct rejections in this block
+    - `nr: number`
+      - Total no responses in this block
 
 ##### Example
 
 ```html
-<detectable-table interactive numeric summary="stimulusRates responseRates accuracy" = color="outcome" hits="80" misses="20" false-alarms="35" correct-rejections="65" payoff hit-payoff="60" miss-payoff="-60" false-alarm-payoff="-40" correct-rejection-payoff="40"></detectable-table>
+<sdt-model interactive color="outcome" distributions threshold unequal sensitivity bias variance histogram d="2" c="1" s="1.5"></sdt-model>
 ```
 
 ### Equations
@@ -786,6 +790,44 @@ False alarm rate from false alarms and correct rejections
 <sdt-equation-facr2far numeric interactive false-alarms="25" correct-rejections="75"></sdt-equation-facr2far>
 ```
 
+#### `SDTEquationHFa2Ppv` / `<sdt-equation-hfa2ppv>`
+
+Positive predictive value rate from hits and false alarms
+
+##### Attributes
+
+- `numeric: boolean = false`
+  - Show values instead of just the names of variables
+- `interactive: boolean = false`
+  - Allow editing of numeric values in the equation
+- `hits: number = 0`
+  - Hits
+- `false-alarms: number = 0`
+  - False alarms
+
+##### Properties
+
+- `ppv: number`
+  - Positive predictive value
+
+##### Custom Events
+
+- `sdt-equation-hfa2ppv-change`
+  - Indicates that the values in the equation have changed
+  - `detail`
+    - `h: number`
+      - New value of hits
+    - `fa: number`
+      - New value of false alarms
+    - `hr: number`
+      - New value of positive predictive value
+
+##### Example
+
+```html
+<sdt-equation-hfa2ppv numeric interactive hits="75" false-alarms="25"></sdt-equation-hfa2ppv>
+```
+
 #### `SDTEquationHM2Hr` / `<sdt-equation-hm2hr>`
 
 Hit rate from hits and misses
@@ -954,6 +996,44 @@ Sensitivity from hit rate and false alarm rate
 <sdt-equation-hrfar2d numeric interactive unequal hit-rate="0.75" false-alarm-rate="0.25" s="1.5"></sdt-equation-hrfar2d>
 ```
 
+#### `SDTEquationMCr2Fomr` / `<sdt-equation-mcr2fomr>`
+
+Positive predictive value rate from hits and false alarms
+
+##### Attributes
+
+- `numeric: boolean = false`
+  - Show values instead of just the names of variables
+- `interactive: boolean = false`
+  - Allow editing of numeric values in the equation
+- `misses: number = 0`
+  - Misses
+- `correct-rejections: number = 0`
+  - Correct rejections
+
+##### Properties
+
+- `fomr: number`
+  - False omission rate
+
+##### Custom Events
+
+- `sdt-equation-mcr2fomr-change`
+  - Indicates that the values in the equation have changed
+  - `detail`
+    - `m: number`
+      - New value of misses
+    - `cr: number`
+      - New value of correct rejections
+    - `fomr: number`
+      - New value of false omission rate
+
+##### Example
+
+```html
+<sdt-equation-mcr2fomr numeric interactive misses="75" correct-rejections="25"></sdt-equation-mcr2fomr>
+```
+
 #### `SDTEquation`
 
 Base class for all interactive SDT equations
@@ -966,7 +1046,7 @@ export default class SDTEquationSomething extends SDTEquation {
 }
 ```
 
-`SDTEquation` extends `DetectableElement` extends `DecidableElement` extends `LitElement`
+`SDTEquation` extends `DetectableElement` extends `DecidablesElement` extends `LitElement`
 
 ### Examples
 
@@ -1118,6 +1198,49 @@ because their values are received from the model's task performance.
 </detectable-example-model>
 ```
 
+#### `DetectableExampleMultiple` / `<detectable-example-multiple>`
+
+Multiple value example
+
+Used to build specialized examples with multiple values for one variable (sensitivity or bias) and a
+single value for the other variable. Can include controls, ROC space, and a visual rendering of
+signal detection theory. The SDT model can be interactive.
+
+##### Attributes
+
+- `variable: string = 'd'`
+  - Choose which variable to have multiple values
+  - Options
+    - `'d'`
+      - Sensitivity
+    - `'c'`
+      - Bias
+- `values: Array = [0, 1]`
+  - Which marginals to display
+  - Expressed in HTML as a space-separated list of numbers
+
+##### Slots
+
+- *unnamed*
+  - Place relevant `detectable-elements` components here
+  - Wired elements
+    - `<detectable-control>`
+      - Allows user to adjust parameters
+    - `<sdt-model>`
+      - Display and change a visual rendering of sensitivity and bias
+    - `<roc-space>`
+      - Displays the hit rate and false alarm rate in ROC space
+
+##### Example
+
+```html
+<sdt-example-multiple variable="d" values="0 1 2 3 4">
+  <detectable-control z-roc></detectable-control>
+  <sdt-model interactive threshold bias></sdt-model>
+  <roc-space z-roc point="rest" iso-d="rest" iso-c="first"></roc-space>
+</sdt-example-multiple>
+```
+
 #### `DetectableExampleUnequal` / `<detectable-example-unequal>`
 
 Unequal variance example
@@ -1164,7 +1287,7 @@ export default class DetectableExampleSomething extends DetectableExample {
 }
 ```
 
-`DetectableExample` extends `DetectableElement` extends `DecidableElement` extends `LitElement`
+`DetectableExample` extends `DetectableElement` extends `DecidablesElement` extends `LitElement`
 
 ### Base class
 
@@ -1180,7 +1303,7 @@ export default class DetectableElementSomething extends DetectableElement {
 }
 ```
 
-`DetectableElement` extends `DecidableElement` extends `LitElement`
+`DetectableElement` extends `DecidablesElement` extends `LitElement`
 
 ## Development