插件 〉Psychart
Psychart
Psychart v5.0.0
用于监控数据中心健康和人体舒适度的湿空气焓湿图
在湿空气焓湿图上查看空气条件。
什么是湿空气焓湿图?
湿空气焓湿图是由 ASHRAE 采纳的图表,用于绘制空气-水蒸气混合物的各种热力学性质。这些图表在 HVAC(供暖、通风和空调)应用中特别有用。以下属性描述了空气的所谓状态。确定空气状态需要两个属性,这意味着需要两个属性来计算其他所有属性。Psychart 默认绘制以下 4 个属性
- 干球温度
- 使用干温度计测量的空气温度。
- 湿球温度
- 湿球温度可以实际解释为水蒸发表面处的温度。
- 露点温度
- 空气中的水分将在此温度或低于此温度时凝结。
- 相对湿度
- 空气中水蒸气压力与饱和水蒸气压力的比值。0%rh 表示绝对干燥的空气,100%rh 表示饱和空气。
Psychart 还能够推导出以下状态变量,这些变量可以通过系列显示选项中的“显示高级状态变量”开关选择性显示。
- 水蒸气分压
- 空气-水蒸气混合物中水的偏压。
- 湿度比
- 每单位干空气重量所含水蒸气的重量。
- 焓
- 在热力学中,指空气-水蒸气混合物的总热含量。
- 比容
- 每单位质量的空气-水蒸气混合物所占的体积。
- 饱和度
- 湿空气湿度比与饱和湿空气湿度比之比。
入门
本节将介绍面板编辑器中的选项。
面板选项
这是所有 Grafana 面板的默认面板选项,用户可访问面板标题、描述、面板链接和重复选项。
图表选项
这些选项影响图表的显示方式。
允许用户选择测量报告使用的单位(美制或国际单位制)、选择显示或隐藏图例、设置当地海拔高度、图表边界、选择性渲染 Mollier 图,以及选择性显示 ASHRAE 舒适区域(包络线)。此外,还可以通过展开“轴间隔”来调整主要轴间隔。湿度比的轴仅在渲染 Mollier 图时显示。
舒适区域
对于数据中心包络线,这些舒适区域遵循 2021 年 ASHRAE 标准,专为不同关键程度的数据中心和 IT 空间设计。对于人体舒适度包络线,这些舒适区域遵循 2017 年发布的 ASHRAE-55 指南。这些人体舒适度包络线是代谢率(MET
,取决于室内活动)、服装等级(CLO
)和风速的函数。在这两种情况下,包络线都显示了供入室内空间的调节空气的目标区域。
数据选项
这些选项有助于处理接收到的数据。
Psychart 能够为每个面板绘制几种不同的状态数据系列。数据系列的数量由系列计数定义。由于确定状态需要两个属性,因此至少需要两个随时间变化的数字字段。用户必须选择这两个字段是干球温度和湿球温度、干球温度和露点温度,还是干球温度和相对湿度。然后必须将这些字段分别输入到下面的字段选择器中。
需要注意的是,根据数据结构,可能需要一个或两个查询。一个单一查询可能足以返回确定状态所需的两个字段。有时,需要一个查询来获取干球温度字段,另一个查询来获取相对湿度字段,例如。
不同的数据系列彼此独立——例如,一个系列可能包含干球温度和湿球温度测量值,而另一个系列可能包含干球温度和露点温度测量值。
系列显示选项
本节配置每个单独的数据系列。
首先,必须设置图例。这将为您的数据系列命名,并在将光标悬停在绘制数据上时添加标签。这支持 Grafana 仪表盘变量,写为 ${variable}
。设置图例名称后,选择代表用于确定状态的两个湿空气测量的两个数据系列。
其余选项更改图表中数据的视觉外观。这允许用户更改点半径、选择性地在相邻时间点之间绘制线条,并为数据系列选择颜色渐变。无论偏好哪种主题(亮/暗),渐变总是对较新的数据点使用更饱和/对比度更高的颜色。用户还可以选择性地查看引言中描述的高级状态变量。
错误和故障排除
由于湿球温度和露点温度必须小于或等于干球温度,且相对湿度必须在 0-1 范围内,数据选项部分可能会出现一些错误。如果相对湿度是主要的测量值,请确保测量类型正确(0-1 或 0%-100%)。对于其他测量值,请确保它们被正确报告。
Psychart 将时间戳相似的值匹配起来。对于干球温度和相对湿度系列,干球温度测量的时间戳必须与相对湿度时间戳匹配,才能被识别为一个点。查询检查器中的“查询选项”可能会提供解决任何时间差异所需的工具。
重要的是,如果一个字段中缺少数据,例如干球温度在过去 5 分钟内没有报告,则不会计算新的状态,也不会在过去 5 分钟内在 Psychart 中绘制新数据,以避免显示不准确的数据。
观察较短的时间跨度时,Psychart 在视觉和实用性上效果最佳。如果 Psychart 加载非常慢,请尝试减少 Grafana 中的“时间范围”。Psychart 接受绝对和相对时间跨度。如果数据仍然看起来太拥挤,请尝试禁用用线条连接点、减小点半径或减少单个面板上渲染的数据系列数量。
如果数据似乎被隐藏,请确保图表边界包含所有数据的范围。另外,仔细检查以确保图例中没有禁用任何系列。如果禁用了,点击它们的系列名称即可重新在 Psychart 上渲染它们。
最后,如果在升级到新版本的 Psychart 后出现问题(例如区域未渲染),请尝试打开面板编辑器,重新应用您的自定义设置,然后保存面板。有时,面板选项在版本之间无法正确存储。
许可证
Psychart 由 Nicolas Ventura 创建,由美国能源部资助的国家实验室 Berkeley Lab 所有,并根据 BSD-3-Clause-LBNL 许可证分发。
插件 ID | 上次更新 | 版本 |
---|---|---|
ventura-psychrometric-panel | 2025-04-23 | 5.0.0 |
在 Grafana Cloud 上安装 Psychart
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很棒吧?
请注意,可能需要最多 1 分钟才能在您的 Grafana 中看到插件显示。
更多信息,请访问关于插件安装的文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但您将在您的 Grafana 中收到更新可用通知。
1. 安装面板
使用 grafana-cli 工具从命令行安装 Psychart
grafana-cli plugins install
插件将安装到您的 grafana 插件目录;默认路径是 /var/lib/grafana/plugins。关于 cli 工具的更多信息。
2. 将面板添加到仪表盘
已安装的面板会立即在您 Grafana 主菜单的仪表盘部分中显示,并且可以像 Grafana 中的任何其他核心面板一样添加。
要查看已安装面板列表,请点击主菜单中的插件项。核心面板和已安装面板都将显示。
变更日志
5.0.0
- 将 Psychart 源代码拆分为独立的 npm 包。主要更新包括
- 添加了图例!图例是交互式的;点击图例中的系列名称将切换其点的可见性
- Mollier 图现在将在其 x 轴上显示湿度比,而不是露点温度
- 单位同时显示在轴标签和轴工具提示中
- Psychart 现在计算饱和度,这可以在“高级”模式下显示!
- 独立应用程序:生成图表后和绘制数据时输入数据显示选项
- 在预置仪表盘中添加更多示例和说明
- 移除所有截图,新版本的截图将在未来的更新中添加
- 使用内置的
<PanelDataErrorView>
Grafana React 元素来显示错误 - 组织文件夹结构以更好地匹配 Grafana 的默认插件
- 不再需要将所有渐变图标打包到插件中!图标现在是动态生成的,并且生成它们的 URL。
- 面板编辑器更改
- 添加显示图例的开关
- 添加调整轴主要间隔的选项
- 移除“启用”开关(因为现在只需点击图例中的系列名称即可隐藏系列)
- 将新截图重新打包到插件中
- 添加(空)单元测试文件
- 主 README 中的次要更新(例如提及变量插值、修复损坏的链接)
- 在 Grafana 工作流程中添加构建证明
- 添加从 4.x.x 版本到 5.x.x 版本的选项迁移处理
- 更新到最新版本
@grafana/create-plugin
(5.19.5)
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) - 修复了一个 bug,该 bug 导致对于已升级到插件版本 4.5.1 的现有仪表盘,数据系列最初会被禁用
4.5.1
- 添加一个名为“启用”的选项,取消选中时将隐藏数据系列
- 更新到最新版本
@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
- 所需 Grafana 版本:
- 更新依赖项版本
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
- 兼容性检查工作流程已修复!
- 所需 Grafana 版本:
- 更新依赖项
smath
(1.8.5) 和viridis
(1.1.4) 的版本 - 支持通过在
x=y
线上镜像 Psychart 来渲染 Mollier 图的功能(感谢 @yevgeny7 的想法!) - 通过将面板内部填充拆分为 x 和 y 值而不是使用单个值来改进填充
- 在所有面板选项字段中添加占位符(字段为空时显示)
- dbMax 和 dpMax 选项的最小/最大值现在动态计算,以便 dbMax 必须严格大于或等于 dpMax
- 通过以下方式提高代码质量...
- 将
let
改为const
- 在可能的情况下添加
readonly
修饰符 - 添加显式访问修饰符(默认情况下,如果未指定,TypeScript 会将所有类成员设置为
public
)
- 将
- Webpack 配置的次要简化(独立应用程序)
- 修复相对湿度从 0-1 而非 0-100% 显示的 bug
- 更新截图
4.2.2
- 修复了区域阴影渐变在浅色主题下未反转的 bug
- 独立应用程序更新
- 添加用于渲染 IBM TS4500 环境包络线的选项
- 使用
script defer
并移除 window load 事件监听器
4.2.1
- 更新依赖项版本
- 清理脚本现在可以移除备份
Psychart
类中的次要清理
4.2.0
- 在 README 中添加 LBL/DOE 通知
- 用
smath
依赖项替换自定义 JMath 以实现线性插值函数 - 用
viridis
依赖项替换自定义 Color 以实现颜色渐变函数- 允许使用此包中的所有默认/内置渐变,为 Psychart 添加了 >10 个新渐变!
- 区域阴影使用“Purplish”调色板
- 默认系列名称使用数字而不是字母
- Psychart 上最大渲染 100 个数据系列
- 移除 default 导出,倾向于命名导出(撤销4.0.1 的更改)
- 区域阴影现在受您的 Grafana 主题影响,以获得更好的对比度
- 添加 IBM TS4500 环境条件包络线
4.1.0
- 更新到最新版本
@grafana/create-plugin
(4.0.1) - 在主 README 页面和插件页面中添加问题链接
- runner update 命令的次要更新(仅选择非隐藏文件)
- 正确设置 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
action
- 使用
- 在插件 README 中添加流行度徽章
4.0.2
- 在 GitHub 仓库中添加横幅图片
- 更新到最新版本
@grafana/create-plugin
(2.8.0)- 除了
grafana/plugin-actions/build-plugin
action - 添加仪表盘预置
- 除了
- runner 文件的主要更新
- 使用
getopts
检查选项 - 重新设计插件验证和发布逻辑/错误消息
- 使用
4.0.1
- 在可能的情况下将 exports 设为 default
- 为浅色主题反转渐变
- 最饱和的颜色代表最新的数据点,无论哪种主题
- 修复了当
min = max
时,归一化值会返回 [0, 1] 之外的值的 bug - 区域着色的次要改进
- 更新了
README
中的一些截图- 显示面板编辑器选项
- 多个数据系列的示例
- 独立应用程序仅在版本发布时发布
4.0.0
- Psychart 现在具备渲染多个数据系列的能力
- 选项在面板编辑器中显示为“数据选项”下的嵌套选项
- 现在可以添加标签,并且 Psychart 将在悬停文本中显示系列标签
- 支持不同系列的不同样式
- 系列计数限制:104(如果您想增加此限制,请给我发送电子邮件)
- Psychart 仅在数据系列名称是有效选项时尝试绘制数据
- 面板编辑器选项现在自动验证
- 弃用的选项现在从仪表盘设置中删除
- 引用相对路径的文件,不带
./
- 数据点现在仅存储干球温度 + 其他值 + 测量类型,其中“其他”根据测量类型是湿球温度、露点温度或相对湿度
- 在
README.md
中添加版本号 - 更新到最新版本
@grafana/create-plugin
(2.6.0)- Node 版本升级到
v20
- Node 版本升级到
- 渐变图标现在根据渐变定义自动生成
- 在设置 Psychart 时,渐变图标现在显示在独立应用程序中
- 新增 4 种渐变!鸣谢
- 祖母绿
- 薄荷
- 日落
- 黄昏
3.3.1
- 在 runner 中将
-r
标志更改为-g
标志(重启本地 Grafana 实例) - 修复
normalize
函数中min = max
的边界情况 - 湿空气区域现在利用了渐变的完整范围
- 改进湿空气状态的错误检查(移除干扰性错误)
- 为较新的 Grafana API 版本更新数据格式化程序
3.3.0
- 更新到最新版本
@grafana/create-plugin
(2.0.2)- 所需 Grafana 版本:
>=10.0.3
- 所需 Grafana 版本:
- Node 版本更新到
v18
3.2.3
- 更新到最新版本
@grafana/create-plugin
(1.12.0)
3.2.2
- 更新到最新版本
@grafana/create-plugin
(1.10.0) - 修复
docker-compose.yaml
中不正确的插件 ID - 移除对
GRAFANA_API_KEY
的引用,改为GRAFANA_ACCESS_POLICY_TOKEN
3.2.1
- 更新到最新版本
@grafana/create-plugin
(1.9.0) - 移除构建脚本中对 npm 的引用
- 将系列值存储在名为
field.config.displayNameFromDS
的标签中
3.2.0
- 更新到最新版本
@grafana/create-plugin
(1.6.3)- 所需 Grafana 版本:
>=9.5.3
- 所需 Grafana 版本:
- 在验证脚本中自动构建和验证插件
3.1.3
- 更新到最新版本
@grafana/create-plugin
(1.3.0) - 将
yarn
命令更改为npm run
3.1.2
- 将
README.md
从根文件夹移动到src/
- 更新依赖项
3.1.1
- 截图已移动到
README.md
3.1.0
- 截图不再随插件打包
- 添加更多新截图并附带更好的描述
- 修复了阻止设置默认渐变的 bug
- 如果未选择任何字段名称,则不尝试绘制数据
- 如果未找到字段或字段无效,则显示错误
- 如果最大露点温度 > 最大干球温度,则显示错误
- 在
plugin.json
中添加作者联系信息 - 发布脚本现在确保变更日志与发布的版本号匹配
3.0.1
- 将 Viridis 设置为默认颜色渐变
- 在
README.md
的故障排除部分添加一小段文字,解释如何在升级到主要版本时修复错误
3.0.0
- 从 JavaScript 代码库迁移到 TypeScript 代码库
- 在独立应用程序和Grafana 插件中动态生成区域和渐变选择
- 这意味着减少了代码重复,因此将来添加更多区域或渐变将更加容易
- 区域现在以蓝色渐变而不是紫色渐变渲染
- 工具提示现在跟随鼠标,而不是位于预先计算的位置
- 区域、图表轴和点不再渲染在图表边界之外
- 使用
npx @grafana/create-plugin@1.0.0
重新构建,以确保源文件和依赖项是最新的 - 更好地支持 long 和 multi-frame 时序数据(wide 时序数据尚未实现)
- 目前,如果您正在使用 wide 时序数据,请使用 Grafana 转换将其转换为 long 或 multi-frame 格式
- 独立应用程序现在默认向数据点添加时间戳
README.md
的次要更新,解释新的 ASHRAE 指南并更新徽章- 在
plugin.json
中添加官方 Grafana 博客文章链接 - 在
plugin.json
中添加更多相关的搜索关键字
2.0.1
- 修复了
README.md
中损坏的徽章 - 修复了
README.md
中指向版权声明的链接 - 移除了对插件签名的引用
- 构建管道的次要改进
2.0.0
- 使用新的 Grafana 插件构建器来自
npx @grafana/create-plugin
- 添加了用于兼容性和测试构建的额外工作流程
1.1.1
打包的次要更新。
- 修复了不正确的包名称实例。
- 更新了网站 URL
- 添加了插件下载 URL
1.1.0
在 Grafana 中的首次公开发布。点击此处访问插件页面。
- 更新了徽章
- 更新了截图
README
中的其他小修复
1.0.2
包含一些次要非代码更新的预发布版本。
README
和CHANGELOG
中的小编辑
1.0.1
包含数据源 bug 修复的预发布版本。
- Psychart 现在可以检测数据源是否按其帧名称、字段名称或两者的组合来调用每个系列(例如,静态数据源)
1.0.0
包含基础功能的初始发布版本。
- 湿空气属性的一个数据系列可视化,具有各种字段选项
- 强大的图表编辑器,具有图表选项和显示选项
- 通过鼠标悬停在数据点或图表部分上实现交互性