README.md · paydy/read-becs-report

去你大爷的斯维尔节能(BECS tool)v0.0.13c
==

目录
==

* [介绍](#介绍)
* [功能](#功能)
  + [广西夏热冬暖地区（南区、北区）居住建筑](#广西夏热冬暖地区南区北区居住建筑)
    - [1.建筑节能专项说明](#1建筑节能专项说明)
    - [2.计算书](#2计算书)
    - [3.广西居住建筑节能设计审查表](#3广西居住建筑节能设计审查表)
  + [广西夏热冬暖地区公共建筑](#广西夏热冬暖地区公共建筑)
* [如何使用（发行版）](#如何使用发行版)
  + [使用步骤](#使用步骤)
  + [注意事项](#注意事项)
* [如何使用（Python源码）](#如何使用Python源码)
* [开发日志](#开发日志)

-----

# 介绍

**去你大爷的斯维尔节能**是为了弥补坑爹的斯维尔节能输出报告的缺陷而诞生的程序，程序的开发目的是减少建筑节能设计人员输出节能成果的时间，把真正的精力和时间投入到设计中来。

去你大爷的斯维尔节能可以让你在计算好节能模型后不必花费太多的时间来反复对照表格，不再需要反复地神经紧绷地对比表格上的数据，将你从繁忙的制表工作中解放出来。

-----

# 功能

目前只适配了广西夏热冬暖地区，理论上广西夏热冬冷地区的节能设计也适配

## 广西夏热冬暖地区（南区、北区）居住建筑

### 1. 建筑节能专项说明

如果你已经从事节能设计一段时间你应该知道斯维尔节能导出的表格是散落破碎的AutoCAD对象，甚至带有错误，这个功能会让你得到一个新的 `Excel` 文件输出，输入到 `.dwg` 图纸文件需要配合天正建筑的 `excel2sheet` 命令来使用。这个 `Excel` 文件的**100%**的数据全部来源于建筑节能计算书与审查表，**0%**的数据来自隔热检查计算书。程序会提供以下功能：
  + 自动填写**工程概况**
    - 外围护结构主要节能措施、外墙颜色和推广的新技术需要一点人工核实的工作
    - 自动填写使用得最频繁的遮阳形式
  + 自动填写**外围护结构构造及热工性能参数表**
    - 默认自动去除掉“外墙构造一：”和“屋面构造一：”这样类似的字样，简化**构造部位**列
    - 默认如果构造部位有采用**聚苯**字样的材料，会自动填写其对应的燃烧性能为B1级。支持添加和删除关键字眼，所有包含这些字眼的构造材料会填写为与其相对应的燃烧性能等级，其他情况默认填写A级
    - 自动填写缺失的热阻数据，默认填写小数点后3位
    - 热惰性指标和传热系数指标默认不直接采用计算书的计算结果，而是采用了读取基本属性的参数（如：厚度、热阻、导热系数等）再进行公式计算，最终录入Excel表格，默认填写小数点后3位

！注意：这两个数据是使用以下这些公式计算的：
      |  参数名称   |   单位   |           计算公式           |
      |:-----------:|:--------:|:----------------------------:|
      |  传热系数K  | W/(m²·k) |      1/(0. 16+热阻之和)      |
      |    热阻R    | (m²k)/W  |   厚度/导热系数(/修正系数)   |
      | 热惰性指标D |    -     | 热阻\*蓄热系数（\*修正系数） |
      如果你注意到Excel里面的热惰性指标和传热系数指标数据跟节能计算书的数据在小数点后的数字上有些许出入，这可能是跟四舍五入的次数有关，要理解这个概念，你可以先观察下面这两个简单的公式：
      * 1.5(2) + 1.5(2) + 1.5(2) + 1.5(2) + 1.5(2) = 10
      * 1.5 + 1.5 + 1.5 + 1.5 + 1.5 = 7.5(8)

首先，括号里面的数字是表示进行四舍五入后的结果。第一个公式在每一个相邻的计算因子进行计算的时候都进行了四舍五入，而第二公式只在最后一步进行了四舍五入，虽然它们的计算因子的数目都一样，都是5个“1.5”，但是因为四舍五入的次数和步骤导致了最终的结果相差了2。同样地，假使这个公式足够长、计算因子足够多的话，这个差距会随着公式的复杂程序和更多计算因子的加入而被扩大。
    
      所以，为什么这个程序在编写的时候会默认采用第二种公式，只在最后一步四舍五入，减少不必要的偏差。当然，如果你发现Excel里面的数据与计算书里面的数据差得要多得多，我的意思是，不是简单的小数点后百分位数的差异的话，你可以向我反馈。
    
      ✍<https://gitee.com/iaso2h/read-becs-report/issues>
    * 当不同的构造部位出现在**建筑计算书**时，不一定要填写在**外围护结构构造及热工性能参数表**上，具体分类如下表
      
      ✅：需要填写
      
      ❌：不需要填写
      
      *例子：ABC123#项目属于居住建筑夏热冬暖地区（南区），斯维尔节能软件导出的建筑节能计算书包含有“凸窗顶板、凸窗底板、凸窗侧板、挑空楼板”这四个构造的内容，但是只有“凸窗顶板”需要填写在外围护结构构造及热工性能参数表上*
      
      |         建筑性质与气候地区         | 屋顶、梁、板、柱、墙 | 阳台隔墙 | 凸窗顶板 | 凸窗底板、侧板 | 挑空楼板 |
      | :--------------------------------: | :------------------: | :------: | :------: | :------------: | :------: |
      | 居住建筑夏热冬暖地区（南区与北区） |          ✅           |    ✅     |    ✅     |       ❌        |    ❌     |
      |        居住建筑夏热冬冷地区        |          ✅           |    ✅     |    ❌     |       ❌        |    ✅     |
      |              公共建筑              |          ✅           |    ❌     |    ❌     |       ❌        |    ✅     |
  + 自动填写**外窗热工表**
    - 原斯维尔节能导出的节能设计专项说明的外遮阳遮蔽SD和综合遮阳系数Sw是错误的
    - 对于玻璃的自遮蔽系数Se，你需要自己填写，因为这个在计算书是找不到的
    - 两种及两种以上的外窗构造仍需要手动填写部分参数，这部分的参数在Excel中以**红色**背景显示
    - **气密性**那一列的数据默认按照**建筑节能计算书**的外窗气密性表格的**最高级**的气密性来填写
    - 不支持超过一个天窗构造的工程
    - 含有凸窗侧板构造的工程可能会引发BUG
  + 自动填写**外窗遮阳表**
    - 有的项目需要这个表，有项目则不需要。总之，本程序能帮你自动读取东西向所有的门窗数据的遮阳形式，并制成表格
    
    - 当外遮阳编号为填写为“ ”、“    ”、“       ”等由纯空格符组成的名称时，程序会尝试跳过该行，不在 `.excel` 文件上填写

- 当有两个及两个以上的门窗类型、门窗尺寸与门窗的外遮阳这三个参数一样时，填写数据在**外窗遮阳表**的时候会将这部分的行数合并。第一次使用时默认开启改选项
    
      ![duplicateMergeToolTip](md/duplicateMergeToolTip.png)
      
      
      
      ![duplicateMergeToolTip2](md/duplicateMergeToolTip2.png)
      
    - 门窗尺寸的是根据门窗编号反推而得，所以模数只能精确到整百，例如:
      |   门窗编号    |  门窗尺寸  |
      |:-------------:|:----------:|
      |   MLC2424-a   | 2400X2400  |
      |    TC2215     | 2200X1500  |
      |    MQ21435    | 21400X3500 |
      | 透光门M1524-1 | 1500X2400  |
      |    BY1515     | 1500X1500  |
      | CCTV1234-KTV  | 1200x3400  |
      | ABCD5678-EFGH | 5600X7800  |

- 自动填写**居住建筑节能设计指标一览表**
    - 南北东西四个方向的外遮阳系数SD默认采用来自建筑节能计算书的数据，不采用审查表的数据
    - 门窗开启与窗地比的考核那一栏会留空，需要自行填写，因为个人经验了解到绝大部分人做节能设计的时候“门窗类型”填写的“门窗开启比”往往不是真实对应得上的

### 2. 计算书

+ 统一建筑节能计算书的门窗遮阳系数术语：

将节能计算书内所有的门窗遮阳系数改为粗体部分，括号斜体部分为斯维尔节能使用过的别称，第一次使用默认开启
    - **窗框的遮阳系数Sf**
    - **窗玻璃的遮蔽系数Se** *（玻璃遮阳系数/玻璃自身遮阳系数）*
    - **窗的本身遮阳系数SC** *（窗遮阳系数/平均遮阳系数/自遮阳系数/自身遮阳系数）*
    - **窗口的外遮阳系数SD**
    - **外窗综合遮阳系数Sw**
    - 参考资料：《广西壮族自治区居住建筑节能设计标准》DBJ45/ 029-2016第19、139页
  + 去除计算书页眉与封面，第一次使用默认开启
  + 插入华蓝设计封面，第一次使用默认开启
    - 数据主要来自原来的计算书，包括原来的封面。所以当程序缺少原来斯维尔节能的封面信息时，会报错
    - 封面部分的计算填写的是计算用户名
    - 支持审核人、校核人和项目部门的自定义记忆， 当校核人与审核人的姓名为空时会提示检查
      ![customCoverInfoDemo](md/customCoverInfoDemo.gif)
    - 封面上的时间日期与页码统计采用了**Word域**对象每次输出的时候需要手动更新一下

### 3. 广西居住建筑节能设计审查表

+ 检查审查表与计算书外遮阳系数SD的一致性（因为审查表的南北东西四个方向的外遮阳系数SD会出现跟节能计算书不一致的情况），第一次使用默认开启

在该功能启用的情况下，当程序检测到数据有出入时会弹窗提示这些数据的区别与不同，并询问使用者意见来进行修改操作
    ![shadingParaConsistencyDemo](md/shadingParaConsistencyDemo.gif)

## 广西夏热冬暖地区公共建筑

很抱歉，公共建筑仅支持**外围护结构构造及热工性能参数表**的填写功能。据我了解，BECS2020的导出公共建筑的建筑节能设计专项说明的功能已经改善得很好了，未来的版本更迭可能不会跟进与公共建筑相关的功能了

-----

# 如何使用（发行版）

## 使用步骤

1. 将 `**隔热检查计算书.docx` 、 `**建筑节能计算书.docx` 、 `**隔热检查计算书.docx` 与 `**广西居住建筑节能设计审查表.docx` 放到与 `BECS tool.exe` 同一目录下
   * 注意： `**` 的意思是任意的字符串前缀，例子： `ABCD大楼建筑节能计算书.docx` 、 `123#建筑节能计算书.docx` 、 `TEST_大楼建筑节能计算书.docx` 都符合 `**建筑节能计算书.docx` 的要求。
   * 你可以在**自动选择文件模式**下，自定义软件搜索文件名称的关键字，例如：把“建筑节能计算书”改成“建筑节能设计报告书”
    ![cumstomSearchKeyword](md/cumstomSearchKeyword.gif)
   * 你可以选择**手动选择文件模式**，自行选择文件，忽视文件名字

2. 运行 `BECS tool.exe` 
3. 当程序成功输出的时候会有一个带有时间后缀的 `.xlsx` 文件生成，例如： `ABCD外围护结构构造及热工性能参数表2020-3-8 200422.xlsx` 
4. 使用 `Microsoft Excel` 软件打开输出的 `.xlsx` 文件，运行天正建筑，打开 `\src\套用表格2020-4-21.dwg` 文件，执行 `excel2sheet` 命令，如图所示
    ![excel2sheetDemo](md/excel2sheetDemo.gif)

## 注意事项

1. 请勿随意更改、删除 `./src文件夹` 下的所有文件
2. 不支持 `.doc` 格式的文件
   * 关于建筑节能设计审查表，当保存成 `.docx` 会造成排版问题的话可以通过取消“重复标题行的”选项来避免
    ![exaReaptHeaderDemo](md/exaReaptHeaderDemo.gif)
3. 不支持超过一个天窗构造的工程
4. 两种及两种以上的外窗构造仍需要手动填写部分参数，这部分的参数在Excel中以**红色**背景显示
5. 含有凸窗侧板构造的工程可能会引发BUG
6. 含有挑空楼板楼板的公建工程可能会引发BUG
7. 关于天正建筑的 `excel2sheet` 命令

* 关于天正建筑的天正表格对象的有关操作可以查阅“T20天正建筑软件 T20-Arch V5.0 使用手册”284页（以天正T20V5.0为例）
   * 在 `AutoCAD` 中执行天正建筑的 `excel2sheet` 命令时，你需要在 `Microsoft Excel` 中首先选中表格
   * 天正建筑不支持 `WPS office` 。目前我测试过的 `Microsoft Excel` 版本有2010、2013、2016、2019，均可以识别导入
   * 当你在使用 `Microsoft Excel 2019` 时，有一定的概率会发生只可以使用 `sheet2excel` 命令而不可以使用 `excel2sheet` 命令的BUG。你可以在 `AutoCAD` 中新建一个天正表格，再执行 `sheet2excel` 命令生成一个新的空白工作簿，再复制导出的节能设计专项说明的内容到这个空白工作簿上，此时空白工作簿的内容是可以使用 `excel2sheet` 命令来导入 `AutoCAD` 的
   * 当你使用了2010及以上版本的 `Microsoft Excel` 软件，却还不能使用 `excel2sheet` 命令来导入 `AutoCAD` 时，建议重装 `Microsoft Office` 软件

-----

# 如何使用（Python源码）

1. 下载Python3
2. 执行依赖包安装 `python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt` 
3. 执行 `python main.py`

-----

# 开发日志

2020-3-6 0.0.1版本：

* 实装自动填写**热阻**、**热惰性指标**与**燃烧性能**列的功能

2020-3-8 0.0.2版本：

* 更新使用说明，并附上模板 .dwg`文件

2020-4-2 0.0.3版本：

* 剔除对于从斯维尔节能导出来的外围护结构构造及热工性能参数表的依赖性
* 广西夏热冬暖地区、居住建筑的建筑节能说明的所有表格自动填写功能
* 广西夏热冬暖地区、居住建筑的建筑节能说明的建筑节能专项说明的外围护结构构造及热工性能参数表的填写
* 删除节能报告页眉的“绿建斯维尔”样式
* 添加数据依据
* 替换上华蓝封面，输入操作人的名字在封面

2020-4-3 0.0.4版本：

* 可执行程序打包
* 添加门窗遮阳系数术语检查
* 审查表与计算书外遮阳系数SD的一致性检查
* 添加log功能

2020-4-4 0.0.5版本：

* 添加自定义设置，现在你可以自由搭配自己想要的功能了
* 现在检查外遮阳SD的一致性的时候你可以看到具体什么地方对应不上了

2020-4-6 0.0.6版本：

* 更好的文件名称检查流程
* 更好的错误提示
* 添加检查项目名称检查功能
* 不再支持Word文档的97-2003(. doc)格式
* 记忆项目设置
* 项目使用次数统计
* 更好的日志BUG记录反馈

2020-4-7 0.0.7版本:

* **外围护结构构造及热工性能参数表**填表功能BUG修复
* 支持记忆部门名称
* 当西向和东向的窗户在没有添加外遮阳的情况下也能通过计算时，不会在**外窗遮阳表**填写这部分的空白外遮阳
* 添加对凸窗顶板和侧板的支持
* 完善日志功能

2020-4-10 0.0.8版本

* 添加对使用 `uft-8-sig` 加密的 `.json` 文件的支持
* 修复**工程概况表**显示层数不全的问题

2020-4-21 0.0.9版本

* GUI界面！更友好的使用体验，程序取名为“去你大爷的斯维尔节能”
* 自定义输出路径
* 支持记忆审核人和校核人
* 鼠标悬浮提示
* `.dwg` 模板修改

2020-4-30 0.0.9a版本

* 修复没有工程大样的情况下对规范依据的识别BUG
* 修复小数点显示异常的BUG
* 修复B1燃烧材料的识别算法
* 支持手动选择文件模式，忽视文件名称
* 支持自动选择文件模式下，自定义搜索文件时使用的关键字

2020-5-4 0.0.9b版本

* 修复公共建筑不能导出 `建筑节能专项说明.xlsx` 的问题
* 改进导出文件的流程机制，当发生错误时，弹出窗口提示
* 不再兼容0.0.9以下版本的设置信息

2020-5-8 0.0.9c版本

* 改正错别字
* 更新说明文件。添加 `README.html` ，删除 `README.pdf` 
* 修复图标丢失
* 修复外窗遮阳表填写错误的BUG

2020-5-9 0.0.10版本

* 修复导入节能审查表模块的BUG
* 修复识别项目性质为住宅建筑的错误BUG，这个BUG会导致很多功能模块运行错误
* 更新说明文件
* 更新图标

2020-5-12 0.0.11版本

* 修复日志显示问题
* 填写外窗热工表的时候，如果正则表达式在获取窗名称或玻璃品种名称失败，会弹窗提醒使用者

![image-20200512183011864](md/image-20200512183011864.png)

2020-5-14 0.0.12版本

* 修复封面信息设计人信息不能存储的BUG
* 修复自定义文件的关键字的显示BUG
* 修复因为门窗编号命名不规范引发的BUG
* 修复东南西北四个方向的墙面积为引发的BUG
* 更正凸窗构造在**外围护结构构造及热工性能参数表**中的填写错误
* 更正因为“隔热反射涂料”的参数为“-”引发的计算错误
* 改进**节能审查表**检查综合外遮阳系数Sw的识别规则
* 程序输出结束会弹窗提示不规范的地方

2020-5-17 0.0.13版本

* 修复外窗遮阳表东向与西向重复的数据错误
* 修复外窗热工表窗种类名称与玻璃名称重复的BUG
* 修复天窗的填写BUG
* 去掉多余的弹窗警告
* 建筑节能计算书代码重构，取消命令窗口的支持

* 支持广西居住建筑的**夏热冬冷地区**与**夏热冬暖地区北区**的节能文档，更新对应的 `.dwg` 模板

2020-5-17 0.0.13a版本

* 修复外遮阳表BUG

2020-6-8 0.0.13b版本

* 在Excel中高亮空白的遮阳类型名称
* 重构寻找文件的代码

2020-6-10 0.0.13c版本

* 修复公建外围护结构及热工性能参数表的填写BUG
* 修复导出文件名称填写BUG

paydy/read-becs-report

简介

发行版

贡献者

近期动态

paydy/read-becs-report .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

paydy/read-becs-report