CGPA Calculator

A lightweight JavaScript library for calculating GPA (Grade Point Average), CGPA (Cumulative GPA), and SGPA (Semester GPA).

Try the online version at gpacalc.app

Installation

npm install cgpa-calculator

Quick Start

const { calculateGPA, calculateCGPA, gpaToLetter } = require('cgpa-calculator');

// Calculate semester GPA
const gpa = calculateGPA([
  { grade: 'A', credits: 4 },
  { grade: 'B+', credits: 3 },
  { grade: 'A-', credits: 3 },
  { grade: 'B', credits: 2 }
]);

console.log(gpa); // 3.58
console.log(gpaToLetter(gpa)); // 'B+'

API

calculateGPA(courses, options?)

Calculate GPA from a list of courses.

const gpa = calculateGPA([
  { grade: 'A', credits: 3 },
  { grade: 'B', credits: 4 }
], { scale: '4.0' });

Parameters:

• courses - Array of { grade: string | number, credits: number }
• options.scale - Grading scale: '4.0' (default) or '5.0'

calculateCGPA(semesters, options?)

Calculate cumulative GPA across multiple semesters.

const cgpa = calculateCGPA([
  [{ grade: 'A', credits: 3 }, { grade: 'B', credits: 4 }],
  [{ grade: 'A-', credits: 3 }, { grade: 'B+', credits: 3 }]
]);

calculateSGPA(courses, options?)

Alias for calculateGPA. Calculate a single semester's GPA.

percentageToGPA(percentage, scale)

Convert percentage score to GPA.

percentageToGPA(85, '4.0'); // 3.5
percentageToGPA(92, '5.0'); // 5.0

gpaToLetter(gpa)

Convert numeric GPA to letter grade.

gpaToLetter(3.5); // 'B+'
gpaToLetter(4.0); // 'A'

getGradePoint(grade, scale)

Get the numeric value for a letter grade.

getGradePoint('A', '4.0'); // 4.0
getGradePoint('B+', '5.0'); // 4.0

Supported Grade Scales

4.0 Scale

5.0 Scale

Online Calculator

For a visual, interactive GPA calculator, visit gpacalc.app.

Related Resources

GPA Calculator -- Free online GPA, CGPA, and SGPA calculator for students worldwide.

Also available for:

• JavaScript (npm)
• Ruby (RubyGems)
• Rust (crates.io)
• PHP (Packagist)
• .NET (NuGet)
• Elixir (Hex.pm)
• Dart/Flutter (pub.dev)

Learn more:

• GPA Resources
• GPA Academic Tools
• GPA Tools
• GPA Student Hub
• GPA Guides
• GPA Resources (GitHub)
• GPA Blog

License

MIT