Skip to main content

Source Robotics Toolbox

License: MIT Issues release

How to install?

pip install SourceRoboticsToolbox

How to use?

This lib was created to simplify the control of your robot with Source robotic line of motor drivers.

Pairing it the with Spectral-BLDC lib allows you to write extremely simple yet capable code for robotic control.

Some features it offers:

  • Sector homing

  • Robot joint mastering/calibration

  • Converting encoder ticks to joint position and speed

  • Converting joint position and speed to encoder ticks

  • Radian 2 degreee, degree 2 radian position and speed manipulation

Skeleton sketch

import SourceRoboticsToolbox

import time



# This is represents encoder ticks where your joint should be at 0 rad

# Usually you know that joint position from your robots DH table / kinematic diagram

Master_position = 14000 

Joint_reduction_ratio = 6 # Joint has reduction ratio of 6:1



Joint = SourceRoboticsToolbox.Joint(encoder_resolution = 14,

                                    master_position=Master_position,

                                    gear_ratio = Joint_reduction_ratio,

                                    offset = 0, #Change If your motor is not at 0 rad at master position 

                                    dir = 0) # Change joint direction



current_motor_encoder_position = 10000 #This emulates the data you would get from your motor encoder

# Init flag; used to run .determine_sector once

Intial = 0



while True:



    # This will give you Joint position in radians 

    # NOTE that joint position is value after the gear reduction of your actuator

    position_values =  Joint.get_joint_position(current_motor_encoder_position)

    print(position_values)



    # This will perform sector homing and determine the sector motor is in

    if Intial ==0 :

        Intial = 1

        Joint.determine_sector(current_motor_encoder_position)



    time.sleep(0.5)

More about our projects

Liability

  1. The software and hardware are still in development and may contain bugs, errors, or incomplete features.

  2. Users are encouraged to use this software and hardware responsibly and at their own risk.

Support the project

The majority of this project is open source and freely available to everyone. Your assistance, whether through donations or advice, is highly valued. Thank you!

General badge

General badge

Project is under MIT Licence

Metadata

Release files for SourceRoboticsToolbox 1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for SourceRoboticsToolbox 1.3
File Size Uploaded Provenance Actions
sourceroboticstoolbox-1.3.tar.gz 5.6 kB Without provenance Details for sourceroboticstoolbox-1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for SourceRoboticsToolbox 1.3
File Interpreter ABI Platform Actions
sourceroboticstoolbox-1.3-py3-none-any.whl Python 3 none any Details for sourceroboticstoolbox-1.3-py3-none-any.whl

Total release size: 11.2 kB

Release files / sourceroboticstoolbox-1.3.tar.gz

Download URL sourceroboticstoolbox-1.3.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
cbeb9ab32a34873eca5e50808480fde62f7e9adbe2977ce3f4eb84416c40bc75
BLAKE2b-256 checksum
How to use checksums
7755d1d986018457fb399af6916d347d96601649c380ec604b01f4b9434a4796
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.0

Release files / sourceroboticstoolbox-1.3-py3-none-any.whl

Download URL sourceroboticstoolbox-1.3-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
afa926a4498862ed20ad9baf7b509f7e2a91928b30b06a24691da9cf140c6c42
BLAKE2b-256 checksum
How to use checksums
b8cdcf8c77f6dbba65fa4b88fd564a8b3e351254daaf8cac8f3676c075f14ea4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.0

Security for SourceRoboticsToolbox 1.3

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page