Adaptive Quiz: Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. It enhances and compliments the moodle activity adaptive quiz in terms of providing an elaborate CAT item pool, a complete CAT engine and advanced CAT test deployments. In CAT testing sessions, test takers are presented only with questions that fall within their identified ability range, based on the answers they give. This is achieved by using common statistical models Item Response Theory (IRT) and allow for significant short testing times and more accurate results.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin supports the following common Item Response Theory (IRT) models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin further enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Finally, the plugin allows to pursuit different test strategies:

• running a "standard" CAT test


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• semi-classical diagnose for all given (sub-)scales


• classical testing (ask all questions), but evaluation with IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the the wunderbyte fork until our changes are integrated into the upstream plugin (in progress). This branch already includes the subplugin adaptivequizcatmodel_catquiz, which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table - database and tables handling

It is also recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• CSV Importer: imports items, params and scales from a csv file.

CSV Importer

• The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, and no context is defined, a new context is created automatically. It contains the items from the default context plus the newly imported items.


• If a context is specified when importing new items, the context of the corresponding root scale has to be changed (in the CAT Manager dashboard, Scales tab) so that these items are used.


• For items to be updated via importer, the context id should be defined to enable matching with existing items.

Shortcodes

• To use the feedback and statistics functionality seamingly in your courses or anywhere you want to show them, use plugin filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

Additionally, the following parameter can be added, like e.g. [catquizfeedback numberofattempts=3]

* numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

Also, the following parameters can be defined, like e.g. [catquizfeedback testid=73 starttime=1723569996]:

* globalscale // Display only attempts for this scale.

* testid      // Display only attempts of the given test.

* courseid    // Display only attempts of tests in the given course.

* starttime   // Display only attempts that were started after this timestamp. Should be a unix timestamp.

* endtime     // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz: Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. It enhances and compliments the moodle activity adaptive quiz in terms of providing an elaborate CAT item pool, a complete CAT engine and advanced CAT test deployments. In CAT testing sessions, test takers are presented only with questions that fall within their identified ability range, based on the answers they give. This is achieved by using common statistical models Item Response Theory (IRT) and allow for significant short testing times and more accurate results.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin supports the following common Item Response Theory (IRT) models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin further enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Finally, the plugin allows to pursuit different test strategies:

• running a "standard" CAT test


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• semi-classical diagnose for all given (sub-)scales


• classical testing (ask all questions), but evaluation with IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the the wunderbyte fork until our changes are integrated into the upstream plugin (in progress). This branch already includes the subplugin adaptivequizcatmodel_catquiz, which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table) - database and tables handling

It is also recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• CSV Importer: imports items, params and scales from a csv file.

CSV Importer

• The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, and no context is defined, a new context is created automatically. It contains the items from the default context plus the newly imported items.


• If a context is specified when importing new items, the context of the corresponding root scale has to be changed (in the CAT Manager dashboard, Scales tab) so that these items are used.


• For items to be updated via importer, the context id should be defined to enable matching with existing items.

Shortcodes

• To use the feedback and statistics functionality seamingly in your courses or anywhere you want to show them, use plugin filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

Additionally, the following parameter can be added, like e.g. [catquizfeedback numberofattempts=3]

* numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

Also, the following parameters can be defined, like e.g. [catquizfeedback testid=73 starttime=1723569996]:

* globalscale // Display only attempts for this scale.

* testid      // Display only attempts of the given test.

* courseid    // Display only attempts of tests in the given course.

* starttime   // Display only attempts that were started after this timestamp. Should be a unix timestamp.

* endtime     // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz: Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. It enhances and compliments the moodle activity adaptive quiz in terms of providing an elaborate CAT item pool, a complete CAT engine and advanced CAT test deployments. In CAT testing sessions, test takers are presented only with questions that fall within their identified ability range, based on the answers they give. This is achieved by using common statistical models Item Response Theory (IRT) and allow for significant short testing times and more accurate results.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin supports the following common Item Response Theory (IRT) models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin further enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Finally, the plugin allows to pursuit different test strategies:

• running a "standard" CAT test


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• semi-classical diagnose for all given (sub-)scales


• classical testing (ask all questions), but evaluation with IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the the wunderbyte fork until our changes are integrated into the upstream plugin (in progress). This branch already includes the subplugin adaptivequizcatmodel_catquiz, which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table) - database and tables handling

It is also recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• CSV Importer: imports items, params and scales from a csv file.

CSV Importer

• The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, and no context is defined, a new context is created automatically. It contains the items from the default context plus the newly imported items.


• If a context is specified when importing new items, the context of the corresponding root scale has to be changed (in the CAT Manager dashboard, Scales tab) so that these items are used.


• For items to be updated via importer, the context id should be defined to enable matching with existing items.

Shortcodes

• To use the feedback and statistics functionality seamingly in your courses or anywhere you want to show them, use plugin filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

Additionally, the following parameter can be added, like e.g. [catquizfeedback numberofattempts=3]

* numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

Also, the following parameters can be defined, like e.g. [catquizfeedback testid=73 starttime=1723569996]:

* globalscale // Display only attempts for this scale.

* testid      // Display only attempts of the given test.

* courseid    // Display only attempts of tests in the given course.

* starttime   // Display only attempts that were started after this timestamp. Should be a unix timestamp.

* endtime     // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz: Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. It enhances and compliments the moodle activity adaptive quiz in terms of providing an elaborate CAT item pool, a complete CAT engine and advanced CAT test deployments. In CAT testing sessions, test takers are presented only with questions that fall within their identified ability range, based on the answers they give. This is achieved by using common statistical models Item Response Theory (IRT) and allow for significant short testing times and more accurate results.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin supports the following common Item Response Theory (IRT) models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin further enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Finally, the plugin allows to pursuit different test strategies:

• running a "standard" CAT test


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• semi-classical diagnose for all given (sub-)scales


• classical testing (ask all questions), but evaluation with IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the the wunderbyte fork until our changes are integrated into the upstream plugin (in progress). This branch already includes the subplugin adaptivequizcatmodel_catquiz, which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table) - database and tables handling

It is also recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• CSV Importer: imports items, params and scales from a csv file.

CSV Importer

• The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, and no context is defined, a new context is created automatically. It contains the items from the default context plus the newly imported items.


• If a context is specified when importing new items, the context of the corresponding root scale has to be changed (in the CAT Manager dashboard, Scales tab) so that these items are used.


• For items to be updated via importer, the context id should be defined to enable matching with existing items.

Shortcodes

• To use the feedback and statistics functionality seamingly in your courses or anywhere you want to show them, use plugin filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

Additionally, the following parameter can be added, like e.g. [catquizfeedback numberofattempts=3]

* numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

Also, the following parameters can be defined, like e.g. [catquizfeedback testid=73 starttime=1723569996]:

* globalscale // Display only attempts for this scale.

* testid      // Display only attempts of the given test.

* courseid    // Display only attempts of tests in the given course.

* starttime   // Display only attempts that were started after this timestamp. Should be a unix timestamp.

* endtime     // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz - Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. Using common one-dimensional Item Response Theory (IRT) models, test takers are presented only with questions that fall within their identified ability range, based on the answers they give.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin provides different IRT models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Furthermore, the plugin allows to pursuit different test strategies:

• running a normal CAT


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• run a classical test (ask all questions), but evaluate by using IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the wb-0.9.0-rc2 release in the wunderbyte fork until our changes are integrated into the upstream plugin (in progress).


• adaptivequizcatmodel_catquiz - which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table - database and tables handling

It is recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• Importer: imports items, params and scales from a csv file.

CSV Importer

The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, and no context is defined, a new context is created automatically. It contains the items from the default context plus the newly imported items.
  If a context is specified when importing new items, the context of the corresponding root scale has to be changed (in the CAT Manager dashboard, Scales tab) so that these items are used.
  For items to be updated via importer, the context id should be defined to enable matching with existing items.

Shortcodes

To use the shortcode functionality, use plugin filter_shortcodes: https://moodle.org/plugins/filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

The following parameters can be defined:

• numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

The following parameters can be defined:

• globalscale // Display only attempts for this scale.


• testid // Display only attempts of the given test.


• courseid // Display only attempts of tests in the given course.


• starttime // Display only attempts that were started after this timestamp. Should be a unix timestamp.


• endtime // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz - Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. Using common one-dimensional Item Response Theory (IRT) models, test takers are presented only with questions that fall within their identified ability range, based on the answers they give.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin provides different IRT models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • Graded Response Model and Generalized Graded Response Model
  
  
  • further models will be realized in upcoming versions
  
  
  
  

The plugin enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Furthermore, the plugin allows to pursuit different test strategies:

• running a normal CAT


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• run a classical test (ask all questions), but evaluate by using IRT

Dependencies

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the wb-0.9.0-rc2 release in the wunderbyte fork until our changes are integrated into the upstream plugin (in progress).


• adaptivequizcatmodel_catquiz - which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table - database and tables handling

It is recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• Importer: imports items, params and scales from a csv file.

CSV Importer

The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, a new context is created automatically. With respect to the new context, new items from the import csv file are added to the corresponding scales whereas existing items are updated with data from the import file.

Shortcodes

To use the shortcode functionality, use plugin filter_shortcodes: https://moodle.org/plugins/filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

The following parameters can be defined:

• numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.

2. 
   

   To display an overview table of all scales use [catscalesoverview].

   
   


3. 
   

   To display statistics for a group of attempts, use [catquizstatistics]

   
   

The following parameters can be defined:

• globalscale // Display only attempts for this scale.


• testid // Display only attempts of the given test.


• courseid // Display only attempts of tests in the given course.


• starttime // Display only attempts that were started after this timestamp. Should be a unix timestamp.


• endtime // Display only attempts that were started before this timestamp. Should be a unix timestamp.

Installing via uploaded ZIP file

1. Make sure to install the dependencies as described in dependencies


2. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


3. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


4. Check the plugin validation report and finish the installation.

Installing manually

Make sure to install the dependencies as described in the dependencies.

The plugin can then be installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

Setup with sample data

Import sample data

You can follow these steps to setup a quiz with sample data. This assumes that you've already installed the required plugins and created a course.

1. Import questions to the course. You can use the simulation.xml file from the tests/fixtures directory.


2. Import item parameters and create CAT scales: Click on the "Catquiz" link in the main menu and select the "Import" tab. You can use the simulation.csv file from the tests/fixtures directory. Select ; as CSV separator. When you press import, this will automatically create new CAT scales. There will be warnings about missing labels for pilot questions, but you can ignore these.


3. If you navigate to the CAT manager via the "Catquiz" link in the main menu, you can check the different tabs and see that items were imported.

Setup a quiz

1. Navigate to your course, activate the edit mode, and add a new activity "Adaptive Quiz".


2. After entering a name, in the "CAT model" section select Catquiz CAT model.


3. Under "Purpose of test" you can select a teststrategy. Here we will use "CAT".


4. You can check "Active pilot mode" to include questions without item parameters in the quiz. When value of 25 is used, on average 25% of the displayed questions will be pilot questions.


5. Additionally, you can choose what question the attempt should be started with, set a minimum and maximum number of questions per attempt (maybe for testing set the maximum to a low value like e.g. 8) and choose at which standard error the test should abort.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.

Adaptive Quiz - Advanced CAT Module

Short description

The plugin local_catquiz implements full Computer Adaptive Testing (CAT) capabilities in Moodle. Using common one-dimensional Item Response Theory (IRT) models, test takers are presented only with questions that fall within their identified ability range, based on the answers they give.

Detailed description

The plugin can be used with all types of questions in Moodle that allow for automatic scoring (e.g. multiple choice or cloze text). The plugin provides different IRT models:

• dichotomous questions (only account for right or wrong answers)
  
  
  
  • Rasch-Model (1 parametric logistic model)
  
  
  • 2PL-Rasch-Birnbaum
  
  
  • 3PL-Mixed-Rasch-Birnbaum
  
  
  
  


• polytomous questions (account for right, wrong and partially correct answers)
  
  
  
  • models will be realized in upcoming versions
  
  
  
  

The plugin enables the creation, administration and modification of different scales on which measurements are taken. For this purpose, the plug-in creates a new role "CAT Manager", which is authorized to perform these administrative tasks.

Furthermore, the plugin allows to pursuit different test strategies:

• running a normal CAT


• adaptive diagnose for weakest/strongest ability in selected (sub-)scales


• adaptive diagnose for all given (sub-)scales


• run a classical test (ask all questions), but evaluate by using IRT

For using this plugin, you are required to install the following plugins:

• mod_adaptivequiz - the activity from which a CAT test can be started (vers 3.1 onwards). Please use the wb-0.9.0-rc2 release in the wunderbyte fork until our changes are integrated into the upstream plugin (in progress).


• adaptivequizcatmodel_catquiz - which serves as a bridge between mod_adaptivequiz and local_adaptivequiz


• local_wunderbyte_table - database and tables handling

It is recommended to install the following plugins as well:

• local_shortcodes - helps to render results at any point in your courses


• local_adaptivelearningpaths - adds the possibility to define learning paths based on quiz and adaptive quiz results (to be released soon)

Core concepts & Terminology

The plugin tries to present questions matching the ability of the student. To assign parameters like difficulty to each question, questions and params are grouped as items.

• Items: question with parameters


• Parameters: characteristics of a question (e.g. difficulty, discrimination, guessing probability).


• Models: model the charcteristics of an item by a specified set of parameters.


• Scales: items are grouped in scales (and subscales) according to the construct they are measuring. For example you may have a parentscale "mathematics" that measures a general construct "mathematical abilities" with subscales "algebra" and "geometry" that contain items of the field of algebra or geometry each.


• Contexts: allow you to reuse the same question within different time periods or usage frames without loosing or confusing its parameters and attempt data. This could be useful if e.g. the question is part of different quizzes or for managing data of different years.


• Importer: imports items, params and scales from a csv file.

CSV Importer

The csv importer accepts different formats of separators and encodings. Some columns are mandatory whereas others are optional. Find detailed descriptions of all columns on the same page, also the demo csv file can be found in: local/catquiz/classes/importer/demo.csv

Contexts

• When importing with the csv importer, a new context is created automatically. With respect to the new context, new items from the import csv file are added to the corresponding scales whereas existing items are updated with data from the import file.

Shortcodes

To use the shortcode functionality, use plugin filter_shortcodes: https://moodle.org/plugins/filter_shortcodes

Shortcodes can be added in any text area and label via editor, e.g. in the course.

1. To display feedbacks of the past quiz attempts use [catquizfeedback].

The following parameters can be defined:

• numberofattempts=3 // Defined the number of feedbacks displayed in collapsables. Starting with the newest.


• primaryscale=parent // Each strategy defines a scale that is be primary for the feedback. It is used as comparison to averagevalues and values from other scales. If you display a feedback via shortcode, you can change this primaryscale. You can either choose a specific scale via ID or name, or choose "parent", "lowest", "strongest", "highest" (the second two pointing to the same scale).


• show=questionssummary // Parts of the feedback that are hidden by default can be displayed with the show attribute.


• hide=comparetotestaverage,chart,pilotquestions // Parts of the feedbacks can be hidden. Either the enitre feedback of a section or keys for certain parts. Generators and subkeys are:

'personabilities' => [
'feedback_personabilities',
'personabilitychart',
'progressindividual',
'progresscomparison',
'abilityprofile',
];
'comparetotestaverage' => [
'comparisontext', // You performed better than ...
'colorbar',
'colorbarlegend', // Legend of the colorbar.
];
'customscalefeedback' => [];
'debuginfo' => [];
'graphicalsummary' => [
'teststrategyname',
'testprogresschart',
'testresultstable',
];
'pilotquestions' => [];
'questionssummary' => []; // This part is hidden by default.

2. To display an overview table of all scales use [catscalesoverview].

Installing via uploaded ZIP file

1. Log in to your Moodle site as an admin and go to Site administration >
   Plugins > Install plugins.


2. Upload the ZIP file with the plugin code. You should only be prompted to add
   extra details if your plugin type is not automatically detected.


3. Check the plugin validation report and finish the installation.

Installing manually

The plugin can be also installed by putting the contents of this directory to

{your/moodle/dirroot}/local/catquiz

Afterwards, log in to your Moodle site as an admin and go to Site administration >
Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

License

2024 Wunderbyte GmbH info@wunderbyte.at

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see https://www.gnu.org/licenses/.