A Simulation Tool to Determine the Required Sample Size for Repertory Grid Studies

Simulation tool to facilitate determination of required sample size to achieve category saturation for studies using multiple repertory grids in conjunction with content analysis.

Build Status


A common approach for evaluating multiple repertory grids is to sort the elicited constructs into categories using content analysis (e.g. Green, 2004; Jankowicz, 2004). Sometimes the question arises what sample size would be needed in order to achieve a minimum saturation of a certain number of constructs per category. The gridsampler GUI allows to run simulations in order to answer these type of questions.

An introduction to its usage can be found on GitHub pages. Please report any bugs here.


You can install the software from CRAN:


or from GitHub:

if (!("devtools" %in% installed.packages())) {
} else {

To run it, simply type this:

# Or run it in a browser window (recommended):
gridsampler(launch.browser = "TRUE")


If you use gridsampler in your publications, you can cite it as follows.

Heckmann, M . & Burk, L. (2016). gridsampler: A simulation tool to determine the required sample size for repertory grid studies. R package version 0.5. Zenodo. doi:10.5281/zenodo.61067



  • Green, B. (2004). Personal construct psychology and content analysis. Personal Construct Theory & Practice, 1(3), 82–91.
  • Jankowicz, D. (2004). The easy guide to repertory grids. Chichester, England: John Wiley & Sons.




  • Add tooltips for various buttons via shinyBS package
  • Tweaked various input element labels
  • Tweaked default values for better results


  • automated linux build check via travis-ci
  • unit tests added
  • improved vignette layout


  • document internal functions
  • tour explaining GUI elements added
  • switch from GTK to shiny GUI
  • passes R CMD check without issues


  • improved grahics, consistent names in all panels


  • all dependencies replaced by import directives
  • rename main function from sampler to gridsampler


  • first version with working features

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.6 by Mark Heckmann, 5 years ago


Report a bug at https://github.com/markheckmann/gridsampler/issues

Browse source code at https://github.com/cran/gridsampler

Authors: Mark Heckmann [aut, cre] , Lukas Burk [aut]

Documentation:   PDF Manual  

GPL-3 license

Imports shiny, ggplot2, reshape2, plyr, shinythemes, BiasedUrn, shinyBS

Suggests knitr, testthat, rmarkdown

See at CRAN