calla

Open implementation of formulas in specifications or codes for structural engineering.

结构工程标准或规范中计算公式的开放实现。

访问项目主页 https://callapy.xyz 获取更多信息。

使用方法

所有计算类实例都有着一致的输入及输出方式：

# 示例：矩形截面抗弯承载力计算
from calla.GB.flexural_capacity import fc_rect
f = fc_rect(M=180,b=250,h0=460,fc=14.3)
f.solve()
print(f.text())

如果需要html格式的输出，请使用html()函数替换text()函数。

开发指南

如何开发一个新的计算类

项目中已经有大量的计算类实例可供参考。为了保证一致的输入及输出方式，方便使用，所有计算类应派生自抽象基类abacus。abacus主要的类成员如下：

• __title__：计算类名称
• __inputs__: 输入参数字典 采用list，每个条目的格式为

__inputs__ = [
	(key, symbol, unit, default_value, name, description, [choices]),
	...
	]

其中：key-参数在代码中的命名；symbol-参数的书面符号，使用html格式表示；unit-单位；name-参数名称；description-参数描述；[choices]-参数值的可选项。

例如：

__inputs__ = [
	('fcd','<i>f</i><sub>cd</sub>','N/mm<sup>2</sup>',22.4,'混凝土轴心抗压强度设计值'),
	...
	]

• __deriveds__：结果参数字典 采用list，格式与__inputs__相同。
• __toggles__：参数开关字典。 某个参数的取值对其它参数可用性有影响时，将其列入__toggles__字典可以实现简单的开关功能。格式为

__toggles__ = [
	parameter, {option:(disabled_parameters),...},
	...
	]

• solve: 计算函数

def solve(self):
	# Do some calculations here.
	return

• html：html格式的文本输出函数

def html(self, digits=2):
	return '<p>Write some outputs here.</p>'

• _html()：一般情况下，推荐改写_html()函数而不是html()函数。html()会自动调用_html()函数生成html格式的输出。在_html()函数中，请使用yield关键字生成每一行输出，输出采用html格式，但无需在最外层使用html元素（例如<p></p>）包裹内容，因为html()函数会自动对每行内容使用<p></p>进行包裹。

def _html(self, digits=2):
	yield 'Write some outputs here.'

• text：plain text格式的文本输出函数 基类abacus实现了由html格式自动转换成纯文本格式。除非有特别需求，否则无需重写此函数。

def text(self, digits=2):
	return 'Write some outputs here.'

计算类输入参数命名规则

参数命名尽可能的与规范标准中的一致，下标连写，上标'采用_代替，例如:

f_cd，命名为fcd。 A_s^'，命名为As_。

例外的情况是，参数名与python关键字冲突，例如a_s，按规则命名则会与关键字as冲突，此时可在下标前插入"_"，因此命名为a_s。