PosturePerfection First Release

Outline

We are excited to announce the first full release of PosturePerfection! We have tweaked a few things since v0.4.0 to make your user experience even better, and we have added some guidance on how to use our system.

Features:

• Set an ideal posture
• Receive constant feedback on your actual posture
• Receive notifications on multiple Linux devices when your posture becomes bad
• Tune the system using our intuitive settings menu

See here for our instructions on setting up the notification receiver.

Installation

Pre-built (recommended)

Simply run our installation script (attached as an asset). To download and run installation:

wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v1.0.0/PosturePerfection_install_1.0.0.sh
sh PosturePerfection_install_1.0.0.sh

Source

To build this release from source, checkout this release and follow the instructions provided in the README.md:

# Download the repository
git clone https://github.com/ESE-Peasy/PosturePerfection.git
cd PosturePerfection

# Checkout this release
git checkout v1.0.0

Then follow instructions in the README.md

Final Unstable Release

Outline

PosturePerfection is entering the final phase before the first full release! We've updated the user interface to improve usability and included useful hints on the system's current state. Also added in this release is the notification system, whereby users can run a client on a separate Linux machine to receive notifications from the machine running PosturePerfection

Note: To use the notification receiver client you must build from source. This will be changed in the next release.

Installation

Pre-built (recommended)

Simply run our installation script (attached as an asset). To download and run installation:

wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v0.4.0/PosturePerfection_install_0.4.0.sh
sh PosturePerfection_install_0.4.0.sh

Source

To build this release from source, checkout this release and follow the instructions provided in the README.md:

# Download the repository
git clone https://github.com/ESE-Peasy/PosturePerfection.git
cd PosturePerfection

# Checkout this release
git checkout v0.4.0

Then follow instructions in the README.md

Support for MacOS

Outline

Minor update to allow building from source on Mac. The following steps will allow this:

# Install required dependencies
./scripts/install_dependencies.sh

# Build PosturePerfection
./scripts/build.sh

# Run PosturePerfection
./PosturePerfection

PosturePerfection Prototype

Outline

Feast your eyes on the newest PosturePerfection release, revising the real-time output. The live video input stream is now passed through the pipeline performing pose estimation and posture estimation before displaying the video feed with the detected posture displayed. A settings page has also been included which allows some configuration of the pipeline.

Installation

Pre-built (recommended)

Simply run our installation script (attached as an asset). To download and run installation:

wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v0.3.0/PosturePerfection_install_0.3.0.sh
sh PosturePerfection_install_0.3.0.sh

Source

To build this release from source, checkout this release and follow the instructions provided in the README.md:

# Download the repository
git clone https://github.com/ESE-Peasy/PosturePerfection.git
cd PosturePerfection

# Checkout this release
git checkout v0.3.0

Then follow instructions in the README.md

Live PosturePerfection Pipeline Prototype

Outline

This version provides a preliminary presentation of our PosturePerfection pipeline prototype. It now works with a live video input stream, making use of the webcam. Each frame is now passed through the pipeline with multiple processing steps applied to determine the user's posture. This currently leads to textual output in the new GUI that has also been added in this release.

Installation

Pre-built (recommended)

Simply run our installation script (attached as an asset). To download and run installation:

wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v0.2.0/PosturePerfection_install_0.2.0.sh
sh PosturePerfection_install_0.2.0.sh

Source

To build this release from source, checkout this release and follow the instructions provided in the README.md:

# Download the repository
git clone https://github.com/ESE-Peasy/PosturePerfection.git
cd PosturePerfection

# Checkout this release
git checkout v0.2.0

Then follow instructions in the README.md

Image-based PosturePerfection Prototype

This version supports running PosturePerfection on individual images and graphically labels joints on a human provided in the output. The nodes that are detected to be above a confidence threshold are coloured differently. This release is very basic and does not offer any posture improvement yet, but it lays the groundwork for the remainder of the project. The program reads in the picture called person.jpg and produces the results testimg.jpg

Notes:

• The binary currently relies on the model being located in models/EfficientPoseRT_LITE.tflite relative to the directory from where the binary is executed
• Ensure you install the correct PosturePerfection and opencv build for your architecture and run ldconfig. On the RPi this would be:

  mkdir models && cd models 
  wget https://github.com/ESE-Peasy/PosturePerfection/raw/main/models/EfficientPoseRT_LITE.tflite 
  cd ..
  wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v0.1.0/PosturePerfection_0.1.0_armv7l
  wget https://github.com/ESE-Peasy/PosturePerfection/releases/download/v0.1.0/opencv-4.5.1_armhf.deb
  sudo apt install ./opencv-4.5.1_armhf.deb
  sudo ldconfig
  chmod u+x PosturePerfection_0.1.0_armv7l 
  wget https://github.com/ESE-Peasy/PosturePerfection/raw/main/person.jpg
  ./PosturePerfection_0.1.0_armv7l