文档: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)