Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eclass/grade-scales
Herramienta para calcular puntaje y notas según una escala. Se considera el % de exigencia. Además se puede transformar una nota a otra escala.
https://github.com/eclass/grade-scales
calcula-notas grade-scales typescript
Last synced: about 1 month ago
JSON representation
Herramienta para calcular puntaje y notas según una escala. Se considera el % de exigencia. Además se puede transformar una nota a otra escala.
- Host: GitHub
- URL: https://github.com/eclass/grade-scales
- Owner: eclass
- License: mit
- Created: 2019-11-19T21:09:08.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-18T19:58:30.000Z (about 2 months ago)
- Last Synced: 2024-11-18T20:55:45.778Z (about 2 months ago)
- Topics: calcula-notas, grade-scales, typescript
- Language: TypeScript
- Homepage: https://eclass.io
- Size: 494 KB
- Stars: 1
- Watchers: 13
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# @eclass/grade-scales
[](https://www.npmjs.com/package/@eclass/grade-scales)
[](https://travis-ci.org/eclass/grade-scales)
[](https://www.npmjs.com/package/@eclass/grade-scales)
[](https://david-dm.org/eclass/grade-scales)
[](https://david-dm.org/eclass/grade-scales#info=devDependencies)
## Instalación
```
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:
## Formato Escala de notas
```js
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: ","
}
```
# eClass - Grade Scales
Las funciones principales nos permiten calcular las notas y formatearlas.
## getGrade() : number
En base a una escala se calcula la nota según los puntos totales y los obtenidos.
```js
const grade = getGrade(scale, 10, 6)
// output: console.log({ grade })
{ grade: 4.6 }
```
## getGradeFormatted(): Object
Devuelve la nota formateada con el estado si está "Aprobada" o "Reprobada"
```js
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
}
}
```
## getQualification(): Object
Si tenemos la nota ya calculada podemos darle formato con la función
```js
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
}
}
```
## getAverage() : number
Según la escala calcula el promedio en base a un set de notas.
```js
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.
```js
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
}
}
}
```
## convertToScale() : number
Transforma una nota de una escala a otra.
```js
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 }
```
## getGrades() : Array
Calcula todas las notas de una escala según el puntaje máximo
```js
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'
}
]
```
# Otras funciones
## gradeFormat(): string
Formatea una nota según el estilo de la escala.
```js
const format = gradeFormat(scale, 2.5)
// output: console.log({ format })
{ format: '2,5' }
```
## gradeIsApproved() : boolean
Calcula la nota si está aprobada o reprobada
```js
const isApproved = gradeIsApproved(scale, 5)
// output: console.log({ isApproved })
{ isApproved: true }
```
## gradeRound() : number
Calcula la nota si está aprobada o reprobada
```js
const rounded = gradeRound(scale, 5.3551)
// output: console.log({ rounded })
{ rounded: 5.4 }
```
## gradeStatus(): QualificationType
Calcula la nota si está aprobada o reprobada con formato
```js
const status = gradeStatus(scale, 4.3)
// output: console.log({ status })
{
status: {
id: 1,
name: 'Aprobado',
detail: 'La nota está aprobada',
style: 'approved',
enabled: true
}
}
```
## License
[MIT](https://tldrlegal.com/license/mit-license)