| Metric | Value | Copy |
|---|---|---|
| {{ row.label }} | {{ row.value }} |
| Priority | Action | Why |
|---|---|---|
| {{ row.priority }} | {{ row.action }} | {{ row.why }} |
| Line | Course | Credits | Grade | Tag | Status | GPA pts | Quality pts | Note |
|---|---|---|---|---|---|---|---|---|
| {{ row.line }} | {{ row.course }} | {{ row.credits }} | {{ row.grade }} | {{ row.tag }} | {{ row.status }} | {{ row.gpaPoints }} | {{ row.qualityPoints }} | {{ row.note }} |
| Course | Credits | Current grade | Next step | GPA lift | Quality share | Note |
|---|---|---|---|---|---|---|
| {{ row.course }} | {{ row.credits }} | {{ row.grade }} | {{ row.nextStep }} | {{ row.projectedLift }} | {{ row.qualityShare }} | {{ row.note }} |
Grade point average, or GPA, is a credit-weighted average of course performance. A strong letter in a four-credit class changes the average more than the same letter in a one-credit class, which is why semester planning usually needs more than a quick mental estimate. This calculator turns a pasted course list into a weighted GPA on the scale you choose.
It is aimed at the common planning question: "If these are my courses and these are the grades I expect, where does the average land?" Beyond the headline GPA, the package reports parsed rows, quality points, a target gap, guidance, and a course-mix ledger that groups effective courses into broad letter bands.
That extra structure matters when the same transcript story can be read in different ways. A repeated course can either be counted every time or reduced to the strongest attempt under the package's repeat rule. An honors bonus can lift each course before the result is capped at the chosen scale. A target GPA can turn a raw average into a planning question about how far short or how far ahead a scenario really is.
The result is useful for semester simulation, retake planning, and checking how sensitive an average is to a few high-credit classes. It is not an official registrar calculation. Schools vary on repeat forgiveness, pass grades, honors weighting, and the exact rules behind academic standing, so the package should be treated as a scenario calculator built around the rules shown in the form.
The arithmetic runs in the browser and this bundle does not ship a server helper for GPA math. Even so, changed inputs are mirrored into the page address through shared query-state handling, so course names and the optional scenario label are best kept generic when a link may be saved, copied, or shared.
Start with one clean baseline pass. Paste one course per line in the form Course, Credits, Grade, leave the scale at its default if that matches your school, and check whether Parsed course rows equals the number of lines you expected to count. If the parser only accepts some rows, the final GPA is already answering a smaller question than the one you thought you asked.
The most important planning switch is Repeated course policy. Count all attempts keeps every parsed row in the denominator and numerator. Keep highest attempt reduces repeated course names to the single attempt that contributes the most quality points in this package. That makes the tool useful for quick retake scenarios, but it also means repeat matching depends on the course name text you enter rather than on any registrar course ID.
Honors bonus per course is the second big lever. The package adds that bonus after converting the grade to the selected scale and then caps the adjusted point value at the scale maximum. It can lift a solid grade toward the top of the scale without letting any one course exceed the chosen maximum, but it should not be mistaken for a universal honors-policy model.
The package also gives you a second read on the same course list through Letter Mix Ledger. Instead of showing only one average, that tab counts how many effective courses land in the package's A-range, B-range, C-range, or below-C buckets after repeat handling and honors adjustment. If the GPA is missing a target by a small amount, that ledger is often more actionable than the average itself because it shows whether one recovery course or a broad middle-band improvement is the bigger issue.
Gap to target GPA means the scenario is still short of the target you entered.The parser reads each non-empty line as a CSV-style row with three expected columns: course name, credits, and grade. Rows with too few columns are ignored with a warning. Rows with invalid credits or an unrecognized grade are also ignored. If the course name contains commas, the parser can still read it correctly when the text is quoted because the input handling follows CSV-style splitting rather than a simple comma cut.
Every valid grade is first resolved on a 4.0 base map. The package uses A+ and A as 4.0, A- as 3.7, B+ as 3.3, B as 3.0, B- as 2.7, C+ as 2.3, C as 2.0, C- as 1.7, D+ as 1.3, D as 1.0, D- as 0.7, and F as 0.0. If you paste a numeric value in the grade column, the package also accepts it as a 0 to 4 point input and clamps it into that range. A pasted P resolves to 0.0 in this bundle, so pass-like rows are not excluded automatically.
After that, the package rescales the 4.0-base value onto the selected GPA maximum, adds the honors bonus, and clamps the adjusted point value so it cannot exceed the chosen scale. Quality points are then calculated as adjusted grade points multiplied by credits. The overall GPA is total quality points divided by total credits from the rows that remain after validation and repeat-policy handling.
| Package step | How the package computes it | Why it changes the result |
|---|---|---|
| Adjusted course points | min(scale, (point4 × scale / 4) + honors bonus) |
This is where scale conversion and honors weighting enter the calculation. |
| Course quality points | adjusted course points × credits |
Higher-credit classes move the final GPA more than lower-credit classes. |
| Overall GPA | total quality points / total credits |
The summary number reflects only the rows that survive validation and repeat handling. |
The default repeat rule deserves careful reading. When Keep highest attempt is selected, the package groups rows by the lowercased course name and keeps only the repeated row with the highest quality-point contribution for that name. In the common case where repeated attempts carry the same credits, that behaves like keeping the highest grade. If credits differ between attempts, the kept row is the one that contributes the most quality points, not necessarily the one with the highest raw letter alone.
| Surface | What it shows | What it is good for |
|---|---|---|
GPA Metrics |
Calculated rows plus the current input snapshot | Auditing the exact scenario and exporting CSV or DOCX summaries. |
GPA Guidance |
Priority-tagged actions about targets, row formatting, and credit-load effects | Deciding what to fix first when the result is close to the target or full of warnings. |
GPA Metrics chart |
Only the numeric result rows that can be graphed | Saving PNG, WebP, JPEG, or CSV evidence of the scenario. |
Letter Mix Ledger |
Counts of A-range, B-range, C-range, and below-C effective courses | Seeing whether the average is driven by one weak bucket or by a broad mix of middle results. |
| JSON output | Summary, rows, input snapshot, guidance, scenario ledger, and warnings | Archiving or comparing runs without losing the assumptions behind them. |
The letter-mix buckets are package rules too. After repeat handling, the tool classifies effective courses into A-range, B-range, C-range, and below-C bands using the rescaled 3.7, 2.7, and 1.7 thresholds. Those buckets are planning labels, not registrar transcript categories.
Courses (one per line) using Course, Credits, Grade.GPA scale max to the scale that should govern the whole run, such as 4.0 or 5.0.Target GPA only if you want the result framed as a gap-to-target calculation.Repeated course policy on Keep highest attempt for a baseline pass, then switch to Count all attempts if you want to test a stricter scenario.Honors bonus per course only when you intentionally want each valid course lifted before the scale cap is applied.Letter Mix Ledger if you need help deciding where improvement would matter most.Calculated GPA is the weighted average for the rows that survived the package rules. The fastest trust check is to compare Parsed course rows, Total credits, and Rows replaced by repeat policy with what you expected before you react to the top-line number. If those support rows are wrong, the average is faithfully summarizing the wrong scenario.
Gap to target GPA should be read as a signed planning number, not as a grade forecast. Positive values mean the current scenario is still short of the target. Negative values mean the current scenario already exceeds it. Very small absolute gaps mean a one-course change, a repeat-policy change, or an honors adjustment may flip the interpretation.
The credit total matters as much as the average. A 4.0 built from a three-credit scenario is more volatile than a 3.4 built from eighteen credits, because one additional course can move the first result much more sharply. The guidance panel reflects that by explicitly flagging low-credit runs as more sensitive planning cases.
Paste Math, 3, A-, History, 4, B+, and Lab, 1, A on a 4.0 scale with no honors bonus. The quality points are 11.1, 13.2, and 4.0 for a total of 28.3 across 8 credits, so the package reports a GPA of 3.5375. If the target is 3.50, the gap is -0.0375, which means the scenario is already slightly above the target rather than still chasing it.
Now try Biology, 4, C, Biology, 4, A-, and Chemistry, 3, B on the same 4.0 scale. With Keep highest attempt, the effective rows are the A- Biology attempt and the B in Chemistry, giving 23.8 quality points over 7 credits for a GPA of 3.4000. With Count all attempts, all three rows stay in the math, producing 31.8 quality points over 11 credits for a much lower GPA of about 2.8909. The package makes that policy difference immediately visible in both the warning row and the numeric totals.
Set the scale to 5.0, add an honors bonus of 0.5, and paste AP English, 3, A- plus Honors Physics, 4, B+. The rescaled A- would be 4.625 before the bonus, so the package lifts it to 5.125 and then caps it at 5.0. The rescaled B+ becomes 4.125 before bonus and 4.625 after bonus. That produces 33.5 quality points across 7 credits, or a GPA of about 4.7857. The example shows why the scale cap matters: the honors rule can boost a course, but it cannot push it past the chosen maximum.
No. It calculates one GPA from the pasted course list only. There is no field for prior cumulative credits or prior cumulative GPA in this bundle.
It matches repeats by the lowercased course name text. If the same class is entered once as Biology I and once as BIO 101, the package will treat them as different courses unless you make the names match.
This bundle does not have a separate pass-fail exclusion rule. A pasted P resolves to 0.0 on the 4.0 base map, so you should confirm that behavior matches your use case before treating the result as policy-accurate.
No. It is descriptive only. The label is added to exported input context and JSON output, but the GPA calculation is driven by the course rows, scale, target, repeat rule, and honors bonus.
The GPA arithmetic runs in the browser and the tool bundle does not include a GPA server helper. The practical privacy caution is the shareable URL state, which can reflect changed inputs in browser history or copied links.