#Adaptive test tutorial for updated version of catR.
This tutorial will show you how to modify your adaptive test on Concerto v3 to suit the updated version of catR (catR 3.0; 2014-04-25). i.e. if you have recently (after 2014-04-25) downloaded Concerto onto your own server or have updated the packages on your server, you will need to modify your test slightly.
NOTE: If you are using our demo instance (http://concerto.e-psychometrics.com/demo/cms/index.php), you will not need to modify your test as we have not updated the packages on the server!
This tutorial will show you how to create a simple adaptive test on Concerto v3 that looks like this:
Concerto v3 Adaptive test
It is assumed that you’ve already taken the Concerto v3 Tutorials: Create a simple test section and are familiar with the basic functions of Concerto v3.
Obviously, this is a very basic test, but it easily shows the idea behind Concerto. Don't forget to add formatting of your choice to make the test professional/pretty! The tests that you develop can be run as a separate website or embedded in the other websites or applications.
It is best to use Google Chrome to run the Concerto administration panel. Please ensure that you have Concerto v3.0 or higher, preferably the latest version. Go to concerto_installation_path/cms/ and login using your credentials. If you haven't installed Concerto on your server, you can use our demo installation at http://concerto.e-psychometrics.com/demo/cms/ to get a free basic account or login to an existing account hosted on our server.
After logging in to Concerto, switch the interface to the SIMPLE mode using the buttons in the top right corner (you will not need advanced functions as for now!):
Create a new template called _introduction_adaptive_ and add some suitable text to describe the test and make participants feel comfortable.
Create a new template called _test item_adaptive_ and add the following content:
Create another new template called _feedback_adaptive_ that contains:
The next step is to create an item bank for the test. Usually, software like R and LTM package are used to generate item parameters. Here, let’s use a mock-up item bank with only one item parameter (difficulty) which can be generated using the Rasch model.
Download and unzip this CSV file http://tinyurl.com/cefwg2z and explore it using Excel or notepad.
Go to the tables tab and click the ‘+ add new object’ icon to add a new table. Assign a meaningful name (E.g. adaptive_test_table) and save it. Click the import table from CSV file icon to import the table that you have downloaded. Concerto will automatically read the data into table format. All you need to do is alter the column names and the data types (see below).
Go to the ‘tests’ tab on the upper left side of the page. Create a new test by clicking the ‘+ add new object’ icon below the “list of available objects” (it is likely to be empty!). Assign a relevant name for the test and click ‘OK’.
To edit a test at any time, click on the pencil symbol towards the right of the specific test you want to edit. Be careful not to click the ‘bin’ icon (second symbol from the left) unless you wish to delete your test!
This step involves editing your test overall. Click the ‘tests’ tab on the upper left side of the page and click the pencil icon on your specific test to edit it. To add a new section, click the ‘+’ at the right side of the last section. At this point, the last section is ‘1. start’.
Follow the table below to add new sections to your test, using the editor. Please double-check your test logic sections using the text and screen shots provided to avoid any errors that may prevent your test from running currently! Please pay attention to all the letters, as Concerto is case sensitive. Please remember to save your test often and do NOT refresh the page or (accidentally) press ‘go back’.
|Load HTML template||Select the introduction template (or whatever you named it)|
|Set variable||SET VARIABLE theta by R code: "Score not available yet"|
|Set variable||SET VARIABLE difficulties from table: adaptive_test (or whatever you named it); COLUMNS difficulty|
|Set variable||SET VARIABLE current_item by R code: 50|
|Set variable||SET VARIABLE responses by R code: NULL|
|Set variable||SET VARIABLE itempar by R code: as.matrix(cbind(1,difficulties,0,1))|
|Set variable||SET VARIABLE items_administered by R code: current_item|
|Set variable||SET VARIABLE question from table: adaptive_test_table (or whatever you named it); COLUMNS content WHERE id equal current_item|
|Set variable||SET VARIABLE difficulty from table: adaptive_test_table (or whatever you named it); COLUMNSdifficultyWHEREidequalcurrent_item|
|Set variable||SET VARIABLE correct_answer from table: adaptive_test (or whatever you named it); COLUMNS correct_answer WHERE id equal current_item|
|Load HTML template||Select the test_item_adaptive template (or whatever you named it).|
|IF statement||IF is.na(response) equal 1 THEN GO TO: (select the previous section where you load the items template). This step is to ensure that there are no missing responses or non-numeric type responses.|
|Set variable||SET VARIABLE responses by R code: c(responses, correct_answer == response) _Note: The operation correct_answer==response is to compare the correct_answer with response and give value 1 if the statement is true and 0 if false. In this way, the elements in the vector responses will be digits either 1 or 0, corresponding to right or wrong._|
|Set variable||SET VARIABLE theta by R code: it<-itempar[items_administered,1:4, drop=F] and in the next line thetaEst(it, responses) (Note: the above two lines of code should be in separate lines; do not enter them continuously as one sentence!)|
|Set variable||SET VARIABLE current_item by R code: nextItem(itemPar,
|Set variable||SET VARIABLE items_administered by R code: c(items_administered, current_item)|
|Set variable||SET VARIABLE nitems by R code: length(items_administered)|
|IF statement||IF nitems equal or lesser than 15 THEN GO TO (select the section where you set the variable "question")|
|Load HTML template||Select feedback template (or whatever else you named it)|
Click the Run Test button at the start of the tests section.
Alternatively, use the following URL: (concerto_installation_path)/?tid=(TEST_ID)
Or if using a free account on our server: http://concerto.e-psychometrics.com/demo/?tid=69
_Substitute the last 2 digits in the URL with the_test idof your specific test.
Note: If the test does not work as expected, you will likely see a page with R return code. The second part down the page R output will provide you with the error message which tells you what goes wrong and in which test section.