https://docs.moodle.org/31/en/api.php?action=feedcontributions&user=Uqat-hb&feedformat=atomMoodleDocs - User contributions [en]2024-03-29T09:56:49ZUser contributionsMediaWiki 1.39.6https://docs.moodle.org/31/en/index.php?title=Grouping_users&diff=101585Grouping users2012-10-29T17:29:49Z<p>Uqat-hb: add fr</p>
<hr />
<div>{{Managing a Moodle course}}<br />
*[[Groups]]: On the course level can you assign a user to one (or more) groups. In a course you can assign a context(activity) to a group. When members of the group leave the course, they lose their identity with the group.<br />
*[[Import groups]]<br />
*[[ Groupings]] are a collection of groups. If you had 10 groups, you could combine or mix and match the smaller groups into 2 or more groupings. You can assign a grouping to a context like an assignment. <br />
*[[Cohorts]]:On the site or category level you assign a user to a cohort. Cohorts are used to bulk enrol users into one or more courses. If you wish the cohort to be members of a group within the course you will then have to add them to a group in a further step.<br />
<br />
==See also==<br />
<br />
*[[Groups FAQ]]<br />
*[[Groupings FAQ]]<br />
<br />
[[Category:Groups]]<br />
<br />
[[de:Nutzer/innen gruppieren]]<br />
[[fr:Groupes d'utilisateurs]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_categories&diff=101468Grade categories2012-10-22T15:35:58Z<p>Uqat-hb: /* See also */ link to french version - correct</p>
<hr />
<div>{{Managing grades}}<br />
{{Improve}}<br />
Grades can be organised into grade categories. <br />
A grade category has its own aggregated grade which is calculated from its grade items. There is no limit to the level of nesting of categories (a category may belong to another category). However, each grade item may belong to only one category. Also, all grade items and categories belong to at least one, permanent category: [[Edit_categories_and_items#Top_category|the course category]].<br />
<br />
==Adding a grade category==<br />
To add a grade category:<br />
# Select "Categories and items" from the gradebook dropdown menu.<br />
# Click the "Add category" button near the bottom of the page.<br />
# Give the grade category a meaningful name.<br />
# Select grade category settings as appropriate. Advanced settings may be made available by clicking the "Show advanced" button.<br />
# Click the "Save changes" button.<br />
<br />
==Editing a grade category==<br />
To edit a grade category:<br />
# Select "Categories and items" from the gradebook dropdown menu.<br />
# Click the edit icon opposite the grade category you wish to edit.<br />
# After editing the grade category, click the "Save changes" button.<br />
[[Image:Edit grade category.png|thumb|center|Editing a grade category]]<br />
<br />
==Settings==<br />
If any of the following do not appear in your page, it may mean that they are set globally in your site. See [[Grade_category_settings#Forcing_settings|Forcing settings]] for more information.<br />
<br />
=== Aggregation ===<br />
See [[Category aggregation]] for a detailed explanation.<br />
<br />
=== Aggregate only non-empty grades ===<br />
Non-existent grades are either treated as minimal grades or not included in the aggregation. For example, an assignment graded between 0 and 100 for which only half the students have been graded will either count the non-graded submissions as 0 (option switched off) or will ignore them (option switched on).<br />
<br />
Important: An empty grade is simply a missing gradebook entry, and could mean different things. For example, it could be a participant who hasn't yet submitted an assignment, an assignment submission not yet graded by the teacher, or a grade that has been manually deleted by the gradebook administrator. Caution in interpreting these "empty grades" is thus advised.<br />
<br />
=== Aggregate including sub-categories ===<br />
The aggregation is usually done only with immediate children, it is also possible to aggregate grades in all subcategories excluding other aggregated grades.<br />
<br />
=== Include outcomes in aggregation ===<br />
Including outcomes in aggregation may not lead to the desired overall grade, so you have the option to include or leave them out.<br />
<br />
=== Drop the lowest ===<br />
If set, this option will drop the X lowest grades, X being the selected value for this option.<br />
<br />
Note: You can only make use of either this option or the option below `Keep Highest`. If you have both set then only `Drop the lowest` will be usable under course categories<br />
<br />
=== Keep the highest ===<br />
If set, this option will only retain the X highest grades, X being the selected value for this option.<br />
<br />
Note: If you have `Drop the lowest` set to anything other than null then this option will have no effect<br />
<br />
=== Parent Category - Item Weight ===<br />
<br />
If your course is set to use weighted mean of grades, you can assign a weight that the grade for this category will have inside the parent category. Within all of the subcategories of the parent category, the weight values do not need to add up to 100.<br />
<br />
=== Aggregation view ===<br />
Each category can be displayed in three ways: Full mode (aggregated column and grade item columns), the aggregated column only, or the grade items alone.<br />
<br />
==See also==<br />
<br />
*[[Grade items]]<br />
*[[Edit categories and items]]<br />
*[[Grade category settings]] - for administrators<br />
*[http://www.youtube.com/watch?v=sUslTuZPu6A Video showing the effects of the grade category settings]<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=91632 Grade categories and weights 1.8 to 1.9?] forum discussion<br />
<br />
[[fr:Catégories de note]]<br />
[[ja:評定カテゴリ]]<br />
[[de:Bewertungskategorien]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_categories&diff=101467Grade categories2012-10-22T15:35:01Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Managing grades}}<br />
{{Improve}}<br />
Grades can be organised into grade categories. <br />
A grade category has its own aggregated grade which is calculated from its grade items. There is no limit to the level of nesting of categories (a category may belong to another category). However, each grade item may belong to only one category. Also, all grade items and categories belong to at least one, permanent category: [[Edit_categories_and_items#Top_category|the course category]].<br />
<br />
==Adding a grade category==<br />
To add a grade category:<br />
# Select "Categories and items" from the gradebook dropdown menu.<br />
# Click the "Add category" button near the bottom of the page.<br />
# Give the grade category a meaningful name.<br />
# Select grade category settings as appropriate. Advanced settings may be made available by clicking the "Show advanced" button.<br />
# Click the "Save changes" button.<br />
<br />
==Editing a grade category==<br />
To edit a grade category:<br />
# Select "Categories and items" from the gradebook dropdown menu.<br />
# Click the edit icon opposite the grade category you wish to edit.<br />
# After editing the grade category, click the "Save changes" button.<br />
[[Image:Edit grade category.png|thumb|center|Editing a grade category]]<br />
<br />
==Settings==<br />
If any of the following do not appear in your page, it may mean that they are set globally in your site. See [[Grade_category_settings#Forcing_settings|Forcing settings]] for more information.<br />
<br />
=== Aggregation ===<br />
See [[Category aggregation]] for a detailed explanation.<br />
<br />
=== Aggregate only non-empty grades ===<br />
Non-existent grades are either treated as minimal grades or not included in the aggregation. For example, an assignment graded between 0 and 100 for which only half the students have been graded will either count the non-graded submissions as 0 (option switched off) or will ignore them (option switched on).<br />
<br />
Important: An empty grade is simply a missing gradebook entry, and could mean different things. For example, it could be a participant who hasn't yet submitted an assignment, an assignment submission not yet graded by the teacher, or a grade that has been manually deleted by the gradebook administrator. Caution in interpreting these "empty grades" is thus advised.<br />
<br />
=== Aggregate including sub-categories ===<br />
The aggregation is usually done only with immediate children, it is also possible to aggregate grades in all subcategories excluding other aggregated grades.<br />
<br />
=== Include outcomes in aggregation ===<br />
Including outcomes in aggregation may not lead to the desired overall grade, so you have the option to include or leave them out.<br />
<br />
=== Drop the lowest ===<br />
If set, this option will drop the X lowest grades, X being the selected value for this option.<br />
<br />
Note: You can only make use of either this option or the option below `Keep Highest`. If you have both set then only `Drop the lowest` will be usable under course categories<br />
<br />
=== Keep the highest ===<br />
If set, this option will only retain the X highest grades, X being the selected value for this option.<br />
<br />
Note: If you have `Drop the lowest` set to anything other than null then this option will have no effect<br />
<br />
=== Parent Category - Item Weight ===<br />
<br />
If your course is set to use weighted mean of grades, you can assign a weight that the grade for this category will have inside the parent category. Within all of the subcategories of the parent category, the weight values do not need to add up to 100.<br />
<br />
=== Aggregation view ===<br />
Each category can be displayed in three ways: Full mode (aggregated column and grade item columns), the aggregated column only, or the grade items alone.<br />
<br />
==See also==<br />
<br />
*[[Grade items]]<br />
*[[Edit categories and items]]<br />
*[[Grade category settings]] - for administrators<br />
*[http://www.youtube.com/watch?v=sUslTuZPu6A Video showing the effects of the grade category settings]<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=91632 Grade categories and weights 1.8 to 1.9?] forum discussion<br />
<br />
[[fr:Catégories de notes]]<br />
[[ja:評定カテゴリ]]<br />
[[de:Bewertungskategorien]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_settings&diff=101466Grade settings2012-10-22T15:28:30Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Grades}}<br />
==Course grade settings==<br />
<br />
[[File:Course grade settings.png|thumb|Course grade settings]]Course grade settings determine how the gradebook appears for all participants in the course.<br />
<br />
Course grade settings are found in ''Settings > Grade administration > Course grade settings'' or via the gradebook Settings tab.<br />
<br />
The default course grade settings are set by an administrator in ''Settings > Site administration > Grades''.<br />
<br />
==Grader report preferences==<br />
<br />
[[File:Grader report preferences.png|thumb|Grader report preferences]]Teachers can set their preferences for the grader report via the gradebook 'My preferences' tab. These settings will apply to all courses for that teacher. The teacher may change them at any time. <br />
<br />
The default grader report preferences are set by an administrator in ''Settings > Site administration > Grades > Report settings > Grader report''.<br />
<br />
==Site administration settings==<br />
<br />
Default values for all grade settings can be set by an administrator. The easiest way to do so is to log in as admin then browse a course gradebook and follow the 'Change defaults' links.<br />
<br />
The following additional grade settings can be found in ''Settings > Site administration > Grades > General settings''. The settings will affect all gradebooks used by all teachers. <br />
<br />
===Graded Roles===<br />
<br />
Graded roles are the type of user that will appear in the gradebook. Most of the time "student" is the only one needed.<br />
<br />
===User profile report===<br />
<br />
The default user profile report setting has just one option, 'User report', unless a custom user report has been added to the site.<br />
<br />
Teachers can view the user reports for all or selected students in the course in ''Settings > Grades administration > User report''.<br />
<br />
===Include scales in aggregation===<br />
Scales can be included as numbers in all aggregated grades across all gradebooks in all courses. Changing this setting will force all aggregated grades to be recalculated.<br />
<br />
If this is checked (and it is by default) then all custom scales will have a corresponding value that is assigned based on the number of options in the scale (ie. three values will have values of 1,2,3) and this will be included in the grade aggregation.<br />
<br />
===Enable publishing===<br />
[[Image:Grade publishing settings.png|thumb|Grade publishing settings]]<br />
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only. Security implications should be thoroughly considered before allowing non-admin users to publish grades.<br />
<br />
Grade publishing may be enabled by checking the gradepublishing box. If enabled, administrators are provided with [[Grade export|grade export]] publishing settings in each course gradebook.<br />
<br />
===Recover grades default===<br />
<br />
{{New features}}When [[Enrolled users|manually enrolling]] a student in a course, there is an option 'Recover user's old grades if possible', however this checkbox is easy to miss. Enabling 'Recover grades default' results in 'Recover user's old grades if possible' being ticked for every course.<br />
<br />
[[File:enrol users enrolment options.png]]<br />
<br />
===Unlimited grades===<br />
Teachers can enter grades over 100% directly in the gradebook if the ''unlimitedgrades'' setting is enabled.<br />
<br />
==Grade capabilities==<br />
<br />
*[[Capabilities/moodle/grade:edit|Edit grades]]<br />
*[[Capabilities/moodle/grade:export|Export grades]]<br />
*[[Capabilities/moodle/grade:hide|Hide/unhide grades or items]]<br />
*[[Capabilities/moodle/grade:import|Import grades]]<br />
*[[Capabilities/moodle/grade:lock|Lock grades or items]]<br />
*[[Capabilities/moodle/grade:manage|Manage grade items]]<br />
*[[Capabilities/moodle/grade:managegradingforms|Manage advanced grading methods]]<br />
*[[Capabilities/moodle/grade:manageletters|Manage grade letters]]<br />
*[[Capabilities/moodle/grade:manageoutcomes|Manage grade outcomes]]<br />
*[[Capabilities/moodle/grade:unlock|Unlock grades or items]]<br />
*[[Capabilities/moodle/grade:view|View own grades]]<br />
*[[Capabilities/moodle/grade:viewall|View grades of other users]]<br />
*[[Capabilities/moodle/grade:viewhidden|View hidden grades for owner]]<br />
<br />
[[de:Bewertungseinstellungen]]<br />
[[fr:Paramètres de notes]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Gradebook&diff=101465Gradebook2012-10-22T15:25:35Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Grades}}<br />
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Settings > Course administration > Grades''.<br />
<br />
The grader report collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.<br />
<br />
The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).<br />
<br />
Note that various default options for the gradebook are set at system level by the administrator and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.<br />
<br />
==Display==<br />
<br />
Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).<br />
<br />
You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.<br />
<br />
There are three ways that the categories can be displayed:<br />
<br />
* Grades only - without the category totals column<br />
* Collapsed - Category total column only<br />
* Full view - grades and the aggregates (the totals column for the category) <br />
<br />
Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category. + goes to grades only view, o goes to full view and - goes to collapsed view.<br />
<br />
[[Image:Grades grader report with categories 1.png]]<br />
<br />
===Highlighting rows and columns===<br />
<br />
When your gradebook starts to grow, it can be hard to keep track of which student and which assignment a cell refers to. Highlighting solves that.<br />
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row<br />
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column<br />
(Note: this requires Javascript to be enabled in your browser.)<br />
<br />
===Sorting by columns===<br />
<br />
You can sort by any column. Click the [[Image:Move.gif]] symbol near the top of a column to sort by that column. This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.<br />
<br />
The student name columns do not have the [[Image:Move.gif]] symbol. Clicking on either the first or last name will cause the report to sort.<br />
<br />
{| style="width:75%; border="0"<br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
===Highlighting scores that are either adequate or unacceptable in red and green===<br />
<br />
Turn editing on and click on the edit icon in the controls cell at the top of the column. You can then (maybe need to click 'show advanced') see the option to enter a 'grade to pass'. Once set, any grades falling above this will be highlighted in green and any below will be highlighted in red.<br />
<br />
Note that the highlighting will not show if the Grader report is viewed in the editing mode.<br />
<br />
===Horizontal scrollbar===<br />
<br />
A horizontal scrollbar enables teachers to scroll grades in the grader report. (Note that this feature is not available for IE6 users or for users who have have the screenreader setting in their profile set to Yes.)<br />
<br />
[[Image:Gradebook horizontal scrollbar.png|thumb|Horizontal scrollbar]]<br />
<br />
===Mouse-over tooltips===<br />
<br />
Each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.<br />
<br />
===Filtering the gradebook by groups===<br />
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.<br />
<br />
==Editing==<br />
<br />
Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities. Roles such as 'non-editing teacher' may only have one or the other.<br />
<br />
===Altering the grades===<br />
You can click "Turn editing on" at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.<br />
<br />
Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.<br />
<br />
Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.<br />
<br />
===Hiding columns or individual grades===<br />
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].<br />
<br />
===Recalculating===<br />
If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click '''Turn editing on''' twice to force the gradebook to re-check.<br />
<br />
==Gradebook capabilities==<br />
<br />
There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.<br />
<br />
==See also==<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
[[de:Bewertungen]]<br />
[[fr:Carnet de notes]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_items&diff=101464Grade items2012-10-22T15:24:13Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Managing grades}}<br />
{{Improve}}<br />
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.<br />
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].<br />
<br />
Grade items may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or manual grades. <br />
<br />
== Grade items and gradebook ==<br />
The three building blocks of the Gradebook are:<br />
<br />
#The grade item<br />
#The [[Grade_categories|grade category]]<br />
#The [[Grades|grade]]<br />
<br />
<br />
Grade items are represented by columns in the [[Grader_report | grader report]].<br />
<br />
Within a category, a [[Grades|grade]] summary is also a grade item itself. Summary grade items for a category can show up in reports, and can be used in the calculation of the grade for the parent category.<br />
<br />
== Activity-based grade items ==<br />
[[Image:Edit grade item.png|right|thumb|Editing a grade item]]<br />
Modules that include a form of grading use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|Gradebook API]] to generate a matching grade item, and to communicate their grades to the gradebook. The generated grade item can later be edited from within the gradebook interface (Course -> Grades -> Edit Categories and items -> Edit (hand icon) grade item), as seen in the screenshot to the right, but several of its settings will be 'frozen', only changeable from the activity module's interface. These are listed and explained below in the manual grade items section.<br />
<br />
Here is a list of the settings that can be edited for an activity-based grade item:<br />
<br />
*'''Item info''': General information about the grade item. Optional.<br />
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. It doesn't work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.<br />
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]<br />
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places. <br />
*'''Multiplicator''': Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100. <br />
*'''Offset''': Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)<br />
*'''Hidden''': Whether this grade item should be hidden from students.<br />
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)<br />
*'''Locked''': Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.<br />
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.<br />
<br />
== Grade outcome items ==<br />
[[Image:grade_outcome_item.png|right|thumb|Editing a grade outcome item]]<br />
These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.<br />
<br />
Grade outcome items can optionally be linked with an activity module. This is done automatically when a grade outcome item is generated by the creation of an activity module in which outcomes were selected. In this scenario, a grade category is also created and named after the activity module, and the grade item and grade outcome items are created as children of that category.<br />
<br />
The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:<br />
<br />
*'''Outcome''': The course outcome represented by this item<br />
*'''Linked activity''': The optional activity module to which this item will be linked<br />
<br />
== Manual grade items ==<br />
[[Image:manual_item.png|right|thumb|Editing a manual grade item]]<br />
These grade items are created manually through the "Edit Categories and Items" page. The "Add grade item" button is clicked, and the form appears. Several options are available here which are normally automatically filled out by the activity module creating an activity-based grade item:<br />
<br />
*'''Item name''': The display name of your grade item<br />
*'''ID Number''': An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.<br />
*'''Grade type''': The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text). <br />
*'''Scale''': Which scale to use for grading: available only when the Scale grade type is selected. <br />
*'''Maximum grade''': The maximum grade that can be given (for scales: the number of items in the scale - 1)<br />
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)<br />
<br />
Conversely, two of the settings found in the form for activity-based grade items are absent from this form:<br />
*Multiplicator<br />
*Offset<br />
<br />
==See also==<br />
*[[Grade item settings]] - for administrators<br />
<br />
[[ca:grade/edit/tree/item]]<br />
[[cs:Položky hodnocení]]<br />
[[de:Bewertungsaspekte]]<br />
[[fr:Éléments de note]]<br />
[[ja:評定項目]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_items&diff=101463Grade items2012-10-22T15:23:49Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Managing grades}}<br />
{{Improve}}<br />
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.<br />
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].<br />
<br />
Grade items may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or manual grades. <br />
<br />
== Grade items and gradebook ==<br />
The three building blocks of the Gradebook are:<br />
<br />
#The grade item<br />
#The [[Grade_categories|grade category]]<br />
#The [[Grades|grade]]<br />
<br />
<br />
Grade items are represented by columns in the [[Grader_report | grader report]].<br />
<br />
Within a category, a [[Grades|grade]] summary is also a grade item itself. Summary grade items for a category can show up in reports, and can be used in the calculation of the grade for the parent category.<br />
<br />
== Activity-based grade items ==<br />
[[Image:Edit grade item.png|right|thumb|Editing a grade item]]<br />
Modules that include a form of grading use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|Gradebook API]] to generate a matching grade item, and to communicate their grades to the gradebook. The generated grade item can later be edited from within the gradebook interface (Course -> Grades -> Edit Categories and items -> Edit (hand icon) grade item), as seen in the screenshot to the right, but several of its settings will be 'frozen', only changeable from the activity module's interface. These are listed and explained below in the manual grade items section.<br />
<br />
Here is a list of the settings that can be edited for an activity-based grade item:<br />
<br />
*'''Item info''': General information about the grade item. Optional.<br />
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. It doesn't work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.<br />
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]<br />
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places. <br />
*'''Multiplicator''': Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100. <br />
*'''Offset''': Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)<br />
*'''Hidden''': Whether this grade item should be hidden from students.<br />
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)<br />
*'''Locked''': Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.<br />
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.<br />
<br />
== Grade outcome items ==<br />
[[Image:grade_outcome_item.png|right|thumb|Editing a grade outcome item]]<br />
These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.<br />
<br />
Grade outcome items can optionally be linked with an activity module. This is done automatically when a grade outcome item is generated by the creation of an activity module in which outcomes were selected. In this scenario, a grade category is also created and named after the activity module, and the grade item and grade outcome items are created as children of that category.<br />
<br />
The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:<br />
<br />
*'''Outcome''': The course outcome represented by this item<br />
*'''Linked activity''': The optional activity module to which this item will be linked<br />
<br />
== Manual grade items ==<br />
[[Image:manual_item.png|right|thumb|Editing a manual grade item]]<br />
These grade items are created manually through the "Edit Categories and Items" page. The "Add grade item" button is clicked, and the form appears. Several options are available here which are normally automatically filled out by the activity module creating an activity-based grade item:<br />
<br />
*'''Item name''': The display name of your grade item<br />
*'''ID Number''': An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.<br />
*'''Grade type''': The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text). <br />
*'''Scale''': Which scale to use for grading: available only when the Scale grade type is selected. <br />
*'''Maximum grade''': The maximum grade that can be given (for scales: the number of items in the scale - 1)<br />
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)<br />
<br />
Conversely, two of the settings found in the form for activity-based grade items are absent from this form:<br />
*Multiplicator<br />
*Offset<br />
<br />
==See also==<br />
*[[Grade item settings]] - for administrators<br />
<br />
[[ca:grade/edit/tree/item]]<br />
[[cs:Položky hodnocení]]<br />
[[de:Bewertungsaspekte]]<br />
[[fr:Eléments de note]]<br />
[[ja:評定項目]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_letters&diff=101462Grade letters2012-10-22T15:16:14Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Grades}}<br />
[[Image:Grade letters.png|thumb|Default grade letters]]Grade letters, also called letter grades, are symbols used to represent a range of grades. For example "A" could be used to represent grades of 80% and above, "B" to represent grades between 70 and 80%, "C" to represent grades between 50 and 70%, and so on. Alternatively, you could have "Pass" for grades above 50% and "Fail" for grades below 50%.<br />
<br />
==Displaying letter grades==<br />
To change particular [[Grade items|grade items]], category and course summaries (called aggregations) in the [[Grader report|grader report]] and [[User report|user reports]] to display letter grades:<br />
<br />
# Follow the grades link in the course administration block.<br />
# Select "Categories and items" from the gradebook dropdown menu.<br />
# Click the edit icon for Category total or Course total.<br />
# From the Grade display type menu, select letter.<br />
# Click the "Save changes" button at the bottom of the page.<br />
<br />
Repeat this for any other totals that you want displayed as letters.<br />
<br />
Alternatively, to display ALL grades as letter grades:<br />
<br />
# Follow the grades link in the course administration block.<br />
# Select "Course settings" from the gradebook dropdown menu.<br />
# From the Grade display type menu, select letter.<br />
# Click the "Save changes" button.<br />
<br />
==Editing course-level grade letters==<br />
<br />
[[Image:Editing grade letters.png|thumb|Editing grade letters]]<br />
Grade letters are set initially at site level. To use different grade letters in a particular course:<br />
<br />
# Follow the grades link in the course administration block.<br />
# Select Letters from the from the gradebook dropdown menu.<br />
# Click the edit tab in the middle of the page.<br />
# Check the override site defaults box.<br />
# Change grade letters and/or boundaries as required. (You may wish to use words, for example Below Pass, Pass, Merit, Distinction, rather than letters.)<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
[[Image:Pass fail grade letters.png|thumb|Pass/fail grade letters]]<br />
<br />
==Setting grade letter site-level defaults==<br />
<br />
To set grade letter site defaults:<br />
# Login as an administrator.<br />
# Access ''Site administration > Grades > Letters''.<br />
# Change grade letters and/or boundaries as required.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
==Forcing grade letter site-level defaults==<br />
<br />
To force grade letter site-level defaults in all courses i.e. remove the ability for teachers to override site defaults and edit grade letters in their courses:<br />
# Login as an administrator.<br />
# Access ''Administration > Users > Permissions > Define roles''<br />
# Edit the role of teacher and change the capability [[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]] from Allow to Not set.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
==Accuracy of grade calculations==<br />
<br />
Grade calculations are made with an accuracy of 5 decimal places and grade letters assigned accordingly. The overall decimal points setting (in the system [[Grade item settings|grade item settings]] and for individual [[Grade items|grade items]]) is for display purposes only and is not used when assigning grade letters. <br />
<br />
==See also==<br />
*[http://www.youtube.com/watch?v=p6zWwJGb9TA Video demonstrating how to use gradebook site settings and defaults]<br />
*[http://www.moodletutorials.org/Moodle-Tutorial-on-Grade-Item-Settings-and-Grade-Letters.html Tutorial on Grade Item Setting and Grade Letters]<br />
<br />
[[ca:grade/edit/letter/index]]<br />
[[es:Calificaciones con Letras]]<br />
[[eu:Kalifikazio-letrak]]<br />
[[fr:Lettres]]<br />
[[ja:評定文字]]<br />
[[de:Notenstufen]]</div>Uqat-hbhttps://docs.moodle.org/31/en/index.php?title=Grade_calculations&diff=101117Grade calculations2012-10-05T18:33:17Z<p>Uqat-hb: /* See also */ link to french version</p>
<hr />
<div>{{Managing grades}}<br />
A grade calculation is a formula used to determine grades, based (optionally) on other grade items. Note that this is not the same as [[Calculated_question_type|Calculated question types]].<br />
<br />
Calculations for the gradebook follow the pattern of formulas/functions in popular spreadsheet programs. They start with an equal (=) sign, and use common mathematical operators and functions to produce a single numerical output. This output is then used as the computed value for the grade item you are editing.<br />
<br />
==Setting a grade calculation==<br />
[[Image:Calc_icon.JPG|thumb|Calculator symbol]]<br />
[[Image:Final_calc.JPG|thumb|Example calculation]]<br />
To set a grade calculation:<br />
# Login as teacher or other user with permission to edit grades<br />
# Click on Grades in the course administration block<br />
# Click the 'Categories and items' tab (or select it from the gradebook dropdown menu)<br />
# Click the 'calculator symbol' (in the 'Actions' column) opposite the grade category you wish to set a calculation for<br />
# Start with an equal sign (=)<br />
# Choose a function; Example: =sum()<br />
# Plug in your ID numbers enclosed in double square brackets, for example <nowiki>=sum([[item1]][[item2]][[item3]])</nowiki><br />
# Separate each ID number with a comma, for example <nowiki>=sum([[item1]],[[item2]],[[item3]])</nowiki><br />
# Click the "Save Changes" button<br />
<br />
==Assigning ID numbers==<br />
<br />
You can include the values of other grade items by using their ID number as references in your formulas. The ID number is surrounded by double square brackets, for example if you have a grade item with Quiz.3 as ID number, you will refer to this item as <nowiki>[[Quiz.3]]</nowiki> in your calculation.<br />
<br />
Below the calculation field is a list of your course with its grade categories and grade items. Next to each item or category's total is displayed the ID number you can use in your calculation (already surrounded with double square brackets). However, since the ID number is optional, some items may not yet have one. These items without an ID number have instead a form field which lets you enter an ID number directly.<br />
<br />
As soon as you have assigned the ID numbers you need, you can click the "Add ID numbers" button, and the page will reload and show you the same list with the ID numbers you have just assigned.<br />
<br />
==Calculation functions==<br />
<br />
Every calculation must start with an equal sign (=). Following is a list of the functions supported by the calculation. The comma (,) character is used to separate arguments within function brackets. The comma can also be used to separate different functions. (The separator character could be a semicolon (;) in other languages, see below).<br />
<br />
* average<nowiki>([[item1]], [[item2]]...)</nowiki>: Returns the average of a sample<br />
* max<nowiki>([[item1]], [[item2]]...)</nowiki>: Returns the maximum value in a list of arguments<br />
* min<nowiki>([[item1]], [[item2]]...):</nowiki> Returns the minimum value in a list of arguments<br />
* mod(dividend, divisor): Calculates the remainder of a division<br />
* pi(): Returns the value of the number Pi<br />
* power(base, power): Raises a number to the power of another<br />
* round(number, count): Rounds a number to a predefined accuracy<br />
* sum(<nowiki>[[item1]], [[item2]]...)</nowiki>: Returns the sum of all arguments<br />
* an asterisk (*) gives the product of two items: <nowiki>[[item1]]*[[item2]]</nowiki><br />
<br />
A number of mathematical functions is also supported:<br />
<br />
* sin<br />
* sinh<br />
* arcsin<br />
* asin<br />
* arcsinh<br />
* asinh<br />
* cos<br />
* cosh<br />
* arccos<br />
* acos<br />
* arccosh<br />
* acosh<br />
* tan<br />
* tanh<br />
* arctan<br />
* atan<br />
* arctanh<br />
* atanh<br />
* sqrt<br />
* abs<br />
* ln<br />
* log<br />
* exp<br />
<br />
==Example calculations==<br />
<br />
* <nowiki>=average([[Quiz.1]], [[Quiz.4]], [[Assignment.1]])</nowiki><br />
* <nowiki>=average(max([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]), min([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]))</nowiki><br />
* Weighted grade calculations where item 1 is weighted 30%, item 2 is weighted at 60% and item 3 is weighted at 200%: <nowiki>=sum([[1]]*0.3,[[2]]*0.6,[[3]]*2)</nowiki><br />
<br />
==Calculations when user language is not English==<br />
<br />
Calculation formulas use decimal and list separators as defined in each language pack.<br />
<br />
The decimal separator (a symbol used to mark the boundary between the integral and the fractional parts of a decimal number) is a point (.) in English. In other languages it may be a comma (,).<br />
<br />
The list separator (a symbol used to separate a list of ID numbers in square brackets) is a comma (,) in English. In other languages it may be a semicolon (;).<br />
<br />
==See also==<br />
*[http://www.youtube.com/watch?v=WKUGyzAXcyA Video on how to set up calculations in the gradebook (basic)]<br />
*[http://www.youtube.com/watch?v=VBEj8mmu8lM Video on how to set up calculations in the gradebook (advanced)]<br />
<br />
[[ca:grade/edit/tree/calculation]]<br />
[[fr:Calcul de note]]<br />
[[ru:Формулы и вычисления оценок]]<br />
[[ja:評定計算]]<br />
[[de:Bewertungen berechnen]]</div>Uqat-hb