Turn NCEA Level 3 results into a university rank score and a GPA.
Use for: 'convert my NCEA to GPA', 'what is my rank score', 'what rank
score do I need for engineering', 'NCEA entry score', 'preferential entry
score', 'NCEA to 4.0 GPA'.
ASK FOR THEIR RESULTS SUBJECT BY SUBJECT and pass `subjects`. The rank
score is calculated by the universities that use one, not NZQA. The
University of
Auckland (rank score), Massey University (Preferential Entry Score, used
when places are limited) and the University of Otago (entry score) publish
the same method: the best 80 credits over at most five approved subjects,
no more than 24 credits from any one subject, Excellence 4, Merit 3,
Achieved 2, maximum 320. Totals alone cannot apply those limits, so a
totals-only result is an UPPER BOUND (rank_score_is_upper_bound): say so.
40 Excellence in one subject plus 20 Achieved in each of two other
subjects is 240 as totals and 176 per subject. Do not say every
university uses this. AUT counts the 80 best credits, at most 24 per
subject, with no stated five-subject limit, so its score can be higher;
the University of Canterbury does not use NCEA rank scores.
ANSWER WITH THE RANK SCORE EVEN WHEN THEY ASKED FOR A GPA. The 4-point
figure (Excellence 4, Merit 3, Achieved 2, Not Achieved 0, across every
credit entered) is indicative and must be labelled unofficial. If they
need an official figure for an overseas application, NZQA can provide its
own grade point average estimate; tell them to ask NZQA.
THE MOST USEFUL THING YOU CAN TELL THEM IS WHY CREDITS DID NOT COUNT:
credits_over_subject_cap, credits_not_approved, credits_outside_best_five
and credits_outside_best_80. Once 80 credits count, more Achieved credits
are worth nothing and lifting existing credits to Merit is worth a great
deal. next_step says which case they are in; lead with it.
Args:
subjects: PREFERRED. A list of {"name": "Calculus", "approved": true,
"excellence_credits": 10, "merit_credits": 8,
"achieved_credits": 2}, one per Level 3 subject. "approved" means
on NZQA's approved list for University Entrance (default true).
When given, the three totals below must be 0.
excellence_credits: Level 3 Excellence credits as a total (upper
bound only).
merit_credits: Level 3 Merit credits as a total (upper bound only).
achieved_credits: Level 3 Achieved credits as a total (upper bound
only).
not_achieved_credits: Credits attempted and not achieved, in total;
lowers the GPA, never the rank score. Allowed with subjects.
Returns:
The rank score out of 320 with its working shown, which subjects and
credits counted and why the rest did not, an unofficial 4-point GPA,
and what would actually raise the score for this student.