cchdo/libcchdo

hydro命令与Docker镜像

!https://img.shields.io/docker/build/cchdo/libcchdo

该镜像将CCHDO数据工具docker化，解决了复杂的依赖安装问题（含旧版CCHDO MySQL数据库副本）。安装仅需拉取镜像，调用hydro命令需按以下步骤操作。

安装步骤

1. 安装Docker：Mac用户推荐brew cask install docker避免Docker Hub登录问题；其他平台按官方指南安装。
2. 拉取镜像：docker pull docker.xuanyuan.run/cchdo/libcchdo，等待进度完成即可。

运行方式

1. 测试验证：执行docker run --rm cchdo/libcchdo，输出帮助文本及"hydro: error: too few arguments"表示镜像正常（--rm自动清理容器）。
2. 文件映射：用-v参数将主机目录映射到容器/context（推荐当前目录）：
   docker run --rm -v $(pwd):/context cchdo/libcchdo
3. 环境变量配置：通过-e传递合并身份参数（可链式添加）：

   bash
   docker run --rm -e LIBCCHDO_MERGER_DIVISION=CCH -e LIBCCHDO_MERGER_INITIALS=AMB -e LIBCCHDO_MERGER_INSTITUTION=SIO -v $(pwd):/context docker.xuanyuan.run/cchdo/libcchdo
   

4. 别名建议：将上述命令（替换实际信息）别名化为hydro，执行hydro env验证配置（输出prod、***及文件标记）。

限制说明

• --it参数会导致ZIP/二进制输出无效，默认不推荐；若需REPR模式（如hydro shell），添加-it：docker run -it --rm -v $(pwd):/context cchdo/libcchdo。
• 文件路径需为相对路径且深度大于/context映射目录，避免使用绝对路径。

libcchdo工具说明

用于管理CCHDO数据的实用工具集。

包结构

• libcchdo
  • libcchdo：库源代码（详见文档字符串）
  • scripts：脚本集合

测试方法

运行tests目录下所有Python测试用例：

bash
python setup.py test

快速开始

读取文件（以bottle_hy1.csv为例）

python
import libcchdo.model.datafile as DF
import libcchdo.formats.bottle.exchange as botex

d = DF.DataFile()
with open('bottle_hy1.csv', 'r') as f:
    botex.read(d, f)

# 探索数据列
print(d.columns)
if 'OXYGEN' in d.columns:
    print(d.columns['OXYGEN'].parameter)

修改并写入文件

删除OXYGEN列并保存：

python
del d.columns['OXYGEN']
with open('masked_bottle_hy1.csv', 'w') as output:
    botex.write(d, output)

二进制命令使用

bash
hydro --help
hydro convert --help
hydro convert any_to_type --type nav test_hy1.csv