# RoboDog SDK
[English](README.md) | [中文](README_zh.md)
Python SDK for AlphaDog robotic dog control.
## Installation
```bash
pip install robodog
```
## Quick Start
1. Ensure your computer is on the same network as the robotic dog
2. Note the IP address of the robotic dog (default: 10.10.10.10)
### Basic Example
```python
from robodog import Dog
import time
with Dog() as dog:
# Adjust standing height
dog.body_height = 0.25
time.sleep(2)
# Restore default height
dog.set_parameters({'body_height': 0.23})
```
## Parameter Control Features
The SDK provides comprehensive parameter control capabilities:
### 1. Basic Motion Parameters
```python
dog.vx = 0.2 # Forward velocity (-1.0 to 1.0)
dog.vy = 0.1 # Lateral velocity (-1.0 to 1.0)
dog.wz = 0.1 # Rotational velocity (-1.0 to 1.0)
```
### 2. Posture Control
```python
dog.roll = 0.1 # Roll angle (-0.5 to 0.5)
dog.pitch = 0.1 # Pitch angle (-0.5 to 0.5)
dog.yaw = 0.1 # Yaw angle (-0.5 to 0.5)
dog.body_height = 0.25 # Body height (0.1 to 0.35)
```
### 3. Gait Parameters
```python
dog.foot_height = 0.08 # Foot lift height (0.0 to 0.15)
dog.swing_duration = 0.3 # Swing period (0.1 to 1.0)
dog.friction = 0.6 # Friction coefficient (0.1 to 1.0)
```
### 4. Advanced Control Features
Combined parameter settings:
```python
# Set gait parameters
dog.set_gait_params(
friction=0.6, # Friction coefficient
scale_x=1.2, # Support surface X scaling
scale_y=1.0 # Support surface Y scaling
)
# Set motion parameters
dog.set_motion_params(
swaying_duration=2.0, # Swaying period
jump_distance=0.3, # Jump distance
jump_angle=0.1 # Jump rotation angle
)
# Set control parameters
dog.set_control_params(
velocity_decay=0.8, # Velocity decay
collision_protect=1, # Collision protection
decelerate_time=2.0, # Deceleration delay
decelerate_duration=1.0 # Deceleration duration
)
```
## Example Programs
Check out `examples` for a complete demonstration including:
- Basic motion control demo
- Advanced motion parameter adjustment
- Complete parameter configuration showcase
- User mode switching demonstration
Running the example:
```bash
python examples/demo_basic_movement.py
```
### Contributing
Issues and pull requests are welcome. For major changes, please open an issue first to discuss proposed changes.
### License
This project is licensed under the MIT License - see the `LICENSE` file for details.
### Contact
For questions or suggestions:
- Submit GitHub Issues
- Email: <towardsrwby@gmail.com>
Raw data
{
"_id": null,
"home_page": "https://github.com/00make/robodog",
"name": "robodog",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "robotics, alphadog, ros, robot control, python",
"author": "00make",
"author_email": "towardsrwby@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d6/6c/d870bdc02e679c27202b0db72c0e5542c2bbb415171dd41fea4affe41924/robodog-0.1.2.4.tar.gz",
"platform": null,
"description": "# RoboDog SDK\n\n[English](README.md) | [\u4e2d\u6587](README_zh.md)\n\nPython SDK for AlphaDog robotic dog control.\n\n## Installation\n\n```bash\npip install robodog\n```\n\n## Quick Start\n\n1. Ensure your computer is on the same network as the robotic dog\n2. Note the IP address of the robotic dog (default: 10.10.10.10)\n\n### Basic Example\n\n```python\nfrom robodog import Dog\nimport time\n\nwith Dog() as dog:\n # Adjust standing height\n dog.body_height = 0.25\n time.sleep(2)\n \n # Restore default height\n dog.set_parameters({'body_height': 0.23})\n```\n\n## Parameter Control Features\n\nThe SDK provides comprehensive parameter control capabilities:\n\n### 1. Basic Motion Parameters\n\n```python\ndog.vx = 0.2 # Forward velocity (-1.0 to 1.0)\ndog.vy = 0.1 # Lateral velocity (-1.0 to 1.0)\ndog.wz = 0.1 # Rotational velocity (-1.0 to 1.0)\n```\n\n### 2. Posture Control\n\n```python\ndog.roll = 0.1 # Roll angle (-0.5 to 0.5)\ndog.pitch = 0.1 # Pitch angle (-0.5 to 0.5)\ndog.yaw = 0.1 # Yaw angle (-0.5 to 0.5)\ndog.body_height = 0.25 # Body height (0.1 to 0.35)\n```\n\n### 3. Gait Parameters\n\n```python\ndog.foot_height = 0.08 # Foot lift height (0.0 to 0.15)\ndog.swing_duration = 0.3 # Swing period (0.1 to 1.0)\ndog.friction = 0.6 # Friction coefficient (0.1 to 1.0)\n```\n\n### 4. Advanced Control Features\n\nCombined parameter settings:\n\n```python\n# Set gait parameters\ndog.set_gait_params(\n friction=0.6, # Friction coefficient\n scale_x=1.2, # Support surface X scaling\n scale_y=1.0 # Support surface Y scaling\n)\n\n# Set motion parameters\ndog.set_motion_params(\n swaying_duration=2.0, # Swaying period\n jump_distance=0.3, # Jump distance\n jump_angle=0.1 # Jump rotation angle\n)\n\n# Set control parameters\ndog.set_control_params(\n velocity_decay=0.8, # Velocity decay\n collision_protect=1, # Collision protection\n decelerate_time=2.0, # Deceleration delay\n decelerate_duration=1.0 # Deceleration duration\n)\n```\n\n## Example Programs\n\nCheck out `examples` for a complete demonstration including:\n\n- Basic motion control demo\n- Advanced motion parameter adjustment\n- Complete parameter configuration showcase\n- User mode switching demonstration\n\nRunning the example:\n\n```bash\npython examples/demo_basic_movement.py\n```\n\n### Contributing\n\nIssues and pull requests are welcome. For major changes, please open an issue first to discuss proposed changes.\n\n### License\n\nThis project is licensed under the MIT License - see the `LICENSE` file for details.\n\n### Contact\n\nFor questions or suggestions:\n\n- Submit GitHub Issues\n- Email: <towardsrwby@gmail.com>\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python library for controlling AlphaDog robotic dogs",
"version": "0.1.2.4",
"project_urls": {
"Bug Tracker": "https://github.com/00make/robodog/issues",
"Documentation": "https://github.com/00make/robodog/wiki",
"Homepage": "https://github.com/00make/robodog",
"Source Code": "https://github.com/00make/robodog"
},
"split_keywords": [
"robotics",
" alphadog",
" ros",
" robot control",
" python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dd64b6083fb83f4578fa56306b475b36c62354f4baec69dbb998d7d5c4592f8f",
"md5": "bd58282770a6e8201ed5d19e29731dcb",
"sha256": "04171afaf771332846b145b91ccc720a78cf6ae2ebef31bc0d521989dfbc59da"
},
"downloads": -1,
"filename": "robodog-0.1.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bd58282770a6e8201ed5d19e29731dcb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 11312,
"upload_time": "2025-01-18T20:25:20",
"upload_time_iso_8601": "2025-01-18T20:25:20.180039Z",
"url": "https://files.pythonhosted.org/packages/dd/64/b6083fb83f4578fa56306b475b36c62354f4baec69dbb998d7d5c4592f8f/robodog-0.1.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d66cd870bdc02e679c27202b0db72c0e5542c2bbb415171dd41fea4affe41924",
"md5": "693a3ed5c17b4efb58a1951b8fd8c953",
"sha256": "7868c2849ba44a0f319e7bd7bd5c61706bb629da5ba2deef829ede366f3956e0"
},
"downloads": -1,
"filename": "robodog-0.1.2.4.tar.gz",
"has_sig": false,
"md5_digest": "693a3ed5c17b4efb58a1951b8fd8c953",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 11210,
"upload_time": "2025-01-18T20:25:22",
"upload_time_iso_8601": "2025-01-18T20:25:22.358004Z",
"url": "https://files.pythonhosted.org/packages/d6/6c/d870bdc02e679c27202b0db72c0e5542c2bbb415171dd41fea4affe41924/robodog-0.1.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 20:25:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "00make",
"github_project": "robodog",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"2.0.1"
]
]
},
{
"name": "pyserial",
"specs": [
[
">=",
"3.5"
]
]
}
],
"lcname": "robodog"
}