RoboDog SDK
Python SDK for AlphaDog robotic dog control.
Installation
pip install robodog
Quick Start
- Ensure your computer is on the same network as the robotic dog
- Note the IP address of the robotic dog (default: 10.10.10.10)
Basic Example
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
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
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
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:
# 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:
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
Metadata
Release files for robodog 0.1.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| robodog-0.1.2.5.tar.gz | 11.2 kB | Without provenance | Details for robodog-0.1.2.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| robodog-0.1.2.5-py3-none-any.whl | Python 3 | none | any | Details for robodog-0.1.2.5-py3-none-any.whl |
Total release size: 22.6 kB
Release files / robodog-0.1.2.5.tar.gz
| Download URL | robodog-0.1.2.5.tar.gz |
|---|---|
| Size | 11.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a2d65a93b9a81df3cbab31fb8de9e007b52c0c4782f99fd41db4cff98cb990da
|
|
BLAKE2b-256 checksum How to use checksums |
544592244ab8d1112d3665bdde17cbae619119044a8a717c325d84e967d6052d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.9.21
|
Release files / robodog-0.1.2.5-py3-none-any.whl
| Download URL | robodog-0.1.2.5-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4776d392c5b1a0f6ae67f423526f1cf62a7aebf2027d62a6410219655a200a8e
|
|
BLAKE2b-256 checksum How to use checksums |
a9ae24e75224a8b5f0cda991f1a4256139327bce995b3bc307e281bd953613ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.9.21
|
Security for robodog 0.1.2.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.