AnyMath 文档
Notebook

具有可变端口数的自定义块

在我之前的帖子中,我告诉过你如何使用AnyMath函数制作自己的块。 但我们谈论的是已经知道输入和输出数量的块。 在这篇文章中,我将向您展示如何使用加法器的示例制作具有可变数量输入的块。

加法器的实现

块体结构

我们的加法器应该能够将其输入相加。 与经典加法器一样,每个输入都有一个+或-符号。

如果用户已输入"+-",则加法器将计算输出为:

换句话说,加法器的公式如下:

因此,需要在某处存储入口的标志列表。

因此,AnyMath功能块将具有一个参数:符号的向量,并且块结构将被描述为:

mutable struct Block <: AbstractCausalComponent

    port_values::Vector{Float64}
    function Block()
        vects_length = length(INPUT_SIGNAL_ATTRIBUTES)
        port_values = zeros(vects_length,)
        new(port_values)
    end

end

注意,由于加法器中输入的数量是可变的,因此在块初始化期间将根据内部变量的大小计算符号的向量的长度。 INPUT_SIGNAL_ATTRIBUTES.

处理未知数量的端口

我在开发具有可变数量端口的块时遇到的主要问题是如何处理它们。 该块的函子具有签名:

function (c::Block)(t::Real, in1, in2)

我们需要得到一个输入列表。 为此,请使用宏 Base.@locals,它返回一个字典,其中包含局部变量的名称和值,包括输入。

宏返回所有局部变量,因此必须在输入函子后立即调用它。

这是代码看起来像得到所有的输入:

args_dict = Base.@locals

pat = r"^in(\d)";
i = 1;
for (name, value) in args_dict
    if occursin(pat, String(name))
        c.port_values[i] = value
        i = i+1
    end
end

请注意,我正在通过使用正则表达式匹配字符串"in<N>"来搜索输入。

手动编写所需的正则表达式非常困难。 使用任何在线建筑工具包!

块函子代码的一般视图如下:

function (c::Block)(t::Real, in1, in2)  
	args_dict = Base.@locals

	pat = r"^in(\d)";
	i = 1;
	for (name, value) in args_dict
		if occursin(pat, String(name))
			c.port_values[i] = value
			i = i+1
		end
	end

	r = (c.port_values .* sign_in)

	return sum(r)
end

制作面具

如果我们对用户隐藏我们的实现,我们将添加一个掩码。 我们的掩码不仅应该允许用户输入字符列表,还:

  1. 验证输入
  2. 配置AnyMath功能块
  3. 设置参数

也就是说,掩码必须是"聪明的",你不能不写代码。

输入验证

可以使用两种方法来验证输入:

  1. 对参数使用validateCallback回调:

    ![图像。png](附件:图片。png)

  2. 使用掩码本身的blockChangedCallback回调:

    ![图像。png](附件:image_2.png)

我将使用后一种方法来完成我们的任务。

我们要检查什么?:

  1. 用户输入了行
  2. 最小字符串长度为2
  3. 字符串只包含**"+"和"-"**

我们将通过@assert宏进行验证。:

@assert typeof(inp_signs) == String
@assert length(inp_signs) >= 2
@assert occursin(r"^[+-]+$",inp_signs)

И опять мы столкнулись с регулярными выражениями!

Настройка блока

Вспомним как работает сумматор: пользователь вводит строку из + и - и блок меняет количество входов. Поэтому код маски должен уметь следующее:

  1. Настраивать количество входов AnyMath Function
  2. Разбирать пользовательский ввод

Делать это будем вот так:

blk = engee.gcb()

vec = Vector{Int64}();
engee.set_param!(blk,"Inputs"=>length(inp_signs))

for (ind,char) in enumerate(inp_signs)
    append!(vec,char == '+' ? 1 : -1)

end

engee.set_param!(blk,"Parameter1Value"=>vec)
for i in 1:length(inp_signs)
    engee.set_param!(blk,"InputPort$(i)Size"=>())
end

主要思想是使用命令控制来配置AnyMath功能。

我们的AnyMath函数的参数值是使用以下代码动态设置的:

for (ind,char) in enumerate(inp_signs)
    append!(vec,char == '+' ? 1 : -1)

end

engee.set_param!(blk,"Parameter1Value"=>vec)

让我们检查加法器是否工作。 从正弦计算余弦,根据众所周知的公式:

为此,我们将组装这样一个模型:

image.png

让我们运行她的模拟。:

In [ ]:
mdl = engee.load(joinpath(@__DIR__,"ef_variadic.engee"))
res = engee.run(mdl)

sine = collect(res["sin_mod"])
cosine = collect(res["cos"])

plot(sine.time,sine.value,label="sine")
plot!(cosine.time,cosine.value,label="cosine")
Out[0]: