Skip to main content

Kinematics and control utilities for OpenArm

Project description

OpenArm Control

Reusable kinematics and control utilities for OpenArm, backed by MuJoCo and mink.

Install

uv sync

Usage

Kinematics

from openarm_control import Kinematics, IKParams, ArmSetup

# FK only
kin = Kinematics(setup)
pose = kin.fk("right", joints)               # float32[7]
pose_r, pose_l = kin.fk_bimanual(r, l)       # single mj_forward

# IK
kin = Kinematics(setup, IKParams(damping=0.25, posture_cost=0.01))
kin.set_target("right", pose_r)
kin.set_target("left", pose_l)
result = kin.solve(dt=0.1, n_iters=5)        # float32[16] right[8]+left[8]

IKParams

Solver configuration passed to Kinematics. All fields have defaults.

Field Default Description
position_cost 1.0 Position task weight
orientation_cost 1.0 Orientation task weight
lm_damping 0.01 Per-task Levenberg-Marquardt damping
damping 0.25 Global Tikhonov regularization
solver "daqp" QP backend
posture_cost 0.01 Neutral posture task weight (0 = disabled)
diag_reg 0.0 QP diagonal regularization
dt 0.1 Integration timestep per iteration
max_iters 5 IK iterations per solve
velocity_limits None Per-joint velocity limits (applied in rad/s from config.py); None = disabled

Build from CLI args with register_ik_args + ik_params_from_args:

Related links

License

Licensed under the Apache License 2.0. See LICENSE.txt for details.

Copyright 2026 Enactic, Inc.

Code of Conduct

All participation in the OpenArm project is governed by our Code of Conduct.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openarm_control-0.1.0.tar.gz (12.5 kB view details)

Uploaded Source

File details

Details for the file openarm_control-0.1.0.tar.gz.

File metadata

  • Download URL: openarm_control-0.1.0.tar.gz
  • Upload date:
  • Size: 12.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for openarm_control-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e735394534d9fe03a14f9bd616a29564a3b97efa71cf46d48a13ea9d2cca0b22
MD5 8eec1ea3d4563088b230abe007164f4b
BLAKE2b-256 e485f256547069d99aab0b5875a6445971fdf9c4519b1c63f60e86e78f1352f6

See more details on using hashes here.

Provenance

The following attestation bundles were made for openarm_control-0.1.0.tar.gz:

Publisher: package.yaml on enactic/openarm_control

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page