.. _onemkl_blas_geru: geru ==== Computes a rank-1 update (unconjugated) of a general complex matrix. .. _onemkl_blas_geru_description: .. rubric:: Description The ``geru`` routines routines compute a scalar-vector-vector product and add the result to a general matrix. The operation is defined as .. math:: A \leftarrow alpha*x*y^T + A where: ``alpha`` is a scalar, ``A`` is an ``m``-by-``n`` matrix, ``x`` is a vector of length ``m``, ``y`` is a vector of length ``n``. ``geru`` supports the following precisions. .. list-table:: :header-rows: 1 * - T * - ``std::complex`` * - ``std::complex`` .. _onemkl_blas_geru_buffer: geru (Buffer Version) --------------------- .. rubric:: Syntax .. code-block:: cpp namespace oneapi::mkl::blas::column_major { void geru(sycl::queue &queue, std::int64_t m, std::int64_t n, T alpha, sycl::buffer &x, std::int64_t incx, sycl::buffer &y, std::int64_t incy, sycl::buffer &a, std::int64_t lda) } .. code-block:: cpp namespace oneapi::mkl::blas::row_major { void geru(sycl::queue &queue, std::int64_t m, std::int64_t n, T alpha, sycl::buffer &x, std::int64_t incx, sycl::buffer &y, std::int64_t incy, sycl::buffer &a, std::int64_t lda) } .. container:: section .. rubric:: Input Parameters queue The queue where the routine should be executed. m Number of rows of ``A``. Must be at least zero. n Number of columns of ``A``. Must be at least zero. alpha Scaling factor for the matrix-vector product. x Buffer holding input vector ``x``. The buffer must be of size at least (1 + (``m`` - 1)*abs(``incx``)). See :ref:`matrix-storage` for more details. incx Stride of vector ``x``. y Buffer holding input/output vector ``y``. The buffer must be of size at least (1 + (``n`` - 1)*abs(``incy``)). See :ref:`matrix-storage` for more details. incy Stride of vector ``y``. a Buffer holding input matrix ``A``. Must have size at least ``lda``\ \*\ ``n`` if column major layout is used or at least ``lda``\ \*\ ``m`` if row major layout is used. See :ref:`matrix-storage` for more details. lda Leading dimension of matrix ``A``. Must be positive and at least ``m`` if column major layout is used or at least ``n`` if row major layout is used. .. container:: section .. rubric:: Output Parameters a Buffer holding the updated matrix ``A``. .. _onemkl_blas_geru_usm: geru (USM Version) ------------------ .. rubric:: Syntax .. code-block:: cpp namespace oneapi::mkl::blas::column_major { sycl::event geru(sycl::queue &queue, std::int64_t m, std::int64_t n, T alpha, const T *x, std::int64_t incx, const T *y, std::int64_t incy, T *a, std::int64_t lda, const std::vector &dependencies = {}) } .. code-block:: cpp namespace oneapi::mkl::blas::row_major { sycl::event geru(sycl::queue &queue, std::int64_t m, std::int64_t n, T alpha, const T *x, std::int64_t incx, const T *y, std::int64_t incy, T *a, std::int64_t lda, const std::vector &dependencies = {}) } .. container:: section .. rubric:: Input Parameters queue The queue where the routine should be executed. m Number of rows of ``A``. Must be at least zero. n Number of columns of ``A``. Must be at least zero. alpha Scaling factor for the matrix-vector product. x Pointer to the input vector ``x``. The array holding input vector ``x`` must be of size at least (1 + (``m`` - 1)*abs(``incx``)). See :ref:`matrix-storage` for more details. incx Stride of vector ``x``. y Pointer to input/output vector ``y``. The array holding input/output vector ``y`` must be of size at least (1 + (``n`` - 1)*abs(``incy``)). See :ref:`matrix-storage` for more details. incy Stride of vector ``y``. a Pointer to input matrix ``A``. The array holding input matrix ``A`` must have size at least ``lda``\ \*\ ``n`` if column major layout is used or at least ``lda``\ \*\ ``m`` if row major layout is used. See :ref:`matrix-storage` for more details. lda Leading dimension of matrix ``A``. Must be positive and at least ``m`` if column major layout is used or at least ``n`` if row major layout is used. dependencies List of events to wait for before starting computation, if any. If omitted, defaults to no dependencies. .. container:: section .. rubric:: Output Parameters a Pointer to the updated matrix ``A``. .. container:: section .. rubric:: Return Values Output event to wait on to ensure computation is complete. **Parent topic:** :ref:`blas-level-2-routines`