Ssyr

功能描述

asdBlasMakeSsyrPlan
接口功能：初始化该句柄对应的Ssyr算子配置。

asdBlasSsyr
接口功能：用于计算单精度向量的外积并将结果加到一个矩阵上。

计算公式

asdBlasSsyr

计算公式： $\text{[math]}$
示例：
输入“x”为：
```
[   [ 1 ], 
    [ 2 ] ]
```
输入“A”为：
```
[   [ 1, 2 ], 
    [ 3, 4 ]  ]
```
输入“uplo”为：U

输入“n”为：2，输入“lda”为：2，输入“incx”为：1，

输入“alpha”为：2.0，

其中，为：
```
 [ 1, 2 ]
```
为：
```
 [ 2, 4 ]
```
$\text{[math]}$ 为：
```
[ [ 2 ], [ 4 ] ] × [ 1, 2 ] =  [ [ 2, 4 ], [ 4, 8 ] ]
```
调用“Ssyr”算子后，

更新上三角数据，输出“A”为：
```
[   [ 3, 6 ], 
    [ 3, 12 ]  ].
```

接口原型

AspbStatus asdBlasMakeSsyrPlan(asdBlasHandle handle)
AspbStatus asdBlasSsyr(asdBlasHandle handle, asdBlasFillMode_t uplo, const int64_t n, const float *alpha, aclTensor *x, const int64_t incx, aclTensor *A, const int64_t lda)

参数列表

asdBlasMakeSsyrPlan

参数名称	Input/Output	类型	描述
handle	Input	asdBlasHandle	ssyr算子的句柄。

asdBlasSsyr

参数名称	Input/Output	类型	描述
handle	Input	asdBlasHandle	ssyr算子的句柄。
uplo	Input	asdBlasFillMode_t	指定矩阵A的存储方式。 ASDBLAS_FILL_MODE_LOWER // 下三角 ASDBLAS_FILL_MODE_UPPER // 上三角
n	Input	const int64_t	向量x中的元素个数，矩阵A的行列数。
alpha	Input	const float *	公式中的alpha，标量，向量乘积缩放因子。
x	Input	aclTensor *	公式中的x，Device侧的Tensor，数据类型支持FLOAT32，数据格式支持ND，shape为[n]。
incx	Input	const int64_t	x相邻元素间的内存地址偏移量（当前约束为1）。
A	Input/Output	aclTensor *	公式中的A，Device侧的Tensor，数据类型支持FLOAT32，数据格式支持ND，shape为[n, n]。
lda	Input	const int64_t	矩阵A的每列元素的存储步长（当前约束为n）。

规格约束

asdBlasMakeSsyrPlan：无。

asdBlasSsyr
- 输入的元素个数n理论支持[1, 9.22e+18]，当前覆盖支持[1, 16384]；
- 算子输入shape为[n]、[n, n]，输出shape为[n, n]；
- 算子实际计算时，不支持ND高维度运算（不支持维度≥3的运算）。

父主题： BLAS