智能构件PythonParts入门教程

1、什么是 PythonParts

Planbar 提供一套参数化的构件，如叠合楼板、叠合墙板等等；有时候用户为了提高建模以及出图效率会考虑定制开发一套符合自己公司标准的参数化构件，俗称参数化构件库，例如梁、柱、楼梯等等。

那么这时候用户就可以考虑使用 Planbar 平台提供的一种解救额方案-PythonParts.

PythonParts 是一种以 Python 编程语言书写的一种智能化构件，用户可以按照用户自己的需求进行定制化开发，以达到最高的建模和出图效率。

2 PythonParts API

Planbar 提供一整套详尽的 Python API，供用户使用，具体请参考网站：

https://pythonparts.allplan.com/

3 、入门介绍

下面介绍几个点，帮助大家更快地入门:

3.1    查询 ETC、STD 等相关文件夹路径

用户在安装完软件后，在桌面上有服务 2018、Planbar2018 两个按钮。点开服务

2018，就可以找到“一般程序数据”以及“办公室标准”者两个路径，即 ETC 和 STD 文件夹位置。

3.2    PythonParts 基本要求

一个成功的 Python Parts 需要两个文件夹来保存相关内容：std/Library 和 Std\PythonPartsScripts

3.3    Std\Library

这个路径是放置构件本身的，即构件入口文件，每个客户/用户可以创建自己的文件

夹，比如：PYP-Joerg，其下至少包括 xxx.png; xxx.pyp; xxx_chn.xml 以及 pics 文件夹

xxx.png                                        封面

xxx.pyp                                         构件入口

xxx_chn.xml               界面翻译

pics 文件夹                 保存所需要的图片（大样图）

建议打开 PYP 后，第一行为公司 LOGO

例如：Std\Library\PYP-Joerg

3.4    Std\PythonPartsScripts

这个路径是保存 xxx.py 文件的，是智能构件的运行逻辑，每个客户/用户可以创建自己

的文件夹，如 AT_reinforcement 或者 PY-ruan 等等。如果是默认安装，srd 下面是没

有 PythonPartsScripts 这个文件夹的，用户需要自己新建这个名字的文件夹。

例如：Std\PythonPartsScripts\AT_reinforcement

注意：这个自己创建的文件夹名字不可以同 Etc\PythonPartsScripts 下文件夹重名！！！具体名字如下图：

3.5    例子

PYP 内容

Std\Library\PYP-Joerg

PY 内容

Std\PythonPartsScripts\AT_reinforcement

3.6    最基本案例

Planbar 提供一整套最基本的案例，供客户/用户方便理解上手。进入 C 盘，打开影藏文 件 夹 ， 找 到 ProgrammData 文 件 夹 ， 之 后 依 次 进 入C:\ProgramData\Nemetschek\Allplan\2019\ETC\Examples，将 PythonParts 文件夹复制到 Std\Library 文件夹下面。

这样就可以在软件界面，库/办公室/PythonParts 中找到全面的最基本的 Python 库。