Main Content

imgaussfilt3

三维图像的三维高斯滤波

全页折叠

语法

B = imgaussfilt3(A)
B = imgaussfilt3(A,sigma)
B = imgaussfilt3(___,Name,Value)

说明

示例

B = imgaussfilt3(A) 使用标准差为 0.5 的三维高斯平滑核对三维图像 A 进行滤波，并在 B 中返回滤波后的图像。

B = imgaussfilt3(A,sigma) 使用由 sigma 指定标准差的三维高斯平滑核对三维图像 A 进行滤波。

B = imgaussfilt3(___,Name,Value) 使用名称-值对组参量来控制滤波的各个方面。

示例

全部折叠

打开实时脚本

加载 MRI 数据并显示它。

vol = load('mri');
figure
montage(vol.D)
title('Original image volume')

用三维高斯滤波器对图像进行平滑处理。 

siz = vol.siz;
vol = squeeze(vol.D);   
sigma = 2;
 
volSmooth = imgaussfilt3(vol, sigma);
  
figure
montage(reshape(volSmooth,siz(1),siz(2),1,siz(3)))
title('Gaussian filtered image volume')

输入参数

全部折叠

要滤波的图像，指定为三维数值数组。

数据类型: single | double | int8 | uint8 | int16 | uint16 | int32 | uint32

高斯分布的标准差，指定为正数或由正数组成的三元素向量。如果 sigma 是标量，则 imgaussfilt3 使用一个三次高斯核。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量后，但对各个参量对组的顺序没有要求。

如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: volSmooth = imgaussfilt3(vol,sigma,"padding","circular");

高斯滤波器的大小，指定为标量或由正奇数组成的三元素向量。如果指定标量，则 imgaussfilt3 使用一个三次滤波器。默认滤波器大小为 2*ceil(2*sigma)+1。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

图像填充，指定为下列值之一。

值描述
数值标量用常量值元素填充图像。
"circular"

通过循环重复维度内的元素来填充。

"replicate"

通过重复数组的边界元素来填充。

"symmetric"

用自身的镜面反射填充图像。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

要在其中执行滤波的域，指定为下列值之一。

滤波域 描述
"auto"基于内部启发式方法，在空间域或频域中执行卷积。
"frequency"在频域中执行卷积。
"spatial"在空间域中执行卷积。

数据类型: char | string

输出参量

全部折叠

滤波后的图像，返回为与输入图像具有相同的类和大小的数值数组。

提示

  • 如果图像 A 包含 Inf 或 NaN，则频域滤波的 imgaussfilt3 的行为会是未定义状态。如果将 FilterDomain 参量设置为 "frequency"，或将其设置为 "auto" 并且 imgaussfilt3 使用频域滤波，就会发生这种情况。要以类似于 imfilter 的方式限制输出中 Inf 和 NaN 的传播，请考虑将 FilterDomain 参量设置为 "spatial"。

  • 如果将 FilterDomain 参量设置为 "auto"，则 imgaussfilt3 使用内部启发式方法来确定是空间域更快还是频域滤波更快。这种启发式方法依赖于机器，可能因不同配置而异。为了获得最优性能，请尝试两个选项 "spatial" 和 "frequency"，以确定适合您的图像和核大小的最佳滤波域。

  • 如果未指定 Padding 参量，则 imgaussfilt3 默认使用 "replicate" 填充，这与 imfilter 使用的默认填充不同。

扩展功能

版本历史记录

在 R2015a 中推出

全部展开

另请参阅

|