(OpenSeesPy) 如何正确地输入参数

文档：OpenSeesPy

文档内的许多函数都有着看起来比较复杂的输入参数，这在一定程度上阻碍了我们去按照需求调用函数。本文将以一个较有代表性的函数为例，阐述如何正确地输入参数

以下是在官方文档中某函数的输入参数：
4.8.1.2. eleLoad command
eleLoad('-ele', *eleTags, '-range', eleTag1, eleTag2, '-type', '-beamUniform', Wy, <Wz>, Wx=0.0, '-beamPoint', Py, <Pz>, xL, Px=0.0, '-beamThermal', *tempPts)

该函数可以表示为如下结构：

eleLoad(
    '-ele', *eleTags, 
    '-range', eleTag1, eleTag2, 
    '-type', 
        '-beamUniform', Wy, <Wz>, Wx=0.0,
        '-beamPoint', Py, <Pz>, xL, Px=0.0, 
        '-beamThermal', *tempPts
)

可知该函数的输入分为两层：

• 第一层：'-ele', '-range', 'type'
• 第二层：'-beamUniform', '-beamPoint', '-beamThermal'

以上每一层内的元素之间都是并列的，而第二层的所有元素均属于第一层中的 '-type'，因此在输入第二层相关的参数时需要在前面加上 '-type'

具体参数：

• *eleTags：星号表示可以输入多个相关参数
• <Wz>：尖括号表示该参数只在某些条件下才需要输入
• Wx=0.0：默认赋0值，因此可以不输入

示例：

# 在1、3、4、5号杆的中间位置: xL=0.5
# 施加y方向(locally)、大小为-20的力: Py=-20
# 该模型为二维模型，而输入Pz的前提是三维模型，因此不输入
ops.eleLoad(
    '-ele', 1, 
    '-range', 3, 5, 
    '-type', 
        '-beamPoint', -20, 0.5)