Skip to main content

A pure Python library to receive motion capture data from OptiTrack Streaming Engine

Project description

A pure Python library to receive motion capture data from OptiTrack Streaming Engine.

OptiTrack is a line of motion capture products by NaturalPoint. Their software can broadcast motion capture data via a documented binary protocol. It is supposed to be used together with the proprietary NatNet SDK, which, unfortunately, is not available for Python, nor cannot be used with free toolchains (GCC, Clang). OptiRX is based on the direct depacketization example from the SDK and does not use NatNet SDK.

Install

pip install optirx

Compatibility

Tracking Tools 2.5.0; Motive 1.5.x (NatNet 2.5.0.0), 1.7.x (NatNet 2.7.0.0), 1.9.0 (NatNet 2.9.0.0).

Usage

Assuming that Tracking Tools or Motion runs on the same machine and broadcasting is enabled on the local network interface (not the loopback), this code receives and prints all data frames:

import optirx as rx

dsock = rx.mkdatasock()
version = (2, 9, 0, 0)  # NatNet version to use
while True:
    data = dsock.recv(rx.MAX_PACKETSIZE)
    packet = rx.unpack(data, version=version)
    if type(packet) is rx.SenderData:
        version = packet.natnet_version
    print packet

Alternatives

  • use VRPN streaming protocol.
  • use Matlab or Microsoft toolchains.
  • use PyNatNet and NatNet SDK

License

MIT

Project details


Release history Release notifications

This version
History Node

1.9

History Node

0.3

History Node

0.2

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page