冷却零回退为何必须保留为失败行
区分合理的零冷却与求解器回退,解释 PMV 和 PPD 时让失败测量始终可见。
数值必须连同产生它的分支阅读
来源讨论提出通过 pandas.itertuples 完整逐行计算 PMV/PPD 的工作流,但私有测量表未公开。可采用的要求是保留每次测量及结果,而不是声称复现无法取得的数据集。
本工具固定采用 jsthermalcomfort 1.4.0 的 ISO7730-2005 与 ASHRAE55-2020。ISO 不使用 ASHRAE 冷却路径;ASHRAE 在风速不超过 0.1 m/s 时不需要冷却调整。CE 求解器也可能在带回退警告时返回零,仅凭数值无法区分这些情形。
| 情形 | CE 含义 | 逐行处理 |
|---|---|---|
| ISO7730-2005 | 此路径不包含 ASHRAE 冷却。 | PMV/PPD 仍须通过输入与适用范围检查。 |
| ASHRAE55-2020,SI 相对风速 ≤0.1 m/s | 零表示无需冷却。 | 它本身不会使 PMV/PPD 行失败。 |
| ASHRAE 冷却求解器带警告返回零 | 零是失败回退,不是成功 CE 估计。 | 保留 cooling-failed、警告及 null PMV/PPD。 |
判断冷却值前先沿原始单位追溯
SI 温度和风速分别是 °C、m/s;IP 使用 °F、ft/s。IP 数值在 CE 前转成 SI,CE 本身是以 °C 表示的温差。RH 始终是百分数,met 和 clo 在两个体系中的单位相同。
输入风速已经相对化,再调整一次会改变被分析的测量。动态服装也应是明确设置,不能静默修正。对照 input、effectiveSI 和 modelInputsSI,可查看单位转换及冷却调整。
- 使用 0.1 m/s 冷却边界前,先确认原始温度和风速单位。
- 在保存的设置中保留动态服装和风速控制选择。
- 遇到可疑零值,先查冷却状态和原警告,再看最终 PMV 单元格。
完整序列不等于只列成功行
删除所有无效或不适用测量,会让剩余表格看起来比原始序列更可用。重复标识及其行序号、所有辅助单元格与明确状态均应保留。完整报告可以包含失败行,同时仍准确覆盖原件。
invalid-input、not-applicable、cooling-failed、non-finite、non-convergent 和 engine-error 行保留 null PMV/PPD,不制造舒适度数值。整件语法或 UTF-8 失败不同:它不会产生完整结果包。分享筛选分析时,应说明每类剔除行的数量与原因。
- 发布平均值或比较前,对齐原始行、有效行及各类失败数量。
- 将原始标识与行序号一起保留,避免重复标签合并测量。
- 任何被下游分析剔除的行都应保留警告原文和设置。
在固定模型内解释 PMV 与 PPD
PMV 预测平均热感觉,接近零表示模型中的热中性。PPD 估计模型群体的不满意百分比。它们既不是直接问卷,也不是每位个体舒适或健康状况的保证。
适用范围是结果的一部分:旧版 ISO 与 ASHRAE 路径的允许范围不同,ISO 另含明确的 met ≥0.8 条件。范围外得到有限运算值仍不能成为有效行。PMV/PPD 不作输出修约,但原 CE 与动态服装的修约保留。
ISO7730-2005 与 ASHRAE55-2020 标识的是已实现的历史路径,不能认证新版合规。关联操作文档说明绑定与导出;当前工具参考提供完整参数及限制。
分享复核包,而不只分享图表
将 thermal-comfort.csv、thermal-report.json、thermal-comfort.svg、原始不变的 thermal-source.csv 或 thermal-source.json、settings.json 和 NOTICE.txt 一起保存。SVG 包含无效状态,完整报告及完整单元格阅读器保留分页预览缩略的值。运行时与 CSV 保留负零,JSON 报告附完整符号路径。
整次任务需满足 32 MiB 输入、100,000 行、含辅助和无效值在内的 2,000,000 单元格、10,000 冷却行、1,000,000,000 实际工作计费、128 MiB 物理下载合计、512 MiB 联合自有分配,以及捕获至首次发布 300 秒。完整文本和复制文本各限 128 MiB,紧凑类型化 JSON 限 256 MiB,合计限 640 MiB,传输限 2 GiB;这些表示轴不会增加内存,也不保证各最大值同时达到。
iso-normal JSON 示例和完整的两行 CSV 示例均已核对。CSV 的有效结果与 RH 为 150、PMV/PPD 为 null 的行在六份导出文件中完整保留。示例核验并不证明最大联合容量或完整浏览器使用流程已经通过验收。
参考资料
- grjonathan: complete pandas.itertuples PMV/PPD workflow
已读取完整封存问题、两条评论及五条时间线。私有测量未公开。
- jsthermalcomfort 1.4.0 (MIT)
固定八个 ESM 源叶;保留原运算,仅加入计量与失败守卫。
本分类工具使用说明
展开工具,查看操作步骤、可调选项和支持范围,再直接进入工作区。
热舒适测量序列完整逐行计算 PMV/PPD,保留明确状态并生成六份可复核下载。
绑定温度、已相对化风速、湿度、met 与 clo 列。连同原始单元格及明确失败状态阅读 PMV、PPD 和 ASHRAE 冷却效应,再保存完整表格、报告、图表、原件、设置及说明。
操作步骤
- 选择一份完整 UTF-8 CSV 或 JSON 表格,并确认当前格式选项。
- 绑定从 1 开始的测量角色,选择 SI/IP、固定模型、动态服装及风速控制设置。
- 运行完整序列,对齐全部行序号、失败状态、警告及可用结果。
- 阅读完整单元格与报告,再将六份下载和原始设置一起保存。
可调选项
- 原件格式
- CSV · JSON
- 单位制
- SI (°C, m/s) · IP (°F, ft/s)
- 固定旧模型
- ISO 7730:2005 · ASHRAE 55:2020
- 明确启用动态服装调整
- 默认关闭
- 使用者可控制风速
- 默认开启
- 行标识
- 1
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 室内温度
- 2
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 平均辐射温度
- 3
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 已经调整的相对风速
- 4
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 相对湿度(%)
- 5
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 代谢率(met)
- 6
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 服装热阻(clo)
- 7
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
- 外部功(met)
- null
列位置从 1 开始,所有数值角色必须使用不同列。只有未绑定的外部功列明确使用零;绑定列中的空白、null 或缺失仍是无效输入。
能力与限制
- 选择一个原始文件或粘贴完整文本。支持严格 UTF-8、有表头的 CSV,或 JSON {schema:"neatbo.thermal-comfort.input.v1",columns:[...],rows:[...]}。保留开头 BOM 和完整原始字节。JSON 单元格为字符串、有限数值、布尔值或 null;拒绝嵌套单元格和重复对象键。
- 用从 1 开始的列位置绑定八个角色:行标识、室内温度、平均辐射温度、已调整的相对风速、RH、met、clo 和可选外部功。数值角色不能共用列。未绑定外部功明确使用零;绑定列中的空白、null 或缺失值无效。表头、辅助、参差及无效单元格均计入预算。
- SI 使用摄氏度和 m/s,IP 使用华氏度和 ft/s。原转换先执行 IP→SI,再调用默认 SI 冷却路线。RH 是 0–100 的百分比。相对风速不重复调整。动态服装默认关闭,仅在明确启用时使用原 ISO/ASHRAE 阈值。
- 固定 jsthermalcomfort 1.4.0 的 ISO 7730:2005 或 ASHRAE 55:2020 模型,输出不取整,适用范围检查始终启用。ISO met≥0.8 是明确额外适用条件。这些模型不认证最新标准符合性。
- 保留每一行、重复标识、完整原数词、解码值、UTF-16/UTF-8 位置及所有设置。无效或不适用行保留状态,PMV/PPD 为 null。非有限值、不收敛及带警告的冷却零回退均为失败,不能显示为有效热舒适结果。
- ASHRAE 仅在相对风速超过 0.1 m/s 时计算冷却。原 SET 与 ET 都实际执行并计费。保留原 PMV/服装 150 次和 Brent 100 次局部迭代上限,不新增 SET/ET 局部小上限。
- 联合上限:输入 32 MiB、100,000 个测量行、2,000,000 个来源单元格(包括表头、辅助及无效值)、10,000 个冷却行、1,000,000,000 次真实循环/调用计费。还须共同满足完整输出与内存预算,不承诺各轴同时达到最大值。
- 六份完整下载:全行 CSV、完整报告 JSON、包括无效状态的全行 SVG、未改变的原件、设置及完整许可说明。运行数值和 CSV 保留负零,报告的完整排序 numericNegativeZeroPaths 用于恢复 JSON 数值的符号。
- 实际下载、完整报告文本、完整复制文本分别最多 128 MiB;全部紧凑 typed JSON 最多 256 MiB;总计最多 640 MiB;二进制及全部转义元数据/文本传输计数最多 2 GiB。真实持有分配共同预检 512 MiB,不将此称为实测浏览器最大堆。
- 单一绝对 300 秒期限覆盖原件元数据/读取、导入、计算、完整验证、清理、六份真实文件及首次结果发布。取消、失败或迟到清理不返回部分结果。保留相同原件与设置以便全新任务恢复。联合最大容量及真实跨浏览器验收仍待验证。