betterosi - a python library for reading and writing open-simulation-interface files using betterproto2

A python library for reading and writing ASAM OSI (Open-Simulation-Interace) files (either .osi binary traces or MCAP files) using betterproto2 instead of the default protobuf generated code (better typing and enum support). Supports writing and reading either mcap or osi files with betterosi.Writer and betterosi.read. View OSI or MCAP file containing OSI GroundTruth betterosi-viewer <filepath.mcap / filepath.osi>(adapted from esmini) Convert osi to mcap with betterosi-to-mcap <filepath to osi>. The library uses code from esmini (betterosi/viewer.py) under MPL 2.0 license and the code from open-simulation-interface to read osi traces (betterosi/osi3trace.py). The library uses code generation of python-betterproto2-compiler to generate python code from the protobuf definitions of open-simulation-interface. Since OSI and esmini are under MPL, also this repository is published under MPL-2.0 license.本Python库基于betterproto2而非默认的protobuf生成代码（具备更优的类型标注与枚举支持），用于读写ASAM OSI（Open-Simulation-Interface，开放仿真接口）文件——包括.osi二进制轨迹文件与MCAP文件。 本库支持通过betterosi.Writer与betterosi.read实现MCAP或OSI文件的读写操作。 可通过betterosi-viewer <文件路径.mcap / 文件路径.osi>查看包含OSI地面真值（OSI GroundTruth）的OSI或MCAP文件，该工具改编自esmini。 可通过betterosi-to-mcap <osi文件路径>将osi文件转换为mcap格式。 本库使用了遵循MPL 2.0许可协议的esmini代码（位于betterosi/viewer.py），以及来自open-simulation-interface的代码（用于读取osi轨迹，对应文件为betterosi/osi3trace.py）。 本库借助python-betterproto2-compiler的代码生成能力，从open-simulation-interface的protobuf定义中生成Python代码。 由于OSI与esmini均采用MPL许可协议，本仓库同样以MPL-2.0协议开源发布。