The r2Winsteps package was developed to provide a convenient interface between R and the Rasch modeling software Winsteps. A full overview of the package functionality can be seen in the Overview of the r2Winsteps Package vignette. The purpose of this vignette is to discuss functions helpful for equating data with Winsteps via the r2Winsteps package. That is, writing anchor files and structure files from analyses, and/or using anchor or structure files in analyses to anchor items and step values (in the case of the partial credit model) to their previously calibrated values. We will begin by discussing writing anchor and structure files. We will then transition to using those files in equating.

Writing Anchor and Structure Files

Vignettes are long form documentation commonly included in packages. Because they are part of the distribution of the package, they need to be as compact as possible. The html_vignette output type provides a custom style sheet (and tweaks some options) to ensure that the resulting html is as small as possible. The html_vignette format:

Vignette Info

Note the various macros within the vignette section of the metadata block above. These are required in order to instruct R how to build the vignette. Note that you should change the title field and the \VignetteIndexEntry to match the title of your vignette.

Styles

The html_vignette template includes a basic CSS theme. To override this theme you can specify your own CSS in the document metadata as follows:

output: 
  rmarkdown::html_vignette:
    css: mystyles.css

Figures

The figure sizes have been customised so that you can easily put two images side-by-side.

plot(1:10)
plot(10:1)

You can enable figure captions by fig_caption: yes in YAML:

output:
  rmarkdown::html_vignette:
    fig_caption: yes

Then you can use the chunk option fig.cap = "Your figure caption." in knitr.

More Examples

You can write math expressions, e.g. $Y = X\beta + \epsilon$, footnotes^[A footnote here.], and tables, e.g. using knitr::kable().

knitr::kable(head(mtcars, 10))

Also a quote using >:

"He who gives up [code] safety for [code] speed deserves neither." (via)



DJAnderson07/r2Winsteps documentation built on Sept. 12, 2019, 1:06 a.m.