Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
davidpagnon authored May 9, 2023
1 parent 3423a1d commit 2153050
Showing 1 changed file with 16 additions and 14 deletions.
30 changes: 16 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -169,12 +169,12 @@ Note that your data will be sent to the Google servers, which do not follow the
BlazePose or OpenPose are used to detect joint centers from a video.
If `BlazePose` is used, only one person can be detected.\
No interpolation nor filtering options are available. Not plotting available.
- If `BlazePose` is used, only one person can be detected.\
No interpolation nor filtering options are available. Not plotting available.
If `OpenPose` is used, multiple persons can be consistently detected across frames. A person is matched to another in the next frame when their average point clouds are at a small euclidian distance.\
Sequences of missing data are interpolated if they are less than N frames long.\
Resulting coordinates can be filtered with Butterworth, gaussian, median, or loess filter. They can also be plotted.
- If `OpenPose` is used, multiple persons can be consistently detected across frames. A person is matched to another in the next frame when their average point clouds are at a small euclidian distance.\
Sequences of missing data are interpolated if they are less than N frames long.\
Resulting coordinates can be filtered with Butterworth, gaussian, median, or loess filter. They can also be plotted.
#### Angle computation:
Expand Down Expand Up @@ -219,14 +219,16 @@ I would happily welcome any proposal for new features, code improvement, and mor
If you want to contribute to Sports2D, please follow [this guide](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) on how to fork, modify and push code, and submit a pull request. I would appreciate it if you provided as much useful information as possible about how you modified the code, and a rationale for why you're making this pull request. Please also specify on which operating system and on which python version you have tested the code.
*Here is a to-do list: feel free to complete it:*
- [x] Compute **segment angles**
- [x] **Multi-person** detection, consistent over time
- [x] **Only interpolate small gaps**
- [x] **Filtering and plotting tools**
- [x] Handle sudden **changes of direction**
- [x] **Colab version** for those who cannot install OpenPose
- [ ] Full test on **MacOS**
- [ ] **GUI applications** for Windows, Mac, and Linux, as well as for Android and iOS (minimal version on mobile device, with only BlazePose). Code with [Kivy](https://kivy.org)
- [ ] **Pose refinement**. Click and move badly estimated 2D points. See [DeepLabCut](https://www.youtube.com/watch?v=bEuBKB7eqmk) for inspiration
- [x] Compute **segment angles**.
- [x] **Multi-person** detection, consistent over time.
- [x] **Only interpolate small gaps**.
- [x] **Filtering and plotting tools**.
- [x] Handle sudden **changes of direction**.
- [x] **Colab version** for those who cannot install OpenPose.
- [ ] Full test on **MacOS**.
- [ ] **GUI applications** for Windows, Mac, and Linux, as well as for Android and iOS (minimal version on mobile device, with only BlazePose). Code with [Kivy](https://kivy.org).
- [ ] **Include OpenPose** in Sports2D executable files. [Dockerize](https://github.com/stanfordnmbl/mobile-gaitlab/blob/master/demo/Dockerfile) it?
- [ ] **Track other points and angles** with classic tracking methods (cf. [Kinovea](https://www.kinovea.org/features.html)), or by training a model (cf. [DeepLabCut](https://deeplabcut.github.io/DeepLabCut/README.html)).
- [ ] **Pose refinement**. Click and move badly estimated 2D points. See [DeepLabCut](https://www.youtube.com/watch?v=bEuBKB7eqmk) for inspiration.
- [ ] **Constrain points** to OpenSim skeletal model for better angle estimation (like with [Pose2Sim](https://github.com/perfanalytics/pose2sim), but in 2D.
- [ ] Add tools for annotating images, undistort them, take perspective into account, etc. (cf. [Kinovea](https://www.kinovea.org/features.html)).

0 comments on commit 2153050

Please sign in to comment.