Engee 文档

康明

的累积最小值。

库::`工程师`

语法

函数调用

  • [参数:M]=康明(___,[参数:nanflag]) -确定是排除还是包含值 到阵列 [参数:A]. 例如, cummin(A,"includenan") 考虑到值 计算每个最小值时。 默认情况下 康明 排除值 .

争论

输入参数

# 一个 — 输入数组

+ 向量资料 | 矩阵 | 多维数组

Details

指定为向量、矩阵或多维数组的输入数组。 对于复杂元素,函数 康明 比较它们的振幅。 如果振幅相等, 康明 它还比较相位角。

数据类型

漂浮物32, 漂浮64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, 布尔</无翻译> 支持复数::是

# 昏暗 — 执行操作的测量

+ 正整数标量

Details

对其执行操作的维度,指定为正整数标量。 如果未指定维度,则默认使用数组的第一个维度,其大小不等于 1.

考虑二维输入数组 A:

  • 康明(A,1) 使用列中的连续元素 A 并返回一个大小与 A,在每列中具有累积最小值。

    cummin 1

  • 康明(A,2) 使用字符串中的连续元素 A 并返回一个大小与 A,每行具有累积最小值。

    cummin 2

康明 申报表 A 如果 昏暗 超过 ndims(A).

# 方向 — 累积方向

+ "前进" (默认情况下)| "反向"

Details

累积的方向,由以下值之一设置:

  • "前进" -工作从 1 直到工作测量结束;

  • "反向" -端到端工作 1 工作测量。

# nanflag — 缺失值的条件

+ "省略" (默认情况下)| "奥米特南" | "包括" | "包括"

Details

处理缺失值的条件,由以下值之一设置:

  • "省略""奥米特南" -忽略值 [参数:A] 计算累积最小值时。 如果在 [参数:A] 有连续的初始值 ,则相应的元素在 [参数:M] 他们也是 . 价值 "省略""omitnan" 他们的行为方式相同。

  • "包括""包括" -启用值 [参数:A] 计算累积最小值时。 元素在 [参数:M] 他们成为 只要在 [参数:A] 第一个值发生 . 价值 "包括""包括" 他们的行为方式相同。

输出参数

# M — 输出阵列

+ 向量资料 | 矩阵 | 多维数组

Details

作为向量、矩阵或多维数组返回的输出数组。

例子:

向量中的累积最小值

Details

让我们找到一个大小随机整数向量的累积最小值 110.

import EngeeDSP.Functions: randi

v = randi([0,10],1,10)
1×10 Matrix{Float64}:
 9.0  2.0  8.0  2.0  10.0  3.0  2.0  2.0  6.0  5.0
import EngeeDSP.Functions: cummin

M = cummin(v)
1×10 Matrix{Float64}:
 9.0  2.0  8.0  2.0  10.0  3.0  2.0  2.0  6.0  5.0

矩阵列中的累积最小值

Details

让我们找到具有大小的矩阵的列的累积最小值 3×3.

A = [3 5 2; 1 6 3; 7 8 1]
3×3 Matrix{Int64}:
 3  5  2
 1  6  3
 7  8  1
import EngeeDSP.Functions: cummin

M = cummin(A)
3×3 Matrix{Float64}:
 3.0  5.0  2.0
 1.0  5.0  2.0
 1.0  5.0  1.0

矩阵行中的累积最小值

Details

让我们找到具有大小的矩阵的行的累积最小值 3×3.

A = [3 5 2; 1 6 3; 7 8 1]
3×3 Matrix{Int64}:
 3  5  2
 1  6  3
 7  8  1
import EngeeDSP.Functions: cummin

M = cummin(A, 2)
3×3 Matrix{Float64}:
 3.0  3.0  2.0
 1.0  1.0  1.0
 7.0  7.0  1.0

反向累积最小值

Details

在数组的第三维中计算累积最小值 2×2×3. 我们会指明方向 "反向" 来计算从第三维结束到开始的值。

A = cat([1 2; 3 4], [9 10; 11 12], [5 6; 7 8]; dims=3)
2×2×3 Array{Int64, 3}:
[:, :, 1] =
 1  2
 3  4

[:, :, 2] =
  9  10
 11  12

[:, :, 3] =
 5  6
 7  8
import EngeeDSP.Functions: cummin

M = cummin(A, 3, "reverse")
2×2×3 Array{Float64, 3}:
[:, :, 1] =
 1.0  2.0
 3.0  4.0

[:, :, 2] =
 5.0  6.0
 7.0  8.0

[:, :, 3] =
 5.0  6.0
 7.0  8.0

累积最小值,包括缺失值

Details

创建包含值的矩阵 .

A = [3 5 NaN 4; 2 6 2 9; 1 3 0 NaN]
3×4 Matrix{Float64}:
 3.0  5.0  NaN      4.0
 2.0  6.0    2.0    9.0
 1.0  3.0    0.0  NaN

计算矩阵的累积最小值,包括值 . 对于包含任何值的矩阵列 ,累计最小值变得相等 只要遇到第一个值 .

import EngeeDSP.Functions: cummin

M = cummin(A, "includenan")
3×4 Matrix{Float64}:
 3.0  5.0  NaN    4.0
 2.0  5.0  NaN    4.0
 1.0  3.0  NaN  NaN

建议

意义 "反向" 在许多累积函数中,它允许您快速执行方向计算,而无需翻转或反射输入数组。