half

构造半精度数值对象

说明

使用 half 构造函数将半精度数据类型分配给数字或变量。半精度数据类型占用 16 位内存，但其浮点表示使其能够处理比相同大小的整数或定点数据类型更宽的动态范围。有关详细信息，请参阅Floating-Point Numbers和 What is Half Precision?。

有关支持使用半精度输入的代码生成的函数列表，请参阅Half Precision Code Generation Support。

创建对象

语法

a = half(v)

描述

示例

a = half(v) 将 v 中的值转换为半精度。

输入参数

全部展开

`v` — 输入数组
标量 | 向量 | 矩阵 | 多维数组

输入数组，指定为标量、向量、矩阵或多维数组。

对象函数

在 MATLAB^® 中，使用半精度输入的仿真支持这些函数。MATLAB System object™ 支持半精度数据类型，而 MATLAB System 模块支持具有实数值的半精度数据类型。有关支持使用半精度输入的代码生成的函数列表，请参阅Half Precision Code Generation Support。

全部展开

数学和算术

`abs`	绝对值和复数的模
`acos`	反余弦（以弧度为单位）
`acosh`	反双曲余弦
`asin`	反正弦（以弧度为单位）
`asinh`	反双曲正弦
`atan`	反正切（以弧度为单位）
`atan2`	四象限反正切
`atanh`	反双曲正切
`ceil`	向正无穷舍入
`conj`	复共轭
`conv`	卷积和多项式乘法
`conv2`	二维卷积
`cos`	以弧度为单位的参数的余弦
`cosh`	双曲余弦
`cospi`	准确计算 cos(X*pi)
`cumsum`	累积和
`dot`	点积
`exp`	指数
`expm1`	针对较小的 `X` 精确计算 `exp(X)-1`
`fft`	快速傅里叶变换
`fft2`	二维快速傅里叶变换
`fftn`	N 维快速傅里叶变换
`fftshift`	将零频分量移到频谱中心
`fix`	向零舍入
`floor`	向负无穷舍入
`fma`	Multiply and add using fused multiply add approach
`hypot`	平方和的平方根（斜边）
`ifft`	快速傅里叶逆变换
`ifft2`	二维快速傅里叶逆变换
`ifftn`	多维快速傅里叶逆变换
`ifftshift`	逆零频平移
`imag`	复数的虚部
`ldivide`	数组左除
`log`	自然对数
`log10`	常用对数（以 10 为底）
`log1p`	针对较小的 `X` 精确计算 `1+X` 的自然对数
`log2`	以 2 为底的对数和浮点数分解
`mean`	数组的均值
`minus`	减法
`mldivide`	求解关于 x 的线性方程组 Ax = B
`mod`	除后的余数（取模运算）
`mrdivide`	求解关于 x 的线性方程组 xA = B
`mtimes`	矩阵乘法
`plus`	添加数字，追加字符串
`pow10`	以 10 为底的幂和缩放半精度数
`pow2`	浮点数的以 2 为底的幂运算和缩放
`power`	按元素求幂
`prod`	数组元素的乘积
`rdivide`	数组右除
`real`	复数的实部
`rem`	除后的余数
`round`	舍入至最近的小数或整数
`rsqrt`	平方根倒数
`sign`	Sign 函数（符号函数）
`sin`	参数的正弦，以弧度为单位
`sinh`	双曲正弦
`sinpi`	准确地计算 sin(X*pi)
`sqrt`	平方根
`sum`	数组元素总和
`tan`	以弧度表示的参数的正切
`tanh`	双曲正切
`times`	乘法
`uminus`	一元减法
`uplus`	一元加法

数据类型

`allfinite`	Determine if all array elements are finite
`anynan`	确定是否有任一数组元素为 `NaN`
`cast`	将变量转换为不同的数据类型
`cell`	元胞数组
`double`	双精度数组
`eps`	浮点相对精度
`flintmax`	浮点格式的最大连续整数
`Inf`	创建所有值均为 `Inf` 的数组
`int16`	16 位有符号整数数组
`int32`	32 位有符号整数数组
`int64`	64 位有符号整数数组
`int8`	8 位有符号整数数组
`isa`	确定输入是否具有指定数据类型
`isfloat`	确定输入是否为浮点数据类型
`isinteger`	确定输入是否为整数数组
`islogical`	确定输入是否为逻辑数组
`isnan`	确定哪些数组元素为 NaN
`isnumeric`	确定输入是否为数值数组
`isobject`	确定输入是否为 MATLAB 对象
`isreal`	确定数组是否使用复数存储
`logical`	将数值转换为逻辑值
`NaN`	创建所有值均为 `NaN` 的数组
`realmax`	最大的正浮点数
`realmin`	最小标准浮点数
`single`	单精度数组
`storedInteger`	`fi` 对象的存储整数值
`typecast`	在不更改基础数据的情况下转换数据类型
`uint16`	16 位无符号整数数组
`uint32`	32 位无符号整数数组
`uint64`	64 位无符号整数数组
`uint8`	8 位无符号整数数组

关系和逻辑运算符

`all`	确定所有的数组元素是为非零还是 `true`
`and`	计算逻辑 AND
`Short-Circuit AND`	具有短路功能的逻辑 AND
`any`	确定是否有任何数组元素非零
`eq`	确定相等性
`ge`	决定大于或等于
`gt`	确定大于
`isequal`	确定数组相等性
`isequaln`	测试数组相等性，将 NaN 值视为相等
`le`	确定小于等于
`lt`	确定小于
`ne`	确定不相等性
`not`	计算逻辑 NOT
`or`	计算逻辑 OR
`Short-Circuit OR`	具有短路功能逻辑 OR

向量和矩阵运算

`cat`	串联数组。
`chol`	Cholesky 分解
`circshift`	循环平移数组
`colon`	向量创建、数组下标和 `for` 循环迭代
`complex`	创建复数数组
`ctranspose`	复共轭转置
`empty`	创建指定类的空数组
`eye`	单位矩阵
`flip`	翻转元素顺序
`fliplr`	将数组从左向右翻转
`flipud`	将数组从上向下翻转
`horzcat`	异构数组的水平串联
`iscolumn`	确定输入是否为列向量
`isempty`	确定数组是否为空
`isfinite`	确定哪些数组元素为有限
`isinf`	确定哪些数组元素为无限值
`ismatrix`	确定输入是否为矩阵
`isrow`	确定输入是否为行向量
`isscalar`	确定输入是否为标量
`issorted`	确定数组是否已排序
`isvector`	确定输入是否为向量
`length`	最大数组维度的长度
`lu`	LU 矩阵分解
`max`	数组的最大元素
`min`	数组的最小元素
`ndims`	数组维度数目
`numel`	数组元素的数目
`ones`	创建全部为 1 的数组
`permute`	置换数组维度
`repelem`	重复数组元素副本
`repmat`	重复数组副本
`reshape`	通过重新排列现有元素来重构数组
`size`	数组大小
`sort`	对数组元素排序
`squeeze`	删除长度为 1 的维度
`transpose`	转置向量或矩阵
`vertcat`	异构数组的垂直串联
`zeros`	创建全零数组

图形

`area`	二维 alpha 形状的面积
`bar`	条形图
`barh`	水平条形图
`fplot`	绘制表达式或函数
`line`	创建基本线条
`plot`	二维线图
`plot3`	三维点或线图
`plotmatrix`	散点图矩阵
`rgbplot`	绘制颜色图
`scatter`	散点图
`scatter3`	三维散点图
`xlim`	设置或查询 x 坐标轴范围
`ylim`	设置或查询 y 坐标轴范围
`zlim`	设置或查询 z 坐标轴范围

深度学习

`activations` (Deep Learning Toolbox)	计算深度学习网络层激活
`classify` (Deep Learning Toolbox)	(Not recommended) Classify data using trained deep learning neural network
`predict` (Deep Learning Toolbox)	Reconstruct the inputs using trained autoencoder
`predictAndUpdateState` (Deep Learning Toolbox)	(Not recommended) Predict responses using a trained recurrent neural network and update the network state

要显示支持函数的列表，请在 MATLAB 命令行窗口中输入：

methods(half(1))

示例

全部折叠

将值转换为半精度

要将双精度数字转换为半精度，请使用 half 函数。

a = half(pi)

a = 

  half

    3.1406

您也可以使用 half 函数将现有变量转换为半精度。

v = single(magic(3))

v = 3x3 single matrix

     8     1     6
     3     5     7
     4     9     2

a = half(v)

a = 

  3x3 half matrix

     8     1     6
     3     5     7
     4     9     2

限制

不支持结合使用半精度和逻辑类型的算术运算。
有关其他使用说明和限制，请参阅Half Precision Code Generation Support。

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

有关支持使用半精度输入的代码生成的函数列表和任何相关联的限制，请参阅Half Precision Code Generation Support。
如果您的目标硬件不支持半精度，则 half 将用作存储类型，算术运算以单精度执行。
有些函数仅将 half 用作存储类型，以单精度执行算术运算，不管目标硬件是什么。
对于深度学习代码生成，半精度输入会转换为单精度，计算以单精度执行。
在 MATLAB 中，isobject 函数以半精度输入返回 true。在生成的代码中，此函数返回 false。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

有关支持使用半精度输入的代码生成的函数列表和任何相关联的限制，请参阅Half Precision Code Generation Support。
要生成和执行具有半精度数据类型的代码，CUDA^® 计算能力必须为 5.3 或更高。
要生成和执行具有半精度数据类型的代码，CUDA 工具包的版本必须为 10.0 或更高。
您必须将内存分配 (malloc) 模式设置为 'Discrete'，才能生成 CUDA 代码。
GPU 代码生成不支持半精度复数数据类型。
如果您的目标硬件不支持半精度，则 half 将用作存储类型，算术运算以单精度执行。
有些函数仅将 half 用作存储类型，以单精度执行算术运算，不管目标硬件是什么。
对于深度学习代码生成，半精度输入会转换为单精度，计算以单精度执行。要将计算量减半，请在 coder.DeepLearningConfig 中将库目标设置为 'tensorrt'，并将数据类型设置为 'FP16'。
在 MATLAB 中，isobject 函数以半精度输入返回 true。在生成的代码中，此函数返回 false。