asin

反正弦（以弧度为单位）

全页折叠

语法

Y = asin(X)

说明

Y = asin(X) 以弧度为单位返回 X 各元素的反正弦 (sin^-1)。该函数同时接受实数和复数输入。

对于 X 在区间 [-1, 1] 内的实数值，asin(X) 返回区间 [-π/2, π/2] 内的值。
对于 X 在区间 [-1, 1] 之外的实数值以及 X 的复数值，asin(X) 返回复数值。

示例

全部折叠

值的反正弦

打开实时脚本

求值的反正弦。

y = asin(1)

y = 
1.5708

复数值向量的反正弦

打开实时脚本

计算向量 x 的各元素的反正弦。asin 函数按元素处理 x。

x = [0.5i 1+3i -2.2+i];
y = asin(x)

y = 1×3 complex

   0.0000 + 0.4812i   0.3076 + 1.8642i  -1.1091 + 1.5480i

绘制反正弦函数

打开实时脚本

在区间 $- 1 \leq x \leq 1$ 上绘制反正弦函数。

x = -1:.01:1; 
plot(x,asin(x))
grid on

Figure contains an axes object. The axes object contains an object of type line.

输入参数

全部折叠

`X` — 角的正弦
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

角正弦，指定为标量、向量、矩阵、多维数组、表或时间表。如果 X 为非标量，则按元素执行 asin 运算。

数据类型: single | double | table | timetable
复数支持: 是

详细信息

全部折叠

反正弦

反正弦定义为

$\sin^{- 1} (z) = - i \log [i z + {(1 - z^{2})}^{1 / 2}] .$

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

asin 函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

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

用法说明和限制：

当输入值 X 为实数而输出应为复数时，将在仿真过程中生成错误并在生成的代码中返回 NaN。要得到复数结果，需要通过传入 complex(X) 使输入值变成复数。

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

用法说明和限制：

当输入值 X 为实数而输出应为复数时，将在仿真过程中生成错误并在生成的代码中返回 NaN。要得到复数结果，需要通过传入 complex(X) 使输入值变成复数。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

asin 函数支持 GPU 数组输入，但有以下用法说明和限制：

如果在 GPU 上运行的函数的输出可能为复数，则必须将其输入参量显式指定为复数。有关详细信息，请参阅在 GPU 上处理复数 (Parallel Computing Toolbox)。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 中推出

全部展开

R2023a: 直接对表和时间表执行计算

asin 函数可以对表或时间表中的所有变量执行计算，而无需通过索引访问这些变量。所有变量都必须具有支持计算的数据类型。有关详细信息，请参阅Direct Calculations on Tables and Timetables。

另请参阅

asind | sin | sind | acsc

asin

语法

说明

示例

值的反正弦

复数值向量的反正弦

绘制反正弦函数

输入参数

X — 角的正弦 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

详细信息

反正弦

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

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

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

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2023a: 直接对表和时间表执行计算

另请参阅

`X` — 角的正弦
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

tall 数组
对行数太多而无法放入内存的数组进行计算。

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

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

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。