关于采样时间

可以在中指定S函数的采样时间行为MDL线性化采样次数. 您的S函数可以从驱动它的块继承它的速率，或者定义它自己的速率。

您可以将S函数速率（即采样时间）指定为

对于基于块的采样时间，S函数在模拟的初始化阶段为整个块指定一组操作速率。对于基于端口的采样时间，S函数在初始化期间为每个输入和输出端口分别指定采样时间。在模拟阶段，使用基于块的采样时间在这种情况下，S函数在块的每次采样命中时处理所有输入和输出。相比之下，对于基于端口的采样时间，块仅在该端口的采样命中时处理特定端口。

例如，考虑两个采样率，分别为0.5秒和0.25秒:

如果应用程序要求输入和输出执行的采样率不相等，或者不希望以块的最高采样率运行输入和输出端口时产生的开销，则应使用基于端口的采样时间。

在某些应用中，S功能块可能需要在内部以一个或多个采样率运行，同时以其他速率输入或输出信号。基于块和端口的混合指定采样率方法允许您创建这样的块。

在典型应用程序中，仅指定一个基于块的采样时间。高级S函数可能需要指定基于端口的采样时间或多个块采样时间。

基于块的样品时间

C MEX S函数在中指定基于块的采样时间信息

接下来的两节讨论如何为C MEX s -函数指定基于块的示例时间。第三部分给出了一个简单的示例，展示了如何指定示例时间MDL线性化采样次数. 有关详细示例，请参见mixedm.c．

ssSetNumSampleTimes(年代,numSampleTimes);

ssSetSampleTime(年代,sampleTimePairIndex，采样时间）ssSetOffsetTime(年代,offsetTimePairIndex, offset_time）

[continuous_sample_time, 0.0] [continuous_sample_time, fixed_in_minor_step_offset]discrete_sample_period,抵消][变量样本时间，0.0]

(INHERITED_SAMPLE_TIME, 0.0)

[继承的\u采样\u时间，固定的\u在\u次要\u步长\u偏移]

如果(ssIsContinuousTask（S，tid））{}

如果(取样命中(S, 2, tid) {}

静态空隙MDL线性化采样次数(SimStruct *S) {ssSetSampleTime(S, 0, 0.01);ssSetOffsetTime(年代,0,0.0);ssSetSampleTime (S, 1, 0.5);ssSetOffsetTime (S, 1, 0.0);} /* mdlInitializeSampleTimes结束。*／

指定基于端口的采样时间

不能对既没有输入端口也没有输出端口的S函数使用基于端口的采样时间。如果S函数使用基于端口的采样时间且没有端口，则S函数在更新或运行Simulink模型时会产生错误。如果S函数上的输入或输出端口数可变，则应向S函数中添加额外的保护，以确保端口总数不会变为零。金宝app

要在C MEX s -函数中使用基于端口的样本次数，必须在s -函数中指定基于端口的样本次数中密度方法：

ssSetNumSampleTimes(年代,PORT_BASED_SAMPLE_TIMES)

您还必须指定s函数中每个输入和输出端口的采样时间中密度方法，使用以下宏

ssSetInputPortSampleTime（S，idx，period）ssSetInputPortOffsetTime(年代,idx抵消)ssSetOutputPortSampleTime（S，idx，period）ssSetOutputPortOffsetTime(年代,idx抵消)

呼吁ssSetNumSampleTimes是否可以放置在基于端口的样品时间实际指定的之前或之后中密度．然而,如果ssSetNumSampleTimes没有将s功能配置为使用基于端口的采样次数，端口上设置的任何采样次数都将被忽略。

对于任何给定的端口，可以指定

ssSetInputPortSampleTime (0, 1);ssSetInputPortOffsetTime (0, 0);

如果(!ssGetInputPortSampleTime(S,0)) {ssSetErrorStatus(S，"Cannot inherit a continuous sample time.")};

基于块和基于端口的混合采样时间

混合采样时间分配方法结合了基于块和基于端口的方法。首先指定in中密度，块运行时的速率总数，包括块速率、输入速率和输出速率，使用ssSetNumSampleTimes．

然后设置SS_OPTION_PORT_SAMPLE_TIMES_ASSIGNED选项,使用ssSetOptions，告诉模拟引擎您将使用基于端口的方法分别指定输入端口和输出端口的速率。接下来，与基于块的方法一样，使用下面的方法指定所有块的内部和外部速率的周期和偏移量

ssSetSampleTime ssSetOffsetTime

最后，与基于端口的方法一样，使用

ssSetInputPortSampleTime(S, idx, period) ssSetInputPortOffsetTime(S, idx, offset) ssSetOutputPortSampleTime(S, idx, period) ssSetOutputPortOffsetTime(S, idx, offset) ssSetOutputPortSampleTime(S, idx, period) ssSetOutputPortOffsetTime(S, idx, offset)

请注意，每个分配的端口速率必须与先前声明的一个块速率相同。有关示例S函数，请参阅mixedm.c．

多速率S功能块

在多速率S函数块中，您可以封装定义函数中每个行为的代码计算输出和mdlUpdate函数的一个语句，该语句确定是否发生了样本命中。在C MEX s -函数中取样命中宏决定当前时间是否为指定的采样时间的采样命中。宏的语法如下:

ssIsSampleHit（S、st_索引、tid）

哪里年代是SimStruct，st_index标识特定的采样时间索引，以及tid为任务ID (tid这是一个论据计算输出和mdlUpdate功能）。

例如，C MEX S函数中的这些语句指定了三个采样时间：一个用于连续行为，两个用于离散行为。

ssSetSampleTime（S，0，连续采样时间）；ssSetSampleTime（S，1，0.75）；ssSetSampleTime（S，2，1.0）；

在mdlUpdate函数，下面的语句封装了定义0.75秒采样时间的行为的代码。

如果（ssIsSampleHit（S，1，tid））{}

第二个参数,1，对应于第二个采样时间，0.75秒。

使用下面的代码行来封装定义连续示例命中行为的代码:

如果(ssIsContinuousTask（S，tid））{}

/*初始化采样时间和偏移量。*/static void mdlinializeSampleTimes（SimStruct*S）{ssSetSampleTime（S，0，连续采样时间）；ssSetOffsetTime（S，0，0.0）；}

ssSetNumSampleTimes（S，1）；

/*初始化采样时间和偏移量。*/静态void mdlinializeSampleTimes（SimStruct*S）{/*连续状态采样时间和偏移量。*/ssSetSampleTime（S，0，连续采样时间）；ssSetOffsetTime（S，0，0.0）；/*离散状态采样时间和偏移量。*/ssSetSampleTime（S，1，0.1）；ssSetOffsetTime（S，1，0.025）；}

ssSetNumSampleTimes（S，2）；

多速率S函数与采样时间命中计算

对于固定步长解算器，Simulink使用整数算法金宝app而不是浮点算法来计算采样时间命中。因此，任务时间是其相应采样时间段的整数倍。

如果考虑在多速率S-函数中基于任务时间执行布尔逻辑，则这种计算方法变得重要。例如，考虑具有两个采样时间的S函数。事实上，（SSISSAMPHILT（S，IDX1）＝Trand和SSISSAMPHILT（S，IDX2）＝true）不保证SSGETTASKTIME（S，IDX1）＝SSGETTASKTIME（S，IDX2）。

同步多速率s -功能块

如果不同速率的任务需要共享数据，则必须确保一个任务生成的数据在另一个不同速率的任务访问时是有效的。你可以使用特殊采样中的宏mdlUpdate或计算输出多速率S函数的例程，以确保共享数据有效。此宏返回符合事实的如果样本命中在同一时间步中以一种速率发生，而样本命中也以另一种速率发生。因此，它允许较高速率的任务以较慢速率的任务可以适应的速率提供较慢速率的任务所需的数据。使用特殊采样宏，较慢的采样时间必须是较快的采样时间的整数倍。

例如，假设您的模型有一个以一种速率运行的输入端口（采样时间索引为0）和一个以较慢速率运行的输出端口（采样时间索引为1）。此外，假设您希望输出端口输出当前输入上的值。以下示例说明了此宏的用法。

if（ssIsSampleHit（S，0，tid）{if（ssIsSpecialSampleHit（S，0，1，tid）{/*将输入传输到输出内存。*/..}}if（ssIsSampleHit（S，1，tid）{/*发出输出。*/..}

在本例中，当以输入速率发生采样命中时，第一个块将运行。如果命中也以输出速率发生，则块将输入传输到输出存储器。第二个块在样本命中以输出速率发生时运行。它将其内存区域中的输出传输到块的输出。

请注意，速率较高的任务总是在速率较低的任务之前运行。因此，前面示例中的输入任务总是在输出任务之前运行，确保输出端口始终存在有效数据。

指定模型引用样本时间继承

如果您的C MEX s -函数从驱动它的块继承了它的样本时间，那么您的s -函数应该指定包含您的s -函数的引用模型是否可以从它们的父模型继承样本时间。如果s函数输出不依赖于它继承的样本时间，则使用ssSetModelReferenceSampleTimeInheritanceRule宏设置s -函数样本时间继承规则为使用\u默认\u进行\u离散\u继承. 否则，将规则设置为不允许\u样本\u时间\u继承对于包含S函数（其输出取决于继承的采样时间）的参考模型，禁止采样时间继承，从而避免意外的模拟错误。

如果不确定现有S函数输出是否取决于其继承的采样时间，请检查它是否调用以下任何C宏：

或TLC功能：

如果您的s函数没有调用这些宏或函数中的任何一个，那么它的输出不依赖于它所继承的样本时间，因此它可以安全地用于继承它们的样本时间的引用模型中。

static void mdlOutputs(SimStruct *S, int_T tid) {const real_T* u = (const real_T*) ssGetInputPortSignal(S,0);real_T *y = ssGetOutputPortSignal(S,0); / /输出y[0] = ssGetSampleTime(S,tid) * u[0]; / /时间｝

ssSetModelReferenceSampleTimeInheritanceRule(年代,DISALLOW_SAMPLE_TIME_INHERITANCE);