Engee Function

信息单元格（不可编辑）-自动显示块变量 Engee Function 、输入和输出信号的属性（维度、类型、离散度）和其他用户定义的参数。 其内容根据块设置动态更新。 单元格始终处于活动状态，但未在"方法管理"菜单中选择该单元格。 . 它有一个半透明的文本，显示提示。

定义组件结构-添加单元格 Component struct code ，其中定义了块组件的结构 Engee Function （继承自’AbstractCausalComponent’类型）。 结构字段在不可编辑字符串`struct Block<:AbstractCausalComponent`和`end’之间定义。 默认情况下，`g’参数被创建，由`gain`块的值初始化，并且`Block()'构造函数不接受参数。

使用通用代码—-添加单元格 *Common code ，其中代码以自由形式编写。 默认情况下，单元格为空。 例如，如果标准结构在 Component struct code 如果它不适合（由于’struct Block<:AbstractCausalComponent’的不可编辑性`，那么您可以禁用*Define component struct*以删除单元格并手动在 Common code . 这同样适用于方法管理菜单中的任何功能。 -而不是标准的单元格，你可以编写自己的代码 Common code .

定义步骤方法-添加单元格 Step method code ，其定义了计算块的输出信号的步进方法 Engee Function . 方法签名是根据端口选项卡中相应端口标签的值自动生成的。 该方法表示为函子（有关详细信息，请参阅 这里）并且在模拟的每个步骤中被调用。 字段在`function(c::Block)(t::Real,in1)`和`end’的不可编辑行之间定义。 第一个参数是`t::Real’是仿真时间，然后传输输入信号变量。 输出的计算值使用关键字`return’返回。

定义更新方法-添加一个单元格*更新方法代码*其中方法`更新！'更新块的内部状态 Engee Function 在模拟的每一步。 第一个参数`c::Block`是块结构，第二个`t::Real`是仿真时间，然后传输输入信号。 如果块没有内部状态，则该方法可以保持为空并简单地返回’c'。

定义终止方法代码-添加*终止方法代码*单元格，该单元格在块模拟完成时执行 Engee Function （使用’终止！'的方法）。 `C::Block’的第一个参数是块结构。 默认情况下，该方法不执行任何其他操作，只返回’c'。

复盖类型继承方法-添加*Types继承方法*单元格，该单元格复盖类型继承方法。

function propagate_types(inputs_types::Vector{DataType})::Vector{DataType}
# 返回输出信号类型数组的函数。
# 如果使用默认算法，它将被忽略。
# 在这种情况下，输入信号的类型和
# '增益'块的参数。
    input_type = first(inputs_types)
    # promote_type返回给出参数类型的类型。
    # 在与这些类型的对象进行算术运算期间。
    output_type = promote_type(input_type, eltype(gain))
    return [output_type]
end

Override dimensions继承方法-添加一个cell*Dimensions继承方法*，它重新定义了维度的继承方法。

function propagate_dimensions(inputs_dimensions::Vector{<:Dimensions})::Vector{<:Dimensions}
# 返回输出信号维度数组的函数。
# 如果使用默认算法，它将被忽略。
# 在这种情况下，输入信号的尺寸被考虑在内和
# '增益'块的参数。
    input_dimensions = first(inputs_dimensions)
    mock_input = zeros(input_dimensions)
    mock_output = mock_input .* gain
    return [size(mock_output)]
end

使用通用方法进行类型和维度继承-添加*通用类型和维度继承方法*单元格，该单元格使用通用方法同时重新定义类型和维度的继承。

function propagate_types_and_dimensions(inputs_types::Vector{DataType}, inputs_dimensions::Vector{<:Dimensions})::Tuple{Vector{DataType}, Vector{<:Dimensions}}
# 返回信号类型数组和数组的函数
# 输出信号的尺寸。 这个功能可以使用
# 如有必要，在同一时间重新定义继承算法。
# 类型的信号，以及用于维度的继承的算法。
    outputs_types = propagate_types(inputs_types)
    outputs_dimensions = propagate_dimensions(inputs_dimensions)
    return outputs_types, outputs_dimensions
end

Override sample time inheritance method-添加单元格*Sample times inheritance method*，该单元格重新定义计算步骤的继承方法。

function propagate_sample_times(inputs_sample_times::Vector{SampleTime}, fixed_solver::Bool)::SampleTime
# 返回块的采样时间的函数。
# 它仅在"自定义"继承模式下使用。
# Fixed_solver参数指示是否正在使用求解器。
# 具有恒定步长(true)或具有可变步长(false)。
# 使用时间继承的更复杂示例
# 可以在文档中查看块采样。
    return first(inputs_sample_times)
end

const SampleTime = NamedTuple{(:period, :offset, :mode), Tuple{Rational{Int64}, Rational{Int64}, Symbol}}

复盖直接馈送设置方法-添加一个单元*直接馈送设置方法*定义直接端到端连接。

function direct_feedthroughs()::Vector{Bool}
# 返回布尔值数组的函数。,
# 端到端连接。 如果数组的第i个元素为true,
# 第i端口具有端到端连接。
# 如果使用默认算法，它将被忽略。
    return [true]
end

function direct_feedthroughs()::Vector{Bool}
    if gain == 2
        return [false]
    else
        return [true]
    end
end

'BLOCK_NAME’是块的名称。 添加到Engee画布的每个块都有一个可以通过此常量访问的名称。 例如，您可以在错误初始化期间引用BLOCK_NAME来输出其中的块名称。

'START_TIME—-从模型设置开始模拟。

'STOP_TIME—-从模型设置中结束模拟。

'INPUT_SIGNAL_ATTRIBUTES'—每个输入端口的属性列表。 例如，要找出第一个输入信号的属性，请使用’INPUT_SIGNAL_ATTRIBUTES[1]`，其中`1`是块的第一个输入端口。 Engee Function .

'OUTPUT_SIGNAL_ATTRIBUTES'—每个输出端口的属性列表。 例如，要找出第一个输出信号的属性，请使用’OUTPUT_SIGNAL_ATTRIBUTES[1]`，其中`1`是块的第一个输出端口。 Engee Function .

'dimensions'-信号的维度。 它可以缩短为’dims'。

"类型—-信号的类型。 它可以缩短为’tp'。

'sample_time’是计算步骤。 它是一种类似于信号属性的结构，可以通过点访问。 .. 提供两种转换功能:

'direct_feedthrough—-指示循环端口是否打开。 它仅用于输入端口（仅检查输入端口的属性）。 它可以缩短为’df'。

'FixedPoint’是所有固定数字的抽象类型`;

'Fixed’是一种特定类型的固定数字，通过指示位表示手动创建。;

'菲（。..)`-使用数值和表示参数创建`Fixed’类型的值;

'fixdt（。..)'-创建一个固定类型，指示符号、宽度和小数位数。

作为参数发送;

在组件结构中使用(cell*Component struct code*);

使用*Step方法代码*单元格中的’emul'，'esum'，'ediv’与它们一起执行算术（有关更多信息，请参阅转换函数和类型化算术运算’econvert','esum','emul`,'ediv`）;

应用于`propagate_types(…​)','propagate_dimensions(…​)`.

'BusSignal{...}'是具有名称、类型和尺寸的总线类型。;

'get_bus_names(type`—-获取信号名称列表;

'get_bus_types(type)—-获取信号的类型;

'get_bus_dimensions(type)—-获取信号的尺寸;

'get_names_types_dims(type)—-一次获取所有内容;

'get_bus_signal_type(::NamedTuple)`—通过值确定`BusSignal`的类型。

在块参数中，您可以通过`fi（设置固定点值。..）'，并且还将总线结构传递为’NamedTuple'。 总线类型可以通过’get_bus_signal_type(…​)'.

在*Common code*单元格中，您可以定义数据类型（'Fixed`’BusSignal{…​}'），组件结构’结构块'），创建辅助函数或初始化值。 如果禁用了*步骤方法代码*或*组件结构代码*，您也可以在此处移动主逻辑。

在*Component structure code*单元格中，当描述结构的字段时，如果字段是复合信号，则可以使用`Fixed`类型的值以及`BusSignal`类型。

*步骤方法代码*单元实现块的主要逻辑。 在这里，固定数字和总线信号可以参与计算、比较和结构处理。

在*Types继承方法*单元格中，您可以使用’Fixed`和’BusSignal’类型来分析输入并设置组件的输出类型。

在*维度继承方法*单元中，您可以使用总线中的"固定"数据和值来确定输出信号的维度。

在*更新方法代码*单元格中，如果块具有内部状态，则可以使用"Fixed"或"BusSignal"等字段在模拟的每个步骤中存储或更改此状态。

在*Terminate方法代码*单元格中，如果结构包含适当的字段，则这些类型可用于记录最终状态。

在*Common types and dimensions inheritance method*cell中，如果两种类型和维度都需要同时处理，`Fixed`和`BusSignal`也可以参与计算逻辑。

实数’Float16`,'Float32`,'Float64`

整数’Int8'，'Int16'，'Int32'，'Int64'，'Int128'，'UInt8'，'UInt16'，'UInt32'，'UInt64'，'UInt128`

逻辑：'Bool`

Fixed:'Fixed`(通过’fi(创建。..）或’fixdt（。..))

复杂’复杂{T}`，其中’T’是上述任何类型

'type'-将值转换为的类型。 如果’var’是复数，则指定基实数类型。 例如，'econvert(Float32,Complex{Int16}(1+2im))返回’复杂{Float32};

'var—-转换的值;

'rounding_mode—-舍入方法（'RoundDown`’RoundUp`，'RoundNearest`，'RoundNearestTiesAway'，'RoundToZero`）;

'overflow—-如果’true`，则使用溢出行为（wrap）;如果`false'，则启用饱和—值限制在类型的范围内。

'x1','x2—-操作的参数（允许标量或数组）;

'out_type’是生成和返回结果的类型。;

'overflow'-启用溢出（'true`）或饱和（'false`）;

'rm’是舍入方法（见上面的列表）。

定义添加相同类型`T`的’n’值时的输出类型:

sum_promote_type(::Type{T}, n::Integer=1, hdlsetup::Bool=false)

定义通过’n’值添加两个不同类型`T1`和`T2’时的输出类型:

sum_promote_type(::Type{T1}, ::Type{T2}, n::Integer=1, hdlsetup::Bool=false)

定义在添加任意数量的具有不同类型的参数时的输出类型。:

sum_promote_type_from_inputs(types::Type...; hdlsetup::Bool=false)

定义在添加相同类型`T`的`n`值时累加器的类型:

sum_accumulator_promote_type(::Type{T}, n::Integer=1, hdlsetup::Bool=false)

通过`n`值添加两个不同类型的`T1`和`T2`时确定累加器的类型。:

sum_accumulator_promote_type(::Type{T1}, ::Type{T2}, n::Integer=1, hdlsetup::Bool=false)

定义在添加任意数量的具有不同类型的参数时累加器的类型。:

sum_accumulator_promote_type_from_inputs(types::Type...; hdlsetup::Bool=false)

定义将相同类型的值乘以"T"时的输出类型:

mul_promote_type(::Type{T}, hdlsetup::Bool=false)

定义两个不同类型`T1`和`T2`相乘时的输出类型:

mul_promote_type(::Type{T1}, ::Type{T2}, hdlsetup::Bool=false)

定义在划分类型为"T"的单个值时的输出类型:

div_promote_type(::Type{T}, hdlsetup::Bool=false)

定义将类型为"T1"的值除以类型为"T2"的值时的输出类型:

div_promote_type(::Type{T1}, ::Type{T2}, hdlsetup::Bool=false)

通过重新定义输出参数将输入数据转换为矢量;

使用缓存和强类型结构来提高性能;

用于打破代数循环的没有直接馈通的块的实现;

设置输出信号的用户采样周期。

Ports:'%<Inputs>','%<Outputs>—-输入和输出端口数’%<InputPort1Type>','%<OutputPort1Type>','%<InputPort1Size>','%<OutputPort1Size>—-数据类型和信号尺寸。

时间特性:'%<Sampleetime>—-离散化;'%<Sampleetimeinheritancemethod>'—离散化的继承方法。

代码块:'%<ComponentStructCode>','%<StepMethodCode>—-步骤的结构和方法的代码。

Parameters:'%<Parameters>`,`%<Parameter1Name>','%<Parameter1Value>'—参数的名称和值。

Enable flags:'%<DefineComponentStruct>`,%<UseCommonCode>,%<DefineStepMethod>,%<definupdatemethod>,%<DefineTerminateMethod>—启用相应的代码段。

重新定义方法:'%<OverrideTypesInhMethod>`,%<OverrideDimsInhMethod>,`%<Overridesampleetimeinhmethod>'—类型继承设置。

Other:'%<UseExternalCache>—-外部缓存使用情况。