{"id":15975947,"url":"https://github.com/gadenbuie/mctestanalysis","last_synced_at":"2026-03-08T02:04:29.915Z","repository":{"id":44963392,"uuid":"88224373","full_name":"gadenbuie/mctestanalysis","owner":"gadenbuie","description":"📚 Apps and reports for multiple-choice test analysis in R with Shiny","archived":false,"fork":false,"pushed_at":"2018-03-15T18:44:07.000Z","size":278,"stargazers_count":7,"open_issues_count":10,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-10-31T09:48:33.884Z","etag":null,"topics":["classical-test-theory","item-analysis","item-response-theory","multiple-choice-tests","r","rmarkdown","shiny","shiny-apps"],"latest_commit_sha":null,"homepage":"https://gadenbuie.github.io/mctestanalysis/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gadenbuie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-14T02:22:09.000Z","updated_at":"2023-09-19T13:18:12.000Z","dependencies_parsed_at":"2022-07-13T15:30:04.154Z","dependency_job_id":null,"html_url":"https://github.com/gadenbuie/mctestanalysis","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gadenbuie/mctestanalysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadenbuie%2Fmctestanalysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadenbuie%2Fmctestanalysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadenbuie%2Fmctestanalysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadenbuie%2Fmctestanalysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gadenbuie","download_url":"https://codeload.github.com/gadenbuie/mctestanalysis/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadenbuie%2Fmctestanalysis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30242404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T00:58:18.660Z","status":"online","status_checked_at":"2026-03-08T02:00:06.215Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["classical-test-theory","item-analysis","item-response-theory","multiple-choice-tests","r","rmarkdown","shiny","shiny-apps"],"created_at":"2024-10-07T22:06:33.627Z","updated_at":"2026-03-08T02:04:29.894Z","avatar_url":"https://github.com/gadenbuie.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MC Test Analysis\n\nThis [R] package provides a nice set of interfaces via [Shiny] for the analysis and review of multiple choice tests.\nView full package documentation at \u003chttps://gadenbuie.github.io/mctestanalysis/\u003e.\n\n## Try Online\n\nYou can try out the Shiny web interface online at \u003chttps://gadenbuie.shinyapps.io/mctestanalysis/\u003e, which demonstrates the test results explorer interface but cannot produce the PDF or HTML reports.\nFor the complete features, you can install the package and use the interface locally (without have to upload your data) by following the instructions below.\n\n## Table of contents\n\n- [Required Software](#required-software)\n    - [R](#r)\n    - [RStudio](#rstudio)\n    - [LaTeX](#latex)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Data Format](#data-format)\n\n# Required Software\n\nYou need to download and install the latest version of the following software.\nIf you already have recent versions of R, RStudio and LaTeX (optional) installed, you can skip ahead to the section on [installing the MCTestAnalysis library](#install-mctestanalysis).\n\n## R \n\nUsing the MCTestAnalysis package does not require any R programming. \nIf you are interested in learning to program in R, RStudio have collated some excellent resources for [Learning R Programming](https://www.rstudio.com/online-learning/#R) on their webpage.\n\nTo install:\n\n- \u003chttp://cran.r-project.org\u003e\n\n- Click the \"Download R for ...\" link for your OS (Linux, Mac, Windows)\n\n- Click the link for the **base** distribution. This package was built and tested on R 3.3.2, although both this package and R may have been updated.\n\n\n## RStudio\n\n[RStudio] is an IDE (an application that supports the development and use of a language) for R.\nThe MCTestAnalysis package is best used from within RStudio, but the user only needs to be able to find the Console window to run the few commands [described below](#install-mctestanalysis).\n\nFor a quick introduction and reference for the RStudio IDE, RStudio publishes an up-to-date [RStudio cheatsheet](https://www.rstudio.com/resources/cheatsheets/).\nThe [RStudio Essentials Webinar Series](https://www.rstudio.com/resources/webinars/rstudio-essentials-webinar-series-part-1/) is also a good place to start learning about the RStudio IDE.\n\nTo install:\n\n- \u003chttp://www.rstudio.com/products/rstudio/download\u003e\n\n- Choose the appropriate installer for your OS under the **Installers for Supported Platforms** heading.\n\n## LaTeX\n\nLaTeX is required in order to create PDF reports.\nThe package will fall back on HTML reports if `pdflatex` is not installed.\nThe HTML version of the report works well on screens but does not print nicely.\n\nIf you'd like to output the report as well-behaved, nicely-printing PDF, a LaTeX distribution is required.\n\nTo install:\n\n- Windows (MiKTeX)\n     - Install the \"Basic MiKTeX Installer\" from \u003chttps://miktex.org/download\u003e.\n     - *Optional*: After installation, run [the update wizard](https://miktex.org/howto/update-miktex) by running \"MiKTeX Update\" from the Windows start menu.\n\n- Mac OS X (MacTeX)\n    - Install the full MacTeX installation from \u003chttp://www.tug.org/mactex/\u003e. (Warning: the download is big!)\n\n- Ubuntu (texlive)\n    - Install texlive via the package manager or on the command line with `sudo apt-get install texlive-core`.\n    - Also install fonts and extra things with `sudo apt-get install texlive-fonts-recommended texlive-latex-recommended`.\n    - Or alternatively install the full texlive package with `sudo apt-get install texlive-latex-extra`.\n\n\n# Installation\n\n## Mac/Linux\n\nOn Mac OS X or Unix-based systems, install this package by running the following commands inside [RStudio] or the [R] command line:\n\n```r\ninstall.packages(\"devtools\")\ndevtools::install_github(\"gadenbuie/mctestanalysis\")\n```\n\n## Windows\n\nOn Windows, the current version of `devtools` doesn't correctly install all package dependencies, so they need to be installed manually before installing the MCTestAnalysis package.\n\nCopy and paste the following command into the RStudio console or the R command line to install the MCTestAnalysis package dependencies.\n\n```r\ninstall.packages(c(\"devtools\", \"dplyr\", \"ggplot2\", \"shiny\", \"miniUI\",\n                   \"ltm\", \"psych\", \"psychometric\", \"reshape2\", \"tibble\",\n                   \"DT\", \"rmarkdown\", \"backports\", \"pander\", \"gridExtra\",\n                   \"survival\"))\n```\n\nThen run the following to complete the installation of the MCTestAnalysis package.\n\n```r\ndevtools::install_github(\"gadenbuie/mctestanalysis\")\n```\n\n# Usage\n\nOpen [RStudio] or [R] on the command line or GUI and run the following commands:\n\n```r\nlibrary(MCTestAnalysis)\n\n# Launch test exploration interface\nexplore()\n\n# Create a test analysis report\nreport()\n```\n\nWhen running `explore()` a browser window will open with the MC Test Analysis exploration application.\nThe `report()` function will launch a window within RStudio to guide the user through the creation of a PDF report.\n\n# Data format\n\nThis package requires both an Answer Key and a table of student responses. \nAn example of each table is provided, in the preferred format, in the  [`inst/extdata` folder](inst/extdata) of this repo, or from links on the \"Import\" tab of the `explore()` or `report()` interfaces.\n\nA detailed overview of the required data format is available at \u003chttp://www.eng.usf.edu/~kaw/MCTestAnalysis/MCTestAnalysis_input.pdf\u003e.\nAdditional example [test results](http://www.eng.usf.edu/~kaw/MCTestAnalysis/sample_answer_key.csv) and [answer key](http://www.eng.usf.edu/~kaw/MCTestAnalysis/sample_student_answers.csv) CSV files are also available.\n\n[R]: https://cran.r-project.org/\n[Shiny]: http://shiny.rstudio.com/\n[Rstudio]: https://www.rstudio.com/products/RStudio/\n[Rtools]: https://cran.r-project.org/bin/windows/Rtools/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgadenbuie%2Fmctestanalysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgadenbuie%2Fmctestanalysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgadenbuie%2Fmctestanalysis/lists"}