# poseconnect
Tools for constructing 3D pose tracks from multi-camera 2D poses
## Installation
To install both the Python library and the command line interface, launch a
Python virtual environment (optional, but recommended) and then install via
`pip`:
```
pip install poseconnect
```
## Command line interface
The command line interface consists of a single command (`poseconnect`) with
four subcommands:
* `reconstruct` takes a file of 2D pose data and a file of camera calibration info as inputs and outputs a file of 3D pose data
* `track` takes a file of 3D pose data as input and outputs a file of 3D pose data with track IDs
* `interpolate` takes a file of 3D pose data with track IDs as input and fills time gaps in each track with linearly interpolated poses
* `identify` takes a file of 3D pose data with track IDs and a file of location sensor data with person IDs and outputs a file of 3D pose data with track and person IDs
* `overlay` takes a file of 2D or 3D pose data and a source video for the data and outputs a video with the poses overlaid
### Help
Overall help is available at `poseconnect --help` and help for each subcommand
(including usage and a list of options) is available at `poseconnect SUBCOMMAND
--help` (e.g., `poseconnect reconstruct --help`).
### Data formats
More information about input and output data file formats is available [here](https://github.com/WildflowerSchools/poseconnect/blob/master/docs/data_formats.md).
### Demo
To see the command line interface in action, download and unzip the following sample JSON data files to your current directory and run the [demo shell script](https://github.com/WildflowerSchools/poseconnect/blob/master/scripts/poseconnect_demo.sh):
* [2D pose data](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_pose_2d_data.zip)
* [Camera calibration info](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_camera_calibration_info.zip)
* [Sensor data](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_sensor_data.zip)
Raw data
{
"_id": null,
"home_page": "https://github.com/WildflowerSchools/poseconnect",
"name": "poseconnect",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "pose reconstruction, pose tracking",
"author": "Theodore Quinn",
"author_email": "ted.quinn@wildflowerschools.org",
"download_url": "https://files.pythonhosted.org/packages/fe/c1/89a5f02c6af4b9cd64b048d9c193bf754d72b5921ba84fb551d329de5180/poseconnect-0.17.2.tar.gz",
"platform": null,
"description": "# poseconnect\n\nTools for constructing 3D pose tracks from multi-camera 2D poses\n\n## Installation\n\nTo install both the Python library and the command line interface, launch a\nPython virtual environment (optional, but recommended) and then install via\n`pip`:\n\n```\npip install poseconnect\n```\n\n## Command line interface\n\nThe command line interface consists of a single command (`poseconnect`) with\nfour subcommands:\n\n* `reconstruct` takes a file of 2D pose data and a file of camera calibration info as inputs and outputs a file of 3D pose data\n* `track` takes a file of 3D pose data as input and outputs a file of 3D pose data with track IDs\n* `interpolate` takes a file of 3D pose data with track IDs as input and fills time gaps in each track with linearly interpolated poses\n* `identify` takes a file of 3D pose data with track IDs and a file of location sensor data with person IDs and outputs a file of 3D pose data with track and person IDs\n* `overlay` takes a file of 2D or 3D pose data and a source video for the data and outputs a video with the poses overlaid\n\n### Help\n\nOverall help is available at `poseconnect --help` and help for each subcommand\n(including usage and a list of options) is available at `poseconnect SUBCOMMAND\n--help` (e.g., `poseconnect reconstruct --help`).\n\n### Data formats\n\nMore information about input and output data file formats is available [here](https://github.com/WildflowerSchools/poseconnect/blob/master/docs/data_formats.md).\n\n### Demo\n\nTo see the command line interface in action, download and unzip the following sample JSON data files to your current directory and run the [demo shell script](https://github.com/WildflowerSchools/poseconnect/blob/master/scripts/poseconnect_demo.sh):\n\n* [2D pose data](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_pose_2d_data.zip)\n* [Camera calibration info](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_camera_calibration_info.zip)\n* [Sensor data](https://wildflower-tech-public.s3.us-east-2.amazonaws.com/poseconnect/sample_sensor_data.zip)\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Tools for constructing 3D pose tracks from multi-camera 2D poses",
"version": "0.17.2",
"project_urls": {
"Homepage": "https://github.com/WildflowerSchools/poseconnect"
},
"split_keywords": [
"pose reconstruction",
" pose tracking"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "04d48e62a9061b0bc94b6bd3e48051675dd8a4f646c7b848317a60807ccf34eb",
"md5": "670574ca648501491535accccfc0b44e",
"sha256": "357c145b9f9efd80663b0aa807efdaa9ea932df52a69e068ea7d848d25f2599c"
},
"downloads": -1,
"filename": "poseconnect-0.17.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "670574ca648501491535accccfc0b44e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 40044,
"upload_time": "2024-03-27T16:32:43",
"upload_time_iso_8601": "2024-03-27T16:32:43.531817Z",
"url": "https://files.pythonhosted.org/packages/04/d4/8e62a9061b0bc94b6bd3e48051675dd8a4f646c7b848317a60807ccf34eb/poseconnect-0.17.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fec189a5f02c6af4b9cd64b048d9c193bf754d72b5921ba84fb551d329de5180",
"md5": "3f7037038327a42c6509e951f8fd0061",
"sha256": "f9f4e2cb91a9f8dd47f80040b1131b6b6c832d3e14365d124f942336554f5d24"
},
"downloads": -1,
"filename": "poseconnect-0.17.2.tar.gz",
"has_sig": false,
"md5_digest": "3f7037038327a42c6509e951f8fd0061",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 37687,
"upload_time": "2024-03-27T16:32:45",
"upload_time_iso_8601": "2024-03-27T16:32:45.759703Z",
"url": "https://files.pythonhosted.org/packages/fe/c1/89a5f02c6af4b9cd64b048d9c193bf754d72b5921ba84fb551d329de5180/poseconnect-0.17.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-27 16:32:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "WildflowerSchools",
"github_project": "poseconnect",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "poseconnect"
}
JSON
