https://docs.moodle.org/23/en/api.php?action=feedcontributions&user=Kaymay&feedformat=atomMoodleDocs - User contributions [en]2024-03-29T09:08:25ZUser contributionsMediaWiki 1.39.6https://docs.moodle.org/23/en/index.php?title=Grade_editing&diff=42927Grade editing2008-08-29T11:34:13Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}In the [[Grader_report|grader report]], in editing mode, users with the appropriate permissions can edit individual grades. Following is an explanation of the various settings and their effects on grades.<br />
<br />
<br />
==General description==<br />
[[Image:grade_edit.png|right|thumb|Editing a grade]]<br />
This form has a number of fields which are 'frozen': they cannot be changed except under certain conditions:<br />
<br />
*'''User''': The name of the course participant to whom this grade is attributed<br />
*'''Item name''': The name of the grade item to which this grade belongs<br />
*'''Final grade''': The grade value after all calculations have been performed. This can be edited if the grade was created manually.<br />
<br />
==Editable settings==<br />
===Overridden===<br />
When on, the overridden flag prevents any future attempts to automatically adjust the value of the grade. This flag is often set internally by the gradebook, but can be switched on and off manually using this form element. <br />
<br />
This must be distinguished from the "locked" flag, which only prevents modules from changing the grade value. With "overriden", even the gradebook calculations and aggregations no longer have any effect on this grade.<br />
<br />
===Excluded===<br />
When on, prevents this grade from being included in any aggregation.<br />
<br />
===Hidden===<br />
If on, the grade will appear as a hyphen (-) to any user without the permission to view hidden grades. This usually refers to students.<br />
<br />
===Hidden until===<br />
This is used instead of the "hidden" flag, when hiding is desired until a certain date, after which the grade will be revealed.<br />
<br />
===Locked===<br />
If on, the grade will ignore updates from the module.<br />
<br />
===Locked after===<br />
This is used instead of the "locked" flag, when locking is desired only after a certain date, after which the grade will be locked. This date is usually set as the same as the "hidden until" date., or shortly before (giving teachers a chance to review the grades before revealing them).<br />
<br />
===Feedback===<br />
The grader's comments about the grade.<br />
<br />
===Format===<br />
The formatting to be applied to the feedback once displayed.<br />
<br />
==See also==<br />
<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=97807 Grading locked in assignments but not locked in gradebook?] forum discussion<br />
<br />
[[ca:Edició de les qualificacions]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grader_report&diff=42917Grader report2008-08-29T09:31:34Z<p>Kaymay: </p>
<hr />
<div>{{Grades}}The grader report page is the main teacher view of the new gradebook in Moodle 1.9. For versions prior to 1.9, look [[Grades_pre-1.9 | here]].<br />
<br />
<br />
=Basics=<br />
The gradebook 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|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 how ever many raw marks that student got, not a percentage (although this can be changed later, see below).<br />
<br />
Not 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 />
==Layout==<br />
[[Image:gradebook_normal_mode.png|right|thumb|Grader report in non-editing mode]]<br />
Along the top are several rows: first the course, then the category, then the actual column (e.g. an essay or a category total). When you start off, every essay, quiz etc is in the '''uncategorised''' category, which is named after the course by default, but can be changed if needed.<br />
<br />
You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.<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 />
===Other layout options===<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->Grader report.<br />
<br />
*You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.<br />
<br />
==Highlighting rows and columns==<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 />
==Highlighting scores that are either adequate or unacceptable in red and green==<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 />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
<br />
=Editing=<br />
[[Image:gradebook_edit_mode.png|right|thumb|Grader report in editing mode]]<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 to 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 and a role e.g. '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 click on "[[Grade_preferences|My report preferences]]"' and choose "Quick grading" and "Quick feedback" to make the report appear with editable boxes containing each grade, so you can change many at once.<br />
<br />
Quick feedback is switched off by default, but you can easily switch it on or off using the "Show Quick Feedback" link above the grader report, when editing is on. Alternatively you can switch it on and off in the page "[[Grade_preferences|My report preferences]]".<br />
<br />
==Calculating totals==<br />
Rather than a simple average or sum, Moodle can perform very complex calculations to produce the totals for each category and for the whole course. e.g. you want to take an average of 3 items from one category, double it, then add it to the average of another category.<br />
<br />
You can do this using calculations. Either turn on editing, then click '''Show calculations''', or go to '''[[Grade_preferences|My report preferences]]''', choose '''show calculations''', then save and turn editing on. You will then see a small calculator icon next to each total column which, when you click on it, will take you to the page [[Edit grade calculation]] where there are instructions.<br />
<br />
To choose how the grades are aggregated for the totals within categories, you can turn editing on and click on the little editing icon for the category. You can then choose to have means, medians, modes etc. leave out empty grades and other settings.<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 assesment 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 />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87844 What happens in the 1.9 gradebook when students are unenrolled from a course] forum discussion<br />
<br />
[[ca:grade/report/grader/index]]<br />
[[fr:Rapport de l'évaluateur]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grades_FAQ&diff=42860Grades FAQ2008-08-28T12:41:04Z<p>Kaymay: </p>
<hr />
<div>{{Grades}}== General ==<br />
=== Why is the new gradebook so complicated? ===<br />
Added power and control requires more options. It is mostly the number of options and settings that gives the impression of complexity. Here are some of the main reasons for the changes made in the gradebook for 1.9:<br />
<br />
*Previous gradebook did not scale well: it became very slow and unmanageable in large organisations with many students, activities and grades<br />
*Grades were generated and stored by each module without much consistency<br />
*Difficulty in producing new types of reports<br />
*No [[Outcomes]]<br />
<br />
=== Is it possible to show the teachers/administrators' grades in the grader report? ===<br />
Yes, at the site level you can define which roles will appear in the grader report. This can be found in [[General_grade_settings#Graded_Roles|Administration > Grades > General settings]]. Also read [http://moodle.org/mod/forum/discuss.php?d=92612 this discussion] for some more ideas.<br />
<br />
===Why can't I change a grade within an assignment after changing it in the gradebook?===<br />
<br />
When you edit a grade directly in the gradebook, an "overridden" flag is set, meaning that the grade can no longer be changed from within the assignment.<br />
<br />
However, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.<br />
<br />
===How do I get groups to show up in the grader report?===<br />
<br />
For groups to show up in the grader report, group mode should be set to visible or separate groups in the [[Course settings|course settings]].<br />
<br />
===Are there any gradebook tutorials?===<br />
A tutorial showing how to set up a gradebook in 1.9 for both default grading and weighted grades by categories is found here: [[Gradebook 1.9 Tutorial]]<br />
<br />
=== Are there any video tutorials? ===<br />
Yes! Most of them were created by students during the [https://docs.moodle.org/en/GHOP/2008 Google Highly Open Participation Contest in 2007-2008]. Here is a list:<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Gradebook reports]<br />
*[http://youtube.com/watch?v=ZSabc0zHpbY Effects of the general grade settings]<br />
*[http://www.youtube.com/watch?v=lXEefYe3qdk How to use the grade item settings and grade letters at admin level]<br />
*[http://www.youtube.com/watch?v=sUslTuZPu6A Grade category settings]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc How to set up the gradebook]<br />
*[http://www.youtube.com/watch?v=PmkEGfvjj9U How to use outcomes in Moodle]<br />
*[http://www.youtube.com/watch?v=yZcbN_7p2zI How to export grades from the gradebook]<br />
*[http://www.youtube.com/watch?v=p6zWwJGb9TA How to use gradebook site settings and defaults]<br />
*[http://www.youtube.com/watch?v=WKUGyzAXcyA How to set up calculations in the gradebook (basic)]<br />
*[http://www.youtube.com/watch?v=VBEj8mmu8lM How to set up calculations in the gradebook (advanced)]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A How to change the display of grades in the gradebook]<br />
<br />
You can also find other tutorials on [http://www.moodletutorials.org moodletutorials.org].<br />
<br />
== Reports ==<br />
=== How do I create my own custom gradebook reports? ===<br />
Here is a [[Development:Gradebook_Report_Tutorial|tutorial]] explaining all the main steps involved.<br />
<br />
== Import/Export==<br />
<br />
== Aggregation ==<br />
=== I can't find where to change the aggregation type for my gradebook categories! ===<br />
Each category has an aggregation type, which can be changed through that category's "edit" page. To access that page, you must use one of 2 ways:<br />
<br />
1. In the grader report, turn "Editing" on, then click the little "hand" icon next to the category whose aggregation you want to change<br />
2. In the "Edit categories and Items" page (accessible through the "choose an action" menu, top left), you see a tree view of the categories and items in your gradebook. The top category is the course category. Each category also has a "hand" icon, which leads to the category edit page<br />
<br />
=== How can I grade some of my activities without the results affecting my students' course total? ===<br />
#Create two [[Grade categories]], one for your "activities still being graded," and one for your "released" activities.<br />
#Ensure that "Aggregate including subcategories" (an advanced option) is unchecked for your top level course grade category.<br />
##Where is this? In gradebook (grader report), in the upper right corner, click the "Turn Editing On" button.<br />
##Click the edit icon next to the "course category" (usually your course name, just above the quiz names and below all the clickable links that were revealed when you turned editing on)<br />
##Then make sure you have the "Show Advanced" option turned on.<br />
#Edit the "activities still being graded" category's "course total" item. (This is one of the categories you created above.)<br />
##Where is this? Look for the edit icon under "category total" that is below this category's name<br />
#Set the "grade type" to "none".<br />
#Tick the "Hidden" checkbox.<br />
#Save your changes.<br />
#Move all your activities being graded in the "activities still being graded" category.<br />
#Move all your activities already graded in the "released" category.<br />
<br />
Note: I rewrote this a bit, to help people find where things are. However, this method didn't seem to work for me on Moodle 1.9.<br />
<br />
=== My student completed only one activity out of 5, but his course total shows 100%. How do I show a more "progressive" course total? ===<br />
By default, only non-empty grades are aggregated, the others are ignored. However, you can change this setting as well as others that affect the course total, by turning "Editing" on in the grader report, and clicking the "Edit" icon next to the course category (the very top row of the grader report).<br />
<br />
You can untick the box "Aggregate only non-empty grades" if you want to show a more "progressive" score for each student. Their empty grades will count as a 0 and will be counted in the course mean/total.<br />
<br />
If you prefer to show a sum of points, rather than a percentage, you can change the course category's aggregation method to "Sum of grades".<br />
<br />
=== How can I display the average grade for my course categories (not grade categories)? ===<br />
In Moodle 1.9 there is no way to aggregate course totals within each category. The gradebook is course-centered, and there is currently no User Interface for showing grades within an entire course category at once.<br />
<br />
== Categories ==<br />
=== How many depths of categories/subcategories can I create? ===<br />
There is no programmatic limit, but there are practical limits. Very deeply nested structures are difficult to manage. 3 levels of categories should be sufficient for most situations. Note that there is always at least one level of categories, since the Course category always encompasses all other categories and grade items, can cannot be deleted.<br />
<br />
== Outcomes ==<br />
=== I have just upgraded to Moodle 1.9, and I want to set up an outcome item for my course. What are the steps required? ===<br />
#[[General_grade_settings#Enable_outcomes|Administration > Grades > General settings > Enable outcomes]]<br />
#[[Scales#Creating_a_new_scale|Create a scale]]<br />
#Create a course outcome (read the [[Outcomes| outcomes documentation]] for instructions). Assign to it the scale you just created.<br />
#Assign the outcome to your course<br />
#Enter the "Grades" section of your course, from the course administration block<br />
#In the Actions menu (top left), select Edit -> Categories and Items<br />
#Click "Add outcome item"<br />
#Follow the instructions of the [[Outcome items|outcome items documentation]] to create the outcome item<br />
<br />
You can now give your students a rating on the outcome dimension you just created. If you created a standard outcome, you will be able to use it in other courses and follow your students' performance across these courses.<br />
<br />
== Modules ==<br />
=== The activity module (Module name) doesn't support grading. How can I give my students a grade anyway? ===<br />
You can create a [[Grade_items#Manual_grade_items|grade item]] manually in the gradebook. You will have to grade your students through the [[Grader report]] interface (in editing mode).<br />
<br />
=== I just graded some of my students using the (Module name) interface, but the results aren't showing up in the grader report. What's going on? ===<br />
Here are some of the possible reasons:<br />
<br />
#The corresponding [[Grade items|grade item]] is [[Grade_locking#In_grade_items|locked]], or its parent [[Grade categories|category]] is [[Grade_locking#In_grade_categories|locked]].<br />
#The module code is not using the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook API]] correctly<br />
<br />
== Differences between 1.8 and 1.9 ==<br />
<br />
=== What improvements in the gradebook justify upgrading from 1.8 to 1.9? ===<br />
*Faster execution, more noticeable with large sites<br />
*More scalable<br />
*More control over the display of grades, to teachers and students<br />
*More [[Category aggregation|aggregation options]]<br />
*A simple, [[Development:Grades#API_for_communication_with_modules.2Fblocks|public API]] that can be used by any module to support grading<br />
*Possibility to write [[Development:Gradebook_Report_Tutorial|custom grade reports]]<br />
*A [[Development:Grades#History_tables|"Grade change history" record]]<br />
<br />
=== Is the gradebook in 1.9 faster than in 1.8? ===<br />
According to [http://moodle.org/mod/forum/discuss.php?d=91034&parent=410224 one early report], yes. There are other more thorough benchmark tests being conducted, and we will publish the results here when they are made public.<br />
<br />
==See also==<br />
<br />
*Using Moodle [http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=102609 Can I aggregate only non hidden items?]<br />
<br />
[[Category:FAQ]]<br />
<br />
<br />
[[ca:PMF de les qualificacions]]<br />
[[fr:FAQ des notes]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_locking&diff=42786Grade locking2008-08-27T09:44:19Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
== Locked after ==<br />
Date ''after'' which the grades will be ''locked''. Usually this date is set to the end of the activity, and the beginning of the grading process.. A typical sequence of events would be:<br />
<br />
{| cellpadding="4"<br />
|-<br />
!Event<br />
!Locked<br />
![[Grade hiding|Hidden]]<br />
|-<br />
|Start of activity and participant submissions<br />
|No<br />
|Yes<br />
|-<br />
|End of activity and beginning of grading/feedback<br />
|Yes<br />
|Yes<br />
|-<br />
|End of grading/feedback, and release of grades<br />
|Yes<br />
|No<br />
|}<br />
<br />
== Effects of locking ==<br />
Locking prevents changes to grades. It disables the "quick grading" and "quick feedback" features of the [[Grader report]], and prevents modules from updating grades. Locking affects grade items and grades differently, as outlined below.<br />
<br />
=== In grade categories ===<br />
Locking has no effect on the category itself, it is only used to affect a large number of grade items at once (bulk action), which in turns locks all their grades. The locking effect cascades down to all the category's children. If the category contains categories, the locking effect continues to cascade down, locking all categories, items and grades below the initial category. A grade item can be unlocked even though its parent category is flagged as locked.<br />
<br />
=== In grade items ===<br />
A locked grade item doesn't accept changes to its settings or grades from its related module. When there is no related module (as for manual grades), the locking simply prevents grader report users from changing the grade using the grader report interface.<br />
<br />
=== In grades ===<br />
If a grade item is locked, its grades are also locked, and cannot be unlocked until the grade item is also unlocked.<br />
<br />
<br />
[[ca:Tancament_de_qualificacions]]<br />
[[fr:Verrouillage de notes]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_hiding&diff=42785Grade hiding2008-08-27T09:43:37Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
==Introduction==<br />
In the context of the gradebook, hiding is completely separate from the show/hide in the main course page, where the activities are shown/hidden. The gradebook ones refer to whether a student will be able to see that grade or grade item in their user report. You can have an activity available on the course page for which you would not want the students to know their grade. Also in reverse - an offline activity that is hidden in the course page, but which you want the students to know their grade for.<br />
<br />
== Hidden until ==<br />
Date ''before'' which the grades will be ''hidden''. Usually this date is set to the end of the activity, and the beginning of the grading process.. A typical sequence of events would be:<br />
<br />
{| cellpadding="4"<br />
|-<br />
!Event<br />
![[Grade locking|Locked]]<br />
!Hidden<br />
|-<br />
|Start of activity and participant submissions<br />
|No<br />
|Yes<br />
|-<br />
|End of activity and beginning of grading/feedback<br />
|Yes<br />
|Yes<br />
|-<br />
|End of grading/feedback, and release of grades<br />
|Yes<br />
|No<br />
|}<br />
<br />
== Effects of hiding ==<br />
Hiding simply prevents students from viewing the categories, grade items and grades to which it applies. They appear to admins and teachers, but with a special style that clearly identifies them as hidden.<br />
<br />
<br />
[[ca:Ocultació_de_qualificacions]]<br />
[[fr:Dissimulation de notes]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Category_aggregation&diff=42784Category aggregation2008-08-27T09:43:03Z<p>Kaymay: correcció de la versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
== Overview ==<br />
This menu lets you choose the aggregation strategy that will be used to calculate each participant's overall grade for a [[Grade categories|grade category]]. The different options are explained below.<br />
<br />
The grades are first converted to percentage values (interval from 0 to 1), then aggregated using one of the strategies below and finally converted to the associated category item's range (between Minimum grade and Maximum grade).<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 />
== Aggregation strategies ==<br />
<br />
=== Mean of grades ===<br />
The sum of all grades divided by the total number of grades.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
(0.7 + 0.25 + 1.0)/3 = 0.65 --> 65/100<br />
=== Weighted mean ===<br />
Each grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence the importance of each item in the overall mean.<br />
A1 70/100 weight 10, A2 20/80 weight 5, A3 10/10 weight 3, category max 100:<br />
(0.7*10 + 0.25*5 + 1.0*3)/18 = 0.625 --> 62.5/100<br />
=== Simple weighted mean ===<br />
The difference from Weighted mean is that weight is calculated as Maximum grade - Minimum grade for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
(0.7*100 + 0.25*80 + 1.0*10)/190 = 0.526 --> 52.6/100<br />
=== Mean of grades (with extra credits) ===<br />
Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only for backward compatibility with old activities.<br />
=== Median of grades ===<br />
The middle grade (or the mean of the two middle grades) when grades are arranged in order of size. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
0.7 + 0.25 + 1.0 --> 0.25 --> 25/100<br />
=== Smallest grade ===<br />
The result is the smallest grade after normalisation. It is usually used in combination with Aggregate only non-empty grades.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
min(0.7 + 0.25 + 1.0) = 0.25 --> 25/100<br />
=== Highest grade ===<br />
The result is the highest grade after normalisation.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
max(0.7 + 0.25 + 1.0) = 1.0 --> 100/100<br />
=== Mode of grades ===<br />
The mode is the grade that occurs the most frequently. It is more often used for non-numerical grades. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean). However it loses its meaning once there is more than one most frequently occurring grade (only one is kept), or when all the grades are different from each other.<br />
A1 70/100, A2 35/50, A3 20/80, A4 10/10, A5 7/10 category max 100:<br />
mode(0.7; 0.7; 0.25; 1.0; 0.7) = 0.7 --> 70/100<br />
=== Sum of grades ===<br />
The sum of all grade values. Scale grades are ignored. This is the only type that does not convert the grades to percentages internally. The Maximum grade of associated category item is calculated automatically as a sum of maximums from all aggregated items.<br />
A1 70/100, A2 20/80, A3 10/10:<br />
70 + 20 + 10 = 100/190<br />
<br />
[[ca:Agregació de les categories]]<br />
[[fr:Tendance centrale de la catégorie]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Category_aggregation&diff=42783Category aggregation2008-08-27T09:41:44Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
== Overview ==<br />
This menu lets you choose the aggregation strategy that will be used to calculate each participant's overall grade for a [[Grade categories|grade category]]. The different options are explained below.<br />
<br />
The grades are first converted to percentage values (interval from 0 to 1), then aggregated using one of the strategies below and finally converted to the associated category item's range (between Minimum grade and Maximum grade).<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 />
== Aggregation strategies ==<br />
<br />
=== Mean of grades ===<br />
The sum of all grades divided by the total number of grades.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
(0.7 + 0.25 + 1.0)/3 = 0.65 --> 65/100<br />
=== Weighted mean ===<br />
Each grade item can be given a weight, which is then used in the arithmetic mean aggregation to influence the importance of each item in the overall mean.<br />
A1 70/100 weight 10, A2 20/80 weight 5, A3 10/10 weight 3, category max 100:<br />
(0.7*10 + 0.25*5 + 1.0*3)/18 = 0.625 --> 62.5/100<br />
=== Simple weighted mean ===<br />
The difference from Weighted mean is that weight is calculated as Maximum grade - Minimum grade for each item. 100 point assignment has weight 100, 10 point assignment has weight 10.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
(0.7*100 + 0.25*80 + 1.0*10)/190 = 0.526 --> 52.6/100<br />
=== Mean of grades (with extra credits) ===<br />
Arithmetic mean with a twist. An old, now unsupported aggregation strategy provided here only for backward compatibility with old activities.<br />
=== Median of grades ===<br />
The middle grade (or the mean of the two middle grades) when grades are arranged in order of size. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean).<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
0.7 + 0.25 + 1.0 --> 0.25 --> 25/100<br />
=== Smallest grade ===<br />
The result is the smallest grade after normalisation. It is usually used in combination with Aggregate only non-empty grades.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
min(0.7 + 0.25 + 1.0) = 0.25 --> 25/100<br />
=== Highest grade ===<br />
The result is the highest grade after normalisation.<br />
A1 70/100, A2 20/80, A3 10/10, category max 100:<br />
max(0.7 + 0.25 + 1.0) = 1.0 --> 100/100<br />
=== Mode of grades ===<br />
The mode is the grade that occurs the most frequently. It is more often used for non-numerical grades. The advantage over the mean is that it is not affected by outliers (grades which are uncommonly far from the mean). However it loses its meaning once there is more than one most frequently occurring grade (only one is kept), or when all the grades are different from each other.<br />
A1 70/100, A2 35/50, A3 20/80, A4 10/10, A5 7/10 category max 100:<br />
mode(0.7; 0.7; 0.25; 1.0; 0.7) = 0.7 --> 70/100<br />
=== Sum of grades ===<br />
The sum of all grade values. Scale grades are ignored. This is the only type that does not convert the grades to percentages internally. The Maximum grade of associated category item is calculated automatically as a sum of maximums from all aggregated items.<br />
A1 70/100, A2 20/80, A3 10/10:<br />
70 + 20 + 10 = 100/190<br />
<br />
[[ca:grade/edit/tree/index]]<br />
[[fr:Tendance centrale de la catégorie]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Edit_categories_and_items&diff=42782Edit categories and items2008-08-27T09:39:58Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
==Introduction==<br />
On this page, teachers and administrators can:<br />
*Add<br />
** [[Grade_categories|grade categories]]<br />
** [[Grade_items|grade items]]<br />
** [[Outcome_items|outcome items]]<br />
*Perform the following actions on grade categories and items:<br />
**Edit<br />
**Move in and out of categories<br />
**[[Grade hiding|Hide or show]]<br />
**[[Grade locking|Lock or unlock]]<br />
**Delete<br />
*Synchronise legacy grades<br />
*Edit [[Grade calculations|calculation formulas]] for grade categories<br />
[[image:edit_categories_and_items.png|thumb|right|Editing categories and items]]<br />
<br />
==Course grade category==<br />
The course grade category represents the course as a container for grade categories and grade items. It cannot be deleted or moved, but it can be [[Grade_hiding|hidden]] and [[Grade_locking|locked]] like other categories and items. When a course is created, this category is automatically created. Its '''Name''' value is empty and optional, in which case the category's name is displayed as that of the course it represents. If a name is given manually to this category, that name will be used instead of the course name. See [[Grade_categories|grade categories editing]] for more information.<br />
<br />
==Deleting categories==<br />
What happens to grade items in a grade category when that category is deleted? They automatically get assigned to the parent category of the deleted category. For example, take the following structure:<br />
<br />
Course (category)<br />
|_ Semester 1 (category)<br />
|_ Week 1 (category)<br />
|_ Quiz 1 (item)<br />
|_ Assignment 1 (item)<br />
|_ Week 2 (category) <br />
|_ Quiz 2 (item)<br />
|_ Assignment 2 (item)<br />
...<br />
<br />
If we delete Week 1, the items within it will be moved up to the Semester 1 category, and we will have the following structure:<br />
<br />
Course (category)<br />
|_ Semester 1 (category)<br />
|_ Quiz 1 (item)<br />
|_ Assignment 1 (item)<br />
|_ Week 2 (category) <br />
|_ Quiz 2 (item)<br />
|_ Assignment 2 (item)<br />
...<br />
<br />
As you can see, categories and items can live along-side each other without problems, but the result may look confusing to students and teachers alike.<br />
<br />
==Moving categories and items==<br />
[[image:edit_categories_and_items_move.png|thumb|right|Moving a grade item]]<br />
Each grade category and grade item has a little up-and-down icon next to it (apart from the course grade category), which triggers the '''move''' action when clicked. The page then changes as shown in the screenshot on the right of this section: <br />
<br />
*The element to be moved is highlighted and the word (Move) appears next to it<br />
*Rectangular boxes preceded by an arrow appear in places where you can move your selected item or category.<br />
*You can cancel your action at any time using the "Cancel" button at the bottom of the page<br />
<br />
Once you have clicked one of the destination rectangles, your item will appear there instead of its original place. If you moved a category that contained items and/or categories, all its contents will also be moved along with it.<br />
<br />
Moving items and categories does not affect individual grades. However, it affects the scores aggregated by categories and, if these categories have special [[Grade calculations|calculation formulas]] in place, also affects the scores aggregated under the course grade category (course totals).<br />
<br />
<br />
<br />
==Synchronise legacy grades==<br />
<br />
All current modules with grading support should be converted to use new gradebook API. Due to performance reasons the grades from legacy modules are not updated automatically, the synchronisation must be done manually by clicking on ''Synchronise legacy grades'' button in each course. '''This action may take a very long time''', depending on the number of activities, grades and participants in your course.<br />
<br />
[[ca:grade/edit/tree/index]]<br />
[[fr:Modifier les catégories et éléments]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Gradebook_course_settings&diff=42781Gradebook course settings2008-08-27T09:38:42Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}Course settings determine how the gradebook appears for all participants in the course.<br />
<br />
To change the course settings:<br />
<br />
#Choose "Course settings" from the gradebook dropdown menu.<br />
#Change the settings as required.<br />
#Click the "Save changes" button.<br />
<br />
Note: Individual teachers may override the aggregation position setting for their own grader report view via their [[Grade preferences|"My report preferences"]] tab.<br />
<br />
===Show rank===<br />
<br />
If the show rank checkbox is ticked, the position of a grade item in relation to the rest of the class will be shown.<br />
<br />
==Default course settings==<br />
[[Image:Gradebook course settings.png|thumb|left|Gradebook course settings]]<br />
The default course settings are set by an administrator in the following locations:<br />
* Grade display type and overall decimal points - ''Administration > Grades > [[Grade item settings]]''<br />
* Default aggregation position - ''Administration > Grades > [[General grade settings|General settings]]''<br />
* Overview report setting - ''Administration > Grades > [[Gradebook report settings|Report settings]] > Overview report''<br />
* User report settings - ''Administration > Grades > [[Gradebook report settings|Report settings]] > User report''<br />
<br />
[[Category:Course]]<br />
<br />
[[ca:grade/edit/settings/index]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_letters&diff=42780Grade letters2008-08-27T09:31:47Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}Grade letters 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.<br />
<br />
<br />
==Viewing grade letters==<br />
[[Image:Grade letters.png|thumb|Viewing the default grade letters]]<br />
Grade letters are set initially at site level. To view grade letters at course level:<br />
# Follow the grades link in the course administration block.<br />
# Select Letters from the view dropdown menu at the top left of the page.<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 />
==Editing course-level grade letters==<br />
[[Image:Editing grade letters.png|thumb|Editing grade letters]]<br />
To change the grade letters set at site level:<br />
<br />
# Follow the grades link in the course administration block.<br />
# Select Letters from the view dropdown menu at the top left of the page.<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 />
<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 />
==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 />
<br />
[[ca:grade/edit/letter/index]]<br />
[[es:Calificaciones con Letras]]<br />
[[fr:Notes lettres]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Outcomes&diff=42779Outcomes2008-08-27T09:30:44Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}Outcomes are specific descriptions of what a student is expected to be able to do or understand at the completion of an activity or course. An activity might have more than one outcome, and each may have a grade against it (usually on a scale). Other terms for Outcomes are ''Competencies'' and ''Goals''. In simple terms an Outcome is like any other grade except that it can be applied to multiple activities. When the activity is marked, a mark should be given for the submission itself '''and''' for the outcome. <br />
<br />
<br />
==Enabling outcomes==<br />
<br />
To use outcomes, the feature must be enabled by an administrator by checking the enableoutcomes box in ''Administration > Grades > [[General grade settings|General settings]]''.<br />
<br />
==Using outcomes==<br />
<br />
# Choose or define some outcomes for your course (see below).<br />
# For each activity, choose which of these outcomes apply using the tickbox in the activity's settings page.<br />
# When grading that activity, grade each student using the Outcome scales. Note: You can also edit the grades in the [[Grader report]] (useful for modules that don't feature inbuilt grading).<br />
# Use the outcomes as part of the assessment for students, or look at the [[Outcomes report]] for some useful feedback on how students in the class in general are performing.<br />
<br />
==Outcomes used in course==<br />
<br />
Outcomes may be set at site and/or course level. To choose outcomes for use in your course:<br />
<br />
# Follow the outcomes link in the course administration block. (Alternatively, select outcomes from the gradebook view dropdown menu.)<br />
# Select standard outcomes from the right list, and use the left-facing arrow button to add them to the left list. Multiple outcomes may be selected by holding down the Apple or Ctrl key whilst clicking on the individual outcomes.<br />
<br />
==Adding course-level outcomes==<br />
<br />
[[Image:Adding an outcome.png|thumb|Adding an outcome]]To add a course-level outcome:<br />
<br />
# Follow the outcomes link in the course administration block. (Alternatively, select outcomes from the gradebook view dropdown menu.)<br />
# Click the "Edit outcomes" tab in the middle of the page.<br />
# Click the "Add a new outcome" button.<br />
# Complete the form then click the "Save changes" button. <br />
<br />
==Adding standard outcomes==<br />
<br />
To add standard outcomes, which are available site-wide:<br />
<br />
# Login as an administrator.<br />
# Access ''Site administration > Grades > Outcomes''.<br />
# Click the "Add a new outcome" button.<br />
# Complete the form then click the "Save changes" button. <br />
<br />
==Import/export of outcomes==<br />
<br />
Outcomes (and their associated scales) can be exported by clicking the "Export all outcomes" button. This will send a file (in .csv format) that can be read by Excel, OpenOffice.org or by any text editor.<br />
<br />
It's possible to import outcomes (and associated scales) by submitting a csv file. The format of the file should be copied from the file obtained by the export function. Note that while importing: <br />
*Existing outcomes and scale will be used if available (no overwriting is done by the script)<br />
*The script will stop if it detects that the file contains invalid data.<br />
<br />
==Removing selected outcomes for activities==<br />
<br />
Previously selected outcomes are greyed out on the update activity page, however they can be removed via the gradebook edit categories and items page. This results in the outcomes being deselected on the update activity page.<br />
<br />
==See also==<br />
*[[Outcomes report]]<br />
*[[Development:Outcomes]]<br />
*[[Development:Outcomes examples]]<br />
*[http://www.youtube.com/watch?v=PmkEGfvjj9U Video on how to use outcomes in Moodle]<br />
*[http://www.youtube.com/watch?v=AYKsokpafsI Video on how outcomes can be reported at the Gradebook in Moodle 1.9]<br />
*[http://youtube.com/watch?v=sUslTuZPu6A Video on "Grade Category Settings" and "Outcomes"]<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=78074 Outcomes in 1.9] forum discussion<br />
*[[General grade settings]]<br />
<br />
<br />
[[ca:grade/edit/outcome/course]]<br />
[[fr:Objectifs]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Scales&diff=42778Scales2008-08-27T09:29:39Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Course admin}}<br />
[[Image:Scales_Icon.GIF]]Scales are a way of evaluating or rating a students' performance. Moodle offers a standard set of numeric scales. It is also possible to create custom scales which can be available on the site. For example, you can give the student a word or small phrase as a way of rating or giving a student feedback. <br />
<br />
<br />
Scales may be used in [[Forums]], [[Glossaries]] and [[Assignments]] for rating and/or [[Grades|grading]] a student's activity. <br />
<br />
==Standard scales==<br />
Moodle includes 100 different numeric scales which can not be edited, and one non-numeric example.<br />
<br />
===Numeric===<br />
Moodle includes numeric scales that range from a maximum of 100 to a maximum of 1. For example, selecting a scale of 10, will allow a rating on a scale between 10 and 1. Numeric scales can be calculated as a [[Grades|grade]]. <br />
<br />
===Included non numeric scales===<br />
Included in the standard 1.9 Moodle install is a scale called "Separate and Connected ways of knowing". This has 3 elements: "Mostly Separate Knowing", "Separate and Connected", "Mostly Connected Knowing". These phrases relate to a theory about how people approach the world. In edit mode, the teacher or administrator can see the scale description which explains the use of this interesting rating system. <br />
<br />
==Creating a new scale==<br />
New scales can be created by teachers with editing rights or by administrators or by any user with the [[Capabilities/moodle/course:managescales|manage scales role capability]] (Moodle 1.7 onwards). The process is similar for making a new scale for either a course or site.<br />
<br />
===Creating course scales===<br />
#Scales are located in the Grades in the course administration block. <br />
##For versions of Moodle prior to 1.9, click on the Scales link in the course [[Administration block]] (highlighted in red in the screenshot).[[Image:moodle19 adminbox scales.jpg|thumb|Moodle 1.8 course administration block]] In Moodle 1.9 onwards, click on the Grades link in the course Administration block, then select Scales from the Edit section of the grader report Choose an action dropdown list.<br />
#On the Scales page click the "Add a new scale" button.<br />
#On the next page give your scale a name in the Name box (highlighted in red in the screenshot) that will identify it among other scales.[[Image:moodle19 scales edit.jpg|center|thumb|Creating a new scale screen: Name, Scale, Description areas]]<br />
#In the Scale box (highlighted in green), create your scale. Each item in the scale should be separated by a comma. You can use as many options here as you require. You must order the comma separated elements in increasing order of value. For example, an A,B,C,D scale must be entered as D,C,B,A.<br />
**For example, you could include a four option scale ''refer, pass, merit, distinction'' or ''Hesitant (Fail), Acceptable, Average, Excellent'' depending on your curriculum/course needs. <br />
#Write a detailed description in the Description box (highlighted in blue) for your scale. Your students will have access to the description, and you can use this to give them additional feedback. The more details you put in the description, the more students will understand what each scale item means.<br />
<br />
===Creating a site scale===<br />
Creating scales that are available in every course is similar to creating one for a single course. The site administrator will find a Scales link in the site administration block under Grades. It will list the scales available on the site, except the standard numeric sales. <br />
<br />
**In older versions of Moodle, Administrators has to create a site-wide scales by "promoting" a scale created for a course. To achieve this, add a new scale in any course, then use the move down arrow to move the scale from custom scales to standard scales (i.e. site-wide).<br />
<br />
==Using a scale==<br />
First the teacher needs to assign a specific scale to the activity using a drop down menu in the activities setting. Then the teacher and/or students can rate an activity element (for example, a post in a forum) with the pre-defined scale.<br />
<br />
==Editing a scale==<br />
A scale can only be edited if no activities are using that scale. If this is the case, you will see an Edit, move Down, and Delete icon in the edit column.[[Image:moodle19 scales edit buttons.jpg|Editing a scale]] <br />
<br />
==Example scales==<br />
===The Cool Scale===<br />
*''The Cool Scale'' - The coolest thing ever!, Very cool, Cool, Fairly cool, Not very cool, Not cool<br />
===Affirmative Scale===<br />
*''General Introductions (The Affirmative Scale)'' - Welcome!, Glad to have you here!, Great post!<br />
===Complete===<br />
If you would like two options in your scale (incomplete and complete) type "incomplete, complete" in the scale box.<br />
<br />
===Generic Social forum scale===<br />
*''Generic Social Forum'' (This scale only worked prior to the averaging function) - Awesome!, Very cool., Interesting., Hmmm. Tell me more., I don’t understand. Please clarify.<br />
<br />
===Graphic character scales===<br />
It is possible to use a special set of characters as scales. For example in Moodle.org forums use a set of 5 stars (outlined and filled). The filled in stars advancing as the rating is higher. <br />
**Caution. Special graphic characters can be dependent upon the browser, the loaded character sets and other variables that may not produce the same result for every student.<br />
<br />
== See also ==<br />
<br />
*[[Using Moodle book]] Chapter 13: Grades and Scales<br />
<br />
[[Category:Grades]]<br />
<br />
[[ca:grade/edit/scale/index]]<br />
[[fr:Barèmes]]<br />
[[nl:Schalen]]<br />
[[zh:等级]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_calculations&diff=42777Grade calculations2008-08-27T09:28:21Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}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 />
<br />
==Enabling calculations==<br />
[[Image:Calc.JPG|thumb|"Show Calculations" Icon]][[Image:Calc_icon.JPG|thumb|Little calculator symbol]]To enable calculations for you gradebook:<br />
# Login as teacher or other user with permission to edit grades.<br />
# Go to course.<br />
# Click on ''Grades'' in the Administration block.<br />
# Click the "Turn Editing On" button on the top right corner.<br />
# Click the "Show Calculations" icon on the middle top.<br />
# Click the little calculator symbol under Course Total column which will bring you to the calculations page.<br />
<br />
==Assigning ID numbers==<br />
ID numbers are similar to nicknames for each grade item. In a calculation, instead of referring back to a whole assignment name, we can substitute it for it's ID number which becomes a lot easier. Think of it as substituting 143 as X and then using X for various math problems.<br />
<br />
ID numbers on the bottom of the page. Use simple to remember numbers or variables like 1, X, or Quiz1. Remember to click "Add id numbers"!<br />
<br />
==Understanding calculation functions==<br />
Click the yellow question mark next to the word "Calculation". This will bring a pop-up explaining the various functions that can be used in calculations and how to use them.<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.<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 />
<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 />
==Making your calculation==<br />
[[Image:Final_calc.JPG|thumb|Example calculation]]<br />
Back on the calculations page, start typing the various functions and the ID numbers chosen for your calculation.<br />
<br />
# Start with an equal sign (=)<br />
# Choose a function; Example: =sum()<br />
# Plug in your ID numbers enclosed in 2 hard brackets; Example: <nowiki>=sum([[item1]][[item2]][[item3]])</nowiki><br />
# Separate each ID number with a comma; Example: <nowiki>=sum([[item1]],[[item2]],[[item3]])</nowiki><br />
# Click the "Save Changes" button.<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 />
<br />
[[ca:grade/edit/tree/calculation]]<br />
[[fr:Calcul de notes]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_categories&diff=42776Grade categories2008-08-27T09:26:04Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
[[Image:Edit grade category.png|thumb|Editing a grade category]]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 />
<br />
==Settings==<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 />
=== Drop the lowest ===<br />
If set, this option will drop the X lowest grades, X being the selected value for this option.<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 />
[[ca:grade/edit/tree/category]]<br />
[[fr:Catégories d'évaluation]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_items&diff=42775Grade items2008-08-27T09:25:28Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
== Introduction ==<br />
The three building blocks of the Gradebook in Moodle 1.9 are<br />
<br />
#The [[Grade_categories|grade category]]<br />
#The grade item<br />
#The [[Grades|grade]]<br />
<br />
A grade item is a unit of measurement by which participants in a course are graded (i.e. 'marked'). 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 are represented by columns in the [[Grader_report | grader report]].<br />
<br />
Grade items may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or even manual grades. Following is an overview of each type.<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.<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 />
[[fr:Eléments d'évaluation]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_export&diff=42774Grade export2008-08-27T09:24:43Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}[[Image:Grade export.png|thumb|left|Grade export]]To export grades from the gradebook:<br />
# Choose an export format - Excel spreadsheet, OpenDocument spreadsheet, plain text file or XML file - from the gradebook dropdown menu.<br />
# Set options as required.<br />
# If the course uses groups, select whether to export grades for all participants or for a particular group.<br />
# Select the grade items to be included. Note that ID numbers are required for all activities for XML file export. An ID number field can be found in the common module settings for each activity.<br />
# Click the submit button.<br />
# After previewing the data on the following page, click the download button.<br />
<br />
==Default grade export settings==<br />
<br />
The grade export display type and grade export decimal points site-wide defaults may be set by an administrator in ''Administration > Grades > [[General grade settings|Grade settings]]''.<br />
<br />
==Grade publishing==<br />
[[Image:Grade publishing settings.png|thumb|left|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, due to the security implications.<br />
<br />
Grade publishing is disabled by default. It can be enabled by an administrator by checking the gradepublishing box in ''Administration > Grades > [[General grade settings|Grade settings]]''. Users with grade publishing capabilities (normally administrators only) are then provided with grade export publishing settings.<br />
<br />
==See also==<br />
<br />
*[http://www.youtube.com/watch?v=yZcbN_7p2zI Video showing how to exporting grades in Moodle 1.9]<br />
<br />
<br />
[[ca:grade/export/xml/index]]<br />
[[fr:Exportation des notes]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grade_import&diff=42773Grade import2008-08-27T09:24:11Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}Grades may be imported as a CSV or XML file.<br />
<br />
The import file format is the same as the corresponding export format. <br />
<br />
Note: Grade import is equivalent to manual grading in the [[Grader report|grader report]]. Thus, if grades for a particular Moodle activity such as an assignment are imported, they can no longer be edited via the assignment submission page.<br />
<br />
<br />
==Importing grades==<br />
[[Image:Csv grade import.png|thumb|CSV grade import]]<br />
To import grades into the gradebook:<br />
<br />
# Decide on an import format - CSV or XML file (see below) - then [[Grade export|export some grades]] using the corresponding export format.<br />
# Edit the export file as appropriate and save it.<br />
# Select your chosen import format from the gradebook dropdown menu.<br />
# Browse and upload your previously saved file.<br />
# Set options as required.<br />
# Click the "Upload grades" button.<br />
# CSV import only: Preview the grade import and choose the column mapping then click the "Upload grades" button to complete the grade import.<br />
<br />
You need two permissions to import grades: (1) general permission to import grades and (2) permission to import grades in a particular format. For example, to import CSV grades you need<br />
<br />
moodle/grade:import ("Import grades") = Allow<br />
gradeimport/csv:view ("Import grades from CSV") = Allow<br />
<br />
==XML import==<br />
<br />
XML import requires the numerical grade, activity idnumber and user idnumber.<br />
<br />
===Remote file URL===<br />
<br />
The remote file URL field is for fetching data from a remote server, such as a student information system.<br />
<br />
==CSV import==<br />
<br />
CSV import is more flexible than XML import, as you may choose the column mapping.<br />
<br />
===Encoding===<br />
<br />
If you are unsure of the encoding of your CSV file, try selecting the second option in the encoding dropdown menu. If you've used Excel to produce the CSV file the second option WINDOWS-xxx encoding is probably the correct one. The grade import preview will tell you if you guessed the encoding correctly.<br />
<br />
===Verbose scales===<br />
<br />
Scales can be either specified as a raw id - eg. 0, 1, 2, 3, etc. or as a string, eg. "good", "bad", "not very bad". The later format is called "verbose".<br />
<br />
==See also==<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=85944 Gradebook confusion]<br />
*[http://moodle.org/mod/forum/discuss.php?d=92081 Can external software insert data into the gradebook?]<br />
<br />
<br />
[[ca:grade/import/csv/index]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=User_report&diff=42772User report2008-08-27T09:23:30Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}The user report shows the currently logged in user's grades in the current course. It includes (for each assessment)<br />
<br />
#a breakdown of the grades for each assessment (grade item) in the course<br />
#a percentage value relative to the minimum-maximum grade for each assessment<br />
#the optional teacher-given feedback for each grade. <br />
<br />
It also shows an overall grade for the course (called course total). This total is the same as that shown on the [[Overview report|overview report]].<br />
<br />
Teachers and administrators may use the "Select all or one user" dropdown menu at the top right of the page to view individual user reports. When all users are selected, the report can be printed, and only one student should appear on each page (browser-dependent behaviour).<br />
<br />
===Can you switch the display of the percentages off in the report to students?===<br />
<br />
For example, if you just want pass/fail or a letter grade shown and not a percentage.<br />
<br />
Answer: not at the moment.<br />
<br />
There are two issue trackers for this: <br />
<br />
#http://tracker.moodle.org/browse/MDL-15887 (with links to the main discussion threads on this topic)<br />
#http://tracker.moodle.org/browse/MDL-13471<br />
<br />
There is a customisation here: http://moodle.org/mod/forum/discuss.php?d=102310 <br />
<br />
==See also==<br />
*[http://moodle.org/mod/forum/discuss.php?d=97607&parent=431607#p432046 How to code a custom User Report without percentages] Read from 'For the user report...'<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
<br />
[[ca:grade/report/user/index]]<br />
[[fr:Rapport de l'utilisateur]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Overview_report&diff=42771Overview report2008-08-27T09:22:47Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}The overview report shows the overall grades for all the courses a student is enrolled in. In this regard it differs from other reports, which only show grades for the current course. To see a breakdown of the grades for other courses, you need to go to these courses, access their gradebook, and select the user report. The overview report will be the same no matter which course you are currently viewing.<br />
<br />
==See also==<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
<br />
[[ca:grade/report/overview/index]]<br />
[[eu:Txosten_orokorra]]<br />
[[fr:Rapport d'ensemble]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Outcomes_report&diff=42770Outcomes report2008-08-27T09:21:45Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<br />
<br />
==Overview==<br />
The outcomes report helps teachers monitor their students' progress using [[Outcomes]]. It lists site-wide outcomes and custom outcomes used in the current course, their overall average (each outcome can be measured through many [[Grade items|grade items]]), each item's average values and the number of "grades" given for each item.<br />
<br />
==Description==<br />
[[image:outcomes_report.png|thumb|right|Outcomes report with sample data]]<br />
The report is a table with 6 columns, explained below:<br />
<br />
===Outcome name===<br />
Simply the short name of the outcome used in this course.<br />
<br />
===Overall average===<br />
This shows two values representing the average scores given to students for each outcome used in this course (it doesn't show the site-wide averages)<br />
<br />
===Site-wide===<br />
Whether the outcome is a site-wide outcome or not.<br />
<br />
===Activities===<br />
This lists the activities that use this outcome in this course. A new row is created for each activity, and the activity name is linked to the activity's page.<br />
<br />
===Average===<br />
This shows the average score for each activity using the outcome in this course.<br />
<br />
===Number of Grades===<br />
The number of grades given to students for each activity using the outcome.<br />
<br />
==See also==<br />
*[[Outcomes]]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
[[ca:grade/report/outcomes/index]]<br />
[[eu:Helburuen_txostena]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grader_report_preferences&diff=42769Grader report preferences2008-08-27T09:20:43Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}Location: The "My report preferences" tab in the grader report<br />
<br />
[[Image:Grade preferences.png|thumb|Grade preferences]]The grade preferences page enables teachers to set preferences for how the grader report is displayed.<br />
<br />
<br />
==General settings==<br />
<br />
===Aggregation view===<br />
Options are:<br />
*Report default (set by an administrator for all courses on the site)<br />
*Full view - all grades and totals are displayed<br />
*Aggregates only - only category and course totals are displayed<br />
*Grades only<br />
<br />
The aggregation view can also be controlled from the grader report using the <code>-</code>, <code>+</code> or <code>o</code> buttons next to the course title.<br />
<br />
===Quick grading===<br />
This will make the grader report appear with editable boxes for each grade, so you can change them quickly for many students.<br />
<br />
===Quick feedback===<br />
This does the same, but for the typed feedback.<br />
<br />
===Students per page===<br />
This sets the number of students displayed per page in the grader report. If left empty, the site default (set by an administrator) is used.<br />
<br />
===Aggregation position===<br />
To show the aggregation position setting (and other advanced settings) click the "Show advanced" button.<br />
<br />
Options are:<br />
*Report default (set by an administrator for all courses on the site)<br />
*Inherit<br />
*First - the course total column is the first column in the grader report<br />
*Last - the course total column is the last column in the grader report<br />
<br />
==Change report defaults==<br />
At the top right of the grade preferences page, administrators are provided with a "Change report defaults" link to [[Gradebook report settings|Grader report settings]]. Grader report settings can also be accessed via ''Administration > Grades > Report settings > Grader report''.<br />
<br />
==See also==<br />
<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
<br />
[[ca:grade/report/grader/preferences]]<br />
[[eu:Kalifikazioen_hobespenak]]<br />
[[fr:Préférences du rapport de l'évaluateur]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grader_report&diff=42768Grader report2008-08-27T09:19:51Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}The grader report page is the main teacher view of the new gradebook in Moodle 1.9. For versions prior to 1.9, look [[Grades_pre-1.9 | here]].<br />
<br />
<br />
=Basics=<br />
The gradebook 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|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 how ever many raw marks that student got, not a percentage (although this can be changed later, see below).<br />
<br />
Not 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 />
==Layout==<br />
[[Image:gradebook_normal_mode.png|right|thumb|Grader report in non-editing mode]]<br />
Along the top are several rows: first the course, then the category, then the actual column (e.g. an essay or a category total). When you start off, every essay, quiz etc is in the '''uncategorised''' category, which is named after the course by default, but can be changed if needed.<br />
<br />
You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.<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 />
===Other layout options===<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->Grader report.<br />
<br />
*You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.<br />
<br />
==Highlighting rows and columns==<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 />
==Highlighting scores that are either adequate or unacceptable in red and green==<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 />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
<br />
=Editing=<br />
[[Image:gradebook_edit_mode.png|right|thumb|Grader report in editing mode]]<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 to 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 and a role e.g. '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 click on "[[Grade_preferences|My report preferences]]"' and choose "Quick grading" and "Quick feedback" to make the report appear with editable boxes containing each grade, so you can change many at once.<br />
<br />
Quick feedback is switched off by default, but you can easily switch it on or off using the "Show Quick Feedback" link above the grader report, when editing is on. Alternatively you can switch it on and off in the page "[[Grade_preferences|My report preferences]]".<br />
<br />
==Calculating totals==<br />
Rather than a simple average or sum, Moodle can perform very complex calculations to produce the totals for each category and for the whole course. e.g. you want to take an average of 3 items from one category, double it, then add it to the average of another category.<br />
<br />
You can do this using calculations. Either turn on editing, then click '''Show calculations''', or go to '''[[Grade_preferences|My report preferences]]''', choose '''show calculations''', then save and turn editing on. You will then see a small calculator icon next to each total column which, when you click on it, will take you to the page [[Edit grade calculation]] where there are instructions.<br />
<br />
To choose how the grades are aggregated for the totals within categories, you can turn editing on and click on the little editing icon for the category. You can then choose to have means, medians, modes etc. leave out empty grades and other settings.<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 assesment 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 />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87844 What happens in the 1.9 gradebook when students are unenrolled from a course] forum discussion<br />
<br />
[[fr:Rapport de l'évaluateur]]<br />
[[ca:grade/report/grader/index]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Grades&diff=42767Grades2008-08-27T09:18:31Z<p>Kaymay: versió en català</p>
<hr />
<div>{{Grades}}<p class="note">'''Note:''' This page, together with the pages listed in the block on the right, describe the gradebook in Moodle 1.9 onwards. For documentation on the gradebook in Moodle prior to 1.9, see [[Grades pre-1.9]].</p><br />
<br />
==Introduction==<br />
<br />
The concepts of ''grades'' and of ''gradebook'' have been completely revisited in Moodle 1.9. Although these words are used in earlier versions, important differences are documented here in order to avoid misconceptions.<br />
<br />
The two central ideas of grading in Moodle 1.9 are:<br />
<br />
#'''Grades''' are scores attributed to participants in a Moodle course<br />
#The '''gradebook''' is a repository of these grades: modules push their grades to it, but the gradebook doesn't push anything back to the modules<br />
<br />
The three building blocks of the Gradebook in Moodle 1.9 are<br />
<br />
*The [[Grade_categories|grade category]]<br />
*The [[Grade_items|grade item]]<br />
*The grade (see above)<br />
<br />
As an overview:<br />
*A grade category groups grade items together, and has settings for affecting these grade items<br />
*A grade item stores a grade for each course participant, and has settings for affecting these grades<br />
*A grade has settings for affecting how it is displayed to the users, as well as [[Grade locking|locking]] and [[Grade hiding|hiding]] functions.<br />
<br />
Grades can be [[Grade_calculations|calculated]], [[Grade_categories#Aggregation|aggregated]] and [[Grader_report#Display|displayed]] in a variety of ways, the many settings having been designed to suit the needs of a great variety of organisations.<br />
<br />
Many activities in Moodle, such as [[Assignment module|assignments]], [[Forum module|forums]] and [[Quiz module|quizzes]] may be given grades. Grades may have numerical values, or words/phrases from a [[Scales|scale or rating system]].<br />
<br />
Grades can also be used as [[Outcomes|outcomes]] and as arbitrary text attributed to each participant in a course.<br />
<br />
==Grades pushed by modules==<br />
When activity modules produce grades, they use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook public API]] to push (or send) their grades to the gradebook. These grades are then stored in database tables that are independent of the modules. The grades are still kept in the module database tables, and the gradebook will never access or modify these original grades. <br />
<br />
The gradebook, however, provides administrators and teachers with tools for changing the ways in which grades are calculated, aggregated and displayed, as well as [[grade/edit/tree/grade|means to change the grades manually]] (a manual edit of a grade automatically locks the grade in the gradebook, so that the module which originally created the grade can no longer update that grade in the gradebook until the grade is unlocked).<br />
<br />
==Settings affecting grades==<br />
Being the smallest unit in the gradebook, the grade is affected by many settings at different levels. Here is a list of these levels, in hierarchical order:<br />
<br />
*[[General_grade_settings|Site-wide general settings]]<br />
*[[Grade_category_settings|Site-wide grade category settings]]<br />
*[[Grade_item_settings|Site-wide grade item settings]]<br />
*[[Gradebook_report_settings|Gradebook report settings]]<br />
*[[Gradebook_course_settings|Course settings]]<br />
*[[Grade_categories|Category settings]]<br />
*[[Grade_items|Grade item settings]]<br />
*[[grade/edit/tree/grade|Grade settings]]<br />
<br />
==Outcomes==<br />
<br />
[[Outcomes]] are specific descriptions of what a student is expected to be able to do or understand at the completion of an activity or course. An activity might have more than one outcome, and each may have a grade against it (usually on a [[Scales|scale]]).<br />
<br />
==Gradebook reports==<br />
<br />
The gradebook includes a variety of reports, available via the grades link in each [[Administration block|course administration block]]:<br />
<br />
* [[Grader report]] - The main teacher view of a course gradebook. The "[[Grade preferences|My report preferences]]" tab in the grader report enables teachers to change how the grader report is displayed.<br />
* [[Outcomes report]]<br />
* [[Overview report]]<br />
* [[User report]]<br />
<br />
==Grades organisation==<br />
<br />
Teachers may organise grades into [[Grade categories|grade categories]], [[Grade import|import]] and/or [[Grade export|export]] grades, and make [[Grade calculations|grade calculations]].<br />
<br />
Symbols to represent ranges of grades may be set as [[Grade letters|grade letters]].<br />
<br />
Administrators may control the appearance of the gradebook site-wide by adjusting settings available via the grades link in the site administration block:<br />
<br />
*[[General grade settings]]<br />
*[[Grade category settings]]<br />
*[[Grade item settings]]<br />
*[[Gradebook report settings]] <br />
<br />
==See also==<br />
<br />
*[http://www.youtube.com/watch?v=YeUy-_kbvqQ Basic Moodle Gradebook howto video]<br />
<br />
[[eu:Kalifikazioak]]<br />
[[fr:Notes]]<br />
[[ca:Qualificacions]]</div>Kaymayhttps://docs.moodle.org/23/en/index.php?title=Notes&diff=36010Notes2008-05-12T09:59:01Z<p>Kaymay: </p>
<hr />
<div>{{Moodle 1.9}}From Moodle 1.9 onwards, teachers may add notes about their students.<br />
<br />
The notes page may be accessed via the Notes tab in a user's profile page or the Notes tab on the Participants page.<br />
<br />
==Note status==<br />
<br />
A note's status determines who it is visible to.<br />
<br />
* Personal - The note will be visible only to you<br />
* Course - The note will be visible to teachers in this course<br />
* Site - The note will be visible to teachers in all courses<br />
<br />
==See also==<br />
*[http://www.youtube.com/watch?v=cS2tBi-ct5k Moodle 1.9 Notes Tutorial video]<br />
<br />
[[Category:Notes]]<br />
<br />
[[eu:Oharrak]]<br />
[[fr:Annotations]]<br />
[[ca:notes/index|Anotacions]]</div>Kaymay