{"id":27399269,"url":"https://github.com/legitcoconut/teed-ts","last_synced_at":"2025-04-14T02:56:54.093Z","repository":{"id":268445014,"uuid":"904382281","full_name":"LegitCoconut/TEED-TS","owner":"LegitCoconut","description":"The Touchless Entry-Exit Data Tracking System (TEED-TS)  is a hygienic, non-contact solution designed to monitor entry and exit movements. ","archived":false,"fork":false,"pushed_at":"2025-01-26T10:53:52.000Z","size":457,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T02:56:49.727Z","etag":null,"topics":["arduino","data-tracking","datamonitor","esp32","esp8266","python","sensor","statistics"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LegitCoconut.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-16T19:27:04.000Z","updated_at":"2025-03-25T04:07:20.000Z","dependencies_parsed_at":"2024-12-16T20:35:33.887Z","dependency_job_id":"83911f09-b413-4fc3-bf03-68b52295ef68","html_url":"https://github.com/LegitCoconut/TEED-TS","commit_stats":null,"previous_names":["legitcoconut/teed-ts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LegitCoconut%2FTEED-TS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LegitCoconut%2FTEED-TS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LegitCoconut%2FTEED-TS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LegitCoconut%2FTEED-TS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LegitCoconut","download_url":"https://codeload.github.com/LegitCoconut/TEED-TS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248813786,"owners_count":21165632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","data-tracking","datamonitor","esp32","esp8266","python","sensor","statistics"],"created_at":"2025-04-14T02:56:53.342Z","updated_at":"2025-04-14T02:56:54.082Z","avatar_url":"https://github.com/LegitCoconut.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![screenshots](https://github.com/LegitCoconut/TEED-TS/blob/main/screenshot/teeds.png)\n# 🚪 Touchless Entry-Exit Data Tracking System (TEED-TS)\n\n## 📖 Overview\nThe **Touchless Entry-Exit Data Tracking System (TEED-TS)** is a hygienic, non-contact solution designed to monitor entry and exit movements. It uses **Infrared (IR) sensors**, the **ESP8266 microcontroller**, and **IoT technologies** to provide real-time data tracking while reducing physical contact.\n\nCollected data is visualized through dynamic graphs and stored in CSV format, making it suitable for environments requiring reliable monitoring, such as:\n- 🏥 Hospitals  \n- 🏢 Offices  \n- 🛒 Retail Spaces  \n- 🛡️ Security Zones  \n\n---\n\n## ✨ Features\n- **Touchless Monitoring**: Tracks entry/exit movements using IR sensors.\n- **Real-Time Visualization**: Displays real-time entry/exit counts via animated bar graphs.\n- **Data Logging**: Saves timestamped data in CSV format for analysis.\n- **Hygienic and Efficient**: Reduces human contact and contamination risk.\n- **Scalable**: Can integrate with larger networks or more complex setups.\n\n---\n\n## 🛠️ Components\n\n### 🔩 Hardware\n| Component      | Quantity | Description                              |\n|----------------|----------|------------------------------------------|\n| **IR Sensors** | 4        | Detect interruptions in infrared beams.  |\n| **ESP8266**    | 1        | Microcontroller for data processing.     |\n| **Breadboard** | 1        | For prototyping the circuit.             |\n| **Jumper Wires** | Set     | Connect components to the circuit.       |\n\n### 💻 Software\n1. **Arduino IDE**: For programming the ESP8266 microcontroller.\n2. **Python**: For data processing and visualization.\n   - Libraries used:\n     - `csv`: Handles data logging.\n     - `time` \u0026 `datetime`: For timestamps.\n     - `matplotlib`: For creating animated bar graphs.\n     - `serial`: For serial communication with the ESP8266.\n\n---\n\n## 🚀 How It Works\n\n1. **Initialization**:  \n   - The ESP8266 connects to Wi-Fi to sync the current time from an NTP server.\n\n2. **Detection**:  \n   - IR sensors monitor movements by detecting interruptions in their beams.\n\n3. **Data Processing**:  \n   - The ESP8266 categorizes events as **entry** or **exit** and sends the data to a laptop.\n   - Timestamped data is logged in a CSV file.\n\n4. **Visualization**:  \n   - Real-time bar graphs show ongoing entry/exit counts.\n   - Interval-based graphs provide insights every 5 minutes.\n\n---\n\n## 📊 Results\n\n| **Metric**               | **Performance**                  |\n|---------------------------|-----------------------------------|\n| **Accuracy**              | ~95% in controlled environments. |\n| **Sensor Response Time**  | 0.5 seconds (average).           |\n| **Uptime**                | 100% (during testing).           |\n| **Test Period Data**      | 98 entries, 96 exits (24 hours). |\n\n---\n\n## 🔧 Setup Instructions\n\n### Hardware\n1. Connect IR sensors to the ESP8266 microcontroller.\n2. Use jumper wires and a breadboard for prototyping.\n3. Power the ESP8266 and ensure proper wiring.\n\n### Software\n1. Install **Arduino IDE** and upload the provided client-side code to the ESP8266.\n2. Install Python (3.x) and required libraries using:  \n   ```bash\n   pip install matplotlib pyserial\n    ```\nA practical, precise, and scalable solution for monitoring movements in real-time. This system prioritizes hygiene, efficiency, and data visualization, making it suitable for a variety of environments, including healthcare, retail, and public spaces.\n\n## 🛠️ Future Improvements\n\n- **Replace wired communication with Wi-Fi-based communication**: Enhance connectivity and reduce dependency on physical wiring.\n- **Integrate AI analytics**: Analyze movement trends and predict patterns for smarter decision-making.\n- **Improve sensor calibration**: Mitigate interference caused by environmental factors to enhance accuracy.\n\n## 🏆 Key Benefits\n\n- **Hygienic**: Reduces contact in sensitive environments.\n- **Real-Time Insights**: Provides live tracking for better monitoring.\n- **Scalable**: Adaptable to various use cases, including large-scale deployments.\n\n## 🖼️ Visualization Example\n\n*Include your data visualization example here (e.g., graphs, charts, or images demonstrating real-time tracking).*\n\n## 📚 References\n\n- [Arduino People Counter](#)\n- [Assessing the ESP8266 Wi-Fi Module](#)\n- [A Smart Bidirectional Visitor Counter](#)\n\n## 💡 Conclusion\n\nThe **Touchless Entry-Exit Data Tracking System (TEED-TS)** is designed for environments where hygiene, precision, and efficiency are paramount. Its features and future enhancements ensure adaptability for applications in various sectors, including:\n\n- Healthcare\n- Retail\n- Public spaces\n\n---\n\n### 🚀 How to Run the Python Script\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/your-repo-name.git\n   cd your-repo-name\n   ```\n2. Install required dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. Run the Python script to process and visualize data:\n   ```bash\n   python script_name.py\n   ```\n\n---\n\n### 🔧 System Requirements\n- Python 3.7+\n- Arduino IDE (for microcontroller programming)\n- ESP8266 Wi-Fi Module or equivalent\n- Sensor hardware\n\n---\n\nFeel free to contribute by submitting pull requests or issues!\n\n## Screenshots\n\n![screenshots](https://github.com/LegitCoconut/TEED-TS/blob/main/screenshot/block_diagran.jpg).\n\n![screenshots](https://github.com/LegitCoconut/TEED-TS/blob/main/screenshot/out_csv.jpg)\n\n![screenshots](https://github.com/LegitCoconut/TEED-TS/blob/main/screenshot/out_graph.jpg)\n\n![screenshots](https://github.com/LegitCoconut/TEED-TS/blob/main/screenshot/project.jpg)\n\n\n## Support\n\nFor support, email labzmad44@gmail.com .\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flegitcoconut%2Fteed-ts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flegitcoconut%2Fteed-ts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flegitcoconut%2Fteed-ts/lists"}