# Motion Planning Scenes
Motion planning consists of finding a path from a state A to a goal state B
while avoiding obstacles.
There is a wide range of motion planning libraries that focus mostly on motion
planning problems formulated in the configuration space
[OMPL](https://ompl.kavrakilab.org/). This approach is usually based on inverse
kinematics to transform real-world goals into suitable configurations.
This repository formulates a generic motion planning scene, including both
moving and static obstacles and a generic formulation of goals.
## Obstacles
Obstacles are split into dynamic and static obstacles. Dynamic obstacles are
further split into movable and fixed obstacles. Movable obstacles can be pushed
by robots while fixed ones act as walls or static parts of the environment.
## Goals
Goals for motion planning should not depend on the robot's structure, neither should they
involve orientation that are generally hard to obtain and hardly human understandable.
## Installation
I have decided to change the name of the package on pypi to `mpscenes` as it
seems more convenient a name. Early versions were published under the name
`motion_planning_scenes`.
```bash
pip3 install .
```
or
```bash
pip3 install mpscenes
```
## Poetry
This package is build using [poetry](https://python-poetry.org/docs/).
Poetry generates a virtual environment automatically.
If you have poetry installed you can test it through:
```bash
poetry install
poetry shell
```
Then you are in a virtual environment in which you can test this specific package.
Read more about poetry on the [documentation website](https://python-poetry.org/docs/).
Raw data
{
"_id": null,
"home_page": "https://github.com/maxspahn/motion_planning_scenes.git",
"name": "mpscenes",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Max",
"author_email": "m.spahn@tudelft.nl",
"download_url": "https://files.pythonhosted.org/packages/8f/4b/032f8ed3892392534feb528ee999070a871e29fcdcbb8db2997a1d957e85/mpscenes-0.4.6.tar.gz",
"platform": null,
"description": "# Motion Planning Scenes\n\nMotion planning consists of finding a path from a state A to a goal state B\nwhile avoiding obstacles.\n\nThere is a wide range of motion planning libraries that focus mostly on motion\nplanning problems formulated in the configuration space\n[OMPL](https://ompl.kavrakilab.org/). This approach is usually based on inverse\nkinematics to transform real-world goals into suitable configurations. \n\nThis repository formulates a generic motion planning scene, including both\nmoving and static obstacles and a generic formulation of goals.\n\n## Obstacles\n\nObstacles are split into dynamic and static obstacles. Dynamic obstacles are\nfurther split into movable and fixed obstacles. Movable obstacles can be pushed\nby robots while fixed ones act as walls or static parts of the environment.\n\n## Goals\n\nGoals for motion planning should not depend on the robot's structure, neither should they\ninvolve orientation that are generally hard to obtain and hardly human understandable.\n\n## Installation\n\nI have decided to change the name of the package on pypi to `mpscenes` as it\nseems more convenient a name. Early versions were published under the name\n`motion_planning_scenes`.\n\n```bash\npip3 install .\n```\nor\n```bash\npip3 install mpscenes\n```\n\n## Poetry\nThis package is build using [poetry](https://python-poetry.org/docs/). \nPoetry generates a virtual environment automatically.\nIf you have poetry installed you can test it through:\n```bash\npoetry install\npoetry shell\n```\nThen you are in a virtual environment in which you can test this specific package.\nRead more about poetry on the [documentation website](https://python-poetry.org/docs/).\n",
"bugtrack_url": null,
"license": "",
"summary": "Generic motion planning scenes, including goals and obstacles.",
"version": "0.4.6",
"project_urls": {
"Homepage": "https://github.com/maxspahn/motion_planning_scenes.git",
"Repository": "https://github.com/maxspahn/motion_planning_scenes.git"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "43269decbe21c7a919f0d739e73c2bcfe9af9de21fae9f9d6fcbf99219ad38e4",
"md5": "d91a6ed4e6b048d5e66feb17f9fd2973",
"sha256": "e679712ec60c16c8a9b8a19c806fb684e0f331e4d2a85ec6db1d2e527901d220"
},
"downloads": -1,
"filename": "mpscenes-0.4.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d91a6ed4e6b048d5e66feb17f9fd2973",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 48605,
"upload_time": "2023-12-06T23:23:37",
"upload_time_iso_8601": "2023-12-06T23:23:37.017310Z",
"url": "https://files.pythonhosted.org/packages/43/26/9decbe21c7a919f0d739e73c2bcfe9af9de21fae9f9d6fcbf99219ad38e4/mpscenes-0.4.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8f4b032f8ed3892392534feb528ee999070a871e29fcdcbb8db2997a1d957e85",
"md5": "2dc75857bc86d312bfcd5c32e1b9585f",
"sha256": "4d2877edd271ec09703c199cde33e47f6a10e0b449bafe93ff06a7180c7bb9b4"
},
"downloads": -1,
"filename": "mpscenes-0.4.6.tar.gz",
"has_sig": false,
"md5_digest": "2dc75857bc86d312bfcd5c32e1b9585f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 38051,
"upload_time": "2023-12-06T23:23:38",
"upload_time_iso_8601": "2023-12-06T23:23:38.750034Z",
"url": "https://files.pythonhosted.org/packages/8f/4b/032f8ed3892392534feb528ee999070a871e29fcdcbb8db2997a1d957e85/mpscenes-0.4.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-06 23:23:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maxspahn",
"github_project": "motion_planning_scenes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mpscenes"
}
JSON
