Skip to content

Commit

Permalink
add vignettes about cont rep task and mixture models
Browse files Browse the repository at this point in the history
  • Loading branch information
venpopov committed Feb 7, 2024
1 parent 0861938 commit 2c60bab
Show file tree
Hide file tree
Showing 9 changed files with 448 additions and 8 deletions.
5 changes: 4 additions & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,10 @@ Suggests:
rmarkdown,
bookdown,
tidybayes,
ggplot2
ggplot2,
mixtur,
ggthemes,
cowplot
Config/testthat/edition: 3
Imports:
brms,
Expand Down
Binary file added inst/mixture2p_vignette_fit.rds
Binary file not shown.
Binary file added inst/mixture2p_vignette_fit1.rds
Binary file not shown.
77 changes: 71 additions & 6 deletions vignettes/REFERENCES.bib
Original file line number Diff line number Diff line change
@@ -1,8 +1,73 @@
@article{Oberauer_2023, address={US}, title={Measurement models for visual working memory—A factorial model comparison}, volume={130}, ISSN={1939-1471}, DOI={10.1037/rev0000328}, number={3}, journal={Psychological Review}, publisher={American Psychological Association}, author={Oberauer, Klaus}, year={2023}, pages={841–852} }

@article{Oberauer_2023,
title = {Measurement models for visual working memory—A factorial model comparison},
author = {Oberauer, Klaus},
year = 2023,
journal = {Psychological Review},
publisher = {American Psychological Association},
address = {US},
volume = 130,
number = 3,
pages = {841–852},
doi = {10.1037/rev0000328},
issn = {1939-1471}
}
@misc{abramowitz1988handbook,
title={Handbook of mathematical functions with formulas, graphs, and mathematical tables},
author={Abramowitz, Milton and Stegun, Irene A and Romer, Robert H},
year={1988},
publisher={American Association of Physics Teachers}
title = {Handbook of mathematical functions with formulas, graphs, and mathematical tables},
author = {Abramowitz, Milton and Stegun, Irene A and Romer, Robert H},
year = 1988,
publisher = {American Association of Physics Teachers}
}
@article{Zhang_Luck_2008,
title = {Discrete fixed-resolution representations in visual working memory},
author = {Zhang, Weiwei and Luck, Steven J.},
year = 2008,
journal = {Nature},
volume = 453,
number = 7192,
pages = {233–235},
doi = {10.1038/nature06860},
issn = {0028-0836},
rights = {© 2008 Nature Publishing Group},
language = {en}
}
@article{Bays_Catalao_Husain_2009,
title = {The precision of visual working memory is set by allocation of a shared resource},
author = {Bays, Paul M. and Catalao, Raquel F. G. and Husain, Masud},
year = 2009,
journal = {Journal of Vision},
volume = 9,
number = 10,
pages = {7–7},
doi = {10.1167/9.10.7},
issn = {1534-7362},
language = {en}
}
@article{Wilken_Ma_2004,
title = {A detection theory account of change detection},
author = {Wilken, Patrick and Ma, Wei Ji},
year = 2004,
journal = {Journal of vision},
volume = 4,
number = 12,
pages = {11–11}
}
@article{Bays_Gorgoraptis_Wee_Marshall_Husain_2011,
title = {Temporal dynamics of encoding, storage, and reallocation of visual working memory},
author = {Bays, Paul M. and Gorgoraptis, Nikos and Wee, Natalie and Marshall, Louise and Husain, Masud},
year = 2011,
journal = {Journal of vision},
volume = 11,
number = 10,
pages = {6–6}
}
@article{Oberauer_Lin_2017,
title = {An interference model of visual working memory.},
author = {Oberauer, Klaus and Lin, Hsuan-Yu},
year = 2017,
journal = {Psychological Review},
volume = 124,
number = 1,
pages = {21–59},
doi = {10.1037/rev0000044},
language = {en}
}
70 changes: 70 additions & 0 deletions vignettes/articles/vwm-crt.Rmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: "Continuous reproduction tasks (CRT)"
output:
bookdown::html_document2:
keep_md: true
bibliography: ../REFERENCES.bib
pkgdown:
as_is: true
---

```{=html}
<style type="text/css">
div.main-container {
max-width: 800px !important;
}
p {
margin-top: 1.5em ;
margin-bottom: 1.5em ;
}
</style>
```
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
```

# Task description

In research on visual working memory participants are often asked to remember and reproduce continuous features of visual objects such as their color or orientation. In the continuous reproduction task (sometimes also called delayed estimation task), participants encode a set of visual objects into visual working memory and are then asked to reproduce a specific feature of one cued object on a continuous scale at test (see Figure \@ref(fig:vwmcrt) for an illustration).

Most often the features used in these tasks are colors sampled from a color wheel [@Wilken_Ma_2004] or continuous orientations of a bar or a triangle [@Bays_Gorgoraptis_Wee_Marshall_Husain_2011]. The set of to-be-remembered objects typically consists of one up to eight objects spatially distributed over the screen. Thus, participants must associate the to-be-remembered features (e.g. color or orientation) with the spatial locations they are presented at. The precision of the representation of an object’s feature in visual working memory is measured as the angular deviation from the true feature presented at encoding.

```{r vwmcrt, echo=F, fig.cap="A typical continuous reproduction task", out.width=450}
knitr::include_graphics("../vwm-crt.png")
```

# The role of measurement models

In these continuous reproduction tasks, the simplest measure of performance is the average angle deviation of the response from the true feature value. In many studies, this average recall error has been the main dependent variable for evaluating the effect of experimental manipulations. Yet, the average recall error confounds different properties of memory representations and does not sufficiently represent the theoretical processes assumed by current models of visual working memory. Therefore, different measurement models have been proposed to formalize distinct aspects of visual working memory models and how they translate into observed behavior.

A measurement model is a statistical model that describes the relationship between latent cognitive processes and observed behavior. For continuous reproduction tasks, measurement models provide a more refined representation of memory processes because they decompose the average recall error into several theoretically meaningful parameters.

At the core of these models is the assumption that responses in continuous reproduction tasks can stem from different distributions depending on the continuous activation of different memory representation or the cognitive state a person is in at recall.

# CRT Models in the `bmm` package

The `bmm` package implements several measurement models for analyzing continuous reproduction data:

#### The two-parameter mixture model [@Zhang_Luck_2008] {.unnumbered}

- see `?mixture2p` and `vignette("mixture_models")`

#### The three-parameter mixture model [@Bays_Catalao_Husain_2009] {.unnumbered}

- see `?mixture3p` and `vignette("mixture_models")`

#### The Interference Measurement Model [@Oberauer_Lin_2017] {.unnumbered}

- see `?IMM` and `vignette("imm")`

#### The Signal Discrimination Model (SDM) by [@Oberauer_2023] {.unnumbered}

- see `?sdmSimple` and `vignette("sdm-simple")`


# References

Loading

0 comments on commit 2c60bab

Please sign in to comment.