NapMap - Sleep Debt Analyzer
Author: Sohraab Singh Dhillon
Institute: NIELIT Chandigarh
Course: Python with Data Science (Summer Training 2025)
ποΈ Project Overview NapMap is an intelligent sleep tracking and visualization tool built using Python with a simple and intuitive Tkinter-based GUI. It allows users to log their daily sleep and wake times, visualize sleep trends, calculate sleep debt, and receive smart feedback to optimize their sleep patterns.
π― Objectives Track daily sleep schedules
Visualize trends in sleep duration
Calculate sleep debt and consistency
Provide personalized feedback for healthier sleep habits
π§° Technologies Used Python 3
Tkinter β GUI interface
Pandas β Data processing
NumPy β Time calculations
Matplotlib & Seaborn β Charts and heatmaps
tkcalendar β Date selection widget
π Features β Log daily sleep and wake times β Visual display of sleep duration over time β Heatmap of bedtime and wake times β Real-time sleep debt and consistency calculation β Smart recommendations for better sleep hygiene β Exportable design for future CSV integration
π How to Run
Install required libraries: pip install pandas numpy matplotlib seaborn tkcalendar
Run the application: main.py Use the form to enter your sleep data. Click on buttons to generate reports and visualizations.
π Example Visuals Line Chart: Sleep hours vs. Date
Heatmap: Bedtime and Wake Time across dates
π Files Included main.py β Main Python script with GUI
sample_sleep_data.csv β Example format for data entry
π Acknowledgements This project was submitted by Sohraab Singh Dhillon as part of the Summer Training Program at NIELIT Chandigarh under the course Python with Data Science (2025).