如何快速上手Simulated Hospital：从安装到生成第一条HL7消息的完整指南

【免费下载链接】simhospital项目地址: https://gitcode.com/gh_mirrors/si/simhospital

Simulated Hospital是一款强大的医疗数据模拟工具，能够快速生成符合HL7标准的医疗消息，帮助开发者和测试人员高效构建医疗信息系统。本指南将带你从安装到生成第一条HL7消息，零门槛掌握这个实用工具。

🚀 准备工作：环境搭建

在开始使用Simulated Hospital之前，需要确保你的系统满足以下要求：

• Docker环境（推荐使用最新稳定版）
• Git工具（用于克隆代码仓库）
• Bazel构建工具（如需从源码构建）

如果你选择使用Docker方式运行，只需安装Docker即可，这是推荐的快速启动方式。

🔧 两种安装方式，总有一款适合你

方式一：Docker快速启动（推荐新手）

Docker方式是最简单快捷的安装方法，只需一行命令即可启动Simulated Hospital：

docker run --rm -it -p 8000:8000 eu.gcr.io/simhospital-images/simhospital:latest health/simulator

这条命令会自动下载最新的Simulated Hospital镜像并启动，同时映射8000端口用于访问Web控制台。

方式二：从源码构建（适合开发者）

如果你需要自定义功能或查看源代码，可以通过以下步骤从源码构建：

1. 克隆代码仓库：

git clone https://gitcode.com/gh_mirrors/si/simhospital cd simhospital

2. 构建并运行测试：

bazel build //... bazel test //...

3. 使用Bazel运行Simulated Hospital：

bazel run //cmd/simulator:simulator -- --local_path=$(pwd)

💻 探索Simulated Hospital控制面板

成功启动后，打开浏览器访问 http://localhost:8000/simulated-hospital/ 即可看到Simulated Hospital的控制面板。

控制面板主要包含以下功能区域：

• ** pathways每小时启动数量调节 **：通过滑块可以调整每小时启动的pathways数量
• ** 手动运行pathway或发送消息 **：可以直接输入pathway名称或HL7消息定义来生成消息

📝 生成你的第一条HL7消息

使用默认Pathway生成消息

1. 在控制面板的"Run A Pathway or Send A Message"文本框中输入sample_pathway
2. 点击"Run or Send"按钮

Simulated Hospital将自动运行示例pathway，生成一系列HL7消息。默认情况下，消息会输出到控制台。你可以在启动命令中添加--output=file --output_file=hl7_messages.out参数将消息保存到文件。

自定义输出目的地

Simulated Hospital支持多种消息输出方式：

-** 控制台输出（默认）：--output=stdout-文件输出：--output=file --output_file=消息文件路径-MLLP网络发送 **：--output=mllp --mllp_destination=目标主机:端口

例如，要将消息保存到文件，可以使用以下命令：

docker run --rm -it -p 8000:8000 eu.gcr.io/simhospital-images/simhospital:latest health/simulator --output=file --output_file=/tmp/hl7_messages.out

⚙️ 配置文件详解

Simulated Hospital的强大之处在于其灵活的配置系统。主要配置文件位于configs/目录下，包括：

-** 患者数据配置：configs/hl7_messages/allergies.csv、configs/hl7_messages/diagnoses.csv等 -路径配置：configs/pathways/目录下的YAML文件 -HL7消息头配置 **：configs/hl7_messages/header.yml

你可以通过挂载自定义配置文件来覆盖默认配置，例如：

docker run --rm -it -p 8000:8000 -v /本地路径/allergies.csv:/configs/hl7_messages/allergies.csv eu.gcr.io/simhospital-images/simhospital:latest health/simulator

🧪 高级功能：自定义Pathways

Pathways是Simulated Hospital的核心，定义了患者的就诊流程和生成的消息序列。所有pathway文件都存放在configs/pathways/目录下。

要创建自定义pathway，只需创建一个新的YAML文件，定义患者流程和要生成的消息类型。详细的pathway编写指南可以参考项目文档。

📊 临床数据示例

Simulated Hospital可以生成各种临床数据，包括放射学报告、实验室结果等。以下是系统内置的一些临床图像示例：

这些图像展示了Simulated Hospital能够生成的临床数据类型，可用于测试医疗系统对复杂临床数据的处理能力。

❓ 常见问题解决

问题：启动时提示"cannot parse locations file"

这通常是因为Simulated Hospital无法找到配置文件。使用Bazel运行时，确保添加--local_path参数：

bazel run //cmd/simulator:simulator -- --local_path=$(pwd)

问题：如何修改生成消息的HL7版本？

可以通过修改configs/hl7_messages/hl7.yml配置文件来更改HL7版本和相关编码。

📚 进一步学习资源

• 官方文档：docs/
• 命令行参数详解：docs/arguments.md
• Pathway编写指南：docs/write-pathways.md

通过本指南，你已经掌握了Simulated Hospital的基本使用方法。现在，你可以开始探索更多高级功能，如自定义消息模板、集成FHIR资源等，充分发挥这个强大工具的潜力！

【免费下载链接】simhospital项目地址: https://gitcode.com/gh_mirrors/si/simhospital