Skip to main content

mcap-codec-support

High-performance decoder and encoder factories for robotics data in MCAP files. It supports regular ROS2 CDR messages, H.264/H.265/VP9/AV1 video, and Cloudini/Draco point clouds.

Install all decoding backends:

uv add "mcap-codec-support[all]"

The base package contains shared protocols and schema helpers and imports without loading any codec backend. Install only the capability needed:

Extra Enables
ros2 Fast generic ROS 2 CDR decoding
video Video/image codecs and VideoDecompressFactory
pointcloud Cloudini point-cloud codecs and decoder factories
draco Draco point-cloud codecs
all Combined decoder factory and every backend

Video, point-cloud, and Draco extras remain separate because their compiled dependencies account for most of the download and installed footprint.

Read every supported message type with small-mcap:

from mcap_codec_support import create_decoder_factories
from small_mcap import read_message_decoded

with open("input.mcap", "rb") as stream:
    messages = read_message_decoded(
        stream,
        decoder_factories=create_decoder_factories(video_format="raw"),
    )
    for message in messages:
        print(message.channel.topic, message.decoded_message)

video_format="raw" produces ROS-like Image dataclass instances. video_format="compressed" produces JPEG CompressedImage instances. Compressed point clouds are returned as PointCloud2 instances. Their fields use the same attribute access as messages from the generic ROS2 decoder. All other ROS2 messages use the fast CDR decoder.

Use CompressedPointCloudDecoderFactory or Pointcloud2DecoderFactory when a structured NumPy array is preferred over a ROS-like message.

For more control, compose the individual VideoDecompressFactory, PointCloudDecompressFactory, and ROS2 DecoderFactory instances yourself. Keep specialized factories before the general ROS2 factory.

Metadata

Release files for mcap-codec-support 0.17.0

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

Source distribution (sdist)

Source distribution for mcap-codec-support 0.17.0
File Size Uploaded Provenance Actions
mcap_codec_support-0.17.0.tar.gz 39.9 kB Without provenance Details for mcap_codec_support-0.17.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcap-codec-support 0.17.0
File Interpreter ABI Platform Actions
mcap_codec_support-0.17.0-py3-none-any.whl Python 3 none any Details for mcap_codec_support-0.17.0-py3-none-any.whl

Total release size: 91.4 kB

Release files / mcap_codec_support-0.17.0.tar.gz

Download URL mcap_codec_support-0.17.0.tar.gz
Size 39.9 kB
Tags Source
SHA-256 checksum
How to use checksums
900af45e6154015c2b506cac79cbf5ea570c98de52568d7411f6422de49968d1
BLAKE2b-256 checksum
How to use checksums
7ae8da50ef04a340bce362d46b4ce9bcf710bf6e7acf2266ca77e68b25643343
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / mcap_codec_support-0.17.0-py3-none-any.whl

Download URL mcap_codec_support-0.17.0-py3-none-any.whl
Size 51.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
249961846fec559f0da7b0ce9be9cd8f990813aa82fdf3f937ea7c199413f1c6
BLAKE2b-256 checksum
How to use checksums
b627896b71c971efee173792aa04a658e2f403b8a69fb768db4dd17fa0586962
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for mcap-codec-support 0.17.0

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