# PBSD二次开发

**Repository Path**: civilwilson/PBSD-SecondaryDevelopment

## Basic Information

- **Project Name**: PBSD二次开发
- **Description**: 基于PBSD的二次开发，功能包括：

1. 结构及构件性能评估；

2. 结构宏观分析结果：最大层间位移角，残余层间位移角，等；

3. 构件性能评估结果：构件变形、应变、需求能力比、变形限值，等；

4. 构件承载力计算及性能指标插值。

- **Primary Language**: C#
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2020-12-13
- **Last Updated**: 2024-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PBSD二次开发

## PBSD简介

* **结构抗震性能设计软件PBSD**包含[设计指标统计](https://help.gwforu.com/PBSD/DesignData)、[地震动工具箱](https://help.gwforu.com/PBSD/GMTool)、[弹塑性分析](https://help.gwforu.com/PBSD/PERFORM3D)、[抗震性能评估](https://help.gwforu.com/PBSD/SeismicPerform)等模块功能；

* PBSD正式版于2019年底上线，截止至2021年底注册用户超1500人，涵盖国内超250所设计院及高等院校；

* 点击跳转[PBSD官方网站](http://www.wwforu.com)，点击跳转[PBSD用户手册及功能介绍](https://help.gwforu.com)，点击[加入官方交流群](https://help.gwforu.com/PBSD/General/afaf)。

* 为满足研究人员及高级用户的需求，开放二次开发接口，可用于且不限于：不同方案间构件性能对比、批量模型构件损伤批量提取，等。

## 二次开发接口功能简介

* 结构及构件性能评估；

* **结构宏观结果-塔楼**：最大层间位移角GetMaxDrift、最大残余层间位移角GetMaxResDrift、顶点位移GetTopDisp、底部剪力GetBottomForce、底部倾覆弯矩GetBottomMoment；

* **结构宏观结果-楼层**：最大层间位移角GetMaxDrift、残余层间位移角GetResDrift、最大位移GetMaxDisp、最大剪力GetMaxForce、最大倾覆弯矩GetMaxMoment；

* **构件性能结果-塔楼**：单元组各楼层构件性能状态占比GetStoreyDeformPerformRatio;

* **构件性能结果-楼层**：单元组楼层平均变形GetAVGDeform、单元组楼层平均变形需求能力比GetAVGDeformDCR；

* **构件性能结果-构件**：变形大小GetDeform、变形限值GetDeformLimits、变形需求能力比GetDeformDCRList、某性能的变形需求能力比GetDeformDCR、压应变GetCompressStrain、拉应变GetTensionStrain；

* **截面承载力计算与构件变形指标插值**；

* C#使用案例详见[ExampleDemo.cs](https://gitee.com/civilwilson/PBSD-SecondaryDevelopment/blob/master/PBSD_Development/PBSD_Development/ExampleDemo.cs)；

## 结构及构件性能评估：C#使用说明

#### 架构与文档

![架构与文档](http://server.wwforu.com//application//GiteeImage//PBSD-Doc20211204.png)

#### 分析结果FEMResultObj

```C#

/// <summary>
/// 构造分析结果
/// </summary>
/// <param name="directPath"> PF3DS所在路径或.tcl所在路径 </param>
/// <param name="isReRead"> 如果宏观分析结果存在，是否重新读取 </param>
FEMResultObj result = new FEMResultObj(string directPath, bool isReRead);

/// <summary>
/// 反序列化构件分析结果
/// </summary>
/// <returns> 是否成功 </returns>
bool isSuccess = result.SetElementResult();

```

#### 工况LoadCaseObj

```C#

/// <summary>
/// 地震工况列表
/// </summary>
/// <returns> 工况对象列表 </returns>
List<LoadCaseObj> loadCaseList = result.GetGroundMotionLoadCaseList();

//获得工况
LoadCaseObj loadCase = loadCaseList.First();
//获得工况名称
string loadcaseName = loadCase.Name;

```

#### 体系SystemObj

```C#

/// <summary>
/// 获得体系（多塔塔楼集合）
/// </summary>
/// <returns> 体系对象 </returns>
SystemObj system = result.GetSystem();

/// <summary>
/// 获得所有塔楼
/// </summary>
/// <returns> 塔楼对象列表 </returns>
List<TowerObj> towerList = system.GetTowerList();

```

#### 塔楼TowerObj

```C#

/// <summary>
/// 获得体系第一塔楼
/// </summary>
/// <returns> 塔楼对象 </returns>
TowerObj tower = result.GetFirstTower();

/// <summary>
/// 获得体系第一塔楼
/// </summary>
/// <returns> 塔楼对象 </returns>
TowerObj tower = system.GetFirstTower();

/// <summary>
/// 体系内塔楼查询
/// </summary>
/// <param name="towerIndex"> 塔楼编号 </param>
/// <param name="towerObj"> 塔楼对象 </param>
/// <returns> 是否存在 </returns>
bool isExist = system.GetTower(int towerIndex, out TowerObj towerObj);

/// <summary>
/// 塔楼最大层间位移角
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向层间位移角 </param>
/// <returns> 层间位移角 </returns>
var maxDrift = tower.GetMaxDrift(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 塔楼最大残余层间位移角
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向残余层间位移角 </param>
/// <returns> 残余层间位移角 </returns>
var resDrift = tower.GetMaxResDrift(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 塔楼最大顶点位移
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX">  X向/Y向顶点位移 </param>
/// <returns> 位移 </returns>
var topDisp = tower.GetTopDisp(LoadCaseObj loadcase, bool isX);
                
/// <summary>
/// 最大基底剪力
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX">  X向/Y向基底剪力 </param>
/// <returns> 基底剪力 </returns>
var baseShear = tower.GetBottomForce(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 最大基底倾覆弯矩
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向倾覆弯矩 </param>
/// <returns> 倾覆弯矩 </returns>
var baseMoment = tower.GetBottomMoment(LoadCaseObj loadcase, bool isX);

```


#### 楼层StoreyObj

```C#

/// <summary>
/// 塔楼所有楼层
/// </summary>
/// <returns> 楼层列表 </returns>
List<StoreyObj> storeyList = tower.GetStoreyList();

/// <summary>
/// 塔楼内楼层查询
/// </summary>
/// <param name="storeyIndex"> 楼层编号 </param>
/// <param name="storeyObj"> 楼层对象 </param>
/// <returns> 是否存在 </returns>
bool isExist = tower.GetStorey(int storeyIndex, out StoreyObj storeyObj);

/// <summary>
/// 楼层最大层间位移角
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向层间位移角 </param>
/// <returns> 层间位移角 </returns>
var maxDrift = storeyObj.GetMaxDrift(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 楼层残余层间位移角
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向残余层间位移角 </param>
/// <returns> 残余层间位移角 </returns>
var resDrift = storeyObj.GetResDrift(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 最大楼层位移
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX">  X向/Y向顶点位移 </param>
/// <returns> 位移 </returns>
var topDisp = storeyObj.GetMaxDisp(LoadCaseObj loadcase, bool isX);
                
/// <summary>
/// 最大楼层剪力
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX">  X向/Y向剪力 </param>
/// <returns> 剪力 </returns>
var baseShear = storeyObj.GetMaxForce(LoadCaseObj loadcase, bool isX);

/// <summary>
/// 最大楼层倾覆弯矩
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="isX"> X向/Y向倾覆弯矩 </param>
/// <returns> 倾覆弯矩 </returns>
var baseMoment = storeyObj.GetMaxMoment(LoadCaseObj loadcase, bool isX);

```

#### 单元组集合ElementGroupSetObj

```C#

/// <summary>
/// 单元组对象列表
/// </summary>
/// <param name="groupSet"> 单元组对象 </param>
/// <returns> 是否存在构件分析结果 </returns>
bool isExist = result.GetElementGroupSetObj(out ElementGroupSetObj groupSet);

/// <summary>
/// 单元组描述
/// </summary>
/// <returns> 单元组描述列表 </returns>
List<string> groupDescps = groupSet.GetGroupDescps();

```

#### 单元组ElementGroupObj

```C#

/// <summary>
/// 获得所有单元组
/// </summary>
/// <returns> 单元组对象列表 </returns>
List<ElementGroupObj> groupObjList = groupSet.GetGroupList();

/// <summary>
/// 获得所有框架单元组
/// </summary>
/// <returns> 框架单元组列表 </returns>
List<ElementGroupObj> frameGroupList = groupSet.GetFRAMEGroupList();

/// <summary>
/// 获得所有墙单元组
/// </summary>
/// <returns> 墙单元组列表 </returns>
List<ElementGroupObj> wallGroupList = groupSet.GetWallGroupList();

/// <summary>
/// 获得单元组
/// </summary>
/// <param name="descp"> 单元组描述 </param>
/// <param name="group"> 单元组对象 </param>
/// <returns> 是否存在 </returns>
bool isExist = groupSet.GetGroup(string descp, out ElementGroupObj groupObj);

/// <summary>
/// 楼层内单元组构件的平均转角
/// </summary>
/// <param name="loadcase"> 工况 </param>
/// <param name="storey"> 楼层 </param>
/// <returns> 平均转角 </returns>
float avgDeform = groupObj.GetAVGDeform(LoadCaseObj loadcase, StoreyObj storey);

/// <summary>
/// 楼层内单元组构件的平均能力需求比
/// </summary>
/// <param name="loadcase"> 工况 </param>
/// <param name="storey"> 楼层 </param>
/// <param name="deformType"> 性能类型 </param>
/// <returns> 需求能力比 </returns>
float avgDeformDCR = groupObj.GetAVGDeformDCR(LoadCaseObj loadcase, StoreyObj storey, DeformType deformType);

/// <summary>
/// 单元组各楼层构件性能状态占比
/// </summary>
/// <param name="loadcase"> 工况 </param>
/// <param name="tower"> 塔楼 </param>
/// <returns> 各楼层构件性能状态占比 </returns>
Dictionary<int, List<double>> deformPerformDict = groupObj.GetStoreyDeformPerformRatio(LoadCaseObj loadcase, TowerObj tower);

```

#### 单元ElementObj

```C#

/// <summary>
/// 获得所有单元
/// </summary>
/// <returns> 单元对象列表 </returns>
List<ElementObj> elementList = groupObj.GetElementList();

/// <summary>
/// 楼层内单元组的所有单元
/// </summary>
/// <param name="storey"> 楼层对象 </param>
/// <returns> 单元对象列表 </returns>
List<ElementObj> elementList = groupObj.GetElementList(StoreyObj storey);

//获得第一个单元
ElementObj element = elementList.First();

/// <summary>
/// 最大压应变
/// </summary>
/// <param name="lcName"> 工况 </param>
/// <returns> 压应变 </returns>
float compressStrain = element.GetCompressStrain(LoadCaseObj loadCase);

/// <summary>
/// 最大拉应变
/// </summary>
/// <param name="lcName"> 工况 </param>
/// <returns> 拉应变 </returns>
float tensionStrain = element.GetTensionStrain(LoadCaseObj loadCase);

/// <summary>
/// 控制性能的构件变形
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <returns> 构件变形 </returns>
float deform = element.GetDeform(LoadCaseObj loadCase);

/// <summary>
/// 端部构件变形
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="direct"> 端部类型 </param>
/// <returns> 构件变形 </returns>
float deform = element.GetDeform(LoadCaseObj loadCase, FRAMReusltDirect direct);

/// <summary>
/// 控制性能的变形限值
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <returns> 变形限值列表 </returns>
List<float> deformLimits = element.GetDeformLimits(LoadCaseObj loadCase);

/// <summary>
/// 端部变形限值
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="direct"> 端部类型 </param>
/// <returns> 变形限值列表 </returns>
List<float> deformLimits = element.GetDeformLimits(LoadCaseObj loadCase, FRAMReusltDirect direct);

/// <summary>
/// 控制性能的需求能力比列表
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <returns> 需求能力比列表 </returns>
List<float> deformDCRList = element.GetDeformDCRList(LoadCaseObj loadCase);

/// <summary>
/// 端部需求能力比列表
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="direct"> 端部类型 </param>
/// <returns> 需求能力比列表 </returns>
List<float> deformDCRList = element.GetDeformLimits(LoadCaseObj loadCase, FRAMReusltDirect direct);

/// <summary>
/// 控制性能的某个性能状态下的需求能力比
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="deformType"> 性能类型 </param>
/// <returns> 需求能力比 </returns>
float deformDCR = element.GetDeformDCR(LoadCaseObj loadCase, DeformType deformType);

/// <summary>
/// 端部某个性能状态下的需求能力比
/// </summary>
/// <param name="loadCase"> 工况 </param>
/// <param name="direct"> 端部类型 </param>
/// <param name="deformType"> 性能类型 </param>
/// <returns> 需求能力比 </returns>
float deformDCR = element.GetDeformDCR(LoadCaseObj loadCase, FRAMReusltDirect direct, DeformType deformType);

```

#### 节点NodeObj

```C#

/// <summary>
/// 获得所有节点
/// </summary>
/// <returns> 节点对象列表 </returns>
List<NodeObj> nodeList = element.GetNodeList();

//第一个节点
NodeObj node = nodeList.First();
//坐标
double x = node.X;
double y = node.Y;
double z = node.Z;

```

## 截面承载力计算及构件变形指标插值：C#使用说明

#### 基本步骤

1. 定义截面受力（剪跨、轴力）及截面尺寸；

2. 定义配筋数据（纵筋、箍筋、分布筋，等）；

3. 定义材料强度；

4. 通过SetLimits完成承载力计算和变形指标插值；

4. 获得变形指标及截面抗弯、抗剪承载力，等。

#### 架构与文档

![架构与文档](http://server.wwforu.com//application//GiteeImage//PBSD-PIDoc20211205.png)

#### 框架截面构造

```C#

/// <summary>
/// 构造截面
/// </summary>
/// <param name="shearSpan"> 剪跨长度 mm </param>
/// <param name="axialLoad"> 轴力 N </param>
var section = new FrameSection(double shearSpan, double axialLoad = 0);

/// <summary>
/// 设定矩形截面
/// </summary>
/// <param name="width"> 截面宽度 </param>
/// <param name="height"> 截面高度 </param>
/// <param name="cover"> 保护层厚度 </param>
section.SetRCRectangularSection(double width, double height, int cover);

/// <summary>
/// 工形劲截面
/// </summary>
/// <param name="width"> 截面宽度 </param>
/// <param name="height"> 截面高度 </param>
/// <param name="webThick"> 腹板厚度 </param>
/// <param name="steelHeight"> 型钢高度 </param>
/// <param name="flangeWidth"> 翼缘宽度 </param>
/// <param name="flangeThick"> 翼缘厚度 </param>
/// <param name="cover"> 保护层厚度 </param>
section.SetSRCRectangularSection13(double width, double height, double webThick, double steelHeight, double flangeWidth, double  flangeThick, int cover);

/// <summary>
/// 对称十字劲截面
/// </summary>
/// <param name="width"> 截面宽度 </param>
/// <param name="height"> 截面高度 </param>
/// <param name="webThick"> 腹板厚度 </param>
/// <param name="steelHeight"> 型钢高度 </param>
/// <param name="flangeWidth"> 翼缘宽度 </param>
/// <param name="flangeThick"> 翼缘厚度 </param>
/// <param name="cover"> 保护层厚度 </param>
section.SetSRCRectangularSection15(double width, double height, double webThick, double steelHeight, double flangeWidth, double flangeThick, int cover);

/// <summary>
/// 设定矩形梁配筋
/// </summary>
/// <param name="AsCompress"> 顶筋-正向加载受压钢筋 </param>
/// <param name="AsTension"> 底筋-正向加载受拉钢筋 </param>
section.SetRectBeamReinforcement(int AsCompress, int AsTension);

/// <summary>
/// 设定矩形柱截面
/// </summary>
/// <param name="Ascor"> 角筋 </param>
/// <param name="Asx"> 除角筋外的X向（宽度方向）单测配筋 </param>
/// <param name="Asy"> 除角筋外的Y向（高度方向）单测配筋 </param>
section.SetRectColumnReinforcement(int Ascor, int Asx, int Asy);

/// <summary>
/// 设定箍筋信息
/// </summary>
/// <param name="sRatio"> 面积配箍率（加载方向） </param>
/// <param name="vRatio"> 体积配箍率 </param>
section.SetStirrup(double sRatio, double vRatio);

```

#### 剪力墙截面构造

```C#

/// <summary>
/// 构造截面
/// </summary>
/// <param name="shearSpan"> 剪跨长度 mm </param>
/// <param name="axialLoad"> 轴力 N </param>
var section = new WallSection(double shearSpan, double axialLoad = 0);

/// <summary>
/// 一字墙截面
/// </summary>
/// <param name="length"> 墙长 </param>
/// <param name="thickness"> 墙厚 </param>
/// <param name="boundaryLengthI"> I端边缘构件长度 </param>
/// <param name="boundaryLengthJ"> J端边缘构件长度 </param>
section.SetWallSection(double length, double thickness, double boundaryLengthI, double boundaryLengthJ);

/// <summary>
/// 异形墙截面（L、T等）
/// </summary>
/// <param name="length"> 墙长 </param>
/// <param name="thickness"> 墙厚 </param>
/// <param name="boundaryLengthI"> I端边缘构件长度 </param>
/// <param name="boundaryLengthJ"> J端边缘构件长度 </param>
/// <param name="boundaryAreaFactorI"> I端边缘构件面积放大系数 </param>
/// <param name="boundaryAreaFactorJ"> J端边缘构件面积放大系数 </param>
section.SetWallSection(double length, double thickness, double boundaryLengthI, double boundaryLengthJ, double boundaryAreaFactorI, double boundaryAreaFactorJ);

/// <summary>
/// 设定剪力墙配筋信息
/// </summary>
/// <param name="vAsRatio"> 竖向分布筋配筋率 </param>
/// <param name="hAsRatio"> 水平分布筋配筋率 </param>
/// <param name="bAsRatioI"> I端边缘构件纵筋配筋率 </param>
/// <param name="bAsRatioJ"> J端边缘构件纵筋配筋率 </param>
/// <param name="bStirrupVRatio"> 边缘构件体积配箍率 </param>
section.SetWallReinforcement(double vAsRatio, double hAsRatio, double bAsRatioI, double bAsRatioJ, double bStirrupVRatio);

/// <summary>
/// 设定型钢及钢板
/// </summary>
/// <param name="steelRatioI"> I端边缘构件含钢率 </param>
/// <param name="steelRatioJ"> J端边缘构件含钢率 </param>
/// <param name="steelPlateThickness"> 钢板厚度 </param>
section.SetWallSteel(double steelRatioI, double steelRatioJ, double steelPlateThickness = 0);

```

#### 材料强度

```C#

/// <summary>
/// 设定RC构件材料强度
/// </summary>
/// <param name="concreteGrade"> 混凝土等级 </param>
/// <param name="barGrade"> 纵筋强度 </param>
/// <param name="stirrupGrade"> 箍筋强度 </param>
section.SetRCMaterial(int concreteGrade, int barGrade, int stirrupGrade);

/// <summary>
/// 设定SRC构件材料强度
/// </summary>
/// <param name="concreteGrade"> 混凝土等级 </param>
/// <param name="barGrade"> 纵筋强度 </param>
/// <param name="stirrupGrade"> 箍筋强度 </param>
/// <param name="steelGrade"> 型钢强度 </param>
section.SetSRCMaterial(int concreteGrade, int barGrade, int stirrupGrade, int steelGrade);

```
#### 承载力与性能指标

```C#

/// <summary>
/// 设定变形限值
/// </summary>
/// <param name="isPosLoading"> 是否正向加载（剪力墙i端受拉） </param>
/// <param name="shearForce"> 剪力大小（部分截面类型用于计算剪压比） </param>
/// <returns> 是否成功 </returns>
bool isSuccess = section.SetLimits(bool isPosLoading, double shearForce = 0);

/// <summary>
/// 抗弯承载力
/// </summary>
/// <param name="capacityType"> 承载力类型：设计值、标准值、平均值 </param>
/// <returns> 承载力 </returns>
double momentCapacity = section.GetMomentCapacity(CapacityType capacityType);

/// <summary>
/// 抗剪承载力
/// </summary>
/// <param name="capacityType"> 承载力类型：设计值、标准值、平均值 </param>
/// <returns> 承载力 </returns>
double shearCapacity = section.GetShearCapacity(CapacityType capacityType);

/// <summary>
/// 变形限值
/// </summary>
/// <returns> 变形限值 </returns>
List<double> limits = section.GetLimits();

/// <summary>
/// 破坏形态
/// </summary>
/// <returns> 破坏形态 </returns>
DamageMode damageMode = section.GetDamageMode();

/// <summary>
/// 性能状态
/// </summary>
/// <param name="rotation"> 构件变形 </param>
/// <returns> 性能状态 </returns>
DeformType perform = section.GetPerform(double rotation);

//弯剪比
double msr = section.MSR;
//剪跨比
double lamda = section.Lammda;
//轴压系数
double alr = section.AxialLoadRatio;

```