Skip to main content

AST-Monitor is a wearable Raspberry Pi computer for cyclists

Project description

logo.png

AST-Monitor --- A wearable Raspberry Pi computer for cyclists

PyPI Version PyPI - Python Version PyPI - Downloads Fedora package AUR package GitHub license Check codestyle and test build Documentation Status

GitHub commit activity GitHub repo size GitHub contributors All Contributors

DOI DOI

๐Ÿ’ป Graphical User Interface โ€ข โš™๏ธ Hardware โ€ข ๐Ÿ–ฅ๏ธ Software โ€ข ๐Ÿ“ฆ Installation โ€ข ๐Ÿ“ข Deployment โ€ข ๐Ÿš€ Examples โ€ข ๐Ÿ”‘ License โ€ข ๐Ÿ“„ Cite us โ€ข ๐Ÿ“– Further read โ€ข ๐Ÿ”— Related packages โ€ข ๐Ÿ“ References โ€ข ๐Ÿซ‚ Contributors

Welcome to AST-Monitor: Revolutionizing Sport Training Sessions! ๐Ÿ‹๏ธโ€โ™‚๏ธ This repository aims to introduce a low-cost, and efficient embedded device that can transform the way you monitor cycling training sessions. Allow us to present AST-Monitor.

To begin, we invite you to explore the paper that introduces the capabilities of AST-Monitor. Dive into the future of artificial sports trainers by reading this paper. ๐Ÿ“„๐Ÿ’ก

  • Free software: MIT license
  • Python versions: 3.8.x, 3.9.x, 3.10.x, 3.11.x, 3.12.x
  • Documentation: https://ast-monitor.readthedocs.io/en/latest
  • Tested OS: Windows, Ubuntu, Fedora, Alpine, Arch, macOS. However, that does not mean it does not work on others

๐Ÿ’ป Graphical User Interface

Basic data: Power at Your Fingertips ๐Ÿ’ช

AST-GUI

The initial page of the AST-Monitor application presents essential parameters, providing real-time insights into an athlete's performance. Gain access to information such as the athlete's current speed and heart rate. After a training session, you'll also receive a comprehensive overview, including total distance covered, session duration, and total ascent conquered. ๐Ÿ“ฑ๐Ÿšดโ€โ™‚๏ธ

Interactive map: Embark on a Visual Journey ๐Ÿ—บ๏ธ๐Ÿš€

AST-Map

As you navigate uncharted territories, this map reveals your precise location in real-time. And allows you to track your progress on the route in real time. ๐ŸŒ๐Ÿšดโ€โ™‚๏ธ๐Ÿ—บ๏ธ

Interval training data: Unleash Your Inner Athlete ๐Ÿƒโ€โ™€๏ธ๐Ÿ’ช

AST-Intervals

Discover the duration of each phase, track your current heart rate, and marvel at the average heart rate achieved. But that's not allโ€”brace yourself for the Digital Twin proposed heart rate and witness the thrilling difference between your current heart rate and the proposed target. Prepare to dominate your workouts with the AST-Monitor! ๐Ÿ‹๏ธโ€โ™€๏ธ

Interval training plan: Unleash the Potential ๐Ÿ’ฏ๐Ÿ“๐Ÿ’ฅ

AST-Trainings

Load up and embark on thrilling interval trainings that await you in the "AST-Monitor/development/trainings" folder. These trainings, meticulously crafted in the domain-specific language AST-TDL, are designed to take you to the next level. Once successfully loaded, witness the training plan come to life before your eyes. ๐Ÿš€๐Ÿ“‹๐Ÿ’ฅ

โš™๏ธ Hardware

Where Innovation Meets Performance โš™๏ธ๐Ÿ”ฉ๐Ÿ’ก

Prepare to be dazzled by the complete hardware setup featured in AST-Monitor.

AST-Monitor

Let's take a closer look at the components:

  • A platform with fixing straps that securely attach to your bicycle, ensuring a seamless training experience. ๐Ÿšฒ๐Ÿ”’
  • The powerful Raspberry Pi 4 Model B micro-controller, powered by the dynamic Raspbian OS. ๐Ÿ’ป
  • A five-inch LCD touchscreen display, allowing the interaction with AST-Monitor during the training. โœจ๐Ÿ–ฅ๏ธ
  • Equipped with a USB ANT+ stick, AST-Monitor captures the heartbeat of your training, providing crucial data for your journey to greatness. ๐Ÿ“ก
  • Adafruit's Ultimate GPS HAT module joins the lineup, empowering you with location information and paving the way for GPS integration (coming soon!). ๐ŸŒ๐Ÿ›ฐ๏ธ

But that's not all:

A Serial Peripheral Interface (SPI) protocol ensures seamless communication between the Raspberry Pi and the GPS peripheral, guaranteeing accurate and timely data. The screen display, connected using a physically shortened HDMI cable, ensures a sleek and compact design that doesn't compromise performance.

During the testing phase, the AST-Monitor prototype was powered by Trust's 5 VDC power bank, providing unparalleled endurance. While the current prototype may be a bit bulky, rest assured, our team is hard at work, exploring sleeker and more discreet solutions. ๐Ÿ’ช๐Ÿ’ฆ

For those who crave a glimpse inside AST-Monitor:

AST-Monitor

Welcome to the next stage of sports training. Welcome to AST-Monitorโ€”your ultimate companion on the road to victory! ๐ŸŒŸ๐Ÿ†๐Ÿš€

๐Ÿ–ฅ๏ธ Software

Dependencies ๐Ÿ“ฆ๐Ÿ”—

List of dependencies:

Package Version Platform
PyQt6 ^5.15.6 All
matplotlib ^3.5.1 All
geopy ^2.2.0 All
openant ^1.2.0 All
pyqt-feedback-flow ^0.1.0 All
tcxreader ^0.4.1 All
sport-activities-features ^0.3.6 All

Additional note: adafruit-circuitpython-gps package must be installed in order to work with the GPS sensor:

$ pip install adafruit-circuitpython-gps

๐Ÿ“ฆ Installation

Install AST-Monitor with pip:

$ pip install ast-monitor

In case you want to install directly from the source code, use:

$ git clone https://github.com/firefly-cpp/AST-Monitor.git
$ cd AST-Monitor
$ poetry build
$ python setup.py install

To install AST-Monitor on Fedora Linux, please use:

$ dnf install python3-ast-monitor

To install AST-Monitor on Alpine Linux, please use:

$ apk add py3-ast-monitor

To install AST-Monitor on Arch Linux, please use an AUR helper:

$ yay -Syyu python-ast-monitor

๐Ÿ“ข Deployment

Our project was deployed on a Raspberry Pi device using Raspberry Pi OS.

The hardware configuration of AST-Monitor using Raspberry Pi OS is described in HARDWARE_CONFIGURATION.md.

๐Ÿš€ Examples

Basic run

import os
import sys

from PyQt6 import QtWidgets

try:
    from ast_monitor.model import AST
except ModuleNotFoundError:
    sys.path.append('../')
    from ast_monitor.model import AST

# Paths to the files with heart rates and GPS data.
hr_data = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'sensor_data', 'hr.txt')
gps_data = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'sensor_data', 'gps.txt')
route_data = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', 'development', 'routes', 'route.json')

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    window = AST(hr_data, gps_data, route_data)
    window.show()
    sys.exit(app.exec())

๐Ÿ”‘ License

This package is distributed under the MIT License. This license can be found online at http://www.opensource.org/licenses/MIT.

Disclaimer

This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!

๐Ÿ“„ Cite us

Lukaฤ, L., Fister Jr., I., Fister, I. "Digital Twin in Sport: From an Idea to Realization." Applied Sciences 12.24 (2022): 12741, DOI: 10.3390/app122412741.

๐Ÿ“– Further read

[1] Awesome Computational Intelligence in Sports

๐Ÿ”— Related packages/frameworks

[1] sport-activities-features: A minimalistic toolbox for extracting features from sports activity files written in Python

[2] ast-tdl: Training Description Language for Artificial Sport Trainer

๐Ÿ“ References

Fister Jr, I., Fister, I., Iglesias, A., Galvez, A., Deb, S., & Fister, D. (2021). On deploying the Artificial Sport Trainer into practice. arXiv preprint arXiv:2109.13334.

Fister Jr, I., Salcedo-Sanz, S., Iglesias, A., Fister, D., Gรกlvez, A., & Fister, I. (2021). New Perspectives in the Development of the Artificial Sport Trainer. Applied Sciences, 11(23), 11452. DOI: 10.3390/app112311452

๐Ÿซ‚ Contributors

Iztok Fister Jr.
Iztok Fister Jr.

๐Ÿ› ๐Ÿ“– ๐Ÿ’ป ๐Ÿšง ๐Ÿง‘โ€๐Ÿซ ๐Ÿ“ฆ
luckyLukac
luckyLukac

๐Ÿ› ๐Ÿ“– ๐Ÿ’ป ๐ŸŽจ
Oromion
Oromion

๐Ÿ“ฆ
alenrajsp
alenrajsp

๐Ÿ–‹ ๐Ÿ’ป ๐Ÿšง ๐Ÿ›
Tatookie
Tatookie

๐Ÿ“– ๐Ÿ›
rhododendrom
rhododendrom

๐ŸŽจ
Sertonix
Sertonix

๐Ÿ›
Tadej Lahovnik
Tadej Lahovnik

๐Ÿ“– ๐Ÿ’ป ๐Ÿ›

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ast_monitor-0.5.2.tar.gz (111.0 kB view hashes)

Uploaded Source

Built Distribution

ast_monitor-0.5.2-py3-none-any.whl (120.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page