最近看到很多朋友问到有关建筑性能分析的问题
很多时候也问到了ladybug怎么用
就当凑个热闹吧
以此文抛砖引玉
和大家聊聊这个插件
同时你的电脑上还需要安装GHpython：
这是在grasshopper3d上的group：
里面可以到达各链接：
ladybug tools是一款免费的、开源的建筑性能分析软件
之前也想过用geco
不过在调用ecotect的时候出现了问题
所以我就转用ladybug了
前不久的住区规划
我找了一些参考案例
其中比如说无锡市太湖新城项目文本中的分析图
似乎就可以用ladybug来做
（上图来自无锡市太湖新城项目方案文本）
（上图来自无锡市太湖新城项目方案文本）
下面我们通过几个案例让大家了解一下它
比如说先从大家可能比较关心的日照开始吧：
使用ladybug软件之前
先把最左边的ladybug_ladybug拖到gh面板上
它相当于ladybug的运算大脑
不拖到面板上，很多运算器会爆红
ladybug基本上都需要
基于epw格式的气候文件进行分析
epw文件可以到energyplus上下载：
比方说搜索桂林，点击epw下载即可
下载好之后
在file path上右键set one file path将其载入进来
再用 import epw读取文件：
经过import epw后
桂林的气候信息
如温度、湿度、风向等就被读取了出来
这里比如说读取干球温度：
前面6个数据是气候数据的一些说明
后面的8760个数字
是一年中8760个小时的干球温度记录
不过我们做日照时数分析暂时用不上温度
接下来找到sunpath运算器
sunpath运算器看起来输入端很多
但其实接入地点它就可以运算了
因为ladybug的运算器
后面有下划线“_”表示有默认数据
可以看到输入端就地点没有"_"
将地点接入
太阳轨迹图就出现了
默认的太阳位置是12月21日12点
也就是冬至日（我国冬至日是12月22日左右）
这个小太阳其实是个mesh球体
ctrl m显示网格就可以看到
下一步
找到sunlight hours analysis日照时数分析运算器
观察一下sunlight hours analysis
要设置的数据有两个
geometry要进行日照分析的物体
sun vector 阳光照射的向量
这里先将体块模型拾取进来
需要注意的是
模型在哪里（圈内圈外）
并不会影响计算结果
因为阳光照过来是个vector
方向不会因为模型在哪里而改变
将地面与建筑接入geometry
（需要分析日照时数的几何体）
sun vector从sunpath接过来
gridsize是网格尺寸，也就是计算精度
用过其他类似软件的朋友应该了解
disfrombase是测试点网格偏移距离
设置成0.1就行
parallel是用multiple CPUs多个cpu来进行运算
runit就是开始运算
双击toggle，设置为ture
开始运算
稍等一下
得到运算结果
这里并没有得到我们想象那种渐变的效果
是默认的12月21日12时
桂林的住宅日照间距是按大寒日1月20日算的
所以这里设置成1月20日
得到一圈小太阳~
再点运算
得出结果：
嗯说这么多
其实就三部分：
此时的图例颜色
是根据日照时数默认的有个颜色渐变
但是要看哪些地方不符合日照时数要求
就不是很直观
可以回到sunlight hours analysis运算器
设置一下legend parameters（图例参数）
接过去
再运算：
完全是黄色的是符合2小时日照时数要求的
带蓝色的是不符合要求的
日照时数分析到此结束
下面就着上面的运算器还可以做一个
太阳位置与温度分析
这是因为sunpath上有annual hourly data这么一个接口
右键进去查看help文件
它可以用来给太阳上色
比如说干球温度
我们接一下看一下效果：
看不太清楚
将月份改成一年12个月
嗯同样的太阳高度
9月比3月要热。。
同样，这里的图例颜色可以根据
自己需要表达的信息
用legend parameters进行更改
（很重要，清晰地表达出想要表达的内容才是分析图应该做的）
3D chart
还是以干球温度来说
将干球温度接入3D chart的inputdata端
等一下，效果就直接出现了
但同样的
这个着色就是根据桂林全年的温度来渐变着色的
并不能很直观地反映哪些点温度比较高了
让人感觉到热了
所以还是通过legendparameters设置一下颜色
这里比方我将11℃和32℃分别设置为
冷的下限和热的上限温度
再看数据就显得更直观
再来解释下这个图怎么看
红色x轴表示天
绿色y轴表示每天的每小时
蓝色z轴表示温度
风向
找到wind rose
恩还是只有几个运算器
把风速和风向接过来即可
运算
得到桂林全年的风玫瑰图
除了全年的
用analysis period可以设置分析周期
比如说设置夏季的5-7月
运算得到：
冬季的（11-1月）：
嗯......
桂林的风向确实有点奇特
东北风在全年都占了大头
可能和桂林周边地形有关系吧
和sun path一样
wind rose同样有个annual hourly data接口可以接其他数据
同样以干球而温度为例：
运算得到结果
得到的图表自动帮你排好
也可以试试其他数据噢
新得到的这风玫瑰图注意单位是℃
是不是感觉特别智能
本文权当抛砖引玉
只是略介绍了ladybug的部分用法
而且关于honeybee和butterfly都没有介绍到
以后有机会再聊
大家也可以先玩玩~
前面有些讲起来很多
其实看看案例文件就觉得很简单了
不牵涉到什么数据结构的问题
只要一一连接就行了
软件易学
还是得多读书啊
再贴一遍链接
ladybug tools下载：
更多资源戳：
epw文件下载：
（包括本文gh文件，Ladybug 0.0.66 and Honeybee 0.0.63，桂林epw文件）