插件 〉Psychart


开发者

Nicolas Ventura

注册以接收不定期产品新闻和更新



面板
社区

Psychart

  • 概览
  • 安装
  • 变更日志
  • 相关内容

Psychart v5.0.0

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

GitHub Workflow Status GitHub Workflow Status GitHub Workflow Status GitHub Workflow Status

Marketplace Downloads Popularity

在湿空气焓湿图上查看空气条件。

什么是湿空气焓湿图?

湿空气焓湿图是由 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-panel2025-04-235.0.0

版权声明

在 Grafana Cloud 上安装 Psychart

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

变更日志

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
  • 更新依赖项版本

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% 显示的 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
  • 渐变图标现在根据渐变定义自动生成
  • 在设置 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
  • 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
  • 在验证脚本中自动构建和验证插件

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

包含一些次要非代码更新的预发布版本。

  • READMECHANGELOG 中的小编辑

1.0.1

包含数据源 bug 修复的预发布版本。

  • Psychart 现在可以检测数据源是否按其帧名称、字段名称或两者的组合来调用每个系列(例如,静态数据源)

1.0.0

包含基础功能的初始发布版本。

  • 湿空气属性的一个数据系列可视化,具有各种字段选项
  • 强大的图表编辑器,具有图表选项和显示选项
  • 通过鼠标悬停在数据点或图表部分上实现交互性