Pre-release

This release is a pre-release and may not be stable for production use.

MetaCar Hybrid - 虚实结合平台 Python API

MetaCar Hybrid 是面向智能网联汽车虚实结合场景的 Python API。本项目基于 YDL-Simulation/autodrive_api_python 开发，在保留原有场景通信、车辆状态和视频流能力的基础上，增加了 HybridControl 消息和 Delta 位移控制。

当前为 Alpha 版本，接口可能随虚实平台协议继续调整。

与原版 MetaCar 的关系

  • PyPI 发行包名为 metacar-hybrid。
  • Python 导入包名为 metacar_hybrid，与原版 metacar 明确区分。
  • metacar-hybrid 与原版 metacar 可以安装在同一个 Python 环境中。
  • 本产品使用独立版本号，并在 UPSTREAM.md 中记录对应的上游基线。

功能特性

  • 与虚实结合平台进行 TCP 通信
  • 解析 HybridControl 和 deltaTime
  • 通过 SceneAPI.set_hybrid_delta() 发送 dx / dy 控制量
  • 获取场景静态数据、车辆状态和传感器数据
  • 摄像头视频流处理
  • 保留原版油门、刹车、转向控制接口
  • 提供不包含产品策略的基础键盘 Delta 控制示例

安装

建议在独立虚拟环境中安装：

python -m venv .venv

Windows PowerShell：

.venv\Scripts\Activate.ps1
python -m pip install --pre metacar-hybrid

安装运行示例所需的键盘和 GUI 依赖：

python -m pip install --pre "metacar-hybrid[examples]"

虚实结合控制

from metacar_hybrid import SceneAPI

api = SceneAPI()
api.connect()

for sim_car_msg, frames in api.main_loop():
    hybrid_control = sim_car_msg.hybrid_control or {}
    dt = hybrid_control.get("deltaTime")

    # dx / dy 由上层轨迹跟踪或键盘算法计算
    api.set_hybrid_delta(dx=0.1, dy=0.0, dt=dt)

示例

仓库中包含：

  • examples/main_hybrid_basic.py - 可公开的基础键盘 Delta 控制示例
  • examples/main.py - 原有仿真控制示例
  • examples/gui.py - 车辆状态与场景信息 GUI

安装示例依赖后，可以直接运行基础示例：

python -m pip install --pre "metacar-hybrid[examples]"
metacar-hybrid-basic

从源码开发时也可以运行：

python examples/main_hybrid_basic.py

完整轨迹控制和测试策略属于内部开发代码，不包含在 PyPI 的 wheel 和源码发布包中。

维护

本项目采用内部开发仓库与公开产品仓库分离的方式维护。上游同步、公开边界和发版步骤请参阅 MAINTENANCE.md。

创建 GitHub Release 和发布 PyPI 前，请按照 RELEASING.md 完成版本、标签、Trusted Publisher 和安装验证。

本地开发与验证

python -m pip install -e ".[test,examples]" build twine
python -m pytest
python -m build
python -m twine check --strict dist/*
python scripts/check_release_artifacts.py dist/*

文档

本地构建 Sphinx 文档：

python -m pip install -r docs/requirements.txt
sphinx-build -W -b html docs docs/_build/html

版本策略

MetaCar Hybrid 独立发版：

  • 0.1.0a1 - 首个 Alpha 测试版，使用旧导入名 metacar
  • 0.1.0a2 - 使用独立导入名 metacar_hybrid，支持与原版共存
  • 0.1.0rc1 - 首个发布候选版
  • 0.1.0 - 首个稳定版

每次同步上游后，应在 UPSTREAM.md 和发布说明中记录上游标签及提交哈希。

许可证

本项目基于 MIT 许可证的上游项目开发，继续使用 MIT 许可证。详见 LICENSE。

Project links

Data verified by PyPI on Jul 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for MengHan_Wang from gravatar.com MengHan_Wang

Credits

Author: YDL-Simulation

Maintainer: theansweri

GitHub Statistics

Data verified by PyPI on Jul 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

examples test

Classifiers

Report project as malware

Download files

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

Source Distribution

metacar_hybrid-0.1.0a2.tar.gz (34.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

metacar_hybrid-0.1.0a2-py3-none-any.whl (16.2 kB view details)

Uploaded Python 3

File details

Details for the file metacar_hybrid-0.1.0a2.tar.gz.

File metadata

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

File hashes

Hashes for metacar_hybrid-0.1.0a2.tar.gz
Algorithm Hash digest
SHA256 cacea1895de8cd28cd6793c12807bba1d9cd66ea6698f36f4f81a13fee58f5ea
MD5 3adc2565e4e8f3da5ae915c5a9c0c160
BLAKE2b-256 8f7db73a1d2c39567b935338945857a9f1987d773fd234ab6563364624d31bf6

See more details on using hashes here.

Provenance

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

Publisher: python-publish.yml on YDL-Simulation/metacar-hybrid

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

File details

Details for the file metacar_hybrid-0.1.0a2-py3-none-any.whl.

File metadata

File hashes

Hashes for metacar_hybrid-0.1.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 5d04e80c0d7ab8838ce536ca76e20359b5a69f3a1310b71fe8fa7388d613619c
MD5 41de7430ff501a72bd35978156a046dd
BLAKE2b-256 6cc68c6f8c410ae306e51d340f4f7413c2683f406b4c15afe7255e3eea159791

See more details on using hashes here.

Provenance

The following attestation bundles were made for metacar_hybrid-0.1.0a2-py3-none-any.whl:

Publisher: python-publish.yml on YDL-Simulation/metacar-hybrid

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

Release history Release notifications | RSS feed

0.1.0

2 files

Pre-release

0.1.0a5

2 files

Pre-release

0.1.0a4

2 files

Pre-release

0.1.0a3

2 files

This release
Pre-release

0.1.0a2 This release

2 files

Pre-release

0.1.0a1

2 files

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