插件〉Psychart

面板

社区

Psychart

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

Psychart v4.5.0

数据中心健康和人体舒适度的焓图

在焓图上查看空气条件。

什么是焓图？

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

干球
- 使用干球温度计测量的空气温度。
湿球
- 湿球温度可以从水面蒸发的表面上实际解释。
露点
- 水分在或低于此温度时将从不饱和空气中冷凝。
相对湿度
- 空气中水蒸气压强与饱和水蒸气压强的比值。0%rh 表示绝对干燥空气，100%rh 表示饱和空气。

Psychart 还具有以下求解状态变量的能力，这些变量可以通过显示选项中的 显示高级状态变量 开关可选地显示。

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

入门教程

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

面板选项

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

图表选项

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

允许用户选择是否以英美单位或国际单位制来报告测量结果，本地海拔，图表边界，翻转X和Y轴，以及可选显示ASHRAE舒适区域（包络线）。对于数据中心包络线，这些舒适区域遵循2021年ASHRAE标准，适合各种关键性的数据中心和IT空间。对于人体舒适包络线，这些舒适区域遵循2017年发布的ASHRAE-55指南。这些人体舒适包络线是代谢率（MET，依赖于室内活动）、服装水平（《CLO》）和风速的函数。在两种情况下，包络线显示供入室内空间的调节空气的目标区域。

数据选项

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

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

需要注意的是，根据数据结构可能需要一个或两个查询。一个查询可能足以返回固定状态的所需两个字段。有时，需要一个查询来获取干球字段，另一个用于相对湿度字段，例如。

不同的数据系列相互独立 - 一系列可能包括干球和湿球测量结果，另一系列可能包括干球和露点测量结果。

系列显示选项

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

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

其余选项更改图表中数据的视觉外观。允许用户更改点半径，可选地绘制相邻点之间的线，并为数据系列选择颜色渐变。渐变始终使用更饱和/对比鲜明的颜色来表示最近的数据点，无论主题（浅色/深色）偏好如何。用户还可以选择在此查看更多的状态变量。

错误和故障排除

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

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

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

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

最后，如果您升级到Psychart的新版本后遇到问题（例如区域无法渲染），请尝试打开面板编辑器，重新应用您的自定义设置，并保存面板。有时，面板选项在版本间可能没有正确存储。

许可

Psychart由Nicolas Ventura创建，由伯克利实验室拥有，该实验室是受DOE资助的国家级实验室，并且根据BSD-3-Clause-LBNL许可协议分发。

插件ID	最后更新	版本
`ventura-psychrometric-panel`	`2024-08-09`	`4.5.0`

屏幕截图

基本HVAC应用案例：数据中心空气处理器供應條件

户外天气应用案例 户外天气条件应用案例

Psychart使用国际单位制 使用Psychart与国际单位制

HVAC设计应用案例：将Psychart用作气象热湿图计算器

Psychart的标准面板编辑器示例

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

多序列#2 Psychart可以同时处理大量数据

使用Psychart渲染Mollier图

在Grafana Cloud上安装Psychart

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

变更日志

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来支持渲染Mollier图（感谢@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个数据系列。
选择性地删除默认导出，优先使用命名的导出（撤销4.0.1中的更改）。
区域着色现在受Grafana主题影响以获得更好的对比度。
添加IBM TS4500环境条件包。

4.1.0

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

4.0.6

更新到最新版本的@grafana/create-plugin（3.5.0）
- 更新工作流程操作依赖的版本，感谢我的pull request！
更新仪表板配置
- 数据源是随机的30Hz数据流
在运行器中添加-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动作
- 添加仪表板配置
对运行器文件进行重大更新
- 使用getopts检查选项
- 重新设计插件验证和发布中的逻辑/错误消息

4.0.1

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

4.0.0

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