BlueSky Docker镜像文档

重要声明

本Docker镜像中包含的BlueSky软件仅用于研究目的。其输出可能因多种原因无法准确反映实际烟雾情况，数据为临时数据，使用风险自负。

镜像概述

该镜像提供了运行BlueSky软件的容器化环境，BlueSky是一个用于烟雾模拟相关研究的项目（项目地址：[***]

前提条件

已安装Docker（安装指南：[***]

获取与基本使用

获取镜像

bash
docker pull pnwairfire/bluesky

查看命令选项

bash
docker run --rm pnwairfire/bluesky bsp -h

注意：若未加入docker用户组，需使用sudo执行docker命令。

使用示例

1. 通过管道输入运行

通过管道传递JSON格式输入数据运行bluesky：

bash
echo '{
    "fires": [
        {
            "id": "SF11C14225236095807750",
            "activity": [
                {
                    "active_areas": [
                        {
                            "start": "2014-08-30T17:00:00",
                            "end": "2014-08-31T17:00:00",
                            "ecoregion": "western",
                            "utc_offset": "-07:00",
                            "specified_points": [
                                {
                                    "lat": 47.4316976,
                                    "lng": -121.3990506,
                                    "area": 200
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}' | docker run --rm -i pnwairfire/bluesky \
    bsp -n fuelbeds consumption emissions

2. 使用vsmoke扩散模型运行

通过挂载主机目录加载输入和配置文件，运行vsmoke扩散模拟：

步骤1：创建本地目录

bash
mkdir -p $HOME/tmp/bluesky-input/ $HOME/tmp/bluesky-output/

步骤2：准备输入文件（vsmoke-input.json）

bash
echo '{
    "fires": [
        {
            "id": "SF11C14225236095807750",
            "meta":{
                "vsmoke": {
                    "wd": 30,
                    "ws": 10
                }
            },
            "activity": [
                {
                    "active_areas": [
                        {
                            "start": "2014-08-29T17:00:00",
                            "end": "2014-08-30T17:00:00",
                            "ecoregion": "western",
                            "utc_offset": "-07:00",
                            "specified_points": [
                                {
                                    "lat": 47.4316976,
                                    "lng": -121.3990506,
                                    "area": 200
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}' > $HOME/tmp/bluesky-input/vsmoke-input.json

步骤3：准备配置文件（vsmoke-config.json）

bash
echo '{
    "config": {
        "emissions": {
            "species": ["PM2.5"]
        },
        "dispersion": {
            "start": "2014-08-29T00:00:00",
            "num_hours": 24,
            "model": "vsmoke",
            "output_dir": "/bluesky-output/dispersion-output/{run_id}/",
            "working_dir": "/bluesky-output/dispersion-working/{run_id}/"
        }
    }
}' > $HOME/tmp/bluesky-input/vsmoke-config.json

步骤4：运行容器

bash
docker run --rm -i -v $HOME/tmp/bluesky-output/:/bluesky-output/ \
    -v $HOME/tmp/bluesky-input/:/bluesky-input/ pnwairfire/bluesky \
    bsp --log-level=DEBUG \
    -i /bluesky-input/vsmoke-input.json \
    -o /bluesky-output/vsmoke-output.json \
    -c /bluesky-input/vsmoke-config.json \
    fuelbeds consumption emissions timeprofile dispersion

挂载目录说明

使用-v选项可将主机目录挂载到容器中，实现输入数据和配置文件的加载及输出结果的保存。如上述示例中，$HOME/tmp/bluesky-input/和$HOME/tmp/bluesky-output/目录分别挂载为容器内的/bluesky-input/和/bluesky-output/目录，用于数据交互。