# HDF5 参数

## 一般描述

此参数从 PyTables HDF 数据库读取数组数据。

该参数使用 PyTables 数组接口读取数据，因此不需要将整个数据集加载到内存中。这对于运行大型模型很有用。 [API 参考资料](https://pywr.github.io/pywr-docs/master/api/generated/pywr.parameters.TablesArrayParameter.html#pywr.parameters.TablesArrayParameter)

通过以 “固定” 格式存储 HDF5 文件，用户可以实现最佳的数据访问速度，这使得 HDF5 成为使用 DataFrames 作为参数的 PyWR 场景的有效工具，在这些场景中，快速数据检索至关重要。HDF5 文件作为字典读取，其中每个密钥代表一个熊猫 DataFrame。例如，inflows.h5 文件的结构可能包含三个密钥，每个密钥代表不同的河流。每个密钥包含三个时间序列，可以将其分配给大小为 3 的 Pywr 场景。

如果使用 h5 文件 DataFrame 来运行 pywr-scenarios，请参阅 [pywr 场景部分](https://app.gitbook.com/s/ODCd8VK2OOl9jOdp5KFf/modeling-basics/scenarios/pywr-scenarios) 为了激活此功能

**注意：** pywr-scenaion 的大小必须与 h5 文件中的密钥数量相匹配

## 属性

<table><thead><tr><th width="158">姓名</th><th width="409">描述</th><th>必填项</th></tr></thead><tbody><tr><td>h5 文件</td><td>用于附加 CarRay 对象的表格文件句柄或文件名。如果给定了文件名，则该对象将打开和关闭文件句柄。</td><td>是的</td></tr><tr><td>节点</td><td>表数据库中要从中读取数据的节点的名称</td><td>是的</td></tr><tr><td>哪里</td><td>读取节点的路径</td><td>是的</td></tr><tr><td>场景</td><td>用作数组中第二个索引的场景</td><td>是的</td></tr></tbody></table>

## 示例

<figure><img src="https://2456626420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FroBiEJ09sszXPUfSv5uk%2Fuploads%2Fgit-blob-846adaf63d356d2aa1bebd28c57e964c7f9f9d62%2Fimage%20(369).png?alt=media" alt=""><figcaption><p>结构流入.h5</p></figcaption></figure>

\`\`json { “钥匙”：“集水河1”， “情景”：“气候变化”， “类型”：“数据框参数”， “网址”：“inflows.h5”， “index\_col”: “时间步”， “parse\_dates”：真 }

```
```
