pyhaystack 3.0.0

这是什么？

Pyhaystack是一个模块，允许Python程序通过建筑语义数据模型（project-haystack）连接到haystack服务器。

浏览校园、建筑、楼层……找到VAV箱、AHU单元等。然后从它们中提取历史数据，并使用pandas或您自己的数据库实现将结果准备好以进行分析。

实现了哪些客户端？

实际上，可以与

• Tridium的Niagara4

• Tridium的NiagaraAX

• Widesky by Widesky.cloud

• Skyspark by SkyFoundry（版本2和3+）

连接到Niagara AX或Niagara 4需要安装并正确配置Jace上的nHaystack模块，由J2 Innovations提供。有关详细信息，请参阅nHaystack文档。

如何安装pyhaystack？

pip install pyhaystack

或者，您也可以克隆develop分支并使用

python setup.py install

使用虚拟环境

您可以在virtualenv网站上找到更多关于如何使用virtualenv的信息，但以下是一个使其工作的简单方法。

sudo pip install virtualenv
mkdir your project folder
cd project
virtualenv venv
source venv/bin/activate

因此，现在您已经在虚拟环境中（在控制台中的括号内），您

pip install requests
pip install hszinc
pip install pyhaystack

（注意，这次您在尝试安装pandas并需要xcode来完成安装时不会看到任何奇怪的消息。）您现在可以

import hszinc
hszinc.MODE_ZINC
from pyhaystack.client.skyspark import SkysparkHaystackSession

什么是project-haystack？

如网站所述

“Project Haystack是一个开源倡议，旨在简化物联网数据的处理。我们标准化语义数据模型和Web服务，旨在使从渗透我们家庭、建筑、工厂和城市的智能设备产生的海量数据中释放价值变得更加容易。应用包括自动化、控制、能源、暖通空调、照明和其他环境系统。”

——Project-Haystack

实际实现

Pyhaystack稳健且将准备好进行异步开发。

我们选择了状态机方法加观察者模式。有关更多信息，请参阅文档。

此实现主要得到了Widesky.cloud和Servisys的支持。我们希望更多的人能加入我们的努力，共同构建一个良好的开源软件，为Python用户提供建筑数据分析的大门。

依赖关系

Pyhaystack高度依赖于hszinc，它是一个用于zinc编码数据的专用解析器。Zinc是为project-haystack创建的CSV替代品。

为了分析，我们还建议使用Pint来处理单位。它将为pyhaystack带来许多可能性（例如单位转换）