GPA & Academic Tools — the full guide

1. What these tools do

The Academic Tools layer turns everything you do on CampusTutor — studying topics, doing quizzes, sitting Course Tests and Exam Simulations — into a real-time prediction of where your GPA is heading. Then it lets you run "what if" scenarios so you can see, before the semester ends, where your effort would matter most.

The pieces:

• Readiness Score per course (0–100) — how prepared you are right now, weighted by AOC, mastery, and days-to-exam.
• GPA forecast — predicted GPA for the current semester, broken into six factors so you can see why.
• CGPA prediction — projected cumulative GPA combining this semester with your archived history.
• What-If simulator — drag your predicted scores up or down per course and watch the GPA respond.
• Academic risk view — courses flagged as Low, Moderate, or High risk with the specific reason for each flag.
• Academic identity — your level, semester, promotion history, and degree-class projection.

2. Plans & access

3. Your academic profile

Everything downstream depends on your academic profile. Open the Academic Context Bar at the top of your dashboard (the little pill that says e.g. "University of Lagos · 200L · Second Semester") to view and edit it.

The profile stores:

• Institution type — University, Polytechnic, or College of Education.
• Institution name — your specific school.
• Department & faculty — used to recommend courses and shape AI examples.
• Current level — 100L–500L for university, ND1–HND2 for polytechnic, NCE1–NCE3 for COE.
• Current semester — First or Second.
• Program type (postgrad only) — Masters / PhD, plus dissertation phase (Proposal / Drafting / Submission / Viva) and research area.

4. The 5-point grading scale

CampusTutor uses the standard Nigerian 5-point grading scale across university, polytechnic ND/HND, and College of Education NCE programmes:

GPA is computed as (sum of (grade point × credit units)) ÷ (sum of credit units). CGPA averages all completed semesters using the same formula across them all.

5. The Readiness Score

Every course on your dashboard shows a small Readiness Ring — a circular progress indicator with a number (0–100) inside and a colour band:

• Ready (75+) — you're where you want to be. Maintain.
• Good (60–74) — solid foundation, room to push.
• Caution (40–59) — visible gap. Focus here next.
• At Risk (under 40) — significant work to do. Don't skip.

Readiness combines three signals: topic coverage(how much of the syllabus you've actually studied), mastery(how well you've understood what you covered), and days-to-examif you've set an exam date. AOC topics are weighted more heavily than non-AOC topics so the score reflects exam-relevance, not raw effort.

6. Topic mastery

Mastery is per-topic, not per-course. Each topic accumulates a Mastery Score (0–100) from your activity on it:

• Topic sessions (Tutor Mode) — Understanding Check results, completion of the consolidate phase.
• Topic Quizzes, Course Tests, Exam Simulations — weighted by question difficulty and type (long-answer correct moves mastery more than an MCQ correct).
• Adaptive ability — a parallel skill estimate from the adaptive engine that feeds into the GPA forecast.

Course mastery is the credit-unit-weighted average of topic mastery across all topics in that course. See the AI Tutor manual for how individual topic mastery is calculated.

7. The 6-factor GPA forecast

The headline GPA prediction on your dashboard comes from a 6-factor model. Each factor has a fixed weight; together they sum to 1.0:

For each course, you can tap the Factor Breakdown view to see your score on each of the six factors. This is what tells you whya course is sitting at a B and not an A — "adaptive ability is strong, but structured-answer average is dragging you because you haven't done essay practice."

8. CGPA prediction

Your CGPA predictioncombines your current-semester GPA forecast with any archived semester results you've stored. From the dashboard, tap your Academic Context pill and choose the History tab to view and edit archived semesters.

The output shows:

• Projected current-semester GPA — the 6-factor forecast.
• Projected CGPA — weighted across all semesters.
• Projected degree class — First, 2:1, 2:2, Third, or At Risk.
• Confidence indicator — how reliable the prediction is, given how much data you've fed it.

9. The What-If simulator

From the dashboard, open the GPA Simulatorto ask "what if I improve in MTH 201 by 10 points?" The simulator runs a pure projection — no data is written, you can play freely.

How to use it:

1. The simulator opens with your current course list and predicted scores.
2. Drag a slider (or type a number) to adjust the predicted score on any course up or down.
3. The simulator instantly recomputes your projected GPA and shows the delta compared to your current forecast.
4. It also flags the most impactful course — the one where a small score change moves your GPA the most. This is almost always the course with the highest credit units, lowest current score, or both.

10. Academic risk view

Open /academic-risk for the dedicated risk-overview screen. Courses are sorted into three bands:

• LOW — predicted A or B, no action required.
• MODERATE — predicted C, some risk of dropping. Specific actions suggested.
• HIGH — predicted D or F, urgent attention needed. The view shows the specific reason (low coverage, weak structured answers, no practice in last 14 days, etc.).

Every High and Moderate row has a What to do next link that takes you straight to the specific topics in Tutor Mode that need work.

11. Promoting to the next semester

When your current semester ends, you can promote — moving on to the next semester and archiving the current one as part of your history. Tap your Academic Context pill, choose the Promote tab, and confirm.

What happens on promotion:

• If you were in Second Semester, your level advances by 100 (e.g. 200L → 300L) and you reset to First Semester.
• If you were in First Semester, the level stays the same and you move to Second Semester.
• A summary snapshot of your stats from the semester (GPA, courses completed, average mastery, total study hours) is archived.
• Your course list clears so you can add the new semester's courses fresh.

12. Academic history

The History tab shows every archived semester in chronological order. For each entry you can:

• View the summary snapshot.
• Edit the GPA and credit units (in case your transcript came in differently than expected).
• Delete entries that shouldn't be there.

Edited entries are factored into CGPA prediction the next time it runs. You don't need to re-run anything manually.

13. Consistency, streaks & accountability

Practice consistency is one of the six GPA factors (10% weight). It's calculated from three sub-metrics:

• Current streak — consecutive days where you completed at least one study session. The streak resets at midnight if you miss a day.
• Longest streak — your personal best, kept as a permanent trophy.
• Completion rate — of the topic sessions you started, how many you finished. Quitters drift down; finishers drift up.
• Consistency index — measures regularity: studying for 30 minutes every day beats cramming for 4 hours once a week.

14. University, polytechnic, COE differences

The same scale and tools apply across institution types, but a few details differ:

• University: Levels 100L–500L (or Postgraduate). Standard 5-point GPA scale. Degree-class projection: First / 2:1 / 2:2 / Third / Pass.
• Polytechnic: ND1, ND2, HND1, HND2. Same 5-point GPA scale, same class names. Continuous Assessment carries a larger weight in some polytechnic programmes — CampusTutor surfaces a separate CA Readiness card for this.
• College of Education: NCE1, NCE2, NCE3. Same 5-point scale. Dual-subject specialisation (e.g. Biology/Chemistry) is recognised — courses tag to your subject combination.

15. How to get maximum results

1. Fill the profile fully. Institution type, level, semester, department, credit units per course. Every missing field is a less accurate prediction.
2. Enter past semester GPAs into History. Without history, CGPA prediction has nothing to anchor on. Five minutes of setup makes the projection trustworthy.
3. Set credit units correctly for every course. This is the #1 source of GPA prediction errors. Double-check against your course allocation form.
4. Set AOC weekly. AOC topics get higher weight in Readiness, which feeds GPA forecast. Skipping AOC is leaving prediction accuracy on the table.
5. Run the simulator on Sundays. 10 minutes weekly: see your projected GPA, find the most impactful course, and plan the week's study around it.
6. Check the risk view before each Course Test. If a course you're about to test is in the Moderate or High band, fix the highest-impact factor first.
7. Don't neglect structured answers. 20% of the GPA forecast comes from short/long answer practice. Students who only do MCQs leave a fifth of the prediction unbuilt.
8. Keep your streak alive. 20 minutes a day for 14 days beats one 5-hour session followed by a week off. Consistency compounds.

16. FAQ

How accurate is the GPA prediction?

Accuracy improves with data. With one or two assessments completed, the prediction is rough (confidence: Low). With ten or more assessments across all courses and a few weeks of study activity, confidence rises to Medium or High. The prediction is most accurate in the final third of the semester — by then the model has seen how you actually perform under real conditions.

Why did my GPA prediction drop after I did well on a quiz?

A single quiz only adjusts one of six factors. If you scored well on an MCQ-only Topic Quiz but your structured-answer average dropped because you submitted a weak long-answer in another assessment, the structured-answer factor weighs heavier on the headline number than the MCQ accuracy. Open the Factor Breakdown view to see which factor moved.

Can I export my GPA forecast as a PDF for my parents/sponsors?

Not yet — PDF export of the forecast is on the roadmap. For now, you can screenshot the dashboard or the Factor Breakdown view.

What happens to my readiness if I haven't opened a course in weeks?

Mastery slowly decays over time to model real-life forgetting — if you haven't practised a topic in 21+ days, its mastery drifts down by a small amount per week. This is intentional: it nudges you back to topics you've forgotten and keeps the GPA prediction realistic.

I think the prediction is wrong. Can I dispute it?

The numbers come from your activity — they reflect what you've done on CampusTutor, not external work. If your lecturer's scoring structure is very different from the 5-point scale, or if you're doing major study outside the platform, the prediction will be less accurate. Email info@campustutor.ngwith details and we'll help interpret what you're seeing.

Do these tools work for postgraduate students?

Yes. Postgrad students also get a Dissertation Progress card on the dashboard that tracks proposal, drafting, submission, and viva phases alongside the standard GPA forecast. The 5-point scale still applies for taught courses; dissertation progress is tracked separately.