Cálculos de calificación

Moodle 3.6

Notas del traductor: Es muy importante recordar que la documentación original de Moodle en inglés, al igual que el paquete de idioma del Español de México, emplean el punto decimal como Separador decimal, mientras que el Español internacional emplea la coma decimal (para España y la mayoría de SudAmérica); esto tiene gran importancia para los cálculos de calificaciones, porque Usted podría usar una fórmula como "=average(item1, item2, item3, item4, item5, item6)" y obtener una respuesta de "Fórmula no válida" con el Español internacional y para corregirlo deberá de emplear ; en lugar de , como caracter separador de la lista de ítems: "=average(item1; item2; item3; item4; item5; item6)".

Un cálculo de calificación es una fórmula usada para determinar calificaciones, basada (opcionalmente) en otros ítems de calificación. Tenga en cuenta que esto no es lo mismo que los tipos de pregunta calculada.

Los cálculos para el libro de calificaciones siguen el patrón de fórmulas/funciones en programas de hoja-de-cálculo populares. Empiezan con un signo igual (=), y usan operadores y funciones matemáticas comunes para producir una salida numérica única. Esta salida es después usada como el valor computado para el ítem de calificación que Usted está editando.

Nota: Urgente de Traducir. ¡ Anímese a traducir esta muy importante página !. ( y otras páginas muy importantes que urge traducir)

Setting a grade calculation

Edit calculation setting

Example calculation

To set a grade calculation:

Login as teacher or other user with permission to edit grades
Click on Grades in the course administration block
Click the 'Categories and items'
Click the 'Edit settings' and then 'Edit calculation'. Note: if you don't see this, then it must be enabled in Site administration>Grades>Report settings>Grader report
Start with an equal sign (=)
Type an expression using numbers, arithmetic operators, mathematical functions and ID numbers; for example =average()
Plug in your ID numbers (see below) enclosed in double square brackets, for example =[[item1]]+[[item2]]
Separate each function argument with a comma, as in =average([[item1]], [[item2]])+[[item3]])
Click the "Save Changes" button

Assigning ID numbers

You can include the values of other grade items by using their ID number as references in your formulas. The ID number must be surrounded by double square brackets, for example if you have a grade item with Quiz.3 as ID number, you can refer this item using [[Quiz.3]] in your calculation.

Below the calculation field there is a list of your course grade categories and grade items. Next to each item or category's total there is the ID number you can use in your calculation (already surrounded with the required double square brackets).

However, since ID numbers are optional, some items may not yet have one. Each item without ID number have a form field that you can use to enter its ID number directly. As soon as you have assigned the ID numbers you need, you must click the "Add ID numbers" button; the page will reload and show you the same list including the ID numbers you have just assigned. Now you can use them in your grade calculation.

Note: Moodle does not allow calculations involving no ID numbers.

Calculation functions

Every grade calculation must start with an equal sign (=) followed by an expression using operators and functions supported by the system. All common arithmetic operators are supported

addition, using the plus (+) sign
subtraction, using the minus (-) sign
multiplication, using the asterisk (*) character
division, using the slash (/) character
exponentiation, using the caret (^) character

with their usual evaluation precedence rules: exponentiations are evaluated first, then multiplications and divisions are performed, finally additions and subtraction are carried out; so, the expression =1+2-3*4/5^6 gives almost 3 (2,999232). Different precedences can be forced using round parentheses, as in the expression =((((1+2)-3)*4)/5)^6 which yields 0.

Functions can also appear in expressions, using the comma (,) character to separate their arguments listed within round brackets. (Note that the separator character could be a semicolon (;) in other idiomas, see below).

average([[item1]], [[item2]]...): Returns the average of the values in a list of arguments
max([[item1]], [[item2]]...): Returns the maximum value in a list of arguments
min([[item1]], [[item2]]...): Returns the minimum value in a list of arguments
mod(dividend, divisor): Calculates the remainder of a division
pi(): Returns the value of the number Pi (3.14159265...)
power(base, exponent): Raises a number to the exponent power (this is the same as base^exponent)
round(number, count): Rounds number to count decimal digits
floor(number): Maps a real number to the largest previous integer
ceil(number): Maps a real number to the smallest following integer
sum([[item1]], [[item2]]...): Returns the sum of all arguments (this is the same as [[item1]]+[[item2]]+...

Many other mathematical functions are also supported:

sin()
sinh()
arcsin()
asin()
arcsinh()
asinh()
cos()
cosh()
arccos()
acos()
arccosh()
acosh()
tan()
tanh()
arctan()
atan()
arctanh()
atanh()
sqrt()
abs()
ln()
log()
exp()

Example calculations

=max([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]) - Returns the maximum value of the grades referred by Quiz.1, Quiz.4 and Assignment.1
=average(max([[Quiz.1]], [[Quiz.4]], [[Assignment.1]]), min([[Quiz.1]], [[Quiz.4]], [[Assignment.1]])) - Returns the average of the maximum and the minimum values among Quiz.1, Quiz.4 and Assignment.1 (functions can be nested)
=sum([[item1]]*0.3, [[item2]]*0.6, [[item3]]*2) - Returns a weighted grade sum where item1 is weighted 30%, item2 is weighted at 60% and item3 is weighted at 200%

Calculations when user language is not English

Calculation can formulas use decimal and list separators as defined in the langconfig.php file of each paquetes de idioma.

The separador decimal (the 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 (,).

Analogously, the list separator (the symbol used to separate the items within a list, such as the arguments of a function) is a comma (,) in English. In other languages it may be a semicolon (;).

Configurando un cálculo de calificación

Moodle 2.8: Configuración para editar el cálculo

Cálculo de ejemplo

Para configurar un cálculo de calificación:

Ingrese como maestro o como otro usuario con permiso para editar calificaciones
Elija 'Configuración del Libro de calificaciones' en el bloque de administración del curso
Elija el desplegable para 'Editar' y después 'Editar cálculo'. Tenga en cuenta que si Usted no ve esto, entonces debe de ser habilitado en "Administración del sitio > Calificaciones > Configuraciones del reporte > Reporte del calificador"
Empiece con un signo igual (=)
Escriba una expresión usando números, operadores aritméticos, funciones matemáticas y números ID; por ejemplo =average()
Escriba sus números de ID (vea debajo) dentro de dobles corchetes (dobles paréntesis cuadrados), por ejemplo =[[item1]]+[[item2]]
Separe cada número ID con una coma, por ejemplo =average([[item1]],[[item2]])+[[item3]]
Elija el botón para "Guardar cambios"

Asignando números ID

Usted puede incluir los valores de otros ítems de calificación al emplear sus números ID como referencias en sus fórmulas. El número ID va rodeado de corchetes o paréntesis cuadrados dobles; por ejemplo, si Usted tuviera un item de calificación cuyo número ID fuese Examen.3 entonces Usted se podría referir a éste ítem como [[Examen.3]] en su cálculo.

Debajo del campo del cálculo está una lista de sus cursos con sus categorías de calificaciones y sus ítems de calificaciones. Junto a cada total de ítem o categoría se muestra el número ID que Usted puede usar en su cálculo (ya está rodeado por dobles corchetes o paréntesis cuadrados). Sin embargo, dado que el número ID es opcional, algunos ítems es posible que no lo tengan. Estos ítems sin número ID tienen en su lugar un campo para formato que le permite escribir directamente un número ID.

Tan pronto como Usted haya asignado los números ID que necesita, Usted podrá elegir el botón para "Añadir números ID", y la página se volverá a cargar y le mostrará la misma lista con los números ID que acaba Usted de asignar. Ahora Usted puede usarlos en sus fórmulas.

Funciones de cálculo

Cada cálculo debe empezar con un signo igual (=). Después sigue una expresión usando operadores y funciones soportadas por el sistema. Todos los operadores aritméticos son soportados:

suma, usando el signo más (+)
resta, usando el signo menos (-)
multiplicación, usando el caracter del asterisco (*)
división, usando el caracter de la diagonal (/)
exponenciación, usando el caracter del signo de intercalación (^)

con sus reglas usuales de precedencia: primeramente se evalúan las exponenciaciones, después se realizan las multiplicaciones y divisiones, finalmente se hacen las sumas y restas; así, la expresión =1+2-3*4/5^6 da casi 3 (2,999232). Pueden forzarse las precedencias usando paréntesis, como en la expresión =((((1+2)-3)*4)/5)^6 que produce 0.

También se pueden usar operadores de comparación:

mayor, usando el carácter (>)
mayor o igual, usando los caracteres (>=)
menor, usando el carácter (<),
menor o igual, usando los caracteres(<=)
igual, usando los caracteres (==)

cada operador da un valor 0 si la condición es falsa o 1 si es verdadera. Se pueden usar en cualquier expresión y tiene mayor precedencia que el resto de los operadores. Por ejemplo, la expresión =2<3*10 da 10 porque 2<3 da 1. Pero se recomienda, por mayor legibilidad, usar paréntesis o la función "if" como en el siguiente ejemplo: =(2<3)*10 o =if(2<3, 10, 0) que son numéricamente equivalentes.

Nota: Moodle no permite cálculos que involucren números sin ID.

Las funciones también pueden aparecer en expresiones, usando el caracter de la coma (,) para separar los argumentos enlistados adentro de la función en paréntesis (redondos). (El caracter separador podría ser un punto y coma (;) en el Español internacional y en otros idiomas diferentes al Inglés y al Español de México, vea debajo).

average([[item1]], [[item2]]...): Regresa el promedio de los valores en una lista de argumentos
max([[item1]], [[item2]]...): Regresa el valor máximo en una lista de argumentos
min([[item1]], [[item2]]...):: Regresa el valor mínimo en una lista de argumentos
mod(dividendo, divisor): Calcula el residuo de una división
pi(): Regresa el valor del número Pi
power(base, potencia): Eleva un número a una potencia
round(número, dígitos): Redondea un número a una cantidad de dígitos decimales
floor(número):Mapea un número real al entero mayor previo
ceil(número):Mapea un número real al entero menor siguiente
sum([[item1]], [[item2]]...): Regresa la suma de todos los argumentos
if(número, número, número): Evalúa el primer argumento (condición) y devuelve el segundo argumento si la condición no es cero (es decir verdadero) y devuelve el tercer argumento si la condición vale cero (indica condición falsa).

Muchas otras funciones matemáticas también están soportadas:

sin()
sinh()
arcsin()
asin()
arcsinh()
asinh()
cos()
cosh()
arccos()
acos()
arccosh()
acosh()
tan()
tanh()
arctan()
atan()
arctanh()
atanh()
sqrt()
abs()
ln()
log()
exp()

Cálculos de ejemplo

=max([[Examen.1]], [[Examen.4]], [[Tarea.1]]) - Regresa el valor máximo de Examen.1, Examen.4 and Tarea.1
=average(max([[Examen.1]], [[Examen.4]], [[Tarea.1]]), min([[Examen.1]], [[Examen.4]], [[Tarea.1]])) - Regresa el promedio de los valores máximo y mínimo entre Examen.1, Examen.4 y Tarea.1 (las funciones pueden estar anidadas)
=sum([[1]]*0.3,[[2]]*0.6,[[3]]*2) - Regresa un cálculo de calificaciones ponderadas en donde el ítem 1 es ponderado 30%, el ítem 2 es ponderado en 60% y el ítem 3 es ponderado al 200%
=if([[examenparcial]]>=5, [[examenparcial]]+[[lab]], 0) - Devuelve la suma de los items examenparcial y lab si la nota de examenparcial es 5 o más y devuelve 0 en caso contrario. Esta es una forma cómoda de manejar las calificaciones condicionales en un curso.

Cálculos cuando el idioma del usuario no es Inglés

Las fórmulas para cálculos usan el Separador decimal y el separador de listas definidos en el archivo langconfig.php de cada paquete de Idioma.

El Separador decimal (un símbolo usado para marcar el límite entre las porciones entera y fraccional de un número decimal) es un punto (.) en Inglés y en el Español de México, pero es una coma (,) en el Español internacional y en algunos otros idiomas.

El separador de listas (un símbolo usado para separar los ítems adentro de una lista, tales como los argumentos de una función) es una coma (,) en Inglés y en el Español de México. En otros idiomas (como en el Español internacional) podría ser un punto y coma (;).

Vea también

Documentation