Difference between revisions of "Formulas question type"
Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Formulas question type.
(→Complete documentation) |
(→Complete documentation) |
||
Line 16: | Line 16: | ||
The following documentation is based on that of [https://code.google.com/archive/p/moodle-coordinate-question/wikis/Documentation.wiki Hon Wai Lau's original project ] (available on Google Code Archive). The content has been slightly modified and updated to match Moodle 2.0 and up. | The following documentation is based on that of [https://code.google.com/archive/p/moodle-coordinate-question/wikis/Documentation.wiki Hon Wai Lau's original project ] (available on Google Code Archive). The content has been slightly modified and updated to match Moodle 2.0 and up. | ||
− | + | CLICK ON THE HEADINGS IN THE LIST BELOW or use the [[:Category:Formulas question type | categories links]] in order to access the different pages of the documentation: | |
<div style="border:1px solid #bce8f1;border-radius:4px;padding:0px 15px 30px;"> | <div style="border:1px solid #bce8f1;border-radius:4px;padding:0px 15px 30px;"> |
Revision as of 18:30, 4 December 2017
Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.
As there is no or little difference in the Formulas question type plugin for recent versions of Moodle (2.0 and above), the documentation for the Formulas question type has been moved to one location (the present page).
The documentation below applies to all recent versions of Moodle including the current Moodle 3.4.
Contents
Complete documentation
The following documentation is based on that of Hon Wai Lau's original project (available on Google Code Archive). The content has been slightly modified and updated to match Moodle 2.0 and up.
CLICK ON THE HEADINGS IN THE LIST BELOW or use the categories links in order to access the different pages of the documentation:
Getting started
Reference
Examples
Once the Formulas question plugin is installed, several examples of the Formulas question can be found in the file called 'sample-formulas-questions.xml' located in the 'moodle/question/type/formulas/sample' folder. Use the Import questions option (Moodle XML) to put them into your Question bank and see how they work.
Features
- Random values. Each student can receive questions with unique values and wording.
- Multiple subquestions. Multiple subquestions can be made to share the same set of random variables.
- Multiple answers. Multiple answer boxes can be used for one subquestion.
- Different answer types. Both numerical answers with units and algebraic answers can be used.
- Grading criterion. In addition to simple absolute error, responses from students can be graded using any formula.
- Units. Supports units and SI unit conversions. SI units with different SI prefixes are accepted using a built-in conversion rule.
- Multiple trials. A finite or infinite number of trials can be specified for each subquestion.
The Formulas question type is for you!
The Formulas question type is a plugin for Moodle with random values and multiple answer fields. The answer fields can be placed anywhere in the question so that you can create questions involving various answer structures such as coordinate, polynomial, matrix, etc. Other features such as unit checking and multiple subquestions are also available. These functionalities can simplify the creation of questions in many fields related to mathematics, numbers and units, such as physics and engineering.
If you are dealing with problems such as those described below, then the Formulas question type is for you! Take, for example, a problem in structural engineering that may involve several parameters with a number of specific values such as:
Parameter: Possible values: Bolt diameter (mm) 16, 20, 22, 24, 27, 30, 36 Plate thickness (mm) 16, 20, 25, 35, 40, 50 Steel strength (MPa) 300, 345, 350, 380 Concrete strength (MPa) 20, 25, 30 Reinforcing bar diameter (mm) 9.5, 12.7, 15.9, 19.1, 22.2, 25.4
A question that involves the five parameters, each with their possible values, has 7 x 6 x 4 x 3 x 6 = 3024 permutations (assuming here that they are all valid), much more than the limit of 100 in the Calculated question.
Even a simple question in basic mathematics can have a large number of permutations. The following one has 5 x 5 x 8 = 200 permutations:
Find the value of x = a*(b + c) where • a is an odd number between and including 1 and 9 • b is an even number between and including 2 and 10 • c is an integer value between and including 1 to 3 or 7 to 11
This kind of question can be easily created using the Formulas question. To create the question, you would enter the sets of numbers in the Random variables field as follows:
Variables Random variables a = {1:10:2}; b = {2:11:2}; c = {1, 2, 3, 7:12};
Note that sets of numbers can be in the format {start:stop:interval}, for example {1:10:2} and {2:11:2}. (The stop value is not included in the set and the interval is set to 1 when not specified). Sets of numbers can also be in the format of a list such as {1,2,3} for the set of numbers 1, 2 and 3. They can even be in a combination of the two formats, such as {1, 2, 3, 7:12}.
When an attempt is started, a, b, and c will take a value drawn from the corresponding set at random. If you want, you can define other variables as a function of the random ones in the Global variables field. For instance, if you need the value of a + 2*b somewhere in your question (that is the main question, subquestions, hints and feedbacks), just define a new variable, say d, in the Global variables field:
Variables Global variables d = a + 2*b;
Once you have defined your variables, you can display them by putting them in curly braces, i.e. {a}, {b}, {c}, {d}, anywhere in the question.
Another advantage of the Formulas question type is that a Formulas question can have several subquestions, called parts, that can share the same variables. The Formulas question also has a complete system of units that is quite useful for physics and engineering.
The Formulas question type is very powerful and permits the making of a wide range of questions. Although mastering all its possibilities require some practice, the basics can be learned quickly.
Once you begin to master the Formulas question type, you will realize how easy it is to use, and how effective and complete it is.
Acknowledgments
The Formulas question was originally written by Hon Wai Lau in about one year during 2009 and 2010, after his Master studies in Physics at the Hong Kong University of Science and Technology. In 2012,Hon Wai Lau was invited by the Complexity Science Group, Department of Physics and Astronomy, University of Calgary, Alberta, Canada. He is currently completing his Ph.D. studies at the Institute for Quantum Science and Technology, University of Calgary.
Hon Wai Lau's Formulas question original project can be found on Google Code Archive. Note that the initial name 'Coordinate question ' was later changed to 'Formulas question'. Hon Wai Lau's original Formulas question is compatible with Moodle 1.9 and 2.0.
The Formulas question was upgraded to the new question engine, introduced in Moodle 2.1, by Jean-Michel Védrine, professor of Statistics and Computing at the Institut Universitaire de Technologie in Saint-Étienne, France. The upgraded version of the Formulas question is compatible with Moodle 2.3 and later versions, currently up to Moodle 3.3.
Maintener(s)
Jean-Michel Védrine has maintained the Formulas question type plugin until 2017. Currently, no maintener is assigned.
Installation
The Formulas question is a Moodle plugin, so you or your Administrator must install it.
Prior to installing the Formulas question though, you need to install install another plugin, that is Tim Hunt's adaptive multipart behaviour, available from GitHub or from the Moodle Plugins directory. Note that you need version 3.3 or newer of this behaviour, because the Formulas question will not work with previous versions.
You can then install the Formulas question either from the Moodle Plugins directory, from GitHub or from a zip file:
Installing from the Moodle Plugins directory
The Formulas question is available from the Moodle Plugins drectory. Install the Formulas question as any other Moodle question type plugin.
Installing from GitHub
The Formulas question is available at the author's Github repository. To install the question, type the following commands in the root of your Moodle install:
git clone git://github.com/jmvedrine/moodle-qtype_formulas.git question/type/formulas echo '/question/type/formulas/' >> .git/info/exclude
Installing from a zip file
Download the zip file from GitHub. Unzip the file in the 'question/type' folder and then rename the new folder to 'formulas'.
Moodle Tracker
Date | Author | Title and link |
---|---|---|
2010-08-27 | Hon Wai Lau | New question type: Formulas |
2015-12-17 | Tikva | Formulas question type does not support expressions calculation |
2016-06-14 | Renaat Debleu | Formulas question type does not support local number formatting |
Forum discussions
Translations available
The Formulas question plugin is available in the following langages:
- English
- French
- Spanish (Mexican)