插件〉Psychart

面板

社区

Psychart

概述
安装
变更日志
相关内容

Psychart v4.5.4

用于监控数据中心健康和人体舒适度的湿度图

在湿度图上查看空气状况。

什么是湿度图？

湿热图是由 ASHRAE 采用的图表，用于绘制空气-水蒸气混合物的各种热力学性质。这些图表在 HVAC 应用中特别有用。以下属性描述了所谓的空气状态。两个属性是确定空气状态所必需的，这意味着需要两个属性才能计算出所有其他属性。以下 4 个属性是 Psychart 默认绘制的

干球温度
- 使用干式温度计测量的空气温度。
湿球温度
- 湿球温度可以通过水蒸发的表面温度来实际解释。
露点
- 在此温度或低于此温度时，水会从空气中凝结出来。
相对湿度
- 空气中水蒸气压力与饱和水蒸气压力的比率。 0%rh 表示绝对干燥的空气，而 100%rh 表示饱和空气。

Psychart 还能够导出以下状态变量，这些变量可以使用显示选项中的显示高级状态变量开关选择性地显示。

水蒸气压力
- 水蒸气-空气混合物中水的分压。
湿度比
- 每单位重量干空气中水蒸气的重量。
焓
- 在热力学中，指水蒸气-空气混合物的总热含量。
比容
- 每单位质量的水蒸气-空气混合物所占的体积量。

入门指南

本节将介绍面板编辑器中的选项。

面板选项

这是所有 Grafana 面板的默认面板选项，用户可以访问面板标题和描述以及其他 UI 效果。

图表选项

这些选项影响图表本身的显示方式。

允许用户选择测量单位是使用美制单位还是 SI 单位、当地海拔、图形边界、翻转 X 轴和 Y 轴，以及可选地显示 ASHRAE 舒适区域（包络线）。对于数据中心包络线，这些舒适区域遵循 2021 年 ASHRAE 标准，专为各种关键级别的数据中心和 IT 空间而设计。对于人体舒适度包络线，这些舒适区域遵循 2017 年发布的 ASHRAE-55 指南。这些人体舒适度包络线是代谢率（MET，取决于室内活动）、服装等级（CLO）和风速的函数。在两种情况下，包络线都显示了输送到室内空间的调节空气的目标区域。

数据选项

这些选项有助于处理传入的数据。

Psychart 能够绘制每个面板的多个状态数据系列。数据系列的数量由系列计数定义。由于需要 2 个属性来确定状态，因此至少需要两个数值型、时变的字段。用户必须选择这两个字段是干球温度和湿球温度、干球温度和露点，还是干球温度和相对湿度。然后，必须将这些字段分别输入到下面的字段选择器中。

重要的是要注意，根据数据结构，可能需要一个或两个查询。一个查询可能足以返回确定状态所需的两个字段。在其他情况下，可能需要一个查询来获取干球温度字段，另一个查询来获取相对湿度字段，例如。

不同的数据系列彼此独立 - 例如，一个系列可能包含干球温度和湿球温度测量值，而另一个系列可能包含干球温度和露点测量值。

系列显示选项

本节配置每个单独的数据系列。

首先，必须设置图例。这将命名您的数据系列，并在将光标悬停在绘制的数据上时添加标签。然后，选择代表 2 个湿热测量值的 2 个数据系列。

其余选项更改图表中数据的视觉外观。这允许用户更改点半径，选择性地绘制时间上相邻点之间的线，以及为数据系列选择颜色渐变。无论首选哪种主题（浅色/深色），渐变始终对较新的数据点使用更饱和/对比鲜明的颜色。用户还可以选择在此处查看更多状态变量。

错误和故障排除

某些错误可能源于数据选项部分，因为湿球温度和露点必须小于或等于干球温度，并且相对湿度必须在 0-1 范围内。如果相对湿度是驱动测量值，请确保测量类型正确（0-1 或 0%-100%）。对于其他测量值，请确保正确报告它们。

Psychart 将值与相似的时间戳匹配。对于干球温度和相对湿度系列，干球温度测量时间戳必须与相对湿度时间戳匹配，才能被识别为单个点。查询检查器中的查询选项可以提供修复任何时间差异所需的工具。

重要的是，如果一个字段中缺少数据，例如，如果干球温度在过去 5 分钟内没有报告，则不会计算新的状态，并且在过去 5 分钟内 Psychart 中不会绘制任何新数据，以避免显示不准确的数据。

当观察较短的时间跨度时，Psychart 在视觉和实际应用中效果最佳。如果 Psychart 加载速度非常慢，请尝试减小 Grafana 中的时间范围。Psychart 接受绝对和相对时间跨度。如果数据仍然显得过于杂乱，请尝试禁用连接系列的线，减小点半径，或减少在单个面板上渲染的数据系列数量。

最后，如果在升级到较新版本的 Psychart 后出现问题（例如，区域未呈现），请尝试打开面板编辑器，重新应用您的自定义设置，然后保存面板。有时，面板选项无法在版本之间正确存储。

许可证

Psychart 由 Nicolas Ventura 创建，由伯克利实验室（一个由 DOE 资助的国家实验室）所有，并根据 BSD-3-Clause-LBNL 许可证分发。

插件 ID	上次更新	版本
`ventura-psychrometric-panel`	`2024-12-10`	`4.5.4`

屏幕截图

基本 HVAC 用例：数据中心空调机组供气条件

室外天气用例 室外天气条件用例

使用 SI 单位的 Psychart 将 Psychart 与 SI 单位一起使用

HVAC 设计用例：将 Psychart 用作湿热计算器

Psychart 标准面板编辑器的示例

多系列 #1 同一图表上的多个数据系列

多系列 #2 Psychart 可以一次处理大量数据

使用 Psychart 渲染莫里尔图

在 Grafana Cloud 上安装 Psychart

有关更多信息，请访问关于插件安装的文档。

更新日志

4.5.4

更新到最新版本的 @grafana/create-plugin (5.11.1)
更新依赖版本

4.5.3

更新到最新版本的 @grafana/create-plugin (5.9.3)
- 解决 Dependabot 安全漏洞
- 将 node 版本更新到 22
感谢 Grafana 团队解决 #1328！

4.5.2

更新到最新版本的 @grafana/create-plugin (5.5.2)
修复了数据系列最初会被禁用的错误，对于升级到插件版本 4.5.1 的现有仪表板

4.5.1

添加一个名为 Enable 的选项，取消选中时，将隐藏数据系列
更新到最新版本的 @grafana/create-plugin (5.3.10)

4.5.0

添加新的舒适区域：建筑生物气候图的舒适区（基于 Milne 和 Givoni 1979 年和 ASHRAE 55-2017 年）
更新到最新版本的 @grafana/create-plugin (5.2.2)

4.4.0

更新到最新版本的 @grafana/create-plugin (4.16.3)
- Grafana 版本要求：>=10.4.0
更新依赖版本

4.3.2

更新到最新版本的 @grafana/create-plugin (4.12.0)
移除对 Grafana 遗留类的依赖
更新 pages.yml 工作流程文件中的依赖版本
- NodeJS 更新到版本 20

4.3.1

更新到最新版本的 @grafana/create-plugin (4.10.1)
在存储库中跟踪 package-lock.json

4.3.0

更新到最新版本的 @grafana/create-plugin (4.6.2)
- Grafana 版本要求：>=10.3.3
- 兼容性检查工作流程现在已修复！
更新 smath (1.8.5) 和 viridis (1.1.4) 的依赖版本
支持通过在 x=y 线上镜像 Psychart 来渲染莫里尔图的功能（感谢 @yevgeny7 的想法！）
通过将面板内部填充拆分为 x 和 y 值而不是使用单个值来改进面板内部填充
在所有面板选项字段中添加占位符（字段为空时显示）
dbMax 和 dpMax 选项的最小值/最大值现在动态计算，以便 dbMax 必须严格大于或等于 dpMax
通过以下方式提高代码质量...
- 将 let 更改为 const
- 在可能的情况下添加 readonly 修饰符
- 添加显式访问修饰符（默认情况下，如果未指定，TypeScript 会将所有类成员设置为 public）
小的 Webpack 配置简化（独立应用程序）
修复了相对湿度显示为 0-1 而不是 0-100% 的错误
更新屏幕截图

4.2.2

修复了浅色主题下区域阴影渐变未反转的错误
更新到独立应用程序
- 添加用于渲染 IBM TS4500 环境包络线的选项
- 使用 script defer 并移除窗口加载事件侦听器

4.2.1

更新依赖版本
清理脚本现在可以移除备份
Psychart 类中的小清理

4.2.0

在 README 中添加 LBL/DOE 通知
将自定义 JMath 替换为 smath 依赖项，用于线性插值函数
将自定义 Color 替换为 viridis 依赖项，用于颜色渐变函数
- 允许来自此软件包的所有默认/内置渐变，为 Psychart 添加了 10 多个新渐变！
- 对区域阴影使用“紫色”调色板
默认系列名称已编号而不是字母
在 Psychart 上渲染最多 100 个数据系列
移除 default 导出，优先使用命名导出（撤消来自 4.0.1 的更改）
区域阴影现在受您的 Grafana 主题影响，以获得更好的对比度
添加 IBM TS4500 环境条件包络线

4.1.0

更新到最新版本的 @grafana/create-plugin (4.0.1)
在主 README 页面和插件页面中添加指向 issues 的链接
对 runner 更新命令进行小更新（仅选择非隐藏文件）
正确设置 package.json 中的许可证类型（感谢 @nagisa！）#10 和 README
在插件 README 的底部添加额外的统计信息
移除构建输出中的重复图像

4.0.6

更新到最新版本的 @grafana/create-plugin (3.5.0)
- 更新工作流程操作依赖版本，感谢我的 pull request！
更新仪表板配置
- 数据源是随机 30Hz 数据流
在 runner 中添加 -U 标志，该标志将使用最新版本的 @grafana/create-plugin 自动重新构建

4.0.5

更新到最新版本的 @grafana/create-plugin (3.1.3)

4.0.4

更新到最新版本的 @grafana/create-plugin (2.11.1)

4.0.3

更新到最新版本的 @grafana/create-plugin (2.10.1)
- 使用 grafana/plugin-actions/build-plugin 操作
在插件 README 中添加受欢迎程度徽章

4.0.2

在 GitHub 存储库中添加横幅图像
更新到最新版本的 @grafana/create-plugin (2.8.0)
- 除了 grafana/plugin-actions/build-plugin 操作
- 添加仪表板配置
对 runner 文件进行重大更新
- 使用 getopts 检查选项
- 重新设计插件验证和发布的逻辑/错误消息

4.0.1

尽可能使导出为默认值
反转浅色主题的渐变
- 最饱和的颜色是较新的数据点，无论使用哪种主题
修复了当 min = max 时，归一化值会返回 [0, 1] 范围外的值的错误
区域着色方面的小改进
更新了 README 中的一些屏幕截图
- 显示面板编辑器选项
- 具有多个数据系列的示例
独立应用程序仅在版本发布时发布

4.0.0

Psychart 现在能够渲染多个数据系列
- 选项在面板编辑器中的 数据选项 下显示为嵌套选项
- 现在可以标记，并且 Psychart 将在悬停文本中显示系列标签
- 支持不同系列的样式
- 系列计数限制：104（如果您希望增加此限制，请发送电子邮件给我）
仅当数据系列名称是有效选项时，Psychart 才会尝试绘制数据
面板编辑器选项现在会自动验证
- 已弃用的选项现在从仪表板设置中删除
使用不带 ./ 的相对路径引用文件
数据点现在仅存储干球温度 + other 值 + 测量类型，其中 other 是湿球温度、露点或相对湿度，具体取决于测量类型
在 README.md 中添加版本号
更新到最新版本的 @grafana/create-plugin (2.6.0)
- Node 版本升级到 v20
渐变图标现在根据渐变定义自动生成
设置 Psychart 时，渐变图标现在显示在独立应用程序中
添加了 4 个新的渐变！致谢
- 翠绿色
- 薄荷色
- 日落色
- 暮色