ast_monitor 0.5.0__tar.gz

ast_monitor-0.5.0/CHANGELOG.md

@@ -0,0 +1,200 @@
+# Changelog
+
+## [Unreleased](https://github.com/firefly-cpp/AST-Monitor/tree/HEAD)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.4.2...HEAD)
+
+**Closed issues:**
+
+- tcx2gpx problem [\#61](https://github.com/firefly-cpp/AST-Monitor/issues/61)
+
+**Merged pull requests:**
+
+- Bump urllib3 from 2.0.6 to 2.0.7 [\#66](https://github.com/firefly-cpp/AST-Monitor/pull/66) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Bump postcss from 8.4.28 to 8.4.31 in /ast\_monitor/map [\#65](https://github.com/firefly-cpp/AST-Monitor/pull/65) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Bump urllib3 from 2.0.5 to 2.0.6 [\#64](https://github.com/firefly-cpp/AST-Monitor/pull/64) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Update workflow [\#63](https://github.com/firefly-cpp/AST-Monitor/pull/63) ([KukovecRok](https://github.com/KukovecRok))
+
+## [0.4.2](https://github.com/firefly-cpp/AST-Monitor/tree/0.4.2) (2023-10-02)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.4.1...0.4.2)
+
+**Closed issues:**
+
+- Switch to pyqt6 [\#46](https://github.com/firefly-cpp/AST-Monitor/issues/46)
+- Upload activity [\#20](https://github.com/firefly-cpp/AST-Monitor/issues/20)
+- Add real time visualization [\#15](https://github.com/firefly-cpp/AST-Monitor/issues/15)
+
+**Merged pull requests:**
+
+- Fixed route reader, code docs update [\#62](https://github.com/firefly-cpp/AST-Monitor/pull/62) ([alenrajsp](https://github.com/alenrajsp))
+- AST Monitor update [\#60](https://github.com/firefly-cpp/AST-Monitor/pull/60) ([alenrajsp](https://github.com/alenrajsp))
+- docs: add alenrajsp as a contributor for maintenance, and bug [\#58](https://github.com/firefly-cpp/AST-Monitor/pull/58) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add rhododendrom as a contributor for design [\#57](https://github.com/firefly-cpp/AST-Monitor/pull/57) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+
+## [0.4.1](https://github.com/firefly-cpp/AST-Monitor/tree/0.4.1) (2023-09-11)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.4.0...0.4.1)
+
+**Closed issues:**
+
+- Add simple logo [\#47](https://github.com/firefly-cpp/AST-Monitor/issues/47)
+
+**Merged pull requests:**
+
+- Bump certifi from 2023.5.7 to 2023.7.22 [\#56](https://github.com/firefly-cpp/AST-Monitor/pull/56) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Map visualizations update [\#55](https://github.com/firefly-cpp/AST-Monitor/pull/55) ([alenrajsp](https://github.com/alenrajsp))
+- Update README.md [\#54](https://github.com/firefly-cpp/AST-Monitor/pull/54) ([alenrajsp](https://github.com/alenrajsp))
+- add logo [\#53](https://github.com/firefly-cpp/AST-Monitor/pull/53) ([rhododendrom](https://github.com/rhododendrom))
+- Bump aiohttp from 3.8.4 to 3.8.5 [\#52](https://github.com/firefly-cpp/AST-Monitor/pull/52) ([dependabot[bot]](https://github.com/apps/dependabot))
+- docs: update README [\#51](https://github.com/firefly-cpp/AST-Monitor/pull/51) ([zala-lahovnik](https://github.com/zala-lahovnik))
+
+## [0.4.0](https://github.com/firefly-cpp/AST-Monitor/tree/0.4.0) (2023-07-02)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.3.3...0.4.0)
+
+**Merged pull requests:**
+
+- docs: add alenrajsp as a contributor for code [\#50](https://github.com/firefly-cpp/AST-Monitor/pull/50) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- Updated to PyQt6 version + [\#49](https://github.com/firefly-cpp/AST-Monitor/pull/49) ([alenrajsp](https://github.com/alenrajsp))
+
+## [0.3.3](https://github.com/firefly-cpp/AST-Monitor/tree/0.3.3) (2023-06-21)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.3.2...0.3.3)
+
+**Closed issues:**
+
+- Fix docs [\#44](https://github.com/firefly-cpp/AST-Monitor/issues/44)
+- Openant dependency [\#42](https://github.com/firefly-cpp/AST-Monitor/issues/42)
+
+**Merged pull requests:**
+
+- docs: add KukovecRok as a contributor for doc, and bug [\#48](https://github.com/firefly-cpp/AST-Monitor/pull/48) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- Sphinx docs fix \#44 [\#45](https://github.com/firefly-cpp/AST-Monitor/pull/45) ([KukovecRok](https://github.com/KukovecRok))
+- Bump requests from 2.30.0 to 2.31.0 [\#43](https://github.com/firefly-cpp/AST-Monitor/pull/43) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+## [0.3.2](https://github.com/firefly-cpp/AST-Monitor/tree/0.3.2) (2023-01-28)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.3.1...0.3.2)
+
+**Closed issues:**
+
+-  @all-contributors add [\#32](https://github.com/firefly-cpp/AST-Monitor/issues/32)
+
+**Merged pull requests:**
+
+- Include openant in dependency list \(finally available on pypi\) [\#41](https://github.com/firefly-cpp/AST-Monitor/pull/41) ([firefly-cpp](https://github.com/firefly-cpp))
+- Bump certifi from 2022.9.24 to 2022.12.7 [\#40](https://github.com/firefly-cpp/AST-Monitor/pull/40) ([dependabot[bot]](https://github.com/apps/dependabot))
+- docs: add alenrajsp as a contributor for content [\#39](https://github.com/firefly-cpp/AST-Monitor/pull/39) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add firefly-cpp as a contributor for platform [\#38](https://github.com/firefly-cpp/AST-Monitor/pull/38) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add carlosal1015 as a contributor for platform [\#37](https://github.com/firefly-cpp/AST-Monitor/pull/37) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add luckyLukac as a contributor for design [\#36](https://github.com/firefly-cpp/AST-Monitor/pull/36) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add firefly-cpp as a contributor for doc, code, and 2 more [\#35](https://github.com/firefly-cpp/AST-Monitor/pull/35) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add luckyLukac as a contributor for bug, doc, and code [\#34](https://github.com/firefly-cpp/AST-Monitor/pull/34) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- docs: add firefly-cpp as a contributor for bug [\#33](https://github.com/firefly-cpp/AST-Monitor/pull/33) ([allcontributors[bot]](https://github.com/apps/allcontributors))
+- Bump pillow from 9.2.0 to 9.3.0 [\#31](https://github.com/firefly-cpp/AST-Monitor/pull/31) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+## [0.3.1](https://github.com/firefly-cpp/AST-Monitor/tree/0.3.1) (2022-09-15)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.3.0...0.3.1)
+
+**Closed issues:**
+
+- Path error [\#29](https://github.com/firefly-cpp/AST-Monitor/issues/29)
+- Add a short outline/description of each figure in README [\#25](https://github.com/firefly-cpp/AST-Monitor/issues/25)
+
+**Merged pull requests:**
+
+- Small bugifx [\#30](https://github.com/firefly-cpp/AST-Monitor/pull/30) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.3.0](https://github.com/firefly-cpp/AST-Monitor/tree/0.3.0) (2022-09-13)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.2.1...0.3.0)
+
+**Closed issues:**
+
+- Show various TRIMP values on the dashboard [\#21](https://github.com/firefly-cpp/AST-Monitor/issues/21)
+- Add reference/minor documentation for ast-tdl [\#17](https://github.com/firefly-cpp/AST-Monitor/issues/17)
+
+**Merged pull requests:**
+
+- Complete revamp of the AST-Monitor application [\#28](https://github.com/firefly-cpp/AST-Monitor/pull/28) ([luckyLukac](https://github.com/luckyLukac))
+- Update lock file [\#27](https://github.com/firefly-cpp/AST-Monitor/pull/27) ([firefly-cpp](https://github.com/firefly-cpp))
+- Add instructions for install from AUR [\#26](https://github.com/firefly-cpp/AST-Monitor/pull/26) ([carlosal1015](https://github.com/carlosal1015))
+
+## [0.2.1](https://github.com/firefly-cpp/AST-Monitor/tree/0.2.1) (2022-07-22)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.2.0...0.2.1)
+
+**Merged pull requests:**
+
+- Slight digital twin algorithm and GUI improvements [\#24](https://github.com/firefly-cpp/AST-Monitor/pull/24) ([luckyLukac](https://github.com/luckyLukac))
+- Digital twin improvements [\#23](https://github.com/firefly-cpp/AST-Monitor/pull/23) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.2.0](https://github.com/firefly-cpp/AST-Monitor/tree/0.2.0) (2022-07-12)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.1.5...0.2.0)
+
+**Closed issues:**
+
+- Generate tcx/gpx file from sensor data [\#5](https://github.com/firefly-cpp/AST-Monitor/issues/5)
+
+**Merged pull requests:**
+
+- Digital twin implementation [\#22](https://github.com/firefly-cpp/AST-Monitor/pull/22) ([luckyLukac](https://github.com/luckyLukac))
+- Interval data depiction [\#19](https://github.com/firefly-cpp/AST-Monitor/pull/19) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.1.5](https://github.com/firefly-cpp/AST-Monitor/tree/0.1.5) (2022-06-24)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.1.4...0.1.5)
+
+**Merged pull requests:**
+
+- Minor Flake8 changes [\#18](https://github.com/firefly-cpp/AST-Monitor/pull/18) ([luckyLukac](https://github.com/luckyLukac))
+- Training loading and unit tests fix [\#16](https://github.com/firefly-cpp/AST-Monitor/pull/16) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.1.4](https://github.com/firefly-cpp/AST-Monitor/tree/0.1.4) (2022-06-07)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.1.3...0.1.4)
+
+**Closed issues:**
+
+- Screenshot of GUI [\#11](https://github.com/firefly-cpp/AST-Monitor/issues/11)
+
+**Merged pull requests:**
+
+- Update README.md [\#14](https://github.com/firefly-cpp/AST-Monitor/pull/14) ([luckyLukac](https://github.com/luckyLukac))
+- Map addition [\#13](https://github.com/firefly-cpp/AST-Monitor/pull/13) ([luckyLukac](https://github.com/luckyLukac))
+- GUI and code improvements [\#12](https://github.com/firefly-cpp/AST-Monitor/pull/12) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.1.3](https://github.com/firefly-cpp/AST-Monitor/tree/0.1.3) (2022-05-03)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.1.2...0.1.3)
+
+**Merged pull requests:**
+
+- GUI enhancements [\#10](https://github.com/firefly-cpp/AST-Monitor/pull/10) ([luckyLukac](https://github.com/luckyLukac))
+- Redesigned GUI [\#9](https://github.com/firefly-cpp/AST-Monitor/pull/9) ([luckyLukac](https://github.com/luckyLukac))
+- Update README.md [\#6](https://github.com/firefly-cpp/AST-Monitor/pull/6) ([alenrajsp](https://github.com/alenrajsp))
+
+## [0.1.2](https://github.com/firefly-cpp/AST-Monitor/tree/0.1.2) (2022-03-10)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/0.1.1...0.1.2)
+
+**Closed issues:**
+
+- 'ant' module cannot be installed using PIP [\#1](https://github.com/firefly-cpp/AST-Monitor/issues/1)
+
+**Merged pull requests:**
+
+- Small changes in GUI [\#4](https://github.com/firefly-cpp/AST-Monitor/pull/4) ([luckyLukac](https://github.com/luckyLukac))
+- Code refactored to comply with Flake standards [\#3](https://github.com/firefly-cpp/AST-Monitor/pull/3) ([luckyLukac](https://github.com/luckyLukac))
+- Small bugfix at pyqt-feedback-flow usage [\#2](https://github.com/firefly-cpp/AST-Monitor/pull/2) ([luckyLukac](https://github.com/luckyLukac))
+
+## [0.1.1](https://github.com/firefly-cpp/AST-Monitor/tree/0.1.1) (2022-01-25)
+
+[Full Changelog](https://github.com/firefly-cpp/AST-Monitor/compare/c3527a1296385a84a0b0be4df0e1609527cbac67...0.1.1)
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

ast_monitor-0.5.0/CITATION.cff

@@ -0,0 +1,31 @@
+cff-version: 1.2.0
+title: >-
+  On Deploying the Artificial Sport Trainer into
+  Practice
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: Iztok Fister Jr.
+    name-particle: Iztok
+    family-names: Fister
+    name-suffix: Jr.
+  - given-names: Iztok Fister
+    name-particle: Iztok
+    family-names: Fister
+  - given-names: Andres Iglesias
+    name-particle: Andres
+    family-names: Iglesias
+  - given-names: Akemi Galvez
+    name-particle: Akemi
+    family-names: Galvez
+  - given-names: Suash Deb
+    name-particle: Suash
+    family-names: Deb
+  - given-names: Dušan Fister
+    name-particle: Dušan
+    family-names: Fister
+identifiers:
+  - type: doi
+    value: 10.1109/ISCMI53840.2021.9654817

ast_monitor-0.5.0/HARDWARE_CONFIGURATION.md

@@ -0,0 +1,109 @@
+## Basic AST-Monitor components
+### Adafruit Ultimate GPS HAT for Raspberry Pi
+Please follow the tutorial: [LINK](https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi)
+
+### USB ANT+ stick
+We used the SUUNTU MOVESTICK MINI stick, which did not require any specific hardware configuration.
+You can use the following stick with the openant python library: [LINK](https://github.com/Tigge/openant)
+
+### A five-inch LCD touch screen display
+Please follow the following tutorial for touch calibration instructions: [LINK](https://www.waveshare.com/wiki/5inch_HDMI_LCD)
+
+
+## Configuration of AST-Monitor
+### Installation of Raspberry Pi OS
+An SD card with the minimum capacity of 8 GB is required for the operating system. Before configuring the device itself, you must install Raspberry Pi OS to the SD card using [Raspberry Pi Imager](https://www.raspberrypi.com/software/). As AST-Monitor apart from the touch screen cannot interact with a user, you must enable SSH and input the Wi-Fi SSID and password in Raspberry Pi Imager settings in order to enable remote access to the device.
+
+### Remote access to AST-Monitor
+When the installation of Raspberry Pi OS is sucessfully finished, you must insert the SD card to Raspberry Pi and plug AST-Monitor into a power source. After the boot of the device, you must connect to AST-Monitor using SSH protocol (open-source client [PuTTY](https://www.putty.org/) is recommended on Windows). It is crucial that both AST-Monitor and the device that runs an SSH client are connected to the same Wi-Fi network.
+
+### Calibration of the touch screen
+To enable the touch screen, you have to add the following lines in <i>/boot/config.txt</i>:
+```
+hdmi_group=2
+hdmi_mode=87
+hdmi_cvt 800 480 60 6 0 0 0
+hdmi_drive=1
+dtoverlay=ads7846,cs=1,penirq=25,penirq_pull=2,speed=50000,
+          keep_vref_on=0,swapxy=0,pmax=255,xohms=150,xmin=200,
+          xmax=3900,ymin=200,ymax=3900
+display_rotate=3
+```
+
+Before calibrating the touch screen, additional packages are required. We can obtain and configure them by executing the following two commands:
+```sh
+$ sudo apt-get install xserver-xorg-input-evdev xinput-calibrator
+$ sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf/usr/share/X11/xorg.conf.d/45-evdev.conf
+```
+
+In the next step, we have to create a file, named <i>99-calibration.conf</i> in the directory <i>/usr/share/X11/xorg.conf.d/</i> and paste the following lines into the newly created file:
+```
+Section "InputClass"
+        Identifier      "calibration"
+        MatchProduct    "ADS7846 Touchscreen"
+        Option  "Calibration"   "139 3891 4 3809"
+        Option  "SwapAxes"      "1"
+        Option "EmulateThirdButton" "1"
+        Option "EmulateThirdButtonTimeout" "1000"
+        Option "EmulateThirdButtonMoveThreshold" "300"
+EndSection
+```
+Note: if a touch screen is still not calibrated correctly, please follow calibration instructions: [LINK](https://www.waveshare.com/wiki/5inch_HDMI_LCD).
+
+The touch screen is initially rotated by 180 degrees. To rotate the screen, you have to truncate <i>/etc/xdg/-lxsession/LXDE-pi/autostart</i> file. After doing that, you have to add the following two lines to the file:
+```
+@xrandr -o 2
+@xcompmgr -C -c -o 0.5 -l -19 -t -10 -r 14 -f -O 0.05 -I 0.05
+```
+
+### Installation of AST-Monitor application
+Since Raspberry Pi OS contains some technical limitations, AST-Monitor package cannot be installed directly using <i>pip</i> by executing the following command:
+```sh
+$ pip install ast-monitor
+```
+
+Instead of that, AST-Monitor has to be downloaded manually by cloning the GitHub repository:
+```sh
+$ cd /home/pi/
+$ git clone https://github.com/firefly-cpp/AST-Monitor.git
+```
+
+By using packet managers apt and apt-get, you have to download PyQt5 distribution and additional packages for Raspberry Pi OS:
+```sh
+$ sudo apt-get install python3-pyqt5
+$ sudo apt install python3-pyqt5.qtsvg
+$ sudo apt-get install libatlas-base-dev
+```
+
+Furthermore, you have to download additional packages using pip:
+```sh
+$ pip install geopy
+$ pip install --no-dependencies pyqt-feedback-flow
+$ pip install sport-activities-features
+$ pip install -U numpy
+$ pip install pyusb
+$ pip install adafruit-circuitpython-gps
+```
+
+OBSOLETE: [openant](https://github.com/Tigge/openant) package has to be downloaded and installed manually using these commands:
+```sh
+$ git clone https://github.com/Tigge/openant
+$ cd ./openant/
+$ sudo python setup.py install
+```
+
+### Automatic launch of AST-Monitor on start-up
+In order to enable automatic launch of AST-Monitor application on start-up, the following line has to be appended to <i>/etc/xdg/lxsession/LXDE-pi/autostart</i>:
+```
+@python /home/pi/AST-Monitor/examples/run_example.py
+```
+
+### Automatic launch of scripts for reading GPS and heart rate data
+To automatically launch the scripts that read and parse GPS and heart rate data, the following snippet has to be added to <i>/etc/profile</i>:
+```sh
+cd /home/pi/AST-Monitor/examples
+nohup python /home/pi/AST-Monitor/examples/read_hr_data.py &
+nohup python /home/pi/AST-Monitor/examples/read_gps_data.py &
+```
+
+Since by default, serial port 0 is disabled, you have to enable it by removing the line <i>console=serial0,115200</i> in <i>/boot/cmdline.txt</i>

ast_monitor-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2024 Iztok Fister Jr., et al.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.