npm i @eclass/grade-scales
Este módulo permite calcular notas en base a una escala de notas. La escala debe tener algunos valores que se listan a continuación:
const scale = {
name: "Chile 50% (1-7, aprobación 50%, nota 4)",
keyname: "Chile50",
min: 1,
max: 7,
passingGrade: 4,
passingPercentage: 50,
roundType: "round",
prepend: "",
append: "",
decimals: 1,
decimalSeparator: ","
}Las funciones principales nos permiten calcular las notas y formatearlas.
En base a una escala se calcula la nota según los puntos totales y los obtenidos.
const grade = getGrade(scale, 10, 6)
// output: console.log({ grade })
{ grade: 4.6 }Devuelve la nota formateada con el estado si está "Aprobada" o "Reprobada"
const grade = getGradeQualification(scale, 10, 6)
// output: console.log({ grade })
{
value: 4.6,
valueFormatted: '4,6',
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}Si tenemos la nota ya calculada podemos darle formato con la función
const qualification = getQualification(scale, 5.6)
// output: console.log({ qualification })
{
value: 5.6,
valueFormatted: '5,6',
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}Según la escala calcula el promedio en base a un set de notas.
const average = getAverage(scale, { grades: [3, 4, 6] })
// output: console.log({ average })
{
average: {
value: 4.7,
valueFormatted: '4,7',
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}
}Además puede recibir un arreglo de valores con las ponderaciones para calcular el promedio de notas.
const average = getAverage(scale, {
grades: [3, 4, 7],
weights: [20, 30, 50]
})
// output
{: console.log({ // })
average: {
value: 5.3,
valueFormatted: '5,3',
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}
}Transforma una nota de una escala a otra.
const newScale = {
name: 'Porcentaje (1-100%, aprobación 60%, nota 70)',
keyname: 'Porcentaje_1-100_60',
min: 1,
max: 100,
passingGrade: 70,
passingPercentage: 60,
roundType: 'round',
prepend: '',
append: '%',
decimals: 0,
decimalSeparator: ','
}
const converted = convertToScale({ scale, grade: 4.8 }, newScale)
// output: console.log({ converted })
{ converted: 64 }Calcula todas las notas de una escala según el puntaje máximo
const grades = getGrades(scale, 1, 0)
// output: console.log({ grades })
[
{
points: { obtained: 0, total: 1 },
grade: 1,
qualification: { value: 1, valueFormatted: '1', status: [Object] },
isApproved: false,
formatted: '1'
},
{
points: { obtained: 1, total: 1 },
grade: 7,
qualification: { value: 7, valueFormatted: '7', status: [Object] },
isApproved: true,
formatted: '7'
}
]Formatea una nota según el estilo de la escala.
const format = gradeFormat(scale, 2.5)
// output: console.log({ format })
{ format: '2,5' }Calcula la nota si está aprobada o reprobada
const isApproved = gradeIsApproved(scale, 5)
// output: console.log({ isApproved })
{ isApproved: true }Calcula la nota si está aprobada o reprobada
const rounded = gradeRound(scale, 5.3551)
// output: console.log({ rounded })
{ rounded: 5.4 }Calcula la nota si está aprobada o reprobada con formato
const status = gradeStatus(scale, 4.3)
// output: console.log({ status })
{
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent