About traceIt.

Understanding how attendance is calculated

Critical Calculation Rules

Unmarked Classes Count as Absent

If a class has occurred and you haven't marked it, it's automatically counted as absent in your attendance percentage. This is the most important rule to remember. Mark your attendance regularly to maintain accurate records.

Upcoming Classes Don't Count

Classes that haven't occurred yet are automatically excluded from attendance calculations, even if you manually set their status. Only classes that have already happened (past dates) or are happening today (if the class start time has passed) are counted. This ensures your percentage reflects only actual classes that have taken place.

How Classes Are Counted

Weekdays Only

Saturday and Sunday are automatically excluded from all attendance calculations. Only weekdays (Monday through Friday) within your semester date range are considered.

Lab vs Lecture Weighting

Different class types are weighted differently in calculations:

  • Lab sessions: Always count as 1 session regardless of duration. A 2-hour lab counts as 1 session.
  • Lecture sessions: Count per hour based on duration. A 2-hour lecture counts as 2 sessions, a 1-hour lecture counts as 1 session.

Holidays Are Completely Excluded

Classes marked as holidays are completely excluded from attendance calculations. They don't count as attended, absent, or total classes. They're simply ignored in all calculations.

Customizable Rules

Mark Entire Day

Use the "Mark Entire Day" button (calendar icon) in the left panel to quickly mark all classes on a specific day with the same status. This is useful when you know you were absent or present for the entire day. Select the date and status, then confirm. All classes scheduled for that day will be marked accordingly.

Mass Bunks

When multiple students bunk a class together, you can choose how it's counted:

  • Present: Counts as attended, boosting your percentage
  • Absent: Counts as absent, realistic but lowers percentage
  • Exclude: Not counted in total classes or attendance, completely ignored

Teacher Absent

When a teacher is absent, you can configure how it affects your attendance:

  • Present: Counts as attended, doesn't affect your percentage negatively
  • Absent: Counts as absent, affects your percentage
  • Exclude: Not counted in calculations, completely ignored

Include Labs in Overall Percentage

By default, lab sessions are included in your overall attendance percentage. You can toggle this off to calculate overall attendance based only on lectures, while lab attendance is tracked separately per subject.

Creating and Editing Your Timetable

Creating a New Timetable

You have three ways to create your timetable:

  • Manual Creation: Click on empty cells in the timetable grid to add classes. Fill in subject code, subject name, and select whether it's a lecture or lab.
  • Community Templates: Browse templates shared by other students. Click "Show Templates" to view available templates. Select a template to load it into your timetable, then customize as needed.
  • AI Image Extraction (Beta): Upload an image of your timetable (screenshot or photo). The AI will automatically extract subject codes, names, timings, and days. Review and edit the extracted information before saving.

Set your semester start and end dates, timetable name, semester name, and section before creating. These dates determine which classes are counted in attendance calculations.

Sharing Templates: After creating your timetable, you can share it with the community. Click the share button, fill in the template name, and optionally add your name. Other students can then browse and use your template when creating their timetables.

Edit Mode: Modifying Your Timetable

Click the "Edit" button above your timetable to enter edit mode. In edit mode, you can modify your timetable structure:

  • Editing a Slot: Click once on a slot to select it (highlighted in yellow), then click again to edit it. You'll see input fields for subject name and subject code, plus buttons to toggle between lecture and lab types.
  • Adding a Slot: Click on any empty cell (dashed border) to open the add dialog. Fill in subject code, subject name, and select lecture or lab type.
  • Deleting a Slot: While editing a slot, click the trash icon button. Alternatively, if you click on an empty slot (one with no subject code or name) while editing it, it will be automatically deleted.
  • Saving Changes: Changes are saved automatically as you edit. Click the checkmark button or click outside the editing slot to finish editing. Click "Exit Edit" to leave edit mode.

Merging Slots: Creating Multi-Hour Classes

To create classes that span multiple hours (like 2-hour or 3-hour lectures), use the merge feature in edit mode:

  1. Click the "Edit" button to enter edit mode.
  2. Click on a slot to select it, then click again to edit it.
  3. If the next time slot is empty, click the "Merge" button to extend the slot.
  4. The slot will now span multiple hours. You can merge multiple consecutive hours as long as the next cell is empty.

Merged slots are counted as multiple sessions in attendance calculations based on their duration.

Slot Types and Merging

When creating or editing a slot, you can specify whether it's a lecture or lab. Lectures count per hour in attendance calculations (a 2-hour lecture counts as 2 sessions), while labs always count as 1 session regardless of duration (a 2-hour lab counts as 1 session).

To create multi-hour classes (like 2-hour or 3-hour lectures), use the merge feature in edit mode: Click "Edit", then click on a slot to select and edit it. If the next time slot is empty, click the "Merge" button to extend the slot. You can merge multiple consecutive hours as long as the next cell is empty. Merged slots are counted as multiple sessions based on their duration.

Marking Attendance

Normal Mode: Marking Individual Classes

When not in edit mode, clicking on a class slot opens a dialog where you can mark attendance:

  • Attended: You were present for the class.
  • Absent: You were not present (counts against your attendance).
  • Mass Bunked: Multiple students bunked together. How this is counted depends on your settings.
  • Teacher Absent: The teacher was absent. How this is counted depends on your settings.
  • Holiday: The class didn't happen due to a holiday. Completely excluded from calculations.

Navigate through weeks using the week selector arrows or "TODAY" button. Each class slot shows its current status with a colored badge. Unmarked classes that have occurred are automatically counted as absent.

Bulk Marking: Marking Entire Days

Use the "Mark Entire Day" button (calendar icon) to quickly mark all classes on a specific day with the same status. This is useful when you know you were absent or present for the entire day. Select the date and status, then confirm. All classes scheduled for that day will be marked accordingly.

Analytics and Additional Features

Viewing Analytics

Enable analytics in settings to see detailed statistics below your timetable. View your overall attendance percentage, subject-wise breakdowns, weekly trends, heatmap calendar, and identify which subjects need attention. You can also view and share visual summary cards showing your attendance progress.

AI Advisor

Get personalized attendance advice from the AI advisor. Ask questions about your attendance status, improvement strategies, or how many classes you can miss while maintaining your target percentage. The AI has access to your timetable and attendance data to provide contextual advice.

Key Reminders

  • Attendance calculations only include classes that have already occurred. Future classes don't affect your percentage, even if marked.
  • Unmarked classes that have occurred are automatically counted as absent. Mark attendance regularly to maintain accuracy.
  • Your percentage updates in real-time as you mark classes. Calculations respect your settings for mass bunks, teacher absences, and lab inclusion.
  • The semester start and end dates you set determine the calculation range. Only classes within this range are considered.