OceanOptics/pySatlantic

# pySatlantic [](https://www.python.org/downloads/) [](https://github.com/OceanOptics/pySatlantic/blob/master/LICENSE) _用于解包 Satlantic 仪器二进制消息的 Python 包。_ 该模块提供了一种简单的方法来解包来自 Satlantic 仪器（例如 HTSRB、HyperNav、HyperPro、HyperSAS 和 Suna）的二进制消息。这可能不是 Satlantic 协议最快的实现。然而，它易于使用，并且足够快，可以在单板计算机上实时处理来自多个传感器（例如 HyperSAS 和 Es）的高光谱光谱。 ## 安装说明 该包运行在 Python 3 环境下，可以通过 setup 文件安装，或者直接使用 pip 安装。 ``` # 通过 setup file 安装 python setup.py install # 通过 pip 安装 pip install pySatlantic ``` ## 将 SatView 录制的二进制文件转换为 CSV 该模块可用于将 SatView 录制的原始文件转换为 CSV 文件。 ``` python -m pySatlantic [-h] [-v] [--version] [-i] cal src ``` 或者直接从已安装的模块运行 ``` python -m pySatlantic.__main__ [-h] [-v] [--version] [-i] cal src ``` positional arguments: cal 校准文件。 src 要解码和校准的原始文件。 optional arguments: -h, --help 显示此帮助消息并退出 -v, --verbose 启用详细输出模式。 --version 打印版本信息。 -i, --immersed 应用浸入系数。 ## 集成到其他软件 `Instrument` 类提供了关键方法来处理来自 Satlantic 仪器的二进制帧 * `read_calibration_file`/`read_calibration_dir`/`read_sip_file`：解析解包和校准二进制帧所需的校准文件。 * `find_frame`：在二进制数组中查找已知帧 * `parse_frame`：解包二进制帧并应用校准拟合，将数据转换为科学单位 `Instrument` 类支持独立地为每个传感器设置 immersed 标志。可以通过 `Instrument.cal[].immersed` 访问浸入标志，其中 `frame_header` 表示是否应用浸入设置的传感器。 `BinReader` 类有助于通过查找注册字节 `b'SAT'` 来分离单个帧。该类的一个使用示例是 `SatViewRawToCSV`，它将 SatView 录制的原始文件转换为 CSV 文件。 ## 测试过的传感器 已测试的帧列表及关联的校准文件： + Es: + HED + HSE + HyperSAS + HLD + HSL + pySAS Tower + UMTWR + HTSRB + HSD + HST + THS + HyperPro + HPE + HPL + MPR + PED + PLD + SATBB2F + SATFLCD + HyperNAV + SATXDZ + SATXLZ + SATXCZ + SATYCZ + OCR-504 + SATDI4 + NMEA + $GPRMC Satlantic 协议的某些功能尚未实现。请使用 GitHub Issues 提交功能请求。

标签：CSV, HyperPro, HyperSAS, pip安装, Python, Satlantic, 二进制解析, 传感器数据处理, 单板计算机, 卫星通信, 开源库, 搜索引擎爬虫, 数据解包, 数据转换, 无后门, 校准文件, 海洋学, 物联网, 科学仪器, 逆向工具, 高光谱