student_edge_avoidance_test_statistic_value: Test Statistic Value of Edge Avoidance Hypothesis Test...

In melissavanbussel/Analyze-Scantron: Analyze your multiple choice test

Description

Finds the test statistic value of a simple hypothesis test, testing whether there is significant statistical evidence of students avoiding edge options.

Usage

student_edge_avoidance_test_statistic_value(exam, numchoicesperitem = NULL,
  check_format = FALSE)

Arguments

exam	A data.frame object containing a test that follows the formatting of a typical Scantron file.
numchoicesperitem	A vector which has the same length as the number of questions on the test, where each element in the vector corresponds to the number of choices there were for each of the questions on the test. For example, if your test had 35 questions which each had 5 options, numchoicesperitem = rep(5, 35).
check_format	a logical value (default = TRUE) indicating whether the "exam" object should be tested for correct formatting.

Details

The null hypothesis is that students are not avoiding edge options. That is, the true proportion of students choosing edge options is the expected proportion of students choosing edge options. For example, consider a question on a test which has options A, B, C, D and E, where the correct answer is "B". Say that 70 expect that the remaining 30 to choose edge options (A or E), and 15 our null hypothesis would be true. The alternative hypothesis is that students are avoiding guessing edge options. That is, the true proportion of students choosing edge options is smaller than the expected proportion of students choosing edge options. For example, if only 2 test statistic value for the described hypothesis test.

Value

Returns a numeric value which corresponds to the test statistic value for the hypothesis test.

Note

The argument "exam" must be in the format of a typical Scantron results file. Column 1 should correspond to ID (e.g., student number); column 2 should correspond to DEPT (e.g., MATH); column 3 should correspond to COURSE CODE (e.g., 1051); the remaining columns should each correspond to one of the questions on the test. The header of the data frame should contain the column names, and row 1 of the data frame should contain the answer key for the test. For example, if you had an exam with 25 students and 40 questions, the data.frame object should have 26 rows and 43 columns.

The "check_format" argument defaults to null. If this is left as null, the function will call the num_choices_per_item function, which will do its best to guess the number of options for each question. This is done by looking at the student answers and finding the "largest" answer for each question. For example, if at least one student answered "E", but no students answered "F", the function would guess that there were 5 options for that question.

melissavanbussel/Analyze-Scantron documentation built on May 10, 2019, 1:19 a.m.