From 179ccee3f0ce1c137a48b2bad93273858f1676b3 Mon Sep 17 00:00:00 2001 From: nscipione Date: Wed, 9 Oct 2024 14:38:55 +0200 Subject: [PATCH 01/16] First commit renaming oneMKL spec to oneMath - Move source/elements/oneMKL to source/elements/oneMath - Rename files using "mkl" or "onemkl" to "onemath" - Rename occurrences of "oneMKL" and "onemkl" to "oneMath" and "onemath" respectively Signed-off-by: nscipione --- doc/versioning.rst | 2 +- roadmap.rst | 8 +- scripts/oneapi.py | 2 +- source/architecture.rst | 2 +- source/elements/element_list.rst | 2 +- .../source/architecture/architecture.rst | 23 --- .../architecture/execution_model.inc.rst | 91 ---------- .../source/architecture/memory_model.inc.rst | 34 ---- .../oneMKL/source/domains/stats.inc.rst | 15 -- .../domains/stats/onemkl_stats_routines.rst | 76 -------- source/elements/oneMKL/source/index.rst | 24 --- .../source/appendix/acknowledgment.inc.rst | 4 +- .../source/appendix/appendix.rst | 4 +- .../appendix/future_considerations.inc.rst | 2 +- .../source/architecture/api_design.inc.rst | 78 ++++---- .../source/architecture/architecture.rst | 23 +++ .../source/architecture/exceptions.inc.rst | 44 ++--- .../architecture/execution_model.inc.rst | 91 ++++++++++ .../source/architecture/memory_model.inc.rst | 34 ++++ .../architecture/other_architecture.inc.rst | 12 +- .../{oneMKL => oneMath}/source/conf.py | 2 +- .../source/domains/blas/asum.rst | 28 +-- .../source/domains/blas/axpby.rst | 28 +-- .../source/domains/blas/axpy.rst | 28 +-- .../source/domains/blas/axpy_batch.rst | 30 ++-- .../domains/blas/blas-level-1-routines.rst | 34 ++-- .../domains/blas/blas-level-2-routines.rst | 52 +++--- .../domains/blas/blas-level-3-routines.rst | 20 +-- .../domains/blas/blas-like-extensions.rst | 26 +-- .../source/domains/blas/blas.rst | 6 +- .../source/domains/blas/copy.rst | 28 +-- .../source/domains/blas/copy_batch.rst | 30 ++-- .../source/domains/blas/dgmm_batch.rst | 34 ++-- .../source/domains/blas/dot.rst | 28 +-- .../source/domains/blas/dotc.rst | 28 +-- .../source/domains/blas/dotu.rst | 28 +-- .../source/domains/blas/gbmv.rst | 32 ++-- .../source/domains/blas/gemm.rst | 28 +-- .../source/domains/blas/gemm_batch.rst | 42 ++--- .../source/domains/blas/gemm_bias.rst | 40 ++--- .../source/domains/blas/gemmt.rst | 40 ++--- .../source/domains/blas/gemv.rst | 30 ++-- .../source/domains/blas/gemv_batch.rst | 36 ++-- .../source/domains/blas/ger.rst | 28 +-- .../source/domains/blas/gerc.rst | 28 +-- .../source/domains/blas/geru.rst | 28 +-- .../source/domains/blas/hbmv.rst | 32 ++-- .../source/domains/blas/hemm.rst | 36 ++-- .../source/domains/blas/hemv.rst | 32 ++-- .../source/domains/blas/her.rst | 32 ++-- .../source/domains/blas/her2.rst | 32 ++-- .../source/domains/blas/her2k.rst | 32 ++-- .../source/domains/blas/herk.rst | 36 ++-- .../source/domains/blas/hpmv.rst | 32 ++-- .../source/domains/blas/hpr.rst | 32 ++-- .../source/domains/blas/hpr2.rst | 32 ++-- .../source/domains/blas/iamax.rst | 28 +-- .../source/domains/blas/iamin.rst | 28 +-- .../source/domains/blas/imatcopy.rst | 32 ++-- .../source/domains/blas/imatcopy_batch.rst | 32 ++-- .../source/domains/blas/nrm2.rst | 28 +-- .../source/domains/blas/omatadd.rst | 36 ++-- .../source/domains/blas/omatadd_batch.rst | 38 ++-- .../source/domains/blas/omatcopy.rst | 32 ++-- .../source/domains/blas/omatcopy2.rst | 32 ++-- .../source/domains/blas/omatcopy_batch.rst | 32 ++-- .../source/domains/blas/rot.rst | 28 +-- .../source/domains/blas/rotg.rst | 28 +-- .../source/domains/blas/rotm.rst | 28 +-- .../source/domains/blas/rotmg.rst | 28 +-- .../source/domains/blas/sbmv.rst | 32 ++-- .../source/domains/blas/scal.rst | 28 +-- .../source/domains/blas/sdsdot.rst | 28 +-- .../source/domains/blas/spmv.rst | 32 ++-- .../source/domains/blas/spr.rst | 32 ++-- .../source/domains/blas/spr2.rst | 32 ++-- .../source/domains/blas/swap.rst | 28 +-- .../source/domains/blas/symm.rst | 36 ++-- .../source/domains/blas/symv.rst | 32 ++-- .../source/domains/blas/syr.rst | 32 ++-- .../source/domains/blas/syr2.rst | 32 ++-- .../source/domains/blas/syr2k.rst | 32 ++-- .../source/domains/blas/syrk.rst | 36 ++-- .../source/domains/blas/syrk_batch.rst | 40 ++--- .../source/domains/blas/tbmv.rst | 40 ++--- .../source/domains/blas/tbsv.rst | 40 ++--- .../source/domains/blas/tpmv.rst | 40 ++--- .../source/domains/blas/tpsv.rst | 40 ++--- .../source/domains/blas/trmm.rst | 80 ++++----- .../source/domains/blas/trmv.rst | 40 ++--- .../source/domains/blas/trsm.rst | 80 ++++----- .../source/domains/blas/trsm_batch.rst | 52 +++--- .../source/domains/blas/trsv.rst | 40 ++--- .../domains/dense_linear_algebra.inc.rst | 8 +- .../source/domains/dft/compute_backward.rst | 10 +- .../source/domains/dft/compute_forward.rst | 10 +- .../dft/config_params/data_layouts.rst | 42 ++--- .../dft/config_params/storage_formats.rst | 12 +- .../dft/config_params/workspace_placement.rst | 10 +- .../source/domains/dft/descriptor.rst | 28 +-- .../source/domains/dft/dft.rst | 20 +-- .../domains/dft/enums_and_config_params.rst | 16 +- .../discrete_fourier_transforms.inc.rst | 4 +- .../source/domains/domains.rst | 4 +- .../equations/error_functions_plot.jpg | Bin .../inverse_error_functions_plot.jpg | Bin .../source/domains/equations/rng-leapfrog.png | Bin .../domains/equations/rng-skip-ahead.png | Bin .../source/domains/lapack/gebrd.rst | 36 ++-- .../domains/lapack/gebrd_scratchpad_size.rst | 18 +- .../source/domains/lapack/geqrf.rst | 32 ++-- .../source/domains/lapack/geqrf_batch.rst | 38 ++-- .../lapack/geqrf_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/geqrf_scratchpad_size.rst | 18 +- .../source/domains/lapack/gerqf.rst | 32 ++-- .../domains/lapack/gerqf_scratchpad_size.rst | 16 +- .../source/domains/lapack/gesvd.rst | 34 ++-- .../domains/lapack/gesvd_scratchpad_size.rst | 18 +- .../source/domains/lapack/getrf.rst | 32 ++-- .../source/domains/lapack/getrf_batch.rst | 38 ++-- .../lapack/getrf_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/getrf_scratchpad_size.rst | 18 +- .../source/domains/lapack/getri.rst | 44 ++--- .../source/domains/lapack/getri_batch.rst | 56 +++--- .../lapack/getri_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/getri_scratchpad_size.rst | 18 +- .../source/domains/lapack/getrs.rst | 42 ++--- .../source/domains/lapack/getrs_batch.rst | 54 +++--- .../lapack/getrs_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/getrs_scratchpad_size.rst | 18 +- .../source/domains/lapack/heevd.rst | 32 ++-- .../domains/lapack/heevd_scratchpad_size.rst | 18 +- .../source/domains/lapack/hegvd.rst | 32 ++-- .../domains/lapack/hegvd_scratchpad_size.rst | 18 +- .../source/domains/lapack/hetrd.rst | 32 ++-- .../domains/lapack/hetrd_scratchpad_size.rst | 18 +- .../source/domains/lapack/hetrf.rst | 32 ++-- .../domains/lapack/hetrf_scratchpad_size.rst | 18 +- .../lapack/lapack-like-extensions.inc.rst | 34 ++-- .../lapack-linear-equation-routines.inc.rst | 70 ++++---- ...singular-value-eigenvalue-routines.inc.rst | 58 +++--- .../source/domains/lapack/lapack.rst | 8 +- .../source/domains/lapack/orgbr.rst | 52 +++--- .../domains/lapack/orgbr_scratchpad_size.rst | 22 +-- .../source/domains/lapack/orgqr.rst | 44 ++--- .../source/domains/lapack/orgqr_batch.rst | 60 +++---- .../lapack/orgqr_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/orgqr_scratchpad_size.rst | 18 +- .../source/domains/lapack/orgtr.rst | 50 +++--- .../domains/lapack/orgtr_scratchpad_size.rst | 20 +-- .../source/domains/lapack/ormqr.rst | 44 ++--- .../domains/lapack/ormqr_scratchpad_size.rst | 18 +- .../source/domains/lapack/ormrq.rst | 44 ++--- .../domains/lapack/ormrq_scratchpad_size.rst | 16 +- .../source/domains/lapack/ormtr.rst | 50 +++--- .../domains/lapack/ormtr_scratchpad_size.rst | 20 +-- .../source/domains/lapack/potrf.rst | 32 ++-- .../source/domains/lapack/potrf_batch.rst | 38 ++-- .../lapack/potrf_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/potrf_scratchpad_size.rst | 18 +- .../source/domains/lapack/potri.rst | 38 ++-- .../domains/lapack/potri_scratchpad_size.rst | 18 +- .../source/domains/lapack/potrs.rst | 38 ++-- .../source/domains/lapack/potrs_batch.rst | 48 ++--- .../lapack/potrs_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/potrs_scratchpad_size.rst | 18 +- .../source/domains/lapack/syevd.rst | 32 ++-- .../domains/lapack/syevd_scratchpad_size.rst | 18 +- .../source/domains/lapack/sygvd.rst | 32 ++-- .../domains/lapack/sygvd_scratchpad_size.rst | 18 +- .../source/domains/lapack/sytrd.rst | 32 ++-- .../domains/lapack/sytrd_scratchpad_size.rst | 18 +- .../source/domains/lapack/sytrf.rst | 32 ++-- .../domains/lapack/sytrf_scratchpad_size.rst | 18 +- .../source/domains/lapack/trtrs.rst | 32 ++-- .../domains/lapack/trtrs_scratchpad_size.rst | 18 +- .../source/domains/lapack/ungbr.rst | 56 +++--- .../domains/lapack/ungbr_scratchpad_size.rst | 22 +-- .../source/domains/lapack/ungqr.rst | 44 ++--- .../source/domains/lapack/ungqr_batch.rst | 66 +++---- .../lapack/ungqr_batch_scratchpad_size.rst | 26 +-- .../domains/lapack/ungqr_scratchpad_size.rst | 18 +- .../source/domains/lapack/ungtr.rst | 50 +++--- .../domains/lapack/ungtr_scratchpad_size.rst | 20 +-- .../source/domains/lapack/unmqr.rst | 44 ++--- .../domains/lapack/unmqr_scratchpad_size.rst | 18 +- .../source/domains/lapack/unmrq.rst | 44 ++--- .../domains/lapack/unmrq_scratchpad_size.rst | 16 +- .../source/domains/lapack/unmtr.rst | 50 +++--- .../domains/lapack/unmtr_scratchpad_size.rst | 20 +-- .../source/domains/matrix-storage.rst | 4 +- .../domains/random_number_generators.inc.rst | 10 +- .../source/domains/rng/bibliography.rst | 2 +- ...istributions-template-parameter-method.rst | 2 +- .../rng/device_api/device-distributions.rst | 28 +-- .../domains/rng/device_api/device-engines.rst | 22 +-- .../rng/device_api/device-rng-bernoulli.rst | 6 +- .../rng/device_api/device-rng-beta.rst | 4 +- .../rng/device_api/device-rng-bits.rst | 6 +- .../rng/device_api/device-rng-exponential.rst | 6 +- .../rng/device_api/device-rng-gamma.rst | 4 +- .../rng/device_api/device-rng-gaussian.rst | 6 +- .../device-rng-generate-routines.rst | 4 +- .../rng/device_api/device-rng-generate.rst | 8 +- .../rng/device_api/device-rng-lognormal.rst | 6 +- .../rng/device_api/device-rng-mcg31m1.rst | 8 +- .../rng/device_api/device-rng-mcg59.rst | 6 +- .../rng/device_api/device-rng-mrg32k3a.rst | 6 +- .../device_api/device-rng-philox4x32x10.rst | 8 +- .../rng/device_api/device-rng-poisson.rst | 6 +- .../rng/device_api/device-rng-skip-ahead.rst | 4 +- .../device_api/device-rng-uniform-bits.rst | 6 +- .../device-rng-uniform-continuous.rst | 6 +- .../device-rng-uniform-discrete.rst | 6 +- .../rng/device_api/device-rng-usage-model.rst | 8 +- .../rng/device_api/device-routines.rst | 14 +- .../device_api/device-service-routines.rst | 6 +- ...mplate-parameter-mkl-rng-method-values.rst | 4 +- .../domains/rng/host_api/distributions.rst | 68 +++---- ...engines-basic-random-number-generators.rst | 92 +++++----- .../domains/rng/host_api/generate-routine.rst | 6 +- .../domains/rng/host_api/mkl-rng-ars5.rst | 18 +- .../rng/host_api/mkl-rng-bernoulli.rst | 12 +- .../domains/rng/host_api/mkl-rng-beta.rst | 12 +- .../domains/rng/host_api/mkl-rng-binomial.rst | 12 +- .../domains/rng/host_api/mkl-rng-bits.rst | 8 +- .../domains/rng/host_api/mkl-rng-cauchy.rst | 12 +- .../rng/host_api/mkl-rng-chi_square.rst | 12 +- .../rng/host_api/mkl-rng-default_engine.rst | 8 +- .../rng/host_api/mkl-rng-exponential.rst | 12 +- .../domains/rng/host_api/mkl-rng-gamma.rst | 12 +- .../domains/rng/host_api/mkl-rng-gaussian.rst | 12 +- .../rng/host_api/mkl-rng-gaussian_mv.rst | 12 +- .../domains/rng/host_api/mkl-rng-generate.rst | 18 +- .../rng/host_api/mkl-rng-geometric.rst | 12 +- .../domains/rng/host_api/mkl-rng-gumbel.rst | 12 +- .../rng/host_api/mkl-rng-hypergeometric.rst | 12 +- .../domains/rng/host_api/mkl-rng-laplace.rst | 12 +- .../domains/rng/host_api/mkl-rng-leapfrog.rst | 8 +- .../rng/host_api/mkl-rng-lognormal.rst | 12 +- .../domains/rng/host_api/mkl-rng-mcg31m1.rst | 12 +- .../domains/rng/host_api/mkl-rng-mcg59.rst | 12 +- .../domains/rng/host_api/mkl-rng-mrg32k3a.rst | 14 +- .../domains/rng/host_api/mkl-rng-mt19937.rst | 18 +- .../domains/rng/host_api/mkl-rng-mt2203.rst | 26 +-- .../rng/host_api/mkl-rng-multinomial.rst | 12 +- .../rng/host_api/mkl-rng-negbinomial.rst | 12 +- .../rng/host_api/mkl-rng-niederreiter.rst | 14 +- .../rng/host_api/mkl-rng-nondeterministic.rst | 10 +- .../rng/host_api/mkl-rng-philox4x32x10.rst | 14 +- .../domains/rng/host_api/mkl-rng-poisson.rst | 12 +- .../rng/host_api/mkl-rng-poisson_v.rst | 12 +- .../domains/rng/host_api/mkl-rng-r250.rst | 14 +- .../domains/rng/host_api/mkl-rng-rayleigh.rst | 14 +- .../rng/host_api/mkl-rng-sfmt19937.rst | 18 +- .../rng/host_api/mkl-rng-skip_ahead.rst | 10 +- .../domains/rng/host_api/mkl-rng-sobol.rst | 14 +- .../host_api/mkl-rng-uniform-continuous.rst | 12 +- .../rng/host_api/mkl-rng-uniform-discrete.rst | 12 +- .../rng/host_api/mkl-rng-uniform_bits.rst | 8 +- .../domains/rng/host_api/mkl-rng-weibull.rst | 12 +- .../rng/host_api/mkl-rng-wichmann_hill.rst | 18 +- .../rng/host_api/onemath-rng-usage-model.rst} | 6 +- .../rng/host_api/rng-host-routines.rst | 16 +- .../domains/rng/host_api/service-routines.rst | 8 +- .../domains/rng/onemath-rng-overview.rst} | 10 +- .../domains/sparse_linear_algebra.inc.rst | 4 +- .../spblas/data_types/data_handles.rst | 36 ++-- .../spblas/data_types/format-descriptions.rst | 10 +- .../spblas/data_types/init_coo_matrix.rst | 54 +++--- .../spblas/data_types/init_csr_matrix.rst | 54 +++--- .../spblas/data_types/init_dense_matrix.rst | 30 ++-- .../spblas/data_types/init_dense_vector.rst | 30 ++-- .../data_types/release_dense_matrix.rst | 12 +- .../data_types/release_dense_vector.rst | 12 +- .../data_types/release_sparse_matrix.rst | 14 +- .../spblas/data_types/set_coo_matrix_data.rst | 54 +++--- .../spblas/data_types/set_csr_matrix_data.rst | 54 +++--- .../data_types/set_dense_matrix_data.rst | 34 ++-- .../data_types/set_dense_vector_data.rst | 34 ++-- .../spblas/data_types/set_matrix_property.rst | 14 +- .../source/domains/spblas/matrix_view.rst | 12 +- .../source/domains/spblas/operations/spmm.rst | 58 +++--- .../source/domains/spblas/operations/spmv.rst | 56 +++--- .../source/domains/spblas/operations/spsv.rst | 56 +++--- .../source/domains/spblas/spblas.rst | 12 +- .../source/domains/spblas/supported-types.rst | 8 +- .../oneMath/source/domains/stats.inc.rst | 15 ++ .../stats/onemath_stats_central_moment.rst} | 16 +- ...nemath_stats_central_moment_user_mean.rst} | 16 +- .../stats/onemath_stats_central_sum.rst} | 16 +- .../onemath_stats_central_sum_user_mean.rst} | 16 +- .../domains/stats/onemath_stats_dataset.rst} | 12 +- .../domains/stats/onemath_stats_kurtosis.rst} | 16 +- .../onemath_stats_kurtosis_user_mean.rst} | 16 +- .../stats/onemath_stats_make_dataset.rst} | 16 +- .../domains/stats/onemath_stats_max.rst} | 16 +- .../domains/stats/onemath_stats_mean.rst} | 16 +- .../domains/stats/onemath_stats_min.rst} | 16 +- .../domains/stats/onemath_stats_min_max.rst} | 16 +- .../domains/stats/onemath_stats_overview.rst} | 20 +-- .../stats/onemath_stats_raw_moment.rst} | 16 +- .../domains/stats/onemath_stats_raw_sum.rst} | 16 +- .../domains/stats/onemath_stats_routines.rst | 76 ++++++++ .../stats/onemath_stats_service_routines.rst} | 8 +- .../domains/stats/onemath_stats_skewness.rst} | 16 +- .../onemath_stats_skewness_user_mean.rst} | 16 +- .../stats/onemath_stats_usage_model.rst} | 8 +- .../stats/onemath_stats_variation.rst} | 16 +- .../onemath_stats_variation_user_mean.rst} | 16 +- .../source/domains/value_or_pointer.rst | 14 +- .../source/domains/vector_math.inc.rst | 4 +- .../source/domains/vm/abs.rst | 10 +- .../source/domains/vm/acos.rst | 14 +- .../source/domains/vm/acosh.rst | 14 +- .../source/domains/vm/acospi.rst | 14 +- .../source/domains/vm/add.rst | 14 +- .../source/domains/vm/arg.rst | 12 +- .../source/domains/vm/asin.rst | 14 +- .../source/domains/vm/asinh.rst | 10 +- .../source/domains/vm/asinpi.rst | 14 +- .../source/domains/vm/atan.rst | 10 +- .../source/domains/vm/atan2.rst | 10 +- .../source/domains/vm/atan2pi.rst | 10 +- .../source/domains/vm/atanh.rst | 14 +- .../source/domains/vm/atanpi.rst | 10 +- .../source/domains/vm/bibliography.rst | 2 +- .../source/domains/vm/cbrt.rst | 10 +- .../source/domains/vm/cdfnorm.rst | 14 +- .../source/domains/vm/cdfnorminv.rst | 14 +- .../source/domains/vm/ceil.rst | 10 +- .../source/domains/vm/cis.rst | 14 +- .../source/domains/vm/clear_status.rst | 4 +- .../source/domains/vm/conj.rst | 10 +- .../source/domains/vm/copysign.rst | 10 +- .../source/domains/vm/cos.rst | 14 +- .../source/domains/vm/cosd.rst | 14 +- .../source/domains/vm/cosh.rst | 14 +- .../source/domains/vm/cospi.rst | 14 +- .../domains/vm/create_error_handler.rst | 4 +- .../source/domains/vm/div.rst | 14 +- .../source/domains/vm/erf.rst | 10 +- .../source/domains/vm/erfc.rst | 14 +- .../source/domains/vm/erfcinv.rst | 14 +- .../source/domains/vm/erfinv.rst | 14 +- .../source/domains/vm/exp.rst | 14 +- .../source/domains/vm/exp10.rst | 14 +- .../source/domains/vm/exp2.rst | 14 +- .../source/domains/vm/expint1.rst | 14 +- .../source/domains/vm/expm1.rst | 14 +- .../source/domains/vm/fdim.rst | 10 +- .../source/domains/vm/floor.rst | 10 +- .../source/domains/vm/fmax.rst | 10 +- .../source/domains/vm/fmin.rst | 10 +- .../source/domains/vm/fmod.rst | 14 +- .../source/domains/vm/frac.rst | 10 +- .../source/domains/vm/get_mode.rst | 6 +- .../source/domains/vm/get_status.rst | 4 +- .../source/domains/vm/hypot.rst | 10 +- .../source/domains/vm/inv.rst | 14 +- .../source/domains/vm/invcbrt.rst | 14 +- .../source/domains/vm/invsqrt.rst | 14 +- .../source/domains/vm/lgamma.rst | 14 +- .../source/domains/vm/linearfrac.rst | 16 +- .../source/domains/vm/ln.rst | 14 +- .../source/domains/vm/log10.rst | 14 +- .../source/domains/vm/log1p.rst | 14 +- .../source/domains/vm/log2.rst | 14 +- .../source/domains/vm/logb.rst | 14 +- .../source/domains/vm/maxmag.rst | 10 +- .../source/domains/vm/minmag.rst | 10 +- .../source/domains/vm/modf.rst | 10 +- .../source/domains/vm/mul.rst | 14 +- .../source/domains/vm/mulbyconj.rst | 14 +- .../source/domains/vm/nearbyint.rst | 10 +- .../source/domains/vm/nextafter.rst | 14 +- .../source/domains/vm/pow.rst | 14 +- .../source/domains/vm/pow2o3.rst | 14 +- .../source/domains/vm/pow3o2.rst | 14 +- .../source/domains/vm/powr.rst | 14 +- .../source/domains/vm/powx.rst | 14 +- .../source/domains/vm/remainder.rst | 14 +- .../source/domains/vm/rint.rst | 10 +- .../source/domains/vm/round.rst | 10 +- .../source/domains/vm/set_status.rst | 4 +- .../source/domains/vm/setmode.rst | 4 +- .../source/domains/vm/sin.rst | 14 +- .../source/domains/vm/sincos.rst | 14 +- .../source/domains/vm/sind.rst | 14 +- .../source/domains/vm/sinh.rst | 14 +- .../source/domains/vm/sinpi.rst | 14 +- .../domains/vm/special-value-notations.rst | 4 +- .../source/domains/vm/sqr.rst | 10 +- .../source/domains/vm/sqrt.rst | 14 +- .../source/domains/vm/sub.rst | 14 +- .../source/domains/vm/tan.rst | 14 +- .../source/domains/vm/tand.rst | 14 +- .../source/domains/vm/tanh.rst | 10 +- .../source/domains/vm/tanpi.rst | 14 +- .../source/domains/vm/tgamma.rst | 14 +- .../source/domains/vm/trunc.rst | 10 +- .../source/domains/vm/vm-exceptions.rst | 2 +- .../domains/vm/vm-mathematical-functions.rst | 166 +++++++++--------- .../domains/vm/vm-service-functions.rst | 16 +- .../source/domains/vm/vm.rst | 10 +- source/elements/oneMath/source/index.rst | 24 +++ source/index.rst | 2 +- source/spelling_wordlist.txt | 4 +- 408 files changed, 4513 insertions(+), 4513 deletions(-) delete mode 100644 source/elements/oneMKL/source/architecture/architecture.rst delete mode 100644 source/elements/oneMKL/source/architecture/execution_model.inc.rst delete mode 100644 source/elements/oneMKL/source/architecture/memory_model.inc.rst delete mode 100755 source/elements/oneMKL/source/domains/stats.inc.rst delete mode 100755 source/elements/oneMKL/source/domains/stats/onemkl_stats_routines.rst delete mode 100644 source/elements/oneMKL/source/index.rst rename source/elements/{oneMKL => oneMath}/source/appendix/acknowledgment.inc.rst (64%) rename source/elements/{oneMKL => oneMath}/source/appendix/appendix.rst (83%) rename source/elements/{oneMKL => oneMath}/source/appendix/future_considerations.inc.rst (93%) rename source/elements/{oneMKL => oneMath}/source/architecture/api_design.inc.rst (70%) create mode 100644 source/elements/oneMath/source/architecture/architecture.rst rename source/elements/{oneMKL => oneMath}/source/architecture/exceptions.inc.rst (68%) create mode 100644 source/elements/oneMath/source/architecture/execution_model.inc.rst create mode 100644 source/elements/oneMath/source/architecture/memory_model.inc.rst rename source/elements/{oneMKL => oneMath}/source/architecture/other_architecture.inc.rst (76%) rename source/elements/{oneMKL => oneMath}/source/conf.py (97%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/asum.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/axpby.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/axpy.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/axpy_batch.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/blas-level-1-routines.rst (66%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/blas-level-2-routines.rst (68%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/blas-level-3-routines.rst (74%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/blas-like-extensions.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/blas.rst (54%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/copy.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/copy_batch.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/dgmm_batch.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/dot.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/dotc.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/dotu.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gbmv.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemm.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemm_batch.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemm_bias.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemmt.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemv.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gemv_batch.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/ger.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/gerc.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/geru.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hbmv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hemm.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hemv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/her.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/her2.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/her2k.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/herk.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hpmv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hpr.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/hpr2.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/iamax.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/iamin.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/imatcopy.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/imatcopy_batch.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/nrm2.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/omatadd.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/omatadd_batch.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/omatcopy.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/omatcopy2.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/omatcopy_batch.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/rot.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/rotg.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/rotm.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/rotmg.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/sbmv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/scal.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/sdsdot.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/spmv.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/spr.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/spr2.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/swap.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/symm.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/symv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/syr.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/syr2.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/syr2k.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/syrk.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/syrk_batch.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/tbmv.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/tbsv.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/tpmv.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/tpsv.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/trmm.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/trmv.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/trsm.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/trsm_batch.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/blas/trsv.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/dense_linear_algebra.inc.rst (53%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/compute_backward.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/compute_forward.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/config_params/data_layouts.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/config_params/storage_formats.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/config_params/workspace_placement.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/descriptor.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/dft.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/dft/enums_and_config_params.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/discrete_fourier_transforms.inc.rst (60%) rename source/elements/{oneMKL => oneMath}/source/domains/domains.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/equations/error_functions_plot.jpg (100%) rename source/elements/{oneMKL => oneMath}/source/domains/equations/inverse_error_functions_plot.jpg (100%) rename source/elements/{oneMKL => oneMath}/source/domains/equations/rng-leapfrog.png (100%) rename source/elements/{oneMKL => oneMath}/source/domains/equations/rng-skip-ahead.png (100%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gebrd.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gebrd_scratchpad_size.rst (69%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/geqrf.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/geqrf_batch.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/geqrf_batch_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/geqrf_scratchpad_size.rst (70%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gerqf.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gerqf_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gesvd.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/gesvd_scratchpad_size.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrf.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrf_batch.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrf_batch_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrf_scratchpad_size.rst (71%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getri.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getri_batch.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getri_batch_scratchpad_size.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getri_scratchpad_size.rst (70%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrs.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrs_batch.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrs_batch_scratchpad_size.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/getrs_scratchpad_size.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/heevd.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/heevd_scratchpad_size.rst (74%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hegvd.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hegvd_scratchpad_size.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hetrd.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hetrd_scratchpad_size.rst (73%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hetrf.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/hetrf_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/lapack-like-extensions.inc.rst (67%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/lapack-linear-equation-routines.inc.rst (62%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst (63%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/lapack.rst (73%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgbr.rst (81%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgbr_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgqr.rst (81%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgqr_batch.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgqr_batch_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgqr_scratchpad_size.rst (72%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgtr.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/orgtr_scratchpad_size.rst (69%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormqr.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormqr_scratchpad_size.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormrq.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormrq_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormtr.rst (81%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ormtr_scratchpad_size.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrf.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrf_batch.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrf_batch_scratchpad_size.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrf_scratchpad_size.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potri.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potri_scratchpad_size.rst (73%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrs.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrs_batch.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrs_batch_scratchpad_size.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/potrs_scratchpad_size.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/syevd.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/syevd_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sygvd.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sygvd_scratchpad_size.rst (78%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sytrd.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sytrd_scratchpad_size.rst (72%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sytrf.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/sytrf_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/trtrs.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/trtrs_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungbr.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungbr_scratchpad_size.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungqr.rst (81%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungqr_batch.rst (83%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungqr_batch_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungqr_scratchpad_size.rst (72%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungtr.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/ungtr_scratchpad_size.rst (70%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmqr.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmqr_scratchpad_size.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmrq.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmrq_scratchpad_size.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmtr.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/lapack/unmtr_scratchpad_size.rst (78%) rename source/elements/{oneMKL => oneMath}/source/domains/matrix-storage.rst (99%) rename source/elements/{oneMKL => oneMath}/source/domains/random_number_generators.inc.rst (53%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/bibliography.rst (99%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-distributions-template-parameter-method.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-distributions.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-engines.rst (64%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-bernoulli.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-beta.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-bits.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-exponential.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-gamma.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-gaussian.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-generate-routines.rst (62%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-generate.rst (81%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-lognormal.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-mcg31m1.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-mcg59.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-mrg32k3a.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-philox4x32x10.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-poisson.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-skip-ahead.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-uniform-bits.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-uniform-continuous.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-uniform-discrete.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-rng-usage-model.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-routines.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/device_api/device-service-routines.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/distributions.rst (72%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/engines-basic-random-number-generators.rst (62%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/generate-routine.rst (71%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-ars5.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-bernoulli.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-beta.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-binomial.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-bits.rst (73%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-cauchy.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-chi_square.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-default_engine.rst (72%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-exponential.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-gamma.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-gaussian.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-generate.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-geometric.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-gumbel.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-hypergeometric.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-laplace.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-leapfrog.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-lognormal.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-mcg31m1.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-mcg59.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-mt19937.rst (82%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-mt2203.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-multinomial.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-negbinomial.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-niederreiter.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-nondeterministic.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-poisson.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-poisson_v.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-r250.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-rayleigh.rst (88%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-sfmt19937.rst (85%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-skip_ahead.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-sobol.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst (90%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-uniform_bits.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-weibull.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst (91%) rename source/elements/{oneMKL/source/domains/rng/host_api/onemkl-rng-usage-model.rst => oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst} (93%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/rng-host-routines.rst (74%) rename source/elements/{oneMKL => oneMath}/source/domains/rng/host_api/service-routines.rst (72%) rename source/elements/{oneMKL/source/domains/rng/onemkl-rng-overview.rst => oneMath/source/domains/rng/onemath-rng-overview.rst} (83%) rename source/elements/{oneMKL => oneMath}/source/domains/sparse_linear_algebra.inc.rst (91%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/data_handles.rst (69%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/format-descriptions.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/init_coo_matrix.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/init_csr_matrix.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/init_dense_matrix.rst (84%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/init_dense_vector.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/release_dense_matrix.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/release_dense_vector.rst (79%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/release_sparse_matrix.rst (77%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/set_coo_matrix_data.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/set_csr_matrix_data.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/set_dense_matrix_data.rst (80%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/set_dense_vector_data.rst (74%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/data_types/set_matrix_property.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/matrix_view.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/operations/spmm.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/operations/spmv.rst (87%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/operations/spsv.rst (86%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/spblas.rst (73%) rename source/elements/{oneMKL => oneMath}/source/domains/spblas/supported-types.rst (74%) create mode 100755 source/elements/oneMath/source/domains/stats.inc.rst rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_central_moment.rst => oneMath/source/domains/stats/onemath_stats_central_moment.rst} (92%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_central_moment_user_mean.rst => oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_central_sum.rst => oneMath/source/domains/stats/onemath_stats_central_sum.rst} (92%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_central_sum_user_mean.rst => oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst} (92%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_dataset.rst => oneMath/source/domains/stats/onemath_stats_dataset.rst} (92%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_kurtosis.rst => oneMath/source/domains/stats/onemath_stats_kurtosis.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_kurtosis_user_mean.rst => oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst} (90%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_make_dataset.rst => oneMath/source/domains/stats/onemath_stats_make_dataset.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_max.rst => oneMath/source/domains/stats/onemath_stats_max.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_mean.rst => oneMath/source/domains/stats/onemath_stats_mean.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_min.rst => oneMath/source/domains/stats/onemath_stats_min.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_min_max.rst => oneMath/source/domains/stats/onemath_stats_min_max.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_overview.rst => oneMath/source/domains/stats/onemath_stats_overview.rst} (65%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_raw_moment.rst => oneMath/source/domains/stats/onemath_stats_raw_moment.rst} (93%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_raw_sum.rst => oneMath/source/domains/stats/onemath_stats_raw_sum.rst} (93%) create mode 100755 source/elements/oneMath/source/domains/stats/onemath_stats_routines.rst rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_service_routines.rst => oneMath/source/domains/stats/onemath_stats_service_routines.rst} (67%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_skewness.rst => oneMath/source/domains/stats/onemath_stats_skewness.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_skewness_user_mean.rst => oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst} (90%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_usage_model.rst => oneMath/source/domains/stats/onemath_stats_usage_model.rst} (87%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_variation.rst => oneMath/source/domains/stats/onemath_stats_variation.rst} (91%) rename source/elements/{oneMKL/source/domains/stats/onemkl_stats_variation_user_mean.rst => oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst} (90%) rename source/elements/{oneMKL => oneMath}/source/domains/value_or_pointer.rst (89%) rename source/elements/{oneMKL => oneMath}/source/domains/vector_math.inc.rst (78%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/abs.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/acos.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/acosh.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/acospi.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/add.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/arg.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/asin.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/asinh.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/asinpi.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/atan.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/atan2.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/atan2pi.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/atanh.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/atanpi.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/bibliography.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cbrt.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cdfnorm.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cdfnorminv.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/ceil.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cis.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/clear_status.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/conj.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/copysign.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cos.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cosd.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cosh.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/cospi.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/create_error_handler.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/div.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/erf.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/erfc.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/erfcinv.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/erfinv.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/exp.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/exp10.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/exp2.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/expint1.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/expm1.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/fdim.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/floor.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/fmax.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/fmin.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/fmod.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/frac.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/get_mode.rst (92%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/get_status.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/hypot.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/inv.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/invcbrt.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/invsqrt.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/lgamma.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/linearfrac.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/ln.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/log10.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/log1p.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/log2.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/logb.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/maxmag.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/minmag.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/modf.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/mul.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/mulbyconj.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/nearbyint.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/nextafter.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/pow.rst (97%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/pow2o3.rst (93%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/pow3o2.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/powr.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/powx.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/remainder.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/rint.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/round.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/set_status.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/setmode.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sin.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sincos.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sind.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sinh.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sinpi.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/special-value-notations.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sqr.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sqrt.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/sub.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/tan.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/tand.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/tanh.rst (96%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/tanpi.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/tgamma.rst (94%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/trunc.rst (95%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/vm-exceptions.rst (98%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/vm-mathematical-functions.rst (76%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/vm-service-functions.rst (75%) rename source/elements/{oneMKL => oneMath}/source/domains/vm/vm.rst (81%) create mode 100644 source/elements/oneMath/source/index.rst diff --git a/doc/versioning.rst b/doc/versioning.rst index 2810ef372..75757fb8c 100644 --- a/doc/versioning.rst +++ b/doc/versioning.rst @@ -7,7 +7,7 @@ Specification versioning ======================== This document describes the versioning of the specification for oneAPI -elements (e.g. oneMKL, oneVPL) and for oneAPI, which includes all the +elements (e.g. oneMath, oneVPL) and for oneAPI, which includes all the elements. Specification versioning is independent of oneAPI product versioning. diff --git a/roadmap.rst b/roadmap.rst index c29be2ffa..763ae6aff 100644 --- a/roadmap.rst +++ b/roadmap.rst @@ -267,7 +267,7 @@ feedback. - Future - Content? -- oneMKL +- oneMath - New - Future @@ -342,7 +342,7 @@ Date Milestone - 80% content -- oneMKL +- oneMath - USM support - Skeleton of spec, breadown by domain @@ -412,7 +412,7 @@ Date Milestone - Updates deferred to 0.8.5_ -- oneMKL +- oneMath - All domains complete - Finalized BLAS, LAPACK domains @@ -497,7 +497,7 @@ Elements - oneVPL -- oneMKL +- oneMath - finalize FFT, sparse BLAS, RNG, and VM domains diff --git a/scripts/oneapi.py b/scripts/oneapi.py index ca4d1ab10..a1eb8775d 100644 --- a/scripts/oneapi.py +++ b/scripts/oneapi.py @@ -251,7 +251,7 @@ def sort_words(root, target=None): dirs = [ 'oneCCL', 'oneDAL', - 'oneMKL', + 'oneMath', 'oneTBB', 'oneDPL', 'oneDNN', diff --git a/source/architecture.rst b/source/architecture.rst index 8fb6d1905..85072beea 100644 --- a/source/architecture.rst +++ b/source/architecture.rst @@ -89,7 +89,7 @@ API Programming Example API programming requires the programmer to specify the target device and the memory communication strategy. In the following example, we call the -oneMKL matrix multiply routine, GEMM. We are writing in SYCL and +oneMath matrix multiply routine, GEMM. We are writing in SYCL and omitting irrelevant details. We create a queue initialized with a *gpu_selector* to specify that we diff --git a/source/elements/element_list.rst b/source/elements/element_list.rst index 50c982545..da8c8e905 100644 --- a/source/elements/element_list.rst +++ b/source/elements/element_list.rst @@ -12,5 +12,5 @@ - :ref:`oneDAL-section`: Algorithms for accelerated data science - :ref:`oneTBB-section`: Library for adding thread-based parallelism to complex applications on multiprocessors -- :ref:`oneMKL-section`: High performance math routines for science, +- :ref:`oneMath-section`: High performance math routines for science, engineering, and financial applications diff --git a/source/elements/oneMKL/source/architecture/architecture.rst b/source/elements/oneMKL/source/architecture/architecture.rst deleted file mode 100644 index 2ea254c0e..000000000 --- a/source/elements/oneMKL/source/architecture/architecture.rst +++ /dev/null @@ -1,23 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemkl_architecture: - -oneMKL Architecture -==================== - -The oneMKL element of oneAPI has several general assumptions, requirements and recommendations for all domains contained therein. These will be addressed in this architecture section. -In particular, DPC++ allows for a great control over the execution of kernels on the various devices. We discuss the supported execution models of oneMKL APIs in :ref:`onemkl_execution_model`. -A discussion of how data is stored and passed in and out of the APIs is addressed in :ref:`onemkl_memory_model`. -The general structure and design of oneMKL APIs including namespaces and common data types are expressed in :ref:`onemkl_api_design`. -The exceptions and error handling are described in :ref:`onemkl_exceptions`. -Finally all the other necessary aspects related to oneMKL architecture can be found in :ref:`onemkl_arch_other` including versioning and discussion of pre and post conditions. -Other nonessential, but useful aspects of the oneMKL architecture and design may also be found in the :ref:`onemkl_appendix`. - - -.. include:: execution_model.inc.rst -.. include:: memory_model.inc.rst -.. include:: api_design.inc.rst -.. include:: exceptions.inc.rst -.. include:: other_architecture.inc.rst diff --git a/source/elements/oneMKL/source/architecture/execution_model.inc.rst b/source/elements/oneMKL/source/architecture/execution_model.inc.rst deleted file mode 100644 index d15c14103..000000000 --- a/source/elements/oneMKL/source/architecture/execution_model.inc.rst +++ /dev/null @@ -1,91 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemkl_execution_model: - -Execution Model ---------------- - -This section describes the execution environment common to all oneMKL functionality. The execution environment includes how data is provided to computational routines in :ref:`onemkl_queues`, support for several devices in :ref:`onemkl_device_usage`, synchronous and asynchronous execution models in :ref:`onemkl_asynchronous_synchronous_execution` and :ref:`onemkl_host_thread_safety`. - -.. _onemkl_queues: - -Use of Queues -+++++++++++++ - -The ``sycl::queue`` defined in the oneAPI DPC++ specification is used to specify the device and features enabled on that device on which a task will be enqueued. There are two forms of computational routines in oneMKL: class based :ref:`onemkl_member_functions` and standalone :ref:`onemkl_nonmember_functions`. As these may interact with the ``sycl::queue`` in different ways, we provide a section for each one to describe assumptions. - - -.. _onemkl_nonmember_functions: - -Non-Member Functions -******************** - -Each oneMKL non-member computational routine takes a ``sycl::queue`` reference as its first parameter:: - - mkl::domain::routine(sycl::queue &q, ...); - -All computation performed by the routine shall be done on the hardware device(s) associated with this queue, with possible aid from the host, unless otherwise specified. -In the case of an ordered queue, all computation shall also be ordered with respect to other kernels as if enqueued on that queue. - -A particular oneMKL implementation may not support the execution of a given oneMKL routine on the specified device(s). In this case, the implementation may either perform the computation on the host or throw an exception. See :ref:`onemkl_exceptions` for the possible exceptions. - - -.. _onemkl_member_functions: - -Member Functions -**************** - -oneMKL class-based APIs, such as those in the RNG and DFT domains, require a ``sycl::queue`` as an argument to the constructor or another setup routine. -The execution requirements for computational routines from the previous section also apply to computational class methods. - -.. _onemkl_device_usage: - -Device Usage -++++++++++++ - -oneMKL itself does not currently provide any interfaces for controlling device usage: for instance, controlling the number of cores used on the CPU, or the number of execution units on a GPU. However, such functionality may be available by partitioning a ``sycl::device`` instance into subdevices, when supported by the device. - -When given a queue associated with such a subdevice, a oneMKL implementation shall only perform computation on that subdevice. - -.. _onemkl_asynchronous_synchronous_execution: - -Asynchronous Execution -++++++++++++++++++++++ -The oneMKL API is designed to allow asynchronous execution of computational routines, to facilitate concurrent usage of multiple devices in the system. Each computational routine enqueues work to be performed on the selected device, and may (but is not required to) return before execution completes. - -Hence, it is the calling application's responsibility to ensure that any inputs are valid until computation is complete, and likewise to wait for computation completion before reading any outputs. This can be done automatically when using DPC++ buffers, or manually when using Unified Shared Memory (USM) pointers, as described in the sections below. - -Unless otherwise specified, asynchronous execution is *allowed*, but not *guaranteed*, by any oneMKL computational routine, and may vary between implementations and/or versions. oneMKL implementations must clearly document whether execution is guaranteed to be asynchronous for each supported routine. Regardless, calling applications shall not launch any oneMKL computational routine with a dependency on a future oneMKL API call, even if this computational routine executes asynchronously (i.e. a oneMKL implementation may assume no antidependencies are present). This guarantee allows oneMKL implementations to reserve resources for execution without risking deadlock. - -.. _onemkl_synchronization_with_buffers: - -Synchronization When Using Buffers -*********************************** - -``sycl::buffer`` objects automatically manage synchronization between kernel launches linked by a data dependency (either read-after-write, write-after-write, or write-after-read). - -oneMKL routines are not required to perform any additional synchronization of ``sycl::buffer`` arguments. - -.. _onemkl_synchronization_with_usm: - -Synchronization When Using USM APIs -*********************************** - -When USM pointers are used as input to, or output from, a oneMKL routine, it becomes the calling application's responsibility to manage possible asynchronicity. - -To help the calling application, all oneMKL routines with at least one USM pointer argument also take an optional reference to a list of *input events*, of type ``std::vector``, and have a return value of type ``sycl::event`` representing computation completion:: - - sycl::event mkl::domain::routine(..., std::vector &in_events = {}); - -The routine shall ensure that all input events (if the list is present and non-empty) have occurred before any USM pointers are accessed. Likewise, the routine's output event shall not be complete until the routine has finished accessing all USM pointer arguments. - -For class methods, "argument" includes any USM pointers previously provided to the object via the class constructor or other class methods. - -.. _onemkl_host_thread_safety: - -Host Thread Safety -++++++++++++++++++ - -All oneMKL member and non-member functions shall be *host thread safe*. That is, they may be safely called simultaneously from concurrent host threads. However, oneMKL objects in class-based APIs may not be shared between concurrent host threads unless otherwise specified. diff --git a/source/elements/oneMKL/source/architecture/memory_model.inc.rst b/source/elements/oneMKL/source/architecture/memory_model.inc.rst deleted file mode 100644 index 34693ad64..000000000 --- a/source/elements/oneMKL/source/architecture/memory_model.inc.rst +++ /dev/null @@ -1,34 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemkl_memory_model: - -Memory Model -------------- - -The oneMKL memory model shall follow directly from the oneAPI memory model. Mainly, oneMKL shall support two modes of encapsulating data for consumption on the device: the buffer memory abstraction model and the pointer-based memory model using Unified Shared Memory (USM). These two paradigms shall also support both synchronous and asynchronous execution models as described in :ref:`onemkl_asynchronous_synchronous_execution`. - - -.. _onemkl_buffers: - -The Buffer Memory Model -+++++++++++++++++++++++ - -The SYCL 1.2.1 specification defines the buffer container templated on the provided data type which encapsulates the data in a SYCL application across both host and devices. It provides the concept of accessors as the mechanism to access the buffer data with different modes to read and or write into that data. These accessors allow SYCL to create and manage the data dependencies in the SYCL graph that order the kernel executions. With the buffer model, all data movement is handled by the SYCL runtime supporting both synchronous and asynchronous execution. - -oneMKL provides APIs where buffers (in particular 1D buffers, ``sycl::buffer``) contain the memory for all non scalar input and output data arguments. See :ref:`onemkl_synchronization_with_buffers` for details on how oneMKL routines manage any data dependencies with buffer arguments. Any higher dimensional buffer must be converted to a 1D buffer prior to use in oneMKL APIs, e.g., via ``buffer::reinterpret``. - - - -.. _onemkl_usm: - -Unified Shared Memory Model -+++++++++++++++++++++++++++ - -While the buffer model is powerful and elegantly expresses data dependencies, it can be a burden for programmers to replace all pointers and arrays by buffers in their C++ applications. DPC++ also provides pointer-based addressing for device-accessible data, using the Unified Shared Memory (USM) model. Correspondingly, oneMKL provides USM APIs in which non-scalar input and output data arguments are passed by USM pointer. - -USM devices and system configurations vary in their ability to share data between devices and between a device and the host. oneMKL implementations may only assume that user-provided USM pointers are accessible by the device associated with the user-provided queue. In particular, an implementation must not assume that USM pointers can be accessed by any other device, or by the host, without querying the DPC++ runtime. An implementation must accept any device-accessible USM pointer regardless of how it was created (`sycl::malloc_device`, `sycl::malloc_shared`, etc.). - -Unlike buffers, USM pointers cannot automatically manage data dependencies between kernels. Users may use in-order queues to ensure ordered execution, or explicitly manage dependencies with ``sycl::event`` objects. To support the second use case, oneMKL USM APIs accept input events (prerequisites before computation can begin) and return an output event (indicating computation is complete). See :ref:`onemkl_synchronization_with_usm` for details. - diff --git a/source/elements/oneMKL/source/domains/stats.inc.rst b/source/elements/oneMKL/source/domains/stats.inc.rst deleted file mode 100755 index 3b953cab8..000000000 --- a/source/elements/oneMKL/source/domains/stats.inc.rst +++ /dev/null @@ -1,15 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemkl_stats: - -Summary Statistics -------------------- - -The oneMKL provides a set of :ref:`Summary Statistics routines ` that compute basic statistical estimates for single and double precision multi-dimensional datasets. - -.. toctree:: - :hidden: - - stats/onemkl_stats_overview.rst \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_routines.rst b/source/elements/oneMKL/source/domains/stats/onemkl_stats_routines.rst deleted file mode 100755 index 4ac38578e..000000000 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_routines.rst +++ /dev/null @@ -1,76 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemkl_stats_routines: - -Summary Statistics Routines -=========================== - -The oneMKL Summary Statistics routines calculate next estimates: - -.. container:: - - .. container:: tablenoborder - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - :ref:`onemkl_stats_raw_sum` - - Raw sums up to the fourth order - * - :ref:`onemkl_stats_central_sum` - - Central sums up to the fourth order - * - :ref:`onemkl_stats_central_sum_user_mean` - - Central sums up to the fourth order with provided mean - * - :ref:`onemkl_stats_mean` - - Mean value - * - :ref:`onemkl_stats_raw_moment` - - Raw moments up to the fourth order - * - :ref:`onemkl_stats_central_moment` - - Central moments up to the fourth order - * - :ref:`onemkl_stats_central_moment_user_mean` - - Central moments up to the fourth order with provided mean - * - :ref:`onemkl_stats_variation` - - Variation coefficient - * - :ref:`onemkl_stats_variation_user_mean` - - Variation coefficient with provided mean - * - :ref:`onemkl_stats_skewness` - - Skewness value - * - :ref:`onemkl_stats_skewness_user_mean` - - Skewness value with provided mean - * - :ref:`onemkl_stats_kurtosis` - - Kurtosis value - * - :ref:`onemkl_stats_kurtosis_user_mean` - - Kurtosis value with provided mean - * - :ref:`onemkl_stats_min` - - Min value - * - :ref:`onemkl_stats_max` - - Max value - * - :ref:`onemkl_stats_min_max` - - Min and max values -   - **Parent topic:** :ref:`onemkl_stats` - - - -.. toctree:: - :hidden: - - onemkl_stats_raw_sum - onemkl_stats_central_sum - onemkl_stats_central_sum_user_mean - onemkl_stats_mean - onemkl_stats_raw_moment - onemkl_stats_central_moment - onemkl_stats_central_moment_user_mean - onemkl_stats_variation - onemkl_stats_variation_user_mean - onemkl_stats_skewness - onemkl_stats_skewness_user_mean - onemkl_stats_kurtosis - onemkl_stats_kurtosis_user_mean - onemkl_stats_min - onemkl_stats_max - onemkl_stats_min_max \ No newline at end of file diff --git a/source/elements/oneMKL/source/index.rst b/source/elements/oneMKL/source/index.rst deleted file mode 100644 index 2ca635aa0..000000000 --- a/source/elements/oneMKL/source/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _oneMKL-section: - -====== -oneMKL -====== - -The |mkl_full_name| (oneMKL) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMKL is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math. - - -The general assumptions, design features and requirements for the oneMKL library and host-to-device computational routines will be described in :ref:`onemkl_architecture`. -The individual domains and their APIs are described in :ref:`onemkl_domains`. -Other design considerations that are not necessarily part of the oneMKL specification but that are worth mentioning will be discussed in :ref:`onemkl_appendix`. - - -.. toctree:: - :maxdepth: 2 - - architecture/architecture.rst - domains/domains.rst - appendix/appendix.rst diff --git a/source/elements/oneMKL/source/appendix/acknowledgment.inc.rst b/source/elements/oneMath/source/appendix/acknowledgment.inc.rst similarity index 64% rename from source/elements/oneMKL/source/appendix/acknowledgment.inc.rst rename to source/elements/oneMath/source/appendix/acknowledgment.inc.rst index 1e3ea2e19..41677b3a7 100644 --- a/source/elements/oneMKL/source/appendix/acknowledgment.inc.rst +++ b/source/elements/oneMath/source/appendix/acknowledgment.inc.rst @@ -2,10 +2,10 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_acknowledgment: +.. _onemath_acknowledgment: Acknowledgment --------------- -The oneMKL `Technical Advisory Board `__ members +The oneMath `Technical Advisory Board `__ members provided valuable feedback to the specification and are thanked for their contributions. diff --git a/source/elements/oneMKL/source/appendix/appendix.rst b/source/elements/oneMath/source/appendix/appendix.rst similarity index 83% rename from source/elements/oneMKL/source/appendix/appendix.rst rename to source/elements/oneMath/source/appendix/appendix.rst index bc2561880..d5e673d2e 100644 --- a/source/elements/oneMKL/source/appendix/appendix.rst +++ b/source/elements/oneMath/source/appendix/appendix.rst @@ -2,9 +2,9 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_appendix: +.. _onemath_appendix: -oneMKL Appendix +oneMath Appendix ================ .. include:: future_considerations.inc.rst diff --git a/source/elements/oneMKL/source/appendix/future_considerations.inc.rst b/source/elements/oneMath/source/appendix/future_considerations.inc.rst similarity index 93% rename from source/elements/oneMKL/source/appendix/future_considerations.inc.rst rename to source/elements/oneMath/source/appendix/future_considerations.inc.rst index e892ac216..75e5dfd0f 100644 --- a/source/elements/oneMKL/source/appendix/future_considerations.inc.rst +++ b/source/elements/oneMath/source/appendix/future_considerations.inc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_future_considerations: +.. _onemath_future_considerations: Future considerations --------------------- diff --git a/source/elements/oneMKL/source/architecture/api_design.inc.rst b/source/elements/oneMath/source/architecture/api_design.inc.rst similarity index 70% rename from source/elements/oneMKL/source/architecture/api_design.inc.rst rename to source/elements/oneMath/source/architecture/api_design.inc.rst index 00d8753cc..b2dddfefd 100644 --- a/source/elements/oneMKL/source/architecture/api_design.inc.rst +++ b/source/elements/oneMath/source/architecture/api_design.inc.rst @@ -2,82 +2,82 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_api_design: +.. _onemath_api_design: API Design ----------- -This section discusses the general features of oneMKL API design. In particular, it covers the use of namespaces and data types from C++, from DPC++ and new ones introduced for oneMKL APIs. +This section discusses the general features of oneMath API design. In particular, it covers the use of namespaces and data types from C++, from DPC++ and new ones introduced for oneMath APIs. -.. _onemkl_namespaces: +.. _onemath_namespaces: -oneMKL namespaces +oneMath namespaces ++++++++++++++++++ -The oneMKL library uses C++ namespaces to organize routines by mathematical domain. All oneMKL objects and routines shall be contained within the ``oneapi::mkl`` base namespace. The individual oneMKL domains use a secondary namespace layer as follows: +The oneMath library uses C++ namespaces to organize routines by mathematical domain. All oneMath objects and routines shall be contained within the ``oneapi::mkl`` base namespace. The individual oneMath domains use a secondary namespace layer as follows: ======================== ======================================================================================================= -namespace oneMKL domain or content +namespace oneMath domain or content ======================== ======================================================================================================= -``oneapi::mkl`` oneMKL base namespace, contains general oneMKL data types, objects, exceptions and routines -``oneapi::mkl::blas`` Dense linear algebra routines from BLAS and BLAS like extensions. The oneapi::mkl::blas namespace should contain two namespaces column_major and row_major to support both matrix layouts. See :ref:`onemkl_blas` -``oneapi::mkl::lapack`` Dense linear algebra routines from LAPACK and LAPACK like extensions. See :ref:`onemkl_lapack` -``oneapi::mkl::sparse`` Sparse linear algebra routines from Sparse BLAS and Sparse Solvers. See :ref:`onemkl_sparse_linear_algebra` -``oneapi::mkl::dft`` Discrete Fourier Transforms. See :ref:`onemkl_dft` -``oneapi::mkl::rng`` Random number generator routines. See :ref:`onemkl_rng` -``oneapi::mkl::vm`` Vector mathematics routines, e.g. trigonometric, exponential functions acting on elements of a vector. See :ref:`onemkl_vm` +``oneapi::mkl`` oneMath base namespace, contains general oneMath data types, objects, exceptions and routines +``oneapi::mkl::blas`` Dense linear algebra routines from BLAS and BLAS like extensions. The oneapi::mkl::blas namespace should contain two namespaces column_major and row_major to support both matrix layouts. See :ref:`onemath_blas` +``oneapi::mkl::lapack`` Dense linear algebra routines from LAPACK and LAPACK like extensions. See :ref:`onemath_lapack` +``oneapi::mkl::sparse`` Sparse linear algebra routines from Sparse BLAS and Sparse Solvers. See :ref:`onemath_sparse_linear_algebra` +``oneapi::mkl::dft`` Discrete Fourier Transforms. See :ref:`onemath_dft` +``oneapi::mkl::rng`` Random number generator routines. See :ref:`onemath_rng` +``oneapi::mkl::vm`` Vector mathematics routines, e.g. trigonometric, exponential functions acting on elements of a vector. See :ref:`onemath_vm` ======================== ======================================================================================================= .. note:: :name: Implementation Requirement - Inside each oneMKL domain, there are many routines, classes, enums and objects defined which constitute the breadth and scope of that oneMKL domain. - It is permitted for a library implementation of the oneMKL specification to implement either all, one or more than one of the domains in oneMKL. However, within an implementation of a specific domain, all relevant routines, classes, enums and objects (including those relevant enums and objects which live outside a particular domain in the general ``oneapi::mkl`` namespace must be both declared and defined in the library so that an application that uses that domain could build and link against that library implementation successfully. + Inside each oneMath domain, there are many routines, classes, enums and objects defined which constitute the breadth and scope of that oneMath domain. + It is permitted for a library implementation of the oneMath specification to implement either all, one or more than one of the domains in oneMath. However, within an implementation of a specific domain, all relevant routines, classes, enums and objects (including those relevant enums and objects which live outside a particular domain in the general ``oneapi::mkl`` namespace must be both declared and defined in the library so that an application that uses that domain could build and link against that library implementation successfully. - It is however acceptable to throw the runtime exception :ref:`oneapi::mkl::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. - For instance, a library may choose to implement the oneMKL BLAS functionality and in particular may choose to implement only the :ref:`onemkl_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::mkl::unimplemented` exception inside all the others. + It is however acceptable to throw the runtime exception :ref:`oneapi::mkl::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. + For instance, a library may choose to implement the oneMath BLAS functionality and in particular may choose to implement only the :ref:`onemath_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::mkl::unimplemented` exception inside all the others. In such a case, the implemented routines in such a library should be communicated clearly and easily understood by users of that library. -.. _onemkl_cpp_datatypes: +.. _onemath_cpp_datatypes: Standard C++ datatype usage +++++++++++++++++++++++++++ -oneMKL uses C++ STL data types for scalars where applicable: +oneMath uses C++ STL data types for scalars where applicable: * Integer scalars are C++ fixed-size integer types (``std::intN_t``, ``std::uintN_t``). * Complex numbers are represented by C++ ``std::complex`` types. -In general, scalar integer arguments to oneMKL routines are 64-bit integers (``std::int64_t`` or ``std::uint64_t``). Integer vectors and matrices may have varying bit widths, defined on a per-routine basis. +In general, scalar integer arguments to oneMath routines are 64-bit integers (``std::int64_t`` or ``std::uint64_t``). Integer vectors and matrices may have varying bit widths, defined on a per-routine basis. -.. _onemkl_dpcpp_datatypes: +.. _onemath_dpcpp_datatypes: DPC++ datatype usage ++++++++++++++++++++ -oneMKL uses the following DPC++ data types: +oneMath uses the following DPC++ data types: -* SYCL queue ``sycl::queue`` for scheduling kernels on a SYCL device. See :ref:`onemkl_queues` for more details. -* SYCL buffer ``sycl::buffer`` for buffer-based memory access. See :ref:`onemkl_buffers` for more details. -* Unified Shared Memory (USM) for pointer-based memory access. See :ref:`onemkl_usm` for more details. -* SYCL event ``sycl::event`` for output event synchronization in oneMKL routines with USM pointers. See :ref:`onemkl_synchronization_with_usm` for more details. -* Vector of SYCL events ``std::vector`` for input events synchronization in oneMKL routines with USM pointers. See :ref:`onemkl_synchronization_with_usm` for more details. +* SYCL queue ``sycl::queue`` for scheduling kernels on a SYCL device. See :ref:`onemath_queues` for more details. +* SYCL buffer ``sycl::buffer`` for buffer-based memory access. See :ref:`onemath_buffers` for more details. +* Unified Shared Memory (USM) for pointer-based memory access. See :ref:`onemath_usm` for more details. +* SYCL event ``sycl::event`` for output event synchronization in oneMath routines with USM pointers. See :ref:`onemath_synchronization_with_usm` for more details. +* Vector of SYCL events ``std::vector`` for input events synchronization in oneMath routines with USM pointers. See :ref:`onemath_synchronization_with_usm` for more details. .. note:: - The class ``sycl::vector_class`` has been removed from SYCL 2020 and the standard class ``std::vector`` should be used instead for vector of SYCL events in oneMKL routines with USM pointers + The class ``sycl::vector_class`` has been removed from SYCL 2020 and the standard class ``std::vector`` should be used instead for vector of SYCL events in oneMath routines with USM pointers -.. _onemkl_datatypes: +.. _onemath_datatypes: -oneMKL defined datatypes +oneMath defined datatypes ++++++++++++++++++++++++ -oneMKL dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::mkl`` namespace. +oneMath dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::mkl`` namespace. Each enumeration value comes with two names: A single-character name (the traditional BLAS/LAPACK character) and a longer, more descriptive name. The two names are exactly equivalent and may be used interchangeably. - .. _onemkl_enum_transpose: + .. _onemath_enum_transpose: .. rubric:: transpose :name: transpose @@ -104,7 +104,7 @@ Each enumeration value comes with two names: A single-character name (the tradit - ``transpose::conjtrans`` - Perform Hermitian transpose (transpose and conjugate). Is the same as ``transpose::trans`` for real matrices. - .. _onemkl_enum_uplo: + .. _onemath_enum_uplo: .. rubric:: uplo :name: uplo @@ -132,7 +132,7 @@ Each enumeration value comes with two names: A single-character name (the tradit In both cases, elements that are not in the selected triangle are not accessed or updated. - .. _onemkl_enum_diag: + .. _onemath_enum_diag: .. rubric:: diag :name: diag @@ -156,7 +156,7 @@ Each enumeration value comes with two names: A single-character name (the tradit - ``diag::unit`` - The matrix is unit triangular (the diagonal entries are all 1's). The diagonal entries in the matrix data are not accessed. - .. _onemkl_enum_side: + .. _onemath_enum_side: .. rubric:: side :name: side @@ -181,7 +181,7 @@ Each enumeration value comes with two names: A single-character name (the tradit - ``side::right`` - The special form matrix is on the right in the multiplication. - .. _onemkl_enum_offset: + .. _onemath_enum_offset: .. rubric:: offset :name: offset @@ -209,7 +209,7 @@ Each enumeration value comes with two names: A single-character name (the tradit - ``offset::row`` - The offset to apply to the output matrix is a row offset, that is to say all the rows in the ``C_offset`` matrix are the same and given by the elements in the ``co`` array. - .. _onemkl_enum_index_base: + .. _onemath_enum_index_base: .. rubric:: index_base :name: index_base @@ -232,7 +232,7 @@ Each enumeration value comes with two names: A single-character name (the tradit - Index arrays for an input matrix are provided using one-based (Fortran style) index values. That is, indices start at 1. - .. _onemkl_enum_layout: + .. _onemath_enum_layout: .. rubric:: layout :name: layout @@ -259,6 +259,6 @@ Each enumeration value comes with two names: A single-character name (the tradit .. note:: - :ref:`onemkl_appendix` may contain other API design decisions or recommendations that may be of use to the general developer of oneMKL, but which may not necessarily be part of the oneMKL specification. + :ref:`onemath_appendix` may contain other API design decisions or recommendations that may be of use to the general developer of oneMath, but which may not necessarily be part of the oneMath specification. diff --git a/source/elements/oneMath/source/architecture/architecture.rst b/source/elements/oneMath/source/architecture/architecture.rst new file mode 100644 index 000000000..248132c2c --- /dev/null +++ b/source/elements/oneMath/source/architecture/architecture.rst @@ -0,0 +1,23 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_architecture: + +oneMath Architecture +==================== + +The oneMath element of oneAPI has several general assumptions, requirements and recommendations for all domains contained therein. These will be addressed in this architecture section. +In particular, DPC++ allows for a great control over the execution of kernels on the various devices. We discuss the supported execution models of oneMath APIs in :ref:`onemath_execution_model`. +A discussion of how data is stored and passed in and out of the APIs is addressed in :ref:`onemath_memory_model`. +The general structure and design of oneMath APIs including namespaces and common data types are expressed in :ref:`onemath_api_design`. +The exceptions and error handling are described in :ref:`onemath_exceptions`. +Finally all the other necessary aspects related to oneMath architecture can be found in :ref:`onemath_arch_other` including versioning and discussion of pre and post conditions. +Other nonessential, but useful aspects of the oneMath architecture and design may also be found in the :ref:`onemath_appendix`. + + +.. include:: execution_model.inc.rst +.. include:: memory_model.inc.rst +.. include:: api_design.inc.rst +.. include:: exceptions.inc.rst +.. include:: other_architecture.inc.rst diff --git a/source/elements/oneMKL/source/architecture/exceptions.inc.rst b/source/elements/oneMath/source/architecture/exceptions.inc.rst similarity index 68% rename from source/elements/oneMKL/source/architecture/exceptions.inc.rst rename to source/elements/oneMath/source/architecture/exceptions.inc.rst index e896badd0..6675cb6bb 100644 --- a/source/elements/oneMKL/source/architecture/exceptions.inc.rst +++ b/source/elements/oneMath/source/architecture/exceptions.inc.rst @@ -2,24 +2,24 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_exceptions: +.. _onemath_exceptions: Exceptions and Error Handling ------------------------------ -oneMKL error handling relies on the mechanism of C++ exceptions. Should error occur, it will be propagated at the point of a function call where it is caught using standard C++ error handling mechanism. +oneMath error handling relies on the mechanism of C++ exceptions. Should error occur, it will be propagated at the point of a function call where it is caught using standard C++ error handling mechanism. -.. _onemkl_exception_classification: +.. _onemath_exception_classification: Exception classification ++++++++++++++++++++++++ -Exception classification in oneMKL is aligned with C++ Standard Library classification. oneMKL introduces class that defines the base class in the hierarchy of oneMKL exception classes. All oneMKL routines throw exceptions inherited from this base class. -In the hierarchy of oneMKL exceptions, ``oneapi::mkl::exception`` is the base class inherited from ``std::exception`` class. All other oneMKL exception classes are derived from this base class. +Exception classification in oneMath is aligned with C++ Standard Library classification. oneMath introduces class that defines the base class in the hierarchy of oneMath exception classes. All oneMath routines throw exceptions inherited from this base class. +In the hierarchy of oneMath exceptions, ``oneapi::mkl::exception`` is the base class inherited from ``std::exception`` class. All other oneMath exception classes are derived from this base class. This specification does not require implementations to perform error-checking. However, if an implementation does provide error-checking, it shall use the following exception classes. Additional implementation-specific exception classes can be used for exceptional conditions not fitting any of these classes. -.. _onemkl_common_exceptions: +.. _onemath_common_exceptions: Common exceptions ***************** @@ -28,36 +28,36 @@ Common exceptions :header: "Exception class", "Description" :widths: 40, 60 - ".. _onemkl_exception: + ".. _onemath_exception: ``oneapi::mkl::exception``", "Reports general unspecified problem" - ".. _onemkl_exception_unsupported_device: + ".. _onemath_exception_unsupported_device: ``oneapi::mkl::unsupported_device``", "Reports a problem when the routine is not supported on a specific device" - ".. _onemkl_exception_host_bad_alloc: + ".. _onemath_exception_host_bad_alloc: ``oneapi::mkl::host_bad_alloc``", "Reports a problem that occurred during memory allocation on the host" - ".. _onemkl_exception_device_bad_alloc: + ".. _onemath_exception_device_bad_alloc: ``oneapi::mkl::device_bad_alloc``", "Reports a problem that occurred during memory allocation on a specific device" - ".. _onemkl_exception_unimplemented: + ".. _onemath_exception_unimplemented: ``oneapi::mkl::unimplemented``", "Reports a problem when a specific routine has not been implemented for the specified parameters" - ".. _onemkl_exception_invalid_argument: + ".. _onemath_exception_invalid_argument: ``oneapi::mkl::invalid_argument``", "Reports problem when arguments to the routine were rejected" - ".. _onemkl_exception_uninitialized: + ".. _onemath_exception_uninitialized: ``oneapi::mkl::uninitialized``", "Reports problem when a handle (descriptor) has not been initialized" - ".. _onemkl_exception_computation_error: + ".. _onemath_exception_computation_error: - ``oneapi::mkl::computation_error``", "Reports any computation errors that have occurred inside a oneMKL routine" - ".. _onemkl_exception_batch_error: + ``oneapi::mkl::computation_error``", "Reports any computation errors that have occurred inside a oneMath routine" + ".. _onemath_exception_batch_error: - ``oneapi::mkl::batch_error``", "Reports errors that have occurred inside a batch oneMKL routine" + ``oneapi::mkl::batch_error``", "Reports errors that have occurred inside a batch oneMath routine" -.. _onemkl_lapack_specific_exceptions: +.. _onemath_lapack_specific_exceptions: LAPACK specific exceptions ************************** @@ -66,16 +66,16 @@ LAPACK specific exceptions :header: "Exception class", "Description" :widths: 40, 60 - ".. _onemkl_lapack_exception: + ".. _onemath_lapack_exception: ``oneapi::mkl::lapack::exception``", "Base class for all LAPACK exceptions providing access to info code familiar to users of conventional LAPACK API. All LAPACK related exceptions can be handled with catch block for this class." - ".. _onemkl_lapack_exception_invalid_argument: + ".. _onemath_lapack_exception_invalid_argument: ``oneapi::mkl::lapack::invalid_argument``", "Reports errors when arguments provided to the LAPACK subroutine are inconsistent or do not match expected values. Class extends base ``oneapi::mkl::invalid_argument`` with ability to access conventional status info code." - ".. _onemkl_lapack_exception_computation_error: + ".. _onemath_lapack_exception_computation_error: ``oneapi::mkl::lapack::computation_error``", "Reports computation errors that have occurred during call to LAPACK subroutine. Class extends base ``oneapi::mkl::computation_error`` with ability to access conventional status info code familiar to LAPACK users." - ".. _onemkl_lapack_exception_batch_error: + ".. _onemath_lapack_exception_batch_error: ``oneapi::mkl::lapack::batch_error``", "Reports errors that have occurred during batch LAPACK computations. Class extends base ``oneapi::mkl::batch_error`` with ability to access individual exception objects for each of the issues observed in a batch and an info code. The info code contains the number of errors that occurred in a batch. Positions of problems in a supplied batch that experienced issues during computations can be retrieved with `ids()` method, and list of particular exceptions can be obtained with `exceptions()` method of the exception object. Possible exceptions for a batch are documented for corresponding non-batch API." diff --git a/source/elements/oneMath/source/architecture/execution_model.inc.rst b/source/elements/oneMath/source/architecture/execution_model.inc.rst new file mode 100644 index 000000000..c08fddd8e --- /dev/null +++ b/source/elements/oneMath/source/architecture/execution_model.inc.rst @@ -0,0 +1,91 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_execution_model: + +Execution Model +--------------- + +This section describes the execution environment common to all oneMath functionality. The execution environment includes how data is provided to computational routines in :ref:`onemath_queues`, support for several devices in :ref:`onemath_device_usage`, synchronous and asynchronous execution models in :ref:`onemath_asynchronous_synchronous_execution` and :ref:`onemath_host_thread_safety`. + +.. _onemath_queues: + +Use of Queues ++++++++++++++ + +The ``sycl::queue`` defined in the oneAPI DPC++ specification is used to specify the device and features enabled on that device on which a task will be enqueued. There are two forms of computational routines in oneMath: class based :ref:`onemath_member_functions` and standalone :ref:`onemath_nonmember_functions`. As these may interact with the ``sycl::queue`` in different ways, we provide a section for each one to describe assumptions. + + +.. _onemath_nonmember_functions: + +Non-Member Functions +******************** + +Each oneMath non-member computational routine takes a ``sycl::queue`` reference as its first parameter:: + + mkl::domain::routine(sycl::queue &q, ...); + +All computation performed by the routine shall be done on the hardware device(s) associated with this queue, with possible aid from the host, unless otherwise specified. +In the case of an ordered queue, all computation shall also be ordered with respect to other kernels as if enqueued on that queue. + +A particular oneMath implementation may not support the execution of a given oneMath routine on the specified device(s). In this case, the implementation may either perform the computation on the host or throw an exception. See :ref:`onemath_exceptions` for the possible exceptions. + + +.. _onemath_member_functions: + +Member Functions +**************** + +oneMath class-based APIs, such as those in the RNG and DFT domains, require a ``sycl::queue`` as an argument to the constructor or another setup routine. +The execution requirements for computational routines from the previous section also apply to computational class methods. + +.. _onemath_device_usage: + +Device Usage +++++++++++++ + +oneMath itself does not currently provide any interfaces for controlling device usage: for instance, controlling the number of cores used on the CPU, or the number of execution units on a GPU. However, such functionality may be available by partitioning a ``sycl::device`` instance into subdevices, when supported by the device. + +When given a queue associated with such a subdevice, a oneMath implementation shall only perform computation on that subdevice. + +.. _onemath_asynchronous_synchronous_execution: + +Asynchronous Execution +++++++++++++++++++++++ +The oneMath API is designed to allow asynchronous execution of computational routines, to facilitate concurrent usage of multiple devices in the system. Each computational routine enqueues work to be performed on the selected device, and may (but is not required to) return before execution completes. + +Hence, it is the calling application's responsibility to ensure that any inputs are valid until computation is complete, and likewise to wait for computation completion before reading any outputs. This can be done automatically when using DPC++ buffers, or manually when using Unified Shared Memory (USM) pointers, as described in the sections below. + +Unless otherwise specified, asynchronous execution is *allowed*, but not *guaranteed*, by any oneMath computational routine, and may vary between implementations and/or versions. oneMath implementations must clearly document whether execution is guaranteed to be asynchronous for each supported routine. Regardless, calling applications shall not launch any oneMath computational routine with a dependency on a future oneMath API call, even if this computational routine executes asynchronously (i.e. a oneMath implementation may assume no antidependencies are present). This guarantee allows oneMath implementations to reserve resources for execution without risking deadlock. + +.. _onemath_synchronization_with_buffers: + +Synchronization When Using Buffers +*********************************** + +``sycl::buffer`` objects automatically manage synchronization between kernel launches linked by a data dependency (either read-after-write, write-after-write, or write-after-read). + +oneMath routines are not required to perform any additional synchronization of ``sycl::buffer`` arguments. + +.. _onemath_synchronization_with_usm: + +Synchronization When Using USM APIs +*********************************** + +When USM pointers are used as input to, or output from, a oneMath routine, it becomes the calling application's responsibility to manage possible asynchronicity. + +To help the calling application, all oneMath routines with at least one USM pointer argument also take an optional reference to a list of *input events*, of type ``std::vector``, and have a return value of type ``sycl::event`` representing computation completion:: + + sycl::event mkl::domain::routine(..., std::vector &in_events = {}); + +The routine shall ensure that all input events (if the list is present and non-empty) have occurred before any USM pointers are accessed. Likewise, the routine's output event shall not be complete until the routine has finished accessing all USM pointer arguments. + +For class methods, "argument" includes any USM pointers previously provided to the object via the class constructor or other class methods. + +.. _onemath_host_thread_safety: + +Host Thread Safety +++++++++++++++++++ + +All oneMath member and non-member functions shall be *host thread safe*. That is, they may be safely called simultaneously from concurrent host threads. However, oneMath objects in class-based APIs may not be shared between concurrent host threads unless otherwise specified. diff --git a/source/elements/oneMath/source/architecture/memory_model.inc.rst b/source/elements/oneMath/source/architecture/memory_model.inc.rst new file mode 100644 index 000000000..cba1ebde3 --- /dev/null +++ b/source/elements/oneMath/source/architecture/memory_model.inc.rst @@ -0,0 +1,34 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_memory_model: + +Memory Model +------------- + +The oneMath memory model shall follow directly from the oneAPI memory model. Mainly, oneMath shall support two modes of encapsulating data for consumption on the device: the buffer memory abstraction model and the pointer-based memory model using Unified Shared Memory (USM). These two paradigms shall also support both synchronous and asynchronous execution models as described in :ref:`onemath_asynchronous_synchronous_execution`. + + +.. _onemath_buffers: + +The Buffer Memory Model ++++++++++++++++++++++++ + +The SYCL 1.2.1 specification defines the buffer container templated on the provided data type which encapsulates the data in a SYCL application across both host and devices. It provides the concept of accessors as the mechanism to access the buffer data with different modes to read and or write into that data. These accessors allow SYCL to create and manage the data dependencies in the SYCL graph that order the kernel executions. With the buffer model, all data movement is handled by the SYCL runtime supporting both synchronous and asynchronous execution. + +oneMath provides APIs where buffers (in particular 1D buffers, ``sycl::buffer``) contain the memory for all non scalar input and output data arguments. See :ref:`onemath_synchronization_with_buffers` for details on how oneMath routines manage any data dependencies with buffer arguments. Any higher dimensional buffer must be converted to a 1D buffer prior to use in oneMath APIs, e.g., via ``buffer::reinterpret``. + + + +.. _onemath_usm: + +Unified Shared Memory Model ++++++++++++++++++++++++++++ + +While the buffer model is powerful and elegantly expresses data dependencies, it can be a burden for programmers to replace all pointers and arrays by buffers in their C++ applications. DPC++ also provides pointer-based addressing for device-accessible data, using the Unified Shared Memory (USM) model. Correspondingly, oneMath provides USM APIs in which non-scalar input and output data arguments are passed by USM pointer. + +USM devices and system configurations vary in their ability to share data between devices and between a device and the host. oneMath implementations may only assume that user-provided USM pointers are accessible by the device associated with the user-provided queue. In particular, an implementation must not assume that USM pointers can be accessed by any other device, or by the host, without querying the DPC++ runtime. An implementation must accept any device-accessible USM pointer regardless of how it was created (`sycl::malloc_device`, `sycl::malloc_shared`, etc.). + +Unlike buffers, USM pointers cannot automatically manage data dependencies between kernels. Users may use in-order queues to ensure ordered execution, or explicitly manage dependencies with ``sycl::event`` objects. To support the second use case, oneMath USM APIs accept input events (prerequisites before computation can begin) and return an output event (indicating computation is complete). See :ref:`onemath_synchronization_with_usm` for details. + diff --git a/source/elements/oneMKL/source/architecture/other_architecture.inc.rst b/source/elements/oneMath/source/architecture/other_architecture.inc.rst similarity index 76% rename from source/elements/oneMKL/source/architecture/other_architecture.inc.rst rename to source/elements/oneMath/source/architecture/other_architecture.inc.rst index 9c5473803..df2c21ba5 100644 --- a/source/elements/oneMKL/source/architecture/other_architecture.inc.rst +++ b/source/elements/oneMath/source/architecture/other_architecture.inc.rst @@ -2,19 +2,19 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_arch_other: +.. _onemath_arch_other: Other Features ---------------- -This section covers all other features in the design of oneMKL architecture. +This section covers all other features in the design of oneMath architecture. -.. _onemkl_spec_current_version: +.. _onemath_spec_current_version: Specification Version and Compliance +++++++++++++++++++++++++++++++++++++++++++++ -Each oneMKL domain must define a preprocessor macro to represent the version of the specification that the implementation is compliant with. +Each oneMath domain must define a preprocessor macro to represent the version of the specification that the implementation is compliant with. The macros for each domain are listed as follows: @@ -49,11 +49,11 @@ Macro Example Versioning details are defined here: https://github.com/uxlfoundation/oneAPI-spec/blob/main/doc/versioning.rst#provisional-versions -.. _onemkl_pre_post_conditions: +.. _onemath_pre_post_conditions: Pre/Post Condition Checking +++++++++++++++++++++++++++++++++++++++ -The individual oneMKL computational routines will define any preconditions and postconditions and will define in this specification any specific checks or verifications that should be enabled for all implementations. +The individual oneMath computational routines will define any preconditions and postconditions and will define in this specification any specific checks or verifications that should be enabled for all implementations. diff --git a/source/elements/oneMKL/source/conf.py b/source/elements/oneMath/source/conf.py similarity index 97% rename from source/elements/oneMKL/source/conf.py rename to source/elements/oneMath/source/conf.py index fcd29abe1..c316d6ae1 100644 --- a/source/elements/oneMKL/source/conf.py +++ b/source/elements/oneMath/source/conf.py @@ -21,7 +21,7 @@ from os.path import join -project = 'oneMKL' +project = 'oneMath' repo_root = join('..', '..', '..', '..') exec(open(join(repo_root, 'source', 'conf', 'common_conf.py')).read()) diff --git a/source/elements/oneMKL/source/domains/blas/asum.rst b/source/elements/oneMath/source/domains/blas/asum.rst similarity index 83% rename from source/elements/oneMKL/source/domains/blas/asum.rst rename to source/elements/oneMath/source/domains/blas/asum.rst index e18c4014e..62a73a418 100644 --- a/source/elements/oneMKL/source/domains/blas/asum.rst +++ b/source/elements/oneMath/source/domains/blas/asum.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_asum: +.. _onemath_blas_asum: asum ==== Computes the sum of magnitudes of the vector elements. -.. _onemkl_blas_asum_description: +.. _onemath_blas_asum_description: .. rubric:: Description @@ -39,7 +39,7 @@ where ``x`` is a vector with ``n`` elements. * - ``std::complex`` - ``double`` -.. _onemkl_blas_asum_buffer: +.. _onemath_blas_asum_buffer: asum (Buffer Version) --------------------- @@ -97,22 +97,22 @@ asum (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_asum_usm: +.. _onemath_blas_asum_usm: asum (USM Version) ------------------ @@ -184,20 +184,20 @@ asum (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/axpby.rst b/source/elements/oneMath/source/domains/blas/axpby.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/axpby.rst rename to source/elements/oneMath/source/domains/blas/axpby.rst index 8e499c173..15db2e6f9 100644 --- a/source/elements/oneMKL/source/domains/blas/axpby.rst +++ b/source/elements/oneMath/source/domains/blas/axpby.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_axpby: +.. _onemath_blas_axpby: axpby ===== Computes a vector-scalar product added to a scaled-vector. -.. _onemkl_blas_axpby_description: +.. _onemath_blas_axpby_description: .. rubric:: Description @@ -32,7 +32,7 @@ where ``x`` and ``y`` are vectors of ``n`` elements and ``alpha`` and ``beta`` a * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_axpby_buffer: +.. _onemath_blas_axpby_buffer: axpby (Buffer Version) ---------------------- @@ -105,17 +105,17 @@ axpby (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_axpby_usm: +.. _onemath_blas_axpby_usm: axpby (USM Version) ------------------- @@ -200,15 +200,15 @@ axpby (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/axpy.rst b/source/elements/oneMath/source/domains/blas/axpy.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/axpy.rst rename to source/elements/oneMath/source/domains/blas/axpy.rst index d44d7bb9f..8d9fd57f4 100644 --- a/source/elements/oneMKL/source/domains/blas/axpy.rst +++ b/source/elements/oneMath/source/domains/blas/axpy.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_axpy: +.. _onemath_blas_axpy: axpy ==== Computes a vector-scalar product and adds the result to a vector. -.. _onemkl_blas_axpy_description: +.. _onemath_blas_axpy_description: .. rubric:: Description @@ -39,7 +39,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_axpy_buffer: +.. _onemath_blas_axpy_buffer: axpy (Buffer Version) --------------------- @@ -111,22 +111,22 @@ axpy (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_axpy_usm: +.. _onemath_blas_axpy_usm: axpy (USM Version) ------------------ @@ -212,20 +212,20 @@ axpy (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/axpy_batch.rst b/source/elements/oneMath/source/domains/blas/axpy_batch.rst similarity index 91% rename from source/elements/oneMKL/source/domains/blas/axpy_batch.rst rename to source/elements/oneMath/source/domains/blas/axpy_batch.rst index cc3a8ff43..e9b6440f1 100644 --- a/source/elements/oneMKL/source/domains/blas/axpy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/axpy_batch.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_axpy_batch: +.. _onemath_blas_axpy_batch: axpy_batch ========== Computes a group of ``axpy`` operations. -.. _onemkl_blas_axpy_batch_description: +.. _onemath_blas_axpy_batch_description: .. rubric:: Description -The ``axpy_batch`` routines are batched versions of :ref:`onemkl_blas_axpy`, performing +The ``axpy_batch`` routines are batched versions of :ref:`onemath_blas_axpy`, performing multiple ``axpy`` operations in a single call. Each ``axpy`` operation adds a scalar-vector product to a vector. @@ -28,7 +28,7 @@ operation adds a scalar-vector product to a vector. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_axpy_batch_buffer: +.. _onemath_blas_axpy_batch_buffer: axpy_batch (Buffer Version) --------------------------- @@ -136,22 +136,22 @@ where: This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_axpy_batch_usm: +.. _onemath_blas_axpy_batch_usm: axpy_batch (USM Version) ------------------------ @@ -376,20 +376,20 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:**:ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/blas-level-1-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst similarity index 66% rename from source/elements/oneMKL/source/domains/blas/blas-level-1-routines.rst rename to source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst index 756ad0355..0721fbc82 100644 --- a/source/elements/oneMKL/source/domains/blas/blas-level-1-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst @@ -23,37 +23,37 @@ BLAS Level 1 Routines * - Routines - Description - * - :ref:`onemkl_blas_asum` + * - :ref:`onemath_blas_asum` - Sum of vector magnitudes - * - :ref:`onemkl_blas_axpy` + * - :ref:`onemath_blas_axpy` - Scalar-vector product - * - :ref:`onemkl_blas_copy` + * - :ref:`onemath_blas_copy` - Copy vector - * - :ref:`onemkl_blas_dot` + * - :ref:`onemath_blas_dot` - Dot product - * - :ref:`onemkl_blas_sdsdot` + * - :ref:`onemath_blas_sdsdot` - Dot product with double precision - * - :ref:`onemkl_blas_dotc` + * - :ref:`onemath_blas_dotc` - Dot product conjugated - * - :ref:`onemkl_blas_dotu` + * - :ref:`onemath_blas_dotu` - Dot product unconjugated - * - :ref:`onemkl_blas_nrm2` + * - :ref:`onemath_blas_nrm2` - Vector 2-norm (Euclidean norm) - * - :ref:`onemkl_blas_rot` + * - :ref:`onemath_blas_rot` - Plane rotation of points - * - :ref:`onemkl_blas_rotg` + * - :ref:`onemath_blas_rotg` - Generate Givens rotation of points - * - :ref:`onemkl_blas_rotm` + * - :ref:`onemath_blas_rotm` - Modified Givens plane rotation of points - * - :ref:`onemkl_blas_rotmg` + * - :ref:`onemath_blas_rotmg` - Generate modified Givens plane rotation of points - * - :ref:`onemkl_blas_scal` + * - :ref:`onemath_blas_scal` - Vector-scalar product - * - :ref:`onemkl_blas_swap` + * - :ref:`onemath_blas_swap` - Vector-vector swap - * - :ref:`onemkl_blas_iamax` + * - :ref:`onemath_blas_iamax` - Index of the maximum absolute value element of a vector - * - :ref:`onemkl_blas_iamin` + * - :ref:`onemath_blas_iamin` - Index of the minimum absolute value element of a vector .. toctree:: @@ -77,4 +77,4 @@ BLAS Level 1 Routines iamin -**Parent topic:** :ref:`onemkl_blas` +**Parent topic:** :ref:`onemath_blas` diff --git a/source/elements/oneMKL/source/domains/blas/blas-level-2-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst similarity index 68% rename from source/elements/oneMKL/source/domains/blas/blas-level-2-routines.rst rename to source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst index a1631bf7e..260a29022 100644 --- a/source/elements/oneMKL/source/domains/blas/blas-level-2-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst @@ -23,55 +23,55 @@ BLAS Level 2 Routines * - Routines - Description - * - :ref:`onemkl_blas_gbmv` + * - :ref:`onemath_blas_gbmv` - Matrix-vector product using a general band matrix - * - :ref:`onemkl_blas_gemv` + * - :ref:`onemath_blas_gemv` - Matrix-vector product using a general matrix - * - :ref:`onemkl_blas_ger` + * - :ref:`onemath_blas_ger` - Rank-1 update of a general matrix - * - :ref:`onemkl_blas_gerc` + * - :ref:`onemath_blas_gerc` - Rank-1 update of a conjugated general matrix - * - :ref:`onemkl_blas_geru` + * - :ref:`onemath_blas_geru` - Rank-1 update of a general matrix, unconjugated - * - :ref:`onemkl_blas_hbmv` + * - :ref:`onemath_blas_hbmv` - Matrix-vector product using a Hermitian band matrix - * - :ref:`onemkl_blas_hemv` + * - :ref:`onemath_blas_hemv` - Matrix-vector product using a Hermitian matrix - * - :ref:`onemkl_blas_her` + * - :ref:`onemath_blas_her` - Rank-1 update of a Hermitian matrix - * - :ref:`onemkl_blas_her2` + * - :ref:`onemath_blas_her2` - Rank-2 update of a Hermitian matrix - * - :ref:`onemkl_blas_hpmv` + * - :ref:`onemath_blas_hpmv` - Matrix-vector product using a Hermitian packed matrix - * - :ref:`onemkl_blas_hpr` + * - :ref:`onemath_blas_hpr` - Rank-1 update of a Hermitian packed matrix - * - :ref:`onemkl_blas_hpr2` + * - :ref:`onemath_blas_hpr2` - Rank-2 update of a Hermitian packed matrix - * - :ref:`onemkl_blas_sbmv` + * - :ref:`onemath_blas_sbmv` - Matrix-vector product using symmetric band matrix - * - :ref:`onemkl_blas_spmv` + * - :ref:`onemath_blas_spmv` - Matrix-vector product using a symmetric packed matrix - * - :ref:`onemkl_blas_spr` + * - :ref:`onemath_blas_spr` - Rank-1 update of a symmetric packed matrix - * - :ref:`onemkl_blas_spr2` + * - :ref:`onemath_blas_spr2` - Rank-2 update of a symmetric packed matrix - * - :ref:`onemkl_blas_symv` + * - :ref:`onemath_blas_symv` - Matrix-vector product using a symmetric matrix - * - :ref:`onemkl_blas_syr` + * - :ref:`onemath_blas_syr` - Rank-1 update of a symmetric matrix - * - :ref:`onemkl_blas_syr2` + * - :ref:`onemath_blas_syr2` - Rank-2 update of a symmetric matrix - * - :ref:`onemkl_blas_tbmv` + * - :ref:`onemath_blas_tbmv` - Matrix-vector product using a triangular band matrix - * - :ref:`onemkl_blas_tbsv` + * - :ref:`onemath_blas_tbsv` - Solution of a linear system of equations with a triangular band matrix - * - :ref:`onemkl_blas_tpmv` + * - :ref:`onemath_blas_tpmv` - Matrix-vector product using a triangular packed matrix - * - :ref:`onemkl_blas_tpsv` + * - :ref:`onemath_blas_tpsv` - Solution of a linear system of equations with a triangular packed matrix - * - :ref:`onemkl_blas_trmv` + * - :ref:`onemath_blas_trmv` - Matrix-vector product using a triangular matrix - * - :ref:`onemkl_blas_trsv` + * - :ref:`onemath_blas_trsv` - Solution of a linear system of equations with a triangular matrix @@ -106,4 +106,4 @@ BLAS Level 2 Routines trmv trsv -**Parent topic:** :ref:`onemkl_blas` +**Parent topic:** :ref:`onemath_blas` diff --git a/source/elements/oneMKL/source/domains/blas/blas-level-3-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst similarity index 74% rename from source/elements/oneMKL/source/domains/blas/blas-level-3-routines.rst rename to source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst index 85e372094..160eb0d24 100644 --- a/source/elements/oneMKL/source/domains/blas/blas-level-3-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst @@ -22,23 +22,23 @@ BLAS Level 3 Routines * - Routines - Description - * - :ref:`onemkl_blas_gemm` + * - :ref:`onemath_blas_gemm` - Computes a matrix-matrix product with general matrices. - * - :ref:`onemkl_blas_hemm` + * - :ref:`onemath_blas_hemm` - Computes a matrix-matrix product where one input matrix is Hermitian and one is general. - * - :ref:`onemkl_blas_herk` + * - :ref:`onemath_blas_herk` - Performs a Hermitian rank-k update. - * - :ref:`onemkl_blas_her2k` + * - :ref:`onemath_blas_her2k` - Performs a Hermitian rank-2k update. - * - :ref:`onemkl_blas_symm` + * - :ref:`onemath_blas_symm` - Computes a matrix-matrix product where one input matrix is symmetric and one matrix is general. - * - :ref:`onemkl_blas_syrk` + * - :ref:`onemath_blas_syrk` - Performs a symmetric rank-k update. - * - :ref:`onemkl_blas_syr2k` + * - :ref:`onemath_blas_syr2k` - Performs a symmetric rank-2k update. - * - :ref:`onemkl_blas_trmm` + * - :ref:`onemath_blas_trmm` - Computes a matrix-matrix product where one input matrix is triangular and one input matrix is general. - * - :ref:`onemkl_blas_trsm` + * - :ref:`onemath_blas_trsm` - Solves a triangular matrix equation (forward or backward solve). @@ -56,4 +56,4 @@ BLAS Level 3 Routines trmm trsm -**Parent topic:** :ref:`onemkl_blas` +**Parent topic:** :ref:`onemath_blas` diff --git a/source/elements/oneMKL/source/domains/blas/blas-like-extensions.rst b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst similarity index 75% rename from source/elements/oneMKL/source/domains/blas/blas-like-extensions.rst rename to source/elements/oneMath/source/domains/blas/blas-like-extensions.rst index cabc5441b..4b9750501 100644 --- a/source/elements/oneMKL/source/domains/blas/blas-like-extensions.rst +++ b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst @@ -26,30 +26,30 @@ BLAS-like Extensions * - Routines - Description - * - :ref:`onemkl_blas_axpy_batch` + * - :ref:`onemath_blas_axpy_batch` - Computes groups of vector-scalar products added to a vector. - * - :ref:`onemkl_blas_gemm_batch` + * - :ref:`onemath_blas_gemm_batch` - Computes groups of matrix-matrix products with general matrices. - * - :ref:`onemkl_blas_trsm_batch` + * - :ref:`onemath_blas_trsm_batch` - Solves a triangular matrix equation for a group of matrices. - * - :ref:`onemkl_blas_gemmt` + * - :ref:`onemath_blas_gemmt` - Computes a matrix-matrix product with general matrices, but updates only the upper or lower triangular part of the result matrix. - * - :ref:`onemkl_blas_gemm_bias` + * - :ref:`onemath_blas_gemm_bias` - Computes a matrix-matrix product using general integer matrices with bias - * - :ref:`onemkl_blas_imatcopy` + * - :ref:`onemath_blas_imatcopy` - Computes an in-place matrix transposition or copy. - * - :ref:`onemkl_blas_omatcopy` + * - :ref:`onemath_blas_omatcopy` - Computes an out-of-place matrix transposition or copy. - * - :ref:`onemkl_blas_omatcopy2` + * - :ref:`onemath_blas_omatcopy2` - Computes a two-strided out-of-place matrix transposition or copy. - * - :ref:`onemkl_blas_omatadd` + * - :ref:`onemath_blas_omatadd` - Computes scaled matrix addition with possibly transposed arguments. - * - :ref:`onemkl_blas_imatcopy_batch` + * - :ref:`onemath_blas_imatcopy_batch` - Computes groups of in-place matrix transposition or copy operations. - * - :ref:`onemkl_blas_omatcopy_batch` + * - :ref:`onemath_blas_omatcopy_batch` - Computes groups of out-of-place matrix transposition or copy operations. - * - :ref:`onemkl_blas_omatadd_batch` + * - :ref:`onemath_blas_omatadd_batch` - Computes groups of scaled matrix additions. @@ -77,4 +77,4 @@ BLAS-like Extensions omatcopy_batch omatadd_batch -**Parent topic:** :ref:`onemkl_blas` +**Parent topic:** :ref:`onemath_blas` diff --git a/source/elements/oneMKL/source/domains/blas/blas.rst b/source/elements/oneMath/source/domains/blas/blas.rst similarity index 54% rename from source/elements/oneMKL/source/domains/blas/blas.rst rename to source/elements/oneMath/source/domains/blas/blas.rst index 429b014d9..8b621d2f2 100644 --- a/source/elements/oneMKL/source/domains/blas/blas.rst +++ b/source/elements/oneMath/source/domains/blas/blas.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas: +.. _onemath_blas: BLAS Routines +++++++++++++ -oneMKL provides DPC++ interfaces to the Basic Linear Algebra Subprograms (BLAS) routines (Level1, Level2, Level3), as well as several BLAS-like extension routines. +oneMath provides DPC++ interfaces to the Basic Linear Algebra Subprograms (BLAS) routines (Level1, Level2, Level3), as well as several BLAS-like extension routines. .. toctree:: :maxdepth: 1 @@ -18,4 +18,4 @@ oneMKL provides DPC++ interfaces to the Basic Linear Algebra Subprograms (BLAS) blas-like-extensions.rst -**Parent topic:** :ref:`onemkl_dense_linear_algebra` +**Parent topic:** :ref:`onemath_dense_linear_algebra` diff --git a/source/elements/oneMKL/source/domains/blas/copy.rst b/source/elements/oneMath/source/domains/blas/copy.rst similarity index 82% rename from source/elements/oneMKL/source/domains/blas/copy.rst rename to source/elements/oneMath/source/domains/blas/copy.rst index 080358e1b..634e113f6 100644 --- a/source/elements/oneMKL/source/domains/blas/copy.rst +++ b/source/elements/oneMath/source/domains/blas/copy.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_copy: +.. _onemath_blas_copy: copy ==== Copies a vector to another vector. -.. _onemkl_blas_copy_description: +.. _onemath_blas_copy_description: .. rubric:: Description @@ -33,7 +33,7 @@ where ``x`` and ``y`` are vectors of n elements. * - ``std::complex`` -.. _onemkl_blas_copy_buffer: +.. _onemath_blas_copy_buffer: copy (Buffer Version) --------------------- @@ -95,22 +95,22 @@ copy (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_copy_usm: +.. _onemath_blas_copy_usm: copy (USM Version) ------------------ @@ -185,20 +185,20 @@ copy (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/copy_batch.rst b/source/elements/oneMath/source/domains/blas/copy_batch.rst similarity index 90% rename from source/elements/oneMKL/source/domains/blas/copy_batch.rst rename to source/elements/oneMath/source/domains/blas/copy_batch.rst index 8c845e27c..9b44e940c 100644 --- a/source/elements/oneMKL/source/domains/blas/copy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/copy_batch.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_copy_batch: +.. _onemath_blas_copy_batch: copy_batch ========== Computes a group of ``copy`` operations. -.. _onemkl_blas_copy_batch_description: +.. _onemath_blas_copy_batch_description: .. rubric:: Description -The ``copy_batch`` routines are batched versions of :ref:`onemkl_blas_copy`, performing +The ``copy_batch`` routines are batched versions of :ref:`onemath_blas_copy`, performing multiple ``copy`` operations in a single call. Each ``copy`` operation copies one vector to another. @@ -28,7 +28,7 @@ operation copies one vector to another. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_copy_batch_buffer: +.. _onemath_blas_copy_batch_buffer: copy_batch (Buffer Version) --------------------------- @@ -128,22 +128,22 @@ where: This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_copy_batch_usm: +.. _onemath_blas_copy_batch_usm: copy_batch (USM Version) ------------------------ @@ -354,20 +354,20 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:**:ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/dgmm_batch.rst b/source/elements/oneMath/source/domains/blas/dgmm_batch.rst similarity index 93% rename from source/elements/oneMKL/source/domains/blas/dgmm_batch.rst rename to source/elements/oneMath/source/domains/blas/dgmm_batch.rst index fecd54260..e8572fc42 100644 --- a/source/elements/oneMKL/source/domains/blas/dgmm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/dgmm_batch.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_dgmm_batch: +.. _onemath_blas_dgmm_batch: dgmm_batch ========== Computes a group of ``dgmm`` operations. -.. _onemkl_blas_dgmm_batch_description: +.. _onemath_blas_dgmm_batch_description: .. rubric:: Description @@ -27,7 +27,7 @@ multiple diagonal matrix-matrix product operations in a single call. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_dgmm_batch_buffer: +.. _onemath_blas_dgmm_batch_buffer: dgmm_batch (Buffer Version) --------------------------- @@ -105,7 +105,7 @@ of matrices in ``a`` and ``x`` buffers is given by the ``batch_size`` parameter. left_right Specifies the position of the diagonal matrix in the product. - See :ref:`onemkl_datatypes` for more details. + See :ref:`onemath_datatypes` for more details. m Number of rows of matrices ``A`` and ``C``. Must be at least zero. @@ -171,22 +171,22 @@ of matrices in ``a`` and ``x`` buffers is given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_dgmm_batch_usm: +.. _onemath_blas_dgmm_batch_usm: dgmm_batch (USM Version) --------------------------- @@ -288,7 +288,7 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. left_right Specifies the position of the diagonal matrix in the product. - See :ref:`onemkl_datatypes` for more details. + See :ref:`onemath_datatypes` for more details. m Array of ``group_count`` integers. ``m[i]`` specifies the @@ -416,7 +416,7 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. left_right Specifies the position of the diagonal matrix in the product. - See :ref:`onemkl_datatypes` for more details. + See :ref:`onemath_datatypes` for more details. m Number of rows of ``A``. Must be at least zero. @@ -488,20 +488,20 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/dot.rst b/source/elements/oneMath/source/domains/blas/dot.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/dot.rst rename to source/elements/oneMath/source/domains/blas/dot.rst index 15b536979..ad528d808 100644 --- a/source/elements/oneMKL/source/domains/blas/dot.rst +++ b/source/elements/oneMath/source/domains/blas/dot.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_dot: +.. _onemath_blas_dot: dot === Computes the dot product of two real vectors. -.. _onemkl_blas_dot_description: +.. _onemath_blas_dot_description: .. rubric:: Description @@ -45,7 +45,7 @@ The ``dot`` routines perform a dot product between two vectors: For the mixed precision version (inputs are float while result is double), the dot product is computed with double precision. -.. _onemkl_blas_dot_buffer: +.. _onemath_blas_dot_buffer: dot (Buffer Version) -------------------- @@ -114,22 +114,22 @@ dot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_dot_usm: +.. _onemath_blas_dot_usm: dot (USM Version) ----------------- @@ -212,20 +212,20 @@ dot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/dotc.rst b/source/elements/oneMath/source/domains/blas/dotc.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/dotc.rst rename to source/elements/oneMath/source/domains/blas/dotc.rst index c782e4122..4694e4ab4 100644 --- a/source/elements/oneMKL/source/domains/blas/dotc.rst +++ b/source/elements/oneMath/source/domains/blas/dotc.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_dotc: +.. _onemath_blas_dotc: dotc ==== Computes the dot product of two complex vectors, conjugating the first vector. -.. _onemkl_blas_dotc_description: +.. _onemath_blas_dotc_description: .. rubric:: Description @@ -29,7 +29,7 @@ vectors, conjugating the first of them: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_dotc_buffer: +.. _onemath_blas_dotc_buffer: dotc (Buffer Version) --------------------- @@ -98,22 +98,22 @@ dotc (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_dotc_usm: +.. _onemath_blas_dotc_usm: dotc (USM Version) ------------------ @@ -196,20 +196,20 @@ dotc (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/dotu.rst b/source/elements/oneMath/source/domains/blas/dotu.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/dotu.rst rename to source/elements/oneMath/source/domains/blas/dotu.rst index 551ad2fb5..3b860011d 100644 --- a/source/elements/oneMKL/source/domains/blas/dotu.rst +++ b/source/elements/oneMath/source/domains/blas/dotu.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_dotu: +.. _onemath_blas_dotu: dotu ==== Computes the dot product of two complex vectors. -.. _onemkl_blas_dotu_description: +.. _onemath_blas_dotu_description: .. rubric:: Description @@ -28,7 +28,7 @@ The ``dotu`` routines perform a dot product between two complex vectors: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_dotu_buffer: +.. _onemath_blas_dotu_buffer: dotu (Buffer Version) --------------------- @@ -98,22 +98,22 @@ dotu (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_dotu_usm: +.. _onemath_blas_dotu_usm: dotu (USM Version) ------------------ @@ -196,20 +196,20 @@ dotu (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/gbmv.rst b/source/elements/oneMath/source/domains/blas/gbmv.rst similarity index 89% rename from source/elements/oneMKL/source/domains/blas/gbmv.rst rename to source/elements/oneMath/source/domains/blas/gbmv.rst index fd90069ba..6852602ab 100644 --- a/source/elements/oneMKL/source/domains/blas/gbmv.rst +++ b/source/elements/oneMath/source/domains/blas/gbmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gbmv: +.. _onemath_blas_gbmv: gbmv ==== Computes a matrix-vector product with a general band matrix. -.. _onemkl_blas_gbmv_description: +.. _onemath_blas_gbmv_description: .. rubric:: Description @@ -44,7 +44,7 @@ op(``A``) is one of op(``A``) = ``A``, or op(``A``) = * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_gbmv_buffer: +.. _onemath_blas_gbmv_buffer: gbmv (Buffer Version) --------------------- @@ -98,7 +98,7 @@ gbmv (Buffer Version) trans Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for more + :ref:`onemath_datatypes` for more details. m @@ -164,22 +164,22 @@ gbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gbmv_usm: +.. _onemath_blas_gbmv_usm: gbmv (USM Version) ------------------ @@ -235,7 +235,7 @@ gbmv (USM Version) trans Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. m @@ -312,20 +312,20 @@ gbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/gemm.rst b/source/elements/oneMath/source/domains/blas/gemm.rst similarity index 94% rename from source/elements/oneMKL/source/domains/blas/gemm.rst rename to source/elements/oneMath/source/domains/blas/gemm.rst index b9d1956e4..e2b9cd616 100644 --- a/source/elements/oneMKL/source/domains/blas/gemm.rst +++ b/source/elements/oneMath/source/domains/blas/gemm.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemm: +.. _onemath_blas_gemm: gemm ==== Computes a matrix-matrix product with general matrices. -.. _onemkl_blas_gemm_description: +.. _onemath_blas_gemm_description: .. rubric:: Description @@ -90,7 +90,7 @@ op(``X``) = ``X``\ :sup:`H`, - ``std::complex`` - ``std::complex`` -.. _onemkl_blas_gemm_buffer: +.. _onemath_blas_gemm_buffer: gemm (Buffer Version) --------------------- @@ -277,22 +277,22 @@ gemm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemm_usm: +.. _onemath_blas_gemm_usm: gemm (USM Version) ------------------ @@ -497,19 +497,19 @@ gemm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/gemm_batch.rst b/source/elements/oneMath/source/domains/blas/gemm_batch.rst similarity index 94% rename from source/elements/oneMKL/source/domains/blas/gemm_batch.rst rename to source/elements/oneMath/source/domains/blas/gemm_batch.rst index 0dfb4fff2..39dbce91f 100644 --- a/source/elements/oneMKL/source/domains/blas/gemm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/gemm_batch.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemm_batch: +.. _onemath_blas_gemm_batch: gemm_batch ========== Computes a group of ``gemm`` operations. -.. _onemkl_blas_gemm_batch_description: +.. _onemath_blas_gemm_batch_description: .. rubric:: Description -The ``gemm_batch`` routines are batched versions of :ref:`onemkl_blas_gemm`, performing +The ``gemm_batch`` routines are batched versions of :ref:`onemath_blas_gemm`, performing multiple ``gemm`` operations in a single call. Each ``gemm`` operation perform a matrix-matrix product with general matrices. @@ -71,7 +71,7 @@ operation perform a matrix-matrix product with general matrices. - ``std::complex`` - ``std::complex`` -.. _onemkl_blas_gemm_batch_buffer: +.. _onemath_blas_gemm_batch_buffer: gemm_batch (Buffer Version) --------------------------- @@ -161,11 +161,11 @@ of matrices in ``a``, ``b`` and ``c`` buffers is given by the ``batch_size`` par transa Specifies op(``A``) the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``) the transposition operation applied to the - matrices ``B``. See :ref:`onemkl_datatypes` for more details. + matrices ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows of op(``A``) and ``C``. Must be at least zero. @@ -265,22 +265,22 @@ of matrices in ``a``, ``b`` and ``c`` buffers is given by the ``batch_size`` par This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemm_batch_usm: +.. _onemath_blas_gemm_batch_usm: gemm_batch (USM Version) --------------------------- @@ -442,11 +442,11 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. transa Array or span of ``group_count`` ``oneapi::mkl::transpose`` values. ``transa[i]`` specifies the form of op(``A``) used in - the matrix multiplication in group ``i``. See :ref:`onemkl_datatypes` for more details. + the matrix multiplication in group ``i``. See :ref:`onemath_datatypes` for more details. transb Array or span of ``group_count`` ``oneapi::mkl::transpose`` values. ``transb[i]`` specifies the form of op(``B``) used in - the matrix multiplication in group ``i``. See :ref:`onemkl_datatypes` for more details. + the matrix multiplication in group ``i``. See :ref:`onemath_datatypes` for more details. m Array or span of ``group_count`` integers. ``m[i]`` specifies the @@ -640,11 +640,11 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. transa Specifies op(``A``) the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``) the transposition operation applied to the - matrices ``B``. See :ref:`onemkl_datatypes` for more details. + matrices ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows of op(``A``) and ``C``. Must be at least zero. @@ -751,20 +751,20 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/gemm_bias.rst b/source/elements/oneMath/source/domains/blas/gemm_bias.rst similarity index 93% rename from source/elements/oneMKL/source/domains/blas/gemm_bias.rst rename to source/elements/oneMath/source/domains/blas/gemm_bias.rst index 0ca1a841d..4007fe561 100644 --- a/source/elements/oneMKL/source/domains/blas/gemm_bias.rst +++ b/source/elements/oneMath/source/domains/blas/gemm_bias.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemm_bias: +.. _onemath_blas_gemm_bias: gemm_bias ========= Computes a matrix-matrix product using general integer matrices with bias. -.. _onemkl_blas_gemm_bias_description: +.. _onemath_blas_gemm_bias_description: .. rubric:: Description @@ -56,7 +56,7 @@ op(``A``) is ``m`` x ``k``, op(``B``) is ``k`` x ``n``, and * - ``std::int8_t`` - ``std::int8_t`` -.. _onemkl_blas_gemm_bias_buffer: +.. _onemath_blas_gemm_bias_buffer: gemm_bias (Buffer Version) -------------------------- @@ -118,19 +118,19 @@ gemm_bias (Buffer Version) transa Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to ``B``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. offset_type Specifies the form of ``C_offset`` used in the matrix multiplication. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. m @@ -279,22 +279,22 @@ gemm_bias (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemm_bias_usm: +.. _onemath_blas_gemm_bias_usm: gemm_bias (USM Version) ----------------------- @@ -358,19 +358,19 @@ gemm_bias (USM Version) transa Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to ``B``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. offset_type Specifies the form of ``C_offset`` used in the matrix multiplication. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. m @@ -529,20 +529,20 @@ gemm_bias (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/gemmt.rst b/source/elements/oneMath/source/domains/blas/gemmt.rst similarity index 91% rename from source/elements/oneMKL/source/domains/blas/gemmt.rst rename to source/elements/oneMath/source/domains/blas/gemmt.rst index 76e7ef61a..cfa6aec27 100644 --- a/source/elements/oneMKL/source/domains/blas/gemmt.rst +++ b/source/elements/oneMath/source/domains/blas/gemmt.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemmt: +.. _onemath_blas_gemmt: gemmt ===== @@ -10,7 +10,7 @@ gemmt Computes a matrix-matrix product with general matrices, but updates only the upper or lower triangular part of the result matrix. -.. _onemkl_blas_gemmt_description: +.. _onemath_blas_gemmt_description: .. rubric:: Description @@ -45,7 +45,7 @@ op(``A``) is ``n`` x ``k``, op(``B``) is ``k`` x ``n``, and * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_gemmt_buffer: +.. _onemath_blas_gemmt_buffer: gemmt (Buffer Version) ---------------------- @@ -98,15 +98,15 @@ gemmt (Buffer Version) upper_lower Specifies whether ``C``\ ’s data is stored in its upper or - lower triangle. See :ref:`onemkl_datatypes` for more details. + lower triangle. See :ref:`onemath_datatypes` for more details. transa Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to - ``B``. See :ref:`onemkl_datatypes` for more details. + ``B``. See :ref:`onemath_datatypes` for more details. n Number of rows of op(``A``), columns of op(``B``), and @@ -228,22 +228,22 @@ gemmt (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemmt_usm: +.. _onemath_blas_gemmt_usm: gemmt (USM Version) ------------------- @@ -299,19 +299,19 @@ gemmt (USM Version) upper_lower Specifies whether ``C``\ ’s data is stored in its upper or lower triangle. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. transa Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to ``B``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. n @@ -444,20 +444,20 @@ gemmt (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/gemv.rst b/source/elements/oneMath/source/domains/blas/gemv.rst similarity index 89% rename from source/elements/oneMKL/source/domains/blas/gemv.rst rename to source/elements/oneMath/source/domains/blas/gemv.rst index aa95b5d2e..354841163 100644 --- a/source/elements/oneMKL/source/domains/blas/gemv.rst +++ b/source/elements/oneMath/source/domains/blas/gemv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemv: +.. _onemath_blas_gemv: gemv ==== Computes a matrix-vector product using a general matrix. -.. _onemkl_blas_gemv_description: +.. _onemath_blas_gemv_description: .. rubric:: Description @@ -41,7 +41,7 @@ op(``A``) is one of op(``A``) = ``A``, or op(``A``) = * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_gemv_buffer: +.. _onemath_blas_gemv_buffer: gemv (Buffer Version) --------------------- @@ -148,22 +148,22 @@ gemv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemv_usm: +.. _onemath_blas_gemv_usm: gemv (USM Version) ------------------ @@ -215,7 +215,7 @@ gemv (USM Version) trans Specifies ``op(A)``, the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for + :ref:`onemath_datatypes` for more details. m @@ -287,20 +287,20 @@ gemv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/gemv_batch.rst b/source/elements/oneMath/source/domains/blas/gemv_batch.rst similarity index 92% rename from source/elements/oneMKL/source/domains/blas/gemv_batch.rst rename to source/elements/oneMath/source/domains/blas/gemv_batch.rst index 1db7c8ff9..ec0c0fae4 100644 --- a/source/elements/oneMKL/source/domains/blas/gemv_batch.rst +++ b/source/elements/oneMath/source/domains/blas/gemv_batch.rst @@ -2,19 +2,19 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gemv_batch: +.. _onemath_blas_gemv_batch: gemv_batch ========== Computes a group of ``gemv`` operations. -.. _onemkl_blas_gemv_batch_description: +.. _onemath_blas_gemv_batch_description: .. rubric:: Description The ``gemv_batch`` routines are batched versions of -:ref:`onemkl_blas_gemv`, performing multiple ``gemv`` operations in a +:ref:`onemath_blas_gemv`, performing multiple ``gemv`` operations in a single call. Each ``gemv`` operations perform a scalar-matrix-vector product and add the result to a scalar-vector product. @@ -29,7 +29,7 @@ product and add the result to a scalar-vector product. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_gemv_batch_buffer: +.. _onemath_blas_gemv_batch_buffer: gemv_batch (Buffer Version) --------------------------- @@ -114,7 +114,7 @@ parameter. trans Specifies op(``A``) the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows of ``A``. Must be at least zero. @@ -174,22 +174,22 @@ parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gemv_batch_usm: +.. _onemath_blas_gemv_batch_usm: gemv_batch (USM Version) --------------------------- @@ -293,7 +293,7 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th trans Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in - the matrix-vector product in group ``i``. See :ref:`onemkl_datatypes` for more details. + the matrix-vector product in group ``i``. See :ref:`onemath_datatypes` for more details. m Array of ``group_count`` integers. ``m[i]`` specifies the @@ -426,7 +426,7 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th trans Specifies op(``A``) the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows of ``A``. Must be at least zero. @@ -492,20 +492,20 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/ger.rst b/source/elements/oneMath/source/domains/blas/ger.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/ger.rst rename to source/elements/oneMath/source/domains/blas/ger.rst index 5179367eb..c2f143739 100644 --- a/source/elements/oneMKL/source/domains/blas/ger.rst +++ b/source/elements/oneMath/source/domains/blas/ger.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_ger: +.. _onemath_blas_ger: ger === Computes a rank-1 update of a general matrix. -.. _onemkl_blas_ger_description: +.. _onemath_blas_ger_description: .. rubric:: Description @@ -39,7 +39,7 @@ where: * - ``float`` * - ``double`` -.. _onemkl_blas_ger_buffer: +.. _onemath_blas_ger_buffer: ger (Buffer Version) -------------------- @@ -131,22 +131,22 @@ ger (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_ger_usm: +.. _onemath_blas_ger_usm: ger (USM Version) ----------------- @@ -251,20 +251,20 @@ ger (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/gerc.rst b/source/elements/oneMath/source/domains/blas/gerc.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/gerc.rst rename to source/elements/oneMath/source/domains/blas/gerc.rst index da2651358..66cb03cf8 100644 --- a/source/elements/oneMKL/source/domains/blas/gerc.rst +++ b/source/elements/oneMath/source/domains/blas/gerc.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_gerc: +.. _onemath_blas_gerc: gerc ==== Computes a rank-1 update (conjugated) of a general complex matrix. -.. _onemkl_blas_gerc_description: +.. _onemath_blas_gerc_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_gerc_buffer: +.. _onemath_blas_gerc_buffer: gerc (Buffer Version) --------------------- @@ -133,22 +133,22 @@ gerc (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_gerc_usm: +.. _onemath_blas_gerc_usm: gerc (USM Version) ------------------ @@ -254,20 +254,20 @@ gerc (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/geru.rst b/source/elements/oneMath/source/domains/blas/geru.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/geru.rst rename to source/elements/oneMath/source/domains/blas/geru.rst index b9952a75d..274c8870c 100644 --- a/source/elements/oneMKL/source/domains/blas/geru.rst +++ b/source/elements/oneMath/source/domains/blas/geru.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_geru: +.. _onemath_blas_geru: geru ==== Computes a rank-1 update (unconjugated) of a general complex matrix. -.. _onemkl_blas_geru_description: +.. _onemath_blas_geru_description: .. rubric:: Description @@ -39,7 +39,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_geru_buffer: +.. _onemath_blas_geru_buffer: geru (Buffer Version) --------------------- @@ -131,22 +131,22 @@ geru (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_geru_usm: +.. _onemath_blas_geru_usm: geru (USM Version) ------------------ @@ -252,20 +252,20 @@ geru (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hbmv.rst b/source/elements/oneMath/source/domains/blas/hbmv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/hbmv.rst rename to source/elements/oneMath/source/domains/blas/hbmv.rst index 7e3958d20..17c16a605 100644 --- a/source/elements/oneMKL/source/domains/blas/hbmv.rst +++ b/source/elements/oneMath/source/domains/blas/hbmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hbmv: +.. _onemath_blas_hbmv: hbmv ==== Computes a matrix-vector product using a Hermitian band matrix. -.. _onemkl_blas_hbmv_description: +.. _onemath_blas_hbmv_description: .. rubric:: Description @@ -39,7 +39,7 @@ super-diagonals, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_hbmv_buffer: +.. _onemath_blas_hbmv_buffer: hbmv (Buffer Version) --------------------- @@ -87,7 +87,7 @@ hbmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -140,22 +140,22 @@ hbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hbmv_usm: +.. _onemath_blas_hbmv_usm: hbmv (USM Version) ------------------ @@ -205,7 +205,7 @@ hbmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -271,20 +271,20 @@ hbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hemm.rst b/source/elements/oneMath/source/domains/blas/hemm.rst similarity index 89% rename from source/elements/oneMKL/source/domains/blas/hemm.rst rename to source/elements/oneMath/source/domains/blas/hemm.rst index defb56a4a..280b59ca5 100644 --- a/source/elements/oneMKL/source/domains/blas/hemm.rst +++ b/source/elements/oneMath/source/domains/blas/hemm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hemm: +.. _onemath_blas_hemm: hemm ==== @@ -10,7 +10,7 @@ hemm Computes a matrix-matrix product where one input matrix is Hermitian and one is general. -.. _onemkl_blas_hemm_description: +.. _onemath_blas_hemm_description: .. rubric:: Description @@ -50,7 +50,7 @@ matrices, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_hemm_buffer: +.. _onemath_blas_hemm_buffer: hemm (Buffer Version) --------------------- @@ -101,11 +101,11 @@ hemm (Buffer Version) left_right Specifies whether ``A`` is on the left side of the multiplication - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. uplo Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of the matrix ``B`` and ``C``. @@ -180,22 +180,22 @@ hemm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hemm_usm: +.. _onemath_blas_hemm_usm: hemm (USM Version) ------------------ @@ -249,11 +249,11 @@ hemm (USM Version) left_right Specifies whether ``A`` is on the left side of the multiplication (``side::left``) or on the right side - (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::right``). See :ref:`onemath_datatypes` for more details. uplo Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of the matrix ``B`` and ``C``. @@ -340,20 +340,20 @@ hemm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hemv.rst b/source/elements/oneMath/source/domains/blas/hemv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/hemv.rst rename to source/elements/oneMath/source/domains/blas/hemv.rst index 87cd997e0..c324466e2 100644 --- a/source/elements/oneMKL/source/domains/blas/hemv.rst +++ b/source/elements/oneMath/source/domains/blas/hemv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hemv: +.. _onemath_blas_hemv: hemv ==== Computes a matrix-vector product using a Hermitian matrix. -.. _onemkl_blas_hemv_description: +.. _onemath_blas_hemv_description: .. rubric:: Description @@ -38,7 +38,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_hemv_buffer: +.. _onemath_blas_hemv_buffer: hemv (Buffer Version) --------------------- @@ -84,7 +84,7 @@ hemv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether *A* is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether *A* is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -133,22 +133,22 @@ hemv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hemv_usm: +.. _onemath_blas_hemv_usm: hemv (USM Version) ------------------ @@ -196,7 +196,7 @@ hemv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether *A* is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether *A* is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -257,20 +257,20 @@ hemv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/her.rst b/source/elements/oneMath/source/domains/blas/her.rst similarity index 86% rename from source/elements/oneMKL/source/domains/blas/her.rst rename to source/elements/oneMath/source/domains/blas/her.rst index 101109bc1..d6010cfef 100644 --- a/source/elements/oneMKL/source/domains/blas/her.rst +++ b/source/elements/oneMath/source/domains/blas/her.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_her: +.. _onemath_blas_her: her === Computes a rank-1 update of a Hermitian matrix. -.. _onemkl_blas_her_description: +.. _onemath_blas_her_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` - ``double`` -.. _onemkl_blas_her_buffer: +.. _onemath_blas_her_buffer: her (Buffer Version) -------------------- @@ -80,7 +80,7 @@ her (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -123,22 +123,22 @@ her (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_her_usm: +.. _onemath_blas_her_usm: her (USM Version) ----------------- @@ -180,7 +180,7 @@ her (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether *A* is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether *A* is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -234,20 +234,20 @@ her (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/her2.rst b/source/elements/oneMath/source/domains/blas/her2.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/her2.rst rename to source/elements/oneMath/source/domains/blas/her2.rst index 5fdce1277..4035acec4 100644 --- a/source/elements/oneMKL/source/domains/blas/her2.rst +++ b/source/elements/oneMath/source/domains/blas/her2.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_her2: +.. _onemath_blas_her2: her2 ==== Computes a rank-2 update of a Hermitian matrix. -.. _onemkl_blas_her2_description: +.. _onemath_blas_her2_description: .. rubric:: Description @@ -37,7 +37,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_her2_buffer: +.. _onemath_blas_her2_buffer: her2 (Buffer Version) --------------------- @@ -81,7 +81,7 @@ her2 (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -132,22 +132,22 @@ her2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_her2_usm: +.. _onemath_blas_her2_usm: her2 (USM Version) ------------------ @@ -193,7 +193,7 @@ her2 (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -256,20 +256,20 @@ her2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/her2k.rst b/source/elements/oneMath/source/domains/blas/her2k.rst similarity index 92% rename from source/elements/oneMKL/source/domains/blas/her2k.rst rename to source/elements/oneMath/source/domains/blas/her2k.rst index 80cdbb733..8f9c8ce84 100644 --- a/source/elements/oneMKL/source/domains/blas/her2k.rst +++ b/source/elements/oneMath/source/domains/blas/her2k.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_her2k: +.. _onemath_blas_her2k: her2k ===== Performs a Hermitian rank-2k update. -.. _onemkl_blas_her2k_description: +.. _onemath_blas_her2k_description: .. rubric:: Description @@ -52,7 +52,7 @@ The inner dimension of both matrix multiplications is ``k``. * - ``std::complex`` - ``double`` -.. _onemkl_blas_her2k_buffer: +.. _onemath_blas_her2k_buffer: her2k (Buffer Version) ---------------------- @@ -103,7 +103,7 @@ her2k (Buffer Version) upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies the operation to apply, as described above. Supported @@ -223,22 +223,22 @@ her2k (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_her2k_usm: +.. _onemath_blas_her2k_usm: her2k (USM Version) ------------------- @@ -291,7 +291,7 @@ her2k (USM Version) upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies the operation to apply, as described above. Supported @@ -422,20 +422,20 @@ her2k (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/herk.rst b/source/elements/oneMath/source/domains/blas/herk.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/herk.rst rename to source/elements/oneMath/source/domains/blas/herk.rst index ea80e89b0..bb4298f19 100644 --- a/source/elements/oneMKL/source/domains/blas/herk.rst +++ b/source/elements/oneMath/source/domains/blas/herk.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_herk: +.. _onemath_blas_herk: herk ==== Performs a Hermitian rank-k update. -.. _onemkl_blas_herk_description: +.. _onemath_blas_herk_description: .. rubric:: Description @@ -42,7 +42,7 @@ Here op(``A``) is ``n`` x ``k``, and ``C`` is ``n`` x ``n``. * - ``std::complex`` - ``double`` -.. _onemkl_blas_herk_buffer: +.. _onemath_blas_herk_buffer: herk (Buffer Version) --------------------- @@ -89,11 +89,11 @@ herk (Buffer Version) upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to ``A``. See - :ref:`onemkl_datatypes` for more + :ref:`onemath_datatypes` for more details. Supported operations are ``transpose::nontrans`` and ``transpose::conjtrans``. @@ -174,22 +174,22 @@ herk (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_herk_usm: +.. _onemath_blas_herk_usm: herk (USM Version) ------------------ @@ -238,11 +238,11 @@ herk (USM Version) upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. Supported operations are ``transpose::nontrans`` + ``A``. See :ref:`onemath_datatypes` for more details. Supported operations are ``transpose::nontrans`` and ``transpose::conjtrans``. n @@ -333,20 +333,20 @@ herk (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hpmv.rst b/source/elements/oneMath/source/domains/blas/hpmv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/hpmv.rst rename to source/elements/oneMath/source/domains/blas/hpmv.rst index b89dff3f9..52f28a5e5 100644 --- a/source/elements/oneMKL/source/domains/blas/hpmv.rst +++ b/source/elements/oneMath/source/domains/blas/hpmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hpmv: +.. _onemath_blas_hpmv: hpmv ==== Computes a matrix-vector product using a Hermitian packed matrix. -.. _onemkl_blas_hpmv_description: +.. _onemath_blas_hpmv_description: .. rubric:: Description @@ -38,7 +38,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_hpmv_buffer: +.. _onemath_blas_hpmv_buffer: hpmv (Buffer Version) --------------------- @@ -82,7 +82,7 @@ hpmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -130,22 +130,22 @@ hpmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hpmv_usm: +.. _onemath_blas_hpmv_usm: hpmv (USM Version) ------------------ @@ -191,7 +191,7 @@ hpmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -252,20 +252,20 @@ hpmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hpr.rst b/source/elements/oneMath/source/domains/blas/hpr.rst similarity index 86% rename from source/elements/oneMKL/source/domains/blas/hpr.rst rename to source/elements/oneMath/source/domains/blas/hpr.rst index d528c22e0..26b5189e4 100644 --- a/source/elements/oneMKL/source/domains/blas/hpr.rst +++ b/source/elements/oneMath/source/domains/blas/hpr.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hpr: +.. _onemath_blas_hpr: hpr === Computes a rank-1 update of a Hermitian packed matrix. -.. _onemkl_blas_hpr_description: +.. _onemath_blas_hpr_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` - ``double`` -.. _onemkl_blas_hpr_buffer: +.. _onemath_blas_hpr_buffer: hpr (Buffer Version) -------------------- @@ -78,7 +78,7 @@ hpr (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -120,22 +120,22 @@ hpr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hpr_usm: +.. _onemath_blas_hpr_usm: hpr (USM Version) ----------------- @@ -175,7 +175,7 @@ hpr (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -229,20 +229,20 @@ hpr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/hpr2.rst b/source/elements/oneMath/source/domains/blas/hpr2.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/hpr2.rst rename to source/elements/oneMath/source/domains/blas/hpr2.rst index d0f263ceb..55556daca 100644 --- a/source/elements/oneMKL/source/domains/blas/hpr2.rst +++ b/source/elements/oneMath/source/domains/blas/hpr2.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_hpr2: +.. _onemath_blas_hpr2: hpr2 ==== Performs a rank-2 update of a Hermitian packed matrix. -.. _onemkl_blas_hpr2_description: +.. _onemath_blas_hpr2_description: .. rubric:: Description @@ -37,7 +37,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_hpr2_buffer: +.. _onemath_blas_hpr2_buffer: hpr2 (Buffer Version) --------------------- @@ -79,7 +79,7 @@ hpr2 (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -129,22 +129,22 @@ hpr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_hpr2_usm: +.. _onemath_blas_hpr2_usm: hpr2 (USM Version) ------------------ @@ -188,7 +188,7 @@ hpr2 (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -251,20 +251,20 @@ hpr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/iamax.rst b/source/elements/oneMath/source/domains/blas/iamax.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/iamax.rst rename to source/elements/oneMath/source/domains/blas/iamax.rst index 708b940f5..694a3c890 100644 --- a/source/elements/oneMKL/source/domains/blas/iamax.rst +++ b/source/elements/oneMath/source/domains/blas/iamax.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_iamax: +.. _onemath_blas_iamax: iamax ===== Finds the index of the element with the largest absolute value in a vector. -.. _onemkl_blas_iamax_description: +.. _onemath_blas_iamax_description: .. rubric:: Description @@ -41,7 +41,7 @@ index of the first ``NaN``. * - ``std::complex`` * - ``std:complex`` -.. _onemkl_blas_iamax_buffer: +.. _onemath_blas_iamax_buffer: iamax (Buffer Version) ---------------------- @@ -105,22 +105,22 @@ iamax (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_iamax_usm: +.. _onemath_blas_iamax_usm: iamax (USM Version) ------------------- @@ -197,20 +197,20 @@ iamax (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/iamin.rst b/source/elements/oneMath/source/domains/blas/iamin.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/iamin.rst rename to source/elements/oneMath/source/domains/blas/iamin.rst index ca84466de..62a5130d6 100644 --- a/source/elements/oneMKL/source/domains/blas/iamin.rst +++ b/source/elements/oneMath/source/domains/blas/iamin.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_iamin: +.. _onemath_blas_iamin: iamin ===== Finds the index of the element with the smallest absolute value. -.. _onemkl_blas_iamin_description: +.. _onemath_blas_iamin_description: .. rubric:: Description @@ -42,7 +42,7 @@ index of the first ``NaN``. * - ``std::complex`` -.. _onemkl_blas_iamin_buffer: +.. _onemath_blas_iamin_buffer: iamin (Buffer Version) ---------------------- @@ -106,22 +106,22 @@ iamin (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_iamin_usm: +.. _onemath_blas_iamin_usm: iamin (USM Version) ------------------- @@ -198,20 +198,20 @@ iamin (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/imatcopy.rst b/source/elements/oneMath/source/domains/blas/imatcopy.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/imatcopy.rst rename to source/elements/oneMath/source/domains/blas/imatcopy.rst index 5c8c0ecfb..cd81148fa 100644 --- a/source/elements/oneMKL/source/domains/blas/imatcopy.rst +++ b/source/elements/oneMath/source/domains/blas/imatcopy.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_imatcopy: +.. _onemath_blas_imatcopy: imatcopy ======== @@ -10,7 +10,7 @@ imatcopy Computes an in-place scaled matrix transpose or copy operation using a general dense matrix. -.. _onemkl_blas_imatcopy_description: +.. _onemath_blas_imatcopy_description: .. rubric:: Description @@ -44,7 +44,7 @@ and ``C`` is ``m`` x ``n`` on input. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_imatcopy_buffer: +.. _onemath_blas_imatcopy_buffer: imatcopy (Buffer Version) ------------------------- @@ -85,7 +85,7 @@ imatcopy (Buffer Version) trans Specifies op(``C``), the transposition operation applied to the - matrix ``C``. See :ref:`onemkl_datatypes` for more details. + matrix ``C``. See :ref:`onemath_datatypes` for more details. m Number of rows of ``C`` on input. Must be at least zero. @@ -149,22 +149,22 @@ imatcopy (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_imatcopy_usm: +.. _onemath_blas_imatcopy_usm: imatcopy (USM Version) ---------------------- @@ -205,7 +205,7 @@ imatcopy (USM Version) trans Specifies op(``C``), the transposition operation applied to the - matrix ``C``. See :ref:`onemkl_datatypes` for more details. + matrix ``C``. See :ref:`onemath_datatypes` for more details. m Number of rows for the matrix ``C`` on input. Must be at least zero. @@ -280,19 +280,19 @@ imatcopy (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/imatcopy_batch.rst b/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst similarity index 93% rename from source/elements/oneMKL/source/domains/blas/imatcopy_batch.rst rename to source/elements/oneMath/source/domains/blas/imatcopy_batch.rst index 5de027211..336dab8a3 100644 --- a/source/elements/oneMKL/source/domains/blas/imatcopy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_imatcopy_batch: +.. _onemath_blas_imatcopy_batch: imatcopy_batch ============== @@ -10,12 +10,12 @@ imatcopy_batch Computes a group of in-place scaled matrix transpose or copy operations using general dense matrices. -.. _onemkl_blas_imatcopy_batch_description: +.. _onemath_blas_imatcopy_batch_description: .. rubric:: Description The ``imatcopy_batch`` routines perform a series of in-place scaled matrix -copies or transpositions. They are batched versions of :ref:`onemkl_blas_imatcopy`, +copies or transpositions. They are batched versions of :ref:`onemath_blas_imatcopy`, but the ``imatcopy_batch`` routines perform their operations with groups of matrices. Each group contains matrices with the same parameters. @@ -53,7 +53,7 @@ and buffer memory. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_imatcopy_batch_buffer: +.. _onemath_blas_imatcopy_batch_buffer: imatcopy_batch (Buffer Version) ------------------------------- @@ -127,7 +127,7 @@ parameter. trans Specifies op(``C``), the transposition operation applied to the - matrices ``C``. See :ref:`onemkl_datatypes` for more details. + matrices ``C``. See :ref:`onemath_datatypes` for more details. m Number of rows of each matrix ``C`` on input. Must be at least zero. @@ -199,22 +199,22 @@ parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_imatcopy_batch_usm: +.. _onemath_blas_imatcopy_batch_usm: imatcopy_batch (USM Version) ---------------------------- @@ -491,19 +491,19 @@ matrices is given by the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/nrm2.rst b/source/elements/oneMath/source/domains/blas/nrm2.rst similarity index 82% rename from source/elements/oneMKL/source/domains/blas/nrm2.rst rename to source/elements/oneMath/source/domains/blas/nrm2.rst index 537360cf9..35e42b87a 100644 --- a/source/elements/oneMKL/source/domains/blas/nrm2.rst +++ b/source/elements/oneMath/source/domains/blas/nrm2.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_nrm2: +.. _onemath_blas_nrm2: nrm2 ==== Computes the Euclidean norm of a vector. -.. _onemkl_blas_nrm2_description: +.. _onemath_blas_nrm2_description: .. rubric:: Description @@ -43,7 +43,7 @@ where: * - ``std::complex`` - ``double`` -.. _onemkl_blas_nrm2_buffer: +.. _onemath_blas_nrm2_buffer: nrm2 (Buffer Version) --------------------- @@ -101,22 +101,22 @@ nrm2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_nrm2_usm: +.. _onemath_blas_nrm2_usm: nrm2 (USM Version) ------------------ @@ -187,20 +187,20 @@ nrm2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/omatadd.rst b/source/elements/oneMath/source/domains/blas/omatadd.rst similarity index 91% rename from source/elements/oneMKL/source/domains/blas/omatadd.rst rename to source/elements/oneMath/source/domains/blas/omatadd.rst index 953e57279..1fab02327 100644 --- a/source/elements/oneMKL/source/domains/blas/omatadd.rst +++ b/source/elements/oneMath/source/domains/blas/omatadd.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_omatadd: +.. _onemath_blas_omatadd: omatadd ======= Computes a sum of two general dense matrices, with optional transposes. -.. _onemkl_blas_omatadd_description: +.. _onemath_blas_omatadd_description: .. rubric:: Description @@ -54,7 +54,7 @@ the following in-place operations: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_omatadd_buffer: +.. _onemath_blas_omatadd_buffer: omatadd (Buffer Version) ------------------------ @@ -105,11 +105,11 @@ omatadd (Buffer Version) transa Specifies op(``A``), the transposition operation applied to the - matrix ``A``. See :ref:`onemkl_datatypes` for more details. + matrix ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to the - matrix ``B``. See :ref:`onemkl_datatypes` for more details. + matrix ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows for the result matrix ``C``. Must be at least zero. @@ -219,22 +219,22 @@ omatadd (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_omatadd_usm: +.. _onemath_blas_omatadd_usm: omatadd (USM Version) --------------------- @@ -287,11 +287,11 @@ omatadd (USM Version) transa Specifies op(``A``), the transposition operation applied to the - matrix ``A``. See :ref:`onemkl_datatypes` for more details. + matrix ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to the - matrix ``B``. See :ref:`onemkl_datatypes` for more details. + matrix ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows for the result matrix ``C``. Must be at least zero. @@ -411,19 +411,19 @@ omatadd (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/omatadd_batch.rst b/source/elements/oneMath/source/domains/blas/omatadd_batch.rst similarity index 95% rename from source/elements/oneMKL/source/domains/blas/omatadd_batch.rst rename to source/elements/oneMath/source/domains/blas/omatadd_batch.rst index 200acbaae..cb2b8c335 100644 --- a/source/elements/oneMKL/source/domains/blas/omatadd_batch.rst +++ b/source/elements/oneMath/source/domains/blas/omatadd_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_omatadd_batch: +.. _onemath_blas_omatadd_batch: omatadd_batch ============= @@ -10,12 +10,12 @@ omatadd_batch Computes a group of out-of-place scaled matrix additions using general dense matrices. -.. _onemkl_blas_omatadd_batch_description: +.. _onemath_blas_omatadd_batch_description: .. rubric:: Description The ``omatadd_batch`` routines perform a series of out-of-place scaled matrix -additions. They are batched versions of :ref:`onemkl_blas_omatadd`, +additions. They are batched versions of :ref:`onemath_blas_omatadd`, but the ``omatadd_batch`` routines perform their operations with groups of matrices. Each group contains matrices with the same parameters. @@ -53,7 +53,7 @@ and buffer memory. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_omatadd_batch_buffer: +.. _onemath_blas_omatadd_batch_buffer: omatadd_batch (Buffer Version) ------------------------------ @@ -156,11 +156,11 @@ memory, with the exception of the following in-place operations: transa Specifies op(``A``), the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to the - matrices ``B``. See :ref:`onemkl_datatypes` for more details. + matrices ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows for the result matrix ``C``. Must be at least zero. @@ -282,22 +282,22 @@ memory, with the exception of the following in-place operations: implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_omatadd_batch_usm: +.. _onemath_blas_omatadd_batch_usm: omatadd_batch (USM Version) --------------------------- @@ -616,11 +616,11 @@ in-place operations: transa Specifies op(``A``), the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. transb Specifies op(``B``), the transposition operation applied to the - matrices ``B``. See :ref:`onemkl_datatypes` for more details. + matrices ``B``. See :ref:`onemath_datatypes` for more details. m Number of rows for the result matrix ``C``. Must be at least zero. @@ -752,19 +752,19 @@ in-place operations: implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/omatcopy.rst b/source/elements/oneMath/source/domains/blas/omatcopy.rst similarity index 89% rename from source/elements/oneMKL/source/domains/blas/omatcopy.rst rename to source/elements/oneMath/source/domains/blas/omatcopy.rst index b0d99f9bd..daef2e226 100644 --- a/source/elements/oneMKL/source/domains/blas/omatcopy.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_omatcopy: +.. _onemath_blas_omatcopy: omatcopy ======== @@ -10,7 +10,7 @@ omatcopy Computes an out-of-place scaled matrix transpose or copy operation using a general dense matrix. -.. _onemkl_blas_omatcopy_description: +.. _onemath_blas_omatcopy_description: .. rubric:: Description @@ -46,7 +46,7 @@ op(``X``) is one of op(``X``) = ``X``, or op(``X``) = ``X``\ :sup:`T`, or op(``X * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_omatcopy_buffer: +.. _onemath_blas_omatcopy_buffer: omatcopy (Buffer Version) ------------------------- @@ -89,7 +89,7 @@ omatcopy (Buffer Version) trans Specifies op(``A``), the transposition operation applied to the - matrix ``A``. See :ref:`onemkl_datatypes` for more details. + matrix ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows for the matrix ``A``. Must be at least zero. @@ -158,22 +158,22 @@ omatcopy (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_omatcopy_usm: +.. _onemath_blas_omatcopy_usm: omatcopy (USM Version) ---------------------- @@ -218,7 +218,7 @@ omatcopy (USM Version) trans Specifies op(``A``), the transposition operation applied to the - matrix ``A``. See :ref:`onemkl_datatypes` for more details. + matrix ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows for the matrix ``A``. Must be at least zero. @@ -297,19 +297,19 @@ omatcopy (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/omatcopy2.rst b/source/elements/oneMath/source/domains/blas/omatcopy2.rst similarity index 91% rename from source/elements/oneMKL/source/domains/blas/omatcopy2.rst rename to source/elements/oneMath/source/domains/blas/omatcopy2.rst index 302f321f0..ebc853057 100644 --- a/source/elements/oneMKL/source/domains/blas/omatcopy2.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy2.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_omatcopy2: +.. _onemath_blas_omatcopy2: omatcopy2 ========= @@ -10,7 +10,7 @@ omatcopy2 Computes two-strided scaling and out-of-place transposition or copying of general dense matrices. -.. _onemkl_blas_omatcopy2_description: +.. _onemath_blas_omatcopy2_description: .. rubric:: Description @@ -54,7 +54,7 @@ op(``X``) is one of op(``X``) = ``X``, or op(``X``) = ``X``\ :sup:`T`, or op(``X * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_omatcopy2_buffer: +.. _onemath_blas_omatcopy2_buffer: omatcopy2 (Buffer Version) -------------------------- @@ -101,7 +101,7 @@ omatcopy2 (Buffer Version) trans Specifies op(``A``), the transposition operation applied to the - matrix ``A``. See :ref:`onemkl_datatypes` for more details. + matrix ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows for the matrix ``A``. Must be at least zero. @@ -184,22 +184,22 @@ omatcopy2 (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_omatcopy2_usm: +.. _onemath_blas_omatcopy2_usm: omatcopy2 (USM Version) ----------------------- @@ -248,7 +248,7 @@ omatcopy2 (USM Version) trans Specifies op(``A``), the transposition operation applied to matrix ``A``. - See :ref:`onemkl_datatypes` for more details. + See :ref:`onemath_datatypes` for more details. m Number of rows for the matrix ``A``. Must be at least zero. @@ -340,19 +340,19 @@ omatcopy2 (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/omatcopy_batch.rst b/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst similarity index 94% rename from source/elements/oneMKL/source/domains/blas/omatcopy_batch.rst rename to source/elements/oneMath/source/domains/blas/omatcopy_batch.rst index c361b3d30..72370390b 100644 --- a/source/elements/oneMKL/source/domains/blas/omatcopy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_omatcopy_batch: +.. _onemath_blas_omatcopy_batch: omatcopy_batch ============== @@ -10,12 +10,12 @@ omatcopy_batch Computes a group of out-of-place scaled matrix transpose or copy operations using general dense matrices. -.. _onemkl_blas_omatcopy_batch_description: +.. _onemath_blas_omatcopy_batch_description: .. rubric:: Description The ``omatcopy_batch`` routines perform a series of out-of-place scaled matrix -copies or transpositions. They are batched versions of :ref:`onemkl_blas_omatcopy`, +copies or transpositions. They are batched versions of :ref:`onemath_blas_omatcopy`, but the ``omatcopy_batch`` routines perform their operations with groups of matrices. Each group contains matrices with the same parameters. @@ -53,7 +53,7 @@ and buffer memory. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_omatcopy_batch_buffer: +.. _onemath_blas_omatcopy_batch_buffer: omatcopy_batch (Buffer Version) ------------------------------- @@ -134,7 +134,7 @@ each buffer is given by the ``batch_size`` parameter. trans Specifies op(``A``), the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. m Number of rows for each matrix ``A``. Must be at least zero. @@ -214,22 +214,22 @@ each buffer is given by the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_omatcopy_batch_usm: +.. _onemath_blas_omatcopy_batch_usm: omatcopy_batch (USM Version) ---------------------------- @@ -560,19 +560,19 @@ the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/rot.rst b/source/elements/oneMath/source/domains/blas/rot.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/rot.rst rename to source/elements/oneMath/source/domains/blas/rot.rst index f7e4b46a0..30fec7fa4 100644 --- a/source/elements/oneMKL/source/domains/blas/rot.rst +++ b/source/elements/oneMath/source/domains/blas/rot.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_rot: +.. _onemath_blas_rot: rot === Performs rotation of points in the plane. -.. _onemkl_blas_rot_description: +.. _onemath_blas_rot_description: .. rubric:: Description @@ -73,7 +73,7 @@ If ``s`` is a complex type, the operation is defined as: - ``double`` - ``double`` -.. _onemkl_blas_rot_buffer: +.. _onemath_blas_rot_buffer: rot (Buffer Version) -------------------- @@ -153,22 +153,22 @@ rot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_rot_usm: +.. _onemath_blas_rot_usm: rot (USM Version) ----------------- @@ -262,20 +262,20 @@ rot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/rotg.rst b/source/elements/oneMath/source/domains/blas/rotg.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/rotg.rst rename to source/elements/oneMath/source/domains/blas/rotg.rst index 0409a2a02..8e32436af 100644 --- a/source/elements/oneMKL/source/domains/blas/rotg.rst +++ b/source/elements/oneMath/source/domains/blas/rotg.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_rotg: +.. _onemath_blas_rotg: rotg ==== Computes the parameters for a Givens rotation. -.. _onemkl_blas_rotg_description: +.. _onemath_blas_rotg_description: .. rubric:: Description @@ -44,7 +44,7 @@ The parameter ``z`` is defined such that if \|\ ``a``\ \| > * - ``std::complex`` - ``double`` -.. _onemkl_blas_rotg_buffer: +.. _onemath_blas_rotg_buffer: rotg (Buffer Version) --------------------- @@ -109,22 +109,22 @@ rotg (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_rotg_usm: +.. _onemath_blas_rotg_usm: rotg (USM Version) ------------------ @@ -201,20 +201,20 @@ rotg (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/rotm.rst b/source/elements/oneMath/source/domains/blas/rotm.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/rotm.rst rename to source/elements/oneMath/source/domains/blas/rotm.rst index fde25b6ae..1d28792d9 100644 --- a/source/elements/oneMKL/source/domains/blas/rotm.rst +++ b/source/elements/oneMath/source/domains/blas/rotm.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_rotm: +.. _onemath_blas_rotm: rotm ==== Performs modified Givens rotation of points in the plane. -.. _onemkl_blas_rotm_description: +.. _onemath_blas_rotm_description: .. rubric:: Description @@ -34,7 +34,7 @@ transformation matrix. * - ``float`` * - ``double`` -.. _onemkl_blas_rotm_buffer: +.. _onemath_blas_rotm_buffer: rotm (Buffer Version) --------------------- @@ -148,22 +148,22 @@ rotm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_rotm_usm: +.. _onemath_blas_rotm_usm: rotm (USM Version) ------------------ @@ -291,20 +291,20 @@ rotm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/rotmg.rst b/source/elements/oneMath/source/domains/blas/rotmg.rst similarity index 88% rename from source/elements/oneMKL/source/domains/blas/rotmg.rst rename to source/elements/oneMath/source/domains/blas/rotmg.rst index 2474a105e..620686cd6 100644 --- a/source/elements/oneMKL/source/domains/blas/rotmg.rst +++ b/source/elements/oneMath/source/domains/blas/rotmg.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_rotmg: +.. _onemath_blas_rotmg: rotmg ===== Computes the parameters for a modified Givens rotation. -.. _onemkl_blas_rotmg_description: +.. _onemath_blas_rotmg_description: .. rubric:: Description @@ -33,7 +33,7 @@ the resulting vector: * - ``float`` * - ``double`` -.. _onemkl_blas_rotmg_buffer: +.. _onemath_blas_rotmg_buffer: rotmg (Buffer Version) ---------------------- @@ -144,22 +144,22 @@ rotmg (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_rotmg_usm: +.. _onemath_blas_rotmg_usm: rotmg (USM Version) ------------------- @@ -282,20 +282,20 @@ rotmg (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/sbmv.rst b/source/elements/oneMath/source/domains/blas/sbmv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/sbmv.rst rename to source/elements/oneMath/source/domains/blas/sbmv.rst index aad42517f..925a656a5 100644 --- a/source/elements/oneMKL/source/domains/blas/sbmv.rst +++ b/source/elements/oneMath/source/domains/blas/sbmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_sbmv: +.. _onemath_blas_sbmv: sbmv ==== Computes a matrix-vector product with a symmetric band matrix. -.. _onemkl_blas_sbmv_description: +.. _onemath_blas_sbmv_description: .. rubric:: Description @@ -39,7 +39,7 @@ super-diagonals, * - ``float`` * - ``double`` -.. _onemkl_blas_sbmv_buffer: +.. _onemath_blas_sbmv_buffer: sbmv (Buffer Version) --------------------- @@ -87,7 +87,7 @@ sbmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -140,22 +140,22 @@ sbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_sbmv_usm: +.. _onemath_blas_sbmv_usm: sbmv (USM Version) ------------------ @@ -205,7 +205,7 @@ sbmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -270,20 +270,20 @@ sbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/scal.rst b/source/elements/oneMath/source/domains/blas/scal.rst similarity index 82% rename from source/elements/oneMKL/source/domains/blas/scal.rst rename to source/elements/oneMath/source/domains/blas/scal.rst index bef42a9e4..c05ab3060 100644 --- a/source/elements/oneMKL/source/domains/blas/scal.rst +++ b/source/elements/oneMath/source/domains/blas/scal.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_scal: +.. _onemath_blas_scal: scal ==== Computes the product of a vector by a scalar. -.. _onemkl_blas_scal_description: +.. _onemath_blas_scal_description: .. rubric:: Description @@ -49,7 +49,7 @@ where: * - ``std::complex`` - ``double`` -.. _onemkl_blas_scal_buffer: +.. _onemath_blas_scal_buffer: scal (Buffer Version) --------------------- @@ -109,22 +109,22 @@ scal (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_scal_usm: +.. _onemath_blas_scal_usm: scal (USM Version) ------------------ @@ -192,20 +192,20 @@ scal (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/sdsdot.rst b/source/elements/oneMath/source/domains/blas/sdsdot.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/sdsdot.rst rename to source/elements/oneMath/source/domains/blas/sdsdot.rst index c606e4cdd..33d3e080e 100644 --- a/source/elements/oneMKL/source/domains/blas/sdsdot.rst +++ b/source/elements/oneMath/source/domains/blas/sdsdot.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_sdsdot: +.. _onemath_blas_sdsdot: sdsdot ====== Computes a vector-vector dot product with double precision. -.. _onemkl_blas_sdsdot_description: +.. _onemath_blas_sdsdot_description: .. rubric:: Description @@ -20,7 +20,7 @@ double precision: result = sb + \sum_{i=1}^{n}X_iY_i -.. _onemkl_blas_sdsdot_buffer: +.. _onemath_blas_sdsdot_buffer: sdsdot (Buffer Version) ----------------------- @@ -95,22 +95,22 @@ sdsdot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_sdsdot_usm: +.. _onemath_blas_sdsdot_usm: sdsdot (USM Version) -------------------- @@ -197,20 +197,20 @@ sdsdot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/spmv.rst b/source/elements/oneMath/source/domains/blas/spmv.rst similarity index 86% rename from source/elements/oneMKL/source/domains/blas/spmv.rst rename to source/elements/oneMath/source/domains/blas/spmv.rst index d3bf3b72d..220a6393c 100644 --- a/source/elements/oneMKL/source/domains/blas/spmv.rst +++ b/source/elements/oneMath/source/domains/blas/spmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_spmv: +.. _onemath_blas_spmv: spmv ==== Computes a matrix-vector product with a symmetric packed matrix. -.. _onemkl_blas_spmv_description: +.. _onemath_blas_spmv_description: .. rubric:: Description @@ -38,7 +38,7 @@ where: * - ``float`` * - ``double`` -.. _onemkl_blas_spmv_buffer: +.. _onemath_blas_spmv_buffer: spmv (Buffer Version) --------------------- @@ -82,7 +82,7 @@ spmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -127,22 +127,22 @@ spmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_spmv_usm: +.. _onemath_blas_spmv_usm: spmv (USM Version) ------------------ @@ -188,7 +188,7 @@ spmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -246,20 +246,20 @@ spmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/spr.rst b/source/elements/oneMath/source/domains/blas/spr.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/spr.rst rename to source/elements/oneMath/source/domains/blas/spr.rst index 595c8f64e..366ae00ed 100644 --- a/source/elements/oneMKL/source/domains/blas/spr.rst +++ b/source/elements/oneMath/source/domains/blas/spr.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_spr: +.. _onemath_blas_spr: spr === Performs a rank-1 update of a symmetric packed matrix. -.. _onemkl_blas_spr_description: +.. _onemath_blas_spr_description: .. rubric:: Description @@ -37,7 +37,7 @@ where: * - ``float`` * - ``double`` -.. _onemkl_blas_spr_buffer: +.. _onemath_blas_spr_buffer: spr (Buffer Version) -------------------- @@ -75,7 +75,7 @@ spr (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -113,22 +113,22 @@ spr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_spr_usm: +.. _onemath_blas_spr_usm: spr (USM Version) ----------------- @@ -168,7 +168,7 @@ spr (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -217,20 +217,20 @@ spr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/spr2.rst b/source/elements/oneMath/source/domains/blas/spr2.rst similarity index 86% rename from source/elements/oneMKL/source/domains/blas/spr2.rst rename to source/elements/oneMath/source/domains/blas/spr2.rst index 49a495108..ae65ecb96 100644 --- a/source/elements/oneMKL/source/domains/blas/spr2.rst +++ b/source/elements/oneMath/source/domains/blas/spr2.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_spr2: +.. _onemath_blas_spr2: spr2 ==== Computes a rank-2 update of a symmetric packed matrix. -.. _onemkl_blas_spr2_description: +.. _onemath_blas_spr2_description: .. rubric:: Description @@ -37,7 +37,7 @@ where: * - ``float`` * - ``double`` -.. _onemkl_blas_spr2_buffer: +.. _onemath_blas_spr2_buffer: spr2 (Buffer Version) --------------------- @@ -79,7 +79,7 @@ spr2 (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -124,22 +124,22 @@ spr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_spr2_usm: +.. _onemath_blas_spr2_usm: spr2 (USM Version) ------------------ @@ -183,7 +183,7 @@ spr2 (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -241,20 +241,20 @@ spr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/swap.rst b/source/elements/oneMath/source/domains/blas/swap.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/swap.rst rename to source/elements/oneMath/source/domains/blas/swap.rst index 0f01714e4..0007ad418 100644 --- a/source/elements/oneMKL/source/domains/blas/swap.rst +++ b/source/elements/oneMath/source/domains/blas/swap.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_swap: +.. _onemath_blas_swap: swap ==== Swaps a vector with another vector. -.. _onemkl_blas_swap_description: +.. _onemath_blas_swap_description: .. rubric:: Description @@ -38,7 +38,7 @@ other. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_swap_buffer: +.. _onemath_blas_swap_buffer: swap (Buffer Version) --------------------- @@ -110,22 +110,22 @@ swap (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_swap_usm: +.. _onemath_blas_swap_usm: swap (USM Version) ------------------ @@ -209,20 +209,20 @@ swap (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMKL/source/domains/blas/symm.rst b/source/elements/oneMath/source/domains/blas/symm.rst similarity index 89% rename from source/elements/oneMKL/source/domains/blas/symm.rst rename to source/elements/oneMath/source/domains/blas/symm.rst index f65bca11f..d9a6d72f4 100644 --- a/source/elements/oneMKL/source/domains/blas/symm.rst +++ b/source/elements/oneMath/source/domains/blas/symm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_symm: +.. _onemath_blas_symm: symm ==== @@ -10,7 +10,7 @@ symm Computes a matrix-matrix product where one input matrix is symmetric and one matrix is general. -.. _onemkl_blas_symm_description: +.. _onemath_blas_symm_description: .. rubric:: Description @@ -51,7 +51,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_symm_buffer: +.. _onemath_blas_symm_buffer: symm (Buffer Version) --------------------- @@ -102,11 +102,11 @@ symm (Buffer Version) left_right Specifies whether ``A`` is on the left side of the multiplication - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. m Number of rows of ``B`` and ``C``. The value of ``m`` must be at @@ -179,22 +179,22 @@ symm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_symm_usm: +.. _onemath_blas_symm_usm: symm (USM Version) ------------------ @@ -248,11 +248,11 @@ symm (USM Version) left_right Specifies whether ``A`` is on the left side of the multiplication (``side::left``) or on the right side - (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether ``A``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. m Number of rows of ``B`` and ``C``. The value of ``m`` must be @@ -337,20 +337,20 @@ symm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/symv.rst b/source/elements/oneMath/source/domains/blas/symv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/symv.rst rename to source/elements/oneMath/source/domains/blas/symv.rst index e79e3574c..d3d66a936 100644 --- a/source/elements/oneMKL/source/domains/blas/symv.rst +++ b/source/elements/oneMath/source/domains/blas/symv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_symv: +.. _onemath_blas_symv: symv ==== Computes a matrix-vector product for a symmetric matrix. -.. _onemkl_blas_symv_description: +.. _onemath_blas_symv_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_symv_buffer: +.. _onemath_blas_symv_buffer: symv (Buffer Version) --------------------- @@ -86,7 +86,7 @@ symv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -135,22 +135,22 @@ symv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_symv_usm: +.. _onemath_blas_symv_usm: symv (USM Version) ------------------ @@ -198,7 +198,7 @@ symv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -260,20 +260,20 @@ symv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/syr.rst b/source/elements/oneMath/source/domains/blas/syr.rst similarity index 85% rename from source/elements/oneMKL/source/domains/blas/syr.rst rename to source/elements/oneMath/source/domains/blas/syr.rst index 18d7137d4..937bcf137 100644 --- a/source/elements/oneMKL/source/domains/blas/syr.rst +++ b/source/elements/oneMath/source/domains/blas/syr.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_syr: +.. _onemath_blas_syr: syr === Computes a rank-1 update of a symmetric matrix. -.. _onemkl_blas_syr_description: +.. _onemath_blas_syr_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_syr_buffer: +.. _onemath_blas_syr_buffer: syr (Buffer Version) -------------------- @@ -80,7 +80,7 @@ syr (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -121,22 +121,22 @@ syr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_syr_usm: +.. _onemath_blas_syr_usm: syr (USM Version) ----------------- @@ -178,7 +178,7 @@ syr (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -230,20 +230,20 @@ syr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/syr2.rst b/source/elements/oneMath/source/domains/blas/syr2.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/syr2.rst rename to source/elements/oneMath/source/domains/blas/syr2.rst index 00e6191b4..8903ed0fc 100644 --- a/source/elements/oneMKL/source/domains/blas/syr2.rst +++ b/source/elements/oneMath/source/domains/blas/syr2.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_syr2: +.. _onemath_blas_syr2: syr2 ==== Computes a rank-2 update of a symmetric matrix. -.. _onemkl_blas_syr2_description: +.. _onemath_blas_syr2_description: .. rubric:: Description @@ -40,7 +40,7 @@ where: * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_syr2_buffer: +.. _onemath_blas_syr2_buffer: syr2 (Buffer Version) --------------------- @@ -84,7 +84,7 @@ syr2 (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -133,22 +133,22 @@ syr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_syr2_usm: +.. _onemath_blas_syr2_usm: syr2 (USM Version) ------------------ @@ -194,7 +194,7 @@ syr2 (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. n Number of columns of ``A``. Must be at least zero. @@ -255,20 +255,20 @@ syr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/syr2k.rst b/source/elements/oneMath/source/domains/blas/syr2k.rst similarity index 92% rename from source/elements/oneMKL/source/domains/blas/syr2k.rst rename to source/elements/oneMath/source/domains/blas/syr2k.rst index 8be26c894..9e5c66fc3 100644 --- a/source/elements/oneMKL/source/domains/blas/syr2k.rst +++ b/source/elements/oneMath/source/domains/blas/syr2k.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_syr2k: +.. _onemath_blas_syr2k: syr2k ===== Performs a symmetric rank-2k update. -.. _onemkl_blas_syr2k_description: +.. _onemath_blas_syr2k_description: .. rubric:: Description @@ -53,7 +53,7 @@ The inner dimension of both matrix multiplications is ``k``. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_syr2k_buffer: +.. _onemath_blas_syr2k_buffer: syr2k (Buffer Version) ---------------------- @@ -104,7 +104,7 @@ syr2k (Buffer Version) upper_lower Specifies whether ``C``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies the operation to apply, as described above. Conjugation @@ -223,22 +223,22 @@ syr2k (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_syr2k_usm: +.. _onemath_blas_syr2k_usm: syr2k (USM Version) ------------------- @@ -291,7 +291,7 @@ syr2k (USM Version) upper_lower Specifies whether ``C``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies the operation to apply, as described above. @@ -422,20 +422,20 @@ syr2k (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/syrk.rst b/source/elements/oneMath/source/domains/blas/syrk.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/syrk.rst rename to source/elements/oneMath/source/domains/blas/syrk.rst index cdc35413c..f4e813860 100644 --- a/source/elements/oneMKL/source/domains/blas/syrk.rst +++ b/source/elements/oneMath/source/domains/blas/syrk.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_syrk: +.. _onemath_blas_syrk: syrk ==== Performs a symmetric rank-k update. -.. _onemkl_blas_syrk_description: +.. _onemath_blas_syrk_description: .. rubric:: Description @@ -42,7 +42,7 @@ Here op(``A``) is ``n``-by-``k``, and ``C`` is ``n``-by-``n``. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_syrk_buffer: +.. _onemath_blas_syrk_buffer: syrk (Buffer Version) --------------------- @@ -89,10 +89,10 @@ syrk (Buffer Version) upper_lower Specifies whether ``C``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A`` (See :ref:`onemkl_datatypes` for more details). Conjugation is never performed, even if ``trans`` = ``transpose::conjtrans``. + Specifies op(``A``), the transposition operation applied to ``A`` (See :ref:`onemath_datatypes` for more details). Conjugation is never performed, even if ``trans`` = ``transpose::conjtrans``. n Number of rows and columns in ``C``. The value of ``n`` must be at @@ -169,22 +169,22 @@ syrk (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_syrk_usm: +.. _onemath_blas_syrk_usm: syrk (USM Version) ------------------ @@ -233,11 +233,11 @@ syrk (USM Version) upper_lower Specifies whether ``C``'s data is stored in its upper or lower - triangle. See :ref:`onemkl_datatypes` for more details. + triangle. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A`` (See :ref:`onemkl_datatypes` for more details). Conjugation is never performed, even if + ``A`` (See :ref:`onemath_datatypes` for more details). Conjugation is never performed, even if ``trans`` = ``transpose::conjtrans``. n @@ -322,20 +322,20 @@ syrk (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/syrk_batch.rst b/source/elements/oneMath/source/domains/blas/syrk_batch.rst similarity index 91% rename from source/elements/oneMKL/source/domains/blas/syrk_batch.rst rename to source/elements/oneMath/source/domains/blas/syrk_batch.rst index c106468dc..4959c7e73 100644 --- a/source/elements/oneMKL/source/domains/blas/syrk_batch.rst +++ b/source/elements/oneMath/source/domains/blas/syrk_batch.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_syrk_batch: +.. _onemath_blas_syrk_batch: syrk_batch ========== Computes a group of ``syrk`` operations. -.. _onemkl_blas_syrk_batch_description: +.. _onemath_blas_syrk_batch_description: .. rubric:: Description -The ``syrk_batch`` routines are batched versions of :ref:`onemkl_blas_syrk`, performing +The ``syrk_batch`` routines are batched versions of :ref:`onemath_blas_syrk`, performing multiple ``syrk`` operations in a single call. Each ``syrk`` operation perform a rank-k update with general matrices. @@ -28,7 +28,7 @@ operation perform a rank-k update with general matrices. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_syrk_batch_buffer: +.. _onemath_blas_syrk_batch_buffer: syrk_batch (Buffer Version) --------------------------- @@ -109,12 +109,12 @@ of matrices in ``a`` and ``c`` buffers is given by the ``batch_size`` parameter. upper_lower Specifies whether data in ``C`` is stored in its upper or lower triangle. - For more details, see :ref:`onemkl_datatypes`. + For more details, see :ref:`onemath_datatypes`. trans Specifies op(``A``) the transposition operation applied to the matrix ``A``. Conjugation is never performed, even if trans = - transpose::conjtrans. See :ref:`onemkl_datatypes` for more + transpose::conjtrans. See :ref:`onemath_datatypes` for more details. n @@ -181,22 +181,22 @@ of matrices in ``a`` and ``c`` buffers is given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_syrk_batch_usm: +.. _onemath_blas_syrk_batch_usm: syrk_batch (USM Version) --------------------------- @@ -301,7 +301,7 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. trans Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in - the rank-k update in group ``i``. See :ref:`onemkl_datatypes` for more details. + the rank-k update in group ``i``. See :ref:`onemath_datatypes` for more details. n Array of ``group_count`` integers. ``n[i]`` specifies the @@ -429,12 +429,12 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. upper_lower Specifies whether data in ``C`` is stored in its upper or lower triangle. - For more details, see :ref:`onemkl_datatypes`. + For more details, see :ref:`onemath_datatypes`. trans Specifies op(``A``) the transposition operation applied to the matrices ``A``. Conjugation is never performed, even if trans = - transpose::conjtrans. See :ref:`onemkl_datatypes` for more + transpose::conjtrans. See :ref:`onemath_datatypes` for more details. n @@ -510,20 +510,20 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/tbmv.rst b/source/elements/oneMath/source/domains/blas/tbmv.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/tbmv.rst rename to source/elements/oneMath/source/domains/blas/tbmv.rst index 6de8c9f65..cd9432525 100644 --- a/source/elements/oneMKL/source/domains/blas/tbmv.rst +++ b/source/elements/oneMath/source/domains/blas/tbmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_tbmv: +.. _onemath_blas_tbmv: tbmv ==== Computes a matrix-vector product using a triangular band matrix. -.. _onemkl_blas_tbmv_description: +.. _onemath_blas_tbmv_description: .. rubric:: Description @@ -41,7 +41,7 @@ triangular band matrix, with (``k`` + 1) diagonals, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_tbmv_buffer: +.. _onemath_blas_tbmv_buffer: tbmv (Buffer Version) --------------------- @@ -85,13 +85,13 @@ tbmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -130,22 +130,22 @@ tbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_tbmv_usm: +.. _onemath_blas_tbmv_usm: tbmv (USM Version) ------------------ @@ -191,14 +191,14 @@ tbmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -248,20 +248,20 @@ tbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/tbsv.rst b/source/elements/oneMath/source/domains/blas/tbsv.rst similarity index 84% rename from source/elements/oneMKL/source/domains/blas/tbsv.rst rename to source/elements/oneMath/source/domains/blas/tbsv.rst index 0bd82caff..c37a109e8 100644 --- a/source/elements/oneMKL/source/domains/blas/tbsv.rst +++ b/source/elements/oneMath/source/domains/blas/tbsv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_tbsv: +.. _onemath_blas_tbsv: tbsv ==== @@ -10,7 +10,7 @@ tbsv Solves a system of linear equations whose coefficients are in a triangular band matrix. -.. _onemkl_blas_tbsv_description: +.. _onemath_blas_tbsv_description: .. rubric:: Description @@ -43,7 +43,7 @@ triangular band matrix, with (``k`` + 1) diagonals, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_tbsv_buffer: +.. _onemath_blas_tbsv_buffer: tbsv (Buffer Version) --------------------- @@ -87,13 +87,13 @@ tbsv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -132,22 +132,22 @@ tbsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_tbsv_usm: +.. _onemath_blas_tbsv_usm: tbsv (USM Version) ------------------ @@ -193,14 +193,14 @@ tbsv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Number of rows and columns of ``A``. Must be at least zero. @@ -250,20 +250,20 @@ tbsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/tpmv.rst b/source/elements/oneMath/source/domains/blas/tpmv.rst similarity index 82% rename from source/elements/oneMKL/source/domains/blas/tpmv.rst rename to source/elements/oneMath/source/domains/blas/tpmv.rst index a15b57c62..901483ae6 100644 --- a/source/elements/oneMKL/source/domains/blas/tpmv.rst +++ b/source/elements/oneMath/source/domains/blas/tpmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_tpmv: +.. _onemath_blas_tpmv: tpmv ==== Computes a matrix-vector product using a triangular packed matrix. -.. _onemkl_blas_tpmv_description: +.. _onemath_blas_tpmv_description: .. rubric:: Description @@ -41,7 +41,7 @@ triangular band matrix, supplied in packed form, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_tpmv_buffer: +.. _onemath_blas_tpmv_buffer: tpmv (Buffer Version) --------------------- @@ -81,13 +81,13 @@ tpmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -118,22 +118,22 @@ tpmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_tpmv_usm: +.. _onemath_blas_tpmv_usm: tpmv (USM Version) ------------------ @@ -175,14 +175,14 @@ tpmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -225,20 +225,20 @@ tpmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/tpsv.rst b/source/elements/oneMath/source/domains/blas/tpsv.rst similarity index 83% rename from source/elements/oneMKL/source/domains/blas/tpsv.rst rename to source/elements/oneMath/source/domains/blas/tpsv.rst index e5f67633b..9a14c1590 100644 --- a/source/elements/oneMKL/source/domains/blas/tpsv.rst +++ b/source/elements/oneMath/source/domains/blas/tpsv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_tpsv: +.. _onemath_blas_tpsv: tpsv ==== @@ -10,7 +10,7 @@ tpsv Solves a system of linear equations whose coefficients are in a triangular packed matrix. -.. _onemkl_blas_tpsv_description: +.. _onemath_blas_tpsv_description: .. rubric:: Description @@ -43,7 +43,7 @@ triangular band matrix, supplied in packed form, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_tpsv_buffer: +.. _onemath_blas_tpsv_buffer: tpsv (Buffer Version) --------------------- @@ -85,13 +85,13 @@ tpsv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -123,22 +123,22 @@ tpsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_tpsv_usm: +.. _onemath_blas_tpsv_usm: tpsv (USM Version) ------------------ @@ -182,14 +182,14 @@ tpsv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -233,20 +233,20 @@ tpsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/trmm.rst b/source/elements/oneMath/source/domains/blas/trmm.rst similarity index 87% rename from source/elements/oneMKL/source/domains/blas/trmm.rst rename to source/elements/oneMath/source/domains/blas/trmm.rst index e86484667..72b144cc1 100644 --- a/source/elements/oneMKL/source/domains/blas/trmm.rst +++ b/source/elements/oneMath/source/domains/blas/trmm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_trmm: +.. _onemath_blas_trmm: trmm ==== @@ -10,7 +10,7 @@ trmm Computes a matrix-matrix product where one input matrix is triangular and one input matrix is general. -.. _onemkl_blas_trmm_description: +.. _onemath_blas_trmm_description: .. rubric:: Description @@ -68,7 +68,7 @@ Here ``B`` and ``C`` are ``m`` x ``n`` and ``A`` is either ``m`` x ``m`` or * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_trmm_buffer: +.. _onemath_blas_trmm_buffer: trmm (Buffer Version) --------------------- @@ -120,17 +120,17 @@ trmm (Buffer Version) left_right Specifies whether ``A`` is on the left side of the multiplication - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether ``A`` is assumed to be unit triangular (all - diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of ``B``. The value of ``m`` must be @@ -187,19 +187,19 @@ trmm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Out-of-place API** -------------------- @@ -256,16 +256,16 @@ trmm (Buffer Version) left_right Specifies whether ``A`` is on the left side of the multiplication - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemath_datatypes` for more details. unit_diag - Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifices the number of rows of ``B``. The value of ``m`` must be at least zero. @@ -313,22 +313,22 @@ trmm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_trmm_usm: +.. _onemath_blas_trmm_usm: trmm (USM Version) ------------------ @@ -383,19 +383,19 @@ trmm (USM Version) left_right Specifies whether ``A`` is on the left side of the multiplication (``side::left``) or on the right side - (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether the matrix ``A`` is upper or lower - triangular. See :ref:`onemkl_datatypes` for more details. + triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether ``A`` is assumed to be unit triangular (all - diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of ``B``. The value of ``m`` must @@ -463,20 +463,20 @@ trmm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Out-of-place API** -------------------- @@ -535,16 +535,16 @@ trmm (USM Version) left_right Specifies whether ``A`` is on the left side of the multiplication - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemath_datatypes` for more details. unit_diag - Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifices the number of rows of ``B``. The value of ``m`` must be at least zero. @@ -596,18 +596,18 @@ trmm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/trmv.rst b/source/elements/oneMath/source/domains/blas/trmv.rst similarity index 83% rename from source/elements/oneMKL/source/domains/blas/trmv.rst rename to source/elements/oneMath/source/domains/blas/trmv.rst index e660a932a..ec13be0b3 100644 --- a/source/elements/oneMKL/source/domains/blas/trmv.rst +++ b/source/elements/oneMath/source/domains/blas/trmv.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_trmv: +.. _onemath_blas_trmv: trmv ==== Computes a matrix-vector product using a triangular matrix. -.. _onemkl_blas_trmv_description: +.. _onemath_blas_trmv_description: .. rubric:: Description @@ -41,7 +41,7 @@ triangular band matrix, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_trmv_buffer: +.. _onemath_blas_trmv_buffer: trmv (Buffer Version) --------------------- @@ -83,13 +83,13 @@ trmv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -124,22 +124,22 @@ trmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_trmv_usm: +.. _onemath_blas_trmv_usm: trmv (USM Version) ------------------ @@ -183,14 +183,14 @@ trmv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -236,20 +236,20 @@ trmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/blas/trsm.rst b/source/elements/oneMath/source/domains/blas/trsm.rst similarity index 86% rename from source/elements/oneMKL/source/domains/blas/trsm.rst rename to source/elements/oneMath/source/domains/blas/trsm.rst index 70bac6b62..4695cc9e1 100644 --- a/source/elements/oneMKL/source/domains/blas/trsm.rst +++ b/source/elements/oneMath/source/domains/blas/trsm.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_trsm: +.. _onemath_blas_trsm: trsm ==== Solves a triangular matrix equation (forward or backward solve). -.. _onemkl_blas_trsm_description: +.. _onemath_blas_trsm_description: .. rubric:: Description @@ -66,7 +66,7 @@ For the out-of-place operation, ``B`` remains untouched and the solution is adde * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_trsm_buffer: +.. _onemath_blas_trsm_buffer: trsm (Buffer Version) --------------------- @@ -118,17 +118,17 @@ trsm (Buffer Version) left_right Specifies whether ``A`` multiplies ``X`` on the left - (``side::left``) or on the right (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether ``A`` is assumed to be unit triangular (all - diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of ``B``. The value of ``m`` must be @@ -184,19 +184,19 @@ trsm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Out-of-place API** -------------------- @@ -253,16 +253,16 @@ trsm (Buffer Version) left_right Specifies whether ``A`` is on the left side of the matrix solve - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemath_datatypes` for more details. unit_diag - Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifices the number of rows of ``B``. The value of ``m`` must be at least zero. @@ -310,22 +310,22 @@ trsm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_trsm_usm: +.. _onemath_blas_trsm_usm: trsm (USM Version) ------------------ @@ -379,19 +379,19 @@ trsm (USM Version) left_right Specifies whether ``A`` multiplies ``X`` on the left - (``side::left``) or on the right (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether the matrix ``A`` is upper or lower - triangular. See :ref:`onemkl_datatypes` for more details. + triangular. See :ref:`onemath_datatypes` for more details. transa Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether ``A`` is assumed to be unit triangular (all - diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifies the number of rows of ``B``. The value of ``m`` must @@ -458,20 +458,20 @@ trsm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Out-of-place API** -------------------- @@ -530,16 +530,16 @@ trsm (USM Version) left_right Specifies whether ``A`` is on the left side of the matrix solve - (``side::left``) or on the right side (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right side (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower - Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to matrix ``A``. See :ref:`onemath_datatypes` for more details. unit_diag - Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Specifices the number of rows of ``B``. The value of ``m`` must be at least zero. @@ -591,19 +591,19 @@ trsm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMKL/source/domains/blas/trsm_batch.rst b/source/elements/oneMath/source/domains/blas/trsm_batch.rst similarity index 90% rename from source/elements/oneMKL/source/domains/blas/trsm_batch.rst rename to source/elements/oneMath/source/domains/blas/trsm_batch.rst index e31b403f6..4042873b4 100644 --- a/source/elements/oneMKL/source/domains/blas/trsm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/trsm_batch.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_trsm_batch: +.. _onemath_blas_trsm_batch: trsm_batch ========== Computes a group of ``trsm`` operations. -.. _onemkl_blas_trsm_batch_description: +.. _onemath_blas_trsm_batch_description: .. rubric:: Description -The ``trsm_batch`` routines are batched versions of :ref:`onemkl_blas_trsm`, performing +The ``trsm_batch`` routines are batched versions of :ref:`onemath_blas_trsm`, performing multiple ``trsm`` operations in a single call. Each ``trsm`` solves an equation of the form op(A) \* X = alpha \* B or X \* op(A) = alpha \* B. @@ -28,7 +28,7 @@ solves an equation of the form op(A) \* X = alpha \* B or X \* op(A) = alpha \* * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_trsm_batch_buffer: +.. _onemath_blas_trsm_batch_buffer: trsm_batch (Buffer Version) --------------------------- @@ -121,19 +121,19 @@ of matrices in ``a`` and ``b`` buffers are given by the ``batch_size`` parameter left_right Specifies whether the matrices ``A`` multiply ``X`` on the left - (``side::left``) or on the right (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether the matrices ``A`` are upper or lower - triangular. See :ref:`onemkl_datatypes` for more details. + triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether the matrices ``A`` are assumed to be unit - triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Number of rows of the ``B`` matrices. Must be at least zero. @@ -190,19 +190,19 @@ of matrices in ``a`` and ``b`` buffers are given by the ``batch_size`` parameter This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` trsm_batch (USM Version) --------------------------- @@ -320,19 +320,19 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. left_right Array of ``group_count`` ``oneapi::mkl::side`` values. ``left_right[i]`` specifies whether ``A`` multiplies ``X`` on the left (``side::left``) or on the right - (``side::right``) for every ``trsm`` operation in group ``i``. See :ref:`onemkl_datatypes` for more details. + (``side::right``) for every ``trsm`` operation in group ``i``. See :ref:`onemath_datatypes` for more details. upper_lower Array of ``group_count`` ``oneapi::mkl::uplo`` values. ``upper_lower[i]`` specifies whether ``A`` is upper or lower - triangular for every matrix in group ``i``. See :ref:`onemkl_datatypes` for more details. + triangular for every matrix in group ``i``. See :ref:`onemath_datatypes` for more details. trans Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used - for every ``trsm`` operation in group ``i``. See :ref:`onemkl_datatypes` for more details. + for every ``trsm`` operation in group ``i``. See :ref:`onemath_datatypes` for more details. unit_diag Array of ``group_count`` ``oneapi::mkl::diag`` values. ``unit_diag[i]`` specifies whether ``A`` is assumed to - be unit triangular (all diagonal elements are 1) for every matrix in group ``i``. See :ref:`onemkl_datatypes` for more details. + be unit triangular (all diagonal elements are 1) for every matrix in group ``i``. See :ref:`onemath_datatypes` for more details. m Array of ``group_count`` integers. ``m[i]`` specifies the @@ -450,19 +450,19 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. left_right Specifies whether the matrices ``A`` multiply ``X`` on the left - (``side::left``) or on the right (``side::right``). See :ref:`onemkl_datatypes` for more details. + (``side::left``) or on the right (``side::right``). See :ref:`onemath_datatypes` for more details. upper_lower Specifies whether the matrices ``A`` are upper or lower - triangular. See :ref:`onemkl_datatypes` for more details. + triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to the - matrices ``A``. See :ref:`onemkl_datatypes` for more details. + matrices ``A``. See :ref:`onemath_datatypes` for more details. unit_diag Specifies whether the matrices ``A`` are assumed to be unit - triangular (all diagonal elements are 1). See :ref:`onemkl_datatypes` for more details. + triangular (all diagonal elements are 1). See :ref:`onemath_datatypes` for more details. m Number of rows of the ``B`` matrices. Must be at least zero. @@ -525,20 +525,20 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMKL/source/domains/blas/trsv.rst b/source/elements/oneMath/source/domains/blas/trsv.rst similarity index 83% rename from source/elements/oneMKL/source/domains/blas/trsv.rst rename to source/elements/oneMath/source/domains/blas/trsv.rst index bc72a057d..99f1b40aa 100644 --- a/source/elements/oneMKL/source/domains/blas/trsv.rst +++ b/source/elements/oneMath/source/domains/blas/trsv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_blas_trsv: +.. _onemath_blas_trsv: trsv ==== @@ -10,7 +10,7 @@ trsv Solves a system of linear equations whose coefficients are in a triangular matrix. -.. _onemkl_blas_trsv_description: +.. _onemath_blas_trsv_description: .. rubric:: Description @@ -42,7 +42,7 @@ triangular matrix, * - ``std::complex`` * - ``std::complex`` -.. _onemkl_blas_trsv_buffer: +.. _onemath_blas_trsv_buffer: trsv (Buffer Version) --------------------- @@ -84,13 +84,13 @@ trsv (Buffer Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans - Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemkl_datatypes` for more details. + Specifies op(``A``), the transposition operation applied to ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -124,22 +124,22 @@ trsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` -.. _onemkl_blas_trsv_usm: +.. _onemath_blas_trsv_usm: trsv (USM Version) ------------------ @@ -183,14 +183,14 @@ trsv (USM Version) The queue where the routine should be executed. upper_lower - Specifies whether ``A`` is upper or lower triangular. See :ref:`onemkl_datatypes` for more details. + Specifies whether ``A`` is upper or lower triangular. See :ref:`onemath_datatypes` for more details. trans Specifies op(``A``), the transposition operation applied to - ``A``. See :ref:`onemkl_datatypes` for more details. + ``A``. See :ref:`onemath_datatypes` for more details. unit_nonunit - Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemkl_datatypes` for more details. + Specifies whether the matrix ``A`` is unit triangular or not. See :ref:`onemath_datatypes` for more details. n Numbers of rows and columns of ``A``. Must be at least zero. @@ -236,20 +236,20 @@ trsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::mkl::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::mkl::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::mkl::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::mkl::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMKL/source/domains/dense_linear_algebra.inc.rst b/source/elements/oneMath/source/domains/dense_linear_algebra.inc.rst similarity index 53% rename from source/elements/oneMKL/source/domains/dense_linear_algebra.inc.rst rename to source/elements/oneMath/source/domains/dense_linear_algebra.inc.rst index 517ce3516..98d4eef97 100644 --- a/source/elements/oneMKL/source/domains/dense_linear_algebra.inc.rst +++ b/source/elements/oneMath/source/domains/dense_linear_algebra.inc.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dense_linear_algebra: +.. _onemath_dense_linear_algebra: Dense Linear Algebra --------------------- This section contains information about dense linear algebra routines: -:ref:`matrix-storage` provides information about dense matrix and vector storage formats that are used by oneMKL :ref:`onemkl_blas` and :ref:`onemkl_lapack`. +:ref:`matrix-storage` provides information about dense matrix and vector storage formats that are used by oneMath :ref:`onemath_blas` and :ref:`onemath_lapack`. -:ref:`onemkl_blas` provides vector, matrix-vector, and matrix-matrix routines for dense matrices and vector operations. +:ref:`onemath_blas` provides vector, matrix-vector, and matrix-matrix routines for dense matrices and vector operations. :ref:`value_or_pointer` describes some details of how scalar parameters (such as ``alpha`` and ``beta``) are handled so that users may pass either values or pointers for these parameters. -:ref:`onemkl_lapack` provides more complex dense linear algebra routines, e.g., matrix factorization, solving dense systems of linear equations, least square problems, eigenvalue and singular value problems, and performing a number of related computational tasks. +:ref:`onemath_lapack` provides more complex dense linear algebra routines, e.g., matrix factorization, solving dense systems of linear equations, least square problems, eigenvalue and singular value problems, and performing a number of related computational tasks. .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/dft/compute_backward.rst b/source/elements/oneMath/source/domains/dft/compute_backward.rst similarity index 98% rename from source/elements/oneMKL/source/domains/dft/compute_backward.rst rename to source/elements/oneMath/source/domains/dft/compute_backward.rst index 2065f4a60..8b067427f 100644 --- a/source/elements/oneMKL/source/domains/dft/compute_backward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_backward.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_compute_backward: +.. _onemath_dft_compute_backward: The ``compute_backward`` function templates =========================================== @@ -13,7 +13,7 @@ computation of backward DFT(s), as defined by a (committed) templates are declared in the ``oneapi::mkl::dft`` namespace; the usage of prepended namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. -.. _onemkl_dft_compute_backward_description: +.. _onemath_dft_compute_backward_description: .. rubric:: Description @@ -36,7 +36,7 @@ progress of the enqueued DFT calculations. done, for instance, by labeling them as friend functions to the ``descriptor`` :ref:`class template`. -.. onemkl_dft_compute_backward_buffer: +.. onemath_dft_compute_backward_buffer: ``compute_backward`` (Buffer versions) -------------------------------------- @@ -207,7 +207,7 @@ progress of the enqueued DFT calculations. associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. -.. onemkl_dft_compute_backward_usm: +.. onemath_dft_compute_backward_usm: ``compute_backward`` (USM versions) ----------------------------------- @@ -393,4 +393,4 @@ progress of the enqueued DFT calculations. routines, which may depend on the result of the backward transform(s) before proceeding with other operations. -**Parent topic:** :ref:`onemkl_dft` +**Parent topic:** :ref:`onemath_dft` diff --git a/source/elements/oneMKL/source/domains/dft/compute_forward.rst b/source/elements/oneMath/source/domains/dft/compute_forward.rst similarity index 98% rename from source/elements/oneMKL/source/domains/dft/compute_forward.rst rename to source/elements/oneMath/source/domains/dft/compute_forward.rst index 4543b18d5..a9d550f23 100644 --- a/source/elements/oneMKL/source/domains/dft/compute_forward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_forward.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_compute_forward: +.. _onemath_dft_compute_forward: The ``compute_forward`` function templates ========================================== @@ -13,7 +13,7 @@ computation of forward DFT(s), as defined by a (committed) templates are declared in the ``oneapi::mkl::dft`` namespace; the usage of prepended namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. -.. _onemkl_dft_compute_forward_description: +.. _onemath_dft_compute_forward_description: .. rubric:: Description @@ -36,7 +36,7 @@ progress of the enqueued DFT calculations. done, for instance, by labeling them as friend functions to the ``descriptor`` :ref:`class template`. -.. onemkl_dft_compute_forward_buffer: +.. onemath_dft_compute_forward_buffer: ``compute_forward`` (Buffer versions) ------------------------------------- @@ -208,7 +208,7 @@ progress of the enqueued DFT calculations. associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. -.. onemkl_dft_compute_forward_usm: +.. onemath_dft_compute_forward_usm: ``compute_forward`` (USM versions) ---------------------------------- @@ -394,4 +394,4 @@ progress of the enqueued DFT calculations. routines, which may depend on the result of the forward transform(s) before proceeding with other operations. -**Parent topic:** :ref:`onemkl_dft` +**Parent topic:** :ref:`onemath_dft` diff --git a/source/elements/oneMKL/source/domains/dft/config_params/data_layouts.rst b/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst similarity index 91% rename from source/elements/oneMKL/source/domains/dft/config_params/data_layouts.rst rename to source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst index 9720aea80..796366ae0 100644 --- a/source/elements/oneMKL/source/domains/dft/config_params/data_layouts.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_config_data_layouts: +.. _onemath_dft_config_data_layouts: Configuration of data layouts ----------------------------- @@ -20,7 +20,7 @@ accordingly, ``config_param::FWD_DISTANCE`` (resp. specifying the distances between successive data sequences in the forward (resp. backward) domain. -Using the notations from the :ref:`introduction` and the +Using the notations from the :ref:`introduction` and the superscript :math:`\text{fwd}` (resp. :math:`\text{bwd}`) for data sequences belonging to forward (resp. backward) domain, for any :math:`m` and multi-index :math:`\left(k_1, k_2, \ldots, k_d\right)` within :ref:`valid @@ -35,31 +35,31 @@ imaginary part thereof – of the relevant data sequence is located at index of the corresponding data container (``sycl::buffer`` object or device-accessible USM allocation) provided to the compute function, the base data type of which is (possibly implicitly re-interpreted) as documented in the -:ref:`table` +:ref:`table` below. In the index expression :eq:`eq_idx_data_layout`, :math:`\text{x} = \text{f}` (resp. :math:`\text{x} = \text{b}`) for entries of forward-domain (resp. backward-domain) data sequences and - :math:`s^{\text{xwd}}_j`, :math:`\forall j \in \lbrace 0, \ldots, d\rbrace` represents the :ref:`offset and generalized - strides` defining the locations of entries within + strides` defining the locations of entries within each :math:`d`-dimensional data sequence in the forward (resp. backward) domain if :math:`\text{x} = \text{f}` (resp. if :math:`\text{x} = \text{b}`), counted in number of elements of the relevant :ref:`implicitly-assumed - elementary data type`; + elementary data type`; - :math:`l^{\text{xwd}}` represents the - :ref:`distance` between successive + :ref:`distance` between successive :math:`d`-dimensional data sequences in the forward (resp. backward) domain if :math:`\text{x} = \text{f}` (resp. if :math:`\text{x} = \text{b}`), counted in number of elements of the relevant :ref:`implicitly-assumed elementary data - type`. + type`. .. note:: All data sequences (or respective real and imaginary parts thereof if separately stored) must belong to the same block allocation, as a consequence of the generalized index :eq:`eq_idx_data_layout`. -.. _onemkl_dft_config_data_implicitly_assumed_elementary_data_type: +.. _onemath_dft_config_data_implicitly_assumed_elementary_data_type: .. rubric:: Implicitly-assumed elementary data type @@ -108,7 +108,7 @@ its configuration value for ``config_param::COMPLEX_STORAGE`` (first 2 columns). - ``double`` - ``std::complex`` -.. _onemkl_dft_num_dft_data_layouts_batched_dfts: +.. _onemath_dft_num_dft_data_layouts_batched_dfts: .. rubric:: Configuring data layouts for batched transforms @@ -125,9 +125,9 @@ configuration parameter ``config_param::NUMBER_OF_TRANSFORMS``. In that case, the configuration parameters ``config_param::FWD_DISTANCE`` and ``config_param::BWD_DISTANCE`` *must also* be set explicitly since their default configuration values of :math:`0` would break the :ref:`consistency -requirements` for any :math:`M > 1`. +requirements` for any :math:`M > 1`. -.. _onemkl_dft_fwd_bwd_strides: +.. _onemath_dft_fwd_bwd_strides: .. rubric:: Configuring strides in forward and backward domains @@ -145,7 +145,7 @@ The default values set for the forward and backward strides correspond to the data layout configurations for unbatched, in-place transforms using unit stride along the last dimension with no offset (and minimal padding in forward domain in case of real descriptors, aligning with the :ref:`requirements for -in-place transforms`). In other words, the +in-place transforms`). In other words, the default values are :math:`s^{\text{fwd}}_0 = s^{\text{bwd}}_0 = 0`, :math:`s^{\text{fwd}}_d = s^{\text{bwd}}_d = 1` and, for :math:`d`-dimensional DFTs with :math:`d > 1`, @@ -158,7 +158,7 @@ DFTs with :math:`d > 1`, for :math:`k \in \lbrace 1, \ldots, d - 2\rbrace` (for :math:`\text{x} = \text{f}` and :math:`\text{x} = \text{b}`). -.. _onemkl_dft_data_layout_requirements: +.. _onemath_dft_data_layout_requirements: .. rubric:: General consistency requirements @@ -168,7 +168,7 @@ under consideration. In other words, there must not be one index value as expressed in :eq:`eq_idx_data_layout` that corresponds to two different :math:`(d+1)`-tuples :math:`(m, k_{1}, k_{2}, \dots, k_d)` that are both within the :ref:`elementary range of indices considered by -oneMKL`. +oneMath`. Additionally, for in-place transforms (configuration value ``config_value::INPLACE`` associated with configuration parameter @@ -178,14 +178,14 @@ abide by following "*consistency requirement*": the memory address(es) of leading entry(ies) along the last dimension must be identical in forward and backward domains. Specifically, considering any :math:`(d+1)`-tuple :math:`(m, k_{1}, k_{2}, \dots, k_{d-1}, 0)` within :ref:`valid -range`, the memory address of the +range`, the memory address of the element of corresponding index value :eq:`eq_idx_data_layout` in forward domain (considering the :ref:`implicitly assumed -type` in forward +type` in forward domain) must be identical to the memory address of the element of corresponding index value :eq:`eq_idx_data_layout` in backward domain (considering the :ref:`implicitly assumed -type` in +type` in backward domain). Equivalently, - for complex descriptors, the offset, stride(s) (and distances, if relevant) @@ -197,7 +197,7 @@ backward domain). Equivalently, this leads to some data padding being required in forward domain if unit strides are used along the last dimension in forward and backward domains. -.. _onemkl_dft_io_strides_deprecated: +.. _onemath_dft_io_strides_deprecated: .. rubric:: Configuring strides for input and output data [deprecated, **not** recommended] @@ -214,7 +214,7 @@ configuration parameter ``config_param::INPUT_STRIDES`` if :math:`\text{x} = \text{o}`). The values of :math:`s^{\text{i}}_{j}` and :math:`s^{\text{o}}_{j}` are to be -used and considered by oneMKL if and only if +used and considered by oneMath if and only if :math:`s^{\text{fwd}}_{j} = s^{\text{bwd}}_{j} = 0, \forall j \in \lbrace 0, 1, \ldots, d\rbrace`. This will happen automatically if ``config_param::INPUT_STRIDES`` and ``config_param::OUTPUT_STRIDES`` are set and ``config_param::FWD_STRIDES`` and @@ -275,7 +275,7 @@ forward and backward domains must be supported by successfully-committed which is **not** to be supported. If such a configuration is attempted, an exception is to be thrown at commit time due to invalid configuration, as the stride values that were implicitly reset surely invalidate the - :ref:`consistency requirements` for any + :ref:`consistency requirements` for any non-trivial DFT. If specifying the data layout strides using these deprecated configuration @@ -302,4 +302,4 @@ parameters are deprecated. A warning message "{IN,OUT}PUT_STRIDES are deprecated please use {F,B}WD_STRIDES, instead." is to be reported to applications using these configuration parameters. -**Parent topic** :ref:`onemkl_dft_enums` +**Parent topic** :ref:`onemath_dft_enums` diff --git a/source/elements/oneMKL/source/domains/dft/config_params/storage_formats.rst b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst similarity index 97% rename from source/elements/oneMKL/source/domains/dft/config_params/storage_formats.rst rename to source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst index 7a8dfcdae..e3a21cdbc 100644 --- a/source/elements/oneMKL/source/domains/dft/config_params/storage_formats.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_data_storage: +.. _onemath_dft_data_storage: Data storage ============ @@ -15,7 +15,7 @@ whether it is a real or complex descriptor and, in case of complex descriptors, on the configuration value associated with configuration parameter ``config_param::COMPLEX_STORAGE``. -.. _onemkl_dft_complex_storage: +.. _onemath_dft_complex_storage: Complex descriptors ------------------- @@ -36,7 +36,7 @@ and imaginary parts of those entries are accessed and stored as ``float`` (resp. These two behaviors are further specified and illustrated below. -.. _onemkl_dft_complex_storage_complex_complex: +.. _onemath_dft_complex_storage_complex_complex: .. rubric:: ``config_value::COMPLEX_COMPLEX`` for ``config_param::COMPLEX_STORAGE`` @@ -88,7 +88,7 @@ USM allocations. // Upon completion of ev, in backward domain: entry {m;k1,k2,k3} // = Z[ strides[0] + k1*strides[1] + k2*strides[2] + k3*strides[3] + m*dist ] -.. _onemkl_dft_complex_storage_real_real: +.. _onemath_dft_complex_storage_real_real: .. rubric:: ``config_value::REAL_REAL`` for ``config_param::COMPLEX_STORAGE`` @@ -146,7 +146,7 @@ USM allocations. // and the imaginary part of entry {m;k1,k2,k3} // = ZI[ strides[0] + k1*strides[1] + k2*strides[2] + k3*strides[3] + m*dist ] -.. _onemkl_dft_real_storage: +.. _onemath_dft_real_storage: Real descriptors ---------------- @@ -197,4 +197,4 @@ forward and backward domains, with USM allocations. // Note: if n3/2 < k3 < n3, entry {m;k1,k2,k3} is not stored explicitly // since it is equal to std::conj(entry {m;n1-k1,n2-k2,n3-k3}) -**Parent topic** :ref:`onemkl_dft_enums` +**Parent topic** :ref:`onemath_dft_enums` diff --git a/source/elements/oneMKL/source/domains/dft/config_params/workspace_placement.rst b/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst similarity index 94% rename from source/elements/oneMKL/source/domains/dft/config_params/workspace_placement.rst rename to source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst index d187810fe..517779cb8 100644 --- a/source/elements/oneMKL/source/domains/dft/config_params/workspace_placement.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_config_workspace_placement: +.. _onemath_dft_config_workspace_placement: Workspace placement ------------------- @@ -36,7 +36,7 @@ it manages its workspace automatically (configuration value ``config_value::WORKSPACE_AUTOMATIC``) or if it is to be provided with an external workspace (configuration value ``config_value::WORKSPACE_EXTERNAL``). -.. _onemkl_dft_config_value_workspace_automatic: +.. _onemath_dft_config_value_workspace_automatic: .. rubric:: Automatically-managed workspace @@ -44,7 +44,7 @@ The default value for the ``config_param::WORKSPACE_PLACEMENT`` is ``config_valu When set to ``config_value::WORKSPACE_AUTOMATIC`` the user does not need to provide an external workspace. The workspace will be automatically managed by the backend library. -.. _onemkl_dft_config_value_workspace_external: +.. _onemath_dft_config_value_workspace_external: .. rubric:: Externally-managed workspace @@ -58,7 +58,7 @@ More details can be found in the section dedicated to the ``set_workspace`` :ref:`member function` and in the typical usage illustrated :ref:`below`. -.. _onemkl_dft_typical_usage_of_workspace_external: +.. _onemath_dft_typical_usage_of_workspace_external: Typical usage of externally-managed workspaces ++++++++++++++++++++++++++++++++++++++++++++++ @@ -97,5 +97,5 @@ This is shown in the following example code: // 5. Now USM compute functions can be called. -**Parent topic:** :ref:`onemkl_dft_enums` +**Parent topic:** :ref:`onemath_dft_enums` diff --git a/source/elements/oneMKL/source/domains/dft/descriptor.rst b/source/elements/oneMath/source/domains/dft/descriptor.rst similarity index 97% rename from source/elements/oneMKL/source/domains/dft/descriptor.rst rename to source/elements/oneMath/source/domains/dft/descriptor.rst index 2cdd7f813..52f56c843 100644 --- a/source/elements/oneMKL/source/domains/dft/descriptor.rst +++ b/source/elements/oneMath/source/domains/dft/descriptor.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_descriptor: +.. _onemath_dft_descriptor: The ``descriptor`` class template ================================= @@ -104,7 +104,7 @@ desired calculations to the ``sycl::queue`` object it was given when committing }; } -.. _onemkl_dft_descriptor_template_parameters: +.. _onemath_dft_descriptor_template_parameters: .. rubric:: Template parameters @@ -126,7 +126,7 @@ desired calculations to the ``sycl::queue`` object it was given when committing ``domain::REAL``) as ``dom`` are referred to as "complex descriptors" (resp. "real descriptors"). -.. _onemkl_dft_descriptor_member_table: +.. _onemath_dft_descriptor_member_table: .. rubric:: Member functions of the ``descriptor`` class template @@ -257,7 +257,7 @@ without copying them. than what is supported by the library implementation. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` .. _onemkl_dft_descriptor_assignment_operators: @@ -310,9 +310,9 @@ The copy assignment operator results in a deep copy. If any memory allocations on host have failed, for instance due to insufficient memory. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` -.. _onemkl_dft_descriptor_set_value: +.. _onemath_dft_descriptor_set_value: ``set_value`` member functions ++++++++++++++++++++++++++++++ @@ -490,7 +490,7 @@ to inform about the recommended alternative. **Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` -.. _onemkl_dft_descriptor_get_value: +.. _onemath_dft_descriptor_get_value: ``get_value`` member functions ++++++++++++++++++++++++++++++ @@ -698,9 +698,9 @@ to inform about the recommended alternative. If the queried ``param`` is valid, but not supported by the library implementation. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` -.. _onemkl_dft_descriptor_set_workspace: +.. _onemath_dft_descriptor_set_workspace: ``set_workspace`` member function +++++++++++++++++++++++++++++++++ @@ -789,9 +789,9 @@ be used in compute calls. However, the aforementioned restrictions will still ap If ``set_workspace`` is called before the descriptor is committed. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` -.. _onemkl_dft_descriptor_commit: +.. _onemath_dft_descriptor_commit: ``commit`` member function ++++++++++++++++++++++++++ @@ -805,7 +805,7 @@ the targeted device. Objects of any ``descriptor`` class **must** be committed prior to using them in any call to ``compute_forward`` or ``compute_backward`` (which trigger actual DFT calculations). -As specified :ref:`above`, all required +As specified :ref:`above`, all required configuration parameters must be set before this function is called. Any change in configuration operated on a ``descriptor`` object via a call to its ``set_value`` member function *after* it was committed results in an undefined @@ -851,6 +851,6 @@ called again. ``oneapi::mkl::device_bad_alloc()`` If any device or shared memory allocation fail. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` -**Parent topic:** :ref:`onemkl_dft` +**Parent topic:** :ref:`onemath_dft` diff --git a/source/elements/oneMKL/source/domains/dft/dft.rst b/source/elements/oneMath/source/domains/dft/dft.rst similarity index 96% rename from source/elements/oneMKL/source/domains/dft/dft.rst rename to source/elements/oneMath/source/domains/dft/dft.rst index 7268c7cf7..92a3358a3 100644 --- a/source/elements/oneMKL/source/domains/dft/dft.rst +++ b/source/elements/oneMath/source/domains/dft/dft.rst @@ -2,15 +2,15 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft: +.. _onemath_dft: Discrete Fourier Transform Functions ------------------------------------ -oneMKL provides a DPC++ interface to :math:`d`-dimensional :math:`\left(d \in +oneMath provides a DPC++ interface to :math:`d`-dimensional :math:`\left(d \in \mathbb{Z}_{>0}\right)` Discrete Fourier Transforms (DFTs). -.. _onemkl_dft_definitions: +.. _onemath_dft_definitions: Definitions +++++++++++ @@ -29,7 +29,7 @@ For every :math:`m \in \lbrace 0, 1, \ldots, M - 1 \rbrace`, the DFT of sequence :math:`w^{m}` is the :math:`d`-dimensional discrete sequence :math:`z^{m}` of length(s) :math:`n_1 \times n_2 \times \dots \times n_d` whose entries are defined as -.. _onemkl_dft_formula: +.. _onemath_dft_formula: .. math:: z^{m}_{k_1, k_2,\ldots, k_d} = \sigma_{\delta} \displaystyle\sum_{j_d=0}^{n_d-1}\dots\displaystyle\sum_{j_2=0}^{n_2-1}\displaystyle\sum_{j_1=0}^{n_1-1} w^{m}_{j_1, j_2,\dots,j_d} \exp \left[ \delta 2\pi \imath \left( \sum_{\ell=1}^{d} \frac{j_{\ell}k_{\ell}}{n_{\ell}} \right) \right], @@ -99,7 +99,7 @@ elementary range - :math:`0 \leq k_d < n_d`, except for backward domain's data sequences of real DFTs; - :math:`0 \leq k_d \leq \lfloor\frac{n_d}{2}\rfloor`, for backward domain's data sequences of real DFTs. -.. _onemkl_dft_additional_constraints_in_bwd_domain_for_real_dft: +.. _onemath_dft_additional_constraints_in_bwd_domain_for_real_dft: Additional constraints for data in backward domain of real DFTs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -121,12 +121,12 @@ DFTs. Specifically, for any of the :math:`M` sequences, that this case falls back to the above constraint if :math:`n_1 = 2`). .. note:: - The behavior of oneMKL is undefined for real backward DFT if the input data - does not satisfy those constraints. oneMKL considers it the user's + The behavior of oneMath is undefined for real backward DFT if the input data + does not satisfy those constraints. oneMath considers it the user's responsibility to guarantee that these constraints are satisfied by the input data for real backward DFTs. -.. _onemkl_dft_recommended_usage: +.. _onemath_dft_recommended_usage: Recommended usage +++++++++++++++++ @@ -174,7 +174,7 @@ Summary table The table below summarizes the identifiers of the ``oneapi::mkl::dft`` namespace relevant to computing DFTs. -.. _onemkl_dft_summary_table: +.. _onemath_dft_summary_table: .. container:: @@ -229,7 +229,7 @@ relevant to computing DFTs. :ref:`dedicated page`). -**Parent topic:** :ref:`onemkl_domains` +**Parent topic:** :ref:`onemath_domains` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/dft/enums_and_config_params.rst b/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst similarity index 97% rename from source/elements/oneMKL/source/domains/dft/enums_and_config_params.rst rename to source/elements/oneMath/source/domains/dft/enums_and_config_params.rst index 6c86a0e9b..f88828221 100644 --- a/source/elements/oneMKL/source/domains/dft/enums_and_config_params.rst +++ b/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_dft_enums: +.. _onemath_dft_enums: DFT-related scoped enumeration types ------------------------------------ @@ -33,7 +33,7 @@ namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. - Type for non-numeric configuration values corresponding to some of the :ref:`configuration parameters`. -.. _onemkl_dft_enum_precision: +.. _onemath_dft_enum_precision: ``precision`` +++++++++++++ @@ -68,7 +68,7 @@ data, the computation being carried out by oneMKL and the delivered results. - Double-precision floating-point format (FP64) is used for data representation and arithmetic operations. -.. _onemkl_dft_enum_domain: +.. _onemath_dft_enum_domain: ``domain`` ++++++++++ @@ -102,7 +102,7 @@ the backward domain type is always complex. - The forward domain is the set of complex :math:`d`-dimensional sequences. -.. _onemkl_dft_enum_config_param: +.. _onemath_dft_enum_config_param: ``config_param`` ++++++++++++++++ @@ -240,7 +240,7 @@ Values in this scoped enumeration type represent configuration parameters for :math:`\left(\cdot\right)^{m + 1}_{k_1, k_2, \ldots, k_d}` for all :math:`0\leq m < M - 1` and :math:`\left(k_1, k_2, \ldots, k_d\right)` in - :ref:`valid range`. This is + :ref:`valid range`. This is relevant (and *must* be set) for batched DFT(s), *i.e.*, if :math:`M > 1`. - | ``std::int64_t`` @@ -254,7 +254,7 @@ Values in this scoped enumeration type represent configuration parameters for :math:`\left(\cdot\right)^{m + 1}_{k_1, k_2, \ldots, k_d}` for all :math:`0\leq m < M - 1` and :math:`\left(k_1, k_2, \ldots, k_d\right)` in - :ref:`valid range`. This is + :ref:`valid range`. This is relevant (and *must* be set) for batched DFT(s), *i.e.*, if :math:`M > 1`. - | ``std::int64_t`` @@ -274,7 +274,7 @@ Values in this scoped enumeration type represent configuration parameters for - | ``std::int64_t`` | [N/A] -.. _onemkl_dft_enum_config_value: +.. _onemath_dft_enum_config_value: ``config_value`` ++++++++++++++++ @@ -341,7 +341,7 @@ configuration values associated with some available in the page dedicated to :ref:`workspace placement`. -**Parent topic:** :ref:`onemkl_dft` +**Parent topic:** :ref:`onemath_dft` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/discrete_fourier_transforms.inc.rst b/source/elements/oneMath/source/domains/discrete_fourier_transforms.inc.rst similarity index 60% rename from source/elements/oneMKL/source/domains/discrete_fourier_transforms.inc.rst rename to source/elements/oneMath/source/domains/discrete_fourier_transforms.inc.rst index 7bb406723..bde4870a5 100644 --- a/source/elements/oneMKL/source/domains/discrete_fourier_transforms.inc.rst +++ b/source/elements/oneMath/source/domains/discrete_fourier_transforms.inc.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_discrete_fourier_transforms: +.. _onemath_discrete_fourier_transforms: Discrete Fourier Transforms ---------------------------------- -The :ref:`onemkl_dft` offer several options for computing Discrete Fourier Transforms (DFTs). +The :ref:`onemath_dft` offer several options for computing Discrete Fourier Transforms (DFTs). .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/domains.rst b/source/elements/oneMath/source/domains/domains.rst similarity index 91% rename from source/elements/oneMKL/source/domains/domains.rst rename to source/elements/oneMath/source/domains/domains.rst index a243598ae..741761db8 100644 --- a/source/elements/oneMKL/source/domains/domains.rst +++ b/source/elements/oneMath/source/domains/domains.rst @@ -2,9 +2,9 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_domains: +.. _onemath_domains: -oneMKL Domains +oneMath Domains ================ This section describes the Data Parallel C++ (DPC++) interface. diff --git a/source/elements/oneMKL/source/domains/equations/error_functions_plot.jpg b/source/elements/oneMath/source/domains/equations/error_functions_plot.jpg similarity index 100% rename from source/elements/oneMKL/source/domains/equations/error_functions_plot.jpg rename to source/elements/oneMath/source/domains/equations/error_functions_plot.jpg diff --git a/source/elements/oneMKL/source/domains/equations/inverse_error_functions_plot.jpg b/source/elements/oneMath/source/domains/equations/inverse_error_functions_plot.jpg similarity index 100% rename from source/elements/oneMKL/source/domains/equations/inverse_error_functions_plot.jpg rename to source/elements/oneMath/source/domains/equations/inverse_error_functions_plot.jpg diff --git a/source/elements/oneMKL/source/domains/equations/rng-leapfrog.png b/source/elements/oneMath/source/domains/equations/rng-leapfrog.png similarity index 100% rename from source/elements/oneMKL/source/domains/equations/rng-leapfrog.png rename to source/elements/oneMath/source/domains/equations/rng-leapfrog.png diff --git a/source/elements/oneMKL/source/domains/equations/rng-skip-ahead.png b/source/elements/oneMath/source/domains/equations/rng-skip-ahead.png similarity index 100% rename from source/elements/oneMKL/source/domains/equations/rng-skip-ahead.png rename to source/elements/oneMath/source/domains/equations/rng-skip-ahead.png diff --git a/source/elements/oneMKL/source/domains/lapack/gebrd.rst b/source/elements/oneMath/source/domains/lapack/gebrd.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/gebrd.rst rename to source/elements/oneMath/source/domains/lapack/gebrd.rst index 7ff12129c..c95ce4f54 100644 --- a/source/elements/oneMKL/source/domains/lapack/gebrd.rst +++ b/source/elements/oneMath/source/domains/lapack/gebrd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gebrd: +.. _onemath_lapack_gebrd: gebrd ===== @@ -52,12 +52,12 @@ representation: If the matrix :math:`A` is real, - to compute :math:`Q` and :math:`P` explicitly, call - :ref:`onemkl_lapack_orgbr`. + :ref:`onemath_lapack_orgbr`. If the matrix :math:`A` is complex, - to compute :math:`Q` and :math:`P` explicitly, call - :ref:`onemkl_lapack_ungbr` + :ref:`onemath_lapack_ungbr` gebrd (Buffer Version) ---------------------- @@ -95,7 +95,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_gebrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_gebrd_scratchpad_size` function. .. container:: section @@ -144,17 +144,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -197,7 +197,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type T. - Size should not be less than the value returned by :ref:`onemkl_lapack_gebrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_gebrd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -249,17 +249,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -273,6 +273,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/gebrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst similarity index 69% rename from source/elements/oneMKL/source/domains/lapack/gebrd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst index 264e76cbb..39500a2f5 100644 --- a/source/elements/oneMKL/source/domains/lapack/gebrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gebrd_scratchpad_size: +.. _onemath_lapack_gebrd_scratchpad_size: gebrd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_gebrd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_gebrd` function. .. rubric:: Description @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_gebrd` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gebrd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gebrd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. .. rubric:: Syntax @@ -39,7 +39,7 @@ Calls to this routine must specify the template parameter explicitly. .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_gebrd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_gebrd` function will be performed. m The number of rows in the matrix :math:`A` (:math:`0 \le m`). @@ -56,11 +56,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -69,8 +69,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gebrd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gebrd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/geqrf.rst b/source/elements/oneMath/source/domains/lapack/geqrf.rst similarity index 83% rename from source/elements/oneMKL/source/domains/lapack/geqrf.rst rename to source/elements/oneMath/source/domains/lapack/geqrf.rst index f9c436ce3..9395d54bb 100644 --- a/source/elements/oneMKL/source/domains/lapack/geqrf.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_geqrf: +.. _onemath_lapack_geqrf: geqrf ===== @@ -63,7 +63,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_geqrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_geqrf_scratchpad_size` function. .. container:: section @@ -92,17 +92,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -143,7 +143,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_geqrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_geqrf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -176,17 +176,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -200,6 +200,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/geqrf_batch.rst b/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst similarity index 89% rename from source/elements/oneMKL/source/domains/lapack/geqrf_batch.rst rename to source/elements/oneMath/source/domains/lapack/geqrf_batch.rst index 7c5ffb211..3b874c25c 100644 --- a/source/elements/oneMKL/source/domains/lapack/geqrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_geqrf_batch: +.. _onemath_lapack_geqrf_batch: geqrf_batch =========== @@ -24,7 +24,7 @@ Computes the QR factorizations of a batch of general matrices. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_geqrf_batch_buffer: +.. _onemath_lapack_geqrf_batch_buffer: geqrf_batch (Buffer Version) ---------------------------- @@ -79,7 +79,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_scratchpad_size` function. + Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemath_lapack_geqrf_batch_scratchpad_size` function. .. container:: section @@ -97,13 +97,13 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -113,7 +113,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -.. _onemkl_lapack_geqrf_batch_usm: +.. _onemath_lapack_geqrf_batch_usm: geqrf_batch (USM Version) ------------------------- @@ -171,7 +171,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Group API of the :ref:`onemkl_lapack_geqrf_batch_scratchpad_size` function. + Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Group API of the :ref:`onemath_lapack_geqrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -198,13 +198,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -261,7 +261,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_scratchpad_size` function. + Size of scratchpad memory as the number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemath_lapack_geqrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -288,13 +288,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -304,4 +304,4 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/geqrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/geqrf_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst index beae62525..144fbf5b6 100644 --- a/source/elements/oneMKL/source/domains/lapack/geqrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_geqrf_batch_scratchpad_size: +.. _onemath_lapack_geqrf_batch_scratchpad_size: geqrf_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_geqrf_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_geqrf_batch` function. .. rubric:: Description @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_geqrf_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_geqrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_geqrf_batch` function. .. rubric:: Syntax @@ -62,7 +62,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_geqrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_geqrf_batch` function. .. container:: section @@ -70,18 +70,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_geqrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_geqrf_batch` function. .. rubric:: Syntax @@ -121,7 +121,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_geqrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_geqrf_batch` function. .. container:: section @@ -129,13 +129,13 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/geqrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst similarity index 70% rename from source/elements/oneMKL/source/domains/lapack/geqrf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst index 882fd2419..0be351a19 100644 --- a/source/elements/oneMKL/source/domains/lapack/geqrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_geqrf_scratchpad_size: +.. _onemath_lapack_geqrf_scratchpad_size: geqrf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_geqrf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_geqrf` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_geqrf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_geqrf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_geqrf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. .. container:: section @@ -43,7 +43,7 @@ Calls to this routine must specify the template parameter explicitly. .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_geqrf` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_geqrf` function will be performed. m The number of rows in the matrix :math:`A` (:math:`0 \le m`). @@ -60,11 +60,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -73,7 +73,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_geqrf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_geqrf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/gerqf.rst b/source/elements/oneMath/source/domains/lapack/gerqf.rst similarity index 84% rename from source/elements/oneMKL/source/domains/lapack/gerqf.rst rename to source/elements/oneMath/source/domains/lapack/gerqf.rst index ff13d2446..5e5f3f755 100644 --- a/source/elements/oneMKL/source/domains/lapack/gerqf.rst +++ b/source/elements/oneMath/source/domains/lapack/gerqf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gerqf: +.. _onemath_lapack_gerqf: gerqf ===== @@ -63,7 +63,7 @@ scratchpad Buffer holding scratchpad memory to be used by the routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the :ref:`onemkl_lapack_gerqf_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the :ref:`onemath_lapack_gerqf_scratchpad_size` function. .. container:: section @@ -87,17 +87,17 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -141,7 +141,7 @@ scratchpad Buffer holding scratchpad memory to be used by the routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the :ref:`onemkl_lapack_gerqf_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the :ref:`onemath_lapack_gerqf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -168,17 +168,17 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -192,5 +192,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/gerqf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/gerqf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst index 7970047d6..4faab2b2c 100644 --- a/source/elements/oneMKL/source/domains/lapack/gerqf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gerqf_scratchpad_size: +.. _onemath_lapack_gerqf_scratchpad_size: gerqf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_gerqf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_gerqf` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_gerqf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gerqf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gerqf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -64,11 +64,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -77,7 +77,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gerqf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gerqf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/gesvd.rst b/source/elements/oneMath/source/domains/lapack/gesvd.rst similarity index 92% rename from source/elements/oneMKL/source/domains/lapack/gesvd.rst rename to source/elements/oneMath/source/domains/lapack/gesvd.rst index c314fd308..919528513 100644 --- a/source/elements/oneMKL/source/domains/lapack/gesvd.rst +++ b/source/elements/oneMath/source/domains/lapack/gesvd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gesvd: +.. _onemath_lapack_gesvd: gesvd ===== @@ -24,7 +24,7 @@ Computes the singular value decomposition of a general rectangular matrix. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_gesvd_batch_buffer: +.. _onemath_lapack_gesvd_batch_buffer: gesvd (Buffer Version) ---------------------- @@ -123,7 +123,7 @@ ldvt scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_gesvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_gesvd_scratchpad_size` function. .. container:: section @@ -185,17 +185,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -308,7 +308,7 @@ ldvt scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_gesvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_gesvd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -373,17 +373,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -405,4 +405,4 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/gesvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/gesvd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst index 275a448fa..e3b6500f5 100644 --- a/source/elements/oneMKL/source/domains/lapack/gesvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_gesvd_scratchpad_size: +.. _onemath_lapack_gesvd_scratchpad_size: gesvd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_gesvd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_gesvd` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_gesvd` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gesvd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gesvd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. gesvd_scratchpad_size @@ -46,7 +46,7 @@ gesvd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_gesvd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_gesvd` function will be performed. jobu Must be ``job::allvec``, ``job::somevec``, @@ -106,11 +106,11 @@ ldvt This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -119,8 +119,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_gesvd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_gesvd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrf.rst b/source/elements/oneMath/source/domains/lapack/getrf.rst similarity index 84% rename from source/elements/oneMKL/source/domains/lapack/getrf.rst rename to source/elements/oneMath/source/domains/lapack/getrf.rst index 702764126..c99ff76cd 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrf.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrf: +.. _onemath_lapack_getrf: getrf ===== @@ -66,7 +66,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getrf_scratchpad_size` function. .. container:: section @@ -87,17 +87,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -141,7 +141,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getrf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -165,17 +165,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -191,6 +191,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrf_batch.rst b/source/elements/oneMath/source/domains/lapack/getrf_batch.rst similarity index 89% rename from source/elements/oneMKL/source/domains/lapack/getrf_batch.rst rename to source/elements/oneMath/source/domains/lapack/getrf_batch.rst index 6dc2e2f9a..629f758b9 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrf_batch: +.. _onemath_lapack_getrf_batch: getrf_batch =========== @@ -22,7 +22,7 @@ Computes the LU factorizations of a batch of general matrices. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_getrf_batch_buffer: +.. _onemath_lapack_getrf_batch_buffer: getrf_batch (Buffer Version) ---------------------------- @@ -75,7 +75,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemkl_lapack_getrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemath_lapack_getrf_batch_scratchpad_size` function. .. container:: section @@ -93,13 +93,13 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -113,7 +113,7 @@ This routine shall throw the following exceptions if the associated condition is The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these :math:`U_i` matrices can be obtained by `exceptions()` method of exception object. -.. _onemkl_lapack_getrf_batch_usm: +.. _onemath_lapack_getrf_batch_usm: getrf_batch (USM Version) ------------------------- @@ -163,7 +163,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemkl_lapack_getrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemath_lapack_getrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -190,13 +190,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -254,7 +254,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_getrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_getrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -281,13 +281,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -301,4 +301,4 @@ This routine shall throw the following exceptions if the associated condition is The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these :math:`U_i` matrices can be obtained by `exceptions()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/getrf_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst index 0d422cda0..c34b2f3da 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrf_batch_scratchpad_size: +.. _onemath_lapack_getrf_batch_scratchpad_size: getrf_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_getrf_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_getrf_batch` function. .. container:: section @@ -26,7 +26,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_getrf_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getrf_batch` function. .. container:: section @@ -65,7 +65,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getrf_batch` function. .. container:: section @@ -73,18 +73,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getrf_batch` function. .. container:: section @@ -126,7 +126,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getrf_batch` function. .. container:: section @@ -134,14 +134,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst similarity index 71% rename from source/elements/oneMKL/source/domains/lapack/getrf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst index 7b5591ee8..b4f1651c9 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrf_scratchpad_size: +.. _onemath_lapack_getrf_scratchpad_size: getrf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_getrf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_getrf` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_getrf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getrf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getrf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. getrf_scratchpad_size @@ -46,7 +46,7 @@ getrf_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_getrf` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_getrf` function will be performed. m The number of rows in the matrix :math:`A` (:math:`0 \le m`). @@ -63,11 +63,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -76,7 +76,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getrf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getrf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getri.rst b/source/elements/oneMath/source/domains/lapack/getri.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/getri.rst rename to source/elements/oneMath/source/domains/lapack/getri.rst index 4356ffba6..3d89b02c9 100644 --- a/source/elements/oneMKL/source/domains/lapack/getri.rst +++ b/source/elements/oneMath/source/domains/lapack/getri.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getri: +.. _onemath_lapack_getri: getri ===== Computes the inverse of an LU-factored general matrix determined by -:ref:`onemkl_lapack_getrf`. +:ref:`onemath_lapack_getrf`. .. container:: section @@ -26,7 +26,7 @@ Computes the inverse of an LU-factored general matrix determined by * - ``std::complex`` The routine computes the inverse :math:`A^{-1}` of a general matrix -:math:`A`. Before calling this routine, call :ref:`onemkl_lapack_getrf` +:math:`A`. Before calling this routine, call :ref:`onemath_lapack_getrf` to factorize :math:`A`. getri (BUFFER Version) @@ -53,19 +53,19 @@ n The order of the matrix :math:`A` :math:`(0 \le n)`. a - The buffer ``a`` as returned by :ref:`onemkl_lapack_getrf`. Must + The buffer ``a`` as returned by :ref:`onemath_lapack_getrf`. Must be of size at least :math:`\text{lda} \cdot \max(1,n)`. lda The leading dimension of ``a`` :math:`(n \le \text{lda})`. ipiv - The buffer as returned by :ref:`onemkl_lapack_getrf`. The + The buffer as returned by :ref:`onemath_lapack_getrf`. The dimension of ``ipiv`` must be at least :math:`\max(1, n)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getri_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getri_scratchpad_size` function. .. container:: section @@ -83,17 +83,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -125,19 +125,19 @@ n The order of the matrix :math:`A` :math:`(0 \le n)`. a - The array as returned by :ref:`onemkl_lapack_getrf`. Must + The array as returned by :ref:`onemath_lapack_getrf`. Must be of size at least :math:`\text{lda} \cdot \max(1,n)`. lda The leading dimension of ``a`` :math:`(n \le \text{lda})`. ipiv - The array as returned by :ref:`onemkl_lapack_getrf`. The + The array as returned by :ref:`onemath_lapack_getrf`. The dimension of ``ipiv`` must be at least :math:`\max(1, n)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getri_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getri_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -158,17 +158,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -182,5 +182,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getri_batch.rst b/source/elements/oneMath/source/domains/lapack/getri_batch.rst similarity index 79% rename from source/elements/oneMKL/source/domains/lapack/getri_batch.rst rename to source/elements/oneMath/source/domains/lapack/getri_batch.rst index 3cd2d5e97..a7eafc90b 100644 --- a/source/elements/oneMKL/source/domains/lapack/getri_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_batch.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getri_batch: +.. _onemath_lapack_getri_batch: getri_batch =========== -Computes the inverses of a batch of LU-factored matrices determined by :ref:`onemkl_lapack_getrf_batch`. +Computes the inverses of a batch of LU-factored matrices determined by :ref:`onemath_lapack_getrf_batch`. .. container:: section @@ -24,7 +24,7 @@ Computes the inverses of a batch of LU-factored matrices determined by :ref:`one * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_getri_batch_buffer: +.. _onemath_lapack_getri_batch_buffer: getri_batch (Buffer Version) ---------------------------- @@ -37,7 +37,7 @@ The buffer version of ``getri_batch`` supports only the strided API. **Strided API** -The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`. Before calling this routine, call the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function to factorize :math:`A_i`. +The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`. Before calling this routine, call the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function to factorize :math:`A_i`. .. container:: section @@ -60,7 +60,7 @@ n Order of the matrices :math:`A_i` (:math:`0 \le n`). a - Result of the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function. + Result of the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function. lda Leading dimension of :math:`A_i` (:math:`n\le \text{lda}`). @@ -69,7 +69,7 @@ stride_a Stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. ipiv - Arrays returned by the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function. + Arrays returned by the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function. stride_ipiv Stride between the beginnings of arrays :math:`\text{ipiv}_i` inside the array ``ipiv``. @@ -81,7 +81,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemkl_lapack_getri_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemath_lapack_getri_batch_scratchpad_size` function. .. container:: section @@ -96,13 +96,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -124,7 +124,7 @@ The USM version of ``getri_batch`` supports the group API and strided API. **Group API** -The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`. Before calling this routine, call the Group API of the :ref:`onemkl_lapack_getrf_batch_usm` function to factorize :math:`A_i`. +The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`. Before calling this routine, call the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function to factorize :math:`A_i`. Total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array. .. container:: section @@ -148,13 +148,13 @@ n Array of ``group_count`` :math:`n_g` parameters specifying the order of the matrices :math:`A_i` (:math:`0 \le n_g`) belonging to group :math:`g`. a - Result of the Group API of the :ref:`onemkl_lapack_getrf_batch_usm` function. + Result of the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function. lda Array of ``group_count`` :math:`\text{lda}_g` parameters specifying the leading dimensions of the matrices :math:`A_i` (:math:`n_g \le \text{lda}_g`) belonging to group :math:`g`. ipiv - Arrays returned by the Group API of the :ref:`onemkl_lapack_getrf_batch_usm` function. + Arrays returned by the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function. group_count Number of groups of parameters. Must be at least 0. @@ -166,7 +166,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Group API of the :ref:`onemkl_lapack_getri_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Group API of the :ref:`onemath_lapack_getri_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -190,13 +190,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -208,7 +208,7 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** -The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`. Before calling this routine, call the Strided API of the :ref:`onemkl_lapack_getrf_batch_usm` function to factorize :math:`A_i`. +The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_i`. Before calling this routine, call the Strided API of the :ref:`onemath_lapack_getrf_batch_usm` function to factorize :math:`A_i`. .. container:: section @@ -231,7 +231,7 @@ n Order of the matrices :math:`A_i` (:math:`0 \le n`). a - Result of the Strided API of the :ref:`onemkl_lapack_getrf_batch_usm` function. + Result of the Strided API of the :ref:`onemath_lapack_getrf_batch_usm` function. lda Leading dimension of :math:`A_i` (:math:`n \le \text{lda}`). @@ -240,7 +240,7 @@ stride_a Stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. ipiv - Arrays returned by the Strided API of the :ref:`onemkl_lapack_getrf_batch_usm` function. + Arrays returned by the Strided API of the :ref:`onemath_lapack_getrf_batch_usm` function. stride_ipiv Stride between the beginnings of arrays :math:`\text{ipiv}_i` inside the array ``ipiv``. @@ -252,7 +252,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemkl_lapack_getri_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the Strided API of the :ref:`onemath_lapack_getri_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -276,13 +276,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -292,5 +292,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getri_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst similarity index 79% rename from source/elements/oneMKL/source/domains/lapack/getri_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst index 954f64554..2d367f83a 100644 --- a/source/elements/oneMKL/source/domains/lapack/getri_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getri_batch_scratchpad_size: +.. _onemath_lapack_getri_batch_scratchpad_size: getri_batch_scratchpad_size =========================== -Computed size of scratchpad memory required for the :ref:`onemkl_lapack_getri_batch` function. +Computed size of scratchpad memory required for the :ref:`onemath_lapack_getri_batch` function. .. container:: section @@ -26,7 +26,7 @@ Computed size of scratchpad memory required for the :ref:`onemkl_lapack_getri_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getri_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getri_batch` function. .. container:: section @@ -62,7 +62,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getri_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getri_batch` function. .. container:: section @@ -70,18 +70,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getri_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getri_batch` function. .. container:: section @@ -120,7 +120,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getri_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getri_batch` function. .. container:: section @@ -128,14 +128,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getri_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst similarity index 70% rename from source/elements/oneMKL/source/domains/lapack/getri_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst index 2be911c9f..6bad7d04c 100644 --- a/source/elements/oneMKL/source/domains/lapack/getri_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getri_scratchpad_size: +.. _onemath_lapack_getri_scratchpad_size: getri_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_getri` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_getri` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_getri` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getri` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getri` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -47,7 +47,7 @@ getri_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_getri` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_getri` function will be performed. n The order of the matrix :math:`A` :math:`(0 \le n)`. @@ -61,11 +61,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -74,8 +74,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getri` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getri` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines`  +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines`  diff --git a/source/elements/oneMKL/source/domains/lapack/getrs.rst b/source/elements/oneMath/source/domains/lapack/getrs.rst similarity index 83% rename from source/elements/oneMKL/source/domains/lapack/getrs.rst rename to source/elements/oneMath/source/domains/lapack/getrs.rst index 4a88eedf5..6ffb4eaaa 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrs.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrs: +.. _onemath_lapack_getrs: getrs ===== @@ -39,7 +39,7 @@ equations: - if ``trans``\ =\ ``oneapi::mkl::transpose::conjtrans``\ Before calling this routine, you must call -:ref:`onemkl_lapack_getrf` +:ref:`onemath_lapack_getrf` to compute the LU factorization of :math:`A`. getrs (Buffer Version) @@ -83,7 +83,7 @@ nrhs a Buffer containing the factorization of the matrix :math:`A`, as - returned by :ref:`onemkl_lapack_getrf`. The second dimension of ``a`` must be at least + returned by :ref:`onemath_lapack_getrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda @@ -91,7 +91,7 @@ lda ipiv Array, size at least :math:`\max(1, n)`. The ``ipiv`` array, as returned by - :ref:`onemkl_lapack_getrf`. + :ref:`onemath_lapack_getrf`. b The array ``b`` contains the matrix :math:`B` whose columns are the @@ -103,7 +103,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getrs_scratchpad_size` function. .. container:: section @@ -121,17 +121,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -183,7 +183,7 @@ nrhs a Pointer to array containing the factorization of the matrix :math:`A`, as - returned by :ref:`onemkl_lapack_getrf`. The second dimension of ``a`` must be at least + returned by :ref:`onemath_lapack_getrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda @@ -191,7 +191,7 @@ lda ipiv Array, size at least :math:`\max(1, n)`. The ``ipiv`` array, as returned by - :ref:`onemkl_lapack_getrf`. + :ref:`onemath_lapack_getrf`. b The array ``b`` contains the matrix :math:`B` whose columns are the @@ -203,7 +203,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_getrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_getrs_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -224,17 +224,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -251,4 +251,4 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrs_batch.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst similarity index 86% rename from source/elements/oneMKL/source/domains/lapack/getrs_batch.rst rename to source/elements/oneMath/source/domains/lapack/getrs_batch.rst index 31f9c63e9..d79a4b64c 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrs_batch: +.. _onemath_lapack_getrs_batch: getrs_batch =========== @@ -24,7 +24,7 @@ Solves a system of linear equations with a batch of LU-factored square coefficie * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_getrs_batch_buffer: +.. _onemath_lapack_getrs_batch_buffer: getrs_batch (Buffer Version) ---------------------------- @@ -41,7 +41,7 @@ The buffer version of ``getrs_batch`` supports only the strided API. | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` - | Before calling this routine, the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function should be called to compute the LU factorizations of :math:`A_i`. + | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -73,7 +73,7 @@ nrhs Number of right-hand sides (:math:`0 \le \text{nrhs}`). a - Array containing the factorizations of the matrices :math:`A_i`, as returned the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function. + Array containing the factorizations of the matrices :math:`A_i`, as returned the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function. lda Leading dimension of :math:`A_i`. @@ -82,7 +82,7 @@ stride_a Stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. ipiv - ``ipiv`` array, as returned by the Strided API of the :ref:`onemkl_lapack_getrf_batch_buffer` function. + ``ipiv`` array, as returned by the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function. stride_ipiv Stride between the beginnings of arrays :math:`\text{ipiv}_i` inside the array ``ipiv``. @@ -103,7 +103,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_getrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_getrs_batch_scratchpad_size` function. .. container:: section @@ -118,13 +118,13 @@ b This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -136,7 +136,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then diagonal element of some of :math:`U_i` is zero, and the solve could not be completed. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these :math:`U_i` matrices can be obtained by `exceptions()` method of exception object. -.. _onemkl_lapack_getrs_batch_usm: +.. _onemath_lapack_getrs_batch_usm: getrs_batch (USM Version) ------------------------- @@ -153,7 +153,7 @@ The USM version of ``getrs_batch`` supports the group API and strided API. | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` - | Before calling this routine, call the Group API of the :ref:`onemkl_lapack_getrf_batch_usm` function to compute the LU factorizations of :math:`A_i`. + | Before calling this routine, call the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function to compute the LU factorizations of :math:`A_i`. | Total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array. .. rubric:: Syntax @@ -184,13 +184,13 @@ nrhs Array of ``group_count`` parameters :math:`\text{nrhs}_g` specifying the number of right-hand sides (:math:`0 \le \text{nrhs}_g`) for group :math:`g`. a - Array of ``batch_size`` pointers to factorizations of the matrices :math:`A_i`, as returned by the Group API of the:ref:`onemkl_lapack_getrf_batch_usm` function. + Array of ``batch_size`` pointers to factorizations of the matrices :math:`A_i`, as returned by the Group API of the:ref:`onemath_lapack_getrf_batch_usm` function. lda Array of ``group_count`` parameters :math:`\text{lda}_g` specifying the leading dimensions of :math:`A_i` from group :math:`g`. ipiv - ``ipiv`` array, as returned by the Group API of the :ref:`onemkl_lapack_getrf_batch_usm` function. + ``ipiv`` array, as returned by the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function. b The array containing ``batch_size`` pointers to the matrices :math:`B_i` whose columns are the right-hand sides for the systems of equations. @@ -208,7 +208,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemkl_lapack_getrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemath_lapack_getrs_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -232,13 +232,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by info() method of exception object: @@ -256,7 +256,7 @@ This routine shall throw the following exceptions if the associated condition is | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` - | Before calling this routine, the Strided API of the :ref:`onemkl_lapack_getrf_batch` function should be called to compute the LU factorizations of :math:`A_i`. + | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -288,7 +288,7 @@ nrhs Number of right-hand sides (:math:`0 \le \text{nrhs}`). a - Array containing the factorizations of the matrices :math:`A_i`, as returned by the Strided API of the:ref:`onemkl_lapack_getrf_batch_usm` function. + Array containing the factorizations of the matrices :math:`A_i`, as returned by the Strided API of the:ref:`onemath_lapack_getrf_batch_usm` function. lda Leading dimension of :math:`A_i`. @@ -318,7 +318,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_getrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_getrs_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -342,13 +342,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -361,5 +361,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then diagonal element of some of :math:`U_i` is zero, and the solve could not be completed. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these :math:`U_i` matrices can be obtained by `exceptions()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst similarity index 84% rename from source/elements/oneMKL/source/domains/lapack/getrs_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst index 14d36d922..f1bb7e572 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrs_batch_scratchpad_size: +.. _onemath_lapack_getrs_batch_scratchpad_size: getrs_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_getrs_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_getrs_batch` function. .. container:: section @@ -26,7 +26,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_getrs_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getrs_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getrs_batch` function. .. container:: section @@ -74,7 +74,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_getrs_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_getrs_batch` function. .. container:: section @@ -82,18 +82,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getrs_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getrs_batch` function. .. container:: section @@ -147,7 +147,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_getrs_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_getrs_batch` function. .. container:: section @@ -155,14 +155,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/getrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst similarity index 76% rename from source/elements/oneMKL/source/domains/lapack/getrs_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst index ec3484716..e3d608f25 100644 --- a/source/elements/oneMKL/source/domains/lapack/getrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_getrs_scratchpad_size: +.. _onemath_lapack_getrs_scratchpad_size: getrs_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_getrs` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_getrs` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_getrs` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getrs` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getrs` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -47,7 +47,7 @@ getrs_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_getrs` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_getrs` function will be performed. trans Indicates the form of the equations: @@ -80,11 +80,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -93,8 +93,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_getrs` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_getrs` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines`  +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines`  diff --git a/source/elements/oneMKL/source/domains/lapack/heevd.rst b/source/elements/oneMath/source/domains/lapack/heevd.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/heevd.rst rename to source/elements/oneMath/source/domains/lapack/heevd.rst index 411505a1f..56ab4dd08 100644 --- a/source/elements/oneMKL/source/domains/lapack/heevd.rst +++ b/source/elements/oneMath/source/domains/lapack/heevd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_heevd: +.. _onemath_lapack_heevd: heevd ===== @@ -87,7 +87,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_heevd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_heevd_scratchpad_size` function. .. container:: section @@ -111,17 +111,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -186,7 +186,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_heevd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_heevd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -212,17 +212,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -245,5 +245,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/heevd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst similarity index 74% rename from source/elements/oneMKL/source/domains/lapack/heevd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst index 4773f2bcb..b2ecdabd2 100644 --- a/source/elements/oneMKL/source/domains/lapack/heevd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_heevd_scratchpad_size: +.. _onemath_lapack_heevd_scratchpad_size: heevd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_heevd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_heevd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_heevd` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_heevd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_heevd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -45,7 +45,7 @@ heevd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_heevd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_heevd` function will be performed. jobz Must be ``job::novec`` or ``job::vec``. @@ -76,11 +76,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -89,8 +89,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_heevd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_heevd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hegvd.rst b/source/elements/oneMath/source/domains/lapack/hegvd.rst similarity index 90% rename from source/elements/oneMKL/source/domains/lapack/hegvd.rst rename to source/elements/oneMath/source/domains/lapack/hegvd.rst index f30af5811..1d745d89d 100644 --- a/source/elements/oneMKL/source/domains/lapack/hegvd.rst +++ b/source/elements/oneMath/source/domains/lapack/hegvd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hegvd: +.. _onemath_lapack_hegvd: hegvd ===== @@ -104,7 +104,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hegvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hegvd_scratchpad_size` function. .. container:: section @@ -142,17 +142,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -245,7 +245,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hegvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hegvd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -287,17 +287,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -329,5 +329,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hegvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst similarity index 79% rename from source/elements/oneMKL/source/domains/lapack/hegvd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst index bbf264698..270688ec7 100644 --- a/source/elements/oneMKL/source/domains/lapack/hegvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hegvd_scratchpad_size: +.. _onemath_lapack_hegvd_scratchpad_size: hegvd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_hegvd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_hegvd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_hegvd` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hegvd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hegvd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -45,7 +45,7 @@ hegvd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_hegvd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_hegvd` function will be performed. itype Must be 1 or 2 or 3. Specifies the problem type to be solved: @@ -90,11 +90,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -103,8 +103,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hegvd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hegvd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hetrd.rst b/source/elements/oneMath/source/domains/lapack/hetrd.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/hetrd.rst rename to source/elements/oneMath/source/domains/lapack/hetrd.rst index 71c354198..36394a796 100644 --- a/source/elements/oneMKL/source/domains/lapack/hetrd.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hetrd: +.. _onemath_lapack_hetrd: hetrd ===== @@ -75,7 +75,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hetrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hetrd_scratchpad_size` function. .. container:: section @@ -118,17 +118,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -179,7 +179,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hetrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hetrd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -225,17 +225,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -249,6 +249,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hetrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst similarity index 73% rename from source/elements/oneMKL/source/domains/lapack/hetrd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst index e44ca1813..87b3472b3 100644 --- a/source/elements/oneMKL/source/domains/lapack/hetrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hetrd_scratchpad_size: +.. _onemath_lapack_hetrd_scratchpad_size: hetrd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_hetrd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_hetrd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_hetrd` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hetrd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hetrd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -45,7 +45,7 @@ hetrd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_hetrd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_hetrd` function will be performed. upper_lower Must be ``uplo::upper`` or ``uplo::lower``. @@ -69,11 +69,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -82,8 +82,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hetrd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hetrd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hetrf.rst b/source/elements/oneMath/source/domains/lapack/hetrf.rst similarity index 88% rename from source/elements/oneMKL/source/domains/lapack/hetrf.rst rename to source/elements/oneMath/source/domains/lapack/hetrf.rst index 62ee3a399..bc0d333a6 100644 --- a/source/elements/oneMKL/source/domains/lapack/hetrf.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hetrf: +.. _onemath_lapack_hetrf: hetrf ===== @@ -78,7 +78,7 @@ scratchpad scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hetrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hetrf_scratchpad_size` function. .. container:: section @@ -100,17 +100,17 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -161,7 +161,7 @@ scratchpad scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_hetrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_hetrf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -186,17 +186,17 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -212,5 +212,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/hetrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/hetrf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst index 67ec1edbb..cc06fd911 100644 --- a/source/elements/oneMKL/source/domains/lapack/hetrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_hetrf_scratchpad_size: +.. _onemath_lapack_hetrf_scratchpad_size: hetrf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_hetrf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_hetrf` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_hetrf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hetrf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hetrf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. hetrf_scratchpad_size @@ -44,7 +44,7 @@ hetrf_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_hetrf` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_hetrf` function will be performed. upper_lower Indicates whether the upper or lower triangular part of :math:`A` is @@ -70,11 +70,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -83,7 +83,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_hetrf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_hetrf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/lapack-like-extensions.inc.rst b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst similarity index 67% rename from source/elements/oneMKL/source/domains/lapack/lapack-like-extensions.inc.rst rename to source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst index b3378b25b..38213aa1c 100644 --- a/source/elements/oneMKL/source/domains/lapack/lapack-like-extensions.inc.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack-like-extensions-routines: +.. _onemath_lapack-like-extensions-routines: LAPACK-like Extensions Routines =============================== @@ -26,29 +26,29 @@ LAPACK-like Extensions Routines * - Routines - Scratchpad Size Routines - Description - * - :ref:`onemkl_lapack_geqrf_batch` - - :ref:`onemkl_lapack_geqrf_batch_scratchpad_size` + * - :ref:`onemath_lapack_geqrf_batch` + - :ref:`onemath_lapack_geqrf_batch_scratchpad_size` - Computes the QR factorizations of a batch of general matrices. - * - :ref:`onemkl_lapack_getrf_batch` - - :ref:`onemkl_lapack_getrf_batch_scratchpad_size` + * - :ref:`onemath_lapack_getrf_batch` + - :ref:`onemath_lapack_getrf_batch_scratchpad_size` - Computes the LU factorizations of a batch of general matrices. - * - :ref:`onemkl_lapack_getri_batch` - - :ref:`onemkl_lapack_getri_batch_scratchpad_size` + * - :ref:`onemath_lapack_getri_batch` + - :ref:`onemath_lapack_getri_batch_scratchpad_size` - Computes the inverses of a batch of LU-factored general matrices. - * - :ref:`onemkl_lapack_getrs_batch` - - :ref:`onemkl_lapack_getrs_batch_scratchpad_size` + * - :ref:`onemath_lapack_getrs_batch` + - :ref:`onemath_lapack_getrs_batch_scratchpad_size` - Solves systems of linear equations with a batch of LU-factored square coefficient matrices, with multiple right-hand sides. - * - :ref:`onemkl_lapack_orgqr_batch` - - :ref:`onemkl_lapack_orgqr_batch_scratchpad_size` + * - :ref:`onemath_lapack_orgqr_batch` + - :ref:`onemath_lapack_orgqr_batch_scratchpad_size` - Generates the real orthogonal/complex unitary matrix :math:`Q_i` of the QR factorization formed by geqrf_batch. - * - :ref:`onemkl_lapack_potrf_batch` - - :ref:`onemkl_lapack_potrf_batch_scratchpad_size` + * - :ref:`onemath_lapack_potrf_batch` + - :ref:`onemath_lapack_potrf_batch_scratchpad_size` - Computes the Cholesky factorization of a batch of symmetric (Hermitian) positive-definite matrices. - * - :ref:`onemkl_lapack_potrs_batch` - - :ref:`onemkl_lapack_potrs_batch_scratchpad_size` + * - :ref:`onemath_lapack_potrs_batch` + - :ref:`onemath_lapack_potrs_batch_scratchpad_size` - Solves systems of linear equations with a batch of Cholesky-factored symmetric (Hermitian) positive-definite coefficient matrices, with multiple right-hand sides. - * - :ref:`onemkl_lapack_ungqr_batch` - - :ref:`onemkl_lapack_ungqr_batch_scratchpad_size` + * - :ref:`onemath_lapack_ungqr_batch` + - :ref:`onemath_lapack_ungqr_batch_scratchpad_size` - Generates the complex unitary matrix :math:`Q_i` with the QR factorization formed by geqrf_batch. diff --git a/source/elements/oneMKL/source/domains/lapack/lapack-linear-equation-routines.inc.rst b/source/elements/oneMath/source/domains/lapack/lapack-linear-equation-routines.inc.rst similarity index 62% rename from source/elements/oneMKL/source/domains/lapack/lapack-linear-equation-routines.inc.rst rename to source/elements/oneMath/source/domains/lapack/lapack-linear-equation-routines.inc.rst index 6e6c25574..7d34886ad 100644 --- a/source/elements/oneMKL/source/domains/lapack/lapack-linear-equation-routines.inc.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack-linear-equation-routines.inc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack-linear-equation-routines: +.. _onemath_lapack-linear-equation-routines: LAPACK Linear Equation Routines =============================== @@ -26,56 +26,56 @@ LAPACK Linear Equation Routines * - Routines - Scratchpad Size Routines - Description - * - :ref:`onemkl_lapack_geqrf` - - :ref:`onemkl_lapack_geqrf_scratchpad_size` + * - :ref:`onemath_lapack_geqrf` + - :ref:`onemath_lapack_geqrf_scratchpad_size` - Computes the QR factorization of a general m-by-n matrix. - * - :ref:`onemkl_lapack_gerqf` - - :ref:`onemkl_lapack_gerqf_scratchpad_size` + * - :ref:`onemath_lapack_gerqf` + - :ref:`onemath_lapack_gerqf_scratchpad_size` - Computes the RQ factorization of a general m-by-n matrix. - * - :ref:`onemkl_lapack_getrf` - - :ref:`onemkl_lapack_getrf_scratchpad_size` + * - :ref:`onemath_lapack_getrf` + - :ref:`onemath_lapack_getrf_scratchpad_size` - Computes the LU factorization of a general m-by-n matrix. - * - :ref:`onemkl_lapack_getri` - - :ref:`onemkl_lapack_getri_scratchpad_size` + * - :ref:`onemath_lapack_getri` + - :ref:`onemath_lapack_getri_scratchpad_size` - Computes the inverse of an LU-factored general matrix. - * - :ref:`onemkl_lapack_getrs` - - :ref:`onemkl_lapack_getrs_scratchpad_size` + * - :ref:`onemath_lapack_getrs` + - :ref:`onemath_lapack_getrs_scratchpad_size` - Solves a system of linear equations with an LU-factored square coefficient matrix, with multiple right-hand sides. - * - :ref:`onemkl_lapack_hetrf` - - :ref:`onemkl_lapack_hetrf_scratchpad_size` + * - :ref:`onemath_lapack_hetrf` + - :ref:`onemath_lapack_hetrf_scratchpad_size` - Computes the Bunch-Kaufman factorization of a complex Hermitian matrix. - * - :ref:`onemkl_lapack_orgqr` - - :ref:`onemkl_lapack_orgqr_scratchpad_size` + * - :ref:`onemath_lapack_orgqr` + - :ref:`onemath_lapack_orgqr_scratchpad_size` - Generates the real orthogonal matrix :math:`Q` of the QR factorization formed by geqrf. - * - :ref:`onemkl_lapack_ormqr` - - :ref:`onemkl_lapack_ormqr_scratchpad_size` + * - :ref:`onemath_lapack_ormqr` + - :ref:`onemath_lapack_ormqr_scratchpad_size` - Multiplies a real matrix by the orthogonal matrix :math:`Q` of the QR factorization formed by geqrf. - * - :ref:`onemkl_lapack_ormrq` - - :ref:`onemkl_lapack_ormrq_scratchpad_size` + * - :ref:`onemath_lapack_ormrq` + - :ref:`onemath_lapack_ormrq_scratchpad_size` - Multiplies a real matrix by the orthogonal matrix :math:`Q` of the RQ factorization formed by gerqf. - * - :ref:`onemkl_lapack_potrf` - - :ref:`onemkl_lapack_potrf_scratchpad_size` + * - :ref:`onemath_lapack_potrf` + - :ref:`onemath_lapack_potrf_scratchpad_size` - Computes the Cholesky factorization of a symmetric (Hermitian) positive-definite matrix. - * - :ref:`onemkl_lapack_potri` - - :ref:`onemkl_lapack_potri_scratchpad_size` + * - :ref:`onemath_lapack_potri` + - :ref:`onemath_lapack_potri_scratchpad_size` - Computes the inverse of a Cholesky-factored symmetric (Hermitian) positive-definite matrix. - * - :ref:`onemkl_lapack_potrs` - - :ref:`onemkl_lapack_potrs_scratchpad_size` + * - :ref:`onemath_lapack_potrs` + - :ref:`onemath_lapack_potrs_scratchpad_size` - Solves a system of linear equations with a Cholesky-factored symmetric (Hermitian) positive-definite coefficient matrix, with multiple right-hand sides. - * - :ref:`onemkl_lapack_sytrf` - - :ref:`onemkl_lapack_sytrf_scratchpad_size` + * - :ref:`onemath_lapack_sytrf` + - :ref:`onemath_lapack_sytrf_scratchpad_size` - Computes the Bunch-Kaufman factorization of a symmetric matrix. - * - :ref:`onemkl_lapack_trtrs` - - :ref:`onemkl_lapack_trtrs_scratchpad_size` + * - :ref:`onemath_lapack_trtrs` + - :ref:`onemath_lapack_trtrs_scratchpad_size` - Solves a system of linear equations with a triangular coefficient matrix, with multiple right-hand sides. - * - :ref:`onemkl_lapack_ungqr` - - :ref:`onemkl_lapack_ungqr_scratchpad_size` + * - :ref:`onemath_lapack_ungqr` + - :ref:`onemath_lapack_ungqr_scratchpad_size` - Generates the complex unitary matrix :math:`Q` of the QR factorization formed by geqrf. - * - :ref:`onemkl_lapack_unmqr` - - :ref:`onemkl_lapack_unmqr_scratchpad_size` + * - :ref:`onemath_lapack_unmqr` + - :ref:`onemath_lapack_unmqr_scratchpad_size` - Multiplies a complex matrix by the unitary matrix :math:`Q` of the QR factorization formed by geqrf. - * - :ref:`onemkl_lapack_unmrq` - - :ref:`onemkl_lapack_unmrq_scratchpad_size` + * - :ref:`onemath_lapack_unmrq` + - :ref:`onemath_lapack_unmrq_scratchpad_size` - Multiplies a complex matrix by the unitary matrix :math:`Q` of the RQ factorization formed by gerqf. diff --git a/source/elements/oneMKL/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst b/source/elements/oneMath/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst similarity index 63% rename from source/elements/oneMKL/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst rename to source/elements/oneMath/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst index bcf8c1af3..5e4a1e800 100644 --- a/source/elements/oneMKL/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack-singular-value-eigenvalue-routines.inc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack-singular-value-eigenvalue-routines: +.. _onemath_lapack-singular-value-eigenvalue-routines: LAPACK Singular Value and Eigenvalue Problem Routines ===================================================== @@ -26,47 +26,47 @@ LAPACK Singular Value and Eigenvalue Problem Routines * - Routines - Scratchpad Size Routines - Description - * - :ref:`onemkl_lapack_gebrd` - - :ref:`onemkl_lapack_gebrd_scratchpad_size` + * - :ref:`onemath_lapack_gebrd` + - :ref:`onemath_lapack_gebrd_scratchpad_size` - Reduces a general matrix to bidiagonal form. - * - :ref:`onemkl_lapack_gesvd` - - :ref:`onemkl_lapack_gesvd_scratchpad_size` + * - :ref:`onemath_lapack_gesvd` + - :ref:`onemath_lapack_gesvd_scratchpad_size` - Computes the singular value decomposition of a general rectangular matrix. - * - :ref:`onemkl_lapack_heevd` - - :ref:`onemkl_lapack_heevd_scratchpad_size` + * - :ref:`onemath_lapack_heevd` + - :ref:`onemath_lapack_heevd_scratchpad_size` - Computes all eigenvalues and, optionally, all eigenvectors of a complex Hermitian matrix using divide and conquer algorithm. - * - :ref:`onemkl_lapack_hegvd` - - :ref:`onemkl_lapack_hegvd_scratchpad_size` + * - :ref:`onemath_lapack_hegvd` + - :ref:`onemath_lapack_hegvd_scratchpad_size` - Computes all eigenvalues and, optionally, all eigenvectors of a complex generalized Hermitian definite eigenproblem using divide and conquer algorithm. - * - :ref:`onemkl_lapack_hetrd` - - :ref:`onemkl_lapack_hetrd_scratchpad_size` + * - :ref:`onemath_lapack_hetrd` + - :ref:`onemath_lapack_hetrd_scratchpad_size` - Reduces a complex Hermitian matrix to tridiagonal form. - * - :ref:`onemkl_lapack_orgbr` - - :ref:`onemkl_lapack_orgbr_scratchpad_size` + * - :ref:`onemath_lapack_orgbr` + - :ref:`onemath_lapack_orgbr_scratchpad_size` - Generates the real orthogonal matrix :math:`Q` or :math:`P^T` determined by gebrd. - * - :ref:`onemkl_lapack_orgtr` - - :ref:`onemkl_lapack_orgtr_scratchpad_size` + * - :ref:`onemath_lapack_orgtr` + - :ref:`onemath_lapack_orgtr_scratchpad_size` - Generates the real orthogonal matrix :math:`Q` determined by sytrd. - * - :ref:`onemkl_lapack_ormtr` - - :ref:`onemkl_lapack_ormtr_scratchpad_size` + * - :ref:`onemath_lapack_ormtr` + - :ref:`onemath_lapack_ormtr_scratchpad_size` - Multiplies a real matrix by the orthogonal matrix :math:`Q` determined by sytrd. - * - :ref:`onemkl_lapack_syevd` - - :ref:`onemkl_lapack_syevd_scratchpad_size` + * - :ref:`onemath_lapack_syevd` + - :ref:`onemath_lapack_syevd_scratchpad_size` - Computes all eigenvalues and, optionally, all eigenvectors of a real symmetric matrix using divide and conquer algorithm. - * - :ref:`onemkl_lapack_sygvd` - - :ref:`onemkl_lapack_sygvd_scratchpad_size` + * - :ref:`onemath_lapack_sygvd` + - :ref:`onemath_lapack_sygvd_scratchpad_size` - Computes all eigenvalues and, optionally, all eigenvectors of a real generalized symmetric definite eigenproblem using divide and conquer algorithm. - * - :ref:`onemkl_lapack_sytrd` - - :ref:`onemkl_lapack_sytrd_scratchpad_size` + * - :ref:`onemath_lapack_sytrd` + - :ref:`onemath_lapack_sytrd_scratchpad_size` - Reduces a real symmetric matrix to tridiagonal form. - * - :ref:`onemkl_lapack_ungbr` - - :ref:`onemkl_lapack_ungbr_scratchpad_size` + * - :ref:`onemath_lapack_ungbr` + - :ref:`onemath_lapack_ungbr_scratchpad_size` - Generates the complex unitary matrix :math:`Q` or :math:`P^T` determined by gebrd. - * - :ref:`onemkl_lapack_ungtr` - - :ref:`onemkl_lapack_ungtr_scratchpad_size` + * - :ref:`onemath_lapack_ungtr` + - :ref:`onemath_lapack_ungtr_scratchpad_size` - Generates the complex unitary matrix :math:`Q` determined by hetrd. - * - :ref:`onemkl_lapack_unmtr` - - :ref:`onemkl_lapack_unmtr_scratchpad_size` + * - :ref:`onemath_lapack_unmtr` + - :ref:`onemath_lapack_unmtr_scratchpad_size` - Multiplies a complex matrix by the unitary matrix :math:`Q` determined by hetrd. diff --git a/source/elements/oneMKL/source/domains/lapack/lapack.rst b/source/elements/oneMath/source/domains/lapack/lapack.rst similarity index 73% rename from source/elements/oneMKL/source/domains/lapack/lapack.rst rename to source/elements/oneMath/source/domains/lapack/lapack.rst index 77c730010..0e869da37 100644 --- a/source/elements/oneMKL/source/domains/lapack/lapack.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack: +.. _onemath_lapack: LAPACK Routines +++++++++++++++ -oneMKL provides a DPC++ interface to select routines from the Linear Algebra PACKage (LAPACK), as well as several LAPACK-like extension routines. +oneMath provides a DPC++ interface to select routines from the Linear Algebra PACKage (LAPACK), as well as several LAPACK-like extension routines. LAPACK routines require column major layout of matrices. .. include:: lapack-linear-equation-routines.inc.rst @@ -24,7 +24,7 @@ LAPACK routines require column major layout of matrices. :class: NoteTipHead - Different arrays used as parameters to oneMKL LAPACK routines must + Different arrays used as parameters to oneMath LAPACK routines must not overlap. @@ -41,4 +41,4 @@ LAPACK routines require column major layout of matrices. values may cause LAPACK to return unexpected results or become unstable. -**Parent topic:** :ref:`onemkl_dense_linear_algebra` +**Parent topic:** :ref:`onemath_dense_linear_algebra` diff --git a/source/elements/oneMKL/source/domains/lapack/orgbr.rst b/source/elements/oneMath/source/domains/lapack/orgbr.rst similarity index 81% rename from source/elements/oneMKL/source/domains/lapack/orgbr.rst rename to source/elements/oneMath/source/domains/lapack/orgbr.rst index 23d8a823b..15198232f 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgbr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgbr.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgbr: +.. _onemath_lapack_orgbr: orgbr ===== Generates the real orthogonal matrix :math:`Q` or :math:`P^{T}` determined by -:ref:`onemkl_lapack_gebrd`. +:ref:`onemath_lapack_gebrd`. ``orgbr`` supports the following precisions. @@ -25,7 +25,7 @@ determined by .. rubric:: Description The routine generates the whole or part of the orthogonal matrices -:math:`Q` and :math:`P^{T}` formed by the routines :ref:`onemkl_lapack_gebrd`. +:math:`Q` and :math:`P^{T}` formed by the routines :ref:`onemath_lapack_gebrd`. All valid combinations of arguments are described in *Input parameters*. In most cases you need the following: @@ -100,15 +100,15 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. a The buffer ``a`` as returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. @@ -116,12 +116,12 @@ lda tau Buffer, size :math:`\min(m,k)` if ``gen = generate::q``, size :math:`\min(n,k)` if ``gen = generate::p``. Scalar factor of the - elementary reflectors, as returned by :ref:`onemkl_lapack_gebrd` in the array tauq + elementary reflectors, as returned by :ref:`onemath_lapack_gebrd` in the array tauq or taup. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgbr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgbr_scratchpad_size` function. .. container:: section @@ -141,17 +141,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -202,15 +202,15 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. a Pointer to array ``a`` as returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. @@ -218,12 +218,12 @@ lda tau Pointer to array of size :math:`\min(m,k)` if ``gen = generate::q``, size :math:`\min(n,k)` if ``gen = generate::p``. Scalar factor of the - elementary reflectors, as returned by :ref:`onemkl_lapack_gebrd` in the array tauq + elementary reflectors, as returned by :ref:`onemath_lapack_gebrd` in the array tauq or taup. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgbr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgbr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -246,17 +246,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -270,5 +270,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgbr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/orgbr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst index 8acc30c79..64411939a 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgbr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgbr_scratchpad_size: +.. _onemath_lapack_orgbr_scratchpad_size: orgbr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgbr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_orgbr` function. ``orgbr_scratchpad_size`` supports the following precisions. @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgbr` funct .. rubric:: Description -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgbr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgbr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. orgbr_scratchpad_size @@ -44,7 +44,7 @@ orgbr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_orgbr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_orgbr` function will be performed. gen Must be ``generate::q`` or ``generate::p``. @@ -70,11 +70,11 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. @@ -85,11 +85,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -98,8 +98,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgbr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgbr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines`  +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines`  diff --git a/source/elements/oneMKL/source/domains/lapack/orgqr.rst b/source/elements/oneMath/source/domains/lapack/orgqr.rst similarity index 81% rename from source/elements/oneMKL/source/domains/lapack/orgqr.rst rename to source/elements/oneMath/source/domains/lapack/orgqr.rst index e8b57a816..e8addfaa2 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgqr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgqr: +.. _onemath_lapack_orgqr: orgqr ===== Generates the real orthogonal matrix :math:`Q` of the QR factorization formed -by :ref:`onemkl_lapack_geqrf`. +by :ref:`onemath_lapack_geqrf`. .. container:: section @@ -25,7 +25,7 @@ by :ref:`onemkl_lapack_geqrf`. The routine generates the whole or part of :math:`m \times m` orthogonal matrix :math:`Q` of the QR factorization formed by the routine -:ref:`onemkl_lapack_geqrf`. +:ref:`onemath_lapack_geqrf`. Usually :math:`Q` is determined from the QR factorization of an ``m`` by ``p`` matrix :math:`A` with :math:`m \ge p`. To compute the whole matrix @@ -89,18 +89,18 @@ k a The buffer ``a`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. lda The leading dimension of ``a`` (:math:`\text{lda} \le m`). tau The buffer ``tau`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgqr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgqr_scratchpad_size` function. .. container:: section @@ -119,17 +119,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -169,18 +169,18 @@ k a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. lda The leading dimension of ``a`` (:math:`\text{lda} \le m`). tau The pointer to ``tau`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgqr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgqr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -202,17 +202,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -226,6 +226,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgqr_batch.rst b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst similarity index 83% rename from source/elements/oneMKL/source/domains/lapack/orgqr_batch.rst rename to source/elements/oneMath/source/domains/lapack/orgqr_batch.rst index 5fcde539c..feb8c01ec 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgqr_batch: +.. _onemath_lapack_orgqr_batch: orgqr_batch =========== @@ -20,7 +20,7 @@ Generates the orthogonal/unitary matrix :math:`Q_i` of the QR factorizations for * - ``float`` * - ``double`` -.. _onemkl_lapack_orgqr_batch_buffer: +.. _onemath_lapack_orgqr_batch_buffer: orgqr_batch (Buffer Version) ---------------------------- @@ -31,7 +31,7 @@ The buffer version of ``orgqr_batch`` supports only the strided API. **Strided API** - | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_buffer` function. + | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Strided API of the :ref:`onemath_lapack_geqrf_batch_buffer` function. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math:`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``orgqr_batch(queue, m, m, p, a, ...)`` @@ -67,7 +67,7 @@ k Number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k \le n`). a - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_buffer` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_buffer` function. lda Leading dimension of :math:`A_i` (:math:`\text{lda} \le m`). @@ -76,7 +76,7 @@ stride_a The stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. tau - Array resulting from call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_buffer` function. + Array resulting from call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_buffer` function. stride_tau Stride between the beginnings of arrays :math:`\tau_i` inside the array ``tau``. @@ -88,7 +88,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_orgqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_orgqr_batch_scratchpad_size` function. .. container:: section @@ -103,13 +103,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -119,7 +119,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -.. _onemkl_lapack_orgqr_batch_usm: +.. _onemath_lapack_orgqr_batch_usm: orgqr_batch (USM Version) ------------------------- @@ -130,7 +130,7 @@ The USM version of ``orgqr_batch`` supports the group API and strided API. **Group API** - | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math:`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``orgqr_batch(queue, m, m, p, a, ...)`` @@ -164,16 +164,16 @@ n Array of ``group_count`` :math:`n_g` parameters as previously supplied to group version of geqrf_batch function. k - Array of ``group_count`` :math:`k_g` parameters as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. The number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k_g \le n_g`). + Array of ``group_count`` :math:`k_g` parameters as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. The number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k_g \le n_g`). a - Array resulting after call to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. lda - Array of leading dimensions of :math:`A_i` as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array of leading dimensions of :math:`A_i` as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. tau - Array resulting after call to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. group_count Number of groups of parameters. Must be at least 0. @@ -185,7 +185,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by Group API of the :ref:`onemkl_lapack_orgqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by Group API of the :ref:`onemath_lapack_orgqr_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -209,13 +209,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -228,7 +228,7 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** - | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + | The routine generates the wholes or parts of :math:`m \times n` orthogonal matrices :math:`Q_i` of the batch of QR factorizations formed by the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math:`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``orgqr_batch(queue, m, m, p, a, ...)`` @@ -264,7 +264,7 @@ k Number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k \le n`). a - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. lda Leading dimension of :math:`A_i` (:math:`\text{lda} \le m`). @@ -273,7 +273,7 @@ stride_a The stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. tau - Array resulting from call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting from call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. stride_tau Stride between the beginnings of arrays :math:`\tau_i` inside the array ``tau``. @@ -285,7 +285,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_orgqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_orgqr_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -309,13 +309,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -325,5 +325,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgqr_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/orgqr_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst index 0cde70684..13af3165a 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgqr_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgqr_batch_scratchpad_size: +.. _onemath_lapack_orgqr_batch_scratchpad_size: orgqr_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_orgqr_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_orgqr_batch` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_orgqr_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_orgqr_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_orgqr_batch` function. .. container:: section @@ -66,7 +66,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_orgqr_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_orgqr_batch` function. .. container:: section @@ -74,17 +74,17 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_orgqr_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_orgqr_batch` function. .. container:: section @@ -129,7 +129,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_orgqr_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_orgqr_batch` function. .. container:: section @@ -137,13 +137,13 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst similarity index 72% rename from source/elements/oneMKL/source/domains/lapack/orgqr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst index e62f4d4eb..b76b84f08 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgqr_scratchpad_size: +.. _onemath_lapack_orgqr_scratchpad_size: orgqr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgqr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_orgqr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgqr` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgqr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgqr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. orgqr_scratchpad_size @@ -44,7 +44,7 @@ orgqr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_orgqr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_orgqr` function will be performed. m The number of rows in the matrix :math:`A` (:math:`0 \le m`). @@ -65,11 +65,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -78,8 +78,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgqr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgqr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgtr.rst b/source/elements/oneMath/source/domains/lapack/orgtr.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/orgtr.rst rename to source/elements/oneMath/source/domains/lapack/orgtr.rst index 714c0ac87..5848e8a48 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgtr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgtr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgtr: +.. _onemath_lapack_orgtr: orgtr ===== Generates the real orthogonal matrix :math:`Q` determined by -:ref:`onemkl_lapack_sytrd`. +:ref:`onemath_lapack_sytrd`. .. container:: section @@ -24,10 +24,10 @@ Generates the real orthogonal matrix :math:`Q` determined by * - ``double`` The routine explicitly generates the :math:`n \times n` orthogonal matrix -:math:`Q` formed by :ref:`onemkl_lapack_sytrd` when +:math:`Q` formed by :ref:`onemath_lapack_sytrd` when reducing a real symmetric matrix :math:`A` to tridiagonal form: :math:`A = QTQ^T`. Use this routine after a call to -:ref:`onemkl_lapack_sytrd`. +:ref:`onemath_lapack_sytrd`. orgtr (Buffer Version) ---------------------- @@ -51,25 +51,25 @@ queue upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same - ``upper_lower`` as supplied to :ref:`onemkl_lapack_sytrd`. + ``upper_lower`` as supplied to :ref:`onemath_lapack_sytrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. a - The buffer ``a`` as returned by :ref:`onemkl_lapack_sytrd`. The + The buffer ``a`` as returned by :ref:`onemath_lapack_sytrd`. The second dimension of ``a`` must be at least :math:`\max(1,n)`. lda The leading dimension of ``a`` :math:`(n \le \text{lda})`. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_sytrd`. The + The buffer ``tau`` as returned by :ref:`onemath_lapack_sytrd`. The dimension of ``tau`` must be at least :math:`\max(1, n-1)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgtr_scratchpad_size` function. .. container:: section @@ -87,17 +87,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -128,26 +128,26 @@ queue upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied - to :ref:`onemkl_lapack_sytrd`. + to :ref:`onemath_lapack_sytrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_sytrd`. The + :ref:`onemath_lapack_sytrd`. The second dimension of ``a`` must be at least :math:`\max(1,n)`. lda The leading dimension of ``a`` :math:`(n \le \text{lda})`. tau - The pointer to ``tau`` as returned by :ref:`onemkl_lapack_sytrd`. The + The pointer to ``tau`` as returned by :ref:`onemath_lapack_sytrd`. The dimension of ``tau`` must be at least :math:`\max(1, n-1)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_orgtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_orgtr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -168,17 +168,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -192,5 +192,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/orgtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst similarity index 69% rename from source/elements/oneMKL/source/domains/lapack/orgtr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst index c2b238062..b9d355173 100644 --- a/source/elements/oneMKL/source/domains/lapack/orgtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_orgtr_scratchpad_size: +.. _onemath_lapack_orgtr_scratchpad_size: orgtr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgtr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_orgtr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_orgtr` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgtr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgtr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. orgtr_scratchpad_size @@ -44,11 +44,11 @@ orgtr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_orgtr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_orgtr` function will be performed. upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same - ``upper_lower`` as supplied to :ref:`onemkl_lapack_sytrd`. + ``upper_lower`` as supplied to :ref:`onemath_lapack_sytrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. @@ -62,11 +62,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -75,8 +75,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_orgtr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_orgtr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ormqr.rst b/source/elements/oneMath/source/domains/lapack/ormqr.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/ormqr.rst rename to source/elements/oneMath/source/domains/lapack/ormqr.rst index 31542c037..af9731f1b 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormqr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormqr: +.. _onemath_lapack_ormqr: ormqr ===== Multiplies a real matrix by the orthogonal matrix :math:`Q` of the QR -factorization formed by :ref:`onemkl_lapack_geqrf`. +factorization formed by :ref:`onemath_lapack_geqrf`. .. container:: section @@ -27,7 +27,7 @@ The routine multiplies a rectangular real :math:`m \times n` matrix :math:`C` by :math:`Q` or :math:`Q^T`, where :math:`Q` is the complex unitary matrix defined as a product of :math:`k` elementary reflectors :math:`H(i)` of order :math:`n`: :math:`Q = H(1)^TH(2)^T ... H(k)^T` as returned by the RQ factorization routine -:ref:`onemkl_lapack_gerqf`. +:ref:`onemath_lapack_gerqf`. Depending on the parameters ``side`` and ``trans``, the routine can form one of the matrix products :math:`QC`, :math:`Q^TC`, :math:`CQ`, or :math:`CQ^T` @@ -82,14 +82,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The buffer ``a`` as returned by :ref:`onemkl_lapack_geqrf`. + The buffer ``a`` as returned by :ref:`onemath_lapack_geqrf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_geqrf`. + The buffer ``tau`` as returned by :ref:`onemath_lapack_geqrf`. c The buffer ``c`` contains the matrix :math:`C`. The second dimension of @@ -101,7 +101,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the - :ref:`onemkl_lapack_ormqr_scratchpad_size` function. + :ref:`onemath_lapack_ormqr_scratchpad_size` function. .. container:: section @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -187,14 +187,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The pointer to ``a`` as returned by :ref:`onemkl_lapack_geqrf`. + The pointer to ``a`` as returned by :ref:`onemath_lapack_geqrf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The pointer to ``tau`` as returned by :ref:`onemkl_lapack_geqrf`. + The pointer to ``tau`` as returned by :ref:`onemath_lapack_geqrf`. c The pointer ``c`` points to the matrix :math:`C`. The second dimension of @@ -206,7 +206,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the - :ref:`onemkl_lapack_ormqr_scratchpad_size` function. + :ref:`onemath_lapack_ormqr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -252,4 +252,4 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ormqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst similarity index 77% rename from source/elements/oneMKL/source/domains/lapack/ormqr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst index 5a53434a1..800dff35b 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormqr_scratchpad_size: +.. _onemath_lapack_ormqr_scratchpad_size: ormqr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormqr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ormqr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormqr` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormqr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormqr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. ormqr_scratchpad_size @@ -44,7 +44,7 @@ ormqr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_ormqr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_ormqr` function will be performed. side If ``side=oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is @@ -82,11 +82,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -95,8 +95,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormqr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormqr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines`  +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines`  diff --git a/source/elements/oneMKL/source/domains/lapack/ormrq.rst b/source/elements/oneMath/source/domains/lapack/ormrq.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/ormrq.rst rename to source/elements/oneMath/source/domains/lapack/ormrq.rst index f7bfcce21..3b1175abf 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormrq.rst +++ b/source/elements/oneMath/source/domains/lapack/ormrq.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormrq: +.. _onemath_lapack_ormrq: ormrq ===== Multiplies a real matrix by the orthogonal matrix :math:`Q` of the RQ -factorization formed by :ref:`onemkl_lapack_gerqf`. +factorization formed by :ref:`onemath_lapack_gerqf`. .. container:: section @@ -27,7 +27,7 @@ The routine multiplies a rectangular real :math:`m \times n` matrix :math:`C` by :math:`Q` or :math:`Q^T`, where :math:`Q` is the complex unitary matrix defined as a product of :math:`k` elementary reflectors :math:`H(i)` of order :math:`n`: :math:`Q = H(1)^TH(2)^T ... H(k)^T` as returned by the RQ factorization routine -:ref:`onemkl_lapack_gerqf`. +:ref:`onemath_lapack_gerqf`. Depending on the parameters ``side`` and ``trans``, the routine can form one of the matrix products :math:`QC`, :math:`Q^TC`, :math:`CQ`, or :math:`CQ^T` @@ -82,14 +82,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The buffer ``a`` as returned by :ref:`onemkl_lapack_gerqf`. + The buffer ``a`` as returned by :ref:`onemath_lapack_gerqf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_gerqf`. + The buffer ``tau`` as returned by :ref:`onemath_lapack_gerqf`. c The buffer ``c`` contains the matrix :math:`C`. The second dimension of @@ -101,7 +101,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the - :ref:`onemkl_lapack_ormrq_scratchpad_size` function. + :ref:`onemath_lapack_ormrq_scratchpad_size` function. .. container:: section @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -187,14 +187,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The pointer to ``a`` as returned by :ref:`onemkl_lapack_gerqf`. + The pointer to ``a`` as returned by :ref:`onemath_lapack_gerqf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The pointer to ``tau`` as returned by :ref:`onemkl_lapack_gerqf`. + The pointer to ``tau`` as returned by :ref:`onemath_lapack_gerqf`. c The pointer ``c`` points to the matrix :math:`C`. The second dimension of @@ -206,7 +206,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the - :ref:`onemkl_lapack_ormrq_scratchpad_size` function. + :ref:`onemath_lapack_ormrq_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -252,5 +252,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ormrq_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/ormrq_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst index f0ce238e7..8bfc8d171 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormrq_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormrq_scratchpad_size: +.. _onemath_lapack_ormrq_scratchpad_size: ormrq_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormrq` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ormrq` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormrq` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormrq` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormrq` function should be able to hold. Calls to this routine must specify the template parameter explicitly. ormrq_scratchpad_size @@ -77,11 +77,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -90,7 +90,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormrq` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormrq` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ormtr.rst b/source/elements/oneMath/source/domains/lapack/ormtr.rst similarity index 81% rename from source/elements/oneMKL/source/domains/lapack/ormtr.rst rename to source/elements/oneMath/source/domains/lapack/ormtr.rst index babd3b380..7cc62a27a 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormtr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormtr: +.. _onemath_lapack_ormtr: ormtr ===== Multiplies a real matrix by the real orthogonal matrix :math:`Q` determined by -:ref:`onemkl_lapack_sytrd`. +:ref:`onemath_lapack_sytrd`. .. container:: section @@ -24,9 +24,9 @@ Multiplies a real matrix by the real orthogonal matrix :math:`Q` determined by * - ``double`` The routine multiplies a real matrix :math:`C` by :math:`Q` or :math:`Q^{T}`, -where :math:`Q` is the orthogonal matrix :math:`Q` formed by:ref:`onemkl_lapack_sytrd` +where :math:`Q` is the orthogonal matrix :math:`Q` formed by:ref:`onemath_lapack_sytrd` when reducing a real symmetric matrix :math:`A` to tridiagonal form: -:math:`A = QTQ^T`. Use this routine after a call to :ref:`onemkl_lapack_sytrd`. +:math:`A = QTQ^T`. Use this routine after a call to :ref:`onemath_lapack_sytrd`. Depending on the parameters side and trans, the routine can form one of the matrix products :math:`QC`, :math:`Q^TC`, :math:`CQ`, or @@ -76,7 +76,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_sytrd`. + :ref:`onemath_lapack_sytrd`. trans Must be either ``transpose::nontrans`` or ``transpose::trans``. @@ -94,13 +94,13 @@ n The number of columns in the matrix :math:`C` :math:`(n \ge 0)`. a - The buffer ``a`` as returned by :ref:`onemkl_lapack_sytrd`. + The buffer ``a`` as returned by :ref:`onemath_lapack_sytrd`. lda The leading dimension of ``a`` :math:`(\max(1, r) \le \text{lda})`. tau - The buffer ``tau`` as returned by a :ref:`onemkl_lapack_sytrd`. The + The buffer ``tau`` as returned by a :ref:`onemath_lapack_sytrd`. The dimension of ``tau`` must be at least :math:`\max(1, r-1)`. c @@ -112,7 +112,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ormtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ormtr_scratchpad_size` function. .. container:: section @@ -131,17 +131,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -192,7 +192,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same - ``upper_lower`` as supplied to :ref:`onemkl_lapack_sytrd`. + ``upper_lower`` as supplied to :ref:`onemath_lapack_sytrd`. trans Must be either ``transpose::nontrans`` or ``transpose::trans``. @@ -210,13 +210,13 @@ n The number of columns in the matrix :math:`C` :math:`(n \ge 0)`. a - The pointer to ``a`` as returned by :ref:`onemkl_lapack_sytrd`. + The pointer to ``a`` as returned by :ref:`onemath_lapack_sytrd`. lda The leading dimension of ``a`` :math:`(\max(1, r) \le \text{lda})`. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_sytrd`. The + The buffer ``tau`` as returned by :ref:`onemath_lapack_sytrd`. The dimension of ``tau`` must be at least :math:`\max(1, r-1)`. c @@ -228,7 +228,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ormtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ormtr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -250,17 +250,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -274,5 +274,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ormtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst similarity index 79% rename from source/elements/oneMKL/source/domains/lapack/ormtr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst index 788949d30..2812979b1 100644 --- a/source/elements/oneMKL/source/domains/lapack/ormtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ormtr_scratchpad_size: +.. _onemath_lapack_ormtr_scratchpad_size: ormtr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormtr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ormtr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ormtr` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormtr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormtr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -57,7 +57,7 @@ In the descriptions below, ``r`` denotes the order of :math:`Q`: - if ``side = side::right`` queue - Device queue where calculations by :ref:`onemkl_lapack_ormtr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_ormtr` function will be performed. side Must be either ``side::left`` or ``side::right``. @@ -71,7 +71,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_sytrd`. + :ref:`onemath_lapack_sytrd`. trans Must be either ``transpose::nontrans`` or ``transpose::trans``. @@ -100,11 +100,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -113,8 +113,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ormtr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ormtr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrf.rst b/source/elements/oneMath/source/domains/lapack/potrf.rst similarity index 86% rename from source/elements/oneMKL/source/domains/lapack/potrf.rst rename to source/elements/oneMath/source/domains/lapack/potrf.rst index ac69f1328..d767e14e6 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrf.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrf: +.. _onemath_lapack_potrf: potrf ===== @@ -86,7 +86,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potrf_scratchpad_size` function. .. container:: section @@ -105,17 +105,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -174,7 +174,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potrf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -196,17 +196,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -225,6 +225,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrf_batch.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst similarity index 90% rename from source/elements/oneMKL/source/domains/lapack/potrf_batch.rst rename to source/elements/oneMath/source/domains/lapack/potrf_batch.rst index eb1135399..4c85e636d 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrf_batch: +.. _onemath_lapack_potrf_batch: potrf_batch =========== @@ -24,7 +24,7 @@ Computes the LU factorizations of a batch of general matrices. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_potrf_batch_buffer: +.. _onemath_lapack_potrf_batch_buffer: potrf_batch (Buffer Version) ---------------------------- @@ -83,7 +83,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_potrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_potrf_batch_scratchpad_size` function. .. container:: section @@ -98,13 +98,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -116,7 +116,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then the leading minors of some of matrices (and therefore some matrices :math:`A_i` themselves) are not positive-definite, and the factorizations could not be completed for these matrices from the batch. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The orders of corresponding not positive-definite leading minors of these matrices can be obtained by `exceptions()` method of exception object. -.. _onemkl_lapack_potrf_batch_usm: +.. _onemath_lapack_potrf_batch_usm: potrf_batch (USM Version) ------------------------- @@ -175,7 +175,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemkl_lapack_potrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemath_lapack_potrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -200,13 +200,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -266,7 +266,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_potrf_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_potrf_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -290,13 +290,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -308,5 +308,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then the leading minors of some of matrices (and therefore some matrices :math:`A_i` themselves) are not positive-definite, and the factorizations could not be completed for these matrices from the batch. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The orders of corresponding not positive-definite leading minors of these matrices can be obtained by `exceptions()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/potrf_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst index dc4d4a36a..78cfdd674 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrf_batch_scratchpad_size: +.. _onemath_lapack_potrf_batch_scratchpad_size: potrf_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_potrf_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_potrf_batch` function. .. container:: section @@ -26,7 +26,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_potrf_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_potrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_potrf_batch` function. .. container:: section @@ -70,7 +70,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_potrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_potrf_batch` function. .. container:: section @@ -78,18 +78,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_potrf_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_potrf_batch` function. .. container:: section @@ -129,7 +129,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_potrf_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_potrf_batch` function. .. container:: section @@ -137,14 +137,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst similarity index 76% rename from source/elements/oneMKL/source/domains/lapack/potrf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst index 4da1de83d..51c13ff0a 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrf_scratchpad_size: +.. _onemath_lapack_potrf_scratchpad_size: potrf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_potrf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_potrf` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_potrf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potrf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potrf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. potrf_scratchpad_size @@ -46,7 +46,7 @@ potrf_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_potrf` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_potrf` function will be performed. upper_lower Indicates whether the upper or lower triangular part of :math:`A` is @@ -72,11 +72,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -85,8 +85,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potrf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potrf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potri.rst b/source/elements/oneMath/source/domains/lapack/potri.rst similarity index 79% rename from source/elements/oneMKL/source/domains/lapack/potri.rst rename to source/elements/oneMath/source/domains/lapack/potri.rst index 377c39088..0ab50cc13 100644 --- a/source/elements/oneMKL/source/domains/lapack/potri.rst +++ b/source/elements/oneMath/source/domains/lapack/potri.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potri: +.. _onemath_lapack_potri: potri ===== @@ -27,7 +27,7 @@ matrix using the Cholesky factorization. The routine computes the inverse :math:`A^{-1}` of a symmetric positive definite or, for complex flavors, Hermitian positive-definite matrix -:math:`A`. Before calling this routine, call :ref:`onemkl_lapack_potrf` +:math:`A`. Before calling this routine, call :ref:`onemath_lapack_potrf` to factorize :math:`A`. potri (Buffer Version) @@ -61,14 +61,14 @@ n Specifies the order of the matrix :math:`A` (:math:`0 \le n`). a - Contains the factorization of the matrix :math:`A`, as returned by :ref:`onemkl_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. + Contains the factorization of the matrix :math:`A`, as returned by :ref:`onemath_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda The leading dimension of ``a``. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potri_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potri_scratchpad_size` function. .. container:: section @@ -86,17 +86,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -138,14 +138,14 @@ n Specifies the order of the matrix :math:`A` (:math:`0 \le n`). a - Contains the factorization of the matrix :math:`A`, as returned by :ref:`onemkl_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. + Contains the factorization of the matrix :math:`A`, as returned by :ref:`onemath_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda The leading dimension of ``a``. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potri_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potri_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -166,17 +166,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -193,6 +193,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potri_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst similarity index 73% rename from source/elements/oneMKL/source/domains/lapack/potri_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst index 1dbd9f2d0..b9417de56 100644 --- a/source/elements/oneMKL/source/domains/lapack/potri_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potri_scratchpad_size: +.. _onemath_lapack_potri_scratchpad_size: potri_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_potri` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_potri` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_potri` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potri` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potri` function should be able to hold. Calls to this routine must specify the template parameter explicitly. potri_scratchpad_size @@ -46,7 +46,7 @@ potri_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_potri` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_potri` function will be performed. upper_lower Indicates how the input matrix :math:`A` has been factored: @@ -67,11 +67,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -80,7 +80,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potri` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potri` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrs.rst b/source/elements/oneMath/source/domains/lapack/potrs.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/potrs.rst rename to source/elements/oneMath/source/domains/lapack/potrs.rst index c88db1df7..539597ca6 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrs.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrs: +.. _onemath_lapack_potrs: potrs ===== @@ -42,7 +42,7 @@ where :math:`L` is a lower triangular matrix and :math:`U` is upper triangular. The system is solved with multiple right-hand sides stored in the columns of the matrix :math:`B`. -Before calling this routine, you must call :ref:`onemkl_lapack_potrf` to compute +Before calling this routine, you must call :ref:`onemath_lapack_potrf` to compute the Cholesky factorization of :math:`A`. potrs (Buffer Version) @@ -79,7 +79,7 @@ nrhs The number of right-hand sides (:math:`0 \le \text{nrhs}`). a - Buffer containing the factorization of the matrix A, as returned by :ref:`onemkl_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. + Buffer containing the factorization of the matrix A, as returned by :ref:`onemath_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda The leading dimension of ``a``. @@ -92,7 +92,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potrs_scratchpad_size` function. .. container:: section @@ -110,17 +110,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -164,7 +164,7 @@ nrhs The number of right-hand sides (:math:`0 \le \text{nrhs}`). a - Pointer to array containing the factorization of the matrix :math:`A`, as returned by :ref:`onemkl_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. + Pointer to array containing the factorization of the matrix :math:`A`, as returned by :ref:`onemath_lapack_potrf`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda The leading dimension of ``a``. @@ -177,7 +177,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_potrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_potrs_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -198,17 +198,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -224,6 +224,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrs_batch.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/potrs_batch.rst rename to source/elements/oneMath/source/domains/lapack/potrs_batch.rst index ba8e2aea8..bd4959456 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrs_batch: +.. _onemath_lapack_potrs_batch: potrs_batch =========== @@ -24,7 +24,7 @@ Computes the LU factorizations of a batch of general matrices. * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_potrs_batch_buffer: +.. _onemath_lapack_potrs_batch_buffer: potrs_batch (Buffer Version) ---------------------------- @@ -42,7 +42,7 @@ The buffer version of ``potrs_batch`` supports only the strided API. | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. - | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemkl_lapack_potrf_batch_buffer` function. + | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_buffer` function. .. container:: section @@ -73,7 +73,7 @@ nrhs The number of right-hand sides (:math:`0 \le \text{nrhs}`). a - Array containing batch of factorizations of the matrices :math:`A_i`, as returned by the Strided API of the :ref:`onemkl_lapack_potrf_batch_buffer` function. + Array containing batch of factorizations of the matrices :math:`A_i`, as returned by the Strided API of the :ref:`onemath_lapack_potrf_batch_buffer` function. lda Leading dimension of :math:`A_i`. @@ -97,7 +97,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_potrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_potrs_batch_scratchpad_size` function. .. container:: section @@ -112,13 +112,13 @@ b This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -130,7 +130,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then for some of the matrices diagonal element of the Cholesky factor is zero, and the solve could not be completed. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these matrices can be obtained by `exceptions()` method of exception object. -.. _onemkl_lapack_potrs_batch_usm: +.. _onemath_lapack_potrs_batch_usm: potrs_batch (USM Version) ------------------------- @@ -175,7 +175,7 @@ nrhs | Each :math:`\text{nrhs}_g` specifies the number of right-hand sides supplied for group :math:`g` in corresponding part of array ``b``. a - Array of ``batch_size`` pointers to Cholesky factored matrices :math:`A_i` as returned by the Group API of the :ref:`onemkl_lapack_potrf_batch_usm` function. + Array of ``batch_size`` pointers to Cholesky factored matrices :math:`A_i` as returned by the Group API of the :ref:`onemath_lapack_potrf_batch_usm` function. lda | Array of ``group_count`` :math:`\text{lda}_g` parameters. @@ -198,7 +198,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemkl_lapack_potrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Group API of the :ref:`onemath_lapack_potrs_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -222,13 +222,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -247,7 +247,7 @@ This routine shall throw the following exceptions if the associated condition is | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. - | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemkl_lapack_potrf_batch_usm` function. + | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_usm` function. .. container:: section @@ -278,7 +278,7 @@ nrhs The number of right-hand sides (:math:`0 \le nrhs`). a - Array containing batch of factorizations of the matrices :math:`A_i`, as returned by the Strided API of the :ref:`onemkl_lapack_potrf_batch_usm` function. + Array containing batch of factorizations of the matrices :math:`A_i`, as returned by the Strided API of the :ref:`onemath_lapack_potrf_batch_usm` function. lda Leading dimension of :math:`A_i`. @@ -302,7 +302,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemkl_lapack_potrs_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by the Strided API of the :ref:`onemath_lapack_potrs_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -326,13 +326,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by `info()` method of exception object: @@ -344,5 +344,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is zero, then for some of the matrices diagonal element of the Cholesky factor is zero, and the solve could not be completed. The indices of such matrices in the batch can be obtained with `ids()` method of the exception object. The indices of first zero diagonal elements in these matrices can be obtained by `exceptions()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst similarity index 84% rename from source/elements/oneMKL/source/domains/lapack/potrs_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst index 9fd078915..2e4c51801 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrs_batch_scratchpad_size: +.. _onemath_lapack_potrs_batch_scratchpad_size: potrs_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_potrs_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_potrs_batch` function. .. container:: section @@ -26,7 +26,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_potrs_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_potrs_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_potrs_batch` function. .. container:: section @@ -77,7 +77,7 @@ group_sizes Array of group_count integers. Array element with index :math:`g` sp .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_potrs_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_potrs_batch` function. .. container:: section @@ -85,18 +85,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_potrs_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_potrs_batch` function. .. container:: section @@ -145,7 +145,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_potrs_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_potrs_batch` function. .. container:: section @@ -153,14 +153,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/potrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst similarity index 76% rename from source/elements/oneMKL/source/domains/lapack/potrs_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst index 99e0553cf..5128926ab 100644 --- a/source/elements/oneMKL/source/domains/lapack/potrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_potrs_scratchpad_size: +.. _onemath_lapack_potrs_scratchpad_size: potrs_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_potrs` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_potrs` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_potrs` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potrs` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potrs` function should be able to hold. Calls to this routine must specify the template parameter explicitly. potrs_scratchpad_size @@ -46,7 +46,7 @@ potrs_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_potrs` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_potrs` function will be performed. upper_lower Indicates how the input matrix has been factored: @@ -73,11 +73,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -86,7 +86,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_potrs` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_potrs` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/syevd.rst b/source/elements/oneMath/source/domains/lapack/syevd.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/syevd.rst rename to source/elements/oneMath/source/domains/lapack/syevd.rst index 6d02e8c01..fb1378815 100644 --- a/source/elements/oneMKL/source/domains/lapack/syevd.rst +++ b/source/elements/oneMath/source/domains/lapack/syevd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_syevd: +.. _onemath_lapack_syevd: syevd ===== @@ -87,7 +87,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_syevd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_syevd_scratchpad_size` function. .. container:: section @@ -111,17 +111,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -187,7 +187,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_syevd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_syevd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -214,17 +214,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -247,6 +247,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/syevd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/syevd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst index c4338d4dd..39a47569c 100644 --- a/source/elements/oneMKL/source/domains/lapack/syevd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_syevd_scratchpad_size: +.. _onemath_lapack_syevd_scratchpad_size: syevd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_syevd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_syevd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_syevd` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_syevd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_syevd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. syevd_scratchpad_size @@ -44,7 +44,7 @@ syevd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_syevd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_syevd` function will be performed. jobz Must be ``job::novec`` or ``job::vec``. @@ -76,11 +76,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -89,8 +89,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_syevd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_syevd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sygvd.rst b/source/elements/oneMath/source/domains/lapack/sygvd.rst similarity index 90% rename from source/elements/oneMKL/source/domains/lapack/sygvd.rst rename to source/elements/oneMath/source/domains/lapack/sygvd.rst index 84a0f503c..c1b84399d 100644 --- a/source/elements/oneMKL/source/domains/lapack/sygvd.rst +++ b/source/elements/oneMath/source/domains/lapack/sygvd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sygvd: +.. _onemath_lapack_sygvd: sygvd ===== @@ -102,7 +102,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sygvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sygvd_scratchpad_size` function. .. container:: section @@ -141,17 +141,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -245,7 +245,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sygvd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sygvd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -287,17 +287,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -330,6 +330,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sygvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst similarity index 78% rename from source/elements/oneMKL/source/domains/lapack/sygvd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst index 15556a212..05b5f5682 100644 --- a/source/elements/oneMKL/source/domains/lapack/sygvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sygvd_scratchpad_size: +.. _onemath_lapack_sygvd_scratchpad_size: sygvd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_sygvd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_sygvd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_sygvd` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sygvd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sygvd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. sygvd_scratchpad_size @@ -44,7 +44,7 @@ sygvd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_sygvd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_sygvd` function will be performed. itype Must be 1 or 2 or 3. Specifies the problem type to be solved: @@ -87,11 +87,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -100,8 +100,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sygvd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sygvd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sytrd.rst b/source/elements/oneMath/source/domains/lapack/sytrd.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/sytrd.rst rename to source/elements/oneMath/source/domains/lapack/sytrd.rst index f2df9bdfb..0d1edb2e0 100644 --- a/source/elements/oneMKL/source/domains/lapack/sytrd.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sytrd: +.. _onemath_lapack_sytrd: sytrd ===== @@ -72,7 +72,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sytrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sytrd_scratchpad_size` function. .. container:: section @@ -116,17 +116,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -177,7 +177,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sytrd_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sytrd_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -224,17 +224,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -248,6 +248,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sytrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst similarity index 72% rename from source/elements/oneMKL/source/domains/lapack/sytrd_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst index e0f089bcb..5c5d781bf 100644 --- a/source/elements/oneMKL/source/domains/lapack/sytrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sytrd_scratchpad_size: +.. _onemath_lapack_sytrd_scratchpad_size: sytrd_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_sytrd` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_sytrd` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_sytrd` funct * - ``float`` * - ``double`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sytrd` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sytrd` function should be able to hold. Calls to this routine must specify the template parameter explicitly. sytrd_scratchpad_size @@ -44,7 +44,7 @@ sytrd_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_sytrd` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_sytrd` function will be performed. upper_lower Must be ``uplo::upper`` or ``uplo::lower``. @@ -67,11 +67,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -80,8 +80,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sytrd` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sytrd` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sytrf.rst b/source/elements/oneMath/source/domains/lapack/sytrf.rst similarity index 88% rename from source/elements/oneMKL/source/domains/lapack/sytrf.rst rename to source/elements/oneMath/source/domains/lapack/sytrf.rst index f303f49b4..c80b1c2b3 100644 --- a/source/elements/oneMKL/source/domains/lapack/sytrf.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sytrf: +.. _onemath_lapack_sytrf: sytrf ===== @@ -77,7 +77,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sytrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sytrf_scratchpad_size` function. .. container:: section @@ -102,17 +102,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -160,7 +160,7 @@ lda scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_sytrf_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_sytrf_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -188,17 +188,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -214,5 +214,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/sytrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/sytrf_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst index 2bd5c7faa..06a224ff8 100644 --- a/source/elements/oneMKL/source/domains/lapack/sytrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_sytrf_scratchpad_size: +.. _onemath_lapack_sytrf_scratchpad_size: sytrf_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_sytrf` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_sytrf` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_sytrf` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sytrf` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sytrf` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -47,7 +47,7 @@ sytrf_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_sytrf` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_sytrf` function will be performed. upper_lower Indicates whether the upper or lower triangular part of :math:`A` is @@ -73,11 +73,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -86,7 +86,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_sytrf` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_sytrf` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/trtrs.rst b/source/elements/oneMath/source/domains/lapack/trtrs.rst similarity index 87% rename from source/elements/oneMKL/source/domains/lapack/trtrs.rst rename to source/elements/oneMath/source/domains/lapack/trtrs.rst index 5da920501..cb0e89ead 100644 --- a/source/elements/oneMKL/source/domains/lapack/trtrs.rst +++ b/source/elements/oneMath/source/domains/lapack/trtrs.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_trtrs: +.. _onemath_lapack_trtrs: trtrs ===== @@ -101,7 +101,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_trtrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_trtrs_scratchpad_size` function. .. container:: section @@ -119,17 +119,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -196,7 +196,7 @@ ldb scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_trtrs_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_trtrs_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -217,17 +217,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -241,5 +241,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/trtrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/trtrs_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst index 38674d990..7ff6d333c 100644 --- a/source/elements/oneMKL/source/domains/lapack/trtrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_trtrs_scratchpad_size: +.. _onemath_lapack_trtrs_scratchpad_size: trtrs_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_trtrs` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_trtrs` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_trtrs` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_trtrs` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_trtrs` function should be able to hold. Calls to this routine must specify the template parameter explicitly. trtrs_scratchpad_size @@ -46,7 +46,7 @@ trtrs_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_trtrs` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_trtrs` function will be performed. upper_lower Indicates whether :math:`A` is upper or lower triangular: @@ -90,11 +90,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -103,7 +103,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_trtrs` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_trtrs` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungbr.rst b/source/elements/oneMath/source/domains/lapack/ungbr.rst similarity index 83% rename from source/elements/oneMKL/source/domains/lapack/ungbr.rst rename to source/elements/oneMath/source/domains/lapack/ungbr.rst index 25b3c7b3a..ee5f45a61 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungbr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungbr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungbr: +.. _onemath_lapack_ungbr: ungbr ===== Generates the complex unitary matrix :math:`Q` or :math:`P^{t}` determined by -:ref:`onemkl_lapack_gebrd`. +:ref:`onemath_lapack_gebrd`. .. container:: section @@ -25,7 +25,7 @@ Generates the complex unitary matrix :math:`Q` or :math:`P^{t}` determined by The routine generates the whole or part of the unitary matrices :math:`Q` and :math:`P^{H}` formed by the routines -:ref:`onemkl_lapack_gebrd`. +:ref:`onemath_lapack_gebrd`. All valid combinations of arguments are described in *Input Parameters*; in most cases you need the following: @@ -100,22 +100,22 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. a The buffer ``a`` as returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. tau - For ``gen = generate::q``, the array ``tauq`` as returned by :ref:`onemkl_lapack_gebrd`. - For ``gen = generate::p``, the array ``taup`` as returned by :ref:`onemkl_lapack_gebrd`. + For ``gen = generate::q``, the array ``tauq`` as returned by :ref:`onemath_lapack_gebrd`. + For ``gen = generate::p``, the array ``taup`` as returned by :ref:`onemath_lapack_gebrd`. The dimension of ``tau`` must be at least :math:`\max(1, \min(m, k))` for ``gen = generate::q``, or :math:`\max(1, \min(m, k))` for @@ -123,7 +123,7 @@ tau scratchpad_size Size of scratchpad memory as a number of floating point elements of type :math:`T`. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungbr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungbr_scratchpad_size` function. .. container:: section @@ -143,17 +143,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -204,22 +204,22 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. tau - For ``gen = generate::q``, the array ``tauq`` as returned by :ref:`onemkl_lapack_gebrd`. - For ``gen = generate::p``, the array ``taup`` as returned by :ref:`onemkl_lapack_gebrd`. + For ``gen = generate::q``, the array ``tauq`` as returned by :ref:`onemath_lapack_gebrd`. + For ``gen = generate::p``, the array ``taup`` as returned by :ref:`onemath_lapack_gebrd`. The dimension of ``tau`` must be at least :math:`\max(1, \min(m, k))` for ``gen = generate::q``, or :math:`\max(1, \min(m, k))` for @@ -227,7 +227,7 @@ tau scratchpad_size Size of scratchpad memory as a number of floating point elements of type :math:`T`. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungbr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungbr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -250,17 +250,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -274,6 +274,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungbr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst similarity index 75% rename from source/elements/oneMKL/source/domains/lapack/ungbr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst index 1b96bc59e..b46eedae9 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungbr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungbr_scratchpad_size: +.. _onemath_lapack_ungbr_scratchpad_size: ungbr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungbr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ungbr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungbr` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type :math:`T` the scratchpad memory to be passed to :ref:`onemkl_lapack_ungbr` function should be able to hold. +Computes the number of elements of type :math:`T` the scratchpad memory to be passed to :ref:`onemath_lapack_ungbr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. ungbr_scratchpad_size @@ -44,7 +44,7 @@ ungbr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_ungbr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_ungbr` function will be performed. gen Must be ``generate::q`` or ``generate::p``. @@ -70,11 +70,11 @@ n k If ``gen = generate::q``, the number of columns in the original :math:`m \times k` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. If ``gen = generate::p``, the number of rows in the original :math:`k \times n` matrix reduced by - :ref:`onemkl_lapack_gebrd`. + :ref:`onemath_lapack_gebrd`. lda The leading dimension of ``a``. @@ -85,11 +85,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -98,8 +98,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ungbr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ungbr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungqr.rst b/source/elements/oneMath/source/domains/lapack/ungqr.rst similarity index 81% rename from source/elements/oneMKL/source/domains/lapack/ungqr.rst rename to source/elements/oneMath/source/domains/lapack/ungqr.rst index b46366379..2a6c629d1 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungqr: +.. _onemath_lapack_ungqr: ungqr ===== Generates the complex unitary matrix :math:`Q` of the QR factorization formed -by :ref:`onemkl_lapack_geqrf`. +by :ref:`onemath_lapack_geqrf`. .. container:: section @@ -25,7 +25,7 @@ by :ref:`onemkl_lapack_geqrf`. The routine generates the whole or part of :math:`m \times m` unitary matrix :math:`Q` of the QR factorization formed by the routines -:ref:`onemkl_lapack_geqrf`. +:ref:`onemath_lapack_geqrf`. Usually :math:`Q` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A` with :math:`m \ge p`. To compute the whole matrix :math:`Q`, use: @@ -88,18 +88,18 @@ k a The buffer ``a`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. lda The leading dimension of ``a`` (:math:`\text{lda} \le m`). tau The buffer ``tau`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungqr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungqr_scratchpad_size` function. .. container:: section @@ -118,17 +118,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -168,18 +168,18 @@ k a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. lda The leading dimension of ``a`` (:math:`\text{lda} \le m`). tau The pointer to ``tau`` as returned by - :ref:`onemkl_lapack_geqrf`. + :ref:`onemath_lapack_geqrf`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungqr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungqr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -201,17 +201,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -225,5 +225,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungqr_batch.rst b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst similarity index 83% rename from source/elements/oneMKL/source/domains/lapack/ungqr_batch.rst rename to source/elements/oneMath/source/domains/lapack/ungqr_batch.rst index 78388521f..678b98e28 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungqr_batch: +.. _onemath_lapack_ungqr_batch: ungqr_batch =========== -Generates the complex unitary matrices :math:`Q_i` of the batch of QR factorizations formed by the :ref:`onemkl_lapack_geqrf_batch` function. +Generates the complex unitary matrices :math:`Q_i` of the batch of QR factorizations formed by the :ref:`onemath_lapack_geqrf_batch` function. .. container:: section @@ -22,7 +22,7 @@ Generates the complex unitary matrices :math:`Q_i` of the batch of QR factorizat * - ``std::complex`` * - ``std::complex`` -.. _onemkl_lapack_ungqr_batch_buffer: +.. _onemath_lapack_ungqr_batch_buffer: ungqr_batch (Buffer Version) ---------------------------- @@ -35,7 +35,7 @@ The buffer version of ``ungqr_batch`` supports only the strided API. **Strided API** - | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_buffer`. + | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Strided API of the :ref:`onemath_lapack_geqrf_batch_buffer`. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``ungqr_batch(queue, m, m, p, a, ...)`` @@ -73,7 +73,7 @@ k Number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k \le n`). a - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. lda Leading dimension of :math:`A_i` (:math:`\text{lda} \le m`). @@ -82,7 +82,7 @@ stride_a Stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. tau - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. stride_tau Stride between the beginnings of arrays :math:`tau_i` inside the array ``tau``. @@ -94,7 +94,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by strided version of the Strided API of the :ref:`onemkl_lapack_ungqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by strided version of the Strided API of the :ref:`onemath_lapack_ungqr_batch_scratchpad_size` function. .. container:: section @@ -109,13 +109,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by info() method of exception object: @@ -125,7 +125,7 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -.. _onemkl_lapack_ungqr_batch_usm: +.. _onemath_lapack_ungqr_batch_usm: ungqr_batch (USM Version) ------------------------- @@ -138,7 +138,7 @@ The USM version of ``ungqr_batch`` supports the group API and strided API. **Group API** - | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Group API of the :ref:`onemkl_lapack_geqrf_batch_buffer`. + | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Group API of the :ref:`onemath_lapack_geqrf_batch_buffer`. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``ungqr_batch(queue, m, m, p, a, ...)`` @@ -167,23 +167,23 @@ queue Device queue where calculations will be performed. m - Array of ``group_count`` :math:`m_g` parameters as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array of ``group_count`` :math:`m_g` parameters as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. n - Array of ``group_count`` :math:`n_g` parameters as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array of ``group_count`` :math:`n_g` parameters as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. k - | Array of ``group_count`` :math:`k_g` parameters as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + | Array of ``group_count`` :math:`k_g` parameters as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. | The number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k_g \le n_g`). a - Array resulting after call to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. lda - Array of leading dimensions of :math:`A_i` as previously supplied to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array of leading dimensions of :math:`A_i` as previously supplied to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. tau - Array resulting after call to the Group API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Group API of the :ref:`onemath_lapack_geqrf_batch_usm` function. group_count Number of groups of parameters. Must be at least 0. @@ -195,7 +195,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by Group API of the :ref:`onemkl_lapack_ungqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by Group API of the :ref:`onemath_lapack_ungqr_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -219,13 +219,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -236,7 +236,7 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** - | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm`. + | The routine generates the wholes or parts of :math`m \times m` unitary matrices :math:`Q_i` of the batch of QR factorization formed by the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm`. | Usually :math:`Q_i` is determined from the QR factorization of an :math:`m \times p` matrix :math:`A_i` with :math`m \ge p`. | To compute the whole matrices :math:`Q_i`, use: | ``ungqr_batch(queue, m, m, p, a, ...)`` @@ -274,7 +274,7 @@ k Number of elementary reflectors whose product defines the matrices :math:`Q_i` (:math:`0 \le k \le n`). a - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. lda Leading dimension of :math:`A_i` (:math:`\text{lda} \le m`). @@ -283,7 +283,7 @@ stride_a Stride between the beginnings of matrices :math:`A_i` inside the batch array ``a``. tau - Array resulting after call to the Strided API of the :ref:`onemkl_lapack_geqrf_batch_usm` function. + Array resulting after call to the Strided API of the :ref:`onemath_lapack_geqrf_batch_usm` function. stride_tau Stride between the beginnings of arrays :math:`tau_i` inside the array ``tau``. @@ -295,7 +295,7 @@ scratchpad Scratchpad memory to be used by routine for storing intermediate results. scratchpad_size - Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by strided version of the Strided API of the :ref:`onemkl_lapack_ungqr_batch_scratchpad_size` function. + Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less then the value returned by strided version of the Strided API of the :ref:`onemath_lapack_ungqr_batch_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -319,13 +319,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::mkl::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -335,5 +335,5 @@ This routine shall throw the following exceptions if the associated condition is If ``info`` is not zero and `detail()` returns zero, then there were some errors for some of the problems in the supplied batch and ``info`` code contains the number of failed calculations in a batch. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungqr_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/ungqr_batch_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst index dbc9c6acd..4804aab09 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungqr_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungqr_batch_scratchpad_size: +.. _onemath_lapack_ungqr_batch_scratchpad_size: ungqr_batch_scratchpad_size =========================== -Computes size of scratchpad memory required for the :ref:`onemkl_lapack_ungqr_batch` function. +Computes size of scratchpad memory required for the :ref:`onemath_lapack_ungqr_batch` function. .. container:: section @@ -24,7 +24,7 @@ Computes size of scratchpad memory required for the :ref:`onemkl_lapack_ungqr_ba **Group API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_ungqr_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_ungqr_batch` function. .. container:: section @@ -67,7 +67,7 @@ group_sizes .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemkl_lapack_ungqr_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Group API of the :ref:`onemath_lapack_ungqr_batch` function. .. container:: section @@ -75,18 +75,18 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. **Strided API** -Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_ungqr_batch` function. +Computes the number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_ungqr_batch` function. .. container:: section @@ -132,7 +132,7 @@ batch_size .. rubric:: Return Values -Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemkl_lapack_ungqr_batch` function. +Number of elements of type ``T`` the scratchpad memory should able to hold to be passed to the Strided API of the :ref:`onemath_lapack_ungqr_batch` function. .. container:: section @@ -140,14 +140,14 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. -**Parent topic:** :ref:`onemkl_lapack-like-extensions-routines` +**Parent topic:** :ref:`onemath_lapack-like-extensions-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst similarity index 72% rename from source/elements/oneMKL/source/domains/lapack/ungqr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst index 2433f00d0..a15baeb1d 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungqr_scratchpad_size: +.. _onemath_lapack_ungqr_scratchpad_size: ungqr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungqr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ungqr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungqr` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ungqr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ungqr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. ungqr_scratchpad_size @@ -44,7 +44,7 @@ ungqr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_ungqr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_ungqr` function will be performed. m The number of rows in the matrix :math:`A` (:math:`0 \le m`). @@ -65,11 +65,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -78,8 +78,8 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ungqr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ungqr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines`  +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines`  diff --git a/source/elements/oneMKL/source/domains/lapack/ungtr.rst b/source/elements/oneMath/source/domains/lapack/ungtr.rst similarity index 77% rename from source/elements/oneMKL/source/domains/lapack/ungtr.rst rename to source/elements/oneMath/source/domains/lapack/ungtr.rst index 0f1caaf6a..6f784e7f4 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungtr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungtr: +.. _onemath_lapack_ungtr: ungtr ===== Generates the complex unitary matrix :math:`Q` determined by -:ref:`onemkl_lapack_hetrd`. +:ref:`onemath_lapack_hetrd`. .. container:: section @@ -24,10 +24,10 @@ Generates the complex unitary matrix :math:`Q` determined by * - ``std::complex`` The routine explicitly generates the :math:`n \times n` unitary matrix -:math:`Q` formed by :ref:`onemkl_lapack_hetrd` when +:math:`Q` formed by :ref:`onemath_lapack_hetrd` when reducing a complex Hermitian matrix :math:`A` to tridiagonal form: :math:`A = QTQ^H`. Use this routine after a call to -:ref:`onemkl_lapack_hetrd`. +:ref:`onemath_lapack_hetrd`. ungtr (Buffer Version) ---------------------- @@ -52,14 +52,14 @@ queue upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. a The buffer ``a`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda @@ -67,12 +67,12 @@ lda tau The buffer ``tau`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The dimension of ``tau`` must be at least :math:`\max(1, n-1)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungtr_scratchpad_size` function. .. container:: section @@ -90,17 +90,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -131,14 +131,14 @@ queue upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The second dimension of ``a`` must be at least :math:`\max(1, n)`. lda @@ -146,12 +146,12 @@ lda tau The pointer to ``tau`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The dimension of ``tau`` must be at least :math:`\max(1, n-1)`. scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_ungtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_ungtr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -172,17 +172,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -196,6 +196,6 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/ungtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst similarity index 70% rename from source/elements/oneMKL/source/domains/lapack/ungtr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst index 9eb3f6bb3..d0a091a6d 100644 --- a/source/elements/oneMKL/source/domains/lapack/ungtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_ungtr_scratchpad_size: +.. _onemath_lapack_ungtr_scratchpad_size: ungtr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungtr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_ungtr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_ungtr` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_ungtr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_ungtr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. ungtr_scratchpad_size @@ -44,12 +44,12 @@ ungtr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_ungtr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_ungtr` function will be performed. upper_lower Must be ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. n The order of the matrix :math:`Q` :math:`(0 \le n)`. @@ -63,11 +63,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -76,7 +76,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type T the scratchpad memory to be passed to :ref:`onemkl_lapack_ungtr` function should be able to hold. +The number of elements of type T the scratchpad memory to be passed to :ref:`onemath_lapack_ungtr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmqr.rst b/source/elements/oneMath/source/domains/lapack/unmqr.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/unmqr.rst rename to source/elements/oneMath/source/domains/lapack/unmqr.rst index 801d03c99..82599102c 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmqr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmqr.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmqr: +.. _onemath_lapack_unmqr: unmqr ===== Multiplies a complex matrix by the unitary matrix :math:`Q` of the QR -factorization formed by :ref:`onemkl_lapack_geqrf`. +factorization formed by :ref:`onemath_lapack_geqrf`. .. container:: section @@ -27,7 +27,7 @@ The routine multiplies a rectangular complex :math:`m \times n` matrix :math:`C` :math:`Q` or :math:`Q^H`, where :math:`Q` is the complex unitary matrix defined as a product of :math:`k` elementary reflectors :math:`H(i)` of order :math:`n`: :math:`Q = H(1)^HH(2)^H ... H(k)^H` as returned by the RQ factorization routine -:ref:`onemkl_lapack_gerqf`. +:ref:`onemath_lapack_gerqf`. Depending on the parameters ``side`` and ``trans``, the routine can form one of the matrix products :math:`QC`, :math:`Q^HC`, :math:`CQ`, or :math:`CQ^H` @@ -82,14 +82,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The buffer ``a`` as returned by :ref:`onemkl_lapack_geqrf`. + The buffer ``a`` as returned by :ref:`onemath_lapack_geqrf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_geqrf`. + The buffer ``tau`` as returned by :ref:`onemath_lapack_geqrf`. c The buffer ``c`` contains the matrix :math:`C`. The second dimension of @@ -101,7 +101,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by the - :ref:`onemkl_lapack_unmqr_scratchpad_size` function. + :ref:`onemath_lapack_unmqr_scratchpad_size` function. .. container:: section @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -187,14 +187,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The pointer to ``a`` as returned by :ref:`onemkl_lapack_geqrf`. + The pointer to ``a`` as returned by :ref:`onemath_lapack_geqrf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The pointer to ``tau`` as returned by :ref:`onemkl_lapack_geqrf`. + The pointer to ``tau`` as returned by :ref:`onemath_lapack_geqrf`. c The pointer ``c`` points to the matrix :math:`C`. The second dimension of @@ -206,7 +206,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by - :ref:`onemkl_lapack_unmqr_scratchpad_size` function. + :ref:`onemath_lapack_unmqr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -252,4 +252,4 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst similarity index 77% rename from source/elements/oneMKL/source/domains/lapack/unmqr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst index 81b97e4cc..49112c811 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmqr_scratchpad_size: +.. _onemath_lapack_unmqr_scratchpad_size: unmqr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmqr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_unmqr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmqr` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmqr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmqr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. @@ -45,7 +45,7 @@ unmqr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_unmqr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_unmqr` function will be performed. side If ``side=oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is @@ -83,11 +83,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -96,7 +96,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmqr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmqr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmrq.rst b/source/elements/oneMath/source/domains/lapack/unmrq.rst similarity index 82% rename from source/elements/oneMKL/source/domains/lapack/unmrq.rst rename to source/elements/oneMath/source/domains/lapack/unmrq.rst index 3ce96d337..9815e045b 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmrq.rst +++ b/source/elements/oneMath/source/domains/lapack/unmrq.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmrq: +.. _onemath_lapack_unmrq: unmrq ===== Multiplies a complex matrix by the unitary matrix :math:`Q` of the RQ -factorization formed by :ref:`onemkl_lapack_gerqf`. +factorization formed by :ref:`onemath_lapack_gerqf`. .. container:: section @@ -27,7 +27,7 @@ The routine multiplies a rectangular complex :math:`m \times n` matrix :math:`C` :math:`Q` or :math:`Q^H`, where :math:`Q` is the complex unitary matrix defined as a product of :math:`k` elementary reflectors :math:`H(i)` of order :math:`n`: :math:`Q = H(1)^HH(2)^H ... H(k)^H` as returned by the RQ factorization routine -:ref:`onemkl_lapack_gerqf`. +:ref:`onemath_lapack_gerqf`. Depending on the parameters ``side`` and ``trans``, the routine can form one of the matrix products :math:`QC`, :math:`Q^HC`, :math:`CQ`, or :math:`CQ^H` @@ -82,14 +82,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The buffer ``a`` as returned by :ref:`onemkl_lapack_gerqf`. + The buffer ``a`` as returned by :ref:`onemath_lapack_gerqf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The buffer ``tau`` as returned by :ref:`onemkl_lapack_gerqf`. + The buffer ``tau`` as returned by :ref:`onemath_lapack_gerqf`. c The buffer ``c`` contains the matrix :math:`C`. The second dimension of @@ -101,7 +101,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by - :ref:`onemkl_lapack_unmrq_scratchpad_size` function. + :ref:`onemath_lapack_unmrq_scratchpad_size` function. .. container:: section @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -187,14 +187,14 @@ k If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` a - The pointer to ``a`` as returned by :ref:`onemkl_lapack_gerqf`. + The pointer to ``a`` as returned by :ref:`onemath_lapack_gerqf`. The second dimension of ``a`` must be at least :math:`\max(1,k)`. lda The leading dimension of ``a``. tau - The pointer to ``tau`` as returned by :ref:`onemkl_lapack_gerqf`. + The pointer to ``tau`` as returned by :ref:`onemath_lapack_gerqf`. c The pointer ``c`` points to the matrix :math:`C`. The second dimension of @@ -206,7 +206,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. Size should not be less than the value returned by - :ref:`onemkl_lapack_unmrq_scratchpad_size` function. + :ref:`onemath_lapack_unmrq_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -252,4 +252,4 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmrq_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst similarity index 80% rename from source/elements/oneMKL/source/domains/lapack/unmrq_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst index 644de58c9..63ecc9ffd 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmrq_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmrq_scratchpad_size: +.. _onemath_lapack_unmrq_scratchpad_size: unmrq_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmrq` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_unmrq` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmrq` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmrq` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmrq` function should be able to hold. Calls to this routine must specify the template parameter explicitly. unmrq_scratchpad_size @@ -75,11 +75,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -88,7 +88,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmrq` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmrq` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-linear-equation-routines` +**Parent topic:** :ref:`onemath_lapack-linear-equation-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmtr.rst b/source/elements/oneMath/source/domains/lapack/unmtr.rst similarity index 84% rename from source/elements/oneMKL/source/domains/lapack/unmtr.rst rename to source/elements/oneMath/source/domains/lapack/unmtr.rst index 6f8bee7b3..5c4939b02 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmtr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmtr.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmtr: +.. _onemath_lapack_unmtr: unmtr ===== Multiplies a complex matrix by the complex unitary matrix Q determined by -:ref:`onemkl_lapack_hetrd`. +:ref:`onemath_lapack_hetrd`. .. container:: section @@ -26,10 +26,10 @@ determined by The routine multiplies a complex matrix :math:`C` by :math:`Q` or :math:`Q^{H}`, where :math:`Q` is the unitary matrix :math:`Q` formed by -:ref:`onemkl_lapack_hetrd` +:ref:`onemath_lapack_hetrd` when reducing a complex Hermitian matrix :math:`A` to tridiagonal form: :math:`A = QTQ^H`. Use this routine after a call to -:ref:`onemkl_lapack_hetrd`. +:ref:`onemath_lapack_hetrd`. Depending on the parameters ``side`` and ``trans``, the routine can form one of the matrix products :math:`QC`, :math:`Q^{H}C`, @@ -79,7 +79,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. trans Must be either ``transpose::nontrans`` or @@ -103,14 +103,14 @@ k a The buffer ``a`` as returned by - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. lda The leading dimension of ``a`` :math:`(\max(1,r) \le \text{lda})`. tau The buffer ``tau`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The dimension of ``tau`` must be at least :math:`\max(1,r-1)`. c @@ -122,7 +122,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_unmtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_unmtr_scratchpad_size` function. .. container:: section @@ -142,17 +142,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -204,7 +204,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. trans Must be either ``transpose::nontrans`` or @@ -228,14 +228,14 @@ k a The pointer to ``a`` as returned by - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. lda The leading dimension of ``a`` :math:`(\max(1,r) \le \text{lda})`. tau The pointer to ``tau`` as returned by - :ref:`onemkl_lapack_hetrd`. The + :ref:`onemath_lapack_hetrd`. The dimension of ``tau`` must be at least :math:`\max(1,r-1)`. c @@ -247,7 +247,7 @@ ldc scratchpad_size Size of scratchpad memory as a number of floating point elements of type ``T``. - Size should not be less than the value returned by :ref:`onemkl_lapack_unmtr_scratchpad_size` function. + Size should not be less than the value returned by :ref:`onemath_lapack_unmtr_scratchpad_size` function. events List of events to wait for before starting computation. Defaults to empty list. @@ -270,17 +270,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::mkl::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::mkl::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::mkl::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -294,5 +294,5 @@ This routine shall throw the following exceptions if the associated condition is Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/lapack/unmtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst similarity index 78% rename from source/elements/oneMKL/source/domains/lapack/unmtr_scratchpad_size.rst rename to source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst index 1d784911d..f3ab16b64 100644 --- a/source/elements/oneMKL/source/domains/lapack/unmtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_lapack_unmtr_scratchpad_size: +.. _onemath_lapack_unmtr_scratchpad_size: unmtr_scratchpad_size ===================== -Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmtr` function. +Computes size of scratchpad memory required for :ref:`onemath_lapack_unmtr` function. .. container:: section @@ -22,7 +22,7 @@ Computes size of scratchpad memory required for :ref:`onemkl_lapack_unmtr` funct * - ``std::complex`` * - ``std::complex`` -Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmtr` function should be able to hold. +Computes the number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmtr` function should be able to hold. Calls to this routine must specify the template parameter explicitly. unmtr_scratchpad_size @@ -44,7 +44,7 @@ unmtr_scratchpad_size .. rubric:: Input Parameters queue - Device queue where calculations by :ref:`onemkl_lapack_unmtr` function will be performed. + Device queue where calculations by :ref:`onemath_lapack_unmtr` function will be performed. side Must be either ``side::left`` or ``side::right``. @@ -58,7 +58,7 @@ side upper_lower Must be either ``uplo::upper`` or ``uplo::lower``. Uses the same ``upper_lower`` as supplied to - :ref:`onemkl_lapack_hetrd`. + :ref:`onemath_lapack_hetrd`. trans Must be either ``transpose::nontrans`` or @@ -92,11 +92,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::mkl::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::mkl::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::mkl::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -105,7 +105,7 @@ This routine shall throw the following exceptions if the associated condition is .. rubric:: Return Value -The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemkl_lapack_unmtr` function should be able to hold. +The number of elements of type ``T`` the scratchpad memory to be passed to :ref:`onemath_lapack_unmtr` function should be able to hold. -**Parent topic:** :ref:`onemkl_lapack-singular-value-eigenvalue-routines` +**Parent topic:** :ref:`onemath_lapack-singular-value-eigenvalue-routines` diff --git a/source/elements/oneMKL/source/domains/matrix-storage.rst b/source/elements/oneMath/source/domains/matrix-storage.rst similarity index 99% rename from source/elements/oneMKL/source/domains/matrix-storage.rst rename to source/elements/oneMath/source/domains/matrix-storage.rst index edd660f6f..0a854a7dc 100644 --- a/source/elements/oneMKL/source/domains/matrix-storage.rst +++ b/source/elements/oneMath/source/domains/matrix-storage.rst @@ -11,7 +11,7 @@ Matrix Storage .. container:: - The oneMKL BLAS and LAPACK routines for DPC++ use several matrix and + The oneMath BLAS and LAPACK routines for DPC++ use several matrix and vector storage formats. These are the same formats used in traditional Fortran BLAS/LAPACK. LAPACK routines require column major layout. @@ -582,5 +582,5 @@ Matrix Storage }_\text{1 + (1-n) x incx}] \quad if \:incx \:< \:0 - **Parent topic:** :ref:`onemkl_dense_linear_algebra` + **Parent topic:** :ref:`onemath_dense_linear_algebra` diff --git a/source/elements/oneMKL/source/domains/random_number_generators.inc.rst b/source/elements/oneMath/source/domains/random_number_generators.inc.rst similarity index 53% rename from source/elements/oneMKL/source/domains/random_number_generators.inc.rst rename to source/elements/oneMath/source/domains/random_number_generators.inc.rst index 736cb4bab..e316dc3fd 100644 --- a/source/elements/oneMKL/source/domains/random_number_generators.inc.rst +++ b/source/elements/oneMath/source/domains/random_number_generators.inc.rst @@ -2,16 +2,16 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng: +.. _onemath_rng: Random Number Generators ------------------------- -The oneAPI Math Kernel Library Random Number Generators provides a :ref:`set of routines ` implementing commonly -used :ref:`pseudorandom, quasi-random, and non-deterministic generators ` -with :ref:`continuous and discrete distributions `. +The oneAPI Math Kernel Library Random Number Generators provides a :ref:`set of routines ` implementing commonly +used :ref:`pseudorandom, quasi-random, and non-deterministic generators ` +with :ref:`continuous and discrete distributions `. .. toctree:: :hidden: - rng/onemkl-rng-overview.rst \ No newline at end of file + rng/onemath-rng-overview.rst \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/rng/bibliography.rst b/source/elements/oneMath/source/domains/rng/bibliography.rst similarity index 99% rename from source/elements/oneMKL/source/domains/rng/bibliography.rst rename to source/elements/oneMath/source/domains/rng/bibliography.rst index be608650f..7c5840595 100644 --- a/source/elements/oneMKL/source/domains/rng/bibliography.rst +++ b/source/elements/oneMath/source/domains/rng/bibliography.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_bibliography: +.. _onemath_rng_bibliography: Bibliography ============ diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-distributions-template-parameter-method.rst b/source/elements/oneMath/source/domains/rng/device_api/device-distributions-template-parameter-method.rst similarity index 97% rename from source/elements/oneMKL/source/domains/rng/device_api/device-distributions-template-parameter-method.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-distributions-template-parameter-method.rst index 8414a5809..88a2e2b13 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-distributions-template-parameter-method.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-distributions-template-parameter-method.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_distributions_method: +.. _onemath_device_rng_distributions_method: Distributions Template Parameter Method ======================================= diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-distributions.rst b/source/elements/oneMath/source/domains/rng/device_api/device-distributions.rst similarity index 77% rename from source/elements/oneMKL/source/domains/rng/device_api/device-distributions.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-distributions.rst index cf7e8d20d..5f81b79f8 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-distributions.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-distributions.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_distributions: +.. _onemath_device_rng_distributions: Device Distributions ==================== -oneMKL RNG routines are used to generate random numbers with different types of distributions. Each function group is +oneMath RNG routines are used to generate random numbers with different types of distributions. Each function group is introduced below by the type of underlying distribution and contains a short description of its functionality, as well as specifications of the call sequence and the explanation of input and output parameters. The Device Continuous Distribution Generators table and Device Discrete Distribution Generators table mention random number generator routines @@ -23,27 +23,27 @@ basic random number generators. - Data Types - BRNG Data Type - Description - * - :ref:`onemkl_device_rng_uniform_continuous` + * - :ref:`onemath_device_rng_uniform_continuous` - float, double - float, double - Uniform continuous distribution on the interval [``a,b``) - * - :ref:`onemkl_device_rng_gaussian` + * - :ref:`onemath_device_rng_gaussian` - float, double - float, double - Normal (Gaussian) distribution - * - :ref:`onemkl_device_rng_exponential` + * - :ref:`onemath_device_rng_exponential` - float, double - float, double - Exponential distribution - * - :ref:`onemkl_device_rng_lognormal` + * - :ref:`onemath_device_rng_lognormal` - float, double - float, double - Lognormal distribution - * - :ref:`onemkl_device_rng_beta` + * - :ref:`onemath_device_rng_beta` - float, double - float, double - Beta distribution - * - :ref:`onemkl_device_rng_gamma` + * - :ref:`onemath_device_rng_gamma` - float, double - float, double - Gamma distribution @@ -58,30 +58,30 @@ basic random number generators. - Data Types - BRNG Data Type - Description - * - :ref:`onemkl_device_rng_uniform_discrete` + * - :ref:`onemath_device_rng_uniform_discrete` - integer - float - Uniform discrete distribution on the interval [``a,b``) - * - :ref:`onemkl_device_rng_bits` + * - :ref:`onemath_device_rng_bits` - integer - integer - Bits of underlying BRNG integer sequence - * - :ref:`onemkl_device_rng_uniform_bits` + * - :ref:`onemath_device_rng_uniform_bits` - integer - integer - Uniformly distributed bits in 32/64-bit chunks - * - :ref:`onemkl_device_rng_poisson` + * - :ref:`onemath_device_rng_poisson` - integer - integer - Poisson distribution - * - :ref:`onemkl_device_rng_bernoulli` + * - :ref:`onemath_device_rng_bernoulli` - integer - integer - Bernoulli distribution `NOTE:` In case of ``integer`` check desired distribution for supported data types. -**Parent topic:** :ref:`onemkl_device_rng_routines` +**Parent topic:** :ref:`onemath_device_rng_routines` .. toctree:: :maxdepth: 1 diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-engines.rst b/source/elements/oneMath/source/domains/rng/device_api/device-engines.rst similarity index 64% rename from source/elements/oneMKL/source/domains/rng/device_api/device-engines.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-engines.rst index 794f089f5..91aa55a3f 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-engines.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-engines.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_engines: +.. _onemath_device_rng_engines: Device Engines (Basic Random Number Generators) =============================================== -oneMKL RNG provides following device pseudorandom number generators: +oneMath RNG provides following device pseudorandom number generators: .. tabularcolumns:: |\Y{0.4}|\Y{0.6}| @@ -18,19 +18,19 @@ oneMKL RNG provides following device pseudorandom number generators: * - Routine - Description - * - :ref:`onemkl_device_rng_mrg32k3a` - - The combined multiple recursive pseudorandom number generator ``MRG32k3a`` [:ref:`L'Ecuyer99 `] + * - :ref:`onemath_device_rng_mrg32k3a` + - The combined multiple recursive pseudorandom number generator ``MRG32k3a`` [:ref:`L'Ecuyer99 `] - * - :ref:`onemkl_device_rng_philox4x32x10` - - Philox4x32-10 counter-based pseudorandom number generator with a period of :math:`2^{128}` ``PHILOX4X32X10`` [:ref:`Salmon11 `] + * - :ref:`onemath_device_rng_philox4x32x10` + - Philox4x32-10 counter-based pseudorandom number generator with a period of :math:`2^{128}` ``PHILOX4X32X10`` [:ref:`Salmon11 `] - * - :ref:`onemkl_device_rng_mcg31m1` - - The 31-bit multiplicative congruential pseudorandom number generator MCG(:math:`1132489760, 2^{32}-1`) :ref:`[L'Ecuyer99a] `. + * - :ref:`onemath_device_rng_mcg31m1` + - The 31-bit multiplicative congruential pseudorandom number generator MCG(:math:`1132489760, 2^{32}-1`) :ref:`[L'Ecuyer99a] `. - * - :ref:`onemkl_device_rng_mcg59` - - The 59-bit multiplicative congruential pseudorandom number generator MCG(:math:`13^{13}, 2^{59}`) from NAG Numerical Libraries :ref:`[NAG] `. + * - :ref:`onemath_device_rng_mcg59` + - The 59-bit multiplicative congruential pseudorandom number generator MCG(:math:`13^{13}, 2^{59}`) from NAG Numerical Libraries :ref:`[NAG] `. -**Parent topic:** :ref:`onemkl_device_rng_routines` +**Parent topic:** :ref:`onemath_device_rng_routines` .. toctree:: :maxdepth: 1 diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst similarity index 95% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-bernoulli.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst index 12697e31e..fbebb0a4d 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-bernoulli.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_bernoulli: +.. _onemath_device_rng_bernoulli: bernoulli ========= @@ -82,7 +82,7 @@ class bernoulli * ``oneapi::mkl::rng::bernoulli_method::by_default`` * ``oneapi::mkl::rng::bernoulli_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -185,5 +185,5 @@ class bernoulli Returns the distribution parameter `p` - probability. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-beta.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst similarity index 98% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-beta.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst index d17a39d26..c3e7004bd 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-beta.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_beta: +.. _onemath_device_rng_beta: beta ==== @@ -244,4 +244,4 @@ class beta Returns the amount of random numbers that were rejected during the last ``generate`` function call. If no ``generate`` calls, ``0`` is returned. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-bits.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst similarity index 86% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-bits.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst index bee0775dd..9a9ff35f7 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-bits.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_bits: +.. _onemath_device_rng_bits: bits ==== @@ -13,7 +13,7 @@ Generates bits of underlying engine (BRNG) integer sequence. The ``bits`` class object is used in ``generate`` and function to provide integer random values. Each integer can be treated as a vector of several bits. In pseudorandom generators -this randomness can be violated. See :ref:`VS Notes` for details. +this randomness can be violated. See :ref:`VS Notes` for details. class bits @@ -58,4 +58,4 @@ class bits The type which defines type of generated random numbers. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst similarity index 96% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-exponential.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst index eab3a2b1d..f0b8bfa12 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-exponential.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_exponential: +.. _onemath_device_rng_exponential: exponential =========== @@ -84,7 +84,7 @@ class exponential * ``oneapi::mkl::rng::device::exponential_method::icdf`` * ``oneapi::mkl::rng::device::exponential_method::icdf_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -204,4 +204,4 @@ class exponential Returns the distribution parameter `beta` - scalefactor value. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst similarity index 98% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-gamma.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst index 40a2b6cc3..f161446c4 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-gamma.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_gamma: +.. _onemath_device_rng_gamma: gamma ===== @@ -225,4 +225,4 @@ class gamma Returns the amount of random numbers that were rejected during the last ``generate`` function call. If no ``generate`` calls, ``0`` is returned. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst similarity index 96% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-gaussian.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst index f809fce6b..5aae871bc 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-gaussian.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_gaussian: +.. _onemath_device_rng_gaussian: gaussian ======== @@ -91,7 +91,7 @@ class gaussian * ``oneapi::mkl::rng::device::gaussian_method::by_default`` * ``oneapi::mkl::rng::device::gaussian_method::box_muller2`` - See description of the methods in :ref:`Distributions methods template parameter` + See description of the methods in :ref:`Distributions methods template parameter` .. container:: section @@ -210,4 +210,4 @@ class gaussian Returns the distribution parameter `stddev` - standard deviation value. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate-routines.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate-routines.rst similarity index 62% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate-routines.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-generate-routines.rst index 8b60e7429..99dd43731 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate-routines.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate-routines.rst @@ -2,13 +2,13 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_generate_routines: +.. _onemath_device_rng_generate_routines: Device Generate Routines ======================== -Use the :ref:`onemkl_device_rng_generate` routine to obtain random numbers from a given engine with proper +Use the :ref:`onemath_device_rng_generate` routine to obtain random numbers from a given engine with proper statistics of a given distribution. .. toctree:: diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst similarity index 81% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst index 02e62390c..8a2230921 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-generate.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_generate: +.. _onemath_device_rng_generate: generate ======== @@ -37,10 +37,10 @@ Entry point to obtain random numbers from a given engine with proper statistics .. rubric:: Input Parameters distr - Distribution object. See :ref:`onemkl_device_rng_distributions` for details. + Distribution object. See :ref:`onemath_device_rng_distributions` for details. engine - Engine object. See :ref:`onemkl_device_rng_engines` for details. + Engine object. See :ref:`onemath_device_rng_engines` for details. .. container:: section @@ -49,4 +49,4 @@ Entry point to obtain random numbers from a given engine with proper statistics Returns `Distr::result_type` if `Engine::vec_size == 1` or `sycl::vec` with generated random numbers. -**Parent topic:** :ref:`onemkl_device_rng_generate_routines` +**Parent topic:** :ref:`onemath_device_rng_generate_routines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-lognormal.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-lognormal.rst similarity index 97% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-lognormal.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-lognormal.rst index d9e065a5a..df4918828 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-lognormal.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-lognormal.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_lognormal: +.. _onemath_device_rng_lognormal: lognormal ========= @@ -86,7 +86,7 @@ class lognormal * ``oneapi::mkl::rng::device::lognormal_method::by_default`` * ``oneapi::mkl::rng::device::lognormal_method::box_muller2`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -239,4 +239,4 @@ class lognormal Returns the distribution parameter `scale` - scalefactor value. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst similarity index 94% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg31m1.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst index 263335ac3..aca80b190 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg31m1.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst @@ -2,16 +2,16 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_mcg31m1: +.. _onemath_device_rng_mcg31m1: mcg31m1 ======= -The 31-bit multiplicative congruential pseudorandom number generator MCG(:math:`1132489760, 2^{32}-1`) :ref:`[L'Ecuyer99a] `. +The 31-bit multiplicative congruential pseudorandom number generator MCG(:math:`1132489760, 2^{32}-1`) :ref:`[L'Ecuyer99a] `. .. rubric:: Description -The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. +The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. The mcg31m1 generator belongs to linear congruential generators with the period length of approximately :math:`2^{31}`. Such generators are still used as default random number generators in various software systems, mainly due to the simplicity of the portable versions implementation, speed, and compatibility with the earlier systems versions. @@ -98,4 +98,4 @@ class mcg31m1 offset Number of skipped elements. -**Parent topic:** :ref:`onemkl_device_rng_engines` +**Parent topic:** :ref:`onemath_device_rng_engines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst similarity index 93% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg59.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst index 0d615c636..0d580b805 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mcg59.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_mcg59: +.. _onemath_device_rng_mcg59: mcg59 ===== @@ -12,7 +12,7 @@ from NAG Numerical Libraries. .. rubric:: Description -The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. +The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. The mcg59 generator belongs to linear congruential generators with the period length of approximately :math:`2^{57}`. .. container:: section @@ -94,4 +94,4 @@ class mcg59 offset Number of skipped elements. -**Parent topic:** :ref:`onemkl_device_rng_engines` +**Parent topic:** :ref:`onemath_device_rng_engines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst similarity index 97% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-mrg32k3a.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst index ffd312519..9cc285b4f 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-mrg32k3a.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_mrg32k3a: +.. _onemath_device_rng_mrg32k3a: mrg32k3a ======== @@ -12,7 +12,7 @@ The combined multiple recursive pseudorandom number generator MRG32k3a. .. rubric:: Description MRG32k3a engine is a 32-bit combined multiple recursive generator with two components of order 3 -[:ref:`L'Ecuyer99a`]. MRG32k3a combined generator meets the requirements for +[:ref:`L'Ecuyer99a`]. MRG32k3a combined generator meets the requirements for modern RNGs, such as good multidimensional uniformity, or a long period (:math:`p \approx 2^{191}`). @@ -210,4 +210,4 @@ class mrg32k3a offset Number of skipped elements. Offset is calculated as: ``num_to_skip`` [0]+ ``num_to_skip`` [1]*2\ :sup:`64` + ``num_to_skip`` [2]\* 2\ :sup:`128` + … + ``num_to_skip`` [``n``-1]\*2\ :sup:`64` \*(``n``-1). -**Parent topic:** :ref:`onemkl_device_rng_engines` +**Parent topic:** :ref:`onemath_device_rng_engines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst similarity index 97% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-philox4x32x10.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst index d5f51b806..10acf6f1e 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-philox4x32x10.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_philox4x32x10: +.. _onemath_device_rng_philox4x32x10: philox4x32x10 ============= -A Philox4x32-10 counter-based pseudorandom number generator [:ref:`Salmon11`]. +A Philox4x32-10 counter-based pseudorandom number generator [:ref:`Salmon11`]. .. rubric:: Description @@ -17,7 +17,7 @@ The Philox4x32x10 engine is a keyed family of generator of counter-based BRNG. T .. rubric:: Generation algorithm - The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: + The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: 1. :math:`c_n=c_{n-1} + 1` 2. :math:`\omega_n = f(c_n)`, where :math:`f` is a function that takes 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: @@ -189,4 +189,4 @@ class philox4x32x10 offset Number of skipped elements. Offset is calculated as: ``num_to_skip`` [0]+ ``num_to_skip`` [1]*2\ :sup:`64` + ``num_to_skip`` [2]\* 2\ :sup:`128` + … + ``num_to_skip`` [``n``-1]\*2\ :sup:`64` \*(``n``-1). -**Parent topic:** :ref:`onemkl_device_rng_engines` +**Parent topic:** :ref:`onemath_device_rng_engines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst similarity index 95% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-poisson.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst index 63b1167cd..e68a0f220 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-poisson.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_poisson: +.. _onemath_device_rng_poisson: poisson ======= @@ -76,7 +76,7 @@ class poisson * ``oneapi::mkl::rng::device::poisson_method::by_default`` * ``oneapi::mkl::rng::device::poisson_method::devroye`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -179,4 +179,4 @@ class poisson Returns the distribution parameter `lambda`. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-skip-ahead.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst similarity index 94% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-skip-ahead.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst index 173b3f782..3630015e5 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-skip-ahead.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_skip_ahead: +.. _onemath_device_rng_skip_ahead: skip_ahead ========== @@ -76,4 +76,4 @@ skip_ahead would be: :math:`num\_to\_skip[0] + num\_to\_skip[1] \cdot 2^{64} + ... + num\_to\_skip[1] \cdot 2^{64 (n - 1)}`, where `n` is a number of elements in `num_to_skip` list. -**Parent topic:** :ref:`onemkl_device_rng_service_routines` +**Parent topic:** :ref:`onemath_device_rng_service_routines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-bits.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-bits.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst index 56bc8cf7d..a2b2fadde 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-bits.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_uniform_bits: +.. _onemath_device_rng_uniform_bits: uniform_bits ============ @@ -16,7 +16,7 @@ in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is is supported for philox4x32x10 and mcg59 engines. When generating 64-bit chunks, twice as much engine offset needs to be provided. -``UIntType`` denotes the chunk size and can be ``std::uint32_t``, ``std::uint64_t``. See :ref:`VS Notes` for details. +``UIntType`` denotes the chunk size and can be ``std::uint32_t``, ``std::uint64_t``. See :ref:`VS Notes` for details. class uniform_bits @@ -61,4 +61,4 @@ class uniform_bits The type which defines type of generated random numbers. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst similarity index 96% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-continuous.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst index ef218522c..099543987 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-continuous.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_uniform_continuous: +.. _onemath_device_rng_uniform_continuous: uniform (Continuous) ==================== @@ -85,7 +85,7 @@ class uniform * ``oneapi::mkl::rng::device::uniform_method::standard`` * ``oneapi::mkl::rng::device::uniform_method::accurate`` - See description of the methods in :ref:`Distributions methods template parameter` + See description of the methods in :ref:`Distributions methods template parameter` .. container:: section @@ -205,4 +205,4 @@ class uniform Returns the distribution parameter `b` - right bound. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst similarity index 95% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-discrete.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst index a3b632a69..581aac578 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-uniform-discrete.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_uniform_discrete: +.. _onemath_device_rng_uniform_discrete: uniform (Discrete) ================== @@ -84,7 +84,7 @@ class uniform * ``oneapi::mkl::rng::device::uniform_method::standard`` * ``oneapi::mkl::rng::device::uniform_method::accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -177,4 +177,4 @@ class uniform Returns the distribution parameter `b` - right bound. -**Parent topic:** :ref:`onemkl_device_rng_distributions` +**Parent topic:** :ref:`onemath_device_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst similarity index 93% rename from source/elements/oneMKL/source/domains/rng/device_api/device-rng-usage-model.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst index 15c65c663..5d0af7cc0 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst @@ -2,9 +2,9 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_usage_model: +.. _onemath_device_rng_usage_model: -oneMKL RNG Device Usage Model +oneMath RNG Device Usage Model ============================= .. contents:: @@ -12,7 +12,7 @@ oneMKL RNG Device Usage Model :depth: 1 A typical usage model for device routines is the same as described in -:ref:`onemkl_rng_usage_model`: +:ref:`onemath_rng_usage_model`: #. Create and initialize the object for basic random number generator. @@ -74,4 +74,4 @@ Example of Vector Random Numbers Generation // ... } -**Parent topic:** :ref:`onemkl_device_rng_routines` +**Parent topic:** :ref:`onemath_device_rng_routines` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-routines.rst b/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst similarity index 80% rename from source/elements/oneMKL/source/domains/rng/device_api/device-routines.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-routines.rst index 16e7d7664..51a3958a2 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-routines.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_routines: +.. _onemath_device_rng_routines: Random Number Generators Device Routines ======================================== @@ -27,26 +27,26 @@ RNG domain contains two classes types: - Engines (basic random number generators) classes, which holds the state of generator and is a source of independent and identically distributed random variables. - Refer to :ref:`onemkl_rng_engines_basic_random_number_generators` + Refer to :ref:`onemath_rng_engines_basic_random_number_generators` for a detailed description. - Distribution classes templates (transformation classes) for different types of statistical distributions, for example, uniform, normal (Gaussian), binomial, etc. These classes contain all of the distribution’s parameters - (including generation method). Refer to :ref:`onemkl_device_rng_distributions` for + (including generation method). Refer to :ref:`onemath_device_rng_distributions` for a detailed description of the distributions. The RNG domain also contains two types of free functions: - Generation routines. The current routines are used to obtain random numbers from a given engine with proper statistics defined by a - given distribution. Refer to the :ref:`onemkl_device_rng_generate_routines` + given distribution. Refer to the :ref:`onemath_device_rng_generate_routines` section for a detailed description. - - Service routines. The routines are used to modify the engine state. Refer to :ref:`onemkl_device_rng_service_routines` for a + - Service routines. The routines are used to modify the engine state. Refer to :ref:`onemath_device_rng_service_routines` for a description of these routines. Engine classes work with both generation and service routines. Distribution classes are used in -generation routines only. Refer to the :ref:`onemkl_device_rng_usage_model` +generation routines only. Refer to the :ref:`onemath_device_rng_usage_model` section for the description of typical RNG scenario. .. toctree:: @@ -59,4 +59,4 @@ section for the description of typical RNG scenario. device-service-routines.rst ../bibliography.rst -**Parent topic:** :ref:`onemkl_rng` +**Parent topic:** :ref:`onemath_rng` diff --git a/source/elements/oneMKL/source/domains/rng/device_api/device-service-routines.rst b/source/elements/oneMath/source/domains/rng/device_api/device-service-routines.rst similarity index 76% rename from source/elements/oneMKL/source/domains/rng/device_api/device-service-routines.rst rename to source/elements/oneMath/source/domains/rng/device_api/device-service-routines.rst index cf0418890..f19fdc05e 100644 --- a/source/elements/oneMKL/source/domains/rng/device_api/device-service-routines.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-service-routines.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_device_rng_service_routines: +.. _onemath_device_rng_service_routines: Device Service Routines ======================= @@ -15,7 +15,7 @@ Device Service Routines * - Routine - Description - * - :ref:`onemkl_device_rng_skip_ahead` + * - :ref:`onemath_device_rng_skip_ahead` - Proceed state of engine by the skip-ahead method to skip a given number of elements from the original sequence. .. toctree:: @@ -24,4 +24,4 @@ Device Service Routines device-rng-skip-ahead.rst -**Parent topic:** :ref:`onemkl_device_rng_routines` \ No newline at end of file +**Parent topic:** :ref:`onemath_device_rng_routines` \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst similarity index 98% rename from source/elements/oneMKL/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst rename to source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst index 741fc34c9..11690f56e 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_distributions_template_parameter_mkl_rng_method_values: +.. _onemath_rng_distributions_template_parameter_mkl_rng_method_values: Distributions Template Parameter Method ======================================= @@ -96,4 +96,4 @@ Distributions Template Parameter Method - Inverse cumulative distribution function (ICDF) method. **Parent -topic:** :ref:`onemkl_rng_distributions` +topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/distributions.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst similarity index 72% rename from source/elements/oneMKL/source/domains/rng/host_api/distributions.rst rename to source/elements/oneMath/source/domains/rng/host_api/distributions.rst index 8308f0783..9aecae533 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/distributions.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_distributions: +.. _onemath_rng_distributions: Host Distributions ================== @@ -11,7 +11,7 @@ Host Distributions .. container:: - oneMKL RNG routines are used to generate random + oneMath RNG routines are used to generate random numbers with different types of distribution. Each function group is introduced below by the type of underlying distribution and contains a short description of its functionality, as well as specifications @@ -33,31 +33,31 @@ Host Distributions * - Routine - Description - * - \ :ref:`onemkl_rng_uniform_continuous`\ + * - \ :ref:`onemath_rng_uniform_continuous`\ - Uniform continuous distribution on the interval [``a,b``) - * - \ :ref:`onemkl_rng_gaussian`\ + * - \ :ref:`onemath_rng_gaussian`\ - Normal (Gaussian) distribution - * - \ :ref:`onemkl_rng_exponential`\ + * - \ :ref:`onemath_rng_exponential`\ - Exponential distribution - * - \ :ref:`onemkl_rng_laplace`\ + * - \ :ref:`onemath_rng_laplace`\ - Laplace distribution (double exponential distribution) - * - \ :ref:`onemkl_rng_weibull`\ + * - \ :ref:`onemath_rng_weibull`\ - Weibull distribution - * - \ :ref:`onemkl_rng_cauchy`\ + * - \ :ref:`onemath_rng_cauchy`\ - Cauchy distribution - * - \ :ref:`onemkl_rng_rayleigh`\ + * - \ :ref:`onemath_rng_rayleigh`\ - Rayleigh distribution - * - \ :ref:`onemkl_rng_lognormal`\ + * - \ :ref:`onemath_rng_lognormal`\ - Lognormal distribution - * - \ :ref:`onemkl_rng_gumbel`\ + * - \ :ref:`onemath_rng_gumbel`\ - Gumbel (extreme value) distribution - * - \ :ref:`onemkl_rng_gamma`\ + * - \ :ref:`onemath_rng_gamma`\ - Gamma distribution - * - \ :ref:`onemkl_rng_beta`\ + * - \ :ref:`onemath_rng_beta`\ - Beta distribution - * - \ :ref:`onemkl_rng_chi_square`\ + * - \ :ref:`onemath_rng_chi_square`\ - Chi-Square distribution - * - \ :ref:`onemkl_rng_gaussian_mv`\ + * - \ :ref:`onemath_rng_gaussian_mv`\ - Normal Multivariate (Gaussian Multivariate) distribution @@ -71,27 +71,27 @@ Host Distributions * - Type of Distribution - Description - * - \ :ref:`onemkl_rng_uniform_discrete`\ + * - \ :ref:`onemath_rng_uniform_discrete`\ - Uniform discrete distribution on the interval [``a,b``) - * - \ :ref:`onemkl_rng_uniform_bits`\ + * - \ :ref:`onemath_rng_uniform_bits`\ - Uniformly distributed bits in 32/64-bit chunks - * - \ :ref:`onemkl_rng_bits`\ + * - \ :ref:`onemath_rng_bits`\ - Bits of underlying BRNG integer recurrence - * - \ :ref:`onemkl_rng_bernoulli`\ + * - \ :ref:`onemath_rng_bernoulli`\ - Bernoulli distribution - * - \ :ref:`onemkl_rng_geometric`\ + * - \ :ref:`onemath_rng_geometric`\ - Geometric distribution - * - \ :ref:`onemkl_rng_binomial`\ + * - \ :ref:`onemath_rng_binomial`\ - Binomial distribution - * - \ :ref:`onemkl_rng_hypergeometric`\ + * - \ :ref:`onemath_rng_hypergeometric`\ - Hypergeometric distribution - * - \ :ref:`onemkl_rng_poisson`\ + * - \ :ref:`onemath_rng_poisson`\ - Poisson distribution - * - \ :ref:`onemkl_rng_poisson_v`\ + * - \ :ref:`onemath_rng_poisson_v`\ - Poisson distribution with varying mean - * - \ :ref:`onemkl_rng_negative_binomial`\ + * - \ :ref:`onemath_rng_negative_binomial`\ - Negative binomial distribution, or Pascal distribution - * - \ :ref:`onemkl_rng_multinomial`\ + * - \ :ref:`onemath_rng_multinomial`\ - Multinomial distribution @@ -127,22 +127,22 @@ Host Distributions * - Distribution - Method - * - \ :ref:`onemkl_rng_uniform_continuous`\ + * - \ :ref:`onemath_rng_uniform_continuous`\ - `oneapi::mkl::rng::unform_method::accurate` - * - \ :ref:`onemkl_rng_exponential`\ + * - \ :ref:`onemath_rng_exponential`\ - `oneapi::mkl::rng::exponential_method::icdf_accurate` - * - \ :ref:`onemkl_rng_weibull`\ + * - \ :ref:`onemath_rng_weibull`\ - `oneapi::mkl::rng::weibull_method::icdf_accurate` - * - \ :ref:`onemkl_rng_rayleigh`\ + * - \ :ref:`onemath_rng_rayleigh`\ - `oneapi::mkl::rng::rayleigh_method::icdf_accurate` - * - \ :ref:`onemkl_rng_lognormal`\ + * - \ :ref:`onemath_rng_lognormal`\ - `oneapi::mkl::rng::lognormal_method::box_muller2_accurate`, `oneapi::mkl::rng::lognormal_method::icdf_accurate` - * - \ :ref:`onemkl_rng_gamma`\ + * - \ :ref:`onemath_rng_gamma`\ - `oneapi::mkl::rng::gamma_method::marsaglia_accurate` - * - \ :ref:`onemkl_rng_beta`\ + * - \ :ref:`onemath_rng_beta`\ - `oneapi::mkl::rng::beta_method::cja_accurate`   - **Parent topic:** :ref:`onemkl_rng_manual_offload_routines` + **Parent topic:** :ref:`onemath_rng_manual_offload_routines` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/engines-basic-random-number-generators.rst b/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst similarity index 62% rename from source/elements/oneMKL/source/domains/rng/host_api/engines-basic-random-number-generators.rst rename to source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst index 5b4b6a2ce..28ac8bbbd 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/engines-basic-random-number-generators.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_engines_basic_random_number_generators: +.. _onemath_rng_engines_basic_random_number_generators: Host Engines (Basic Random Number Generators) ============================================= @@ -11,7 +11,7 @@ Host Engines (Basic Random Number Generators) .. container:: - oneMKL RNG provides pseudorandom, quasi-random, and non-deterministic + oneMath RNG provides pseudorandom, quasi-random, and non-deterministic random number generators for Data Parallel C++: @@ -23,43 +23,43 @@ Host Engines (Basic Random Number Generators) * - Routine - Description - * - \ :ref:`onemkl_rng_default_engine`\ + * - \ :ref:`onemath_rng_default_engine`\ - The default random engine - * - \ :ref:`onemkl_rng_mrg32k3a`\ - - The combined multiple recursive pseudorandom number generator ``MRG32k3a``\ :ref:`[L'Ecuyer99a] `\ - * - \ :ref:`onemkl_rng_philox4x32x10`\ - - Philox4x32-10 counter-based pseudorandom number generator with a period of 2\ :sup:`128`\ ``PHILOX4X32X10``\ :ref:`[Salmon11] `\ - * - \ :ref:`onemkl_rng_mcg31m1`\ - - The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1) :ref:`[L'Ecuyer99] `\ - * - \ :ref:`onemkl_rng_r250`\ - - The 32-bit generalized feedback shift register pseudorandom number generator ``GFSR(250,103)``\ :ref:`[Kirkpatrick81] `\ - * - \ :ref:`onemkl_rng_mcg59`\ - - The 59-bit multiplicative congruential pseudorandom number generator ``MCG(13``\ :sup:`13`\ ``, 2``\ :sup:`59`) from NAG Numerical Libraries :ref:`[NAG] `\ - * - \ :ref:`onemkl_rng_wichmann_hill`\ - - Wichmann-Hill pseudorandom number generator (a set of 273 basic generators) from NAG Numerical Libraries :ref:`[NAG] `\ - * - \ :ref:`onemkl_rng_mt19937`\ - - Mersenne Twister pseudorandom number generator ``MT19937``\ :ref:`[Matsumoto98] ` with period length 2\ :sup:`19937`-1 of the produced sequence - * - \ :ref:`onemkl_rng_mt2203`\ - - Set of 6024 Mersenne Twister pseudorandom number generators ``MT2203``\ :ref:`[Matsumoto98] `, :ref:`[Matsumoto00] `. Each of them generates a sequence of period length equal to 2\ :sup:`2203`-1. Parameters of the generators provide mutual independence of the corresponding sequences. - * - \ :ref:`onemkl_rng_sfmt19937`\ - - SIMD-oriented Fast Mersenne Twister pseudorandom number generator ``SFMT19937``\ :ref:`[Saito08] ` with a period length equal to 2\ :sup:`19937`-1 of the produced sequence. - * - \ :ref:`onemkl_rng_sobol`\ - - Sobol quasi-random number generator :ref:`[Sobol76] `, :ref:`[Bratley88] `, which works in arbitrary dimension. - * - \ :ref:`onemkl_rng_niederreiter`\ - - Niederreiter quasi-random number generator :ref:`[Bratley92] `, which works in arbitrary dimension. - * - \ :ref:`onemkl_rng_ars5`\ - - ARS-5 counter-based pseudorandom number generator with a period of 2\ :sup:`128`, which uses instructions from the AES-NI set ``ARS5``\ :ref:`[Salmon11] `. - * - \ :ref:`onemkl_rng_nondeterministic`\ + * - \ :ref:`onemath_rng_mrg32k3a`\ + - The combined multiple recursive pseudorandom number generator ``MRG32k3a``\ :ref:`[L'Ecuyer99a] `\ + * - \ :ref:`onemath_rng_philox4x32x10`\ + - Philox4x32-10 counter-based pseudorandom number generator with a period of 2\ :sup:`128`\ ``PHILOX4X32X10``\ :ref:`[Salmon11] `\ + * - \ :ref:`onemath_rng_mcg31m1`\ + - The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1) :ref:`[L'Ecuyer99] `\ + * - \ :ref:`onemath_rng_r250`\ + - The 32-bit generalized feedback shift register pseudorandom number generator ``GFSR(250,103)``\ :ref:`[Kirkpatrick81] `\ + * - \ :ref:`onemath_rng_mcg59`\ + - The 59-bit multiplicative congruential pseudorandom number generator ``MCG(13``\ :sup:`13`\ ``, 2``\ :sup:`59`) from NAG Numerical Libraries :ref:`[NAG] `\ + * - \ :ref:`onemath_rng_wichmann_hill`\ + - Wichmann-Hill pseudorandom number generator (a set of 273 basic generators) from NAG Numerical Libraries :ref:`[NAG] `\ + * - \ :ref:`onemath_rng_mt19937`\ + - Mersenne Twister pseudorandom number generator ``MT19937``\ :ref:`[Matsumoto98] ` with period length 2\ :sup:`19937`-1 of the produced sequence + * - \ :ref:`onemath_rng_mt2203`\ + - Set of 6024 Mersenne Twister pseudorandom number generators ``MT2203``\ :ref:`[Matsumoto98] `, :ref:`[Matsumoto00] `. Each of them generates a sequence of period length equal to 2\ :sup:`2203`-1. Parameters of the generators provide mutual independence of the corresponding sequences. + * - \ :ref:`onemath_rng_sfmt19937`\ + - SIMD-oriented Fast Mersenne Twister pseudorandom number generator ``SFMT19937``\ :ref:`[Saito08] ` with a period length equal to 2\ :sup:`19937`-1 of the produced sequence. + * - \ :ref:`onemath_rng_sobol`\ + - Sobol quasi-random number generator :ref:`[Sobol76] `, :ref:`[Bratley88] `, which works in arbitrary dimension. + * - \ :ref:`onemath_rng_niederreiter`\ + - Niederreiter quasi-random number generator :ref:`[Bratley92] `, which works in arbitrary dimension. + * - \ :ref:`onemath_rng_ars5`\ + - ARS-5 counter-based pseudorandom number generator with a period of 2\ :sup:`128`, which uses instructions from the AES-NI set ``ARS5``\ :ref:`[Salmon11] `. + * - \ :ref:`onemath_rng_nondeterministic`\ - Non-deterministic random number generator \ - For some basic generators, oneMKL RNG provides two methods of + For some basic generators, oneMath RNG provides two methods of creating independent states in multiprocessor computations, which are the leapfrog method and the block-splitting method. These sequence splitting methods are also useful in sequential Monte Carlo. The - description of these functions can be found in the :ref:`onemkl_rng_service_routines` section. + description of these functions can be found in the :ref:`onemath_rng_service_routines` section. In addition, the MT2203 pseudorandom number generator is a set of 6024 @@ -69,60 +69,60 @@ Host Engines (Basic Random Number Generators) allows creating up to 273 independent random streams. The properties of the generators designed for parallel computations are discussed in detail in - [:ref:`Coddington94 `]. + [:ref:`Coddington94 `]. - **Parent topic:** :ref:`onemkl_rng_manual_offload_routines` + **Parent topic:** :ref:`onemath_rng_manual_offload_routines` .. container:: - - :ref:`onemkl_rng_default_engine` + - :ref:`onemath_rng_default_engine` The default random engine (implementation defined) - - :ref:`onemkl_rng_mrg32k3a` + - :ref:`onemath_rng_mrg32k3a` The combined multiple recursive pseudorandom number generator MRG32k3a [ L'Ecuyer99a] - - :ref:`onemkl_rng_philox4x32x10` + - :ref:`onemath_rng_philox4x32x10` A Philox4x32-10 counter-based pseudorandom number generator. [Salmon11]. - - :ref:`onemkl_rng_mcg31m1` + - :ref:`onemath_rng_mcg31m1` The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1) [L'Ecuyer99] - - :ref:`onemkl_rng_mcg59` + - :ref:`onemath_rng_mcg59` The 59-bit multiplicative congruential pseudorandom number generator MCG(1313, 259) from NAG Numerical Libraries [NAG]. - - :ref:`onemkl_rng_r250` + - :ref:`onemath_rng_r250` The 32-bit generalized feedback shift register pseudorandom number generator GFSR(250,103)[Kirkpatrick81]. - - :ref:`onemkl_rng_wichmann_hill` + - :ref:`onemath_rng_wichmann_hill` Wichmann-Hill pseudorandom number generator (a set of 273 basic generators) from NAG Numerical Libraries [NAG]. - - :ref:`onemkl_rng_mt19937` + - :ref:`onemath_rng_mt19937` Mersenne Twister pseudorandom number generator MT19937 [Matsumoto98] with period length 2\ :sup:`19937`-1 of the produced sequence. - - :ref:`onemkl_rng_sfmt19937` + - :ref:`onemath_rng_sfmt19937` SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [Saito08] with a period length equal to 2\ :sup:`19937`-1 of the produced sequence. - - :ref:`onemkl_rng_mt2203` + - :ref:`onemath_rng_mt2203` Set of 6024 Mersenne Twister pseudorandom number generators MT2203 [Matsumoto98], [Matsumoto00]. Each of them generates a sequence of period length equal to 2\ :sup:`2203`-1. Parameters of the generators provide mutual independence of the corresponding sequences.. - - :ref:`onemkl_rng_ars5` + - :ref:`onemath_rng_ars5` ARS-5 counter-based pseudorandom number generator with a period of 2\ :sup:`128`, which uses instructions from the AES-NI set ARS5[Salmon11]. - - :ref:`onemkl_rng_sobol` + - :ref:`onemath_rng_sobol` Sobol quasi-random number generator [Sobol76], [Bratley88], which works in arbitrary dimension. - - :ref:`onemkl_rng_niederreiter` + - :ref:`onemath_rng_niederreiter` Niederreiter quasi-random number generator [Bratley92], which works in arbitrary dimension. - - :ref:`onemkl_rng_nondeterministic` + - :ref:`onemath_rng_nondeterministic` Non-deterministic random number generator. .. toctree:: diff --git a/source/elements/oneMKL/source/domains/rng/host_api/generate-routine.rst b/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst similarity index 71% rename from source/elements/oneMKL/source/domains/rng/host_api/generate-routine.rst rename to source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst index 8c43e955c..d4a7b7c79 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/generate-routine.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_generate_routine: +.. _onemath_rng_generate_routine: Host Generate Routine ===================== @@ -10,11 +10,11 @@ Host Generate Routine .. container:: - - :ref:`onemkl_rng_generate` + - :ref:`onemath_rng_generate` Entry point to obtain random numbers from a given engine with proper statistics of a given distribution. - **Parent topic:** :ref:`onemkl_rng_manual_offload_routines` + **Parent topic:** :ref:`onemath_rng_manual_offload_routines` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-ars5.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-ars5.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst index 7212e5a5e..fbcaacc1f 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-ars5.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst @@ -2,24 +2,24 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_ars5: +.. _onemath_rng_ars5: ars5 ==== The ars5 counter-based pseudorandom number generator. -.. _onemkl_rng_ars5_description: +.. _onemath_rng_ars5_description: .. rubric:: Description -The ars5 engine is a keyed family of counter-based BRNG. The state consists of a 128-bit integer counter :math:`c` and a 128-bit key :math:`k`. The BRNG is based on the AES encryption algorithm [:ref:`FIPS-197 `]. +The ars5 engine is a keyed family of counter-based BRNG. The state consists of a 128-bit integer counter :math:`c` and a 128-bit key :math:`k`. The BRNG is based on the AES encryption algorithm [:ref:`FIPS-197 `]. .. container:: section .. rubric:: Generation algorithm - The generator has a 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: + The generator has a 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: 1. The i-th number is defined by the following formula :math:`r_i=(f(i/ 4) >> ((i \ mod \ 4) * 32)) \ mod \ 2 ^ {32}` 2. Function :math:`f(c)` takes a 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: @@ -39,13 +39,13 @@ The ars5 engine is a keyed family of counter-based BRNG. The state consists of a :math:`Hi(k_{i+1}) = Hi(k) + 0xBB67AE8584CAA73B` - Specification for :math:`SubBytes, ShiftRows, MixColumns, AddRoundKey` functions can be found in [:ref:`FIPS-197 `]. + Specification for :math:`SubBytes, ShiftRows, MixColumns, AddRoundKey` functions can be found in [:ref:`FIPS-197 `]. 2.3. Put :math:`f(c) = c_N`, where :math:`N = 10` 3. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` -.. _onemkl_rng_ars5_description_syntax: +.. _onemath_rng_ars5_description_syntax: class ars5 ---------- @@ -112,7 +112,7 @@ class ars5 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is 128-bit key, :math:`c` is 128-bit counter. @@ -128,7 +128,7 @@ class ars5 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume @@ -197,4 +197,4 @@ class ars5 other Valid ``ars5`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bernoulli.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst index 07c49277c..0baed6f2f 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bernoulli.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_bernoulli: +.. _onemath_rng_bernoulli: bernoulli ========= Class is used for generation of Bernoulli distributed integer types random numbers. -.. _onemkl_rng_bernoulli_description: +.. _onemath_rng_bernoulli_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. The probability distribution is given by: @@ -31,7 +31,7 @@ The cumulative distribution function is as follows: F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - p, 0 \leq x < 1, x \in R \\ 1, x \ge 1 \end{array}\right. -.. _onemkl_rng_bernoulli_syntax: +.. _onemath_rng_bernoulli_syntax: class bernoulli --------------- @@ -71,7 +71,7 @@ class bernoulli * ``oneapi::mkl::rng::bernoulli_method::by_default`` * ``oneapi::mkl::rng::bernoulli_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -174,4 +174,4 @@ class bernoulli Returns the distribution parameter `p` - probability. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-beta.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst similarity index 95% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-beta.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst index 5fae96997..c7e5b9034 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-beta.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_beta: +.. _onemath_rng_beta: beta ==== Class is used for generation of beta distributed real types random numbers. -.. _onemkl_rng_beta_description: +.. _onemath_rng_beta_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers beta distributed with shape parameters :math:`p` and :math:`q`, displacement :math:`\alpha` and scale parameter :math:`(b, \beta)`, where :math:`p`, :math:`q`. :math:`\alpha`, :math:`\beta` :math:`\in R; p > 0; q > 0; \beta > 0`. @@ -33,7 +33,7 @@ The cumulative distribution function is as follows: Where :math:`B(p, 1)` is the complete beta function. -.. _onemkl_rng_beta_syntax: +.. _onemath_rng_beta_syntax: class beta ---------- @@ -77,7 +77,7 @@ class beta * ``oneapi::mkl::rng::beta_method::cja`` * ``oneapi::mkl::rng::beta_method::cja_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -228,4 +228,4 @@ class beta Returns the distribution parameter :math:`\beta` - scalefactor. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-binomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-binomial.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst index 0dbcdfecf..31fd0a9bf 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-binomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_binomial: +.. _onemath_rng_binomial: binomial ======== Class is used for generation of binomially distributed integer types random numbers. -.. _onemkl_rng_binomial_description: +.. _onemath_rng_binomial_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. A binomially distributed variate represents the number of successes in :math:`m` independent Bernoulli trials with probability of a single trial success :math:`p`. @@ -30,7 +30,7 @@ The cumulative distribution function is as follows: F_{m, p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ \sum^{\lfloor x \rfloor}_{k = 0} C^k_{m}p^k(1 - p)^{m - k}, 0 \leq x < m, x \in R \\ 1, x \ge m \end{array}\right. -.. _onemkl_rng_binomial_syntax: +.. _onemath_rng_binomial_syntax: class binomial -------------- @@ -70,7 +70,7 @@ class binomial * ``oneapi::mkl::rng::binomial_method::by_default`` * ``oneapi::mkl::rng::binomial_method::btpe`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -189,4 +189,4 @@ class binomial Returns the distribution parameter `p` - success probability of a single trial. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst similarity index 73% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bits.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst index edc41aee7..3354c4aa4 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-bits.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_bits: +.. _onemath_rng_bits: bits ==== Class is used for generation of underlying engine integer recurrence. -.. _onemkl_rng_bits_description: +.. _onemath_rng_bits_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. class bits ---------- @@ -56,4 +56,4 @@ class bits The type which defines type of generated random numbers. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-cauchy.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-cauchy.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst index 2cfd69027..7c8bcf760 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-cauchy.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_cauchy: +.. _onemath_rng_cauchy: cauchy ====== Class is used for generation of Cauchy distributed real types random numbers. -.. _onemkl_rng_cauchy_description: +.. _onemath_rng_cauchy_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \beta}(x) = \frac{1}{2} + \frac{1}{\pi} \arctan{(\frac{x - a}{\beta})}, x \in R. -.. _onemkl_rng_cauchy_syntax: +.. _onemath_rng_cauchy_syntax: class cauchy ------------ @@ -68,7 +68,7 @@ class cauchy * ``oneapi::mkl::rng::cauchy_method::by_default`` * ``oneapi::mkl::rng::cauchy_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -187,4 +187,4 @@ class cauchy Returns the distribution parameter `b` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-chi_square.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-chi_square.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst index 4f335f053..ba6269cd0 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-chi_square.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_chi_square: +.. _onemath_rng_chi_square: chi_square ========== Class is used for generation of chi-square distributed real types random numbers. -.. _onemkl_rng_chi_square_description: +.. _onemath_rng_chi_square_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. The probability distribution is given by: @@ -28,7 +28,7 @@ The cumulative distribution function is as follows: F_{n}(x) = \left\{ \begin{array}{rcl} \int^{x}_{0}\frac{y^{\frac{n - 2}{2}}e^{-\frac{x}{2}}}{2^{n/2}\Gamma(n/2)}dy, x \ge 0 \\ 0, x < 0 \end{array}\right. -.. _onemkl_rng_chi_square_syntax: +.. _onemath_rng_chi_square_syntax: class chi_square ---------------- @@ -68,7 +68,7 @@ class chi_square * ``oneapi::mkl::rng::chi_square_method::by_default`` * ``oneapi::mkl::rng::chi_square_method::gamma_based`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -171,4 +171,4 @@ class chi_square Returns the distribution parameter `n` - number of degrees of freedom. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-default_engine.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst similarity index 72% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-default_engine.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst index 95241dca8..9d11919a2 100755 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-default_engine.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_default_engine: +.. _onemath_rng_default_engine: default_engine ============== Default random engine. -.. _onemkl_rng_default_engine_description: +.. _onemath_rng_default_engine_description: .. rubric:: Description The choice of engine type named by default_engine is implementation-defined. The implementation may select this type on the basis of performance, size, quality, or any combination of such factors. -.. _onemkl_rng_default_engine_description_syntax: +.. _onemath_rng_default_engine_description_syntax: type alias default_engine ------------------------- @@ -27,4 +27,4 @@ type alias default_engine using default_engine = implementation-defined; -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-exponential.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst index 9c0b30c44..e0d1e1764 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-exponential.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_exponential: +.. _onemath_rng_exponential: exponential =========== Class is used for generation of exponentially distributed real types random numbers. -.. _onemkl_rng_exponential_description: +.. _onemath_rng_exponential_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{x - a}{\beta}), x \ge a \\ 0, x < a \end{array}\right. -.. _onemkl_rng_exponential_syntax: +.. _onemath_rng_exponential_syntax: class exponential ----------------- @@ -69,7 +69,7 @@ class exponential * ``oneapi::mkl::rng::exponential_method::icdf`` * ``oneapi::mkl::rng::exponential_method::icdf_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -188,4 +188,4 @@ class exponential Returns the distribution parameter `beta` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst similarity index 95% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gamma.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst index 644914851..b92dfc408 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gamma.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_gamma: +.. _onemath_rng_gamma: gamma ===== Class is used for generation of gamma distributed real types random numbers. -.. _onemkl_rng_gamma_description: +.. _onemath_rng_gamma_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers gamma distributed with shape :math:`\alpha`, displacement :math:`a`, and scale parameter :math:`\beta`, where :math:`a, \alpha, \beta \in R; \alpha > 0; \beta > 0`. @@ -30,7 +30,7 @@ The cumulative distribution function is as follows: F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \int^x_a\frac{1}{\Gamma(\alpha)\beta^{\alpha}}(y - a)^{\alpha - 1}e^{-(y - a) / \beta}dy, x \ge a \\ 0, x < a \end{array}\right. -.. _onemkl_rng_gamma_syntax: +.. _onemath_rng_gamma_syntax: class gamma ----------- @@ -73,7 +73,7 @@ class gamma * ``oneapi::mkl::rng::gamma_method::marsaglia`` * ``oneapi::mkl::rng::gamma_method::marsaglia_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -208,4 +208,4 @@ class gamma Returns the distribution parameter `beta` - scale parameter. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst index d10d626e7..93f3abae4 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_gaussian: +.. _onemath_rng_gaussian: gaussian ======== Class is used for generation of normally distributed real types random numbers. -.. _onemkl_rng_gaussian_description: +.. _onemath_rng_gaussian_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. The probability distribution is given by: @@ -28,7 +28,7 @@ The cumulative distribution function is as follows: F_{a, \sigma}(x) = \int^x_{-\infty}\frac{1}{\sigma\sqrt{2\pi}}exp(-\frac{(y - a)^2}{2*\sigma^2})dy, x \in R. -.. _onemkl_rng_gaussian_syntax: +.. _onemath_rng_gaussian_syntax: class gaussian -------------- @@ -71,7 +71,7 @@ class gaussian * ``oneapi::mkl::rng::gaussian_method::box_muller2`` * ``oneapi::mkl::rng::gaussian_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter` + See description of the methods in :ref:`Distributions methods template parameter` .. container:: section @@ -190,4 +190,4 @@ class gaussian Returns the distribution parameter `stddev` - standard deviation value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst index 1232a5377..a7dea550c 100755 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_gaussian_mv: +.. _onemath_rng_gaussian_mv: gaussian_mv =========== Class is used for generation of multivariate normally distributed real types random numbers. -.. _onemkl_rng_gaussian_mv_description: +.. _onemath_rng_gaussian_mv_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. The probability density function is given by: @@ -21,7 +21,7 @@ The probability density function is given by: f_{a, C}(x) = \frac{1}{\sqrt{det(2\pi C)}}exp(-1 / 2(x - a)^T C^{-1}(x-a)). -.. _onemkl_rng_gaussian_mv_syntax: +.. _onemath_rng_gaussian_mv_syntax: class gaussian_mv ----------------- @@ -77,7 +77,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. * ``oneapi::mkl::rng::gaussian_mv_method::box_muller2`` * ``oneapi::mkl::rng::gaussian_mv_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -196,4 +196,4 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. Returns the variance-covariance matrix. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-generate.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst similarity index 82% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-generate.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst index d1557ab80..d1940a9e1 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-generate.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_generate: +.. _onemath_rng_generate: generate ======== Entry point to obtain random numbers from a given engine with proper statistics of a given distribution. -.. _onemkl_rng_generate_description: +.. _onemath_rng_generate_description: .. rubric:: Description and Assumptions oneapi::mkl::rng::generate function produces random numbers sequence from the given engine object and applied transformation from a given distribution object. -.. _onemkl_rng_generate_buffer: +.. _onemath_rng_generate_buffer: generate (Buffer version) ------------------------- @@ -44,10 +44,10 @@ generate (Buffer version) .. rubric:: Input Parameters distr - Distribution object. See :ref:`onemkl_rng_distributions` for details. + Distribution object. See :ref:`onemath_rng_distributions` for details. engine - Engine object. See :ref:`onemkl_rng_engines_basic_random_number_generators` for details. + Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. n Number of random values to be generated. @@ -66,7 +66,7 @@ generate (Buffer version) oneapi::mkl::invalid_argument Exception is thrown when n > r.get_count(), or n < 0 -.. _onemkl_rng_generate_usm: +.. _onemath_rng_generate_usm: generate (USM version) ---------------------- @@ -95,10 +95,10 @@ generate (USM version) .. rubric:: Input Parameters distr - Distribution object. See :ref:`onemkl_rng_distributions` for details. + Distribution object. See :ref:`onemath_rng_distributions` for details. engine - Engine object. See :ref:`onemkl_rng_engines_basic_random_number_generators` for details. + Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. n Number of random values to be generated. @@ -127,4 +127,4 @@ generate (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_rng_generate_routine` +**Parent topic:** :ref:`onemath_rng_generate_routine` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-geometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-geometric.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst index a51386385..230c17b72 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-geometric.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_geometric: +.. _onemath_rng_geometric: geometric ========= Class is used for generation of geometrically distributed integer types random numbers. -.. _onemkl_rng_geometric_description: +.. _onemath_rng_geometric_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - (1 - p)^{\lfloor x + 1 \rfloor}, x \ge 0 \end{array}\right. -.. _onemkl_rng_geometric_syntax: +.. _onemath_rng_geometric_syntax: class geometric --------------- @@ -67,7 +67,7 @@ class geometric * ``oneapi::mkl::rng::geometric_method::by_default`` * ``oneapi::mkl::rng::geometric_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -170,4 +170,4 @@ class geometric Returns the distribution parameter `p` - probability value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gumbel.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gumbel.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst index 88d9a8aaf..bd86b232a 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-gumbel.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_gumbel: +.. _onemath_rng_gumbel: gumbel ====== Class is used for generation of Gumbel distributed real types random numbers. -.. _onemkl_rng_gumbel_description: +.. _onemath_rng_gumbel_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \beta}(x) = 1 - exp(-exp(\frac{x - a}{\beta})), x \in R. -.. _onemkl_rng_gumbel_syntax: +.. _onemath_rng_gumbel_syntax: class gumbel ------------ @@ -68,7 +68,7 @@ class gumbel * ``oneapi::mkl::rng::gumbel_method::by_default`` * ``oneapi::mkl::rng::gumbel_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -187,4 +187,4 @@ class gumbel Returns the distribution parameter `b` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-hypergeometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-hypergeometric.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst index 863f066c8..e8f5fd78c 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-hypergeometric.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_hypergeometric: +.. _onemath_rng_hypergeometric: hypergeometric ============== Class is used for generation of hypergeometrically distributed integer types random numbers. -.. _onemkl_rng_hypergeometric_description: +.. _onemath_rng_hypergeometric_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. Consider a lot of :math:`l` elements comprising :math:`m` marked and :math:`l` - :math:`m` unmarked elements. A trial sampling without replacement of exactly :math:`s` elements from this lot helps to define the hypergeometric distribution, which is the probability that the group of :math:`s` elements contains exactly :math:`k` marked elements. @@ -29,7 +29,7 @@ The cumulative distribution function is as follows: F_{l, s, m}(x) = \left\{ \begin{array}{rcl} 0, x < max(0, s + m - l) \\ \sum^{\lfloor x \rfloor}_{k = max(0, s + m - l)}\frac{C^k_mC^{s-k}_{l-m}}{C^s_l}, max(0, s + m - l) \leq x \leq min(s, m) \\ 1, x > min(s, m) \end{array}\right. -.. _onemkl_rng_hypergeometric_syntax: +.. _onemath_rng_hypergeometric_syntax: class hypergeometric -------------------- @@ -71,7 +71,7 @@ class hypergeometric * ``oneapi::mkl::rng::hypergeometric_method::by_default`` * ``oneapi::mkl::rng::hypergeometric_method::h2pe`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -206,4 +206,4 @@ class hypergeometric Returns the distribution parameter `m` - number of marked elements. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-laplace.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst similarity index 88% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-laplace.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst index ddb8206d0..5e2e977ef 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-laplace.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_laplace: +.. _onemath_rng_laplace: laplace ======= Class is used for generation of Laplace distributed real types random numbers. -.. _onemkl_rng_laplace_description: +.. _onemath_rng_laplace_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x \ge a \\ 1 - \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x < a \end{array}\right. -.. _onemkl_rng_laplace_syntax: +.. _onemath_rng_laplace_syntax: class laplace ------------- @@ -66,7 +66,7 @@ class laplace * ``oneapi::mkl::rng::laplace_method::by_default`` * ``oneapi::mkl::rng::laplace_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -185,4 +185,4 @@ class laplace Returns the distribution parameter `b` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-leapfrog.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst similarity index 92% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-leapfrog.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst index b767ec0b6..8d473ac86 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-leapfrog.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_leapfrog: +.. _onemath_rng_leapfrog: leapfrog ======== Proceed state of engine by the leapfrog method. -.. _onemkl_rng_leapfrog_description: +.. _onemath_rng_leapfrog_description: .. rubric:: Description and Assumptions @@ -22,7 +22,7 @@ oneapi::mkl::rng::leapfrog function generates random numbers in an engine with n |image0| -.. _onemkl_rng_leapfrog_common: +.. _onemath_rng_leapfrog_common: leapfrog -------- @@ -74,6 +74,6 @@ leapfrog // Generating random numbers -**Parent topic:** :ref:`onemkl_rng_service_routines` +**Parent topic:** :ref:`onemath_rng_service_routines` .. |image0| image:: ../../equations/rng-leapfrog.png diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-lognormal.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-lognormal.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst index 10feecd4c..a763e9d4b 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-lognormal.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_lognormal: +.. _onemath_rng_lognormal: lognormal ========= Class is used for generation of lognormally distributed real types random numbers. -.. _onemkl_rng_lognormal_description: +.. _onemath_rng_lognormal_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \sigma, b, \beta}(x) = \left\{ \begin{array}{rcl} \Phi( \frac{(ln((x - b) / \beta) - a)}{\sigma}), x > b \\ 0, x \leq b \end{array}\right. -.. _onemkl_rng_lognormal_syntax: +.. _onemath_rng_lognormal_syntax: class lognormal --------------- @@ -73,7 +73,7 @@ class lognormal * ``oneapi::mkl::rng::lognormal_method::box_muller2_accurate`` * ``oneapi::mkl::rng::lognormal_method::icdf_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -224,4 +224,4 @@ class lognormal Returns the distribution parameter `scale` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst similarity index 77% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg31m1.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst index df851db12..04ec7f84c 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg31m1.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_mcg31m1: +.. _onemath_rng_mcg31m1: mcg31m1 ======= The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1). -.. _onemkl_rng_mcg31m1_description: +.. _onemath_rng_mcg31m1_description: .. rubric:: Description -The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. The mcg31m1 generator belongs to linear congruential generators with the period length of approximately :math:`2^{31}`. Such generators are still used as default random number generators in various software systems, mainly due to the simplicity of the portable versions implementation, speed, and compatibility with the earlier systems versions. However, their period length does not meet the requirements for modern basic generators. Still, the mcg31m1 generator possesses good statistic properties and you may successfully use it to generate random numbers of different distributions for small samplings. +The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. The mcg31m1 generator belongs to linear congruential generators with the period length of approximately :math:`2^{31}`. Such generators are still used as default random number generators in various software systems, mainly due to the simplicity of the portable versions implementation, speed, and compatibility with the earlier systems versions. However, their period length does not meet the requirements for modern basic generators. Still, the mcg31m1 generator possesses good statistic properties and you may successfully use it to generate random numbers of different distributions for small samplings. .. container:: section @@ -25,7 +25,7 @@ The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ec :math:`a = 1132489760, m=2^{31} - 1` -.. _onemkl_rng_mcg31m1_description_syntax: +.. _onemath_rng_mcg31m1_description_syntax: class mcg31m1 ------------- @@ -88,7 +88,7 @@ class mcg31m1 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 0x7FFFFFFF`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -145,4 +145,4 @@ class mcg31m1 other Valid ``mcg31m1`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst similarity index 86% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg59.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst index d05c1ba2f..5d1b9e0a4 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mcg59.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_mcg59: +.. _onemath_rng_mcg59: mcg59 ===== The 59-bit multiplicative congruential pseudorandom number generator. -.. _onemkl_rng_mcg59_description: +.. _onemath_rng_mcg59_description: .. rubric:: Description -The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. The mcg59 generator belongs to linear congruential generators with the period length of approximately :math:`2^{57}`. +The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. The mcg59 generator belongs to linear congruential generators with the period length of approximately :math:`2^{57}`. .. container:: section @@ -25,7 +25,7 @@ The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Nume :math:`a = 13^{13}, m=2^{59}` -.. _onemkl_rng_mcg59_description_syntax: +.. _onemath_rng_mcg59_description_syntax: class mcg59 ----------- @@ -88,7 +88,7 @@ class mcg59 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 2^{59}`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -145,4 +145,4 @@ class mcg59 other Valid ``mcg59`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst index e72ff80b0..b0154b294 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_mrg32k3a: +.. _onemath_rng_mrg32k3a: mrg32k3a ======== The combined multiple recursive pseudorandom number generator MRG32k3a. -.. _onemkl_rng_mrg32k3a_description: +.. _onemath_rng_mrg32k3a_description: .. rubric:: Description -MRG32k3a engine is a 32-bit combined multiple recursive generator with two components of order 3 :ref:`[L'Ecuyer99a] `. MRG32k3a combined generator meets the requirements for modern RNGs, such as good multidimensional uniformity, or a long period (:math:`p \approx 2^{191}`). +MRG32k3a engine is a 32-bit combined multiple recursive generator with two components of order 3 :ref:`[L'Ecuyer99a] `. MRG32k3a combined generator meets the requirements for modern RNGs, such as good multidimensional uniformity, or a long period (:math:`p \approx 2^{191}`). .. container:: section @@ -33,7 +33,7 @@ MRG32k3a engine is a 32-bit combined multiple recursive generator with two compo :math:`a_{21} = 527612, a_{22} = 0, a_{23} = -1370589, m_2 = 2^{32} - 22853` -.. _onemkl_rng_mrg32k3a_description_syntax: +.. _onemath_rng_mrg32k3a_description_syntax: class mrg32k3a -------------- @@ -100,7 +100,7 @@ class mrg32k3a .. rubric:: Input Parameters queue - Valid ``sycl::queue object``, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue object``, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_{-3} = seed \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1`. @@ -116,7 +116,7 @@ class mrg32k3a .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume @@ -198,4 +198,4 @@ class mrg32k3a other Valid ``mrg32k3a`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst similarity index 82% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt19937.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst index fead41585..f5bbf52b6 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt19937.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_mt19937: +.. _onemath_rng_mt19937: mt19937 ======= Mersenne Twister pseudorandom number generator. -.. _onemkl_rng_mt19937_description: +.. _onemath_rng_mt19937_description: .. rubric:: Description -The Mersenne Twister pseudorandom number generator, mt19937, is a modification of twisted generalized feedback shift register generator [:ref:`Matsumoto98 `]. MT19937 has the period length of :math:`2^{19937} - 1` and is 623-dimensionally equidistributed with up to 32-bit accuracy. These properties make the generator applicable for simulations in various fields of science and engineering. The state of the generator is represented by 624 32-bit unsigned integer numbers. +The Mersenne Twister pseudorandom number generator, mt19937, is a modification of twisted generalized feedback shift register generator [:ref:`Matsumoto98 `]. MT19937 has the period length of :math:`2^{19937} - 1` and is 623-dimensionally equidistributed with up to 32-bit accuracy. These properties make the generator applicable for simulations in various fields of science and engineering. The state of the generator is represented by 624 32-bit unsigned integer numbers. .. container:: section @@ -46,7 +46,7 @@ The Mersenne Twister pseudorandom number generator, mt19937, is a modification o Where the 32-bit vector :math:`a = a_{31}..a_{0}` has the value :math:`a=0x9908B0DF`. -.. _onemkl_rng_mt19937_description_syntax: +.. _onemath_rng_mt19937_description_syntax: class mt19937 -------------- @@ -113,10 +113,10 @@ class mt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. .. _`mt19937(sycl::queue queue, std::initializer_list seed)`: @@ -129,10 +129,10 @@ class mt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. .. _`mt19937(const mt19937& other)`: @@ -186,4 +186,4 @@ class mt19937 other Valid ``mt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt2203.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst similarity index 85% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt2203.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst index 62aeedc36..6cc1c6f4b 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-mt2203.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_mt2203: +.. _onemath_rng_mt2203: mt2203 ====== -The mt2203 engine is the set of 6024 Mersenne Twister pseudorandom number generators MT2203 [:ref:`Matsumoto98 `], [:ref:`Matsumoto00 `]. +The mt2203 engine is the set of 6024 Mersenne Twister pseudorandom number generators MT2203 [:ref:`Matsumoto98 `], [:ref:`Matsumoto00 `]. -.. _onemkl_rng_mt2203_description: +.. _onemath_rng_mt2203_description: .. rubric:: Description @@ -43,7 +43,7 @@ The set of 6024 basic pseudorandom number generators MT2203 is a natural additio \left [ \begin{array}{ccccc} 0 & 1 & 0 & ... & ... \\ 0 & 0 & ... & 0 & ... \\ ... & ... & ... & ... & ... \\ 0 & ... & 0 & 0 & 1 \\ a_{31, j} & a_{30, j} & ... & ... & a_{0, 1} \end{array}\right ] -.. _onemkl_rng_mt2203_description_syntax: +.. _onemath_rng_mt2203_description_syntax: class mt2203 ------------ @@ -118,10 +118,10 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. .. _`mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`: @@ -134,10 +134,10 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. engine_idx The index of the set 1, ..., 6024. @@ -160,10 +160,10 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. .. _`mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx)`: @@ -176,10 +176,10 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. engine_idx The index of the set 1, ..., 6024. @@ -236,4 +236,4 @@ class mt2203 other Valid ``mt2203`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-multinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst similarity index 88% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-multinomial.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst index 5cd943332..5b4e11dcc 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-multinomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_multinomial: +.. _onemath_rng_multinomial: multinomial =========== Class is used for generation of multinomially distributed integer types random numbers. -.. _onemkl_rng_multinomial_description: +.. _onemath_rng_multinomial_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. The probability distribution is given by: @@ -21,7 +21,7 @@ The probability distribution is given by: P(X_1 = x_1, ..., X_k = x_k) = \frac{m!}{\Pi^k_{i = 1}x_i!}\Pi^k_{i = 1}p_i^{x_i}, 0 \leq x_i \leq m, \sum^{k}_{i = 1}x_i = m -.. _onemkl_rng_multinomial_syntax: +.. _onemath_rng_multinomial_syntax: class multinomial ----------------- @@ -64,7 +64,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. * ``oneapi::mkl::rng::multinomial_method::by_default`` * ``oneapi::mkl::rng::multinomial_method::poisson_icdf_based`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -167,4 +167,4 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. Returns the distribution parameter `p`. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-negbinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-negbinomial.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst index 187ba77da..505dbc0ba 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-negbinomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_negative_binomial: +.. _onemath_rng_negative_binomial: negative_binomial ================= Class is used for generation of negative binomially distributed integer types random numbers. -.. _onemkl_rng_negative_binomial_description: +.. _onemath_rng_negative_binomial_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. The probability distribution is given by: @@ -28,7 +28,7 @@ The cumulative distribution function is as follows: F_{a, p}(x) = \left\{ \begin{array}{rcl} \sum^{\lfloor x \rfloor}_{k = 0} C^k_{a + k - 1}p^a(1 - p)^{k}, x \ge 0, x \in R \\ 0, x < 0 \end{array}\right. -.. _onemkl_rng_negative_binomial_syntax: +.. _onemath_rng_negative_binomial_syntax: class negative_binomial ----------------------- @@ -69,7 +69,7 @@ class negative_binomial * ``oneapi::mkl::rng::negative_binomial_method::by_default`` * ``oneapi::mkl::rng::negative_binomial_method::nbar`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -188,4 +188,4 @@ class negative_binomial Returns the distribution parameter `p` - the second distribution parameter. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-niederreiter.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst similarity index 87% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-niederreiter.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst index 0ddb6549b..0a9560ddb 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-niederreiter.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_niederreiter: +.. _onemath_rng_niederreiter: niederreiter ============ The niederreiter generator is a 32-bit Gray code-based quasi-random number generator. -.. _onemkl_rng_niederreiter_description: +.. _onemath_rng_niederreiter_description: .. rubric:: Description -According to results of Bratley, Fox and Niederreiter :ref:`[Bratley92] ` Niederreiter sequences have the best known theoretical asymptotic properties. The default dimension of quasi-random vectors can vary from 1 to 318 inclusive. It is also allowed to register user-defined parameters (irreducible polynomials). +According to results of Bratley, Fox and Niederreiter :ref:`[Bratley92] ` Niederreiter sequences have the best known theoretical asymptotic properties. The default dimension of quasi-random vectors can vary from 1 to 318 inclusive. It is also allowed to register user-defined parameters (irreducible polynomials). .. container:: section @@ -26,7 +26,7 @@ According to results of Bratley, Fox and Niederreiter :ref:`[Bratley92] ` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. dimensions Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 318`, assume :math:`dimen = 1`. @@ -109,7 +109,7 @@ class niederreiter .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. irred_polynomials If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own irreducible polynomials. The number of dimensions corresponds to the length of the vector. @@ -166,4 +166,4 @@ class niederreiter other Valid ``niederreiter`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-nondeterministic.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-nondeterministic.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst index 38e3aff5b..8c3b7b112 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-nondeterministic.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_nondeterministic: +.. _onemath_rng_nondeterministic: nondeterministic ================ Non-deterministic random number generator. -.. _onemkl_rng_nondeterministic_description: +.. _onemath_rng_nondeterministic_description: .. rubric:: Description Implementation defined generator with non-deterministic source of randomness (for example, a hardware device). -.. _onemkl_rng_nondeterministic_description_syntax: +.. _onemath_rng_nondeterministic_description_syntax: class nondeterministic ---------------------- @@ -76,7 +76,7 @@ class nondeterministic .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. .. _`nondeterministic(const nondeterministic& other)`: @@ -131,4 +131,4 @@ class nondeterministic other Valid ``nondeterministic`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst index 95330ac4e..fdd737c4a 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_philox4x32x10: +.. _onemath_rng_philox4x32x10: philox4x32x10 ============= The Philox4x32x10 counter-based pseudorandom number generator. -.. _onemkl_rng_philox4x32x10_description: +.. _onemath_rng_philox4x32x10_description: .. rubric:: Description @@ -19,7 +19,7 @@ The Philox4x32x10 engine is a keyed family of generator of counter-based BRNG. T .. rubric:: Generation algorithm - The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: + The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: 1. :math:`c_n=c_{n-1} + 1` 2. :math:`\omega_n = f(c_n)`, where :math:`f` is a function that takes 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: @@ -44,7 +44,7 @@ The Philox4x32x10 engine is a keyed family of generator of counter-based BRNG. T 3. Integer output: :math:`r_{4n + k} = \omega_n(k)`, where :math:`\omega_n(k)` is the k-th 32-bit integer in quadruple :math:`\omega_n, k = 0, 1, 2, 3` 4. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` -.. _onemkl_rng_philox4x32x10_description_syntax: +.. _onemath_rng_philox4x32x10_description_syntax: class philox4x32x10 ------------------- @@ -111,7 +111,7 @@ class philox4x32x10 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is a 64-bit key, :math:`c` is a 128-bit counter. @@ -127,7 +127,7 @@ class philox4x32x10 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume @@ -193,4 +193,4 @@ class philox4x32x10 other Valid ``philox4x32x10`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst index 16b6c47a1..fba554ac6 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_poisson: +.. _onemath_rng_poisson: poisson ======= Class is used for generation of Poisson distributed integer types random numbers. -.. _onemkl_rng_poisson_description: +.. _onemath_rng_poisson_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{\lambda}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda^ke^{-\lambda}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. -.. _onemkl_rng_poisson_syntax: +.. _onemath_rng_poisson_syntax: class poisson ------------- @@ -67,7 +67,7 @@ class poisson * ``oneapi::mkl::rng::poisson_method::ptpe`` * ``oneapi::mkl::rng::poisson_method::gaussian_icdf_based`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -170,4 +170,4 @@ class poisson Returns the distribution parameter `lambda`. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson_v.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst similarity index 93% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson_v.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst index 9d699eab2..2c8f66610 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-poisson_v.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_poisson_v: +.. _onemath_rng_poisson_v: poisson_v ========= Class is used for generation of Poisson distributed integer types random numbers with varying mean. -.. _onemkl_rng_poisson_v_description: +.. _onemath_rng_poisson_v_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide n random numbers Poisson distributed, with distribution parameter :math:`\lambda_i`, where :math:`\lambda_i \in R; \lambda_i > 0; i = 1, ... , n`. The probability distribution is given by: @@ -28,7 +28,7 @@ The cumulative distribution function is as follows: F_{\lambda_i}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda_i^ke^{-\lambda_i}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. -.. _onemkl_rng_poisson_v_syntax: +.. _onemath_rng_poisson_v_syntax: class poisson_v --------------- @@ -69,7 +69,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. * ``oneapi::mkl::rng::poisson_v_method::by_default`` * ``oneapi::mkl::rng::poisson_v_method::gaussian_icdf_based`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -156,4 +156,4 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. Returns the distribution parameter ``lambda``. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-r250.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-r250.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst index 9359db585..093041366 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-r250.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_r250: +.. _onemath_rng_r250: r250 ==== -The 32-bit generalized feedback shift register pseudorandom number generator GFSR(250,103) :ref:`[Kirkpatrick81] `. +The 32-bit generalized feedback shift register pseudorandom number generator GFSR(250,103) :ref:`[Kirkpatrick81] `. -.. _onemkl_rng_r250_description: +.. _onemath_rng_r250_description: .. rubric:: Description @@ -25,7 +25,7 @@ Feedback shift register generators possess ample theoretical foundation and were :math:`u_n=x_n / 2 ^ {32}` -.. _onemkl_rng_r250_description_syntax: +.. _onemath_rng_r250_description_syntax: class r250 ---------- @@ -92,7 +92,7 @@ class r250 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_{-250} = seed`. If :math:`seed = 0`, assume :math:`seed = 1`. Other values in state are initialized according to recurrent correlation :math:`x_{n+1} = 69069x_{n}(mod \ 2 ^ {32})`. Then the values :math:`x_{7k-247}, k = 0, 1, ..., 31` are interpreted as a binary matrix of size 32 x 32 and diagonal bits are set to 0, the under-diagonal bits to 0. @@ -108,7 +108,7 @@ class r250 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state @@ -166,4 +166,4 @@ class r250 other Valid ``r250`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-rayleigh.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst similarity index 88% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-rayleigh.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst index 92d6afc5b..03497d5f9 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-rayleigh.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_rayleigh: +.. _onemath_rng_rayleigh: rayleigh ======== Class is used for generation of Rayleigh distributed real types random numbers. -.. _onemkl_rng_rayleigh_description: +.. _onemath_rng_rayleigh_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. -The Rayleigh distribution is a special case of the :ref:`onemkl_rng_weibull` distribution, where the shape parameter `\alpha` = 2 . +The Rayleigh distribution is a special case of the :ref:`onemath_rng_weibull` distribution, where the shape parameter `\alpha` = 2 . The probability distribution is given by: @@ -29,7 +29,7 @@ The cumulative distribution function is as follows: F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{(x - a)^2)}{\beta^2}), x \ge a \\ 0, x < a \end{array}\right. -.. _onemkl_rng_rayleigh_syntax: +.. _onemath_rng_rayleigh_syntax: class rayleigh -------------- @@ -71,7 +71,7 @@ class rayleigh * ``oneapi::mkl::rng::rayleigh_method::icdf`` * ``oneapi::mkl::rng::rayleigh_method::icdf_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -190,4 +190,4 @@ class rayleigh Returns the distribution parameter `b` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sfmt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst similarity index 85% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sfmt19937.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst index bb67cd234..4310acb27 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sfmt19937.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_sfmt19937: +.. _onemath_rng_sfmt19937: sfmt19937 ========= The SIMD-oriented Mersenne Twister pseudorandom number generator. -.. _onemkl_rng_sfmt19937_description: +.. _onemath_rng_sfmt19937_description: .. rubric:: Description -SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [:ref:`Saito08 `] with a period length equal to :math:`2 ^ {19937}-1` of the produced sequence. The state of the engine contains the array of 156 128-bit integers. +SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [:ref:`Saito08 `] with a period length equal to :math:`2 ^ {19937}-1` of the produced sequence. The state of the engine contains the array of 156 128-bit integers. .. container:: section @@ -36,7 +36,7 @@ SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [:re :math:`u_n = (int) r_n / 2^{32} + 1/2` -.. _onemkl_rng_sfmt19937_description_syntax: +.. _onemath_rng_sfmt19937_description_syntax: class sfmt19937 --------------- @@ -103,10 +103,10 @@ class sfmt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. .. _`sfmt19937(sycl::queue queue, std::initializer_list seed)`: @@ -119,10 +119,10 @@ class sfmt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. + The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. .. _`sfmt19937(const sfmt19937& other)`: @@ -176,4 +176,4 @@ class sfmt19937 other Valid ``sfmt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-skip_ahead.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst similarity index 94% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-skip_ahead.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst index f97542186..fe8bfb815 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-skip_ahead.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_skip_ahead: +.. _onemath_rng_skip_ahead: skip_ahead ========== Proceed state of engine by the skip-ahead method. -.. _onemkl_rng_skip_ahead_description: +.. _onemath_rng_skip_ahead_description: .. rubric:: Description and Assumptions @@ -22,7 +22,7 @@ oneapi::mkl::rng::skip_ahead function changes the current state of the engine so |image0| -.. _onemkl_rng_skip_ahead_common: +.. _onemath_rng_skip_ahead_common: skip_ahead ---------- @@ -69,7 +69,7 @@ skip_ahead oneapi::mkl::rng::skip_ahead(engine_3, 14); -.. _onemkl_rng_skip_ahead_ex: +.. _onemath_rng_skip_ahead_ex: skip_ahead (Interface with a partitioned number of skipped elements) -------------------------------------------------------------------- @@ -116,6 +116,6 @@ skip_ahead (Interface with a partitioned number of skipped elements) oneapi::mkl::rng::skip_ahead(engine_2, num_to_skip); -**Parent topic:** :ref:`onemkl_rng_service_routines` +**Parent topic:** :ref:`onemath_rng_service_routines` .. |image0| image:: ../../equations/rng-skip-ahead.png diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sobol.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst similarity index 86% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sobol.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst index 261cc1ea8..5a562181f 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-sobol.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_sobol: +.. _onemath_rng_sobol: sobol ===== The sobol is a 32-bit Gray code-based quasi-random number generator. -.. _onemkl_rng_sobol_description: +.. _onemath_rng_sobol_description: .. rubric:: Description -Bratley and Fox :ref:`[Bratley88] ` provide an implementation of the SOBOL quasi-random number generator. The default dimensions of quasi-random vectors can vary from 1 to 40 inclusive. It is also allowed to register user-defined parameters (direction numbers). +Bratley and Fox :ref:`[Bratley88] ` provide an implementation of the SOBOL quasi-random number generator. The default dimensions of quasi-random vectors can vary from 1 to 40 inclusive. It is also allowed to register user-defined parameters (direction numbers). .. container:: section @@ -26,7 +26,7 @@ Bratley and Fox :ref:`[Bratley88] ` provide an implemen The value :math:`c` is the right-most zero bit in :math:`n-1`; :math:`x_n` is s-dimensional vector of 32-bit values. The s-dimensional vectors (calculated during engine initialization) :math:`v_i, i = 1, 32` are called direction numbers. The vector :math:`u_n` is the generator output normalized to the unit hypercube :math:`(0, 1) ^ s`. -.. _onemkl_rng_sobol_description_syntax: +.. _onemath_rng_sobol_description_syntax: class sobol ----------- @@ -93,7 +93,7 @@ class sobol .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. dimensions Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 40`, assume :math:`dimen = 1`. @@ -109,7 +109,7 @@ class sobol .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. direction_numbers If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own direction_numbers. The number of dimensions corresponds to direction_numbers.size() / 32. @@ -166,4 +166,4 @@ class sobol other Valid ``sobol`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst similarity index 90% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst index 540c0484c..a1b04cc5e 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_uniform_continuous: +.. _onemath_rng_uniform_continuous: uniform (continuous) ==================== Class is used for generation of uniformly distributed real types random numbers. -.. _onemkl_rng_uniform_continuous_description: +.. _onemath_rng_uniform_continuous_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the interval, respectively, and :math:`a, b \in R; a < b` The probability distribution is given by: @@ -29,7 +29,7 @@ The cumulative distribution function is as follows: F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{x - a}{b - a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. -.. _onemkl_rng_uniform_continuous_syntax: +.. _onemath_rng_uniform_continuous_syntax: class uniform ------------- @@ -71,7 +71,7 @@ class uniform * ``oneapi::mkl::rng::uniform_method::standard`` * ``oneapi::mkl::rng::uniform_method::accurate`` - See description of the methods in :ref:`Distributions methods template parameter` + See description of the methods in :ref:`Distributions methods template parameter` .. container:: section @@ -190,4 +190,4 @@ class uniform Returns the distribution parameter `b` - right bound. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst similarity index 89% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst index 8e837b3f6..220336705 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_uniform_discrete: +.. _onemath_rng_uniform_discrete: uniform (discrete) ================== Class is used for generation of uniformly distributed integer types random numbers. -.. _onemkl_rng_uniform_discrete_description: +.. _onemath_rng_uniform_discrete_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the interval, respectively, and :math:`a, b \in R; a < b`. The probability distribution is given by: @@ -29,7 +29,7 @@ The cumulative distribution function is as follows: F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{\lfloor x - a + 1 \rfloor}{b-a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. -.. _onemkl_rng_uniform_discrete_syntax: +.. _onemath_rng_uniform_discrete_syntax: class uniform ------------- @@ -63,7 +63,7 @@ class uniform * ``oneapi::mkl::rng::uniform_method::by_default`` * ``oneapi::mkl::rng::uniform_method::standard`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -182,4 +182,4 @@ class uniform Returns the distribution parameter `b` - right bound. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform_bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst similarity index 75% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform_bits.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst index 10da23047..b82d76ba3 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-uniform_bits.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_uniform_bits: +.. _onemath_rng_uniform_bits: uniform_bits ============ Class is used for generation of uniformly distributed bits in 32/64-bit chunks. -.. _onemkl_rng_uniform_bits_description: +.. _onemath_rng_uniform_bits_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. class uniform_bits ------------------ @@ -57,4 +57,4 @@ class uniform_bits The type which defines type of generated random numbers. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-weibull.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-weibull.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst index bceb7c63f..6ccf2a63b 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-weibull.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst @@ -2,18 +2,18 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_weibull: +.. _onemath_rng_weibull: weibull ======= Class is used for generation of Weibull distributed real types random numbers. -.. _onemkl_rng_weibull_description: +.. _onemath_rng_weibull_description: .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. +The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. The probability distribution is given by: @@ -27,7 +27,7 @@ The cumulative distribution function is as follows: F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp((-\frac{x - a}{\beta})^{\alpha}), x \ge a \\ 0, x < a \end{array}\right. -.. _onemkl_rng_weibull_syntax: +.. _onemath_rng_weibull_syntax: class weibull ------------- @@ -70,7 +70,7 @@ class weibull * ``oneapi::mkl::rng::weibull_method::icdf`` * ``oneapi::mkl::rng::weibull_method::icdf_accurate`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section @@ -205,4 +205,4 @@ class weibull Returns the distribution parameter `beta` - scalefactor value. -**Parent topic:** :ref:`onemkl_rng_distributions` +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst similarity index 91% rename from source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst rename to source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst index a35adb8c1..0f90272f9 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_wichmann_hill: +.. _onemath_rng_wichmann_hill: wichmann_hill ============= -The wichmann_hill engine is the set of 273 Wichmann-Hill's combined multiplicative congruential generators from NAG Numerical Libraries :ref:`[NAG] `. +The wichmann_hill engine is the set of 273 Wichmann-Hill's combined multiplicative congruential generators from NAG Numerical Libraries :ref:`[NAG] `. -.. _onemkl_rng_wichmann_hill_description: +.. _onemath_rng_wichmann_hill_description: .. rubric:: Description @@ -32,7 +32,7 @@ The set of 372 different basic pseudorandom number generators wichmann_hill is t The constants :math:`a_{i, j}` range from 112 to 127, the constants :math:`m_{i, j}` are prime numbers ranging from 16718909 to 16776917, close to :math:`2 ^ {24}`. -.. _onemkl_rng_wichmann_hill_description_syntax: +.. _onemath_rng_wichmann_hill_description_syntax: class wichmann_hill ------------------- @@ -107,7 +107,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -123,7 +123,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -149,7 +149,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume: @@ -177,7 +177,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume: @@ -248,4 +248,4 @@ class wichmann_hill other Valid ``wichmann_hill`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. -**Parent topic:** :ref:`onemkl_rng_engines_basic_random_number_generators` +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/onemkl-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst similarity index 93% rename from source/elements/oneMKL/source/domains/rng/host_api/onemkl-rng-usage-model.rst rename to source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst index ad62a589e..cca8f0217 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/onemkl-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst @@ -2,9 +2,9 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_usage_model: +.. _onemath_rng_usage_model: -oneMKL RNG Host Usage Model +oneMath RNG Host Usage Model =========================== @@ -65,4 +65,4 @@ USM-based example // ... } -**Parent topic:** :ref:`onemkl_rng_manual_offload_routines` +**Parent topic:** :ref:`onemath_rng_manual_offload_routines` diff --git a/source/elements/oneMKL/source/domains/rng/host_api/rng-host-routines.rst b/source/elements/oneMath/source/domains/rng/host_api/rng-host-routines.rst similarity index 74% rename from source/elements/oneMKL/source/domains/rng/host_api/rng-host-routines.rst rename to source/elements/oneMath/source/domains/rng/host_api/rng-host-routines.rst index 053160201..d63e54d2c 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/rng-host-routines.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/rng-host-routines.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_manual_offload_routines: +.. _onemath_rng_manual_offload_routines: Random Number Generators Host Routines ====================================== @@ -13,36 +13,36 @@ RNG domain contains two classes types: - Engines (basic random number generators) classes, which holds the state of generator and is a source of independent and identically distributed random variables. - Refer to :ref:`onemkl_rng_engines_basic_random_number_generators` + Refer to :ref:`onemath_rng_engines_basic_random_number_generators` for a detailed description. - Distribution classes templates (transformation classes) for different types of statistical distributions, for example, uniform, normal (Gaussian), binomial, etc. These classes contain all of the distribution’s parameters - (including generation method). Refer to :ref:`onemkl_rng_distributions` for + (including generation method). Refer to :ref:`onemath_rng_distributions` for a detailed description of the distributions. The RNG domain also contains two types of free functions: - Generation routines. The current routines are used to obtain random numbers from a given engine with proper statistics defined by a - given distribution. Refer to the :ref:`onemkl_rng_generate_routine` + given distribution. Refer to the :ref:`onemath_rng_generate_routine` section for a detailed description. - - Service routines. The routines are used to modify the engine state. Refer to :ref:`onemkl_rng_service_routines` for a + - Service routines. The routines are used to modify the engine state. Refer to :ref:`onemath_rng_service_routines` for a description of these routines. Engine classes work with both generation and service routines. Distribution classes are used in -generation routines only. Refer to the :ref:`onemkl_rng_usage_model` +generation routines only. Refer to the :ref:`onemath_rng_usage_model` section for the description of typical RNG scenario. .. toctree:: :hidden: - onemkl-rng-usage-model.rst + onemath-rng-usage-model.rst generate-routine.rst engines-basic-random-number-generators.rst service-routines.rst distributions.rst ../bibliography.rst -**Parent topic:** :ref:`onemkl_rng` \ No newline at end of file +**Parent topic:** :ref:`onemath_rng` \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/rng/host_api/service-routines.rst b/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst similarity index 72% rename from source/elements/oneMKL/source/domains/rng/host_api/service-routines.rst rename to source/elements/oneMath/source/domains/rng/host_api/service-routines.rst index 08c0c072d..78cb46e30 100644 --- a/source/elements/oneMKL/source/domains/rng/host_api/service-routines.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_service_routines: +.. _onemath_rng_service_routines: Host Service Routines ===================== @@ -19,14 +19,14 @@ Host Service Routines * - Routine - Description - * - \ :ref:`onemkl_rng_leapfrog`\ + * - \ :ref:`onemath_rng_leapfrog`\ - Proceed state of engine by the leapfrog method to generate a subsequence of the original sequence - * - \ :ref:`onemkl_rng_skip_ahead`\ + * - \ :ref:`onemath_rng_skip_ahead`\ - Proceed state of engine by the skip-ahead method to skip a given number of elements from the original sequence - **Parent topic:** :ref:`onemkl_rng_manual_offload_routines` + **Parent topic:** :ref:`onemath_rng_manual_offload_routines` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/rng/onemkl-rng-overview.rst b/source/elements/oneMath/source/domains/rng/onemath-rng-overview.rst similarity index 83% rename from source/elements/oneMKL/source/domains/rng/onemkl-rng-overview.rst rename to source/elements/oneMath/source/domains/rng/onemath-rng-overview.rst index ddf440a33..f96fb1d15 100755 --- a/source/elements/oneMKL/source/domains/rng/onemkl-rng-overview.rst +++ b/source/elements/oneMath/source/domains/rng/onemath-rng-overview.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_rng_overview: +.. _onemath_rng_overview: Random Number Generators (RNG) ============================== @@ -40,9 +40,9 @@ In computational statistics, random variate generation is usually made in two st RNG domain supports two execution models: - #. :ref:`Host API`, which is aligned with the rest of oneMKL domains - :ref:`oneMKL domains`. - #. :ref:`Device API`, which is specific for RNG domain. These APIs + #. :ref:`Host API`, which is aligned with the rest of oneMath domains + :ref:`oneMath domains`. + #. :ref:`Device API`, which is specific for RNG domain. These APIs are designed to be callable from the User's kernels as well as Host code. @@ -52,4 +52,4 @@ RNG domain supports two execution models: host_api/rng-host-routines.rst device_api/device-routines.rst -**Parent topic:** :ref:`onemkl_rng` +**Parent topic:** :ref:`onemath_rng` diff --git a/source/elements/oneMKL/source/domains/sparse_linear_algebra.inc.rst b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst similarity index 91% rename from source/elements/oneMKL/source/domains/sparse_linear_algebra.inc.rst rename to source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst index b48583bd7..2546026f4 100644 --- a/source/elements/oneMKL/source/domains/sparse_linear_algebra.inc.rst +++ b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_linear_algebra: +.. _onemath_sparse_linear_algebra: Sparse Linear Algebra ---------------------- @@ -12,7 +12,7 @@ Sparse Linear Algebra The oneAPI Math Kernel Library provides a C++ interface to a set of Sparse Linear Algebra routines using SYCL. - :ref:`onemkl_spblas` provides basic operations on sparse vectors and + :ref:`onemath_spblas` provides basic operations on sparse vectors and matrices. Most operations are split into three stages: query of the external workspace size, optimization stage and execution. For a given configuration, the first two stages would typically be called once for a set of input diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/data_handles.rst b/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst similarity index 69% rename from source/elements/oneMKL/source/domains/spblas/data_types/data_handles.rst rename to source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst index dfcf92212..15ff3eab1 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/data_handles.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_data_handles: +.. _onemath_sparse_data_handles: Data handles ============ -.. _onemkl_sparse_dense_vector_handle: +.. _onemath_sparse_dense_vector_handle: Dense vector handle ------------------- @@ -33,11 +33,11 @@ Dense vector handle See related functions: - - :ref:`onemkl_sparse_init_dense_vector` - - :ref:`onemkl_sparse_set_dense_vector_data` - - :ref:`onemkl_sparse_release_dense_vector` + - :ref:`onemath_sparse_init_dense_vector` + - :ref:`onemath_sparse_set_dense_vector_data` + - :ref:`onemath_sparse_release_dense_vector` -.. _onemkl_sparse_dense_matrix_handle: +.. _onemath_sparse_dense_matrix_handle: Dense matrix handle ------------------- @@ -63,11 +63,11 @@ Dense matrix handle See related functions: - - :ref:`onemkl_sparse_init_dense_matrix` - - :ref:`onemkl_sparse_set_dense_matrix_data` - - :ref:`onemkl_sparse_release_dense_matrix` + - :ref:`onemath_sparse_init_dense_matrix` + - :ref:`onemath_sparse_set_dense_matrix_data` + - :ref:`onemath_sparse_release_dense_matrix` -.. _onemkl_sparse_matrix_handle: +.. _onemath_sparse_matrix_handle: Sparse matrix handle -------------------- @@ -93,14 +93,14 @@ Sparse matrix handle See related functions: - - :ref:`onemkl_sparse_init_coo_matrix` - - :ref:`onemkl_sparse_init_csr_matrix` - - :ref:`onemkl_sparse_set_coo_matrix_data` - - :ref:`onemkl_sparse_set_csr_matrix_data` - - :ref:`onemkl_sparse_set_matrix_property` - - :ref:`onemkl_sparse_release_sparse_matrix` + - :ref:`onemath_sparse_init_coo_matrix` + - :ref:`onemath_sparse_init_csr_matrix` + - :ref:`onemath_sparse_set_coo_matrix_data` + - :ref:`onemath_sparse_set_csr_matrix_data` + - :ref:`onemath_sparse_set_matrix_property` + - :ref:`onemath_sparse_release_sparse_matrix` - See a description of the supported :ref:`sparse formats`. + See a description of the supported :ref:`sparse formats`. .. toctree:: :hidden: @@ -119,4 +119,4 @@ Sparse matrix handle set_matrix_property format-descriptions -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/format-descriptions.rst b/source/elements/oneMath/source/domains/spblas/data_types/format-descriptions.rst similarity index 96% rename from source/elements/oneMKL/source/domains/spblas/data_types/format-descriptions.rst rename to source/elements/oneMath/source/domains/spblas/data_types/format-descriptions.rst index 33ab4b153..286bbb8d1 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/format-descriptions.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/format-descriptions.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_format_descriptions: +.. _onemath_sparse_format_descriptions: Sparse storage formats ====================== @@ -13,12 +13,12 @@ Compressed Sparse Row (CSR) format. In this specification, "non-zero" elements or "non-zero" entries refer to explicitly defined elements or entries which may take any value supported by the -the `:ref:data type`. Undefined elements or +the `:ref:data type`. Undefined elements or entries are implicitly zeros. .. container:: section - .. _onemkl_sparse_coo: + .. _onemath_sparse_coo: .. rubric:: COO @@ -87,7 +87,7 @@ one-based indexing): .. container:: section - .. _onemkl_sparse_csr: + .. _onemath_sparse_csr: .. rubric:: CSR @@ -152,4 +152,4 @@ zero-based indexing): | val | 1 | 2 | -1 | 4 | 3 | +------------+------------+-----------+-----------+-----------+-----------+ -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/init_coo_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst similarity index 79% rename from source/elements/oneMKL/source/domains/spblas/data_types/init_coo_matrix.rst rename to source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst index 7f955e388..c980afc7c 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/init_coo_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_init_coo_matrix: +.. _onemath_sparse_init_coo_matrix: init_coo_matrix =============== @@ -27,13 +27,13 @@ certain math operations where the output is a sparse matrix, e.g., sparse matrix addition (sparse matrix + sparse matrix = sparse matrix), and multiplication of two sparse matrices, the number of non-zero elements in the output sparse matrix are not known in advance and must be calculated as part of the operation API. -Such APIs are currently not part of the oneMKL Specification, but will be added +Such APIs are currently not part of the oneMath Specification, but will be added in the future. This behavior is currently left to be implementation-defined, but -may be clarified in the oneMKL Specification in the future. +may be clarified in the oneMath Specification in the future. -See :ref:`onemkl_sparse_matrix_handle`. +See :ref:`onemath_sparse_matrix_handle`. -.. _onemkl_sparse_init_coo_matrix_buffer: +.. _onemath_sparse_init_coo_matrix_buffer: init_coo_matrix (Buffer version) -------------------------------- @@ -62,10 +62,10 @@ init_coo_matrix (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. indexType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -90,22 +90,22 @@ init_coo_matrix (Buffer version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ind Buffer of length at least ``nnz`` containing the row indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``row_ind``. col_ind Buffer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``col_ind``. val Buffer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are implicit - zeros. Refer to :ref:`onemkl_sparse_coo` format for detailed description + zeros. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``val``. .. container:: section @@ -134,12 +134,12 @@ init_coo_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_init_coo_matrix_usm: +.. _onemath_sparse_init_coo_matrix_usm: init_coo_matrix (USM version) ----------------------------- @@ -168,10 +168,10 @@ init_coo_matrix (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. indexType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -196,24 +196,24 @@ init_coo_matrix (USM version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ind USM pointer of length at least ``nnz`` containing the row indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``row_ind``. The data must be accessible on the device. col_ind USM pointer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``col_ind``. The data must be accessible on the device. val USM pointer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are - implicit zeros. Refer to :ref:`onemkl_sparse_coo` format for detailed + implicit zeros. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``val``. The data must be accessible on the device. Using a USM pointer with a smaller allocated memory size is undefined behavior. @@ -243,9 +243,9 @@ init_coo_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/init_csr_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst similarity index 79% rename from source/elements/oneMKL/source/domains/spblas/data_types/init_csr_matrix.rst rename to source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst index cf8a14eb2..e3c701c66 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/init_csr_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_init_csr_matrix: +.. _onemath_sparse_init_csr_matrix: init_csr_matrix =============== @@ -28,13 +28,13 @@ certain math operations where the output is a sparse matrix, e.g., sparse matrix addition (sparse matrix + sparse matrix = sparse matrix), and multiplication of two sparse matrices, the number of non-zero elements in the output sparse matrix are not known in advance and must be calculated as part of the operation API. -Such APIs are currently not part of the oneMKL Specification, but will be added +Such APIs are currently not part of the oneMath Specification, but will be added in the future. This behavior is currently left to be implementation-defined, but -may be clarified in the oneMKL Specification in the future. +may be clarified in the oneMath Specification in the future. -See :ref:`onemkl_sparse_matrix_handle`. +See :ref:`onemath_sparse_matrix_handle`. -.. _onemkl_sparse_init_csr_matrix_buffer: +.. _onemath_sparse_init_csr_matrix_buffer: init_csr_matrix (Buffer version) -------------------------------- @@ -63,10 +63,10 @@ init_csr_matrix (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. indexType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -91,21 +91,21 @@ init_csr_matrix (Buffer version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ptr Buffer of length at least ``num_rows+1``. Refer to - :ref:`onemkl_sparse_csr` format for detailed description of ``row_ptr``. + :ref:`onemath_sparse_csr` format for detailed description of ``row_ptr``. col_ind Buffer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_csr` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``col_ind``. val Buffer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are implicit - zeros. Refer to :ref:`onemkl_sparse_csr` format for detailed description + zeros. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``val``. .. container:: section @@ -134,12 +134,12 @@ init_csr_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_init_csr_matrix_usm: +.. _onemath_sparse_init_csr_matrix_usm: init_csr_matrix (USM version) ----------------------------- @@ -168,10 +168,10 @@ init_csr_matrix (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. indexType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -196,23 +196,23 @@ init_csr_matrix (USM version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ptr USM pointer of length at least ``num_rows+1``. Refer to - :ref:`onemkl_sparse_csr` format for detailed description of ``row_ptr``. + :ref:`onemath_sparse_csr` format for detailed description of ``row_ptr``. The data must be accessible on the device. col_ind USM pointer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_csr` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``col_ind``. The data must be accessible on the device. val USM pointer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are - implicit zeros. Refer to :ref:`onemkl_sparse_csr` format for detailed + implicit zeros. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``val``. The data must be accessible on the device. Using a USM pointer with a smaller allocated memory size is undefined behavior. @@ -242,9 +242,9 @@ init_csr_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/init_dense_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst similarity index 84% rename from source/elements/oneMKL/source/domains/spblas/data_types/init_dense_matrix.rst rename to source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst index 15c37b498..3b834dae6 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/init_dense_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_init_dense_matrix: +.. _onemath_sparse_init_dense_matrix: init_dense_matrix ================= @@ -21,9 +21,9 @@ with ``set_dense_matrix_data``. In the case of USM, the object does not take ownership of the data. -See :ref:`onemkl_sparse_dense_matrix_handle`. +See :ref:`onemath_sparse_dense_matrix_handle`. -.. _onemkl_sparse_init_dense_matrix_buffer: +.. _onemath_sparse_init_dense_matrix_buffer: init_dense_matrix (Buffer version) ---------------------------------- @@ -50,7 +50,7 @@ init_dense_matrix (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -100,12 +100,12 @@ init_dense_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_init_dense_matrix_usm: +.. _onemath_sparse_init_dense_matrix_usm: init_dense_matrix (USM version) ------------------------------- @@ -132,7 +132,7 @@ init_dense_matrix (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -183,9 +183,9 @@ init_dense_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/init_dense_vector.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst similarity index 80% rename from source/elements/oneMKL/source/domains/spblas/data_types/init_dense_vector.rst rename to source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst index 50b6de6c7..f785688d2 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/init_dense_vector.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_init_dense_vector: +.. _onemath_sparse_init_dense_vector: init_dense_vector ================= @@ -21,9 +21,9 @@ with ``set_dense_vector_data``. In the case of USM, the object does not take ownership of the data. -See :ref:`onemkl_sparse_dense_vector_handle`. +See :ref:`onemath_sparse_dense_vector_handle`. -.. _onemkl_sparse_init_dense_vector_buffer: +.. _onemath_sparse_init_dense_vector_buffer: init_dense_vector (Buffer version) ---------------------------------- @@ -47,7 +47,7 @@ init_dense_vector (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -85,12 +85,12 @@ init_dense_vector (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_init_dense_vector_usm: +.. _onemath_sparse_init_dense_vector_usm: init_dense_vector (USM version) ------------------------------- @@ -114,7 +114,7 @@ init_dense_vector (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. + See :ref:`supported template types`. .. container:: section @@ -153,9 +153,9 @@ init_dense_vector (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/release_dense_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst similarity index 79% rename from source/elements/oneMKL/source/domains/spblas/data_types/release_dense_matrix.rst rename to source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst index 2d77606e1..6f736e23f 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/release_dense_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_release_dense_matrix: +.. _onemath_sparse_release_dense_matrix: release_dense_matrix ==================== @@ -38,7 +38,7 @@ If a USM pointer was provided, the data is not free'd. The SYCL command queue which will be used for SYCL kernels execution. dmhandle - Handle initialized with :ref:`onemkl_sparse_init_dense_matrix`. + Handle initialized with :ref:`onemath_sparse_init_dense_matrix`. dependencies List of events to depend on before starting asynchronous tasks that access @@ -60,8 +60,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/release_dense_vector.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst similarity index 79% rename from source/elements/oneMKL/source/domains/spblas/data_types/release_dense_vector.rst rename to source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst index 73b186048..5eea90af1 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/release_dense_vector.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_release_dense_vector: +.. _onemath_sparse_release_dense_vector: release_dense_vector ==================== @@ -38,7 +38,7 @@ If a USM pointer was provided, the data is not free'd. The SYCL command queue which will be used for SYCL kernels execution. dvhandle - Handle initialized with :ref:`onemkl_sparse_init_dense_vector`. + Handle initialized with :ref:`onemath_sparse_init_dense_vector`. dependencies List of events to depend on before starting asynchronous tasks that access @@ -60,8 +60,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/release_sparse_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst similarity index 77% rename from source/elements/oneMKL/source/domains/spblas/data_types/release_sparse_matrix.rst rename to source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst index d1d549335..0dffa6aba 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/release_sparse_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_release_sparse_matrix: +.. _onemath_sparse_release_sparse_matrix: release_sparse_matrix ===================== @@ -38,8 +38,8 @@ If a USM pointer was provided, the data is not free'd. The SYCL command queue which will be used for SYCL kernels execution. smhandle - Handle initialized with :ref:`onemkl_sparse_init_csr_matrix` or - :ref:`onemkl_sparse_init_coo_matrix`. + Handle initialized with :ref:`onemath_sparse_init_csr_matrix` or + :ref:`onemath_sparse_init_coo_matrix`. dependencies List of events to depend on before starting asynchronous tasks that access @@ -61,8 +61,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` \ No newline at end of file +**Parent topic:** :ref:`onemath_sparse_data_handles` \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/set_coo_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst similarity index 76% rename from source/elements/oneMKL/source/domains/spblas/data_types/set_coo_matrix_data.rst rename to source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst index a12311d31..f9ef07239 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/set_coo_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_set_coo_matrix_data: +.. _onemath_sparse_set_coo_matrix_data: set_coo_matrix_data =================== @@ -21,9 +21,9 @@ with ``set_coo_matrix_data``. In the case of USM, the object does not take ownership of the data. -Also see :ref:`onemkl_sparse_init_coo_matrix`. +Also see :ref:`onemath_sparse_init_coo_matrix`. -.. _onemkl_sparse_set_coo_matrix_data_buffer: +.. _onemath_sparse_set_coo_matrix_data_buffer: set_coo_matrix_data (Buffer version) ------------------------------------ @@ -52,11 +52,11 @@ set_coo_matrix_data (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. indexType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. .. container:: section @@ -67,7 +67,7 @@ set_coo_matrix_data (Buffer version) The SYCL command queue which will be used for SYCL kernels execution. smhandle - Handle already initialized with :ref:`onemkl_sparse_init_coo_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_coo_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 0. @@ -81,22 +81,22 @@ set_coo_matrix_data (Buffer version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ind Buffer of length at least ``nnz`` containing the row indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``row_ind``. col_ind Buffer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``col_ind``. val Buffer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are implicit - zeros. Refer to :ref:`onemkl_sparse_coo` format for detailed description + zeros. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``val``. .. container:: section @@ -116,12 +116,12 @@ set_coo_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_set_coo_matrix_data_usm: +.. _onemath_sparse_set_coo_matrix_data_usm: set_coo_matrix_data (USM version) --------------------------------- @@ -150,11 +150,11 @@ set_coo_matrix_data (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. indexType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. .. container:: section @@ -165,7 +165,7 @@ set_coo_matrix_data (USM version) The SYCL command queue which will be used for SYCL kernels execution. smhandle - Handle already initialized with :ref:`onemkl_sparse_init_coo_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_coo_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 0. @@ -179,24 +179,24 @@ set_coo_matrix_data (USM version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ind USM pointer of length at least ``nnz`` containing the row indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``row_ind``. The data must be accessible on the device. col_ind USM pointer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_coo` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``col_ind``. The data must be accessible on the device. val USM pointer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are - implicit zeros. Refer to :ref:`onemkl_sparse_coo` format for detailed + implicit zeros. Refer to :ref:`onemath_sparse_coo` format for detailed description of ``val``. The data must be accessible on the device. Using a USM pointer with a smaller allocated memory size is undefined behavior. @@ -217,9 +217,9 @@ set_coo_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/set_csr_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst similarity index 76% rename from source/elements/oneMKL/source/domains/spblas/data_types/set_csr_matrix_data.rst rename to source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst index 8b9527755..22f237b72 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/set_csr_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_set_csr_matrix_data: +.. _onemath_sparse_set_csr_matrix_data: set_csr_matrix_data =================== @@ -21,9 +21,9 @@ with ``set_csr_matrix_data``. In the case of USM, the object does not take ownership of the data. -Also see :ref:`onemkl_sparse_init_csr_matrix`. +Also see :ref:`onemath_sparse_init_csr_matrix`. -.. _onemkl_sparse_set_csr_matrix_data_buffer: +.. _onemath_sparse_set_csr_matrix_data_buffer: set_csr_matrix_data (Buffer version) ------------------------------------ @@ -52,11 +52,11 @@ set_csr_matrix_data (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. indexType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. .. container:: section @@ -67,7 +67,7 @@ set_csr_matrix_data (Buffer version) The SYCL command queue which will be used for SYCL kernels execution. smhandle - Handle already initialized with :ref:`onemkl_sparse_init_csr_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_csr_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 0. @@ -81,21 +81,21 @@ set_csr_matrix_data (Buffer version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ptr Buffer of length at least ``num_rows+1``. Refer to - :ref:`onemkl_sparse_csr` format for detailed description of ``row_ptr``. + :ref:`onemath_sparse_csr` format for detailed description of ``row_ptr``. col_ind Buffer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_csr` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``col_ind``. val Buffer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are implicit - zeros. Refer to :ref:`onemkl_sparse_csr` format for detailed description + zeros. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``val``. .. container:: section @@ -115,12 +115,12 @@ set_csr_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_set_csr_matrix_data_usm: +.. _onemath_sparse_set_csr_matrix_data_usm: set_csr_matrix_data (USM version) --------------------------------- @@ -149,11 +149,11 @@ set_csr_matrix_data (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. indexType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``matrix_handle_t``. .. container:: section @@ -164,7 +164,7 @@ set_csr_matrix_data (USM version) The SYCL command queue which will be used for SYCL kernels execution. smhandle - Handle already initialized with :ref:`onemkl_sparse_init_csr_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_csr_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 0. @@ -178,23 +178,23 @@ set_csr_matrix_data (USM version) index Indicates how input arrays are indexed. The possible options are described - in :ref:`onemkl_enum_index_base` enum class. + in :ref:`onemath_enum_index_base` enum class. row_ptr USM pointer of length at least ``num_rows+1``. Refer to - :ref:`onemkl_sparse_csr` format for detailed description of ``row_ptr``. + :ref:`onemath_sparse_csr` format for detailed description of ``row_ptr``. The data must be accessible on the device. col_ind USM pointer of length at least ``nnz`` containing the column indices in - ``index``-based numbering. Refer to :ref:`onemkl_sparse_csr` format for + ``index``-based numbering. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``col_ind``. The data must be accessible on the device. val USM pointer of length at least ``nnz``. Contains the data of the input matrix which is not implicitly zero. The remaining input values are - implicit zeros. Refer to :ref:`onemkl_sparse_csr` format for detailed + implicit zeros. Refer to :ref:`onemath_sparse_csr` format for detailed description of ``val``. The data must be accessible on the device. Using a USM pointer with a smaller allocated memory size is undefined behavior. @@ -215,9 +215,9 @@ set_csr_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/set_dense_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst similarity index 80% rename from source/elements/oneMKL/source/domains/spblas/data_types/set_dense_matrix_data.rst rename to source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst index 0eab72f6b..0a4ba2a45 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/set_dense_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_set_dense_matrix_data: +.. _onemath_sparse_set_dense_matrix_data: set_dense_matrix_data ===================== @@ -21,9 +21,9 @@ with ``set_dense_matrix_data``. In the case of USM, the object does not take ownership of the data. -Also see :ref:`onemkl_sparse_init_dense_matrix`. +Also see :ref:`onemath_sparse_init_dense_matrix`. -.. _onemkl_sparse_set_dense_matrix_data_buffer: +.. _onemath_sparse_set_dense_matrix_data_buffer: set_dense_matrix_data (Buffer version) -------------------------------------- @@ -50,7 +50,7 @@ set_dense_matrix_data (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``dense_matrix_handle_t``. .. container:: section @@ -61,7 +61,7 @@ set_dense_matrix_data (Buffer version) The SYCL command queue which will be used for SYCL kernels execution. dmhandle - Handle already initialized with :ref:`onemkl_sparse_init_dense_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_dense_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 0. @@ -90,12 +90,12 @@ set_dense_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_set_dense_matrix_data_usm: +.. _onemath_sparse_set_dense_matrix_data_usm: set_dense_matrix_data (USM version) ----------------------------------- @@ -122,7 +122,7 @@ set_dense_matrix_data (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``dense_matrix_handle_t``. .. container:: section @@ -133,7 +133,7 @@ set_dense_matrix_data (USM version) The SYCL command queue which will be used for SYCL kernels execution. dmhandle - Handle already initialized with :ref:`onemkl_sparse_init_dense_matrix`. + Handle already initialized with :ref:`onemath_sparse_init_dense_matrix`. num_rows Number of rows of the provided data ``val``. Must be at least 1. @@ -164,9 +164,9 @@ set_dense_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/set_dense_vector_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst similarity index 74% rename from source/elements/oneMKL/source/domains/spblas/data_types/set_dense_vector_data.rst rename to source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst index c882f0707..37b0d0c8a 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/set_dense_vector_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_set_dense_vector_data: +.. _onemath_sparse_set_dense_vector_data: set_dense_vector_data ===================== @@ -21,9 +21,9 @@ with ``set_dense_vector_data``. In the case of USM, the object does not take ownership of the data. -Also see :ref:`onemkl_sparse_init_dense_vector`. +Also see :ref:`onemath_sparse_init_dense_vector`. -.. _onemkl_sparse_set_dense_vector_data_buffer: +.. _onemath_sparse_set_dense_vector_data_buffer: set_dense_vector_data (Buffer version) -------------------------------------- @@ -47,7 +47,7 @@ set_dense_vector_data (Buffer version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``dense_vector_handle_t``. .. container:: section @@ -58,7 +58,7 @@ set_dense_vector_data (Buffer version) The SYCL command queue which will be used for SYCL kernels execution. dvhandle - Handle already initialized with :ref:`onemkl_sparse_init_dense_vector`. + Handle already initialized with :ref:`onemath_sparse_init_dense_vector`. size Number of elements of the provided data ``val``. Must be at least 0. @@ -75,12 +75,12 @@ set_dense_vector_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_set_dense_vector_data_usm: +.. _onemath_sparse_set_dense_vector_data_usm: set_dense_vector_data (USM version) ----------------------------------- @@ -104,7 +104,7 @@ set_dense_vector_data (USM version) .. rubric:: Template parameters dataType - See :ref:`supported template types`. Must + See :ref:`supported template types`. Must be the same type as was used when creating the ``dense_vector_handle_t``. .. container:: section @@ -115,7 +115,7 @@ set_dense_vector_data (USM version) The SYCL command queue which will be used for SYCL kernels execution. dvhandle - Handle already initialized with :ref:`onemkl_sparse_init_dense_vector`. + Handle already initialized with :ref:`onemath_sparse_init_dense_vector`. size Number of elements of the provided data ``val``. Must be at least 1. @@ -134,9 +134,9 @@ set_dense_vector_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/data_types/set_matrix_property.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst similarity index 86% rename from source/elements/oneMKL/source/domains/spblas/data_types/set_matrix_property.rst rename to source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst index 4e2014b7f..82db60a23 100644 --- a/source/elements/oneMKL/source/domains/spblas/data_types/set_matrix_property.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_set_matrix_property: +.. _onemath_sparse_set_matrix_property: set_matrix_property =================== @@ -25,7 +25,7 @@ Matrix properties } Matrix properties are optional and "strong" guarantees. Unlike - :ref:`onemkl_sparse_matrix_view`, the user must ensure that the handle's data + :ref:`onemath_sparse_matrix_view`, the user must ensure that the handle's data holds all the given properties. A property can be set as a hint for backends to optimize some operations. Multiple properties can be set to the same handle. @@ -126,9 +126,9 @@ matrix handle. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_sparse_data_handles` +**Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMKL/source/domains/spblas/matrix_view.rst b/source/elements/oneMath/source/domains/spblas/matrix_view.rst similarity index 89% rename from source/elements/oneMKL/source/domains/spblas/matrix_view.rst rename to source/elements/oneMath/source/domains/spblas/matrix_view.rst index 0c0bb6535..a4b527bba 100644 --- a/source/elements/oneMKL/source/domains/spblas/matrix_view.rst +++ b/source/elements/oneMath/source/domains/spblas/matrix_view.rst @@ -2,12 +2,12 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_matrix_view_and_descr: +.. _onemath_sparse_matrix_view_and_descr: Matrix view =========== -.. _onemkl_sparse_matrix_descriptor: +.. _onemath_sparse_matrix_descriptor: matrix_descr ------------ @@ -51,7 +51,7 @@ matrix_descr * - ``diagonal`` - View as diagonal, use only main diagonal values. -.. _onemkl_sparse_matrix_view: +.. _onemath_sparse_matrix_view: matrix_view ----------- @@ -81,8 +81,8 @@ matrix_view The matrix view holds information to specify which part of the matrix should be read without changing the matrix's data. - See :ref:`onemkl_sparse_matrix_descriptor`, :ref:`onemkl_enum_uplo` and - :ref:`onemkl_enum_diag` for a description of the members. + See :ref:`onemath_sparse_matrix_descriptor`, :ref:`onemath_enum_uplo` and + :ref:`onemath_enum_diag` for a description of the members. Each operation documents which combination of ``type_view``, ``uplo_view`` and ``diag_view`` are valid. @@ -122,4 +122,4 @@ matrix_view the other members are initialized to the same value as the default constructor. -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMKL/source/domains/spblas/operations/spmm.rst b/source/elements/oneMath/source/domains/spblas/operations/spmm.rst similarity index 86% rename from source/elements/oneMKL/source/domains/spblas/operations/spmm.rst rename to source/elements/oneMath/source/domains/spblas/operations/spmm.rst index 08b64595e..1fcd3a673 100644 --- a/source/elements/oneMKL/source/domains/spblas/operations/spmm.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spmm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_spmm_header: +.. _onemath_sparse_spmm_header: spmm ==== @@ -33,7 +33,7 @@ matrix product defined as: A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} \end{cases} -.. _onemkl_sparse_spmm_descr: +.. _onemath_sparse_spmm_descr: spmm_descr ---------- @@ -59,7 +59,7 @@ spmm_descr stages of the spmm operation to house relevant state, optimizations and workspaces. -.. _onemkl_sparse_init_spmm_descr: +.. _onemath_sparse_init_spmm_descr: init_spmm_descr --------------- @@ -103,12 +103,12 @@ init_spmm_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_release_spmm_descr: +.. _onemath_sparse_release_spmm_descr: release_spmm_descr ------------------ @@ -155,11 +155,11 @@ release_spmm_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_spmm_alg: +.. _onemath_sparse_spmm_alg: spmm_alg -------- @@ -195,7 +195,7 @@ spmm_alg implementation-defined and must be documented in the library implementing the oneAPI specification. -.. _onemkl_sparse_spmm: +.. _onemath_sparse_spmm: spmm ---- @@ -275,11 +275,11 @@ spmm some of the descriptor's data such as the ``workspace``. - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spmm_buffer_size`` or - ``spmm_optimize`` at least once with a given descriptor will throw a - :ref:`oneapi::mkl::uninitialized` + ``spmm_optimize`` at least once with a given descriptor will throw an + :ref:`oneapi::mkl::uninitialized` exception. Calling ``spmm`` with arguments not matching ``spmm_optimize`` will throw a - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` exception, unless stated otherwise. - The data of the dense handles ``B_handle`` and ``C_handle`` and the scalars ``alpha`` and ``beta`` can be reset before each call to ``spmm``. Changing @@ -299,11 +299,11 @@ spmm opA Specifies operation ``op()`` on the input matrix A. The possible options - are described in :ref:`onemkl_enum_transpose` enum class. + are described in :ref:`onemath_enum_transpose` enum class. opB Specifies operation ``op()`` on the input matrix B. The possible options - are described in :ref:`onemkl_enum_transpose` enum class. + are described in :ref:`onemath_enum_transpose` enum class. alpha Host or USM pointer representing :math:`\alpha`. The USM allocation can be @@ -315,7 +315,7 @@ spmm A_view Specifies which part of the handle should be read as described by - :ref:`onemkl_sparse_matrix_view`. The ``type_view`` field must be + :ref:`onemath_sparse_matrix_view`. The ``type_view`` field must be ``matrix_descr::general`` and the ``uplo_view`` and ``diag_view`` fields are ignored. @@ -337,10 +337,10 @@ spmm Dense matrix handle object representing :math:`C`. alg - Specifies the :ref:`spmm algorithm` to use. + Specifies the :ref:`spmm algorithm` to use. spmm_descr - Initialized :ref:`spmm descriptor`. + Initialized :ref:`spmm descriptor`. temp_buffer_size Output buffer size in bytes. @@ -350,7 +350,7 @@ spmm ``temp_buffer_size`` bytes and the address aligned on the size of the handles' data type. | If it is a buffer, its lifetime is extended until the :ref:`spmm - descriptor` is released or the workspace is + descriptor` is released or the workspace is reset by ``spmm_optimize``. The workspace cannot be a sub-buffer. | If it is a USM pointer, it must not be free'd until the corresponding ``spmm`` has completed. The data must be accessible on the device. @@ -387,11 +387,11 @@ spmm implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::computation_error` + | :ref:`oneapi::mkl::device_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMKL/source/domains/spblas/operations/spmv.rst b/source/elements/oneMath/source/domains/spblas/operations/spmv.rst similarity index 87% rename from source/elements/oneMKL/source/domains/spblas/operations/spmv.rst rename to source/elements/oneMath/source/domains/spblas/operations/spmv.rst index cbcc0a026..378326612 100644 --- a/source/elements/oneMKL/source/domains/spblas/operations/spmv.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spmv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_spmv_header: +.. _onemath_sparse_spmv_header: spmv ==== @@ -33,7 +33,7 @@ vector product defined as: A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} \end{cases} -.. _onemkl_sparse_spmv_descr: +.. _onemath_sparse_spmv_descr: spmv_descr ---------- @@ -59,7 +59,7 @@ spmv_descr stages of the spmv operation to house relevant state, optimizations and workspaces. -.. _onemkl_sparse_init_spmv_descr: +.. _onemath_sparse_init_spmv_descr: init_spmv_descr --------------- @@ -103,12 +103,12 @@ init_spmv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_release_spmv_descr: +.. _onemath_sparse_release_spmv_descr: release_spmv_descr ------------------ @@ -155,11 +155,11 @@ release_spmv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_spmv_alg: +.. _onemath_sparse_spmv_alg: spmv_alg -------- @@ -193,7 +193,7 @@ spmv_alg implementation-defined and must be documented in the library implementing the oneAPI specification. -.. _onemkl_sparse_spmv: +.. _onemath_sparse_spmv: spmv ---- @@ -269,11 +269,11 @@ spmv some of the descriptor's data such as the ``workspace``. - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spmv_buffer_size`` or - ``spmv_optimize`` at least once with a given descriptor will throw a - :ref:`oneapi::mkl::uninitialized` + ``spmv_optimize`` at least once with a given descriptor will throw an + :ref:`oneapi::mkl::uninitialized` exception. Calling ``spmv`` with arguments not matching ``spmv_optimize`` will throw a - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::mkl::invalid_argument` exception, unless stated otherwise. - The data of the dense handles ``x_handle`` and ``y_handle`` and the scalars ``alpha`` and ``beta`` can be reset before each call to ``spmv``. Changing @@ -293,7 +293,7 @@ spmv opA Specifies operation ``op()`` on the input matrix. The possible options are - described in :ref:`onemkl_enum_transpose` enum class. + described in :ref:`onemath_enum_transpose` enum class. alpha Host or USM pointer representing :math:`\alpha`. The USM allocation can be @@ -305,7 +305,7 @@ spmv A_view Specifies which part of the handle should be read as described by - :ref:`onemkl_sparse_matrix_view`. The ``type_view`` field cannot be + :ref:`onemath_sparse_matrix_view`. The ``type_view`` field cannot be ``matrix_descr::diagonal``. The ``diag_view`` field can be ``diag::unit`` if and only if ``type_view`` is ``matrix_descr::triangular``. @@ -327,10 +327,10 @@ spmv Dense vector handle object representing :math:`y`. alg - Specifies the :ref:`spmv algorithm` to use. + Specifies the :ref:`spmv algorithm` to use. spmv_descr - Initialized :ref:`spmv descriptor`. + Initialized :ref:`spmv descriptor`. temp_buffer_size Output buffer size in bytes. @@ -340,7 +340,7 @@ spmv ``temp_buffer_size`` bytes and the address aligned on the size of the handles' data type. | If it is a buffer, its lifetime is extended until the :ref:`spmv - descriptor` is released or the workspace is + descriptor` is released or the workspace is reset by ``spmv_optimize``. The workspace cannot be a sub-buffer. | If it is a USM pointer, it must not be free'd until the corresponding ``spmv`` has completed. The data must be accessible on the device. @@ -377,11 +377,11 @@ spmv implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::computation_error` + | :ref:`oneapi::mkl::device_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMKL/source/domains/spblas/operations/spsv.rst b/source/elements/oneMath/source/domains/spblas/operations/spsv.rst similarity index 86% rename from source/elements/oneMKL/source/domains/spblas/operations/spsv.rst rename to source/elements/oneMath/source/domains/spblas/operations/spsv.rst index 146088b63..0c19783da 100644 --- a/source/elements/oneMKL/source/domains/spblas/operations/spsv.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spsv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_spsv_header: +.. _onemath_sparse_spsv_header: spsv ==== @@ -33,7 +33,7 @@ for a square matrix: A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} \end{cases} -.. _onemkl_sparse_spsv_descr: +.. _onemath_sparse_spsv_descr: spsv_descr ---------- @@ -59,7 +59,7 @@ spsv_descr stages of the spsv operation to house relevant state, optimizations and workspaces. -.. _onemkl_sparse_init_spsv_descr: +.. _onemath_sparse_init_spsv_descr: init_spsv_descr --------------- @@ -103,12 +103,12 @@ init_spsv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::host_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_release_spsv_descr: +.. _onemath_sparse_release_spsv_descr: release_spsv_descr ------------------ @@ -155,11 +155,11 @@ release_spsv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::unsupported_device` -.. _onemkl_sparse_spsv_alg: +.. _onemath_sparse_spsv_alg: spsv_alg -------- @@ -188,7 +188,7 @@ spsv_alg implementation-defined and must be documented in the library implementing the oneAPI specification. -.. _onemkl_sparse_spsv: +.. _onemath_sparse_spsv: spsv ---- @@ -261,10 +261,10 @@ spsv - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spsv_buffer_size`` or ``spsv_optimize`` at least once with a given descriptor will throw a - :ref:`oneapi::mkl::uninitialized` + :ref:`oneapi::mkl::uninitialized` exception. Calling ``spsv`` with arguments not matching ``spsv_optimize`` - will throw a - :ref:`oneapi::mkl::invalid_argument` + will throw an + :ref:`oneapi::mkl::invalid_argument` exception, unless stated otherwise. - The data of the dense handle ``x_handle`` and scalar ``alpha`` can be reset before each call to ``spsv``. Changing the data of the sparse handle @@ -284,7 +284,7 @@ spsv opA Specifies operation ``op()`` on the input matrix. The possible options are - described in :ref:`onemkl_enum_transpose` enum class. + described in :ref:`onemath_enum_transpose` enum class. alpha Host or USM pointer representing :math:`\alpha`. The USM allocation can be @@ -293,7 +293,7 @@ spsv A_view Specifies which part of the handle should be read as described by - :ref:`onemkl_sparse_matrix_view`. The ``type_view`` field must be + :ref:`onemath_sparse_matrix_view`. The ``type_view`` field must be ``matrix_descr::triangular``. The ``diag_view`` field can be ``diag::nonunit`` or ``diag::unit``. @@ -307,10 +307,10 @@ spsv Dense vector handle object representing :math:`y`. alg - Specifies the :ref:`spsv algorithm` to use. + Specifies the :ref:`spsv algorithm` to use. spsv_descr - Initialized :ref:`spsv descriptor`. + Initialized :ref:`spsv descriptor`. temp_buffer_size Output buffer size in bytes. @@ -320,7 +320,7 @@ spsv ``temp_buffer_size`` bytes and the address aligned on the size of the handles' data type. | If it is a buffer, its lifetime is extended until the :ref:`spsv - descriptor` is released or the workspace is + descriptor` is released or the workspace is reset by ``spsv_optimize``. The workspace cannot be a sub-buffer. | If it is a USM pointer, it must not be free'd until the corresponding ``spsv`` has completed. The data must be accessible on the device. @@ -357,11 +357,11 @@ spsv implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::mkl::computation_error` + | :ref:`oneapi::mkl::device_bad_alloc` + | :ref:`oneapi::mkl::invalid_argument` + | :ref:`oneapi::mkl::unimplemented` + | :ref:`oneapi::mkl::uninitialized` + | :ref:`oneapi::mkl::unsupported_device` -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMKL/source/domains/spblas/spblas.rst b/source/elements/oneMath/source/domains/spblas/spblas.rst similarity index 73% rename from source/elements/oneMKL/source/domains/spblas/spblas.rst rename to source/elements/oneMath/source/domains/spblas/spblas.rst index eef2b3fb4..a5093af8a 100644 --- a/source/elements/oneMKL/source/domains/spblas/spblas.rst +++ b/source/elements/oneMath/source/domains/spblas/spblas.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_spblas: +.. _onemath_spblas: Sparse BLAS =========== @@ -18,13 +18,13 @@ Sparse BLAS * - Routines and Objects - Description - * - :ref:`onemkl_sparse_data_handles` + * - :ref:`onemath_sparse_data_handles` - Matrix and vector handle types - * - :ref:`onemkl_sparse_spmm_header` + * - :ref:`onemath_sparse_spmm_header` - Compute the product of a sparse matrix with a dense matrix - * - :ref:`onemkl_sparse_spmv_header` + * - :ref:`onemath_sparse_spmv_header` - Compute the product of a sparse matrix with a dense vector - * - :ref:`onemkl_sparse_spsv_header` + * - :ref:`onemath_sparse_spsv_header` - Solve a triangular sparse linear system .. toctree:: @@ -37,4 +37,4 @@ Sparse BLAS matrix_view supported-types -**Parent topic:** :ref:`onemkl_sparse_linear_algebra` +**Parent topic:** :ref:`onemath_sparse_linear_algebra` diff --git a/source/elements/oneMKL/source/domains/spblas/supported-types.rst b/source/elements/oneMath/source/domains/spblas/supported-types.rst similarity index 74% rename from source/elements/oneMKL/source/domains/spblas/supported-types.rst rename to source/elements/oneMath/source/domains/spblas/supported-types.rst index 858f1a699..0268d65d9 100644 --- a/source/elements/oneMKL/source/domains/spblas/supported-types.rst +++ b/source/elements/oneMath/source/domains/spblas/supported-types.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_sparse_supported_types: +.. _onemath_sparse_supported_types: Supported template types ======================== @@ -24,11 +24,11 @@ Supported template types -   ``dataType`` is used to describe the precision (i.e. number of bits) and domain -(i.e. real or complex) of the :ref:`data handles ` +(i.e. real or complex) of the :ref:`data handles ` and the operations using them. ``indexType`` is used to describe the range of integer types such as indices, -offsets or sizes of the :ref:`data handles ` and the +offsets or sizes of the :ref:`data handles ` and the operations using them. -**Parent topic:** :ref:`onemkl_spblas` +**Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMath/source/domains/stats.inc.rst b/source/elements/oneMath/source/domains/stats.inc.rst new file mode 100755 index 000000000..cd23bd2a7 --- /dev/null +++ b/source/elements/oneMath/source/domains/stats.inc.rst @@ -0,0 +1,15 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_stats: + +Summary Statistics +------------------- + +The oneMath provides a set of :ref:`Summary Statistics routines ` that compute basic statistical estimates for single and double precision multi-dimensional datasets. + +.. toctree:: + :hidden: + + stats/onemath_stats_overview.rst \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst similarity index 92% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst index e4f6efae5..99c3cea3f 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_central_moment: +.. _onemath_stats_central_moment: central_moment ============== Entry point to compute central moments up to the 4th order. -.. _onemkl_stats_central_moment_description: +.. _onemath_stats_central_moment_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension). -:ref:`onemkl_stats_central_moment` supports the following precisions for data: +:ref:`onemath_stats_central_moment` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::central_moment function is used to compute an array of c * - ``double`` -.. _onemkl_stats_central_moment_buffer: +.. _onemath_stats_central_moment_buffer: central_moment (buffer version) ------------------------------- @@ -58,7 +58,7 @@ central_moment (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -90,7 +90,7 @@ central_moment (buffer version) oneapi::mkl::invalid_argument Exception is thrown when central_moment_2.get_count() == 0 & central_moment_3.get_count() == 0 & central_moment_4.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_central_moment_usm: +.. _onemath_stats_central_moment_usm: central_moment (USM version) ---------------------------- @@ -122,7 +122,7 @@ central_moment (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -166,5 +166,5 @@ central_moment (USM version) -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment_user_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst index 02e6c1115..69157e915 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_moment_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_central_moment_user_mean: +.. _onemath_stats_central_moment_user_mean: central_moment with provided mean ================================= Entry point to compute central moments up to the 4th order with the provided mean values. -.. _onemkl_stats_central_moment_user_mean_description: +.. _onemath_stats_central_moment_user_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension) with the provided mean values. -:ref:`onemkl_stats_central_moment_user_mean` supports the following precisions for data: +:ref:`onemath_stats_central_moment_user_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::central_moment function is used to compute an array of c * - ``double`` -.. _onemkl_stats_central_moment_user_mean_buffer: +.. _onemath_stats_central_moment_user_mean_buffer: central_moment with provided mean (buffer version) -------------------------------------------------- @@ -57,7 +57,7 @@ central_moment with provided mean (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -93,7 +93,7 @@ central_moment with provided mean (buffer version) Exception is thrown when central_moment_2.get_count() == 0 & central_moment_3.get_count() == 0 & central_moment_4.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_central_moment_user_mean_usm: +.. _onemath_stats_central_moment_user_mean_usm: central_moment with provided mean (USM version) ----------------------------------------------- @@ -126,7 +126,7 @@ central_moment with provided mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -171,5 +171,5 @@ central_moment with provided mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst similarity index 92% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst index 7f6f70adc..c5fb82427 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_central_sum: +.. _onemath_stats_central_sum: central_sum =========== Entry point to compute central sums up to the 4th order. -.. _onemkl_stats_central_sum_description: +.. _onemath_stats_central_sum_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension). -:ref:`onemkl_stats_central_sum` supports the following precisions for data: +:ref:`onemath_stats_central_sum` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::central_sum function is used to compute an array of cent * - ``double`` -.. _onemkl_stats_central_sum_buffer: +.. _onemath_stats_central_sum_buffer: central_sum (Buffer version) ---------------------------- @@ -57,7 +57,7 @@ central_sum (Buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -89,7 +89,7 @@ central_sum (Buffer version) oneapi::mkl::invalid_argument Exception is thrown when central_sum_2.get_count() == 0 & central_sum_3.get_count() == 0 & central_sum_4.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_central_sum_usm: +.. _onemath_stats_central_sum_usm: central_sum (USM version) ------------------------- @@ -123,7 +123,7 @@ central_sum (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -165,5 +165,5 @@ central_sum (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst similarity index 92% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum_user_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst index cf36eda7e..806d0cc7c 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_central_sum_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_central_sum_user_mean: +.. _onemath_stats_central_sum_user_mean: central_sum with provided mean ============================== Entry point to compute central sums up to the 4th order with the provided mean values. -.. _onemkl_stats_central_sum_user_mean_description: +.. _onemath_stats_central_sum_user_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension) with the provided mean values. -:ref:`onemkl_stats_central_sum_user_mean` supports the following precisions for data: +:ref:`onemath_stats_central_sum_user_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::central_sum function is used to compute an array of cent * - ``double`` -.. _onemkl_stats_central_sum_user_mean_buffer: +.. _onemath_stats_central_sum_user_mean_buffer: central_sum with provided mean (buffer version) ----------------------------------------------- @@ -57,7 +57,7 @@ central_sum with provided mean (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -92,7 +92,7 @@ central_sum with provided mean (buffer version) oneapi::mkl::invalid_argument Exception is thrown when central_sum_2.get_count() == 0 & central_sum_3.get_count() == 0 & central_sum_4.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_central_sum_user_mean_usm: +.. _onemath_stats_central_sum_user_mean_usm: central_sum with provided mean (USM version) --------------------------------------------- @@ -125,7 +125,7 @@ central_sum with provided mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -170,5 +170,5 @@ central_sum with provided mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_dataset.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst similarity index 92% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_dataset.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst index 56b235393..ade84873c 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_dataset.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_dataset: +.. _onemath_stats_dataset: dataset ======= The structure consolidates the information of a multi-dimensional dataset. -.. _onemkl_stats_dataset_description: +.. _onemath_stats_dataset_description: .. rubric:: Description -The ``dataset`` struct object is used in :ref:`onemkl_stats_routines` as a multi-dimensional data storage. ``dataset`` struct contains information about observations matrix and its size (dimensions x observations), observations weights and indices for dimensions (defines dimensions to be processed). +The ``dataset`` struct object is used in :ref:`onemath_stats_routines` as a multi-dimensional data storage. ``dataset`` struct contains information about observations matrix and its size (dimensions x observations), observations weights and indices for dimensions (defines dimensions to be processed). -.. _onemkl_stats_dataset_syntax_buffer: +.. _onemath_stats_dataset_syntax_buffer: structure dataset (Buffer version) ---------------------------------- @@ -109,7 +109,7 @@ structure dataset (Buffer version) oneapi::mkl::invalid_argument Exception is thrown when `n_dims_` :math:`\leq 0`, or `n_observations_` :math:`\leq 0`, or `observations_.get_count() == 0` -.. _onemkl_stats_dataset_syntax_usm: +.. _onemath_stats_dataset_syntax_usm: structure dataset (USM version) ------------------------------- @@ -201,5 +201,5 @@ structure dataset (USM version) oneapi::mkl::invalid_argument Exception is thrown when `n_dims_` :math:`\leq 0`, or `n_observations_` :math:`\leq 0`, or `observations_ == nullptr` -**Parent topic:** :ref:`onemkl_stats` +**Parent topic:** :ref:`onemath_stats` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst index 1c5e65b74..76babc5cf 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_kurtosis: +.. _onemath_stats_kurtosis: kurtosis ======== Entry point to compute kurtosis. -.. _onemkl_stats_kurtosis_description: +.. _onemath_stats_kurtosis_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::kurtosis function is used to compute a kurtosis array (kurtosis for each dataset's dimension). -:ref:`onemkl_stats_kurtosis` supports the following precisions for data: +:ref:`onemath_stats_kurtosis` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::kurtosis function is used to compute a kurtosis array (k * - ``double`` -.. _onemkl_stats_kurtosis_buffer: +.. _onemath_stats_kurtosis_buffer: kurtosis (buffer version) ------------------------- @@ -55,7 +55,7 @@ kurtosis (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -81,7 +81,7 @@ kurtosis (buffer version) oneapi::mkl::invalid_argument Exception is thrown when kurtosis.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_kurtosis_usm: +.. _onemath_stats_kurtosis_usm: kurtosis (USM version) ---------------------- @@ -112,7 +112,7 @@ kurtosis (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -148,5 +148,5 @@ kurtosis (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst similarity index 90% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis_user_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst index e09193e15..edaf83806 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_kurtosis_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_kurtosis_user_mean: +.. _onemath_stats_kurtosis_user_mean: kurtosis with provided mean =========================== Entry point to compute kurtosis with the provided mean values. -.. _onemkl_stats_kurtosis_user_mean_description: +.. _onemath_stats_kurtosis_user_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::kurtosis function is used to compute an array of kurtosis (kurtosis for each dataset's dimension) with the provided mean values. -:ref:`onemkl_stats_kurtosis_user_mean` supports the following precisions for data: +:ref:`onemath_stats_kurtosis_user_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::kurtosis function is used to compute an array of kurtosi * - ``double`` -.. _onemkl_stats_kurtosis_user_mean_buffer: +.. _onemath_stats_kurtosis_user_mean_buffer: kurtosis with provided mean (buffer version) -------------------------------------------- @@ -56,7 +56,7 @@ kurtosis with provided mean (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -85,7 +85,7 @@ kurtosis with provided mean (buffer version) oneapi::mkl::invalid_argument Exception is thrown when kurtosis.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_kurtosis_user_mean_usm: +.. _onemath_stats_kurtosis_user_mean_usm: kurtosis with provided mean (USM version) ----------------------------------------- @@ -116,7 +116,7 @@ kurtosis with provided mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -155,5 +155,5 @@ kurtosis with provided mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_make_dataset.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_make_dataset.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst index bb6ff601a..e5aece656 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_make_dataset.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_make_dataset: +.. _onemath_stats_make_dataset: make_dataset ============ Entry point to create a dataset from the provided parameters. -.. _onemkl_stats_make_dataset_description: +.. _onemath_stats_make_dataset_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::make_dataset function is used to create a dataset from the provided storage of the observations matrix, the number of dimensions and observations, and other parameters. -:ref:`onemkl_stats_make_dataset` supports the following precisions for data: +:ref:`onemath_stats_make_dataset` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::make_dataset function is used to create a dataset from t * - ``double`` -.. _onemkl_stats_make_dataset_buffer: +.. _onemath_stats_make_dataset_buffer: make_dataset (buffer version) ----------------------------- @@ -49,7 +49,7 @@ make_dataset (buffer version) .. rubric:: Template Parameters ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. Type Data precision. @@ -87,7 +87,7 @@ make_dataset (buffer version) Dataset holding specified parameters. -.. _onemkl_stats_make_dataset_usm: +.. _onemath_stats_make_dataset_usm: make_dataset (USM version) -------------------------- @@ -108,7 +108,7 @@ make_dataset (USM version) .. rubric:: Template Parameters ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. Type Data precision. @@ -146,4 +146,4 @@ make_dataset (USM version) Dataset holding specified parameters. -**Parent topic:** :ref:`onemkl_stats_service_routines` +**Parent topic:** :ref:`onemath_stats_service_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_max.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_max.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_max.rst index 52feb64ae..7192cf52f 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_max.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_max: +.. _onemath_stats_max: max === Entry point to compute max values. -.. _onemkl_stats_max_description: +.. _onemath_stats_max_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::max function is used to compute a max values arrays (max value for each dataset's dimension). -:ref:`onemkl_stats_max` supports the following precisions for data: +:ref:`onemath_stats_max` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::max function is used to compute a max values arrays (max * - ``double`` -.. _onemkl_stats_max_buffer: +.. _onemath_stats_max_buffer: max (buffer version) -------------------- @@ -54,7 +54,7 @@ max (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -80,7 +80,7 @@ max (buffer version) oneapi::mkl::invalid_argument Exception is thrown when max.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_max_usm: +.. _onemath_stats_max_usm: max (USM version) ----------------- @@ -110,7 +110,7 @@ max (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -146,5 +146,5 @@ max (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst index cd2982e00..54dc14615 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_mean: +.. _onemath_stats_mean: mean ==== Entry point to compute mean values. -.. _onemkl_stats_mean_description: +.. _onemath_stats_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::mean function is used to compute a mean array (mean value for each dataset's dimension). -:ref:`onemkl_stats_mean` supports the following precisions for data: +:ref:`onemath_stats_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::mean function is used to compute a mean array (mean valu * - ``double`` -.. _onemkl_stats_mean_buffer: +.. _onemath_stats_mean_buffer: mean (buffer version) --------------------- @@ -55,7 +55,7 @@ mean (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -81,7 +81,7 @@ mean (buffer version) oneapi::mkl::invalid_argument Exception is thrown when mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_mean_usm: +.. _onemath_stats_mean_usm: mean (USM version) ------------------ @@ -112,7 +112,7 @@ mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -148,5 +148,5 @@ mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_min.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_min.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_min.rst index cdf0c9540..12401792b 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_min.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_min: +.. _onemath_stats_min: min === Entry point to compute min values. -.. _onemkl_stats_min_description: +.. _onemath_stats_min_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::min function is used to compute min arrays (min value for each dataset's dimension). -:ref:`onemkl_stats_min` supports the following precisions for data: +:ref:`onemath_stats_min` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::min function is used to compute min arrays (min value fo * - ``double`` -.. _onemkl_stats_min_buffer: +.. _onemath_stats_min_buffer: min (buffer version) -------------------- @@ -54,7 +54,7 @@ min (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -80,7 +80,7 @@ min (buffer version) oneapi::mkl::invalid_argument Exception is thrown when min.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_min_usm: +.. _onemath_stats_min_usm: min (USM version) ----------------- @@ -110,7 +110,7 @@ min (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -146,5 +146,5 @@ min (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_min_max.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_min_max.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst index a8bb27cce..e2908629e 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_min_max.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_min_max: +.. _onemath_stats_min_max: min_max ======= Entry point to compute min and max values. -.. _onemkl_stats_min_max_description: +.. _onemath_stats_min_max_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::min_max function is used to compute min and max arrays (min and max values for each dataset's dimension). -:ref:`onemkl_stats_min_max` supports the following precisions for data: +:ref:`onemath_stats_min_max` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::min_max function is used to compute min and max arrays ( * - ``double`` -.. _onemkl_stats_min_max_buffer: +.. _onemath_stats_min_max_buffer: min_max (buffer version) ------------------------ @@ -55,7 +55,7 @@ min_max (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -84,7 +84,7 @@ min_max (buffer version) oneapi::mkl::invalid_argument Exception is thrown when min.get_count() == 0, or max.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_min_max_usm: +.. _onemath_stats_min_max_usm: min_max (USM version) --------------------- @@ -115,7 +115,7 @@ min_max (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -154,5 +154,5 @@ min_max (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_overview.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_overview.rst similarity index 65% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_overview.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_overview.rst index 00af7efe1..19cc45c93 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_overview.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_overview.rst @@ -2,31 +2,31 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_overview: +.. _onemath_stats_overview: Summary Statistics ================== .. rubric:: Definitions -The oneMKL Summary Statistics domains consists of: +The oneMath Summary Statistics domains consists of: - * Dataset structure. The structure consolidates the information of a multi-dimensional dataset (see detailed description in :ref:`onemkl_stats_dataset`). - * Computation routines. The routines are represented as free functions (see detailed description for each routine in :ref:`onemkl_stats_routines`): + * Dataset structure. The structure consolidates the information of a multi-dimensional dataset (see detailed description in :ref:`onemath_stats_dataset`). + * Computation routines. The routines are represented as free functions (see detailed description for each routine in :ref:`onemath_stats_routines`): * Raw and central sums / moments up to the fourth order * Variation coefficient * Skewness and excess kurtosis (further referred as kurtosis) * Minimum and maximum -Refer to :ref:`onemkl_stats_usage_model`. +Refer to :ref:`onemath_stats_usage_model`. .. toctree:: :hidden: - onemkl_stats_usage_model.rst - onemkl_stats_dataset.rst - onemkl_stats_routines.rst - onemkl_stats_service_routines.rst + onemath_stats_usage_model.rst + onemath_stats_dataset.rst + onemath_stats_routines.rst + onemath_stats_service_routines.rst -**Parent topic:** :ref:`onemkl_stats` \ No newline at end of file +**Parent topic:** :ref:`onemath_stats` \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_moment.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst similarity index 93% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_moment.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst index 7220e00e2..78dcc5138 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_moment.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_raw_moment: +.. _onemath_stats_raw_moment: raw_moment ========== Entry point to compute raw moments up to the 4th order. -.. _onemkl_stats_raw_moment_description: +.. _onemath_stats_raw_moment_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::raw_moment function is used to compute array of raw moments up to the 4th order (raw moments for each dataset's dimension). -:ref:`onemkl_stats_raw_moment` supports the following precisions for data: +:ref:`onemath_stats_raw_moment` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::raw_moment function is used to compute array of raw mome * - ``double`` -.. _onemkl_stats_raw_moment_buffer: +.. _onemath_stats_raw_moment_buffer: oneapi::mkl::stats::raw_moment (buffer version) ----------------------------------------------- @@ -58,7 +58,7 @@ oneapi::mkl::stats::raw_moment (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -93,7 +93,7 @@ oneapi::mkl::stats::raw_moment (buffer version) oneapi::mkl::invalid_argument Exception is thrown when mean.get_count() == 0 & raw_moment_2.get_count() == 0 & raw_moment_3.get_count() == 0 & raw_moment_4.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_raw_moment_usm: +.. _onemath_stats_raw_moment_usm: raw_moment (USM version) ------------------------ @@ -128,7 +128,7 @@ raw_moment (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -173,5 +173,5 @@ raw_moment (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_sum.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst similarity index 93% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_sum.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst index 453ee45cd..58817e3b7 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_raw_sum.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_raw_sum: +.. _onemath_stats_raw_sum: raw_sum ======= Entry point to compute raw sums up to the 4th order. -.. _onemkl_stats_raw_sum_description: +.. _onemath_stats_raw_sum_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::raw_sum function is used to compute an array of raw sums up to the 4th order (raw sums for each dataset's dimension). -:ref:`onemkl_stats_raw_sum` supports the following precisions for data: +:ref:`onemath_stats_raw_sum` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::raw_sum function is used to compute an array of raw sums * - ``double`` -.. _onemkl_stats_raw_sum_buffer: +.. _onemath_stats_raw_sum_buffer: raw_sum (Buffer version) ------------------------ @@ -58,7 +58,7 @@ raw_sum (Buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -93,7 +93,7 @@ raw_sum (Buffer version) oneapi::mkl::invalid_argument Exception is thrown when sum.get_count() == 0 & raw_sum_2.get_count() == 0 & raw_sum_3.get_count() == 0 & raw_sum_4.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_raw_sum_usm: +.. _onemath_stats_raw_sum_usm: raw_sum (USM version) --------------------- @@ -127,7 +127,7 @@ raw_sum (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -172,5 +172,5 @@ raw_sum (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_routines.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_routines.rst new file mode 100755 index 000000000..7cf9822c4 --- /dev/null +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_routines.rst @@ -0,0 +1,76 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_stats_routines: + +Summary Statistics Routines +=========================== + +The oneMath Summary Statistics routines calculate next estimates: + +.. container:: + + .. container:: tablenoborder + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - :ref:`onemath_stats_raw_sum` + - Raw sums up to the fourth order + * - :ref:`onemath_stats_central_sum` + - Central sums up to the fourth order + * - :ref:`onemath_stats_central_sum_user_mean` + - Central sums up to the fourth order with provided mean + * - :ref:`onemath_stats_mean` + - Mean value + * - :ref:`onemath_stats_raw_moment` + - Raw moments up to the fourth order + * - :ref:`onemath_stats_central_moment` + - Central moments up to the fourth order + * - :ref:`onemath_stats_central_moment_user_mean` + - Central moments up to the fourth order with provided mean + * - :ref:`onemath_stats_variation` + - Variation coefficient + * - :ref:`onemath_stats_variation_user_mean` + - Variation coefficient with provided mean + * - :ref:`onemath_stats_skewness` + - Skewness value + * - :ref:`onemath_stats_skewness_user_mean` + - Skewness value with provided mean + * - :ref:`onemath_stats_kurtosis` + - Kurtosis value + * - :ref:`onemath_stats_kurtosis_user_mean` + - Kurtosis value with provided mean + * - :ref:`onemath_stats_min` + - Min value + * - :ref:`onemath_stats_max` + - Max value + * - :ref:`onemath_stats_min_max` + - Min and max values +   + **Parent topic:** :ref:`onemath_stats` + + + +.. toctree:: + :hidden: + + onemath_stats_raw_sum + onemath_stats_central_sum + onemath_stats_central_sum_user_mean + onemath_stats_mean + onemath_stats_raw_moment + onemath_stats_central_moment + onemath_stats_central_moment_user_mean + onemath_stats_variation + onemath_stats_variation_user_mean + onemath_stats_skewness + onemath_stats_skewness_user_mean + onemath_stats_kurtosis + onemath_stats_kurtosis_user_mean + onemath_stats_min + onemath_stats_max + onemath_stats_min_max \ No newline at end of file diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_service_routines.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_service_routines.rst similarity index 67% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_service_routines.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_service_routines.rst index aae6a421e..7e2ca9710 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_service_routines.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_service_routines.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_service_routines: +.. _onemath_stats_service_routines: Service Routines ================ @@ -19,14 +19,14 @@ Service Routines * - Routine - Description - * - \ :ref:`onemkl_stats_make_dataset`\ + * - \ :ref:`onemath_stats_make_dataset`\ - Creates a dataset from the provided parameters - **Parent topic:** :ref:`onemkl_stats` + **Parent topic:** :ref:`onemath_stats` .. toctree:: :hidden: - onemkl_stats_make_dataset + onemath_stats_make_dataset diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst index d8ab16d8b..cea6f4d96 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_skewness: +.. _onemath_stats_skewness: skewness ======== Entry point to compute skewness. -.. _onemkl_stats_skewness_description: +.. _onemath_stats_skewness_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::skewness function is used to compute a skewness array (skewness for each dataset's dimension). -:ref:`onemkl_stats_skewness` supports the following precisions for data: +:ref:`onemath_stats_skewness` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::skewness function is used to compute a skewness array (s * - ``double`` -.. _onemkl_stats_skewness_buffer: +.. _onemath_stats_skewness_buffer: skewness (buffer version) ------------------------- @@ -55,7 +55,7 @@ skewness (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -81,7 +81,7 @@ skewness (buffer version) oneapi::mkl::invalid_argument Exception is thrown when skewness.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_skewness_usm: +.. _onemath_stats_skewness_usm: skewness (USM version) ---------------------- @@ -112,7 +112,7 @@ skewness (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -148,5 +148,5 @@ skewness (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst similarity index 90% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness_user_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst index 93429aabc..01514435e 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_skewness_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_skewness_user_mean: +.. _onemath_stats_skewness_user_mean: skewness with provided mean =========================== Entry point to compute skewness with the provided mean values. -.. _onemkl_stats_skewness_user_mean_description: +.. _onemath_stats_skewness_user_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::skewness function is used to compute an array of skewness (skewness for each dataset's dimension) with the provided mean values. -:ref:`onemkl_stats_skewness_user_mean` supports the following precisions for data: +:ref:`onemath_stats_skewness_user_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::skewness function is used to compute an array of skewnes * - ``double`` -.. _onemkl_stats_skewness_user_mean_buffer: +.. _onemath_stats_skewness_user_mean_buffer: skewness with provided mean (buffer version) -------------------------------------------- @@ -55,7 +55,7 @@ skewness with provided mean (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -84,7 +84,7 @@ skewness with provided mean (buffer version) oneapi::mkl::invalid_argument Exception is thrown when skewness.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_skewness_user_mean_usm: +.. _onemath_stats_skewness_user_mean_usm: skewness with provided mean (USM version) ----------------------------------------- @@ -115,7 +115,7 @@ skewness with provided mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -154,5 +154,5 @@ skewness with provided mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_usage_model.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst similarity index 87% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_usage_model.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst index bb6d634ab..4a244f619 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_usage_model.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst @@ -2,9 +2,9 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_usage_model: +.. _onemath_stats_usage_model: -oneMKL Summary Statistics Usage Model +oneMath Summary Statistics Usage Model ===================================== @@ -17,7 +17,7 @@ A typical algorithm for summary statistics is as follows: #. Call the summary statistics routine to calculate the appropriate estimate. -The following example demonstrates how to calculate mean values for a 3-dimensional dataset filled with random numbers. For dataset creation, the :ref:`onemkl_stats_make_dataset` helper function is used. +The following example demonstrates how to calculate mean values for a 3-dimensional dataset filled with random numbers. For dataset creation, the :ref:`onemath_stats_make_dataset` helper function is used. USM-based example @@ -48,4 +48,4 @@ USM-based example // ... } -**Parent topic:** :ref:`onemkl_stats` +**Parent topic:** :ref:`onemath_stats` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_variation.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst similarity index 91% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_variation.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst index cf5e14861..f5d1fb095 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_variation.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_variation: +.. _onemath_stats_variation: variation ========= Entry point to compute variation. -.. _onemkl_stats_variation_description: +.. _onemath_stats_variation_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::variation function is used to compute a variation array (variation for each dataset's dimension). -:ref:`onemkl_stats_variation` supports the following precisions for data: +:ref:`onemath_stats_variation` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::variation function is used to compute a variation array * - ``double`` -.. _onemkl_stats_variation_buffer: +.. _onemath_stats_variation_buffer: variation (buffer version) -------------------------- @@ -55,7 +55,7 @@ variation (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -81,7 +81,7 @@ variation (buffer version) oneapi::mkl::invalid_argument Exception is thrown when variation.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_variation_usm: +.. _onemath_stats_variation_usm: variation (USM version) ----------------------- @@ -112,7 +112,7 @@ variation (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -148,5 +148,5 @@ variation (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/stats/onemkl_stats_variation_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst similarity index 90% rename from source/elements/oneMKL/source/domains/stats/onemkl_stats_variation_user_mean.rst rename to source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst index dcec77f5b..b678711b3 100755 --- a/source/elements/oneMKL/source/domains/stats/onemkl_stats_variation_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst @@ -2,20 +2,20 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_stats_variation_user_mean: +.. _onemath_stats_variation_user_mean: variation with provided mean ============================ Entry point to compute variation with the provided mean values. -.. _onemkl_stats_variation_user_mean_description: +.. _onemath_stats_variation_user_mean_description: .. rubric:: Description and Assumptions The oneapi::mkl::stats::variation function is used to compute an array of variation (variation for each dataset's dimension) with the provided mean values. -:ref:`onemkl_stats_variation_user_mean` supports the following precisions for data: +:ref:`onemath_stats_variation_user_mean` supports the following precisions for data: .. list-table:: :header-rows: 1 @@ -25,7 +25,7 @@ The oneapi::mkl::stats::variation function is used to compute an array of variat * - ``double`` -.. _onemkl_stats_variation_user_mean_buffer: +.. _onemath_stats_variation_user_mean_buffer: oneapi::mkl::stats::variation (buffer version) ---------------------------------------------- @@ -54,7 +54,7 @@ oneapi::mkl::stats::variation (buffer version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -84,7 +84,7 @@ oneapi::mkl::stats::variation (buffer version) oneapi::mkl::invalid_argument Exception is thrown when variation.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid -.. _onemkl_stats_variation_user_mean_usm: +.. _onemath_stats_variation_user_mean_usm: variation with provided mean (USM version) ------------------------------------------ @@ -115,7 +115,7 @@ variation with provided mean (USM version) Data precision. ObservationsLayout - Data layout. The specific values are described in :ref:`onemkl_stats_dataset`. + Data layout. The specific values are described in :ref:`onemath_stats_dataset`. .. container:: section @@ -153,5 +153,5 @@ variation with provided mean (USM version) Output event to wait on to ensure computation is complete. -**Parent topic:** :ref:`onemkl_stats_routines` +**Parent topic:** :ref:`onemath_stats_routines` diff --git a/source/elements/oneMKL/source/domains/value_or_pointer.rst b/source/elements/oneMath/source/domains/value_or_pointer.rst similarity index 89% rename from source/elements/oneMKL/source/domains/value_or_pointer.rst rename to source/elements/oneMath/source/domains/value_or_pointer.rst index aef22f5a3..93fdacbb4 100644 --- a/source/elements/oneMKL/source/domains/value_or_pointer.rst +++ b/source/elements/oneMath/source/domains/value_or_pointer.rst @@ -9,7 +9,7 @@ Scalar Arguments in BLAS .. container:: - The USM version of oneMKL BLAS routines for DPC++ will accept either + The USM version of oneMath BLAS routines for DPC++ will accept either a scalar (for example ``float``) or pointer (``float*``) for parameters that represent a single fixed value (not a vector or matrix). These parameters are often named ``alpha`` or ``beta`` in BLAS. @@ -60,21 +60,21 @@ Scalar Arguments in BLAS :name: wrapper-time :class: sectiontitle - The USM version of oneMKL BLAS routines use a templated + The USM version of oneMath BLAS routines use a templated ``value_or_pointer`` wrapper to enable either pointers or values to be passed to routines that take a scalar parameter. In general, users should not explicitly use this type in their code. There is no need to construct an object of type - ``value_or_pointer`` in order to use the oneMKL functions that + ``value_or_pointer`` in order to use the oneMath functions that include it in their function signatures. Instead, values and pointers in user code will be implicitly converted to this type when a user - calls a oneMKL function. + calls a oneMath function. The ``value_or_pointer`` wrapper has two constructors, one that converts a value of type ``T`` (or anything convertible to ``T``) to ``value_or_pointer``, and another that converts a pointer to ``T`` - to ``value_or_pointer``. Internally, the oneMKL functions can + to ``value_or_pointer``. Internally, the oneMath functions can behave slightly differently depending on whether the underlying data is a value or a pointer, and if it points to host-side memory or device-side memory, but these uses should be transparent to users. @@ -85,7 +85,7 @@ Scalar Arguments in BLAS :name: dependencies :class: sectiontitle - For scalar parameters passed to oneMKL BLAS routines as pointers, the + For scalar parameters passed to oneMath BLAS routines as pointers, the timing of pointer dereferencing depends on whether it is a USM-managed pointer or a raw pointer. @@ -100,5 +100,5 @@ Scalar Arguments in BLAS function is called and it may not be assigned asynchronously. - **Parent topic:** :ref:`onemkl_dense_linear_algebra` + **Parent topic:** :ref:`onemath_dense_linear_algebra` diff --git a/source/elements/oneMKL/source/domains/vector_math.inc.rst b/source/elements/oneMath/source/domains/vector_math.inc.rst similarity index 78% rename from source/elements/oneMKL/source/domains/vector_math.inc.rst rename to source/elements/oneMath/source/domains/vector_math.inc.rst index 2cbf8856e..b48314ca1 100644 --- a/source/elements/oneMKL/source/domains/vector_math.inc.rst +++ b/source/elements/oneMath/source/domains/vector_math.inc.rst @@ -2,14 +2,14 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_inc: +.. _onemath_vm_inc: Vector Math ----------- .. container:: - oneMKL :ref:`Vector Mathematics functions ` (VM) compute a mathematical + oneMath :ref:`Vector Mathematics functions ` (VM) compute a mathematical function of each of the vector elements. VM includes a set of functions (arithmetic, power, trigonometric, exponential, hyperbolic, special, and rounding) that operate on vectors of real diff --git a/source/elements/oneMKL/source/domains/vm/abs.rst b/source/elements/oneMath/source/domains/vm/abs.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/abs.rst rename to source/elements/oneMath/source/domains/vm/abs.rst index efdd97cef..e0257a2ee 100644 --- a/source/elements/oneMKL/source/domains/vm/abs.rst +++ b/source/elements/oneMath/source/domains/vm/abs.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_abs: +.. _onemath_vm_abs: abs === @@ -155,7 +155,7 @@ abs mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -181,7 +181,7 @@ abs mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -216,7 +216,7 @@ abs .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -224,6 +224,6 @@ abs .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/acos.rst b/source/elements/oneMath/source/domains/vm/acos.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/acos.rst rename to source/elements/oneMath/source/domains/vm/acos.rst index 40e714851..d87bac147 100644 --- a/source/elements/oneMKL/source/domains/vm/acos.rst +++ b/source/elements/oneMath/source/domains/vm/acos.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_acos: +.. _onemath_vm_acos: acos ==== @@ -231,14 +231,14 @@ acos mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -264,14 +264,14 @@ acos mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -306,7 +306,7 @@ acos .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -314,6 +314,6 @@ acos .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/acosh.rst b/source/elements/oneMath/source/domains/vm/acosh.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/acosh.rst rename to source/elements/oneMath/source/domains/vm/acosh.rst index e6e3afa2b..daaa03a93 100644 --- a/source/elements/oneMKL/source/domains/vm/acosh.rst +++ b/source/elements/oneMath/source/domains/vm/acosh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_acosh: +.. _onemath_vm_acosh: acosh ===== @@ -223,14 +223,14 @@ acosh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -256,14 +256,14 @@ acosh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -298,7 +298,7 @@ acosh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -306,4 +306,4 @@ acosh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/acospi.rst b/source/elements/oneMath/source/domains/vm/acospi.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/acospi.rst rename to source/elements/oneMath/source/domains/vm/acospi.rst index fb1a9fed4..9891d42a4 100644 --- a/source/elements/oneMKL/source/domains/vm/acospi.rst +++ b/source/elements/oneMath/source/domains/vm/acospi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_acospi: +.. _onemath_vm_acospi: acospi ====== @@ -151,14 +151,14 @@ acospi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -184,14 +184,14 @@ acospi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -226,7 +226,7 @@ acospi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -234,6 +234,6 @@ acospi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/add.rst b/source/elements/oneMath/source/domains/vm/add.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/add.rst rename to source/elements/oneMath/source/domains/vm/add.rst index 9e6d20dba..24f7e8fe6 100644 --- a/source/elements/oneMKL/source/domains/vm/add.rst +++ b/source/elements/oneMath/source/domains/vm/add.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_add: +.. _onemath_vm_add: add === @@ -189,14 +189,14 @@ add mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -226,14 +226,14 @@ add mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -268,7 +268,7 @@ add .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -276,6 +276,6 @@ add .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/arg.rst b/source/elements/oneMath/source/domains/vm/arg.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/arg.rst rename to source/elements/oneMath/source/domains/vm/arg.rst index 42d718771..d9a81550f 100644 --- a/source/elements/oneMKL/source/domains/vm/arg.rst +++ b/source/elements/oneMath/source/domains/vm/arg.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_arg: +.. _onemath_vm_arg: arg === @@ -84,7 +84,7 @@ arg The arg(a) function computes argument of vector elements. - See :ref:`onemkl_vm_special_value_notations` for the conventions used in the + See :ref:`onemath_vm_special_value_notations` for the conventions used in the table below. @@ -199,7 +199,7 @@ arg mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -225,7 +225,7 @@ arg mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -260,7 +260,7 @@ arg .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -268,6 +268,6 @@ arg .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/asin.rst b/source/elements/oneMath/source/domains/vm/asin.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/asin.rst rename to source/elements/oneMath/source/domains/vm/asin.rst index 6b2313184..791dca5ba 100644 --- a/source/elements/oneMKL/source/domains/vm/asin.rst +++ b/source/elements/oneMath/source/domains/vm/asin.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_asin: +.. _onemath_vm_asin: asin ==== @@ -158,14 +158,14 @@ asin mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -191,14 +191,14 @@ asin mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -233,7 +233,7 @@ asin .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -241,6 +241,6 @@ asin .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/asinh.rst b/source/elements/oneMath/source/domains/vm/asinh.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/asinh.rst rename to source/elements/oneMath/source/domains/vm/asinh.rst index c0d13ff83..abd6d55de 100644 --- a/source/elements/oneMKL/source/domains/vm/asinh.rst +++ b/source/elements/oneMath/source/domains/vm/asinh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_asinh: +.. _onemath_vm_asinh: asinh ===== @@ -227,7 +227,7 @@ asinh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -253,7 +253,7 @@ asinh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -288,7 +288,7 @@ asinh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -296,6 +296,6 @@ asinh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/asinpi.rst b/source/elements/oneMath/source/domains/vm/asinpi.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/asinpi.rst rename to source/elements/oneMath/source/domains/vm/asinpi.rst index ec0b242b9..91ad13bdc 100644 --- a/source/elements/oneMKL/source/domains/vm/asinpi.rst +++ b/source/elements/oneMath/source/domains/vm/asinpi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_asinpi: +.. _onemath_vm_asinpi: asinpi ====== @@ -151,14 +151,14 @@ asinpi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -184,14 +184,14 @@ asinpi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -226,7 +226,7 @@ asinpi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -234,6 +234,6 @@ asinpi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/atan.rst b/source/elements/oneMath/source/domains/vm/atan.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/atan.rst rename to source/elements/oneMath/source/domains/vm/atan.rst index 0e7f6d980..5e02424b9 100644 --- a/source/elements/oneMKL/source/domains/vm/atan.rst +++ b/source/elements/oneMath/source/domains/vm/atan.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_atan: +.. _onemath_vm_atan: atan ==== @@ -150,7 +150,7 @@ atan mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -176,7 +176,7 @@ atan mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -211,7 +211,7 @@ atan .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -219,6 +219,6 @@ atan .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/atan2.rst b/source/elements/oneMath/source/domains/vm/atan2.rst similarity index 97% rename from source/elements/oneMKL/source/domains/vm/atan2.rst rename to source/elements/oneMath/source/domains/vm/atan2.rst index e5395ecd4..9896ed104 100644 --- a/source/elements/oneMKL/source/domains/vm/atan2.rst +++ b/source/elements/oneMath/source/domains/vm/atan2.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_atan2: +.. _onemath_vm_atan2: atan2 ===== @@ -295,7 +295,7 @@ atan2 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -325,7 +325,7 @@ atan2 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -360,7 +360,7 @@ atan2 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -368,6 +368,6 @@ atan2 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/atan2pi.rst b/source/elements/oneMath/source/domains/vm/atan2pi.rst similarity index 97% rename from source/elements/oneMKL/source/domains/vm/atan2pi.rst rename to source/elements/oneMath/source/domains/vm/atan2pi.rst index 697eacf78..6738e6c29 100644 --- a/source/elements/oneMKL/source/domains/vm/atan2pi.rst +++ b/source/elements/oneMath/source/domains/vm/atan2pi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_atan2pi: +.. _onemath_vm_atan2pi: atan2pi ======= @@ -298,7 +298,7 @@ atan2pi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -328,7 +328,7 @@ atan2pi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -363,7 +363,7 @@ atan2pi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -371,6 +371,6 @@ atan2pi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/atanh.rst b/source/elements/oneMath/source/domains/vm/atanh.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/atanh.rst rename to source/elements/oneMath/source/domains/vm/atanh.rst index 52d629c96..1c866e814 100644 --- a/source/elements/oneMKL/source/domains/vm/atanh.rst +++ b/source/elements/oneMath/source/domains/vm/atanh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_atanh: +.. _onemath_vm_atanh: atanh ===== @@ -232,14 +232,14 @@ atanh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -265,14 +265,14 @@ atanh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -307,7 +307,7 @@ atanh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -315,6 +315,6 @@ atanh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/atanpi.rst b/source/elements/oneMath/source/domains/vm/atanpi.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/atanpi.rst rename to source/elements/oneMath/source/domains/vm/atanpi.rst index d02ee7f19..f34976ce3 100644 --- a/source/elements/oneMKL/source/domains/vm/atanpi.rst +++ b/source/elements/oneMath/source/domains/vm/atanpi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_atanpi: +.. _onemath_vm_atanpi: atanpi ====== @@ -143,7 +143,7 @@ atanpi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -169,7 +169,7 @@ atanpi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -204,7 +204,7 @@ atanpi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -212,6 +212,6 @@ atanpi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/bibliography.rst b/source/elements/oneMath/source/domains/vm/bibliography.rst similarity index 93% rename from source/elements/oneMKL/source/domains/vm/bibliography.rst rename to source/elements/oneMath/source/domains/vm/bibliography.rst index a72a095e1..a6b8bc641 100644 --- a/source/elements/oneMKL/source/domains/vm/bibliography.rst +++ b/source/elements/oneMath/source/domains/vm/bibliography.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_bibliography: +.. _onemath_vm_bibliography: Bibliography ============ diff --git a/source/elements/oneMKL/source/domains/vm/cbrt.rst b/source/elements/oneMath/source/domains/vm/cbrt.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/cbrt.rst rename to source/elements/oneMath/source/domains/vm/cbrt.rst index 7787b944f..4654a503e 100644 --- a/source/elements/oneMKL/source/domains/vm/cbrt.rst +++ b/source/elements/oneMath/source/domains/vm/cbrt.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cbrt: +.. _onemath_vm_cbrt: cbrt ==== @@ -141,7 +141,7 @@ cbrt mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -167,7 +167,7 @@ cbrt mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -202,7 +202,7 @@ cbrt .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -210,6 +210,6 @@ cbrt .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cdfnorm.rst b/source/elements/oneMath/source/domains/vm/cdfnorm.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/cdfnorm.rst rename to source/elements/oneMath/source/domains/vm/cdfnorm.rst index dbb122284..e7cedcf8a 100644 --- a/source/elements/oneMKL/source/domains/vm/cdfnorm.rst +++ b/source/elements/oneMath/source/domains/vm/cdfnorm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cdfnorm: +.. _onemath_vm_cdfnorm: cdfnorm ======= @@ -177,14 +177,14 @@ cdfnorm mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -210,14 +210,14 @@ cdfnorm mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -252,7 +252,7 @@ cdfnorm .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -260,6 +260,6 @@ cdfnorm .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` .. |image0| image:: ../equations/error_functions_plot.jpg diff --git a/source/elements/oneMKL/source/domains/vm/cdfnorminv.rst b/source/elements/oneMath/source/domains/vm/cdfnorminv.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/cdfnorminv.rst rename to source/elements/oneMath/source/domains/vm/cdfnorminv.rst index 00364c03a..819329eee 100644 --- a/source/elements/oneMKL/source/domains/vm/cdfnorminv.rst +++ b/source/elements/oneMath/source/domains/vm/cdfnorminv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cdfnorminv: +.. _onemath_vm_cdfnorminv: cdfnorminv ========== @@ -197,14 +197,14 @@ cdfnorminv mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -230,14 +230,14 @@ cdfnorminv mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -272,7 +272,7 @@ cdfnorminv .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -280,7 +280,7 @@ cdfnorminv .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/ceil.rst b/source/elements/oneMath/source/domains/vm/ceil.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/ceil.rst rename to source/elements/oneMath/source/domains/vm/ceil.rst index 148439282..26409c7d1 100644 --- a/source/elements/oneMKL/source/domains/vm/ceil.rst +++ b/source/elements/oneMath/source/domains/vm/ceil.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_ceil: +.. _onemath_vm_ceil: ceil ==== @@ -147,7 +147,7 @@ ceil mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -173,7 +173,7 @@ ceil mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -208,7 +208,7 @@ ceil .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -216,4 +216,4 @@ ceil .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cis.rst b/source/elements/oneMath/source/domains/vm/cis.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/cis.rst rename to source/elements/oneMath/source/domains/vm/cis.rst index 8c417f36b..3a96afe87 100644 --- a/source/elements/oneMKL/source/domains/vm/cis.rst +++ b/source/elements/oneMath/source/domains/vm/cis.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cis: +.. _onemath_vm_cis: cis === @@ -145,14 +145,14 @@ cis mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -178,14 +178,14 @@ cis mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -220,7 +220,7 @@ cis .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -228,6 +228,6 @@ cis .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/clear_status.rst b/source/elements/oneMath/source/domains/vm/clear_status.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/clear_status.rst rename to source/elements/oneMath/source/domains/vm/clear_status.rst index a99eb5208..871610fef 100644 --- a/source/elements/oneMKL/source/domains/vm/clear_status.rst +++ b/source/elements/oneMath/source/domains/vm/clear_status.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_clear_status: +.. _onemath_vm_clear_status: clear_status ============ @@ -104,6 +104,6 @@ clear_status .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/conj.rst b/source/elements/oneMath/source/domains/vm/conj.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/conj.rst rename to source/elements/oneMath/source/domains/vm/conj.rst index 9f0d38438..0f12b9d45 100644 --- a/source/elements/oneMKL/source/domains/vm/conj.rst +++ b/source/elements/oneMath/source/domains/vm/conj.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_conj: +.. _onemath_vm_conj: conj ==== @@ -112,7 +112,7 @@ conj mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -138,7 +138,7 @@ conj mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -173,7 +173,7 @@ conj .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -181,6 +181,6 @@ conj .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/copysign.rst b/source/elements/oneMath/source/domains/vm/copysign.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/copysign.rst rename to source/elements/oneMath/source/domains/vm/copysign.rst index 43ea5184f..48000455c 100644 --- a/source/elements/oneMKL/source/domains/vm/copysign.rst +++ b/source/elements/oneMath/source/domains/vm/copysign.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_copysign: +.. _onemath_vm_copysign: copysign ======== @@ -141,7 +141,7 @@ copysign mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -171,7 +171,7 @@ copysign mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -206,7 +206,7 @@ copysign .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -214,6 +214,6 @@ copysign .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cos.rst b/source/elements/oneMath/source/domains/vm/cos.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/cos.rst rename to source/elements/oneMath/source/domains/vm/cos.rst index a6d4930a5..60f89465e 100644 --- a/source/elements/oneMKL/source/domains/vm/cos.rst +++ b/source/elements/oneMath/source/domains/vm/cos.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cos: +.. _onemath_vm_cos: cos === @@ -159,14 +159,14 @@ cos mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -192,14 +192,14 @@ cos mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -234,7 +234,7 @@ cos .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -242,6 +242,6 @@ cos .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cosd.rst b/source/elements/oneMath/source/domains/vm/cosd.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/cosd.rst rename to source/elements/oneMath/source/domains/vm/cosd.rst index 4b234ce09..c48ba7c1d 100644 --- a/source/elements/oneMKL/source/domains/vm/cosd.rst +++ b/source/elements/oneMath/source/domains/vm/cosd.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cosd: +.. _onemath_vm_cosd: cosd ==== @@ -154,14 +154,14 @@ cosd mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -187,14 +187,14 @@ cosd mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -229,7 +229,7 @@ cosd .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -237,6 +237,6 @@ cosd .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cosh.rst b/source/elements/oneMath/source/domains/vm/cosh.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/cosh.rst rename to source/elements/oneMath/source/domains/vm/cosh.rst index 005e7e9b2..36d5c86fa 100644 --- a/source/elements/oneMKL/source/domains/vm/cosh.rst +++ b/source/elements/oneMath/source/domains/vm/cosh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cosh: +.. _onemath_vm_cosh: cosh ==== @@ -254,14 +254,14 @@ cosh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -287,14 +287,14 @@ cosh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -329,7 +329,7 @@ cosh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -337,6 +337,6 @@ cosh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/cospi.rst b/source/elements/oneMath/source/domains/vm/cospi.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/cospi.rst rename to source/elements/oneMath/source/domains/vm/cospi.rst index e095b4baf..4896b1744 100644 --- a/source/elements/oneMKL/source/domains/vm/cospi.rst +++ b/source/elements/oneMath/source/domains/vm/cospi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_cospi: +.. _onemath_vm_cospi: cospi ===== @@ -156,14 +156,14 @@ cospi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -189,14 +189,14 @@ cospi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -231,7 +231,7 @@ cospi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -239,6 +239,6 @@ cospi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/create_error_handler.rst b/source/elements/oneMath/source/domains/vm/create_error_handler.rst similarity index 98% rename from source/elements/oneMKL/source/domains/vm/create_error_handler.rst rename to source/elements/oneMath/source/domains/vm/create_error_handler.rst index 3be49afc1..0780cb034 100644 --- a/source/elements/oneMKL/source/domains/vm/create_error_handler.rst +++ b/source/elements/oneMath/source/domains/vm/create_error_handler.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_create_error_handler: +.. _onemath_vm_create_error_handler: create_error_handler ==================== @@ -215,4 +215,4 @@ create_error_handler .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/div.rst b/source/elements/oneMath/source/domains/vm/div.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/div.rst rename to source/elements/oneMath/source/domains/vm/div.rst index 137b75742..d6bb1e584 100644 --- a/source/elements/oneMKL/source/domains/vm/div.rst +++ b/source/elements/oneMath/source/domains/vm/div.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_div: +.. _onemath_vm_div: div === @@ -194,14 +194,14 @@ div mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -231,14 +231,14 @@ div mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -273,7 +273,7 @@ div .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -281,6 +281,6 @@ div .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/erf.rst b/source/elements/oneMath/source/domains/vm/erf.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/erf.rst rename to source/elements/oneMath/source/domains/vm/erf.rst index 6f039e430..84d47515c 100644 --- a/source/elements/oneMKL/source/domains/vm/erf.rst +++ b/source/elements/oneMath/source/domains/vm/erf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_erf: +.. _onemath_vm_erf: erf === @@ -206,7 +206,7 @@ erf mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -232,7 +232,7 @@ erf mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -267,7 +267,7 @@ erf .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -275,7 +275,7 @@ erf .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/erfc.rst b/source/elements/oneMath/source/domains/vm/erfc.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/erfc.rst rename to source/elements/oneMath/source/domains/vm/erfc.rst index 1cd4f55ea..301c18673 100644 --- a/source/elements/oneMKL/source/domains/vm/erfc.rst +++ b/source/elements/oneMath/source/domains/vm/erfc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_erfc: +.. _onemath_vm_erfc: erfc ==== @@ -214,14 +214,14 @@ erfc mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -247,14 +247,14 @@ erfc mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -289,7 +289,7 @@ erfc .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -297,7 +297,7 @@ erfc .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/erfcinv.rst b/source/elements/oneMath/source/domains/vm/erfcinv.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/erfcinv.rst rename to source/elements/oneMath/source/domains/vm/erfcinv.rst index 0f238a5e7..acf104d6c 100644 --- a/source/elements/oneMKL/source/domains/vm/erfcinv.rst +++ b/source/elements/oneMath/source/domains/vm/erfcinv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_erfcinv: +.. _onemath_vm_erfcinv: erfcinv ======= @@ -199,14 +199,14 @@ erfcinv mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -232,14 +232,14 @@ erfcinv mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -274,7 +274,7 @@ erfcinv .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -282,7 +282,7 @@ erfcinv .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/erfinv.rst b/source/elements/oneMath/source/domains/vm/erfinv.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/erfinv.rst rename to source/elements/oneMath/source/domains/vm/erfinv.rst index 80051126d..96dc1794d 100644 --- a/source/elements/oneMKL/source/domains/vm/erfinv.rst +++ b/source/elements/oneMath/source/domains/vm/erfinv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_erfinv: +.. _onemath_vm_erfinv: erfinv ====== @@ -214,14 +214,14 @@ erfinv mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -247,14 +247,14 @@ erfinv mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -289,7 +289,7 @@ erfinv .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -297,7 +297,7 @@ erfinv .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/exp.rst b/source/elements/oneMath/source/domains/vm/exp.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/exp.rst rename to source/elements/oneMath/source/domains/vm/exp.rst index 604bc987f..dd2b49175 100644 --- a/source/elements/oneMKL/source/domains/vm/exp.rst +++ b/source/elements/oneMath/source/domains/vm/exp.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_exp: +.. _onemath_vm_exp: exp === @@ -249,14 +249,14 @@ exp mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -282,14 +282,14 @@ exp mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -324,7 +324,7 @@ exp .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -332,6 +332,6 @@ exp .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/exp10.rst b/source/elements/oneMath/source/domains/vm/exp10.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/exp10.rst rename to source/elements/oneMath/source/domains/vm/exp10.rst index 059e76349..22f5a530b 100644 --- a/source/elements/oneMKL/source/domains/vm/exp10.rst +++ b/source/elements/oneMath/source/domains/vm/exp10.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_exp10: +.. _onemath_vm_exp10: exp10 ===== @@ -163,14 +163,14 @@ exp10 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -196,14 +196,14 @@ exp10 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -238,7 +238,7 @@ exp10 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -246,6 +246,6 @@ exp10 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/exp2.rst b/source/elements/oneMath/source/domains/vm/exp2.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/exp2.rst rename to source/elements/oneMath/source/domains/vm/exp2.rst index 69ebce540..7a07e04e1 100644 --- a/source/elements/oneMKL/source/domains/vm/exp2.rst +++ b/source/elements/oneMath/source/domains/vm/exp2.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_exp2: +.. _onemath_vm_exp2: exp2 ==== @@ -162,14 +162,14 @@ exp2 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -195,14 +195,14 @@ exp2 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -237,7 +237,7 @@ exp2 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -245,6 +245,6 @@ exp2 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/expint1.rst b/source/elements/oneMath/source/domains/vm/expint1.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/expint1.rst rename to source/elements/oneMath/source/domains/vm/expint1.rst index 67eb7a6f1..c25ec22af 100644 --- a/source/elements/oneMKL/source/domains/vm/expint1.rst +++ b/source/elements/oneMath/source/domains/vm/expint1.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_expint1: +.. _onemath_vm_expint1: expint1 ======= @@ -156,14 +156,14 @@ expint1 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -189,14 +189,14 @@ expint1 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -231,7 +231,7 @@ expint1 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -239,4 +239,4 @@ expint1 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/expm1.rst b/source/elements/oneMath/source/domains/vm/expm1.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/expm1.rst rename to source/elements/oneMath/source/domains/vm/expm1.rst index 8ab133b6e..cb9446dbe 100644 --- a/source/elements/oneMKL/source/domains/vm/expm1.rst +++ b/source/elements/oneMath/source/domains/vm/expm1.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_expm1: +.. _onemath_vm_expm1: expm1 ===== @@ -161,14 +161,14 @@ expm1 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -194,14 +194,14 @@ expm1 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -236,7 +236,7 @@ expm1 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -244,5 +244,5 @@ expm1 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/fdim.rst b/source/elements/oneMath/source/domains/vm/fdim.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/fdim.rst rename to source/elements/oneMath/source/domains/vm/fdim.rst index ad4fb2f6b..a9312837a 100644 --- a/source/elements/oneMKL/source/domains/vm/fdim.rst +++ b/source/elements/oneMath/source/domains/vm/fdim.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_fdim: +.. _onemath_vm_fdim: fdim ==== @@ -150,7 +150,7 @@ fdim mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -180,7 +180,7 @@ fdim mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -215,7 +215,7 @@ fdim .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -223,6 +223,6 @@ fdim .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/floor.rst b/source/elements/oneMath/source/domains/vm/floor.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/floor.rst rename to source/elements/oneMath/source/domains/vm/floor.rst index 438dd5e67..ee2ce8563 100644 --- a/source/elements/oneMKL/source/domains/vm/floor.rst +++ b/source/elements/oneMath/source/domains/vm/floor.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_floor: +.. _onemath_vm_floor: floor ===== @@ -147,7 +147,7 @@ floor mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -173,7 +173,7 @@ floor mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -208,7 +208,7 @@ floor .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -216,4 +216,4 @@ floor .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/fmax.rst b/source/elements/oneMath/source/domains/vm/fmax.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/fmax.rst rename to source/elements/oneMath/source/domains/vm/fmax.rst index ad27e7828..2caa78b35 100644 --- a/source/elements/oneMKL/source/domains/vm/fmax.rst +++ b/source/elements/oneMath/source/domains/vm/fmax.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_fmax: +.. _onemath_vm_fmax: fmax ==== @@ -146,7 +146,7 @@ fmax mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -176,7 +176,7 @@ fmax mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -211,7 +211,7 @@ fmax .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -219,6 +219,6 @@ fmax .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/fmin.rst b/source/elements/oneMath/source/domains/vm/fmin.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/fmin.rst rename to source/elements/oneMath/source/domains/vm/fmin.rst index e31e197ca..07c63d3f2 100644 --- a/source/elements/oneMKL/source/domains/vm/fmin.rst +++ b/source/elements/oneMath/source/domains/vm/fmin.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_fmin: +.. _onemath_vm_fmin: fmin ==== @@ -146,7 +146,7 @@ fmin mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -176,7 +176,7 @@ fmin mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -211,7 +211,7 @@ fmin .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -219,6 +219,6 @@ fmin .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/fmod.rst b/source/elements/oneMath/source/domains/vm/fmod.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/fmod.rst rename to source/elements/oneMath/source/domains/vm/fmod.rst index 238f068ce..3760e3fb1 100644 --- a/source/elements/oneMKL/source/domains/vm/fmod.rst +++ b/source/elements/oneMath/source/domains/vm/fmod.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_fmod: +.. _onemath_vm_fmod: fmod ==== @@ -165,14 +165,14 @@ fmod mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -202,14 +202,14 @@ fmod mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -244,7 +244,7 @@ fmod .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -252,6 +252,6 @@ fmod .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/frac.rst b/source/elements/oneMath/source/domains/vm/frac.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/frac.rst rename to source/elements/oneMath/source/domains/vm/frac.rst index 118a0b7d9..1956a797f 100644 --- a/source/elements/oneMKL/source/domains/vm/frac.rst +++ b/source/elements/oneMath/source/domains/vm/frac.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_frac: +.. _onemath_vm_frac: frac ==== @@ -149,7 +149,7 @@ frac mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -175,7 +175,7 @@ frac mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -210,7 +210,7 @@ frac .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -218,4 +218,4 @@ frac .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/get_mode.rst b/source/elements/oneMath/source/domains/vm/get_mode.rst similarity index 92% rename from source/elements/oneMKL/source/domains/vm/get_mode.rst rename to source/elements/oneMath/source/domains/vm/get_mode.rst index 497e43441..9fa2bb526 100644 --- a/source/elements/oneMKL/source/domains/vm/get_mode.rst +++ b/source/elements/oneMath/source/domains/vm/get_mode.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_get_mode: +.. _onemath_vm_get_mode: get_mode ======== @@ -56,7 +56,7 @@ get_mode * - ``oneapi::mkl::vm::mode::not_defined`` - VM mode not defined. It means that no special provisions for accuracy have been made for this queue. - See :ref:`onemkl_vm_setmode` for details. + See :ref:`onemath_vm_setmode` for details. .. container:: section @@ -86,4 +86,4 @@ get_mode .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/get_status.rst b/source/elements/oneMath/source/domains/vm/get_status.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/get_status.rst rename to source/elements/oneMath/source/domains/vm/get_status.rst index b95c928e3..9f074d589 100644 --- a/source/elements/oneMKL/source/domains/vm/get_status.rst +++ b/source/elements/oneMath/source/domains/vm/get_status.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_get_status: +.. _onemath_vm_get_status: get_status ========== @@ -102,6 +102,6 @@ get_status .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/hypot.rst b/source/elements/oneMath/source/domains/vm/hypot.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/hypot.rst rename to source/elements/oneMath/source/domains/vm/hypot.rst index 6b204b006..577e1557d 100644 --- a/source/elements/oneMKL/source/domains/vm/hypot.rst +++ b/source/elements/oneMath/source/domains/vm/hypot.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_hypot: +.. _onemath_vm_hypot: hypot ===== @@ -179,7 +179,7 @@ hypot mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -209,7 +209,7 @@ hypot mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -244,7 +244,7 @@ hypot .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -252,6 +252,6 @@ hypot .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/inv.rst b/source/elements/oneMath/source/domains/vm/inv.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/inv.rst rename to source/elements/oneMath/source/domains/vm/inv.rst index 26f98c9ad..f57b086d0 100644 --- a/source/elements/oneMKL/source/domains/vm/inv.rst +++ b/source/elements/oneMath/source/domains/vm/inv.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_inv: +.. _onemath_vm_inv: inv === @@ -141,14 +141,14 @@ inv mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -174,14 +174,14 @@ inv mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -216,7 +216,7 @@ inv .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -224,6 +224,6 @@ inv .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/invcbrt.rst b/source/elements/oneMath/source/domains/vm/invcbrt.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/invcbrt.rst rename to source/elements/oneMath/source/domains/vm/invcbrt.rst index c3e90b4a2..9cdaa87bb 100644 --- a/source/elements/oneMKL/source/domains/vm/invcbrt.rst +++ b/source/elements/oneMath/source/domains/vm/invcbrt.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_invcbrt: +.. _onemath_vm_invcbrt: invcbrt ======= @@ -141,14 +141,14 @@ invcbrt mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -174,14 +174,14 @@ invcbrt mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -216,7 +216,7 @@ invcbrt .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -224,6 +224,6 @@ invcbrt .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/invsqrt.rst b/source/elements/oneMath/source/domains/vm/invsqrt.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/invsqrt.rst rename to source/elements/oneMath/source/domains/vm/invsqrt.rst index 8a9835200..d63fcfedf 100644 --- a/source/elements/oneMKL/source/domains/vm/invsqrt.rst +++ b/source/elements/oneMath/source/domains/vm/invsqrt.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_invsqrt: +.. _onemath_vm_invsqrt: invsqrt ======= @@ -144,14 +144,14 @@ invsqrt mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -177,14 +177,14 @@ invsqrt mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -219,7 +219,7 @@ invsqrt .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -227,6 +227,6 @@ invsqrt .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/lgamma.rst b/source/elements/oneMath/source/domains/vm/lgamma.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/lgamma.rst rename to source/elements/oneMath/source/domains/vm/lgamma.rst index 6bbaae482..e94ddc032 100644 --- a/source/elements/oneMKL/source/domains/vm/lgamma.rst +++ b/source/elements/oneMath/source/domains/vm/lgamma.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_lgamma: +.. _onemath_vm_lgamma: lgamma ====== @@ -158,14 +158,14 @@ lgamma mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -191,14 +191,14 @@ lgamma mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -233,7 +233,7 @@ lgamma .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -241,6 +241,6 @@ lgamma .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/linearfrac.rst b/source/elements/oneMath/source/domains/vm/linearfrac.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/linearfrac.rst rename to source/elements/oneMath/source/domains/vm/linearfrac.rst index cc2f32aa5..f9a0f11dd 100644 --- a/source/elements/oneMKL/source/domains/vm/linearfrac.rst +++ b/source/elements/oneMath/source/domains/vm/linearfrac.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_linearfrac: +.. _onemath_vm_linearfrac: linearfrac ========== @@ -136,7 +136,7 @@ linearfrac ``EMIN``\ and ``EMAX`` are the minimum and maximum exponents and ``p`` is the number of significant bits (precision) for the corresponding data type according to the ANSI/IEEE Standard 754-2008 - ([:ref:`onemkl_vm_bibliography`]): + ([:ref:`onemath_vm_bibliography`]): - for single precision\ ``EMIN`` = -126, ``EMAX`` = 127, ``p`` = 24 @@ -202,14 +202,14 @@ linearfrac mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -255,14 +255,14 @@ linearfrac mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -297,7 +297,7 @@ linearfrac .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -305,6 +305,6 @@ linearfrac .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/ln.rst b/source/elements/oneMath/source/domains/vm/ln.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/ln.rst rename to source/elements/oneMath/source/domains/vm/ln.rst index f8ebb8815..7150fe622 100644 --- a/source/elements/oneMKL/source/domains/vm/ln.rst +++ b/source/elements/oneMath/source/domains/vm/ln.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_ln: +.. _onemath_vm_ln: ln == @@ -222,14 +222,14 @@ ln mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -255,14 +255,14 @@ ln mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -297,7 +297,7 @@ ln .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -305,4 +305,4 @@ ln .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/log10.rst b/source/elements/oneMath/source/domains/vm/log10.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/log10.rst rename to source/elements/oneMath/source/domains/vm/log10.rst index 79e8588c7..d8542cbcc 100644 --- a/source/elements/oneMKL/source/domains/vm/log10.rst +++ b/source/elements/oneMath/source/domains/vm/log10.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_log10: +.. _onemath_vm_log10: log10 ===== @@ -223,14 +223,14 @@ log10 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -256,14 +256,14 @@ log10 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -298,7 +298,7 @@ log10 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -306,7 +306,7 @@ log10 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/log1p.rst b/source/elements/oneMath/source/domains/vm/log1p.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/log1p.rst rename to source/elements/oneMath/source/domains/vm/log1p.rst index 67c9208ab..970ec0cf3 100644 --- a/source/elements/oneMKL/source/domains/vm/log1p.rst +++ b/source/elements/oneMath/source/domains/vm/log1p.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_log1p: +.. _onemath_vm_log1p: log1p ===== @@ -148,14 +148,14 @@ log1p mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -181,14 +181,14 @@ log1p mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -223,7 +223,7 @@ log1p .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -231,6 +231,6 @@ log1p .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/log2.rst b/source/elements/oneMath/source/domains/vm/log2.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/log2.rst rename to source/elements/oneMath/source/domains/vm/log2.rst index 21d365675..6377de9fc 100644 --- a/source/elements/oneMKL/source/domains/vm/log2.rst +++ b/source/elements/oneMath/source/domains/vm/log2.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_log2: +.. _onemath_vm_log2: log2 ==== @@ -147,14 +147,14 @@ log2 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -180,14 +180,14 @@ log2 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -222,7 +222,7 @@ log2 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -230,6 +230,6 @@ log2 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/logb.rst b/source/elements/oneMath/source/domains/vm/logb.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/logb.rst rename to source/elements/oneMath/source/domains/vm/logb.rst index be2c6e717..6c5f9a0c6 100644 --- a/source/elements/oneMKL/source/domains/vm/logb.rst +++ b/source/elements/oneMath/source/domains/vm/logb.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_logb: +.. _onemath_vm_logb: logb ==== @@ -144,14 +144,14 @@ logb mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -177,14 +177,14 @@ logb mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -219,7 +219,7 @@ logb .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -227,6 +227,6 @@ logb .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/maxmag.rst b/source/elements/oneMath/source/domains/vm/maxmag.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/maxmag.rst rename to source/elements/oneMath/source/domains/vm/maxmag.rst index 71ff771b6..9e34f449a 100644 --- a/source/elements/oneMKL/source/domains/vm/maxmag.rst +++ b/source/elements/oneMath/source/domains/vm/maxmag.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_maxmag: +.. _onemath_vm_maxmag: maxmag ====== @@ -156,7 +156,7 @@ maxmag mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -186,7 +186,7 @@ maxmag mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -221,7 +221,7 @@ maxmag .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -229,6 +229,6 @@ maxmag .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/minmag.rst b/source/elements/oneMath/source/domains/vm/minmag.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/minmag.rst rename to source/elements/oneMath/source/domains/vm/minmag.rst index 9e7325bbd..2bd33c2a3 100644 --- a/source/elements/oneMKL/source/domains/vm/minmag.rst +++ b/source/elements/oneMath/source/domains/vm/minmag.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_minmag: +.. _onemath_vm_minmag: minmag ====== @@ -156,7 +156,7 @@ minmag mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -186,7 +186,7 @@ minmag mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -221,7 +221,7 @@ minmag .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -229,6 +229,6 @@ minmag .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/modf.rst b/source/elements/oneMath/source/domains/vm/modf.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/modf.rst rename to source/elements/oneMath/source/domains/vm/modf.rst index 6990acb55..fb755f276 100644 --- a/source/elements/oneMKL/source/domains/vm/modf.rst +++ b/source/elements/oneMath/source/domains/vm/modf.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_modf: +.. _onemath_vm_modf: modf ==== @@ -166,7 +166,7 @@ modf mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -192,7 +192,7 @@ modf mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -239,7 +239,7 @@ modf .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -247,4 +247,4 @@ modf .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/mul.rst b/source/elements/oneMath/source/domains/vm/mul.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/mul.rst rename to source/elements/oneMath/source/domains/vm/mul.rst index 40e885990..d1fdfa22a 100644 --- a/source/elements/oneMKL/source/domains/vm/mul.rst +++ b/source/elements/oneMath/source/domains/vm/mul.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_mul: +.. _onemath_vm_mul: mul === @@ -229,14 +229,14 @@ mul mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -266,14 +266,14 @@ mul mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -308,7 +308,7 @@ mul .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -316,6 +316,6 @@ mul .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/mulbyconj.rst b/source/elements/oneMath/source/domains/vm/mulbyconj.rst similarity index 93% rename from source/elements/oneMKL/source/domains/vm/mulbyconj.rst rename to source/elements/oneMath/source/domains/vm/mulbyconj.rst index 3cc0609a8..58fd1761f 100644 --- a/source/elements/oneMKL/source/domains/vm/mulbyconj.rst +++ b/source/elements/oneMath/source/domains/vm/mulbyconj.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_mulbyconj: +.. _onemath_vm_mulbyconj: mulbyconj ========= @@ -106,14 +106,14 @@ mulbyconj mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -143,14 +143,14 @@ mulbyconj mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -185,7 +185,7 @@ mulbyconj .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -193,6 +193,6 @@ mulbyconj .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/nearbyint.rst b/source/elements/oneMath/source/domains/vm/nearbyint.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/nearbyint.rst rename to source/elements/oneMath/source/domains/vm/nearbyint.rst index 08b6e63b8..fb7314c09 100644 --- a/source/elements/oneMKL/source/domains/vm/nearbyint.rst +++ b/source/elements/oneMath/source/domains/vm/nearbyint.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_nearbyint: +.. _onemath_vm_nearbyint: nearbyint ========= @@ -143,7 +143,7 @@ nearbyint mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -169,7 +169,7 @@ nearbyint mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -204,7 +204,7 @@ nearbyint .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -212,6 +212,6 @@ nearbyint .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/nextafter.rst b/source/elements/oneMath/source/domains/vm/nextafter.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/nextafter.rst rename to source/elements/oneMath/source/domains/vm/nextafter.rst index 4c666ed6d..c9d3d969d 100644 --- a/source/elements/oneMKL/source/domains/vm/nextafter.rst +++ b/source/elements/oneMath/source/domains/vm/nextafter.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_nextafter: +.. _onemath_vm_nextafter: nextafter ========= @@ -141,14 +141,14 @@ nextafter mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -178,14 +178,14 @@ nextafter mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -220,7 +220,7 @@ nextafter .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -229,6 +229,6 @@ nextafter .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/pow.rst b/source/elements/oneMath/source/domains/vm/pow.rst similarity index 97% rename from source/elements/oneMKL/source/domains/vm/pow.rst rename to source/elements/oneMath/source/domains/vm/pow.rst index bfede9029..e555350c4 100644 --- a/source/elements/oneMKL/source/domains/vm/pow.rst +++ b/source/elements/oneMath/source/domains/vm/pow.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_pow: +.. _onemath_vm_pow: pow === @@ -400,14 +400,14 @@ pow mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -437,14 +437,14 @@ pow mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -479,7 +479,7 @@ pow .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -487,6 +487,6 @@ pow .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/pow2o3.rst b/source/elements/oneMath/source/domains/vm/pow2o3.rst similarity index 93% rename from source/elements/oneMKL/source/domains/vm/pow2o3.rst rename to source/elements/oneMath/source/domains/vm/pow2o3.rst index 363f75244..206395362 100644 --- a/source/elements/oneMKL/source/domains/vm/pow2o3.rst +++ b/source/elements/oneMath/source/domains/vm/pow2o3.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_pow2o3: +.. _onemath_vm_pow2o3: pow2o3 ====== @@ -139,14 +139,14 @@ pow2o3 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -172,14 +172,14 @@ pow2o3 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -214,7 +214,7 @@ pow2o3 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -222,6 +222,6 @@ pow2o3 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/pow3o2.rst b/source/elements/oneMath/source/domains/vm/pow3o2.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/pow3o2.rst rename to source/elements/oneMath/source/domains/vm/pow3o2.rst index 51f241333..816eed495 100644 --- a/source/elements/oneMKL/source/domains/vm/pow3o2.rst +++ b/source/elements/oneMath/source/domains/vm/pow3o2.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_pow3o2: +.. _onemath_vm_pow3o2: pow3o2 ====== @@ -160,14 +160,14 @@ pow3o2 mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -193,14 +193,14 @@ pow3o2 mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -235,7 +235,7 @@ pow3o2 .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -243,6 +243,6 @@ pow3o2 .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/powr.rst b/source/elements/oneMath/source/domains/vm/powr.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/powr.rst rename to source/elements/oneMath/source/domains/vm/powr.rst index 0f483c1d1..a186747d6 100644 --- a/source/elements/oneMKL/source/domains/vm/powr.rst +++ b/source/elements/oneMath/source/domains/vm/powr.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_powr: +.. _onemath_vm_powr: powr ==== @@ -236,14 +236,14 @@ powr mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -273,14 +273,14 @@ powr mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -315,7 +315,7 @@ powr .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -324,6 +324,6 @@ powr .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/powx.rst b/source/elements/oneMath/source/domains/vm/powx.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/powx.rst rename to source/elements/oneMath/source/domains/vm/powx.rst index c10486e15..8b39fdd50 100644 --- a/source/elements/oneMKL/source/domains/vm/powx.rst +++ b/source/elements/oneMath/source/domains/vm/powx.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_powx: +.. _onemath_vm_powx: powx ==== @@ -131,14 +131,14 @@ powx mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -168,14 +168,14 @@ powx mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -210,7 +210,7 @@ powx .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -219,4 +219,4 @@ powx .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/remainder.rst b/source/elements/oneMath/source/domains/vm/remainder.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/remainder.rst rename to source/elements/oneMath/source/domains/vm/remainder.rst index cc0d459cb..33a9353ce 100644 --- a/source/elements/oneMKL/source/domains/vm/remainder.rst +++ b/source/elements/oneMath/source/domains/vm/remainder.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_remainder: +.. _onemath_vm_remainder: remainder ========= @@ -166,14 +166,14 @@ remainder mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -203,14 +203,14 @@ remainder mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -245,7 +245,7 @@ remainder .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -253,6 +253,6 @@ remainder .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/rint.rst b/source/elements/oneMath/source/domains/vm/rint.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/rint.rst rename to source/elements/oneMath/source/domains/vm/rint.rst index e9718dd5f..d53e00eed 100644 --- a/source/elements/oneMKL/source/domains/vm/rint.rst +++ b/source/elements/oneMath/source/domains/vm/rint.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_rint: +.. _onemath_vm_rint: rint ==== @@ -161,7 +161,7 @@ rint mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -187,7 +187,7 @@ rint mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -222,7 +222,7 @@ rint .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -230,6 +230,6 @@ rint .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/round.rst b/source/elements/oneMath/source/domains/vm/round.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/round.rst rename to source/elements/oneMath/source/domains/vm/round.rst index 38df3fda3..c985680ab 100644 --- a/source/elements/oneMKL/source/domains/vm/round.rst +++ b/source/elements/oneMath/source/domains/vm/round.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_round: +.. _onemath_vm_round: round ===== @@ -145,7 +145,7 @@ round mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -171,7 +171,7 @@ round mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -206,7 +206,7 @@ round .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -214,6 +214,6 @@ round .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/set_status.rst b/source/elements/oneMath/source/domains/vm/set_status.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/set_status.rst rename to source/elements/oneMath/source/domains/vm/set_status.rst index 98061201a..d6ec5295c 100644 --- a/source/elements/oneMKL/source/domains/vm/set_status.rst +++ b/source/elements/oneMath/source/domains/vm/set_status.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_set_status: +.. _onemath_vm_set_status: set_status ========== @@ -107,6 +107,6 @@ set_status .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/setmode.rst b/source/elements/oneMath/source/domains/vm/setmode.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/setmode.rst rename to source/elements/oneMath/source/domains/vm/setmode.rst index 1f768db86..6f562fd5d 100644 --- a/source/elements/oneMKL/source/domains/vm/setmode.rst +++ b/source/elements/oneMath/source/domains/vm/setmode.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_setmode: +.. _onemath_vm_setmode: set_mode ======== @@ -96,6 +96,6 @@ set_mode .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_service_functions` + **Parent topic:** :ref:`onemath_vm_service_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sin.rst b/source/elements/oneMath/source/domains/vm/sin.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/sin.rst rename to source/elements/oneMath/source/domains/vm/sin.rst index b9c5ed213..9ed7f10b4 100644 --- a/source/elements/oneMKL/source/domains/vm/sin.rst +++ b/source/elements/oneMath/source/domains/vm/sin.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sin: +.. _onemath_vm_sin: sin === @@ -159,14 +159,14 @@ sin mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -192,14 +192,14 @@ sin mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -234,7 +234,7 @@ sin .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -242,6 +242,6 @@ sin .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sincos.rst b/source/elements/oneMath/source/domains/vm/sincos.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/sincos.rst rename to source/elements/oneMath/source/domains/vm/sincos.rst index a679c6008..89e0b15ef 100644 --- a/source/elements/oneMKL/source/domains/vm/sincos.rst +++ b/source/elements/oneMath/source/domains/vm/sincos.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sincos: +.. _onemath_vm_sincos: sincos ====== @@ -159,14 +159,14 @@ sincos mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -192,14 +192,14 @@ sincos mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -244,7 +244,7 @@ sincos .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -252,6 +252,6 @@ sincos .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sind.rst b/source/elements/oneMath/source/domains/vm/sind.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/sind.rst rename to source/elements/oneMath/source/domains/vm/sind.rst index 6490dff8a..d3efedc13 100644 --- a/source/elements/oneMKL/source/domains/vm/sind.rst +++ b/source/elements/oneMath/source/domains/vm/sind.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sind: +.. _onemath_vm_sind: sind ==== @@ -154,14 +154,14 @@ sind mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -187,14 +187,14 @@ sind mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -229,7 +229,7 @@ sind .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -238,6 +238,6 @@ sind .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sinh.rst b/source/elements/oneMath/source/domains/vm/sinh.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/sinh.rst rename to source/elements/oneMath/source/domains/vm/sinh.rst index 59c438514..1a614e1c0 100644 --- a/source/elements/oneMKL/source/domains/vm/sinh.rst +++ b/source/elements/oneMath/source/domains/vm/sinh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sinh: +.. _onemath_vm_sinh: sinh ==== @@ -254,14 +254,14 @@ sinh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -287,14 +287,14 @@ sinh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -329,7 +329,7 @@ sinh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -337,6 +337,6 @@ sinh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sinpi.rst b/source/elements/oneMath/source/domains/vm/sinpi.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/sinpi.rst rename to source/elements/oneMath/source/domains/vm/sinpi.rst index e7512b3c6..d320bd646 100644 --- a/source/elements/oneMKL/source/domains/vm/sinpi.rst +++ b/source/elements/oneMath/source/domains/vm/sinpi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sinpi: +.. _onemath_vm_sinpi: sinpi ===== @@ -159,14 +159,14 @@ sinpi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -192,14 +192,14 @@ sinpi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -234,7 +234,7 @@ sinpi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -243,6 +243,6 @@ sinpi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/special-value-notations.rst b/source/elements/oneMath/source/domains/vm/special-value-notations.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/special-value-notations.rst rename to source/elements/oneMath/source/domains/vm/special-value-notations.rst index 29154cea6..fcd196c74 100644 --- a/source/elements/oneMKL/source/domains/vm/special-value-notations.rst +++ b/source/elements/oneMath/source/domains/vm/special-value-notations.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_special_value_notations: +.. _onemath_vm_special_value_notations: Special Value Notations ======================= @@ -60,5 +60,5 @@ Special Value Notations well-defined computationally. -**Parent topic:** :ref:`onemkl_vm` +**Parent topic:** :ref:`onemath_vm` diff --git a/source/elements/oneMKL/source/domains/vm/sqr.rst b/source/elements/oneMath/source/domains/vm/sqr.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/sqr.rst rename to source/elements/oneMath/source/domains/vm/sqr.rst index 7b25164db..d7f83ce68 100644 --- a/source/elements/oneMKL/source/domains/vm/sqr.rst +++ b/source/elements/oneMath/source/domains/vm/sqr.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sqr: +.. _onemath_vm_sqr: sqr === @@ -141,7 +141,7 @@ sqr mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -167,7 +167,7 @@ sqr mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -202,7 +202,7 @@ sqr .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -210,6 +210,6 @@ sqr .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sqrt.rst b/source/elements/oneMath/source/domains/vm/sqrt.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/sqrt.rst rename to source/elements/oneMath/source/domains/vm/sqrt.rst index 96e3f48b8..4afdeab26 100644 --- a/source/elements/oneMKL/source/domains/vm/sqrt.rst +++ b/source/elements/oneMath/source/domains/vm/sqrt.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sqrt: +.. _onemath_vm_sqrt: sqrt ==== @@ -225,14 +225,14 @@ sqrt mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -258,14 +258,14 @@ sqrt mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -300,7 +300,7 @@ sqrt .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -308,6 +308,6 @@ sqrt .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/sub.rst b/source/elements/oneMath/source/domains/vm/sub.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/sub.rst rename to source/elements/oneMath/source/domains/vm/sub.rst index 7365699e3..5beac15d7 100644 --- a/source/elements/oneMKL/source/domains/vm/sub.rst +++ b/source/elements/oneMath/source/domains/vm/sub.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_sub: +.. _onemath_vm_sub: sub === @@ -191,14 +191,14 @@ sub mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -228,14 +228,14 @@ sub mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -270,7 +270,7 @@ sub .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -279,6 +279,6 @@ sub .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/tan.rst b/source/elements/oneMath/source/domains/vm/tan.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/tan.rst rename to source/elements/oneMath/source/domains/vm/tan.rst index 40c53e71f..d02056b14 100644 --- a/source/elements/oneMKL/source/domains/vm/tan.rst +++ b/source/elements/oneMath/source/domains/vm/tan.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_tan: +.. _onemath_vm_tan: tan === @@ -159,14 +159,14 @@ tan mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -192,14 +192,14 @@ tan mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -234,7 +234,7 @@ tan .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -243,6 +243,6 @@ tan .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/tand.rst b/source/elements/oneMath/source/domains/vm/tand.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/tand.rst rename to source/elements/oneMath/source/domains/vm/tand.rst index c827653ef..e80875387 100644 --- a/source/elements/oneMKL/source/domains/vm/tand.rst +++ b/source/elements/oneMath/source/domains/vm/tand.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_tand: +.. _onemath_vm_tand: tand ==== @@ -154,14 +154,14 @@ tand mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -187,14 +187,14 @@ tand mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -229,7 +229,7 @@ tand .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -237,6 +237,6 @@ tand .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/tanh.rst b/source/elements/oneMath/source/domains/vm/tanh.rst similarity index 96% rename from source/elements/oneMKL/source/domains/vm/tanh.rst rename to source/elements/oneMath/source/domains/vm/tanh.rst index 8a6522e5b..b0488d850 100644 --- a/source/elements/oneMKL/source/domains/vm/tanh.rst +++ b/source/elements/oneMath/source/domains/vm/tanh.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_tanh: +.. _onemath_vm_tanh: tanh ==== @@ -226,7 +226,7 @@ tanh mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -252,7 +252,7 @@ tanh mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -287,7 +287,7 @@ tanh .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -296,6 +296,6 @@ tanh .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/tanpi.rst b/source/elements/oneMath/source/domains/vm/tanpi.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/tanpi.rst rename to source/elements/oneMath/source/domains/vm/tanpi.rst index cc18eb51d..7fee6c406 100644 --- a/source/elements/oneMKL/source/domains/vm/tanpi.rst +++ b/source/elements/oneMath/source/domains/vm/tanpi.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_tanpi: +.. _onemath_vm_tanpi: tanpi ===== @@ -170,14 +170,14 @@ tanpi mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -203,14 +203,14 @@ tanpi mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -245,7 +245,7 @@ tanpi .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -253,6 +253,6 @@ tanpi .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/tgamma.rst b/source/elements/oneMath/source/domains/vm/tgamma.rst similarity index 94% rename from source/elements/oneMKL/source/domains/vm/tgamma.rst rename to source/elements/oneMath/source/domains/vm/tgamma.rst index cabec01cf..b4b894df7 100644 --- a/source/elements/oneMKL/source/domains/vm/tgamma.rst +++ b/source/elements/oneMath/source/domains/vm/tgamma.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_tgamma: +.. _onemath_vm_tgamma: tgamma ====== @@ -151,14 +151,14 @@ tgamma mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -184,14 +184,14 @@ tgamma mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. errhandler Sets local error handling mode for this function call. See the - :ref:`onemkl_vm_create_error_handler` + :ref:`onemath_vm_create_error_handler` function for arguments and their descriptions. This is an optional parameter. The local error handler is disabled by default. @@ -226,7 +226,7 @@ tgamma .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -234,6 +234,6 @@ tgamma .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/trunc.rst b/source/elements/oneMath/source/domains/vm/trunc.rst similarity index 95% rename from source/elements/oneMKL/source/domains/vm/trunc.rst rename to source/elements/oneMath/source/domains/vm/trunc.rst index ee18568bc..936ce0cfc 100644 --- a/source/elements/oneMKL/source/domains/vm/trunc.rst +++ b/source/elements/oneMath/source/domains/vm/trunc.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_trunc: +.. _onemath_vm_trunc: trunc ===== @@ -150,7 +150,7 @@ trunc mode Overrides the global VM mode setting for this function call. See - :ref:`onemkl_vm_setmode` + :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -176,7 +176,7 @@ trunc mode Overrides the global VM mode setting for this function call. See - the :ref:`onemkl_vm_setmode` + the :ref:`onemath_vm_setmode` function for possible values and their description. This is an optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. @@ -211,7 +211,7 @@ trunc .. rubric:: Exceptions :class: sectiontitle - For list of generated exceptions please refer to  :ref:`onemkl_vm_exceptions` + For list of generated exceptions please refer to  :ref:`onemath_vm_exceptions` .. container:: familylinks @@ -219,4 +219,4 @@ trunc .. container:: parentlink - **Parent topic:** :ref:`onemkl_vm_mathematical_functions` + **Parent topic:** :ref:`onemath_vm_mathematical_functions` diff --git a/source/elements/oneMKL/source/domains/vm/vm-exceptions.rst b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst similarity index 98% rename from source/elements/oneMKL/source/domains/vm/vm-exceptions.rst rename to source/elements/oneMath/source/domains/vm/vm-exceptions.rst index 1e1e8300d..b6009a7d4 100644 --- a/source/elements/oneMKL/source/domains/vm/vm-exceptions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_exceptions: +.. _onemath_vm_exceptions: Exceptions ========== diff --git a/source/elements/oneMKL/source/domains/vm/vm-mathematical-functions.rst b/source/elements/oneMath/source/domains/vm/vm-mathematical-functions.rst similarity index 76% rename from source/elements/oneMKL/source/domains/vm/vm-mathematical-functions.rst rename to source/elements/oneMath/source/domains/vm/vm-mathematical-functions.rst index 466af75e4..cbdfebfda 100644 --- a/source/elements/oneMKL/source/domains/vm/vm-mathematical-functions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-mathematical-functions.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_mathematical_functions: +.. _onemath_vm_mathematical_functions: VM Mathematical Functions ========================= @@ -48,29 +48,29 @@ VM Mathematical Functions * - Arithmetic Routines - Description - * - :ref:`onemkl_vm_add` + * - :ref:`onemath_vm_add` - Adds vector elements - * - :ref:`onemkl_vm_sub` + * - :ref:`onemath_vm_sub` - Subtracts vector elements - * - :ref:`onemkl_vm_sqr` + * - :ref:`onemath_vm_sqr` - Squares vector elements - * - :ref:`onemkl_vm_mul` + * - :ref:`onemath_vm_mul` - Multiplies vector elements - * - :ref:`onemkl_vm_mulbyconj` + * - :ref:`onemath_vm_mulbyconj` - Multiplies elements of one vector by conjugated elements of the second vector - * - :ref:`onemkl_vm_conj` + * - :ref:`onemath_vm_conj` - Conjugates vector elements - * - :ref:`onemkl_vm_abs` + * - :ref:`onemath_vm_abs` - Computes the absolute value of vector elements - * - :ref:`onemkl_vm_arg` + * - :ref:`onemath_vm_arg` - Computes the argument of vector elements - * - :ref:`onemkl_vm_linearfrac` + * - :ref:`onemath_vm_linearfrac` - Performs linear fraction transformation of vectors - * - :ref:`onemkl_vm_fmod` + * - :ref:`onemath_vm_fmod` - Performs element by element computation of the modulus function of vector ``a`` with respect to vector ``b`` - * - :ref:`onemkl_vm_remainder` + * - :ref:`onemath_vm_remainder` - Performs element by element computation of the remainder function on the elements of vector ``a`` and the corresponding elements of vector ``b`` @@ -83,30 +83,30 @@ VM Mathematical Functions * - Power and Root Routines - Description - * - :ref:`onemkl_vm_inv` + * - :ref:`onemath_vm_inv` - Inverts vector elements - * - :ref:`onemkl_vm_div` + * - :ref:`onemath_vm_div` - Divides elements of one vector by elements of the second vector - * - :ref:`onemkl_vm_sqrt` + * - :ref:`onemath_vm_sqrt` - Computes the square root of vector elements - * - :ref:`onemkl_vm_invsqrt` + * - :ref:`onemath_vm_invsqrt` - Computes the inverse square root of vector elements - * - :ref:`onemkl_vm_cbrt` + * - :ref:`onemath_vm_cbrt` - Computes the cube root of vector elements - * - :ref:`onemkl_vm_invcbrt` + * - :ref:`onemath_vm_invcbrt` - Computes the inverse cube root of vector elements - * - :ref:`onemkl_vm_pow2o3` + * - :ref:`onemath_vm_pow2o3` - Computes the cube root of the square of each vector element - * - :ref:`onemkl_vm_pow3o2` + * - :ref:`onemath_vm_pow3o2` - Computes the square root of the cube of each vector element - * - :ref:`onemkl_vm_pow` + * - :ref:`onemath_vm_pow` - Raises each vector element to the specified power - * - :ref:`onemkl_vm_powx` + * - :ref:`onemath_vm_powx` - Raises each vector element to the constant power - * - :ref:`onemkl_vm_powr` + * - :ref:`onemath_vm_powr` - Computes ``a`` to the power ``b`` for elements of two vectors, where the elements of vector argument ``a`` are all non-negative - * - :ref:`onemkl_vm_hypot` + * - :ref:`onemath_vm_hypot` - Computes the square root of sum of squares .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -117,25 +117,25 @@ VM Mathematical Functions * - Exponential and Logarithmic Routines - Description - * - :ref:`onemkl_vm_exp` + * - :ref:`onemath_vm_exp` - Computes the base ``e`` exponential of vector elements - * - :ref:`onemkl_vm_exp2` + * - :ref:`onemath_vm_exp2` - Computes the base 2 exponential of vector elements - * - :ref:`onemkl_vm_exp10` + * - :ref:`onemath_vm_exp10` - Computes the base 10 exponential of vector elements - * - :ref:`onemkl_vm_expm1` + * - :ref:`onemath_vm_expm1` - Computes the base ``e`` exponential of vector elements decreased by 1 - * - :ref:`onemkl_vm_ln` + * - :ref:`onemath_vm_ln` - Computes the natural logarithm of vector elements - * - :ref:`onemkl_vm_log2` + * - :ref:`onemath_vm_log2` - Computes the base 2 logarithm of vector elements - * - :ref:`onemkl_vm_log10` + * - :ref:`onemath_vm_log10` - Computes the base 10 logarithm of vector elements - * - :ref:`onemkl_vm_log1p` + * - :ref:`onemath_vm_log1p` - Computes the natural logarithm of vector elements that are increased by 1 - * - :ref:`onemkl_vm_logb` + * - :ref:`onemath_vm_logb` - Computes the exponents of the elements of input vector ``a`` .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -146,46 +146,46 @@ VM Mathematical Functions * - Trigonometric Routines - Description - * - :ref:`onemkl_vm_cos` + * - :ref:`onemath_vm_cos` - Computes the cosine of vector elements - * - :ref:`onemkl_vm_sin` + * - :ref:`onemath_vm_sin` - Computes the sine of vector elements - * - :ref:`onemkl_vm_sincos` + * - :ref:`onemath_vm_sincos` - Computes the sine and cosine of vector elements - * - :ref:`onemkl_vm_cis` + * - :ref:`onemath_vm_cis` - Computes the complex exponent of vector elements (cosine and sine combined to complex value) - * - :ref:`onemkl_vm_tan` + * - :ref:`onemath_vm_tan` - Computes the tangent of vector elements - * - :ref:`onemkl_vm_acos` + * - :ref:`onemath_vm_acos` - Computes the inverse cosine of vector elements - * - :ref:`onemkl_vm_asin` + * - :ref:`onemath_vm_asin` - Computes the inverse sine of vector elements - * - :ref:`onemkl_vm_atan` + * - :ref:`onemath_vm_atan` - Computes the inverse tangent of vector elements - * - :ref:`onemkl_vm_atan2` + * - :ref:`onemath_vm_atan2` - Computes the four-quadrant inverse tangent of ratios of the elements of two vectors - * - :ref:`onemkl_vm_cospi` + * - :ref:`onemath_vm_cospi` - Computes the cosine of vector elements multiplied by ``π`` - * - :ref:`onemkl_vm_sinpi` + * - :ref:`onemath_vm_sinpi` - Computes the sine of vector elements multiplied by ``π`` - * - :ref:`onemkl_vm_tanpi` + * - :ref:`onemath_vm_tanpi` - Computes the tangent of vector elements multiplied by ``π`` - * - :ref:`onemkl_vm_acospi` + * - :ref:`onemath_vm_acospi` - Computes the inverse cosine of vector elements divided by ``π`` - * - :ref:`onemkl_vm_asinpi` + * - :ref:`onemath_vm_asinpi` - Computes the inverse sine of vector elements divided by ``π`` - * - :ref:`onemkl_vm_atanpi` + * - :ref:`onemath_vm_atanpi` - Computes the inverse tangent of vector elements divided by ``π`` - * - :ref:`onemkl_vm_atan2pi` + * - :ref:`onemath_vm_atan2pi` - Computes the four-quadrant inverse tangent of the ratios of the corresponding elements of two vectors divided by ``π`` - * - :ref:`onemkl_vm_cosd` + * - :ref:`onemath_vm_cosd` - Computes the cosine of vector elements multiplied by ``π``/180 - * - :ref:`onemkl_vm_sind` + * - :ref:`onemath_vm_sind` - Computes the sine of vector elements multiplied by ``π``/180 - * - :ref:`onemkl_vm_tand` + * - :ref:`onemath_vm_tand` - Computes the tangent of vector elements multiplied by ``π``/180 .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -196,17 +196,17 @@ VM Mathematical Functions * - Hyperbolic Routines - Description - * - :ref:`onemkl_vm_cosh` + * - :ref:`onemath_vm_cosh` - Computes the hyperbolic cosine of vector elements - * - :ref:`onemkl_vm_sinh` + * - :ref:`onemath_vm_sinh` - Computes the hyperbolic sine of vector elements - * - :ref:`onemkl_vm_tanh` + * - :ref:`onemath_vm_tanh` - Computes the hyperbolic tangent of vector elements - * - :ref:`onemkl_vm_acosh` + * - :ref:`onemath_vm_acosh` - Computes the inverse hyperbolic cosine of vector elements - * - :ref:`onemkl_vm_asinh` + * - :ref:`onemath_vm_asinh` - Computes the inverse hyperbolic sine of vector elements - * - :ref:`onemkl_vm_atanh` + * - :ref:`onemath_vm_atanh` - Computes the inverse hyperbolic tangent of vector elements. .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -217,27 +217,27 @@ VM Mathematical Functions * - Special Routines - Description - * - :ref:`onemkl_vm_erf` + * - :ref:`onemath_vm_erf` - Computes the error function value of vector elements - * - :ref:`onemkl_vm_erfc` + * - :ref:`onemath_vm_erfc` - Computes the complementary error function value of vector elements - * - :ref:`onemkl_vm_cdfnorm` + * - :ref:`onemath_vm_cdfnorm` - Computes the cumulative normal distribution function value of vector elements - * - :ref:`onemkl_vm_erfinv` + * - :ref:`onemath_vm_erfinv` - Computes the inverse error function value of vector elements - * - :ref:`onemkl_vm_erfcinv` + * - :ref:`onemath_vm_erfcinv` - Computes the inverse complementary error function value of vector elements - * - :ref:`onemkl_vm_cdfnorminv` + * - :ref:`onemath_vm_cdfnorminv` - Computes the inverse cumulative normal distribution function value of vector elements - * - :ref:`onemkl_vm_lgamma` + * - :ref:`onemath_vm_lgamma` - Computes the natural logarithm for the absolute value of the gamma function of vector elements - * - :ref:`onemkl_vm_tgamma` + * - :ref:`onemath_vm_tgamma` - Computes the gamma function of vector elements - * - :ref:`onemkl_vm_expint1` + * - :ref:`onemath_vm_expint1` - Computes the exponential integral of vector elements .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -248,22 +248,22 @@ VM Mathematical Functions * - Rounding Routines - Description - * - :ref:`onemkl_vm_floor` + * - :ref:`onemath_vm_floor` - Rounds towards minus infinity - * - :ref:`onemkl_vm_ceil` + * - :ref:`onemath_vm_ceil` - Rounds towards plus infinity - * - :ref:`onemkl_vm_trunc` + * - :ref:`onemath_vm_trunc` - Rounds towards zero infinity - * - :ref:`onemkl_vm_round` + * - :ref:`onemath_vm_round` - Rounds to nearest integer - * - :ref:`onemkl_vm_nearbyint` + * - :ref:`onemath_vm_nearbyint` - Rounds according to current mode - * - :ref:`onemkl_vm_rint` + * - :ref:`onemath_vm_rint` - Rounds according to current mode and reports inexact result status - * - :ref:`onemkl_vm_modf` + * - :ref:`onemath_vm_modf` - Computes the integer and fractional parts - * - :ref:`onemkl_vm_frac` + * - :ref:`onemath_vm_frac` - Computes the fractional part .. tabularcolumns:: |p{0.4\textwidth}|p{0.6\textwidth}| @@ -274,33 +274,33 @@ VM Mathematical Functions * - Miscellaneous Routines - Description - * - :ref:`onemkl_vm_copysign` + * - :ref:`onemath_vm_copysign` - Returns vector of elements of one argument with signs changed to match other argument elements - * - :ref:`onemkl_vm_nextafter` + * - :ref:`onemath_vm_nextafter` - Returns vector of elements containing the next representable floating-point values following the values from the elements of one vector in the direction of the corresponding elements of another vector - * - :ref:`onemkl_vm_fdim` + * - :ref:`onemath_vm_fdim` - Returns vector containing the differences of the corresponding elements of the vector arguments if the first is larger and +0 otherwise - * - :ref:`onemkl_vm_fmax` + * - :ref:`onemath_vm_fmax` - Returns the larger of each pair of elements of the two vector arguments - * - :ref:`onemkl_vm_fmin` + * - :ref:`onemath_vm_fmin` - Returns the smaller of each pair of elements of the two vector arguments - * - :ref:`onemkl_vm_maxmag` + * - :ref:`onemath_vm_maxmag` - Returns the element with the larger magnitude between each pair of elements of the two vector arguments - * - :ref:`onemkl_vm_minmag` + * - :ref:`onemath_vm_minmag` - Returns the element with the smaller magnitude between each pair of elements of the two vector arguments -**Parent topic:** :ref:`onemkl_vm` +**Parent topic:** :ref:`onemath_vm` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/vm/vm-service-functions.rst b/source/elements/oneMath/source/domains/vm/vm-service-functions.rst similarity index 75% rename from source/elements/oneMKL/source/domains/vm/vm-service-functions.rst rename to source/elements/oneMath/source/domains/vm/vm-service-functions.rst index 518784d18..fd183d0c2 100644 --- a/source/elements/oneMKL/source/domains/vm/vm-service-functions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-service-functions.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm_service_functions: +.. _onemath_vm_service_functions: VM Service Functions ==================== @@ -25,21 +25,21 @@ VM Service Functions * - Function Short Name - Description - * - :ref:`onemkl_vm_setmode` + * - :ref:`onemath_vm_setmode` - Sets the VM mode for given queue - * - :ref:`onemkl_vm_get_mode` + * - :ref:`onemath_vm_get_mode` - Gets the VM mode for given queue - * - :ref:`onemkl_vm_set_status` + * - :ref:`onemath_vm_set_status` - Sets the VM status code for given queue - * - :ref:`onemkl_vm_get_status` + * - :ref:`onemath_vm_get_status` - Gets the VM status code for given queue - * - :ref:`onemkl_vm_clear_status` + * - :ref:`onemath_vm_clear_status` - Clears the VM status code for given queue - * - :ref:`onemkl_vm_create_error_handler` + * - :ref:`onemath_vm_create_error_handler` - Creates the local VM error handler for a function -**Parent topic:** :ref:`onemkl_vm` +**Parent topic:** :ref:`onemath_vm` .. toctree:: :hidden: diff --git a/source/elements/oneMKL/source/domains/vm/vm.rst b/source/elements/oneMath/source/domains/vm/vm.rst similarity index 81% rename from source/elements/oneMKL/source/domains/vm/vm.rst rename to source/elements/oneMath/source/domains/vm/vm.rst index fe984e90c..b971c4f00 100644 --- a/source/elements/oneMKL/source/domains/vm/vm.rst +++ b/source/elements/oneMath/source/domains/vm/vm.rst @@ -2,7 +2,7 @@ .. .. SPDX-License-Identifier: CC-BY-4.0 -.. _onemkl_vm: +.. _onemath_vm: Vector Math ------------ @@ -18,12 +18,12 @@ Vector Math operations they perform: - - :ref:`onemkl_vm_mathematical_functions` compute values of mathematical + - :ref:`onemath_vm_mathematical_functions` compute values of mathematical functions, such as sine, cosine, exponential, or logarithm, on vectors stored contiguously in memory. - - :ref:`onemkl_vm_service_functions` set/get the accuracy modes and the + - :ref:`onemath_vm_service_functions` set/get the accuracy modes and the error codes, and create error handlers for mathematical functions. @@ -33,7 +33,7 @@ Vector Math can perform in-place operations, where the input and output arrays are at the same memory locations. - - :ref:`onemkl_vm_special_value_notations` + - :ref:`onemath_vm_special_value_notations` .. toctree:: :hidden: @@ -44,4 +44,4 @@ Vector Math vm-exceptions.rst bibliography.rst -**Parent topic:** :ref:`onemkl_vm_inc` \ No newline at end of file +**Parent topic:** :ref:`onemath_vm_inc` \ No newline at end of file diff --git a/source/elements/oneMath/source/index.rst b/source/elements/oneMath/source/index.rst new file mode 100644 index 000000000..8d4d608ef --- /dev/null +++ b/source/elements/oneMath/source/index.rst @@ -0,0 +1,24 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _oneMath-section: + +====== +oneMath +====== + +The |mkl_full_name| (oneMath) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMath is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math. + + +The general assumptions, design features and requirements for the oneMath library and host-to-device computational routines will be described in :ref:`onemath_architecture`. +The individual domains and their APIs are described in :ref:`onemath_domains`. +Other design considerations that are not necessarily part of the oneMath specification but that are worth mentioning will be discussed in :ref:`onemath_appendix`. + + +.. toctree:: + :maxdepth: 2 + + architecture/architecture.rst + domains/domains.rst + appendix/appendix.rst diff --git a/source/index.rst b/source/index.rst index b6f7398d9..457ba57b7 100644 --- a/source/index.rst +++ b/source/index.rst @@ -25,6 +25,6 @@ for creating parallel applications: elements/oneCCL/source/index elements/oneDAL/source/index elements/oneTBB/source/nested-index - elements/oneMKL/source/index + elements/oneMath/source/index Releases notices diff --git a/source/spelling_wordlist.txt b/source/spelling_wordlist.txt index f37d64b6c..57ad846a4 100644 --- a/source/spelling_wordlist.txt +++ b/source/spelling_wordlist.txt @@ -547,11 +547,11 @@ oneCCL oneDAL oneDNN oneDPL -oneMKL +oneMath oneTBB oneVPL oneapi -onemkl +onemath opencl oqueueing orgbr From 8adeb29e2dd07cfc1caf3ff81c5cd7c9dda65ef6 Mon Sep 17 00:00:00 2001 From: nscipione Date: Wed, 9 Oct 2024 17:02:18 +0200 Subject: [PATCH 02/16] Renaming part 2 - Rename the namespace oneapi::mkl to oneapi::math and references to the folder oneapi/mkl to oneapi/math Signed-off-by: nscipione --- .../source/architecture/api_design.inc.rst | 24 ++-- .../source/architecture/exceptions.inc.rst | 28 ++-- .../oneMath/source/domains/blas/asum.rst | 28 ++-- .../oneMath/source/domains/blas/axpby.rst | 28 ++-- .../oneMath/source/domains/blas/axpy.rst | 28 ++-- .../source/domains/blas/axpy_batch.rst | 32 ++--- .../oneMath/source/domains/blas/copy.rst | 28 ++-- .../source/domains/blas/copy_batch.rst | 32 ++--- .../source/domains/blas/dgmm_batch.rst | 46 +++---- .../oneMath/source/domains/blas/dot.rst | 28 ++-- .../oneMath/source/domains/blas/dotc.rst | 28 ++-- .../oneMath/source/domains/blas/dotu.rst | 28 ++-- .../oneMath/source/domains/blas/gbmv.rst | 36 +++--- .../oneMath/source/domains/blas/gemm.rst | 44 +++---- .../source/domains/blas/gemm_batch.rst | 68 +++++----- .../oneMath/source/domains/blas/gemm_bias.rst | 52 ++++---- .../oneMath/source/domains/blas/gemmt.rst | 52 ++++---- .../oneMath/source/domains/blas/gemv.rst | 36 +++--- .../source/domains/blas/gemv_batch.rst | 46 +++---- .../oneMath/source/domains/blas/ger.rst | 28 ++-- .../oneMath/source/domains/blas/gerc.rst | 28 ++-- .../oneMath/source/domains/blas/geru.rst | 28 ++-- .../oneMath/source/domains/blas/hbmv.rst | 36 +++--- .../oneMath/source/domains/blas/hemm.rst | 44 +++---- .../oneMath/source/domains/blas/hemv.rst | 36 +++--- .../oneMath/source/domains/blas/her.rst | 36 +++--- .../oneMath/source/domains/blas/her2.rst | 36 +++--- .../oneMath/source/domains/blas/her2k.rst | 44 +++---- .../oneMath/source/domains/blas/herk.rst | 44 +++---- .../oneMath/source/domains/blas/hpmv.rst | 36 +++--- .../oneMath/source/domains/blas/hpr.rst | 36 +++--- .../oneMath/source/domains/blas/hpr2.rst | 36 +++--- .../oneMath/source/domains/blas/iamax.rst | 40 +++--- .../oneMath/source/domains/blas/iamin.rst | 40 +++--- .../oneMath/source/domains/blas/imatcopy.rst | 36 +++--- .../source/domains/blas/imatcopy_batch.rst | 44 +++---- .../oneMath/source/domains/blas/nrm2.rst | 28 ++-- .../oneMath/source/domains/blas/omatadd.rst | 44 +++---- .../source/domains/blas/omatadd_batch.rst | 56 ++++---- .../oneMath/source/domains/blas/omatcopy.rst | 36 +++--- .../oneMath/source/domains/blas/omatcopy2.rst | 36 +++--- .../source/domains/blas/omatcopy_batch.rst | 40 +++--- .../oneMath/source/domains/blas/rot.rst | 34 ++--- .../oneMath/source/domains/blas/rotg.rst | 28 ++-- .../oneMath/source/domains/blas/rotm.rst | 28 ++-- .../oneMath/source/domains/blas/rotmg.rst | 28 ++-- .../oneMath/source/domains/blas/sbmv.rst | 36 +++--- .../oneMath/source/domains/blas/scal.rst | 28 ++-- .../oneMath/source/domains/blas/sdsdot.rst | 28 ++-- .../oneMath/source/domains/blas/spmv.rst | 36 +++--- .../oneMath/source/domains/blas/spr.rst | 36 +++--- .../oneMath/source/domains/blas/spr2.rst | 36 +++--- .../oneMath/source/domains/blas/swap.rst | 28 ++-- .../oneMath/source/domains/blas/symm.rst | 44 +++---- .../oneMath/source/domains/blas/symv.rst | 36 +++--- .../oneMath/source/domains/blas/syr.rst | 36 +++--- .../oneMath/source/domains/blas/syr2.rst | 36 +++--- .../oneMath/source/domains/blas/syr2k.rst | 44 +++---- .../oneMath/source/domains/blas/syrk.rst | 44 +++---- .../source/domains/blas/syrk_batch.rst | 44 +++---- .../oneMath/source/domains/blas/tbmv.rst | 52 ++++---- .../oneMath/source/domains/blas/tbsv.rst | 52 ++++---- .../oneMath/source/domains/blas/tpmv.rst | 52 ++++---- .../oneMath/source/domains/blas/tpsv.rst | 52 ++++---- .../oneMath/source/domains/blas/trmm.rst | 120 +++++++++--------- .../oneMath/source/domains/blas/trmv.rst | 52 ++++---- .../oneMath/source/domains/blas/trsm.rst | 120 +++++++++--------- .../source/domains/blas/trsm_batch.rst | 94 +++++++------- .../oneMath/source/domains/blas/trsv.rst | 52 ++++---- .../source/domains/dft/compute_backward.rst | 16 +-- .../source/domains/dft/compute_forward.rst | 16 +-- .../dft/config_params/storage_formats.rst | 6 +- .../oneMath/source/domains/dft/descriptor.rst | 24 ++-- .../oneMath/source/domains/lapack/gebrd.rst | 28 ++-- .../domains/lapack/gebrd_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/geqrf.rst | 28 ++-- .../source/domains/lapack/geqrf_batch.rst | 30 ++--- .../lapack/geqrf_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/geqrf_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/gerqf.rst | 28 ++-- .../domains/lapack/gerqf_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/gesvd.rst | 32 ++--- .../domains/lapack/gesvd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/getrf.rst | 28 ++-- .../source/domains/lapack/getrf_batch.rst | 30 ++--- .../lapack/getrf_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/getrf_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/getri.rst | 28 ++-- .../source/domains/lapack/getri_batch.rst | 30 ++--- .../lapack/getri_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/getri_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/getrs.rst | 50 ++++---- .../source/domains/lapack/getrs_batch.rst | 30 ++--- .../lapack/getrs_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/getrs_scratchpad_size.rst | 16 +-- .../oneMath/source/domains/lapack/heevd.rst | 40 +++--- .../domains/lapack/heevd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/hegvd.rst | 40 +++--- .../domains/lapack/hegvd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/hetrd.rst | 32 ++--- .../domains/lapack/hetrd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/hetrf.rst | 40 +++--- .../domains/lapack/hetrf_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/orgbr.rst | 32 ++--- .../domains/lapack/orgbr_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/orgqr.rst | 36 +++--- .../source/domains/lapack/orgqr_batch.rst | 30 ++--- .../lapack/orgqr_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/orgqr_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/orgtr.rst | 32 ++--- .../domains/lapack/orgtr_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/ormqr.rst | 56 ++++---- .../domains/lapack/ormqr_scratchpad_size.rst | 18 +-- .../oneMath/source/domains/lapack/ormrq.rst | 56 ++++---- .../domains/lapack/ormrq_scratchpad_size.rst | 18 +-- .../oneMath/source/domains/lapack/ormtr.rst | 32 ++--- .../domains/lapack/ormtr_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/potrf.rst | 44 +++---- .../source/domains/lapack/potrf_batch.rst | 30 ++--- .../lapack/potrf_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/potrf_scratchpad_size.rst | 14 +- .../oneMath/source/domains/lapack/potri.rst | 40 +++--- .../domains/lapack/potri_scratchpad_size.rst | 14 +- .../oneMath/source/domains/lapack/potrs.rst | 44 +++---- .../source/domains/lapack/potrs_batch.rst | 30 ++--- .../lapack/potrs_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/potrs_scratchpad_size.rst | 14 +- .../oneMath/source/domains/lapack/syevd.rst | 40 +++--- .../domains/lapack/syevd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/sygvd.rst | 40 +++--- .../domains/lapack/sygvd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/sytrd.rst | 32 ++--- .../domains/lapack/sytrd_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/sytrf.rst | 40 +++--- .../domains/lapack/sytrf_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/trtrs.rst | 32 ++--- .../domains/lapack/trtrs_scratchpad_size.rst | 18 +-- .../oneMath/source/domains/lapack/ungbr.rst | 40 +++--- .../domains/lapack/ungbr_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/ungqr.rst | 36 +++--- .../source/domains/lapack/ungqr_batch.rst | 30 ++--- .../lapack/ungqr_batch_scratchpad_size.rst | 16 +-- .../domains/lapack/ungqr_scratchpad_size.rst | 8 +- .../oneMath/source/domains/lapack/ungtr.rst | 32 ++--- .../domains/lapack/ungtr_scratchpad_size.rst | 10 +- .../oneMath/source/domains/lapack/unmqr.rst | 56 ++++---- .../domains/lapack/unmqr_scratchpad_size.rst | 18 +-- .../oneMath/source/domains/lapack/unmrq.rst | 56 ++++---- .../domains/lapack/unmrq_scratchpad_size.rst | 16 +-- .../oneMath/source/domains/lapack/unmtr.rst | 32 ++--- .../domains/lapack/unmtr_scratchpad_size.rst | 10 +- .../rng/device_api/device-rng-bernoulli.rst | 10 +- .../rng/device_api/device-rng-beta.rst | 4 +- .../rng/device_api/device-rng-bits.rst | 2 +- .../rng/device_api/device-rng-exponential.rst | 12 +- .../rng/device_api/device-rng-gamma.rst | 4 +- .../rng/device_api/device-rng-gaussian.rst | 8 +- .../rng/device_api/device-rng-generate.rst | 2 +- .../rng/device_api/device-rng-lognormal.rst | 10 +- .../rng/device_api/device-rng-mcg31m1.rst | 2 +- .../rng/device_api/device-rng-mcg59.rst | 2 +- .../rng/device_api/device-rng-mrg32k3a.rst | 2 +- .../device_api/device-rng-philox4x32x10.rst | 2 +- .../rng/device_api/device-rng-poisson.rst | 10 +- .../rng/device_api/device-rng-skip-ahead.rst | 4 +- .../device_api/device-rng-uniform-bits.rst | 2 +- .../device-rng-uniform-continuous.rst | 10 +- .../device-rng-uniform-discrete.rst | 12 +- .../rng/device_api/device-rng-usage-model.rst | 16 +-- .../rng/device_api/device-routines.rst | 4 +- .../domains/rng/host_api/distributions.rst | 14 +- .../domains/rng/host_api/mkl-rng-ars5.rst | 6 +- .../rng/host_api/mkl-rng-bernoulli.rst | 12 +- .../domains/rng/host_api/mkl-rng-beta.rst | 14 +- .../domains/rng/host_api/mkl-rng-binomial.rst | 12 +- .../domains/rng/host_api/mkl-rng-bits.rst | 4 +- .../domains/rng/host_api/mkl-rng-cauchy.rst | 12 +- .../rng/host_api/mkl-rng-chi_square.rst | 12 +- .../rng/host_api/mkl-rng-exponential.rst | 14 +- .../domains/rng/host_api/mkl-rng-gamma.rst | 14 +- .../domains/rng/host_api/mkl-rng-gaussian.rst | 16 +-- .../rng/host_api/mkl-rng-gaussian_mv.rst | 24 ++-- .../domains/rng/host_api/mkl-rng-generate.rst | 10 +- .../rng/host_api/mkl-rng-geometric.rst | 12 +- .../domains/rng/host_api/mkl-rng-gumbel.rst | 12 +- .../rng/host_api/mkl-rng-hypergeometric.rst | 12 +- .../domains/rng/host_api/mkl-rng-laplace.rst | 10 +- .../domains/rng/host_api/mkl-rng-leapfrog.rst | 16 +-- .../rng/host_api/mkl-rng-lognormal.rst | 18 +-- .../domains/rng/host_api/mkl-rng-mcg31m1.rst | 4 +- .../domains/rng/host_api/mkl-rng-mcg59.rst | 4 +- .../domains/rng/host_api/mkl-rng-mrg32k3a.rst | 6 +- .../domains/rng/host_api/mkl-rng-mt19937.rst | 6 +- .../domains/rng/host_api/mkl-rng-mt2203.rst | 12 +- .../rng/host_api/mkl-rng-multinomial.rst | 12 +- .../rng/host_api/mkl-rng-negbinomial.rst | 12 +- .../rng/host_api/mkl-rng-niederreiter.rst | 6 +- .../rng/host_api/mkl-rng-nondeterministic.rst | 4 +- .../rng/host_api/mkl-rng-philox4x32x10.rst | 6 +- .../domains/rng/host_api/mkl-rng-poisson.rst | 14 +- .../rng/host_api/mkl-rng-poisson_v.rst | 12 +- .../domains/rng/host_api/mkl-rng-r250.rst | 6 +- .../domains/rng/host_api/mkl-rng-rayleigh.rst | 14 +- .../rng/host_api/mkl-rng-sfmt19937.rst | 6 +- .../rng/host_api/mkl-rng-skip_ahead.rst | 24 ++-- .../domains/rng/host_api/mkl-rng-sobol.rst | 6 +- .../host_api/mkl-rng-uniform-continuous.rst | 14 +- .../rng/host_api/mkl-rng-uniform-discrete.rst | 12 +- .../rng/host_api/mkl-rng-uniform_bits.rst | 4 +- .../domains/rng/host_api/mkl-rng-weibull.rst | 14 +- .../rng/host_api/mkl-rng-wichmann_hill.rst | 12 +- .../rng/host_api/onemath-rng-usage-model.rst | 16 +-- .../spblas/data_types/data_handles.rst | 6 +- .../spblas/data_types/init_coo_matrix.rst | 28 ++-- .../spblas/data_types/init_csr_matrix.rst | 28 ++-- .../spblas/data_types/init_dense_matrix.rst | 26 ++-- .../spblas/data_types/init_dense_vector.rst | 26 ++-- .../data_types/release_dense_matrix.rst | 12 +- .../data_types/release_dense_vector.rst | 12 +- .../data_types/release_sparse_matrix.rst | 12 +- .../spblas/data_types/set_coo_matrix_data.rst | 26 ++-- .../spblas/data_types/set_csr_matrix_data.rst | 26 ++-- .../data_types/set_dense_matrix_data.rst | 26 ++-- .../data_types/set_dense_vector_data.rst | 26 ++-- .../spblas/data_types/set_matrix_property.rst | 16 +-- .../source/domains/spblas/matrix_view.rst | 8 +- .../source/domains/spblas/operations/spmm.rst | 116 ++++++++--------- .../source/domains/spblas/operations/spmv.rst | 108 ++++++++-------- .../source/domains/spblas/operations/spsv.rst | 108 ++++++++-------- .../stats/onemath_stats_central_moment.rst | 20 +-- ...onemath_stats_central_moment_user_mean.rst | 14 +- .../stats/onemath_stats_central_sum.rst | 18 +-- .../onemath_stats_central_sum_user_mean.rst | 14 +- .../domains/stats/onemath_stats_dataset.rst | 20 +-- .../domains/stats/onemath_stats_kurtosis.rst | 18 +-- .../onemath_stats_kurtosis_user_mean.rst | 18 +-- .../stats/onemath_stats_make_dataset.rst | 10 +- .../domains/stats/onemath_stats_max.rst | 14 +- .../domains/stats/onemath_stats_mean.rst | 18 +-- .../domains/stats/onemath_stats_min.rst | 14 +- .../domains/stats/onemath_stats_min_max.rst | 14 +- .../stats/onemath_stats_raw_moment.rst | 20 +-- .../domains/stats/onemath_stats_raw_sum.rst | 18 +-- .../domains/stats/onemath_stats_skewness.rst | 18 +-- .../onemath_stats_skewness_user_mean.rst | 14 +- .../stats/onemath_stats_usage_model.rst | 8 +- .../domains/stats/onemath_stats_variation.rst | 18 +-- .../onemath_stats_variation_user_mean.rst | 16 +-- .../source/domains/value_or_pointer.rst | 6 +- .../oneMath/source/domains/vm/abs.rst | 16 +-- .../oneMath/source/domains/vm/acos.rst | 26 ++-- .../oneMath/source/domains/vm/acosh.rst | 24 ++-- .../oneMath/source/domains/vm/acospi.rst | 26 ++-- .../oneMath/source/domains/vm/add.rst | 24 ++-- .../oneMath/source/domains/vm/arg.rst | 16 +-- .../oneMath/source/domains/vm/asin.rst | 26 ++-- .../oneMath/source/domains/vm/asinh.rst | 16 +-- .../oneMath/source/domains/vm/asinpi.rst | 26 ++-- .../oneMath/source/domains/vm/atan.rst | 16 +-- .../oneMath/source/domains/vm/atan2.rst | 16 +-- .../oneMath/source/domains/vm/atan2pi.rst | 16 +-- .../oneMath/source/domains/vm/atanh.rst | 32 ++--- .../oneMath/source/domains/vm/atanpi.rst | 16 +-- .../oneMath/source/domains/vm/cbrt.rst | 16 +-- .../oneMath/source/domains/vm/cdfnorm.rst | 22 ++-- .../oneMath/source/domains/vm/cdfnorminv.rst | 34 ++--- .../oneMath/source/domains/vm/ceil.rst | 16 +-- .../oneMath/source/domains/vm/cis.rst | 24 ++-- .../source/domains/vm/clear_status.rst | 24 ++-- .../oneMath/source/domains/vm/conj.rst | 16 +-- .../oneMath/source/domains/vm/copysign.rst | 16 +-- .../oneMath/source/domains/vm/cos.rst | 24 ++-- .../oneMath/source/domains/vm/cosd.rst | 24 ++-- .../oneMath/source/domains/vm/cosh.rst | 26 ++-- .../oneMath/source/domains/vm/cospi.rst | 24 ++-- .../domains/vm/create_error_handler.rst | 36 +++--- .../oneMath/source/domains/vm/div.rst | 34 ++--- .../oneMath/source/domains/vm/erf.rst | 16 +-- .../oneMath/source/domains/vm/erfc.rst | 22 ++-- .../oneMath/source/domains/vm/erfcinv.rst | 34 ++--- .../oneMath/source/domains/vm/erfinv.rst | 30 ++--- .../oneMath/source/domains/vm/exp.rst | 26 ++-- .../oneMath/source/domains/vm/exp10.rst | 24 ++-- .../oneMath/source/domains/vm/exp2.rst | 24 ++-- .../oneMath/source/domains/vm/expint1.rst | 28 ++-- .../oneMath/source/domains/vm/expm1.rst | 22 ++-- .../oneMath/source/domains/vm/fdim.rst | 16 +-- .../oneMath/source/domains/vm/floor.rst | 16 +-- .../oneMath/source/domains/vm/fmax.rst | 16 +-- .../oneMath/source/domains/vm/fmin.rst | 16 +-- .../oneMath/source/domains/vm/fmod.rst | 24 ++-- .../oneMath/source/domains/vm/frac.rst | 16 +-- .../oneMath/source/domains/vm/get_mode.rst | 14 +- .../oneMath/source/domains/vm/get_status.rst | 20 +-- .../oneMath/source/domains/vm/hypot.rst | 16 +-- .../oneMath/source/domains/vm/inv.rst | 24 ++-- .../oneMath/source/domains/vm/invcbrt.rst | 24 ++-- .../oneMath/source/domains/vm/invsqrt.rst | 28 ++-- .../oneMath/source/domains/vm/lgamma.rst | 30 ++--- .../oneMath/source/domains/vm/linearfrac.rst | 22 ++-- .../elements/oneMath/source/domains/vm/ln.rst | 28 ++-- .../oneMath/source/domains/vm/log10.rst | 28 ++-- .../oneMath/source/domains/vm/log1p.rst | 26 ++-- .../oneMath/source/domains/vm/log2.rst | 28 ++-- .../oneMath/source/domains/vm/logb.rst | 24 ++-- .../oneMath/source/domains/vm/maxmag.rst | 16 +-- .../oneMath/source/domains/vm/minmag.rst | 16 +-- .../oneMath/source/domains/vm/modf.rst | 16 +-- .../oneMath/source/domains/vm/mul.rst | 24 ++-- .../oneMath/source/domains/vm/mulbyconj.rst | 20 +-- .../oneMath/source/domains/vm/nearbyint.rst | 16 +-- .../oneMath/source/domains/vm/nextafter.rst | 24 ++-- .../oneMath/source/domains/vm/pow.rst | 48 +++---- .../oneMath/source/domains/vm/pow2o3.rst | 16 +-- .../oneMath/source/domains/vm/pow3o2.rst | 24 ++-- .../oneMath/source/domains/vm/powr.rst | 30 ++--- .../oneMath/source/domains/vm/powx.rst | 20 +-- .../oneMath/source/domains/vm/remainder.rst | 22 ++-- .../oneMath/source/domains/vm/rint.rst | 16 +-- .../oneMath/source/domains/vm/round.rst | 16 +-- .../oneMath/source/domains/vm/set_status.rst | 22 ++-- .../oneMath/source/domains/vm/setmode.rst | 18 +-- .../oneMath/source/domains/vm/sin.rst | 24 ++-- .../oneMath/source/domains/vm/sincos.rst | 24 ++-- .../oneMath/source/domains/vm/sind.rst | 24 ++-- .../oneMath/source/domains/vm/sinh.rst | 26 ++-- .../oneMath/source/domains/vm/sinpi.rst | 24 ++-- .../oneMath/source/domains/vm/sqr.rst | 16 +-- .../oneMath/source/domains/vm/sqrt.rst | 24 ++-- .../oneMath/source/domains/vm/sub.rst | 24 ++-- .../oneMath/source/domains/vm/tan.rst | 24 ++-- .../oneMath/source/domains/vm/tand.rst | 24 ++-- .../oneMath/source/domains/vm/tanh.rst | 16 +-- .../oneMath/source/domains/vm/tanpi.rst | 24 ++-- .../oneMath/source/domains/vm/tgamma.rst | 32 ++--- .../oneMath/source/domains/vm/trunc.rst | 16 +-- .../source/domains/vm/vm-exceptions.rst | 6 +- 337 files changed, 4137 insertions(+), 4137 deletions(-) diff --git a/source/elements/oneMath/source/architecture/api_design.inc.rst b/source/elements/oneMath/source/architecture/api_design.inc.rst index b2dddfefd..10093c729 100644 --- a/source/elements/oneMath/source/architecture/api_design.inc.rst +++ b/source/elements/oneMath/source/architecture/api_design.inc.rst @@ -14,28 +14,28 @@ This section discusses the general features of oneMath API design. In particular oneMath namespaces ++++++++++++++++++ -The oneMath library uses C++ namespaces to organize routines by mathematical domain. All oneMath objects and routines shall be contained within the ``oneapi::mkl`` base namespace. The individual oneMath domains use a secondary namespace layer as follows: +The oneMath library uses C++ namespaces to organize routines by mathematical domain. All oneMath objects and routines shall be contained within the ``oneapi::math`` base namespace. The individual oneMath domains use a secondary namespace layer as follows: ======================== ======================================================================================================= namespace oneMath domain or content ======================== ======================================================================================================= -``oneapi::mkl`` oneMath base namespace, contains general oneMath data types, objects, exceptions and routines -``oneapi::mkl::blas`` Dense linear algebra routines from BLAS and BLAS like extensions. The oneapi::mkl::blas namespace should contain two namespaces column_major and row_major to support both matrix layouts. See :ref:`onemath_blas` -``oneapi::mkl::lapack`` Dense linear algebra routines from LAPACK and LAPACK like extensions. See :ref:`onemath_lapack` -``oneapi::mkl::sparse`` Sparse linear algebra routines from Sparse BLAS and Sparse Solvers. See :ref:`onemath_sparse_linear_algebra` -``oneapi::mkl::dft`` Discrete Fourier Transforms. See :ref:`onemath_dft` -``oneapi::mkl::rng`` Random number generator routines. See :ref:`onemath_rng` -``oneapi::mkl::vm`` Vector mathematics routines, e.g. trigonometric, exponential functions acting on elements of a vector. See :ref:`onemath_vm` +``oneapi::math`` oneMath base namespace, contains general oneMath data types, objects, exceptions and routines +``oneapi::math::blas`` Dense linear algebra routines from BLAS and BLAS like extensions. The oneapi::math::blas namespace should contain two namespaces column_major and row_major to support both matrix layouts. See :ref:`onemath_blas` +``oneapi::math::lapack`` Dense linear algebra routines from LAPACK and LAPACK like extensions. See :ref:`onemath_lapack` +``oneapi::math::sparse`` Sparse linear algebra routines from Sparse BLAS and Sparse Solvers. See :ref:`onemath_sparse_linear_algebra` +``oneapi::math::dft`` Discrete Fourier Transforms. See :ref:`onemath_dft` +``oneapi::math::rng`` Random number generator routines. See :ref:`onemath_rng` +``oneapi::math::vm`` Vector mathematics routines, e.g. trigonometric, exponential functions acting on elements of a vector. See :ref:`onemath_vm` ======================== ======================================================================================================= .. note:: :name: Implementation Requirement Inside each oneMath domain, there are many routines, classes, enums and objects defined which constitute the breadth and scope of that oneMath domain. - It is permitted for a library implementation of the oneMath specification to implement either all, one or more than one of the domains in oneMath. However, within an implementation of a specific domain, all relevant routines, classes, enums and objects (including those relevant enums and objects which live outside a particular domain in the general ``oneapi::mkl`` namespace must be both declared and defined in the library so that an application that uses that domain could build and link against that library implementation successfully. + It is permitted for a library implementation of the oneMath specification to implement either all, one or more than one of the domains in oneMath. However, within an implementation of a specific domain, all relevant routines, classes, enums and objects (including those relevant enums and objects which live outside a particular domain in the general ``oneapi::math`` namespace must be both declared and defined in the library so that an application that uses that domain could build and link against that library implementation successfully. - It is however acceptable to throw the runtime exception :ref:`oneapi::mkl::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. - For instance, a library may choose to implement the oneMath BLAS functionality and in particular may choose to implement only the :ref:`onemath_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::mkl::unimplemented` exception inside all the others. + It is however acceptable to throw the runtime exception :ref:`oneapi::math::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. + For instance, a library may choose to implement the oneMath BLAS functionality and in particular may choose to implement only the :ref:`onemath_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::math::unimplemented` exception inside all the others. In such a case, the implemented routines in such a library should be communicated clearly and easily understood by users of that library. @@ -73,7 +73,7 @@ oneMath uses the following DPC++ data types: oneMath defined datatypes ++++++++++++++++++++++++ -oneMath dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::mkl`` namespace. +oneMath dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::math`` namespace. Each enumeration value comes with two names: A single-character name (the traditional BLAS/LAPACK character) and a longer, more descriptive name. The two names are exactly equivalent and may be used interchangeably. diff --git a/source/elements/oneMath/source/architecture/exceptions.inc.rst b/source/elements/oneMath/source/architecture/exceptions.inc.rst index 6675cb6bb..4d6ef9eea 100644 --- a/source/elements/oneMath/source/architecture/exceptions.inc.rst +++ b/source/elements/oneMath/source/architecture/exceptions.inc.rst @@ -15,7 +15,7 @@ Exception classification ++++++++++++++++++++++++ Exception classification in oneMath is aligned with C++ Standard Library classification. oneMath introduces class that defines the base class in the hierarchy of oneMath exception classes. All oneMath routines throw exceptions inherited from this base class. -In the hierarchy of oneMath exceptions, ``oneapi::mkl::exception`` is the base class inherited from ``std::exception`` class. All other oneMath exception classes are derived from this base class. +In the hierarchy of oneMath exceptions, ``oneapi::math::exception`` is the base class inherited from ``std::exception`` class. All other oneMath exception classes are derived from this base class. This specification does not require implementations to perform error-checking. However, if an implementation does provide error-checking, it shall use the following exception classes. Additional implementation-specific exception classes can be used for exceptional conditions not fitting any of these classes. @@ -30,31 +30,31 @@ Common exceptions ".. _onemath_exception: - ``oneapi::mkl::exception``", "Reports general unspecified problem" + ``oneapi::math::exception``", "Reports general unspecified problem" ".. _onemath_exception_unsupported_device: - ``oneapi::mkl::unsupported_device``", "Reports a problem when the routine is not supported on a specific device" + ``oneapi::math::unsupported_device``", "Reports a problem when the routine is not supported on a specific device" ".. _onemath_exception_host_bad_alloc: - ``oneapi::mkl::host_bad_alloc``", "Reports a problem that occurred during memory allocation on the host" + ``oneapi::math::host_bad_alloc``", "Reports a problem that occurred during memory allocation on the host" ".. _onemath_exception_device_bad_alloc: - ``oneapi::mkl::device_bad_alloc``", "Reports a problem that occurred during memory allocation on a specific device" + ``oneapi::math::device_bad_alloc``", "Reports a problem that occurred during memory allocation on a specific device" ".. _onemath_exception_unimplemented: - ``oneapi::mkl::unimplemented``", "Reports a problem when a specific routine has not been implemented for the specified parameters" + ``oneapi::math::unimplemented``", "Reports a problem when a specific routine has not been implemented for the specified parameters" ".. _onemath_exception_invalid_argument: - ``oneapi::mkl::invalid_argument``", "Reports problem when arguments to the routine were rejected" + ``oneapi::math::invalid_argument``", "Reports problem when arguments to the routine were rejected" ".. _onemath_exception_uninitialized: - ``oneapi::mkl::uninitialized``", "Reports problem when a handle (descriptor) has not been initialized" + ``oneapi::math::uninitialized``", "Reports problem when a handle (descriptor) has not been initialized" ".. _onemath_exception_computation_error: - ``oneapi::mkl::computation_error``", "Reports any computation errors that have occurred inside a oneMath routine" + ``oneapi::math::computation_error``", "Reports any computation errors that have occurred inside a oneMath routine" ".. _onemath_exception_batch_error: - ``oneapi::mkl::batch_error``", "Reports errors that have occurred inside a batch oneMath routine" + ``oneapi::math::batch_error``", "Reports errors that have occurred inside a batch oneMath routine" .. _onemath_lapack_specific_exceptions: @@ -68,14 +68,14 @@ LAPACK specific exceptions ".. _onemath_lapack_exception: - ``oneapi::mkl::lapack::exception``", "Base class for all LAPACK exceptions providing access to info code familiar to users of conventional LAPACK API. All LAPACK related exceptions can be handled with catch block for this class." + ``oneapi::math::lapack::exception``", "Base class for all LAPACK exceptions providing access to info code familiar to users of conventional LAPACK API. All LAPACK related exceptions can be handled with catch block for this class." ".. _onemath_lapack_exception_invalid_argument: - ``oneapi::mkl::lapack::invalid_argument``", "Reports errors when arguments provided to the LAPACK subroutine are inconsistent or do not match expected values. Class extends base ``oneapi::mkl::invalid_argument`` with ability to access conventional status info code." + ``oneapi::math::lapack::invalid_argument``", "Reports errors when arguments provided to the LAPACK subroutine are inconsistent or do not match expected values. Class extends base ``oneapi::math::invalid_argument`` with ability to access conventional status info code." ".. _onemath_lapack_exception_computation_error: - ``oneapi::mkl::lapack::computation_error``", "Reports computation errors that have occurred during call to LAPACK subroutine. Class extends base ``oneapi::mkl::computation_error`` with ability to access conventional status info code familiar to LAPACK users." + ``oneapi::math::lapack::computation_error``", "Reports computation errors that have occurred during call to LAPACK subroutine. Class extends base ``oneapi::math::computation_error`` with ability to access conventional status info code familiar to LAPACK users." ".. _onemath_lapack_exception_batch_error: - ``oneapi::mkl::lapack::batch_error``", "Reports errors that have occurred during batch LAPACK computations. Class extends base ``oneapi::mkl::batch_error`` with ability to access individual exception objects for each of the issues observed in a batch and an info code. The info code contains the number of errors that occurred in a batch. Positions of problems in a supplied batch that experienced issues during computations can be retrieved with `ids()` method, and list of particular exceptions can be obtained with `exceptions()` method of the exception object. Possible exceptions for a batch are documented for corresponding non-batch API." + ``oneapi::math::lapack::batch_error``", "Reports errors that have occurred during batch LAPACK computations. Class extends base ``oneapi::math::batch_error`` with ability to access individual exception objects for each of the issues observed in a batch and an info code. The info code contains the number of errors that occurred in a batch. Positions of problems in a supplied batch that experienced issues during computations can be retrieved with `ids()` method, and list of particular exceptions can be obtained with `exceptions()` method of the exception object. Possible exceptions for a batch are documented for corresponding non-batch API." diff --git a/source/elements/oneMath/source/domains/blas/asum.rst b/source/elements/oneMath/source/domains/blas/asum.rst index 62a73a418..e3f0bea06 100644 --- a/source/elements/oneMath/source/domains/blas/asum.rst +++ b/source/elements/oneMath/source/domains/blas/asum.rst @@ -48,7 +48,7 @@ asum (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void asum(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -57,7 +57,7 @@ asum (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void asum(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -97,19 +97,19 @@ asum (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_asum_usm: @@ -121,7 +121,7 @@ asum (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event asum(sycl::queue &queue, std::int64_t n, const T *x, @@ -131,7 +131,7 @@ asum (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event asum(sycl::queue &queue, std::int64_t n, const T *x, @@ -184,20 +184,20 @@ asum (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/axpby.rst b/source/elements/oneMath/source/domains/blas/axpby.rst index 15db2e6f9..5fddcf227 100644 --- a/source/elements/oneMath/source/domains/blas/axpby.rst +++ b/source/elements/oneMath/source/domains/blas/axpby.rst @@ -41,7 +41,7 @@ axpby (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void axpby(sycl::queue &queue, std::int64_t n, T alpha, @@ -51,7 +51,7 @@ axpby (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void axpby(sycl::queue &queue, std::int64_t n, T alpha, @@ -105,15 +105,15 @@ axpby (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_axpby_usm: @@ -124,7 +124,7 @@ axpby (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event axpby(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -135,7 +135,7 @@ axpby (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event axpby(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -200,15 +200,15 @@ axpby (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/axpy.rst b/source/elements/oneMath/source/domains/blas/axpy.rst index 8d9fd57f4..fa998673b 100644 --- a/source/elements/oneMath/source/domains/blas/axpy.rst +++ b/source/elements/oneMath/source/domains/blas/axpy.rst @@ -48,7 +48,7 @@ axpy (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void axpy(sycl::queue &queue, std::int64_t n, T alpha, @@ -59,7 +59,7 @@ axpy (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void axpy(sycl::queue &queue, std::int64_t n, T alpha, @@ -111,19 +111,19 @@ axpy (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_axpy_usm: @@ -135,7 +135,7 @@ axpy (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event axpy(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -147,7 +147,7 @@ axpy (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event axpy(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -212,20 +212,20 @@ axpy (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/axpy_batch.rst b/source/elements/oneMath/source/domains/blas/axpy_batch.rst index e9b6440f1..6896b280f 100644 --- a/source/elements/oneMath/source/domains/blas/axpy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/axpy_batch.rst @@ -57,7 +57,7 @@ where: .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void axpy_batch(sycl::queue &queue, std::int64_t n, T alpha, @@ -73,7 +73,7 @@ where: } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void axpy_batch(sycl::queue &queue, std::int64_t n, T alpha, @@ -136,19 +136,19 @@ where: This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_axpy_batch_usm: @@ -202,7 +202,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event axpy_batch(sycl::queue &queue, const std::int64_t *n, const T *alpha, @@ -216,7 +216,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event axpy_batch(sycl::queue &queue, const std::int64_t *n, const T *alpha, @@ -289,7 +289,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event axpy_batch(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -304,7 +304,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event axpy_batch(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -376,20 +376,20 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:**:ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/copy.rst b/source/elements/oneMath/source/domains/blas/copy.rst index 634e113f6..ee108451f 100644 --- a/source/elements/oneMath/source/domains/blas/copy.rst +++ b/source/elements/oneMath/source/domains/blas/copy.rst @@ -42,7 +42,7 @@ copy (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void copy(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -52,7 +52,7 @@ copy (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void copy(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -95,19 +95,19 @@ copy (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_copy_usm: @@ -119,7 +119,7 @@ copy (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event copy(sycl::queue &queue, std::int64_t n, const T *x, @@ -130,7 +130,7 @@ copy (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event copy(sycl::queue &queue, std::int64_t n, const T *x, @@ -185,20 +185,20 @@ copy (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/copy_batch.rst b/source/elements/oneMath/source/domains/blas/copy_batch.rst index 9b44e940c..2ada0ad07 100644 --- a/source/elements/oneMath/source/domains/blas/copy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/copy_batch.rst @@ -55,7 +55,7 @@ where: .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void copy_batch(sycl::queue &queue, std::int64_t n, sycl::buffer` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_copy_batch_usm: @@ -192,7 +192,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event copy_batch(sycl::queue &queue, const std::int64_t *n, const T **x, @@ -205,7 +205,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event copy_batch(sycl::queue &queue, const std::int64_t *n, const T **x, @@ -273,7 +273,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event copy_batch(sycl::queue &queue, std::int64_t n, const T *x, @@ -287,7 +287,7 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event copy_batch(sycl::queue &queue, std::int64_t n, const T *x, @@ -354,20 +354,20 @@ The total number of vectors in ``x`` and ``y`` are given by the ``batch_size`` p This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:**:ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/dgmm_batch.rst b/source/elements/oneMath/source/domains/blas/dgmm_batch.rst index e8572fc42..6a2480c9e 100644 --- a/source/elements/oneMath/source/domains/blas/dgmm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/dgmm_batch.rst @@ -61,9 +61,9 @@ of matrices in ``a`` and ``x`` buffers is given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void dgmm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, + oneapi::math::side left_right, std::int64_t m, std::int64_t n, sycl::buffer &a, @@ -79,9 +79,9 @@ of matrices in ``a`` and ``x`` buffers is given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void dgmm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, + oneapi::math::side left_right, std::int64_t m, std::int64_t n, sycl::buffer &a, @@ -171,19 +171,19 @@ of matrices in ``a`` and ``x`` buffers is given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_dgmm_batch_usm: @@ -203,7 +203,7 @@ The group API operation is defined as: for j = 0 … group_size – 1 a and c are matrices of size mxn at position idx in a_array and c_array x is a vector of size m or n depending on left_right, at position idx in x_array - if (left_right == oneapi::mkl::side::left) + if (left_right == oneapi::math::side::left) c := diag(x) * a else c := a * diag(x) @@ -246,9 +246,9 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event dgmm_batch(sycl::queue &queue, - const oneapi::mkl::side *left_right, + const oneapi::math::side *left_right, const std::int64_t *m, const std::int64_t *n, const T **a, @@ -263,9 +263,9 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event dgmm_batch(sycl::queue &queue, - const oneapi::mkl::side *left_right, + const oneapi::math::side *left_right, const std::int64_t *m, const std::int64_t *n, const T **a, @@ -370,9 +370,9 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event dgmm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, + oneapi::math::side left_right, std::int64_t m, std::int64_t n, const T *a, @@ -389,9 +389,9 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event dgmm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, + oneapi::math::side left_right, std::int64_t m, std::int64_t n, const T *a, @@ -488,20 +488,20 @@ in ``a`` and ``x`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/dot.rst b/source/elements/oneMath/source/domains/blas/dot.rst index ad528d808..103159eb1 100644 --- a/source/elements/oneMath/source/domains/blas/dot.rst +++ b/source/elements/oneMath/source/domains/blas/dot.rst @@ -54,7 +54,7 @@ dot (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void dot(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -65,7 +65,7 @@ dot (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void dot(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -114,19 +114,19 @@ dot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_dot_usm: @@ -138,7 +138,7 @@ dot (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event dot(sycl::queue &queue, std::int64_t n, const T *x, @@ -150,7 +150,7 @@ dot (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event dot(sycl::queue &queue, std::int64_t n, const T *x, @@ -212,20 +212,20 @@ dot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/dotc.rst b/source/elements/oneMath/source/domains/blas/dotc.rst index 4694e4ab4..002e81b86 100644 --- a/source/elements/oneMath/source/domains/blas/dotc.rst +++ b/source/elements/oneMath/source/domains/blas/dotc.rst @@ -38,7 +38,7 @@ dotc (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void dotc(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -49,7 +49,7 @@ dotc (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void dotc(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -98,19 +98,19 @@ dotc (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_dotc_usm: @@ -122,7 +122,7 @@ dotc (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void dotc(sycl::queue &queue, std::int64_t n, const T *x, @@ -134,7 +134,7 @@ dotc (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void dotc(sycl::queue &queue, std::int64_t n, const T *x, @@ -196,20 +196,20 @@ dotc (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/dotu.rst b/source/elements/oneMath/source/domains/blas/dotu.rst index 3b860011d..d1a2dbdf6 100644 --- a/source/elements/oneMath/source/domains/blas/dotu.rst +++ b/source/elements/oneMath/source/domains/blas/dotu.rst @@ -37,7 +37,7 @@ dotu (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void dotu(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -48,7 +48,7 @@ dotu (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void dotu(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -98,19 +98,19 @@ dotu (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_dotu_usm: @@ -122,7 +122,7 @@ dotu (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event dotu(sycl::queue &queue, std::int64_t n, const T *x, @@ -134,7 +134,7 @@ dotu (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event dotu(sycl::queue &queue, std::int64_t n, const T *x, @@ -196,20 +196,20 @@ dotu (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/gbmv.rst b/source/elements/oneMath/source/domains/blas/gbmv.rst index 6852602ab..52111276b 100644 --- a/source/elements/oneMath/source/domains/blas/gbmv.rst +++ b/source/elements/oneMath/source/domains/blas/gbmv.rst @@ -53,9 +53,9 @@ gbmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gbmv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t kl, @@ -71,9 +71,9 @@ gbmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gbmv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t kl, @@ -164,19 +164,19 @@ gbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gbmv_usm: @@ -188,9 +188,9 @@ gbmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gbmv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t kl, @@ -207,9 +207,9 @@ gbmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gbmv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t kl, @@ -312,20 +312,20 @@ gbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/gemm.rst b/source/elements/oneMath/source/domains/blas/gemm.rst index e2b9cd616..7c8b0cc45 100644 --- a/source/elements/oneMath/source/domains/blas/gemm.rst +++ b/source/elements/oneMath/source/domains/blas/gemm.rst @@ -99,10 +99,10 @@ gemm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemm(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -117,10 +117,10 @@ gemm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemm(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -277,19 +277,19 @@ gemm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemm_usm: @@ -301,10 +301,10 @@ gemm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemm(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -320,10 +320,10 @@ gemm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemm(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -497,19 +497,19 @@ gemm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/gemm_batch.rst b/source/elements/oneMath/source/domains/blas/gemm_batch.rst index 39dbce91f..690e725cd 100644 --- a/source/elements/oneMath/source/domains/blas/gemm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/gemm_batch.rst @@ -109,10 +109,10 @@ of matrices in ``a``, ``b`` and ``c`` buffers is given by the ``batch_size`` par .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemm_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -131,10 +131,10 @@ of matrices in ``a``, ``b`` and ``c`` buffers is given by the ``batch_size`` par } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemm_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -265,19 +265,19 @@ of matrices in ``a``, ``b`` and ``c`` buffers is given by the ``batch_size`` par This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemm_batch_usm: @@ -356,10 +356,10 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemm_batch(sycl::queue &queue, - const oneapi::mkl::transpose *transa, - const oneapi::mkl::transpose *transb, + const oneapi::math::transpose *transa, + const oneapi::math::transpose *transb, const std::int64_t *m, const std::int64_t *n, const std::int64_t *k, @@ -376,8 +376,8 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. const std::vector &dependencies = {}) sycl::event gemm_batch(sycl::queue &queue, - const sycl::span &transa, - const sycl::span &transb, + const sycl::span &transa, + const sycl::span &transb, const sycl::span &m, const sycl::span &n, const sycl::span &k, @@ -395,10 +395,10 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemm_batch(sycl::queue &queue, - const oneapi::mkl::transpose *transa, - const oneapi::mkl::transpose *transb, + const oneapi::math::transpose *transa, + const oneapi::math::transpose *transb, const std::int64_t *m, const std::int64_t *n, const std::int64_t *k, @@ -415,8 +415,8 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. const std::vector &dependencies = {}) sycl::event gemm_batch(sycl::queue &queue, - const sycl::span &transa, - const sycl::span &transb, + const sycl::span &transa, + const sycl::span &transb, const sycl::span &m, const sycl::span &n, const sycl::span &k, @@ -441,11 +441,11 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. The queue where the routine should be executed. transa - Array or span of ``group_count`` ``oneapi::mkl::transpose`` values. ``transa[i]`` specifies the form of op(``A``) used in + Array or span of ``group_count`` ``oneapi::math::transpose`` values. ``transa[i]`` specifies the form of op(``A``) used in the matrix multiplication in group ``i``. See :ref:`onemath_datatypes` for more details. transb - Array or span of ``group_count`` ``oneapi::mkl::transpose`` values. ``transb[i]`` specifies the form of op(``B``) used in + Array or span of ``group_count`` ``oneapi::math::transpose`` values. ``transb[i]`` specifies the form of op(``B``) used in the matrix multiplication in group ``i``. See :ref:`onemath_datatypes` for more details. m @@ -586,10 +586,10 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemm_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -609,10 +609,10 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemm_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, std::int64_t k, @@ -751,20 +751,20 @@ in ``a``, ``b`` and ``c`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/gemm_bias.rst b/source/elements/oneMath/source/domains/blas/gemm_bias.rst index 4007fe561..0ecb073a7 100644 --- a/source/elements/oneMath/source/domains/blas/gemm_bias.rst +++ b/source/elements/oneMath/source/domains/blas/gemm_bias.rst @@ -65,11 +65,11 @@ gemm_bias (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemm_bias(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, - oneapi::mkl::offset offset_type, + oneapi::math::transpose transa, + oneapi::math::transpose transb, + oneapi::math::offset offset_type, std::int64_t m, std::int64_t n, std::int64_t k, @@ -87,11 +87,11 @@ gemm_bias (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemm_bias(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, - oneapi::mkl::offset offset_type, + oneapi::math::transpose transa, + oneapi::math::transpose transb, + oneapi::math::offset offset_type, std::int64_t m, std::int64_t n, std::int64_t k, @@ -279,19 +279,19 @@ gemm_bias (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemm_bias_usm: @@ -303,11 +303,11 @@ gemm_bias (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemm_bias(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, - oneapi::mkl::offset offset_type, + oneapi::math::transpose transa, + oneapi::math::transpose transb, + oneapi::math::offset offset_type, std::int64_t m, std::int64_t n, std::int64_t k, @@ -326,11 +326,11 @@ gemm_bias (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemm_bias(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, - oneapi::mkl::offset offset_type, + oneapi::math::transpose transa, + oneapi::math::transpose transb, + oneapi::math::offset offset_type, std::int64_t m, std::int64_t n, std::int64_t k, @@ -529,20 +529,20 @@ gemm_bias (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/gemmt.rst b/source/elements/oneMath/source/domains/blas/gemmt.rst index cfa6aec27..e876ce7a0 100644 --- a/source/elements/oneMath/source/domains/blas/gemmt.rst +++ b/source/elements/oneMath/source/domains/blas/gemmt.rst @@ -54,11 +54,11 @@ gemmt (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemmt(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t n, std::int64_t k, T alpha, @@ -72,11 +72,11 @@ gemmt (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemmt(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t n, std::int64_t k, T alpha, @@ -228,19 +228,19 @@ gemmt (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemmt_usm: @@ -252,11 +252,11 @@ gemmt (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemmt(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -271,11 +271,11 @@ gemmt (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemmt(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -444,20 +444,20 @@ gemmt (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/gemv.rst b/source/elements/oneMath/source/domains/blas/gemv.rst index 354841163..8aae56c0c 100644 --- a/source/elements/oneMath/source/domains/blas/gemv.rst +++ b/source/elements/oneMath/source/domains/blas/gemv.rst @@ -50,9 +50,9 @@ gemv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -66,9 +66,9 @@ gemv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -148,19 +148,19 @@ gemv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemv_usm: @@ -172,9 +172,9 @@ gemv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -189,9 +189,9 @@ gemv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemv(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -287,20 +287,20 @@ gemv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/gemv_batch.rst b/source/elements/oneMath/source/domains/blas/gemv_batch.rst index ec0c0fae4..17b64eff9 100644 --- a/source/elements/oneMath/source/domains/blas/gemv_batch.rst +++ b/source/elements/oneMath/source/domains/blas/gemv_batch.rst @@ -66,9 +66,9 @@ parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gemv_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -86,9 +86,9 @@ parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gemv_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -174,19 +174,19 @@ parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gemv_batch_usm: @@ -247,9 +247,9 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemv_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans, + const oneapi::math::transpose *trans, const std::int64_t *m, const std::int64_t *n, const T *alpha, @@ -266,9 +266,9 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemv_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans, + const oneapi::math::transpose *trans, const std::int64_t *m, const std::int64_t *n, const T *alpha, @@ -292,7 +292,7 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th The queue where the routine should be executed. trans - Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in + Array of ``group_count`` ``oneapi::math::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in the matrix-vector product in group ``i``. See :ref:`onemath_datatypes` for more details. m @@ -375,9 +375,9 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gemv_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -396,9 +396,9 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gemv_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -492,20 +492,20 @@ total number of vectors in ``x`` and ``y`` and matrices in ``A`` are given by th This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/ger.rst b/source/elements/oneMath/source/domains/blas/ger.rst index c2f143739..f1c8d81c7 100644 --- a/source/elements/oneMath/source/domains/blas/ger.rst +++ b/source/elements/oneMath/source/domains/blas/ger.rst @@ -48,7 +48,7 @@ ger (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void ger(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -62,7 +62,7 @@ ger (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void ger(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -131,19 +131,19 @@ ger (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_ger_usm: @@ -155,7 +155,7 @@ ger (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event ger(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -170,7 +170,7 @@ ger (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event ger(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -251,20 +251,20 @@ ger (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/gerc.rst b/source/elements/oneMath/source/domains/blas/gerc.rst index 66cb03cf8..0946ade3f 100644 --- a/source/elements/oneMath/source/domains/blas/gerc.rst +++ b/source/elements/oneMath/source/domains/blas/gerc.rst @@ -49,7 +49,7 @@ gerc (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void gerc(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -63,7 +63,7 @@ gerc (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void gerc(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -133,19 +133,19 @@ gerc (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_gerc_usm: @@ -157,7 +157,7 @@ gerc (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event gerc(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -172,7 +172,7 @@ gerc (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event gerc(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -254,20 +254,20 @@ gerc (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/geru.rst b/source/elements/oneMath/source/domains/blas/geru.rst index 274c8870c..fec5fae70 100644 --- a/source/elements/oneMath/source/domains/blas/geru.rst +++ b/source/elements/oneMath/source/domains/blas/geru.rst @@ -48,7 +48,7 @@ geru (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void geru(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -62,7 +62,7 @@ geru (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void geru(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -131,19 +131,19 @@ geru (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_geru_usm: @@ -155,7 +155,7 @@ geru (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event geru(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -170,7 +170,7 @@ geru (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event geru(sycl::queue &queue, std::int64_t m, std::int64_t n, @@ -252,20 +252,20 @@ geru (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/hbmv.rst b/source/elements/oneMath/source/domains/blas/hbmv.rst index 17c16a605..4c44e3bb0 100644 --- a/source/elements/oneMath/source/domains/blas/hbmv.rst +++ b/source/elements/oneMath/source/domains/blas/hbmv.rst @@ -48,9 +48,9 @@ hbmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, T alpha, @@ -64,9 +64,9 @@ hbmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, T alpha, @@ -140,19 +140,19 @@ hbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hbmv_usm: @@ -164,9 +164,9 @@ hbmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -181,9 +181,9 @@ hbmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -271,20 +271,20 @@ hbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/hemm.rst b/source/elements/oneMath/source/domains/blas/hemm.rst index 280b59ca5..f16efb752 100644 --- a/source/elements/oneMath/source/domains/blas/hemm.rst +++ b/source/elements/oneMath/source/domains/blas/hemm.rst @@ -59,10 +59,10 @@ hemm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hemm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, T alpha, @@ -76,10 +76,10 @@ hemm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hemm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, T alpha, @@ -180,19 +180,19 @@ hemm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hemm_usm: @@ -204,10 +204,10 @@ hemm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hemm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -222,10 +222,10 @@ hemm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hemm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -340,20 +340,20 @@ hemm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/hemv.rst b/source/elements/oneMath/source/domains/blas/hemv.rst index c324466e2..264506b78 100644 --- a/source/elements/oneMath/source/domains/blas/hemv.rst +++ b/source/elements/oneMath/source/domains/blas/hemv.rst @@ -47,9 +47,9 @@ hemv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hemv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -62,9 +62,9 @@ hemv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hemv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -133,19 +133,19 @@ hemv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hemv_usm: @@ -157,9 +157,9 @@ hemv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hemv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -173,9 +173,9 @@ hemv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hemv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -257,20 +257,20 @@ hemv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/her.rst b/source/elements/oneMath/source/domains/blas/her.rst index d6010cfef..b7bd9a474 100644 --- a/source/elements/oneMath/source/domains/blas/her.rst +++ b/source/elements/oneMath/source/domains/blas/her.rst @@ -49,9 +49,9 @@ her (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void her(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, Treal alpha, sycl::buffer &x, @@ -61,9 +61,9 @@ her (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void her(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, Treal alpha, sycl::buffer &x, @@ -123,19 +123,19 @@ her (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_her_usm: @@ -147,9 +147,9 @@ her (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event her(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -160,9 +160,9 @@ her (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event her(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -234,20 +234,20 @@ her (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/her2.rst b/source/elements/oneMath/source/domains/blas/her2.rst index 4035acec4..566f6478e 100644 --- a/source/elements/oneMath/source/domains/blas/her2.rst +++ b/source/elements/oneMath/source/domains/blas/her2.rst @@ -46,9 +46,9 @@ her2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void her2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -60,9 +60,9 @@ her2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void her2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -132,19 +132,19 @@ her2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_her2_usm: @@ -156,9 +156,9 @@ her2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event her2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -171,9 +171,9 @@ her2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event her2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -256,20 +256,20 @@ her2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/her2k.rst b/source/elements/oneMath/source/domains/blas/her2k.rst index 8f9c8ce84..960edda01 100644 --- a/source/elements/oneMath/source/domains/blas/her2k.rst +++ b/source/elements/oneMath/source/domains/blas/her2k.rst @@ -61,10 +61,10 @@ her2k (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void her2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -78,10 +78,10 @@ her2k (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void her2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -223,19 +223,19 @@ her2k (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_her2k_usm: @@ -247,10 +247,10 @@ her2k (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event her2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -265,10 +265,10 @@ her2k (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event her2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -422,20 +422,20 @@ her2k (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/herk.rst b/source/elements/oneMath/source/domains/blas/herk.rst index bb4298f19..0e59a509a 100644 --- a/source/elements/oneMath/source/domains/blas/herk.rst +++ b/source/elements/oneMath/source/domains/blas/herk.rst @@ -51,10 +51,10 @@ herk (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void herk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, Treal alpha, @@ -66,10 +66,10 @@ herk (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void herk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, Treal alpha, @@ -174,19 +174,19 @@ herk (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_herk_usm: @@ -198,10 +198,10 @@ herk (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event herk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -214,10 +214,10 @@ herk (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event herk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -333,20 +333,20 @@ herk (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/hpmv.rst b/source/elements/oneMath/source/domains/blas/hpmv.rst index 52f28a5e5..cb2c4e5a1 100644 --- a/source/elements/oneMath/source/domains/blas/hpmv.rst +++ b/source/elements/oneMath/source/domains/blas/hpmv.rst @@ -47,9 +47,9 @@ hpmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -61,9 +61,9 @@ hpmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -130,19 +130,19 @@ hpmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hpmv_usm: @@ -154,9 +154,9 @@ hpmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -169,9 +169,9 @@ hpmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -252,20 +252,20 @@ hpmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/hpr.rst b/source/elements/oneMath/source/domains/blas/hpr.rst index 26b5189e4..c1891d626 100644 --- a/source/elements/oneMath/source/domains/blas/hpr.rst +++ b/source/elements/oneMath/source/domains/blas/hpr.rst @@ -49,9 +49,9 @@ hpr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hpr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, Treal alpha, sycl::buffer &x, @@ -60,9 +60,9 @@ hpr (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hpr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, Treal alpha, sycl::buffer &x, @@ -120,19 +120,19 @@ hpr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hpr_usm: @@ -144,9 +144,9 @@ hpr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hpr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -156,9 +156,9 @@ hpr (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hpr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -229,20 +229,20 @@ hpr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/hpr2.rst b/source/elements/oneMath/source/domains/blas/hpr2.rst index 55556daca..ce5bb506a 100644 --- a/source/elements/oneMath/source/domains/blas/hpr2.rst +++ b/source/elements/oneMath/source/domains/blas/hpr2.rst @@ -46,9 +46,9 @@ hpr2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void hpr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -59,9 +59,9 @@ hpr2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void hpr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -129,19 +129,19 @@ hpr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_hpr2_usm: @@ -153,9 +153,9 @@ hpr2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event hpr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -167,9 +167,9 @@ hpr2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event hpr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -251,20 +251,20 @@ hpr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/iamax.rst b/source/elements/oneMath/source/domains/blas/iamax.rst index 694a3c890..4cc5b4c6a 100644 --- a/source/elements/oneMath/source/domains/blas/iamax.rst +++ b/source/elements/oneMath/source/domains/blas/iamax.rst @@ -18,8 +18,8 @@ has the maximum absolute value of all elements in vector ``x`` (real variants), or such that (\|Re(``x[i]``)\| + \|Im(``x[i]``)\|) is maximal (complex variants). -The index is zero-based if ``base`` is set to ``oneapi::mkl::index_base::zero`` (default) -or one-based if it is set to ``oneapi::mkl::index_base::one``. +The index is zero-based if ``base`` is set to ``oneapi::math::index_base::zero`` (default) +or one-based if it is set to ``oneapi::math::index_base::one``. If either ``n`` or ``incx`` is not positive, the routine returns ``0``, regardless of the base of the index selected. @@ -50,23 +50,23 @@ iamax (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void iamax(sycl::queue &queue, std::int64_t n, sycl::buffer &x, std::int64_t incx, sycl::buffer &result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero) + oneapi::math::index_base base = oneapi::math::index_base::zero) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void iamax(sycl::queue &queue, std::int64_t n, sycl::buffer &x, std::int64_t incx, sycl::buffer &result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero) + oneapi::math::index_base base = oneapi::math::index_base::zero) } .. container:: section @@ -105,19 +105,19 @@ iamax (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_iamax_usm: @@ -129,24 +129,24 @@ iamax (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event iamax(sycl::queue &queue, std::int64_t n, const T *x, std::int64_t incx, std::int64_t *result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero, + oneapi::math::index_base base = oneapi::math::index_base::zero, const std::vector &dependencies = {}) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event iamax(sycl::queue &queue, std::int64_t n, const T *x, std::int64_t incx, std::int64_t *result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero, + oneapi::math::index_base base = oneapi::math::index_base::zero, const std::vector &dependencies = {}) } @@ -197,20 +197,20 @@ iamax (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/iamin.rst b/source/elements/oneMath/source/domains/blas/iamin.rst index 62a5130d6..031d5ebf9 100644 --- a/source/elements/oneMath/source/domains/blas/iamin.rst +++ b/source/elements/oneMath/source/domains/blas/iamin.rst @@ -18,8 +18,8 @@ the minimum absolute value of all elements in vector ``x`` (real variants), or such that (\|Re(``x[i]``)\| + \|Im(``x[i]``)\|) is minimal (complex variants). -The index is zero-based if ``base`` is set to ``oneapi::mkl::index_base::zero`` (default) -or one-based if it is set to ``oneapi::mkl::index_base::one``. +The index is zero-based if ``base`` is set to ``oneapi::math::index_base::zero`` (default) +or one-based if it is set to ``oneapi::math::index_base::one``. If either ``n`` or ``incx`` is not positive, the routine returns ``0``, regardless of the base of the index selected. @@ -51,23 +51,23 @@ iamin (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void iamin(sycl::queue &queue, std::int64_t n, sycl::buffer &x, std::int64_t incx, sycl::buffer &result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero) + oneapi::math::index_base base = oneapi::math::index_base::zero) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void iamin(sycl::queue &queue, std::int64_t n, sycl::buffer &x, std::int64_t incx, sycl::buffer &result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero) + oneapi::math::index_base base = oneapi::math::index_base::zero) } .. container:: section @@ -106,19 +106,19 @@ iamin (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_iamin_usm: @@ -130,24 +130,24 @@ iamin (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event iamin(sycl::queue &queue, std::int64_t n, const T *x, std::int64_t incx, std::int64_t *result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero, + oneapi::math::index_base base = oneapi::math::index_base::zero, const std::vector &dependencies = {}) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event iamin(sycl::queue &queue, std::int64_t n, const T *x, std::int64_t incx, std::int64_t *result, - oneapi::mkl::index_base base = oneapi::mkl::index_base::zero, + oneapi::math::index_base base = oneapi::math::index_base::zero, const std::vector &dependencies = {}) } @@ -198,20 +198,20 @@ iamin (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/imatcopy.rst b/source/elements/oneMath/source/domains/blas/imatcopy.rst index cd81148fa..dc5c14bef 100644 --- a/source/elements/oneMath/source/domains/blas/imatcopy.rst +++ b/source/elements/oneMath/source/domains/blas/imatcopy.rst @@ -53,9 +53,9 @@ imatcopy (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void imatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -65,9 +65,9 @@ imatcopy (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void imatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -149,19 +149,19 @@ imatcopy (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_imatcopy_usm: @@ -173,9 +173,9 @@ imatcopy (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event imatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -185,9 +185,9 @@ imatcopy (USM Version) const std::vector &dependencies = {}); .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event imatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -280,19 +280,19 @@ imatcopy (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst b/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst index 336dab8a3..7a74d616e 100644 --- a/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/imatcopy_batch.rst @@ -91,9 +91,9 @@ parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void imatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -105,9 +105,9 @@ parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void imatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -199,19 +199,19 @@ parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_imatcopy_batch_usm: @@ -274,9 +274,9 @@ matrices is given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { event imatcopy_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans_array, + const oneapi::math::transpose *trans_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -289,9 +289,9 @@ matrices is given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { event imatcopy_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans_array, + const oneapi::math::transpose *trans_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -381,9 +381,9 @@ matrices is given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event imatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -395,9 +395,9 @@ matrices is given by the ``batch_size`` parameter. const std::vector &dependencies = {}); .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event imatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -491,19 +491,19 @@ matrices is given by the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/nrm2.rst b/source/elements/oneMath/source/domains/blas/nrm2.rst index 35e42b87a..85e78c61c 100644 --- a/source/elements/oneMath/source/domains/blas/nrm2.rst +++ b/source/elements/oneMath/source/domains/blas/nrm2.rst @@ -52,7 +52,7 @@ nrm2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void nrm2(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -61,7 +61,7 @@ nrm2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void nrm2(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -101,19 +101,19 @@ nrm2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_nrm2_usm: @@ -125,7 +125,7 @@ nrm2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event nrm2(sycl::queue &queue, std::int64_t n, const T *x, @@ -135,7 +135,7 @@ nrm2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event nrm2(sycl::queue &queue, std::int64_t n, const T *x, @@ -187,20 +187,20 @@ nrm2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/omatadd.rst b/source/elements/oneMath/source/domains/blas/omatadd.rst index 1fab02327..ee07bfcb5 100644 --- a/source/elements/oneMath/source/domains/blas/omatadd.rst +++ b/source/elements/oneMath/source/domains/blas/omatadd.rst @@ -63,10 +63,10 @@ omatadd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void omatadd(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, T alpha, @@ -80,10 +80,10 @@ omatadd (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void omatadd(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, T alpha, @@ -219,19 +219,19 @@ omatadd (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_omatadd_usm: @@ -243,10 +243,10 @@ omatadd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatadd(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -261,10 +261,10 @@ omatadd (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatadd(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -411,19 +411,19 @@ omatadd (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/omatadd_batch.rst b/source/elements/oneMath/source/domains/blas/omatadd_batch.rst index cb2b8c335..63ba47159 100644 --- a/source/elements/oneMath/source/domains/blas/omatadd_batch.rst +++ b/source/elements/oneMath/source/domains/blas/omatadd_batch.rst @@ -106,10 +106,10 @@ memory, with the exception of the following in-place operations: .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void omatadd_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, T alpha, @@ -127,10 +127,10 @@ memory, with the exception of the following in-place operations: } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void omatadd_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, T alpha, @@ -282,19 +282,19 @@ memory, with the exception of the following in-place operations: implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_omatadd_batch_usm: @@ -373,10 +373,10 @@ in-place operations: .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatadd_batch(sycl::queue &queue, - const oneapi::mkl::transpose *transa_array, - const oneapi::mkl::transpose *transb_array, + const oneapi::math::transpose *transa_array, + const oneapi::math::transpose *transb_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -393,10 +393,10 @@ in-place operations: } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatadd_batch(sycl::queue &queue, - const oneapi::mkl::transpose *transa_array, - const oneapi::mkl::transpose *transb_array, + const oneapi::math::transpose *transa_array, + const oneapi::math::transpose *transb_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -564,10 +564,10 @@ in-place operations: .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatadd_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -586,10 +586,10 @@ in-place operations: } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatadd_batch(sycl::queue &queue, - oneapi::mkl::transpose transa, - oneapi::mkl::transpose transb, + oneapi::math::transpose transa, + oneapi::math::transpose transb, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -752,19 +752,19 @@ in-place operations: implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/omatcopy.rst b/source/elements/oneMath/source/domains/blas/omatcopy.rst index daef2e226..af5f9dc14 100644 --- a/source/elements/oneMath/source/domains/blas/omatcopy.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy.rst @@ -55,9 +55,9 @@ omatcopy (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void omatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -68,9 +68,9 @@ omatcopy (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void omatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -158,19 +158,19 @@ omatcopy (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_omatcopy_usm: @@ -182,9 +182,9 @@ omatcopy (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -196,9 +196,9 @@ omatcopy (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatcopy(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -297,19 +297,19 @@ omatcopy (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/omatcopy2.rst b/source/elements/oneMath/source/domains/blas/omatcopy2.rst index ebc853057..30c9858bc 100644 --- a/source/elements/oneMath/source/domains/blas/omatcopy2.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy2.rst @@ -63,9 +63,9 @@ omatcopy2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void omatcopy2(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -78,9 +78,9 @@ omatcopy2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void omatcopy2(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -184,19 +184,19 @@ omatcopy2 (Buffer Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_omatcopy2_usm: @@ -208,9 +208,9 @@ omatcopy2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatcopy2(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -224,9 +224,9 @@ omatcopy2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatcopy2(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -340,19 +340,19 @@ omatcopy2 (USM Version) implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst b/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst index 72370390b..1e9182eb8 100644 --- a/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst +++ b/source/elements/oneMath/source/domains/blas/omatcopy_batch.rst @@ -94,9 +94,9 @@ each buffer is given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void omatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -110,9 +110,9 @@ each buffer is given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void omatcopy_batch(sycl::queue &queue, - oneapi::mkl::transpose trans, + oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T alpha, @@ -214,19 +214,19 @@ each buffer is given by the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_omatcopy_batch_usm: @@ -292,9 +292,9 @@ the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event omatcopy_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans_array, + const oneapi::math::transpose *trans_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -308,9 +308,9 @@ the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event omatcopy_batch(sycl::queue &queue, - const oneapi::mkl::transpose *trans_array, + const oneapi::math::transpose *trans_array, const std::int64_t *m_array, const std::int64_t *n_array, const T *alpha_array, @@ -425,7 +425,7 @@ the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { event omatcopy_batch(queue &queue, transpose trans, std::int64_t m, @@ -442,7 +442,7 @@ the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { event omatcopy_batch(queue &queue, transpose trans, std::int64_t m, @@ -560,19 +560,19 @@ the ``batch_size`` parameter. implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/rot.rst b/source/elements/oneMath/source/domains/blas/rot.rst index 30fec7fa4..63af86748 100644 --- a/source/elements/oneMath/source/domains/blas/rot.rst +++ b/source/elements/oneMath/source/domains/blas/rot.rst @@ -51,9 +51,9 @@ If ``s`` is a complex type, the operation is defined as: * - ``sycl::half`` - ``sycl::half`` - ``sycl::half`` - * - ``oneapi::mkl::bfloat16`` - - ``oneapi::mkl::bfloat16`` - - ``oneapi::mkl::bfloat16`` + * - ``oneapi::math::bfloat16`` + - ``oneapi::math::bfloat16`` + - ``oneapi::math::bfloat16`` * - ``float`` - ``float`` - ``float`` @@ -82,7 +82,7 @@ rot (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void rot(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -94,7 +94,7 @@ rot (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void rot(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -153,19 +153,19 @@ rot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_rot_usm: @@ -177,7 +177,7 @@ rot (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event rot(sycl::queue &queue, std::int64_t n, T *x, @@ -190,7 +190,7 @@ rot (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event rot(sycl::queue &queue, std::int64_t n, T *x, @@ -262,20 +262,20 @@ rot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/rotg.rst b/source/elements/oneMath/source/domains/blas/rotg.rst index 8e32436af..7d47466c3 100644 --- a/source/elements/oneMath/source/domains/blas/rotg.rst +++ b/source/elements/oneMath/source/domains/blas/rotg.rst @@ -53,7 +53,7 @@ rotg (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void rotg(sycl::queue &queue, sycl::buffer &a, sycl::buffer &b, @@ -62,7 +62,7 @@ rotg (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void rotg(sycl::queue &queue, sycl::buffer &a, sycl::buffer &b, @@ -109,19 +109,19 @@ rotg (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_rotg_usm: @@ -133,7 +133,7 @@ rotg (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event rotg(sycl::queue &queue, T *a, T *b, @@ -143,7 +143,7 @@ rotg (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event rotg(sycl::queue &queue, T *a, T *b, @@ -201,20 +201,20 @@ rotg (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/rotm.rst b/source/elements/oneMath/source/domains/blas/rotm.rst index 1d28792d9..f3fc2ae2b 100644 --- a/source/elements/oneMath/source/domains/blas/rotm.rst +++ b/source/elements/oneMath/source/domains/blas/rotm.rst @@ -43,7 +43,7 @@ rotm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void rotm(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -54,7 +54,7 @@ rotm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void rotm(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -148,19 +148,19 @@ rotm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_rotm_usm: @@ -172,7 +172,7 @@ rotm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event rotm(sycl::queue &queue, std::int64_t n, T *x, @@ -184,7 +184,7 @@ rotm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event rotm(sycl::queue &queue, std::int64_t n, T *x, @@ -291,20 +291,20 @@ rotm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/rotmg.rst b/source/elements/oneMath/source/domains/blas/rotmg.rst index 620686cd6..511a787c3 100644 --- a/source/elements/oneMath/source/domains/blas/rotmg.rst +++ b/source/elements/oneMath/source/domains/blas/rotmg.rst @@ -42,7 +42,7 @@ rotmg (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void rotmg(sycl::queue &queue, sycl::buffer &d1, sycl::buffer &d2, @@ -52,7 +52,7 @@ rotmg (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void rotmg(sycl::queue &queue, sycl::buffer &d1, sycl::buffer &d2, @@ -144,19 +144,19 @@ rotmg (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_rotmg_usm: @@ -168,7 +168,7 @@ rotmg (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event rotmg(sycl::queue &queue, T *d1, T *d2, @@ -179,7 +179,7 @@ rotmg (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event rotmg(sycl::queue &queue, T *d1, T *d2, @@ -282,20 +282,20 @@ rotmg (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/sbmv.rst b/source/elements/oneMath/source/domains/blas/sbmv.rst index 925a656a5..4589c8952 100644 --- a/source/elements/oneMath/source/domains/blas/sbmv.rst +++ b/source/elements/oneMath/source/domains/blas/sbmv.rst @@ -48,9 +48,9 @@ sbmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void sbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, T alpha, @@ -64,9 +64,9 @@ sbmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void sbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, T alpha, @@ -140,19 +140,19 @@ sbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_sbmv_usm: @@ -164,9 +164,9 @@ sbmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event sbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -181,9 +181,9 @@ sbmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event sbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -270,20 +270,20 @@ sbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/scal.rst b/source/elements/oneMath/source/domains/blas/scal.rst index c05ab3060..c74ada279 100644 --- a/source/elements/oneMath/source/domains/blas/scal.rst +++ b/source/elements/oneMath/source/domains/blas/scal.rst @@ -58,7 +58,7 @@ scal (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void scal(sycl::queue &queue, std::int64_t n, Ts alpha, @@ -67,7 +67,7 @@ scal (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void scal(sycl::queue &queue, std::int64_t n, Ts alpha, @@ -109,19 +109,19 @@ scal (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_scal_usm: @@ -133,7 +133,7 @@ scal (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event scal(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -143,7 +143,7 @@ scal (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event scal(sycl::queue &queue, std::int64_t n, value_or_pointer alpha, @@ -192,20 +192,20 @@ scal (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/sdsdot.rst b/source/elements/oneMath/source/domains/blas/sdsdot.rst index 33d3e080e..140644124 100644 --- a/source/elements/oneMath/source/domains/blas/sdsdot.rst +++ b/source/elements/oneMath/source/domains/blas/sdsdot.rst @@ -29,7 +29,7 @@ sdsdot (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void sdsdot(sycl::queue &queue, std::int64_t n, float sb, @@ -41,7 +41,7 @@ sdsdot (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void sdsdot(sycl::queue &queue, std::int64_t n, float sb, @@ -95,19 +95,19 @@ sdsdot (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_sdsdot_usm: @@ -119,7 +119,7 @@ sdsdot (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event sdsdot(sycl::queue &queue, std::int64_t n, float sb, @@ -132,7 +132,7 @@ sdsdot (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event sdsdot(sycl::queue &queue, std::int64_t n, float sb, @@ -197,20 +197,20 @@ sdsdot (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/spmv.rst b/source/elements/oneMath/source/domains/blas/spmv.rst index 220a6393c..09242b658 100644 --- a/source/elements/oneMath/source/domains/blas/spmv.rst +++ b/source/elements/oneMath/source/domains/blas/spmv.rst @@ -47,9 +47,9 @@ spmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void spmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -61,9 +61,9 @@ spmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void spmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -127,19 +127,19 @@ spmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_spmv_usm: @@ -151,9 +151,9 @@ spmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event spmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -166,9 +166,9 @@ spmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event spmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -246,20 +246,20 @@ spmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/spr.rst b/source/elements/oneMath/source/domains/blas/spr.rst index 366ae00ed..e23d0f12e 100644 --- a/source/elements/oneMath/source/domains/blas/spr.rst +++ b/source/elements/oneMath/source/domains/blas/spr.rst @@ -46,9 +46,9 @@ spr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void spr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::std::int64_t n, T alpha, sycl::buffer &x, @@ -57,9 +57,9 @@ spr (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void spr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::std::int64_t n, T alpha, sycl::buffer &x, @@ -113,19 +113,19 @@ spr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_spr_usm: @@ -137,9 +137,9 @@ spr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event spr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -149,9 +149,9 @@ spr (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event spr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -217,20 +217,20 @@ spr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/spr2.rst b/source/elements/oneMath/source/domains/blas/spr2.rst index ae65ecb96..09244c2dd 100644 --- a/source/elements/oneMath/source/domains/blas/spr2.rst +++ b/source/elements/oneMath/source/domains/blas/spr2.rst @@ -46,9 +46,9 @@ spr2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void spr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -59,9 +59,9 @@ spr2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void spr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -124,19 +124,19 @@ spr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_spr2_usm: @@ -148,9 +148,9 @@ spr2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event spr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -162,9 +162,9 @@ spr2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event spr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -241,20 +241,20 @@ spr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/swap.rst b/source/elements/oneMath/source/domains/blas/swap.rst index 0007ad418..d8da26d1a 100644 --- a/source/elements/oneMath/source/domains/blas/swap.rst +++ b/source/elements/oneMath/source/domains/blas/swap.rst @@ -47,7 +47,7 @@ swap (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void swap(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -57,7 +57,7 @@ swap (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void swap(sycl::queue &queue, std::int64_t n, sycl::buffer &x, @@ -110,19 +110,19 @@ swap (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_swap_usm: @@ -134,7 +134,7 @@ swap (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event swap(sycl::queue &queue, std::int64_t n, T *x, @@ -145,7 +145,7 @@ swap (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event swap(sycl::queue &queue, std::int64_t n, T *x, @@ -209,20 +209,20 @@ swap (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-1-routines` diff --git a/source/elements/oneMath/source/domains/blas/symm.rst b/source/elements/oneMath/source/domains/blas/symm.rst index d9a6d72f4..929ada957 100644 --- a/source/elements/oneMath/source/domains/blas/symm.rst +++ b/source/elements/oneMath/source/domains/blas/symm.rst @@ -60,10 +60,10 @@ symm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void symm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, T alpha, @@ -77,10 +77,10 @@ symm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void symm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, T alpha, @@ -179,19 +179,19 @@ symm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_symm_usm: @@ -203,10 +203,10 @@ symm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event symm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -221,10 +221,10 @@ symm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event symm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -337,20 +337,20 @@ symm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/symv.rst b/source/elements/oneMath/source/domains/blas/symv.rst index d3d66a936..5d72b06d1 100644 --- a/source/elements/oneMath/source/domains/blas/symv.rst +++ b/source/elements/oneMath/source/domains/blas/symv.rst @@ -49,9 +49,9 @@ symv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void symv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -64,9 +64,9 @@ symv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void symv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &a, @@ -135,19 +135,19 @@ symv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_symv_usm: @@ -159,9 +159,9 @@ symv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event symv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -175,9 +175,9 @@ symv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event symv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *a, @@ -260,20 +260,20 @@ symv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/syr.rst b/source/elements/oneMath/source/domains/blas/syr.rst index 937bcf137..a6fa5a56e 100644 --- a/source/elements/oneMath/source/domains/blas/syr.rst +++ b/source/elements/oneMath/source/domains/blas/syr.rst @@ -49,9 +49,9 @@ syr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void syr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -61,9 +61,9 @@ syr (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void syr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -121,19 +121,19 @@ syr (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_syr_usm: @@ -145,9 +145,9 @@ syr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -158,9 +158,9 @@ syr (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syr(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -230,20 +230,20 @@ syr (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/syr2.rst b/source/elements/oneMath/source/domains/blas/syr2.rst index 8903ed0fc..3a248579f 100644 --- a/source/elements/oneMath/source/domains/blas/syr2.rst +++ b/source/elements/oneMath/source/domains/blas/syr2.rst @@ -49,9 +49,9 @@ syr2 (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void syr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -63,9 +63,9 @@ syr2 (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void syr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, T alpha, sycl::buffer &x, @@ -133,19 +133,19 @@ syr2 (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_syr2_usm: @@ -157,9 +157,9 @@ syr2 (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -172,9 +172,9 @@ syr2 (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syr2(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, + oneapi::math::uplo upper_lower, std::int64_t n, value_or_pointer alpha, const T *x, @@ -255,20 +255,20 @@ syr2 (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/syr2k.rst b/source/elements/oneMath/source/domains/blas/syr2k.rst index 9e5c66fc3..5f5a74fb9 100644 --- a/source/elements/oneMath/source/domains/blas/syr2k.rst +++ b/source/elements/oneMath/source/domains/blas/syr2k.rst @@ -62,10 +62,10 @@ syr2k (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void syr2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -79,10 +79,10 @@ syr2k (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void syr2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -223,19 +223,19 @@ syr2k (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_syr2k_usm: @@ -247,10 +247,10 @@ syr2k (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syr2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -265,10 +265,10 @@ syr2k (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syr2k(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -422,20 +422,20 @@ syr2k (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/syrk.rst b/source/elements/oneMath/source/domains/blas/syrk.rst index f4e813860..589882224 100644 --- a/source/elements/oneMath/source/domains/blas/syrk.rst +++ b/source/elements/oneMath/source/domains/blas/syrk.rst @@ -51,10 +51,10 @@ syrk (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void syrk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -66,10 +66,10 @@ syrk (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void syrk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -169,19 +169,19 @@ syrk (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_syrk_usm: @@ -193,10 +193,10 @@ syrk (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syrk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -209,10 +209,10 @@ syrk (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syrk(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, value_or_pointer alpha, @@ -322,20 +322,20 @@ syrk (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/syrk_batch.rst b/source/elements/oneMath/source/domains/blas/syrk_batch.rst index 4959c7e73..5438bfa1a 100644 --- a/source/elements/oneMath/source/domains/blas/syrk_batch.rst +++ b/source/elements/oneMath/source/domains/blas/syrk_batch.rst @@ -65,10 +65,10 @@ of matrices in ``a`` and ``c`` buffers is given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void syrk_batch(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -83,10 +83,10 @@ of matrices in ``a`` and ``c`` buffers is given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void syrk_batch(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, std::int64_t n, std::int64_t k, T alpha, @@ -181,19 +181,19 @@ of matrices in ``a`` and ``c`` buffers is given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_syrk_batch_usm: @@ -252,7 +252,7 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syrk_batch(sycl::queue &queue, const uplo *upper_lower, const transpose *trans, @@ -270,7 +270,7 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syrk_batch(sycl::queue &queue, const uplo *upper_lower, const transpose *trans, @@ -295,12 +295,12 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. The queue where the routine should be executed. upper_lower - Array of ``group_count`` ``oneapi::mkl::upper_lower`` + Array of ``group_count`` ``oneapi::math::upper_lower`` values. ``upper_lower[i]`` specifies whether data in C for every matrix in group ``i`` is in upper or lower triangle. trans - Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in + Array of ``group_count`` ``oneapi::math::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used in the rank-k update in group ``i``. See :ref:`onemath_datatypes` for more details. n @@ -383,7 +383,7 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event syrk_batch(sycl::queue &queue, uplo upper_lower, transpose trans, @@ -402,7 +402,7 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event syrk_batch(sycl::queue &queue, uplo upper_lower, transpose trans, @@ -510,20 +510,20 @@ in ``a`` and ``c`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/tbmv.rst b/source/elements/oneMath/source/domains/blas/tbmv.rst index cd9432525..abe86166d 100644 --- a/source/elements/oneMath/source/domains/blas/tbmv.rst +++ b/source/elements/oneMath/source/domains/blas/tbmv.rst @@ -50,11 +50,11 @@ tbmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void tbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -64,11 +64,11 @@ tbmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void tbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -130,19 +130,19 @@ tbmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_tbmv_usm: @@ -154,11 +154,11 @@ tbmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event tbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -169,11 +169,11 @@ tbmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event tbmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -248,20 +248,20 @@ tbmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/tbsv.rst b/source/elements/oneMath/source/domains/blas/tbsv.rst index c37a109e8..ca81c03fa 100644 --- a/source/elements/oneMath/source/domains/blas/tbsv.rst +++ b/source/elements/oneMath/source/domains/blas/tbsv.rst @@ -52,11 +52,11 @@ tbsv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void tbsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -66,11 +66,11 @@ tbsv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void tbsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -132,19 +132,19 @@ tbsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_tbsv_usm: @@ -156,11 +156,11 @@ tbsv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event tbsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -171,11 +171,11 @@ tbsv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event tbsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -250,20 +250,20 @@ tbsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/tpmv.rst b/source/elements/oneMath/source/domains/blas/tpmv.rst index 901483ae6..c10a11db2 100644 --- a/source/elements/oneMath/source/domains/blas/tpmv.rst +++ b/source/elements/oneMath/source/domains/blas/tpmv.rst @@ -50,11 +50,11 @@ tpmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void tpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, sycl::buffer &x, @@ -62,11 +62,11 @@ tpmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void tpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, sycl::buffer &x, @@ -118,19 +118,19 @@ tpmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_tpmv_usm: @@ -142,11 +142,11 @@ tpmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event tpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, T *x, @@ -155,11 +155,11 @@ tpmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event tpmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, T *x, @@ -225,20 +225,20 @@ tpmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/tpsv.rst b/source/elements/oneMath/source/domains/blas/tpsv.rst index 9a14c1590..80f9297f0 100644 --- a/source/elements/oneMath/source/domains/blas/tpsv.rst +++ b/source/elements/oneMath/source/domains/blas/tpsv.rst @@ -52,11 +52,11 @@ tpsv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void tpsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -65,11 +65,11 @@ tpsv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void tpsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, sycl::buffer &a, @@ -123,19 +123,19 @@ tpsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_tpsv_usm: @@ -147,11 +147,11 @@ tpsv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event tpsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -161,11 +161,11 @@ tpsv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event tpsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, std::int64_t k, const T *a, @@ -233,20 +233,20 @@ tpsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/trmm.rst b/source/elements/oneMath/source/domains/blas/trmm.rst index 72b144cc1..3770b36b0 100644 --- a/source/elements/oneMath/source/domains/blas/trmm.rst +++ b/source/elements/oneMath/source/domains/blas/trmm.rst @@ -80,12 +80,12 @@ trmm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -96,12 +96,12 @@ trmm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -187,19 +187,19 @@ trmm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Out-of-place API** -------------------- @@ -208,12 +208,12 @@ trmm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -228,12 +228,12 @@ trmm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -313,19 +313,19 @@ trmm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_trmm_usm: @@ -340,12 +340,12 @@ trmm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -357,12 +357,12 @@ trmm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -463,20 +463,20 @@ trmm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Out-of-place API** -------------------- @@ -485,12 +485,12 @@ trmm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -506,12 +506,12 @@ trmm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trmm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -596,18 +596,18 @@ trmm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/trmv.rst b/source/elements/oneMath/source/domains/blas/trmv.rst index ec13be0b3..eaed13802 100644 --- a/source/elements/oneMath/source/domains/blas/trmv.rst +++ b/source/elements/oneMath/source/domains/blas/trmv.rst @@ -50,11 +50,11 @@ trmv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, std::int64_t lda, @@ -63,11 +63,11 @@ trmv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, std::int64_t lda, @@ -124,19 +124,19 @@ trmv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_trmv_usm: @@ -148,11 +148,11 @@ trmv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, std::int64_t lda, @@ -162,11 +162,11 @@ trmv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trmv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, std::int64_t lda, @@ -236,20 +236,20 @@ trmv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/blas/trsm.rst b/source/elements/oneMath/source/domains/blas/trsm.rst index 4695cc9e1..4b889a9af 100644 --- a/source/elements/oneMath/source/domains/blas/trsm.rst +++ b/source/elements/oneMath/source/domains/blas/trsm.rst @@ -78,12 +78,12 @@ trsm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -94,12 +94,12 @@ trsm (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -184,19 +184,19 @@ trsm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Out-of-place API** -------------------- @@ -205,12 +205,12 @@ trsm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -225,12 +225,12 @@ trsm (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -310,19 +310,19 @@ trsm (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_trsm_usm: @@ -337,12 +337,12 @@ trsm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -354,12 +354,12 @@ trsm (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose transa, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose transa, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -458,20 +458,20 @@ trsm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Out-of-place API** -------------------- @@ -480,12 +480,12 @@ trsm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -501,12 +501,12 @@ trsm (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trsm(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -591,19 +591,19 @@ trsm (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-3-routines` diff --git a/source/elements/oneMath/source/domains/blas/trsm_batch.rst b/source/elements/oneMath/source/domains/blas/trsm_batch.rst index 4042873b4..941c606f9 100644 --- a/source/elements/oneMath/source/domains/blas/trsm_batch.rst +++ b/source/elements/oneMath/source/domains/blas/trsm_batch.rst @@ -42,7 +42,7 @@ The strided API operation is defined as: for i = 0 … batch_size – 1 A and B are matrices at offset i * stridea and i * strideb in a and b. - if (left_right == oneapi::mkl::side::left) then + if (left_right == oneapi::math::side::left) then compute X such that op(A) * X = alpha * B else compute X such that X * op(A) = alpha * B @@ -75,12 +75,12 @@ of matrices in ``a`` and ``b`` buffers are given by the ``batch_size`` parameter .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trsm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -94,12 +94,12 @@ of matrices in ``a`` and ``b`` buffers are given by the ``batch_size`` parameter } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trsm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, T alpha, @@ -190,19 +190,19 @@ of matrices in ``a`` and ``b`` buffers are given by the ``batch_size`` parameter This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` trsm_batch (USM Version) --------------------------- @@ -218,7 +218,7 @@ The group API operation is defined as: for i = 0 … group_count – 1 for j = 0 … group_size – 1 A and B are matrices in a[idx] and b[idx] - if (left_right == oneapi::mkl::side::left) then + if (left_right == oneapi::math::side::left) then compute X such that op(A) * X = alpha[i] * B else compute X such that X * op(A) = alpha[i] * B @@ -234,7 +234,7 @@ The strided API operation is defined as: for i = 0 … batch_size – 1 A and B are matrices at offset i * stridea and i * strideb in a and b. - if (left_right == oneapi::mkl::side::left) then + if (left_right == oneapi::math::side::left) then compute X such that op(A) * X = alpha * B else compute X such that X * op(A) = alpha * B @@ -273,12 +273,12 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trsm_batch(sycl::queue &queue, - const oneapi::mkl::side *left_right, - const oneapi::mkl::uplo *upper_lower, - const oneapi::mkl::transpose *trans, - const oneapi::mkl::diag *unit_diag, + const oneapi::math::side *left_right, + const oneapi::math::uplo *upper_lower, + const oneapi::math::transpose *trans, + const oneapi::math::diag *unit_diag, const std::int64_t *m, const std::int64_t *n, const T *alpha, @@ -292,12 +292,12 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trsm_batch(sycl::queue &queue, - const oneapi::mkl::side *left_right, - const oneapi::mkl::uplo *upper_lower, - const oneapi::mkl::transpose *trans, - const oneapi::mkl::diag *unit_diag, + const oneapi::math::side *left_right, + const oneapi::math::uplo *upper_lower, + const oneapi::math::transpose *trans, + const oneapi::math::diag *unit_diag, const std::int64_t *m, const std::int64_t *n, const T *alpha, @@ -318,20 +318,20 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. The queue where the routine should be executed. left_right - Array of ``group_count`` ``oneapi::mkl::side`` values. ``left_right[i]`` specifies whether ``A`` multiplies + Array of ``group_count`` ``oneapi::math::side`` values. ``left_right[i]`` specifies whether ``A`` multiplies ``X`` on the left (``side::left``) or on the right (``side::right``) for every ``trsm`` operation in group ``i``. See :ref:`onemath_datatypes` for more details. upper_lower - Array of ``group_count`` ``oneapi::mkl::uplo`` values. ``upper_lower[i]`` specifies whether ``A`` is upper or lower + Array of ``group_count`` ``oneapi::math::uplo`` values. ``upper_lower[i]`` specifies whether ``A`` is upper or lower triangular for every matrix in group ``i``. See :ref:`onemath_datatypes` for more details. trans - Array of ``group_count`` ``oneapi::mkl::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used + Array of ``group_count`` ``oneapi::math::transpose`` values. ``trans[i]`` specifies the form of op(``A``) used for every ``trsm`` operation in group ``i``. See :ref:`onemath_datatypes` for more details. unit_diag - Array of ``group_count`` ``oneapi::mkl::diag`` values. ``unit_diag[i]`` specifies whether ``A`` is assumed to + Array of ``group_count`` ``oneapi::math::diag`` values. ``unit_diag[i]`` specifies whether ``A`` is assumed to be unit triangular (all diagonal elements are 1) for every matrix in group ``i``. See :ref:`onemath_datatypes` for more details. m @@ -402,12 +402,12 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trsm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -422,12 +422,12 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trsm_batch(sycl::queue &queue, - oneapi::mkl::side left_right, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_diag, + oneapi::math::side left_right, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_diag, std::int64_t m, std::int64_t n, value_or_pointer alpha, @@ -525,20 +525,20 @@ in ``a`` and ``b`` are given by the ``batch_size`` parameter. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-like-extensions` diff --git a/source/elements/oneMath/source/domains/blas/trsv.rst b/source/elements/oneMath/source/domains/blas/trsv.rst index 99f1b40aa..c0485e131 100644 --- a/source/elements/oneMath/source/domains/blas/trsv.rst +++ b/source/elements/oneMath/source/domains/blas/trsv.rst @@ -51,11 +51,11 @@ trsv (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { void trsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, std::int64_t lda, @@ -64,11 +64,11 @@ trsv (Buffer Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { void trsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, sycl::buffer &a, std::int64_t lda, @@ -124,19 +124,19 @@ trsv (Buffer Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` .. _onemath_blas_trsv_usm: @@ -148,11 +148,11 @@ trsv (USM Version) .. code-block:: cpp - namespace oneapi::mkl::blas::column_major { + namespace oneapi::math::blas::column_major { sycl::event trsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, std::int64_t lda, @@ -162,11 +162,11 @@ trsv (USM Version) } .. code-block:: cpp - namespace oneapi::mkl::blas::row_major { + namespace oneapi::math::blas::row_major { sycl::event trsv(sycl::queue &queue, - oneapi::mkl::uplo upper_lower, - oneapi::mkl::transpose trans, - oneapi::mkl::diag unit_nonunit, + oneapi::math::uplo upper_lower, + oneapi::math::transpose trans, + oneapi::math::diag unit_nonunit, std::int64_t n, const T *a, std::int64_t lda, @@ -236,20 +236,20 @@ trsv (USM Version) This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` - :ref:`oneapi::mkl::unsupported_device` + :ref:`oneapi::math::unsupported_device` - :ref:`oneapi::mkl::host_bad_alloc` + :ref:`oneapi::math::host_bad_alloc` - :ref:`oneapi::mkl::device_bad_alloc` + :ref:`oneapi::math::device_bad_alloc` - :ref:`oneapi::mkl::unimplemented` + :ref:`oneapi::math::unimplemented` **Parent topic:** :ref:`blas-level-2-routines` diff --git a/source/elements/oneMath/source/domains/dft/compute_backward.rst b/source/elements/oneMath/source/domains/dft/compute_backward.rst index 8b067427f..d5e7ae678 100644 --- a/source/elements/oneMath/source/domains/dft/compute_backward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_backward.rst @@ -45,7 +45,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_backward(descriptor_type &desc, @@ -57,7 +57,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_backward(descriptor_type &desc, @@ -70,7 +70,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_backward(descriptor_type &desc, @@ -82,7 +82,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_backward(descriptor_type &desc, @@ -216,7 +216,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_backward(descriptor_type &desc, @@ -228,7 +228,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_backward(descriptor_type &desc, @@ -241,7 +241,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_backward(descriptor_type &desc, @@ -254,7 +254,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_backward(descriptor_type &desc, diff --git a/source/elements/oneMath/source/domains/dft/compute_forward.rst b/source/elements/oneMath/source/domains/dft/compute_forward.rst index a9d550f23..bdae5bdb3 100644 --- a/source/elements/oneMath/source/domains/dft/compute_forward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_forward.rst @@ -45,7 +45,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_forward(descriptor_type &desc, @@ -57,7 +57,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_forward(descriptor_type &desc, @@ -70,7 +70,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_forward(descriptor_type &desc, @@ -82,7 +82,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void compute_forward(descriptor_type &desc, @@ -217,7 +217,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_forward(descriptor_type &desc, @@ -229,7 +229,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_forward(descriptor_type &desc, @@ -242,7 +242,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_forward(descriptor_type &desc, @@ -255,7 +255,7 @@ progress of the enqueued DFT calculations. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template sycl::event compute_forward(descriptor_type &desc, diff --git a/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst index e3a21cdbc..897dd2e52 100644 --- a/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst @@ -69,7 +69,7 @@ USM allocations. .. code-block:: cpp - namespace dft = oneapi::mkl::dft; + namespace dft = oneapi::math::dft; dft::descriptor desc({n1, n2, n3}); std::vector strides({0, n2*n3, n3, 1}); std::int64_t dist = n1*n2*n3; @@ -122,7 +122,7 @@ USM allocations. .. code-block:: cpp - namespace dft = oneapi::mkl::dft; + namespace dft = oneapi::math::dft; dft::descriptor desc({n1, n2, n3}); std::vector strides({0, n2*n3, n3, 1}); std::int64_t dist = n1*n2*n3; @@ -171,7 +171,7 @@ forward and backward domains, with USM allocations. .. code-block:: cpp - namespace dft = oneapi::mkl::dft; + namespace dft = oneapi::math::dft; dft::descriptor desc({n1, n2, n3}); // Note: integer divisions here below std::vector fwd_strides({0, 2*n2*(n3/2 + 1), 2*(n3/2 + 1), 1}); diff --git a/source/elements/oneMath/source/domains/dft/descriptor.rst b/source/elements/oneMath/source/domains/dft/descriptor.rst index 52f56c843..1eff4318a 100644 --- a/source/elements/oneMath/source/domains/dft/descriptor.rst +++ b/source/elements/oneMath/source/domains/dft/descriptor.rst @@ -45,7 +45,7 @@ desired calculations to the ``sycl::queue`` object it was given when committing .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template class descriptor { @@ -180,7 +180,7 @@ without copying them. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor::descriptor(std::int64_t length); @@ -192,7 +192,7 @@ without copying them. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor::descriptor(std::vector lengths); @@ -203,7 +203,7 @@ without copying them. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor::descriptor(const descriptor& other); @@ -214,7 +214,7 @@ without copying them. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor::descriptor(descriptor&& other); @@ -271,7 +271,7 @@ The copy assignment operator results in a deep copy. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor& descriptor::operator=(const descriptor& other); @@ -282,7 +282,7 @@ The copy assignment operator results in a deep copy. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template descriptor& descriptor::operator=(descriptor&& other); @@ -338,7 +338,7 @@ to be used for a specific value of ``param``. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, std::int64_t value); @@ -519,7 +519,7 @@ to be used for a specific value of ``param``. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, domain* value_ptr) const; @@ -736,7 +736,7 @@ be used in compute calls. However, the aforementioned restrictions will still ap .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_workspace(sycl::buffer &workspaceBuf); @@ -746,7 +746,7 @@ be used in compute calls. However, the aforementioned restrictions will still ap .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_workspace(real_scalar_t* workspaceUSM); @@ -816,7 +816,7 @@ called again. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::commit(sycl::queue& queue); diff --git a/source/elements/oneMath/source/domains/lapack/gebrd.rst b/source/elements/oneMath/source/domains/lapack/gebrd.rst index c95ce4f54..90d723d4c 100644 --- a/source/elements/oneMath/source/domains/lapack/gebrd.rst +++ b/source/elements/oneMath/source/domains/lapack/gebrd.rst @@ -68,7 +68,7 @@ gebrd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void gebrd(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &d, cl::sycl::buffer &e, cl::sycl::buffer &tauq, cl::sycl::buffer &taup, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -144,17 +144,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -171,7 +171,7 @@ gebrd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event gebrd(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, RealT *d, RealT *e, T *tauq, T *taup, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -249,17 +249,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst index 39500a2f5..9c1cc18ac 100644 --- a/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gebrd_scratchpad_size.rst @@ -29,7 +29,7 @@ Calls to this routine must specify the template parameter explicitly. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t gebrd_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda) } @@ -56,11 +56,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/geqrf.rst b/source/elements/oneMath/source/domains/lapack/geqrf.rst index 9395d54bb..18f2772f9 100644 --- a/source/elements/oneMath/source/domains/lapack/geqrf.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf.rst @@ -37,7 +37,7 @@ geqrf (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void geqrf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -92,17 +92,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -117,7 +117,7 @@ geqrf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event geqrf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -176,17 +176,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst b/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst index 3b874c25c..7a140918d 100644 --- a/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_batch.rst @@ -43,7 +43,7 @@ The buffer version of ``geqrf_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void geqrf_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &tau, std::int64_t stride_tau, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -97,13 +97,13 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -137,7 +137,7 @@ The total number of problems to solve, ``batch_size``, is a sum of sizes of all .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event geqrf_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, T **a, std::int64_t *lda, T **tau, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -198,13 +198,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -225,7 +225,7 @@ The routine does not form the matrices :math:`Q_i` explicitly. Instead, :math:`Q .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { sycl::event geqrf_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, T *tau, std::int64_t stride_tau, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -288,13 +288,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst index 144fbf5b6..8cf5d3656 100644 --- a/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_batch_scratchpad_size.rst @@ -30,7 +30,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t geqrf_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -70,11 +70,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -87,7 +87,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t geqrf_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_tau, std::int64_t batch_size) }; @@ -129,11 +129,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst index 0be351a19..547312884 100644 --- a/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/geqrf_scratchpad_size.rst @@ -33,7 +33,7 @@ Calls to this routine must specify the template parameter explicitly. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t geqrf_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda) } @@ -60,11 +60,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/gerqf.rst b/source/elements/oneMath/source/domains/lapack/gerqf.rst index 5e5f3f755..f4712a84a 100644 --- a/source/elements/oneMath/source/domains/lapack/gerqf.rst +++ b/source/elements/oneMath/source/domains/lapack/gerqf.rst @@ -36,7 +36,7 @@ gerqf (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void gerqf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -87,17 +87,17 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -114,7 +114,7 @@ gerqf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event gerqf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -168,17 +168,17 @@ tau This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst index 4faab2b2c..276bf686b 100644 --- a/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gerqf_scratchpad_size.rst @@ -37,7 +37,7 @@ gerqf_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t gerqf_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda) } @@ -64,11 +64,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/gesvd.rst b/source/elements/oneMath/source/domains/lapack/gesvd.rst index 919528513..bbf7451c5 100644 --- a/source/elements/oneMath/source/domains/lapack/gesvd.rst +++ b/source/elements/oneMath/source/domains/lapack/gesvd.rst @@ -54,8 +54,8 @@ are returned in descending order. The first :math:`\min(m, n)` columns of .. code-block:: cpp - namespace oneapi::mkl::lapack { - void gesvd(cl::sycl::queue &queue, oneapi::mkl::job jobu, oneapi::mkl::job jobvt, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &s, cl::sycl::buffer &u, std::int64_t ldu, cl::sycl::buffer &vt, std::int64_t ldvt, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void gesvd(cl::sycl::queue &queue, oneapi::math::job jobu, oneapi::math::job jobvt, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &s, cl::sycl::buffer &u, std::int64_t ldu, cl::sycl::buffer &vt, std::int64_t ldvt, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -185,17 +185,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -239,8 +239,8 @@ are returned in descending order. The first :math:`\min(m, n)` columns of .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event gesvd(cl::sycl::queue &queue, oneapi::mkl::job jobu, oneapi::mkl::job jobvt, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, RealT *s, T *u, std::int64_t ldu, T *vt, std::int64_t ldvt, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event gesvd(cl::sycl::queue &queue, oneapi::math::job jobu, oneapi::math::job jobvt, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, RealT *s, T *u, std::int64_t ldu, T *vt, std::int64_t ldvt, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -373,17 +373,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst index e3b6500f5..1bb1f16cb 100644 --- a/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/gesvd_scratchpad_size.rst @@ -36,9 +36,9 @@ gesvd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t gesvd_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::job jobu, oneapi::mkl::job jobvt, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldu, std::int64_t ldvt) + std::int64_t gesvd_scratchpad_size(cl::sycl::queue &queue, oneapi::math::job jobu, oneapi::math::job jobvt, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldu, std::int64_t ldvt) } .. container:: section @@ -106,11 +106,11 @@ ldvt This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getrf.rst b/source/elements/oneMath/source/domains/lapack/getrf.rst index c99ff76cd..e4ae05ef2 100644 --- a/source/elements/oneMath/source/domains/lapack/getrf.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf.rst @@ -41,7 +41,7 @@ getrf (BUFFER Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void getrf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -87,17 +87,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -116,7 +116,7 @@ getrf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getrf(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, std::int64_t *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -165,17 +165,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getrf_batch.rst b/source/elements/oneMath/source/domains/lapack/getrf_batch.rst index 629f758b9..c6e687978 100644 --- a/source/elements/oneMath/source/domains/lapack/getrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_batch.rst @@ -39,7 +39,7 @@ The routine computes the LU factorizations of general :math:`m \times n` matrice .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void getrf_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -93,13 +93,13 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -130,7 +130,7 @@ The routine computes the batch of LU factorizations of general :math:`m \times n .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getrf_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t **ipiv, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -190,13 +190,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -218,7 +218,7 @@ The routine computes the LU factorizations of general :math:`m \times n` matrice .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getrf_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -281,13 +281,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst index c34b2f3da..e79fe6198 100644 --- a/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_batch_scratchpad_size.rst @@ -34,7 +34,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getrf_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -73,11 +73,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -92,7 +92,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getrf_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t batch_size) }; @@ -134,11 +134,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst index b4f1651c9..706669e67 100644 --- a/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrf_scratchpad_size.rst @@ -36,7 +36,7 @@ getrf_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getrf_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t lda) } @@ -63,11 +63,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getri.rst b/source/elements/oneMath/source/domains/lapack/getri.rst index 3d89b02c9..6aeaaaffa 100644 --- a/source/elements/oneMath/source/domains/lapack/getri.rst +++ b/source/elements/oneMath/source/domains/lapack/getri.rst @@ -38,7 +38,7 @@ getri (BUFFER Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void getri(cl::sycl::queue &queue, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -83,17 +83,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -110,7 +110,7 @@ getri (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri(cl::sycl::queue &queue, std::int64_t n, T *a, std::int64_t lda, std::int64_t *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -158,17 +158,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getri_batch.rst b/source/elements/oneMath/source/domains/lapack/getri_batch.rst index a7eafc90b..d2229a705 100644 --- a/source/elements/oneMath/source/domains/lapack/getri_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_batch.rst @@ -45,7 +45,7 @@ The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_ .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void getri_batch(cl::sycl::queue &queue, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -96,13 +96,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -133,7 +133,7 @@ Total number of problems to solve, ``batch_size``, is a sum of sizes of all of t .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri_batch(cl::sycl::queue &queue, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t **ipiv, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -190,13 +190,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -216,7 +216,7 @@ The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_ .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri_batch(cl::sycl::queue &queue, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -276,13 +276,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst index 2d367f83a..2bcd9b1a7 100644 --- a/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_batch_scratchpad_size.rst @@ -34,7 +34,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getri_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -70,11 +70,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -89,7 +89,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getri_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t batch_size) }; @@ -128,11 +128,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst index 6bad7d04c..a37584e11 100644 --- a/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_scratchpad_size.rst @@ -37,7 +37,7 @@ getri_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getri_scratchpad_size(cl::sycl::queue &queue, std::int64_t n, std::int64_t lda) } @@ -61,11 +61,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getrs.rst b/source/elements/oneMath/source/domains/lapack/getrs.rst index 6ffb4eaaa..f01fe782e 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs.rst @@ -32,11 +32,11 @@ equations: :header-rows: 1 * - \ :math:`AX = B`\ - - if ``trans``\ =\ ``oneapi::mkl::transpose::nontrans``\ + - if ``trans``\ =\ ``oneapi::math::transpose::nontrans``\ * - \ :math:`A^TX = B`\ - - if ``trans``\ =\ ``oneapi::mkl::transpose::trans``\ + - if ``trans``\ =\ ``oneapi::math::transpose::trans``\ * - \ :math:`A^HX = B`\ - - if ``trans``\ =\ ``oneapi::mkl::transpose::conjtrans``\ + - if ``trans``\ =\ ``oneapi::math::transpose::conjtrans``\ Before calling this routine, you must call :ref:`onemath_lapack_getrf` @@ -51,8 +51,8 @@ getrs (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void getrs(cl::sycl::queue &queue, oneapi::mkl::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void getrs(cl::sycl::queue &queue, oneapi::math::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -65,13 +65,13 @@ queue trans Indicates the form of the equations: - If ``trans=oneapi::mkl::transpose::nontrans``, then :math:`AX = B` is solved + If ``trans=oneapi::math::transpose::nontrans``, then :math:`AX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::trans``, then :math:`A^TX = B` is solved + If ``trans=oneapi::math::transpose::trans``, then :math:`A^TX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::conjtrans``, then :math:`A^HX = B` is + If ``trans=oneapi::math::transpose::conjtrans``, then :math:`A^HX = B` is solved for :math:`X`. n @@ -121,17 +121,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -151,8 +151,8 @@ getrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event getrs(cl::sycl::queue &queue, oneapi::mkl::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t *ipiv, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event getrs(cl::sycl::queue &queue, oneapi::math::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t *ipiv, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -165,13 +165,13 @@ queue trans Indicates the form of the equations: - If ``trans=oneapi::mkl::transpose::nontrans``, then :math:`AX = B` is solved + If ``trans=oneapi::math::transpose::nontrans``, then :math:`AX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::trans``, then :math:`A^TX = B` is solved + If ``trans=oneapi::math::transpose::trans``, then :math:`A^TX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::conjtrans``, then :math:`A^HX = B` is + If ``trans=oneapi::math::transpose::conjtrans``, then :math:`A^HX = B` is solved for :math:`X`. n @@ -224,17 +224,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst index d79a4b64c..a131bece7 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst @@ -49,7 +49,7 @@ The buffer version of ``getrs_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void getrs_batch(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -118,13 +118,13 @@ b This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -160,7 +160,7 @@ The USM version of ``getrs_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose *trans, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, std::int64_t **ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -232,13 +232,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by info() method of exception object: @@ -264,7 +264,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -342,13 +342,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst index f1bb7e572..f9467dd29 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst @@ -34,7 +34,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::transpose *trans, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } @@ -82,11 +82,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -101,7 +101,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; @@ -155,11 +155,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst index e3d608f25..164c37642 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_scratchpad_size.rst @@ -37,9 +37,9 @@ getrs_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t getrs_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) + std::int64_t getrs_scratchpad_size(cl::sycl::queue &queue, oneapi::math::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) } .. container:: section @@ -52,13 +52,13 @@ queue trans Indicates the form of the equations: - If ``trans=oneapi::mkl::transpose::nontrans``, then :math:`AX = B` is solved + If ``trans=oneapi::math::transpose::nontrans``, then :math:`AX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::trans``, then :math:`A^TX = B` is solved + If ``trans=oneapi::math::transpose::trans``, then :math:`A^TX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::conjtrans``, then :math:`A^HX = B` is + If ``trans=oneapi::math::transpose::conjtrans``, then :math:`A^HX = B` is solved for :math:`X`. n @@ -80,11 +80,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/heevd.rst b/source/elements/oneMath/source/domains/lapack/heevd.rst index 56ab4dd08..b8b6b1d0a 100644 --- a/source/elements/oneMath/source/domains/lapack/heevd.rst +++ b/source/elements/oneMath/source/domains/lapack/heevd.rst @@ -47,8 +47,8 @@ heevd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void heevd(cl::sycl::queue &queue, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, butter &a, std::int64_t lda, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void heevd(cl::sycl::queue &queue, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, butter &a, std::int64_t lda, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -111,28 +111,28 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: If ``info=-i``, the :math:`i`-th parameter had an illegal value. - If ``info=i``, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If ``info=i``, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If ``info=i``, and ``jobz = oneapi::mkl::job::vec``, then the algorithm failed + If ``info=i``, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. @@ -147,8 +147,8 @@ heevd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event heevd(cl::sycl::queue &queue, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, butter &a, std::int64_t lda, RealT *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event heevd(cl::sycl::queue &queue, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, butter &a, std::int64_t lda, RealT *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -212,28 +212,28 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: If ``info=-i``, the :math:`i`-th parameter had an illegal value. - If ``info=i``, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If ``info=i``, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If ``info=i``, and ``jobz = oneapi::mkl::job::vec``, then the algorithm failed + If ``info=i``, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. diff --git a/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst index b2ecdabd2..b7a09272e 100644 --- a/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/heevd_scratchpad_size.rst @@ -35,9 +35,9 @@ heevd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t heevd_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t heevd_scratchpad_size(cl::sycl::queue &queue, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -76,11 +76,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/hegvd.rst b/source/elements/oneMath/source/domains/lapack/hegvd.rst index 1d745d89d..e5fb9535d 100644 --- a/source/elements/oneMath/source/domains/lapack/hegvd.rst +++ b/source/elements/oneMath/source/domains/lapack/hegvd.rst @@ -44,8 +44,8 @@ hegvd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void hegvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void hegvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -142,17 +142,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -160,11 +160,11 @@ This routine shall throw the following exceptions if the associated condition is For :math:`\text{info} \le n`: - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero; - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)`` through :math:`\text{mod}(\text{info}, n+1)`. @@ -187,8 +187,8 @@ hegvd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event hegvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *b, std::int64_t ldb, RealT *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event hegvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *b, std::int64_t ldb, RealT *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -287,17 +287,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -305,11 +305,11 @@ This routine shall throw the following exceptions if the associated condition is For :math:`\text{info} \le n`: - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero; - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. diff --git a/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst index 270688ec7..b9230486b 100644 --- a/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hegvd_scratchpad_size.rst @@ -35,9 +35,9 @@ hegvd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t hegvd_scratchpad_size(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda, std::int64_t ldb) + std::int64_t hegvd_scratchpad_size(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda, std::int64_t ldb) } .. container:: section @@ -90,11 +90,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/hetrd.rst b/source/elements/oneMath/source/domains/lapack/hetrd.rst index 36394a796..d9beeef6e 100644 --- a/source/elements/oneMath/source/domains/lapack/hetrd.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrd.rst @@ -40,8 +40,8 @@ hetrd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void hetrd(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &d, cl::sycl::buffer &e, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void hetrd(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &d, cl::sycl::buffer &e, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -118,17 +118,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -145,8 +145,8 @@ hetrd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event hetrd(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, RealT *d, RealT *e, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event hetrd(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, RealT *d, RealT *e, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -225,17 +225,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst index 87b3472b3..c32398c0d 100644 --- a/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrd_scratchpad_size.rst @@ -35,9 +35,9 @@ hetrd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t hetrd_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t hetrd_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -69,11 +69,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/hetrf.rst b/source/elements/oneMath/source/domains/lapack/hetrf.rst index bc0d333a6..b49f0cad5 100644 --- a/source/elements/oneMath/source/domains/lapack/hetrf.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrf.rst @@ -46,8 +46,8 @@ hetrf (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void hetrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void hetrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -90,9 +90,9 @@ a ipiv Buffer, size at least :math:`\max(1, n)`. Contains details of the interchanges and the block structure of :math:`D`. If :math:`\text{ipiv}(i)=k>0`, then :math:`d_{ii}` is a :math:`1 \times 1` block, and the :math:`i`-th row and column of :math:`A` was interchanged with the :math:`k`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i`-1, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i`-1, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. .. container:: section @@ -100,17 +100,17 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -129,8 +129,8 @@ hetrf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event hetrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, int_64 *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event hetrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, int_64 *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -176,9 +176,9 @@ a ipiv Pointer to array of size at least :math:`\max(1, n)`. Contains details of the interchanges and the block structure of :math:`D`. If :math:`\text{ipiv}(i)=k>0`, then :math:`d_{ii}` is a :math:`1 \times 1` block, and the :math:`i`-th row and column of :math:`A` was interchanged with the :math:`k`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i-1`, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i-1`, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. .. container:: section @@ -186,17 +186,17 @@ ipiv This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst index cc06fd911..f0cf4baf4 100644 --- a/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/hetrf_scratchpad_size.rst @@ -34,9 +34,9 @@ hetrf_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t hetrf_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t hetrf_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -70,11 +70,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/orgbr.rst b/source/elements/oneMath/source/domains/lapack/orgbr.rst index 15198232f..a199d251d 100644 --- a/source/elements/oneMath/source/domains/lapack/orgbr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgbr.rst @@ -66,8 +66,8 @@ orgbr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void orgbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void orgbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -141,17 +141,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -168,8 +168,8 @@ orgbr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event orgbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event orgbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -246,17 +246,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst index 64411939a..a6156e5a4 100644 --- a/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgbr_scratchpad_size.rst @@ -34,9 +34,9 @@ orgbr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t orgbr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t &scratchpad_size) + std::int64_t orgbr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t &scratchpad_size) } .. container:: section @@ -85,11 +85,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/orgqr.rst b/source/elements/oneMath/source/domains/lapack/orgqr.rst index e8addfaa2..4f0d39269 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr.rst @@ -33,21 +33,21 @@ by ``p`` matrix :math:`A` with :math:`m \ge p`. To compute the whole matrix :: - oneapi::mkl::lapack::orgqr(queue, m, m, p, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::orgqr(queue, m, m, p, a, lda, tau, scratchpad, scratchpad_size) To compute the leading :math:`p` columns of :math:`Q` (which form an orthonormal basis in the space spanned by the columns of :math:`A`): :: - oneapi::mkl::lapack::orgqr(queue, m, p, p, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::orgqr(queue, m, p, p, a, lda, tau, scratchpad, scratchpad_size) To compute the matrix :math:`Q^{k}` of the QR factorization of leading :math:`k` columns of the matrix :math:`A`: :: - oneapi::mkl::lapack::orgqr(queue, m, m, k, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::orgqr(queue, m, m, k, a, lda, tau, scratchpad, scratchpad_size) To compute the leading :math:`k` columns of :math:`Q^{k}` (which form an orthonormal basis in the space spanned by leading :math:`k` columns of @@ -55,7 +55,7 @@ the matrix :math:`A`): :: - oneapi::mkl::lapack::orgqr(queue, m, k, k, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::orgqr(queue, m, k, k, a, lda, tau, scratchpad, scratchpad_size) orgqr (Buffer Version) ---------------------- @@ -66,7 +66,7 @@ orgqr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void orgqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -119,17 +119,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -146,7 +146,7 @@ orgqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -202,17 +202,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst index feb8c01ec..5266d4158 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst @@ -46,7 +46,7 @@ The buffer version of ``orgqr_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void orgqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &tau, std::int64_t stride_tau, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -103,13 +103,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -145,7 +145,7 @@ The USM version of ``orgqr_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, T **a, std::int64_t *lda, T **tau, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -209,13 +209,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -243,7 +243,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, std::int64_t stride_a, T *tau, std::int64_t stride_tau, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -309,13 +309,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst index 13af3165a..0a122e459 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_batch_scratchpad_size.rst @@ -32,7 +32,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t orgqr_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -74,11 +74,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -92,7 +92,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t orgqr_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_tau, std::int64_t batch_size) }; @@ -137,11 +137,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst index b76b84f08..20c61bdc1 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_scratchpad_size.rst @@ -34,7 +34,7 @@ orgqr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t orgqr_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda) } @@ -65,11 +65,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/orgtr.rst b/source/elements/oneMath/source/domains/lapack/orgtr.rst index 5848e8a48..b1df5c5dc 100644 --- a/source/elements/oneMath/source/domains/lapack/orgtr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgtr.rst @@ -38,8 +38,8 @@ orgtr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void orgtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void orgtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -87,17 +87,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -114,8 +114,8 @@ orgtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event orgtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event orgtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -168,17 +168,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst index b9d355173..8b6049347 100644 --- a/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/orgtr_scratchpad_size.rst @@ -34,9 +34,9 @@ orgtr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t orgtr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t orgtr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -62,11 +62,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ormqr.rst b/source/elements/oneMath/source/domains/lapack/ormqr.rst index af9731f1b..cf4399f06 100644 --- a/source/elements/oneMath/source/domains/lapack/ormqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormqr.rst @@ -42,8 +42,8 @@ ormqr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void ormqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void ormqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -54,17 +54,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{T}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::trans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^{T}`. m @@ -77,9 +77,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The buffer ``a`` as returned by :ref:`onemath_lapack_geqrf`. @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -147,8 +147,8 @@ ormqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -159,17 +159,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{T}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::trans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^{T}`. m @@ -182,9 +182,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The pointer to ``a`` as returned by :ref:`onemath_lapack_geqrf`. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst index 800dff35b..b9273e7d9 100644 --- a/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormqr_scratchpad_size.rst @@ -34,9 +34,9 @@ ormqr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t ormqr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc, std::int64_t &scratchpad_size) + std::int64_t ormqr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc, std::int64_t &scratchpad_size) } .. container:: section @@ -47,17 +47,17 @@ queue Device queue where calculations by :ref:`onemath_lapack_ormqr` function will be performed. side - If ``side=oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is + If ``side=oneapi::math::side::left``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the left. - If ``side=oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{T}` is + If ``side=oneapi::math::side::right``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the right. trans - If ``trans=oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans=oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans=oneapi::mkl::transpose::trans``, the routine multiplies + If ``trans=oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^{T}`. m @@ -82,11 +82,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ormrq.rst b/source/elements/oneMath/source/domains/lapack/ormrq.rst index 3b1175abf..fb7fddab0 100644 --- a/source/elements/oneMath/source/domains/lapack/ormrq.rst +++ b/source/elements/oneMath/source/domains/lapack/ormrq.rst @@ -42,8 +42,8 @@ ormrq (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void ormrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void ormrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -54,17 +54,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{T}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::trans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^{T}`. m @@ -77,9 +77,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The buffer ``a`` as returned by :ref:`onemath_lapack_gerqf`. @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -147,8 +147,8 @@ ormrq (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -159,17 +159,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{T}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{T}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{T}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::trans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^{T}`. m @@ -182,9 +182,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The pointer to ``a`` as returned by :ref:`onemath_lapack_gerqf`. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst index 8bfc8d171..dabe6020f 100644 --- a/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormrq_scratchpad_size.rst @@ -34,9 +34,9 @@ ormrq_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t ormrq_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc); + std::int64_t ormrq_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc); } .. container:: section @@ -47,14 +47,14 @@ queue Device queue where calculations by the ormrq function will be performed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the left. + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the right. + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the right. trans - If ``trans=oneapi::mkl::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. + If ``trans=oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans=oneapi::mkl::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^T`. + If ``trans=oneapi::math::transpose::trans``, the routine multiplies :math:`C` by :math:`Q^T`. m The number of rows in the matrix :math:`C` (:math:`0 \le m`). @@ -77,11 +77,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ormtr.rst b/source/elements/oneMath/source/domains/lapack/ormtr.rst index 7cc62a27a..0f734e484 100644 --- a/source/elements/oneMath/source/domains/lapack/ormtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormtr.rst @@ -41,8 +41,8 @@ ormtr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void ormtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void ormtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -131,17 +131,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -158,8 +158,8 @@ ormtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -250,17 +250,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst index 2812979b1..5cb504933 100644 --- a/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ormtr_scratchpad_size.rst @@ -35,9 +35,9 @@ ormtr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t ormtr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldc) + std::int64_t ormtr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldc) } .. container:: section @@ -100,11 +100,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/potrf.rst b/source/elements/oneMath/source/domains/lapack/potrf.rst index d767e14e6..e5c1aec36 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf.rst @@ -33,9 +33,9 @@ matrix :math:`A`: :header-rows: 1 * - :math:`A` = :math:`U^{T}U` for real data, :math:`A = U^{H}U` for complex data - - if upper_lower=\ ``oneapi::mkl::uplo::upper`` + - if upper_lower=\ ``oneapi::math::uplo::upper`` * - :math:`A` = :math:`LL^{T}` for real data, :math:`A = LL^{H}` for complex data - - if upper_lower=\ ``oneapi::mkl::uplo::lower`` + - if upper_lower=\ ``oneapi::math::uplo::lower`` where :math:`L` is a lower triangular matrix and :math:`U` is upper triangular. @@ -49,8 +49,8 @@ potrf (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void potrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void potrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -64,11 +64,11 @@ upper_lower Indicates whether the upper or lower triangular part of :math:`A` is stored and how :math:`A` is factored: - If upper_lower=\ ``oneapi::mkl::uplo::upper``, the array ``a`` stores the + If upper_lower=\ ``oneapi::math::uplo::upper``, the array ``a`` stores the upper triangular part of the matrix :math:`A`, and the strictly lower triangular part of the matrix is not referenced. - If upper_lower=\ ``oneapi::mkl::uplo::lower``, the array ``a`` stores the + If upper_lower=\ ``oneapi::math::uplo::lower``, the array ``a`` stores the lower triangular part of the matrix :math:`A`, and the strictly upper triangular part of the matrix is not referenced. @@ -105,17 +105,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -137,8 +137,8 @@ potrf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -152,11 +152,11 @@ upper_lower Indicates whether the upper or lower triangular part of :math:`A` is stored and how :math:`A` is factored: - If upper_lower=\ ``oneapi::mkl::uplo::upper``, the array ``a`` stores the + If upper_lower=\ ``oneapi::math::uplo::upper``, the array ``a`` stores the upper triangular part of the matrix :math:`A`, and the strictly lower triangular part of the matrix is not referenced. - If upper_lower=\ ``oneapi::mkl::uplo::lower``, the array ``a`` stores the + If upper_lower=\ ``oneapi::math::uplo::lower``, the array ``a`` stores the lower triangular part of the matrix :math:`A`, and the strictly upper triangular part of the matrix is not referenced. @@ -196,17 +196,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst index 4c85e636d..104286262 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst @@ -48,7 +48,7 @@ The buffer version of ``potrf_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void potrf_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -98,13 +98,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -140,7 +140,7 @@ The USM version of ``potrf_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event potrf_batch(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -200,13 +200,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -231,7 +231,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event potrf_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -290,13 +290,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst index 78cfdd674..503985d18 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst @@ -34,7 +34,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -78,11 +78,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -97,7 +97,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size) }; @@ -137,11 +137,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst index 51c13ff0a..02ffa9637 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_scratchpad_size.rst @@ -36,9 +36,9 @@ potrf_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t potrf_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t potrf_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -52,11 +52,11 @@ upper_lower Indicates whether the upper or lower triangular part of :math:`A` is stored and how :math:`A` is factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the array ``a`` stores the + If ``upper_lower = oneapi::math::uplo::upper``, the array ``a`` stores the upper triangular part of the matrix :math:`A`, and the strictly lower triangular part of the matrix is not referenced. - If ``upper_lower = oneapi::mkl::uplo::lower``, the array ``a`` stores the + If ``upper_lower = oneapi::math::uplo::lower``, the array ``a`` stores the lower triangular part of the matrix :math:`A`, and the strictly upper triangular part of the matrix is not referenced. @@ -72,11 +72,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/potri.rst b/source/elements/oneMath/source/domains/lapack/potri.rst index 0ab50cc13..d7b3db3f7 100644 --- a/source/elements/oneMath/source/domains/lapack/potri.rst +++ b/source/elements/oneMath/source/domains/lapack/potri.rst @@ -39,8 +39,8 @@ potri (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void potri(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void potri(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -53,9 +53,9 @@ queue upper_lower Indicates how the input matrix :math:`A` has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle of :math:`A` is stored. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle of :math:`A` is stored. n Specifies the order of the matrix :math:`A` (:math:`0 \le n`). @@ -86,17 +86,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -116,8 +116,8 @@ potri (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potri(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potri(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -130,9 +130,9 @@ queue upper_lower Indicates how the input matrix :math:`A` has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle of :math:`A` is stored. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle of :math:`A` is stored. n Specifies the order of the matrix :math:`A` (:math:`0 \le n`). @@ -166,17 +166,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst index b9417de56..0d790a5fb 100644 --- a/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potri_scratchpad_size.rst @@ -36,9 +36,9 @@ potri_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t potri_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t potri_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -51,9 +51,9 @@ queue upper_lower Indicates how the input matrix :math:`A` has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle of :math:`A` is stored. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle of :math:`A` is stored. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle of :math:`A` is stored. n Specifies the order of the matrix :math:`A` (:math:`0 \le n`). @@ -67,11 +67,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/potrs.rst b/source/elements/oneMath/source/domains/lapack/potrs.rst index 539597ca6..3d14a78fe 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs.rst @@ -34,9 +34,9 @@ factorization of :math:`A`: :header-rows: 1 * - :math:`A = U^TU` for real data, :math:`A = U^HU` for complex data - - if ``upper_lower=oneapi::mkl::uplo::upper`` + - if ``upper_lower=oneapi::math::uplo::upper`` * - :math:`A = LL^T` for real data, :math:`A = LL^H` for complex data - - if ``upper_lower=oneapi::mkl::uplo::lower`` + - if ``upper_lower=oneapi::math::uplo::lower`` where :math:`L` is a lower triangular matrix and :math:`U` is upper triangular. The system is solved with multiple right-hand sides @@ -54,8 +54,8 @@ potrs (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void potrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void potrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -68,9 +68,9 @@ queue upper_lower Indicates how the input matrix has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A` = :math:`U^{T}`U` for real data, :math:`A` = :math:`U^{H}U` for complex data. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A` = :math:`U^{T}`U` for real data, :math:`A` = :math:`U^{H}U` for complex data. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A` = :math:`LL^{T}` for real data, :math:`A` = :math:`LL^{H}` for complex data. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A` = :math:`LL^{T}` for real data, :math:`A` = :math:`LL^{H}` for complex data. n The order of matrix :math:`A` (:math:`0 \le n`).\ @@ -110,17 +110,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -139,8 +139,8 @@ potrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -153,9 +153,9 @@ queue upper_lower Indicates how the input matrix has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A` = :math:`U^{T}U` for real data, :math:`A` = :math:`U^{H}U` for complex data. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A` = :math:`U^{T}U` for real data, :math:`A` = :math:`U^{H}U` for complex data. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A` = :math:`LL^{T}` for real data, :math:`A` = :math:`LL^{H}` for complex data. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A` = :math:`LL^{T}` for real data, :math:`A` = :math:`LL^{H}` for complex data. n The order of matrix :math:`A` (:math:`0 \le n`).\ @@ -198,17 +198,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst index bd4959456..589dcbd0c 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst @@ -50,7 +50,7 @@ The buffer version of ``potrs_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void potrs_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -112,13 +112,13 @@ b This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -149,7 +149,7 @@ The USM version of ``potrs_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -222,13 +222,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -255,7 +255,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -326,13 +326,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst index 2e4c51801..8b4b73418 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst @@ -34,7 +34,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } @@ -85,11 +85,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -104,7 +104,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; @@ -153,11 +153,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst index 5128926ab..eafb7d4ff 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_scratchpad_size.rst @@ -36,9 +36,9 @@ potrs_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t potrs_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) + std::int64_t potrs_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) } .. container:: section @@ -51,9 +51,9 @@ queue upper_lower Indicates how the input matrix has been factored: - If ``upper_lower = oneapi::mkl::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A = U^{T}U` for real data, :math:`A = U^{H}U` for complex data. + If ``upper_lower = oneapi::math::uplo::upper``, the upper triangle :math:`U` of :math:`A` is stored, where :math:`A = U^{T}U` for real data, :math:`A = U^{H}U` for complex data. - If ``upper_lower = oneapi::mkl::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A = LL^{T}` for real data, :math:`A = LL^{H}` for complex data. + If ``upper_lower = oneapi::math::uplo::lower``, the lower triangle :math:`L` of :math:`A` is stored, where :math:`A = LL^{T}` for real data, :math:`A = LL^{H}` for complex data. n The order of matrix :math:`A` (:math:`0 \le n`). @@ -73,11 +73,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/syevd.rst b/source/elements/oneMath/source/domains/lapack/syevd.rst index fb1378815..d017bdb2e 100644 --- a/source/elements/oneMath/source/domains/lapack/syevd.rst +++ b/source/elements/oneMath/source/domains/lapack/syevd.rst @@ -47,8 +47,8 @@ syevd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void syevd(cl::sycl::queue &queue, jobz jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void syevd(cl::sycl::queue &queue, jobz jobz, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -111,28 +111,28 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: If :math:`\text{info}=-i`, the :math:`i`-th parameter had an illegal value. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm failed + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. @@ -147,8 +147,8 @@ syevd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event syevd(cl::sycl::queue &queue, jobz jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event syevd(cl::sycl::queue &queue, jobz jobz, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -214,28 +214,28 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: If :math:`\text{info}=-i`, the :math:`i`-th parameter had an illegal value. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm failed + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. diff --git a/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst index 39a47569c..f41a86865 100644 --- a/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/syevd_scratchpad_size.rst @@ -34,9 +34,9 @@ syevd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t syevd_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t syevd_scratchpad_size(cl::sycl::queue &queue, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -76,11 +76,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/sygvd.rst b/source/elements/oneMath/source/domains/lapack/sygvd.rst index c1b84399d..1894242ed 100644 --- a/source/elements/oneMath/source/domains/lapack/sygvd.rst +++ b/source/elements/oneMath/source/domains/lapack/sygvd.rst @@ -44,8 +44,8 @@ sygvd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void sygvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void sygvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &w, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -141,17 +141,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -159,12 +159,12 @@ This routine shall throw the following exceptions if the associated condition is For :math:`\text{info} \le n`: - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. @@ -187,8 +187,8 @@ sygvd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event sygvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event sygvd(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *w, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -287,17 +287,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -305,12 +305,12 @@ This routine shall throw the following exceptions if the associated condition is For :math:`\text{info} \le n`: - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::novec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::novec``, then the algorithm failed to converge; :math:`i` indicates the number of off-diagonal elements of an intermediate tridiagonal form which did not converge to zero. - If :math:`\text{info}=i`, and ``jobz = oneapi::mkl::job::vec``, then the algorithm + If :math:`\text{info}=i`, and ``jobz = oneapi::math::job::vec``, then the algorithm failed to compute an eigenvalue while working on the submatrix lying in rows and columns :math:`\text{info}/(n+1)` through :math:`\text{mod}(\text{info},n+1)`. diff --git a/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst index 05b5f5682..806c0a18c 100644 --- a/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sygvd_scratchpad_size.rst @@ -34,9 +34,9 @@ sygvd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t sygvd_scratchpad_size(cl::sycl::queue &queue, std::int64_t itype, oneapi::mkl::job jobz, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda, std::int64_t ldb) + std::int64_t sygvd_scratchpad_size(cl::sycl::queue &queue, std::int64_t itype, oneapi::math::job jobz, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda, std::int64_t ldb) } .. container:: section @@ -87,11 +87,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/sytrd.rst b/source/elements/oneMath/source/domains/lapack/sytrd.rst index 0d1edb2e0..8719dd5f8 100644 --- a/source/elements/oneMath/source/domains/lapack/sytrd.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrd.rst @@ -37,8 +37,8 @@ sytrd (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void sytrd(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &d, cl::sycl::buffer &e, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void sytrd(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &d, cl::sycl::buffer &e, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -116,17 +116,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -143,8 +143,8 @@ sytrd (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event sytrd(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *d, T *e, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event sytrd(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *d, T *e, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -224,17 +224,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst index 5c5d781bf..a0e6e8729 100644 --- a/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrd_scratchpad_size.rst @@ -34,9 +34,9 @@ sytrd_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t sytrd_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t sytrd_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -67,11 +67,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/sytrf.rst b/source/elements/oneMath/source/domains/lapack/sytrf.rst index c80b1c2b3..4b79e10ec 100644 --- a/source/elements/oneMath/source/domains/lapack/sytrf.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrf.rst @@ -48,8 +48,8 @@ sytrf (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void sytrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void sytrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &ipiv, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -89,9 +89,9 @@ a ipiv Buffer, size at least :math:`\max(1, n)`. Contains details of the interchanges and the block structure of :math:`D`. If :math:`\text{ipiv}(i)=k>0`, then :math:`d_{ii}` is a :math:`1 \times 1` block, and the :math:`i`-th row and column of :math:`A` was interchanged with the :math:`k`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i`-1, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i`-1, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. scratchpad Buffer holding scratchpad memory to be used by routine for storing intermediate results. @@ -102,17 +102,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -131,8 +131,8 @@ sytrf (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event sytrf(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, int_64 *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event sytrf(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, int_64 *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -175,9 +175,9 @@ a ipiv Pointer to array of size at least :math:`\max(1, n)`. Contains details of the interchanges and the block structure of :math:`D`. If :math:`\text{ipiv}(i)=k>0`, then :math:`d_{ii}` is a :math:`1 \times 1` block, and the :math:`i`-th row and column of :math:`A` was interchanged with the :math:`k`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i-1`, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::upper`` and :math:`\text{ipiv}(i)=\text{ipiv}(i-1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i-1`, and (:math:`i-1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. - If ``upper_lower=oneapi::mkl::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. + If ``upper_lower=oneapi::math::uplo::lower`` and :math:`\text{ipiv}(i)=\text{ipiv}(i+1)=-m<0`, then :math:`D` has a :math:`2 \times 2` block in rows/columns :math:`i` and :math:`i+1`, and (:math:`i+1`)-th row and column of :math:`A` was interchanged with the :math:`m`-th row and column. scratchpad Pointer to scratchpad memory to be used by routine for storing intermediate results. @@ -188,17 +188,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst index 06a224ff8..a79439b82 100644 --- a/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/sytrf_scratchpad_size.rst @@ -37,9 +37,9 @@ sytrf_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t sytrf_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t sytrf_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -73,11 +73,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/trtrs.rst b/source/elements/oneMath/source/domains/lapack/trtrs.rst index cb0e89ead..af14317ca 100644 --- a/source/elements/oneMath/source/domains/lapack/trtrs.rst +++ b/source/elements/oneMath/source/domains/lapack/trtrs.rst @@ -51,8 +51,8 @@ trtrs (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void trtrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose transa, oneapi::mkl::diag unit_diag, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void trtrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, oneapi::math::transpose transa, oneapi::math::diag unit_diag, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &b, std::int64_t ldb, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -119,17 +119,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -146,8 +146,8 @@ trtrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event trtrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose transa, oneapi::mkl::diag unit_diag, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event trtrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, oneapi::math::transpose transa, oneapi::math::diag unit_diag, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -217,17 +217,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst index 7ff6d333c..321689010 100644 --- a/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/trtrs_scratchpad_size.rst @@ -36,9 +36,9 @@ trtrs_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t trtrs_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, oneapi::mkl::diag diag, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) + std::int64_t trtrs_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, oneapi::math::diag diag, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t ldb) } .. container:: section @@ -58,17 +58,17 @@ upper_lower trans Indicates the form of the equations: - If ``trans=oneapi::mkl::transpose::nontrans``, then :math:`AX = B` is solved + If ``trans=oneapi::math::transpose::nontrans``, then :math:`AX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::trans``, then :math:`A^TX = B` is solved + If ``trans=oneapi::math::transpose::trans``, then :math:`A^TX = B` is solved for :math:`X`. - If ``trans=oneapi::mkl::transpose::conjtrans``, then :math:`A^HX = B` is + If ``trans=oneapi::math::transpose::conjtrans``, then :math:`A^HX = B` is solved for :math:`X`. diag - If diag = ``oneapi::mkl::diag::nonunit``, then :math:`A` is not a unit triangular matrix. + If diag = ``oneapi::math::diag::nonunit``, then :math:`A` is not a unit triangular matrix. If unit_diag = ``diag::unit``, then :math:`A` is unit triangular: diagonal elements of :math:`A` are assumed to be 1 and not referenced in the array ``a``. @@ -90,11 +90,11 @@ ldb This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ungbr.rst b/source/elements/oneMath/source/domains/lapack/ungbr.rst index ee5f45a61..63427d09c 100644 --- a/source/elements/oneMath/source/domains/lapack/ungbr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungbr.rst @@ -33,7 +33,7 @@ To compute the whole :math:`m \times m` matrix :math:`Q`, use: :: - oneapi::mkl::lapack::ungbr(queue, generate::q, m, m, n, a, ...) + oneapi::math::lapack::ungbr(queue, generate::q, m, m, n, a, ...) (note that the buffer ``a`` must have at least :math:`m` columns). @@ -41,13 +41,13 @@ To form the :math:`n` leading columns of :math:`Q` if :math:`m > n`, use: :: - oneapi::mkl::lapack::ungbr(queue, generate::q, m, n, n, a, ...) + oneapi::math::lapack::ungbr(queue, generate::q, m, n, n, a, ...) To compute the whole :math:`n \times n` matrix :math:`P^{T}`, use: :: - oneapi::mkl::lapack::ungbr(queue, generate::p, n, n, m, a, ...) + oneapi::math::lapack::ungbr(queue, generate::p, n, n, m, a, ...) (note that the array ``a`` must have at least :math:`n` rows). @@ -55,7 +55,7 @@ To form the :math:`m` leading rows of :math:`P^{T}` if :math:`m < n`, use: :: - oneapi::mkl::lapack::ungbr(queue, generate::p, m, n, m, a, ...) + oneapi::math::lapack::ungbr(queue, generate::p, m, n, m, a, ...) ungbr (Buffer Version) ---------------------- @@ -66,8 +66,8 @@ ungbr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void ungbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void ungbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -143,17 +143,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -170,8 +170,8 @@ ungbr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ungbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ungbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -250,17 +250,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst index b46eedae9..513d9ff71 100644 --- a/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungbr_scratchpad_size.rst @@ -34,9 +34,9 @@ ungbr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t ungbr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t &scratchpad_size) + std::int64_t ungbr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t &scratchpad_size) } .. container:: section @@ -85,11 +85,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ungqr.rst b/source/elements/oneMath/source/domains/lapack/ungqr.rst index 2a6c629d1..af1b060ca 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr.rst @@ -32,21 +32,21 @@ Usually :math:`Q` is determined from the QR factorization of an :math:`m \times :: - oneapi::mkl::lapack::ungqr(queue, m, m, p, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::ungqr(queue, m, m, p, a, lda, tau, scratchpad, scratchpad_size) To compute the leading :math:`p` columns of :math:`Q` (which form an orthonormal basis in the space spanned by the columns of :math:`A`): :: - oneapi::mkl::lapack::ungqr(queue, m, p, p, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::ungqr(queue, m, p, p, a, lda, tau, scratchpad, scratchpad_size) To compute the matrix :math:`Q^{k}` of the QR factorization of the leading :math:`k` columns of the matrix :math:`A`: :: - oneapi::mkl::lapack::ungqr(queue, m, m, k, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::ungqr(queue, m, m, k, a, lda, tau, scratchpad, scratchpad_size) To compute the leading :math:`k` columns of :math:`Q^{k}` (which form an orthonormal basis in the space spanned by the leading :math:`k` @@ -54,7 +54,7 @@ columns of the matrix :math:`A`): :: - oneapi::mkl::lapack::ungqr(queue, m, k, k, a, lda, tau, scratchpad, scratchpad_size) + oneapi::math::lapack::ungqr(queue, m, k, k, a, lda, tau, scratchpad, scratchpad_size) ungqr (Buffer Version) ---------------------- @@ -65,7 +65,7 @@ ungqr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void ungqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -118,17 +118,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -145,7 +145,7 @@ ungqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -201,17 +201,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst index 678b98e28..b3d2daece 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst @@ -52,7 +52,7 @@ The buffer version of ``ungqr_batch`` supports only the strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { void ungqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &tau, std::int64_t stride_tau, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } @@ -109,13 +109,13 @@ a This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of problems during calculations. The info code of the problem can be obtained by info() method of exception object: @@ -155,7 +155,7 @@ The USM version of ``ungqr_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, T **a, std::int64_t *lda, T **tau, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -219,13 +219,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -253,7 +253,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, std::int64_t stride_a, T *tau, std::int64_t stride_tau, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; @@ -319,13 +319,13 @@ Output event to wait on to ensure computation is complete. This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::lapack::batch_error` +:ref:`oneapi::math::lapack::batch_error` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst index 4804aab09..c68df2dd8 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_batch_scratchpad_size.rst @@ -32,7 +32,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t ungqr_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } @@ -75,11 +75,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. @@ -94,7 +94,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t ungqr_batch_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_tau, std::int64_t batch_size) }; @@ -140,11 +140,11 @@ Number of elements of type ``T`` the scratchpad memory should able to hold to be This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst index a15baeb1d..fbac1ab38 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_scratchpad_size.rst @@ -34,7 +34,7 @@ ungqr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template std::int64_t ungqr_scratchpad_size(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda) } @@ -65,11 +65,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/ungtr.rst b/source/elements/oneMath/source/domains/lapack/ungtr.rst index 6f784e7f4..05337e7ed 100644 --- a/source/elements/oneMath/source/domains/lapack/ungtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungtr.rst @@ -38,8 +38,8 @@ ungtr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void ungtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void ungtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -90,17 +90,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -117,8 +117,8 @@ ungtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ungtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ungtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -172,17 +172,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst index d0a091a6d..7ca69e14a 100644 --- a/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/ungtr_scratchpad_size.rst @@ -34,9 +34,9 @@ ungtr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t ungtr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t lda) + std::int64_t ungtr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t lda) } .. container:: section @@ -63,11 +63,11 @@ lda This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/unmqr.rst b/source/elements/oneMath/source/domains/lapack/unmqr.rst index 82599102c..30d420806 100644 --- a/source/elements/oneMath/source/domains/lapack/unmqr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmqr.rst @@ -42,8 +42,8 @@ unmqr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void unmqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void unmqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -54,17 +54,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{H}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::conjtrans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^{H}`. m @@ -77,9 +77,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The buffer ``a`` as returned by :ref:`onemath_lapack_geqrf`. @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -147,8 +147,8 @@ unmqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -159,17 +159,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{H}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::conjtrans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^{H}`. m @@ -182,9 +182,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The pointer to ``a`` as returned by :ref:`onemath_lapack_geqrf`. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst index 49112c811..8c0a639e4 100644 --- a/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmqr_scratchpad_size.rst @@ -35,9 +35,9 @@ unmqr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t unmqr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc, std::int64_t &scratchpad_size) + std::int64_t unmqr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc, std::int64_t &scratchpad_size) } .. container:: section @@ -48,17 +48,17 @@ queue Device queue where calculations by :ref:`onemath_lapack_unmqr` function will be performed. side - If ``side=oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is + If ``side=oneapi::math::side::left``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the left. - If ``side=oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{H}` is + If ``side=oneapi::math::side::right``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the right. trans - If ``trans=oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans=oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans=oneapi::mkl::transpose::conjtrans``, the routine multiplies + If ``trans=oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^H`. m @@ -83,11 +83,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/unmrq.rst b/source/elements/oneMath/source/domains/lapack/unmrq.rst index 9815e045b..eaa5ec8c1 100644 --- a/source/elements/oneMath/source/domains/lapack/unmrq.rst +++ b/source/elements/oneMath/source/domains/lapack/unmrq.rst @@ -42,8 +42,8 @@ unmrq (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void unmrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void unmrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -54,17 +54,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{H}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::conjtrans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^{H}`. m @@ -77,9 +77,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The buffer ``a`` as returned by :ref:`onemath_lapack_gerqf`. @@ -120,17 +120,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -147,8 +147,8 @@ unmrq (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -159,17 +159,17 @@ queue The queue where the routine should be executed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^{H}` is applied + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the left. - If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^{H}` is + If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^{H}` is applied to :math:`C` from the right. trans - If ``trans = oneapi::mkl::transpose::nontrans``, the routine multiplies + If ``trans = oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans = oneapi::mkl::transpose::conjtrans``, the routine multiplies :math:`C` + If ``trans = oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^{H}`. m @@ -182,9 +182,9 @@ k The number of elementary reflectors whose product defines the matrix :math:`Q` - If ``side = oneapi::mkl::side::left``, :math:`0 \le k \le m` + If ``side = oneapi::math::side::left``, :math:`0 \le k \le m` - If ``side = oneapi::mkl::side::right``, :math:`0 \le k \le n` + If ``side = oneapi::math::side::right``, :math:`0 \le k \le n` a The pointer to ``a`` as returned by :ref:`onemath_lapack_gerqf`. @@ -228,17 +228,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst index 63ecc9ffd..b99220b63 100644 --- a/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmrq_scratchpad_size.rst @@ -34,9 +34,9 @@ unmrq_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t unmrq_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc) + std::int64_t unmrq_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, std::int64_t lda, std::int64_t ldc) } .. container:: section @@ -47,12 +47,12 @@ queue Device queue where calculations by the unmrq function will be performed. side - If ``side = oneapi::mkl::side::left``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the left. If ``side = oneapi::mkl::side::right``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the right. + If ``side = oneapi::math::side::left``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the left. If ``side = oneapi::math::side::right``, :math:`Q` or :math:`Q^T` is applied to :math:`C` from the right. trans - If ``trans=oneapi::mkl::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. + If ``trans=oneapi::math::transpose::nontrans``, the routine multiplies :math:`C` by :math:`Q`. - If ``trans=oneapi::mkl::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^H`. + If ``trans=oneapi::math::transpose::conjtrans``, the routine multiplies :math:`C` by :math:`Q^H`. m The number of rows in the matrix :math:`C` (:math:`0 \le m`). @@ -75,11 +75,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/lapack/unmtr.rst b/source/elements/oneMath/source/domains/lapack/unmtr.rst index 5c4939b02..d0d204274 100644 --- a/source/elements/oneMath/source/domains/lapack/unmtr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmtr.rst @@ -44,8 +44,8 @@ unmtr (Buffer Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - void unmtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + namespace oneapi::math::lapack { + void unmtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, cl::sycl::buffer &tau, cl::sycl::buffer &c, std::int64_t ldc, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -142,17 +142,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: @@ -169,8 +169,8 @@ unmtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, T *a, std::int64_t lda, T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -270,17 +270,17 @@ scratchpad This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::host_bad_alloc` +:ref:`oneapi::math::host_bad_alloc` -:ref:`oneapi::mkl::device_bad_alloc` +:ref:`oneapi::math::device_bad_alloc` -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` -:ref:`oneapi::mkl::lapack::computation_error` +:ref:`oneapi::math::lapack::computation_error` Exception is thrown in case of problems during calculations. The ``info`` code of the problem can be obtained by `info()` method of exception object: diff --git a/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst index f3ab16b64..fc202e6db 100644 --- a/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/unmtr_scratchpad_size.rst @@ -34,9 +34,9 @@ unmtr_scratchpad_size .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { template - std::int64_t unmtr_scratchpad_size(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldc) + std::int64_t unmtr_scratchpad_size(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t lda, std::int64_t ldc) } .. container:: section @@ -92,11 +92,11 @@ ldc This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here. -:ref:`oneapi::mkl::unimplemented` +:ref:`oneapi::math::unimplemented` -:ref:`oneapi::mkl::unsupported_device` +:ref:`oneapi::math::unsupported_device` -:ref:`oneapi::mkl::lapack::invalid_argument` +:ref:`oneapi::math::lapack::invalid_argument` Exception is thrown in case of incorrect supplied argument value. Position of wrong argument can be determined by `info()` method of exception object. diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst index fbebb0a4d..17c540908 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst @@ -44,7 +44,7 @@ class bernoulli .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class bernoulli { public: @@ -76,11 +76,11 @@ class bernoulli .. container:: section - typename Method = oneapi::mkl::rng::bernoulli_method::by_default + typename Method = oneapi::math::rng::bernoulli_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::bernoulli_method::by_default`` - * ``oneapi::mkl::rng::bernoulli_method::icdf`` + * ``oneapi::math::rng::bernoulli_method::by_default`` + * ``oneapi::math::rng::bernoulli_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -164,7 +164,7 @@ class bernoulli .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `p > 1`, or `p < 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst index c3e7004bd..fcd6602e2 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-beta.rst @@ -39,7 +39,7 @@ class beta .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class beta { public: @@ -166,7 +166,7 @@ class beta .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`p \leq 0`, or :math:`q \leq 0`, or :math:`\beta \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst index 9a9ff35f7..70dce2dae 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bits.rst @@ -23,7 +23,7 @@ class bits .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class bits { using result_type = UIntType; diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst index f0b8bfa12..0ee577361 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-exponential.rst @@ -47,7 +47,7 @@ class exponential .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class exponential { public: @@ -77,12 +77,12 @@ class exponential .. container:: section - typename Method = oneapi::mkl::rng::exponential_method::by_default + typename Method = oneapi::math::rng::exponential_method::by_default Generation method. The specific values are as follows: - * ``oneapi::mkl::rng::device::exponential_method::by_default`` - * ``oneapi::mkl::rng::device::exponential_method::icdf`` - * ``oneapi::mkl::rng::device::exponential_method::icdf_accurate`` + * ``oneapi::math::rng::device::exponential_method::by_default`` + * ``oneapi::math::rng::device::exponential_method::icdf`` + * ``oneapi::math::rng::device::exponential_method::icdf_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -169,7 +169,7 @@ class exponential .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`beta \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst index f161446c4..b8a049a54 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gamma.rst @@ -37,7 +37,7 @@ class gamma .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class gamma { public: @@ -161,7 +161,7 @@ class gamma .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`alpha \leq 0` or :math:`beta \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst index 5aae871bc..f31cf32ee 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-gaussian.rst @@ -56,7 +56,7 @@ class gaussian .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class gaussian { public: @@ -88,8 +88,8 @@ class gaussian typename Method Generation method. The specific values are as follows: - * ``oneapi::mkl::rng::device::gaussian_method::by_default`` - * ``oneapi::mkl::rng::device::gaussian_method::box_muller2`` + * ``oneapi::math::rng::device::gaussian_method::by_default`` + * ``oneapi::math::rng::device::gaussian_method::box_muller2`` See description of the methods in :ref:`Distributions methods template parameter` @@ -175,7 +175,7 @@ class gaussian .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `stddev` :math:`\leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst index 8a2230921..5a29df4f5 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-generate.rst @@ -15,7 +15,7 @@ Entry point to obtain random numbers from a given engine with proper statistics .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template auto generate(Distr& distr, Engine& engine) -> typename std::conditional class lognormal { public: @@ -80,11 +80,11 @@ class lognormal .. container:: section - typename Method = oneapi::mkl::rng::lognormal_method::by_default + typename Method = oneapi::math::rng::lognormal_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::device::lognormal_method::by_default`` - * ``oneapi::mkl::rng::device::lognormal_method::box_muller2`` + * ``oneapi::math::rng::device::lognormal_method::by_default`` + * ``oneapi::math::rng::device::lognormal_method::box_muller2`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -176,7 +176,7 @@ class lognormal .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`s \leq 0`, or :math:`scale \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst index aca80b190..9ef7ff8ab 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg31m1.rst @@ -36,7 +36,7 @@ class mcg31m1 .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class mcg31m1 { public: diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst index 0d580b805..61f66edba 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mcg59.rst @@ -32,7 +32,7 @@ class mcg59 .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class mcg59 { public: diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst index 9cc285b4f..3bc1c3964 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-mrg32k3a.rst @@ -41,7 +41,7 @@ class mrg32k3a .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class mrg32k3a { public: diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst index 10acf6f1e..c09f51c79 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-philox4x32x10.rst @@ -51,7 +51,7 @@ class philox4x32x10 .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class philox4x32x10 { public: diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst index e68a0f220..1365cd614 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst @@ -42,7 +42,7 @@ class poisson .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class poisson { public: @@ -70,11 +70,11 @@ class poisson .. container:: section - typename Method = oneapi::mkl::rng::poisson_method::by_default + typename Method = oneapi::math::rng::poisson_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::device::poisson_method::by_default`` - * ``oneapi::mkl::rng::device::poisson_method::devroye`` + * ``oneapi::math::rng::device::poisson_method::by_default`` + * ``oneapi::math::rng::device::poisson_method::devroye`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -158,7 +158,7 @@ class poisson .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`lambda \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst index 3630015e5..16dbe2918 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-skip-ahead.rst @@ -25,7 +25,7 @@ skip_ahead .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template void skip_ahead (Engine& engine, std::uint64_t num_to_skip) } @@ -52,7 +52,7 @@ skip_ahead .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template void skip_ahead (Engine& engine, std::initializer_list num_to_skip) } diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst index a2b2fadde..84a7aee4f 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-bits.rst @@ -26,7 +26,7 @@ class uniform_bits .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class uniform_bits { using result_type = UIntType; diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst index 099543987..8ce4ac353 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-continuous.rst @@ -48,7 +48,7 @@ class uniform .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class uniform { public: @@ -81,9 +81,9 @@ class uniform typename Method Generation method. The specific values are as follows: - * ``oneapi::mkl::rng::device::uniform_method::by_default`` - * ``oneapi::mkl::rng::device::uniform_method::standard`` - * ``oneapi::mkl::rng::device::uniform_method::accurate`` + * ``oneapi::math::rng::device::uniform_method::by_default`` + * ``oneapi::math::rng::device::uniform_method::standard`` + * ``oneapi::math::rng::device::uniform_method::accurate`` See description of the methods in :ref:`Distributions methods template parameter` @@ -170,7 +170,7 @@ class uniform .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`a \ge b` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst index 581aac578..1712a33cc 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-uniform-discrete.rst @@ -45,7 +45,7 @@ class uniform .. code-block:: cpp - namespace oneapi::mkl::rng::device { + namespace oneapi::math::rng::device { template class uniform { public: @@ -77,12 +77,12 @@ class uniform .. container:: section - typename Method = oneapi::mkl::rng::uniform_method::by_default + typename Method = oneapi::math::rng::uniform_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::device::uniform_method::by_default`` - * ``oneapi::mkl::rng::device::uniform_method::standard`` - * ``oneapi::mkl::rng::device::uniform_method::accurate`` + * ``oneapi::math::rng::device::uniform_method::by_default`` + * ``oneapi::math::rng::device::uniform_method::standard`` + * ``oneapi::math::rng::device::uniform_method::accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -142,7 +142,7 @@ class uniform .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`a \ge b` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst index 5d0af7cc0..46c603c3f 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst @@ -27,7 +27,7 @@ Example of Scalar Random Numbers Generation .. code-block:: cpp - #include "oneapi/mkl/rng/device.hpp" + #include "oneapi/math/rng/device.hpp" int main() { sycl::queue q; @@ -37,11 +37,11 @@ Example of Scalar Random Numbers Generation // ... cgh.parallel_for(n, [=](size_t idx) { // Create an engine object - oneapi::mkl::rng::device::philox4x32x10<> engine(seed, idx); + oneapi::math::rng::device::philox4x32x10<> engine(seed, idx); // Create a distribution object - oneapi::mkl::rng::device::uniform distr; + oneapi::math::rng::device::uniform distr; // Call generate function to obtain scalar random number - float res = oneapi::mkl::rng::device::generate(distr, engine); + float res = oneapi::math::rng::device::generate(distr, engine); // ... }); }); @@ -53,7 +53,7 @@ Example of Vector Random Numbers Generation .. code-block:: cpp - #include "oneapi/mkl/rng/device.hpp" + #include "oneapi/math/rng/device.hpp" int main() { sycl::queue q; @@ -63,11 +63,11 @@ Example of Vector Random Numbers Generation // ... cgh.parallel_for((n / vec_size), [=](size_t idx) { // Create an engine object - oneapi::mkl::rng::device::philox4x32x10 engine(seed, idx * vec_size); + oneapi::math::rng::device::philox4x32x10 engine(seed, idx * vec_size); // Create a distribution object - oneapi::mkl::rng::device::uniform distr; + oneapi::math::rng::device::uniform distr; // Call generate function to obtain random numbers - sycl::vec res = oneapi::mkl::rng::device::generate(distr, engine); + sycl::vec res = oneapi::math::rng::device::generate(distr, engine); // ... }); }); diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst b/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst index 51a3958a2..022775085 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-routines.rst @@ -15,11 +15,11 @@ The main purpose of Device routines is to make them callable from your SYCL kern queue.submit([&](sycl::handler& cgh) { cgh.parallel_for(range,[=](...) { - oneapi::mkl::rng::device::routine(...); // calling routine from user's kernel code + oneapi::math::rng::device::routine(...); // calling routine from user's kernel code }); }); - oneapi::mkl::rng::device::routine(...); // calling routine from host + oneapi::math::rng::device::routine(...); // calling routine from host .. rubric:: Structure diff --git a/source/elements/oneMath/source/domains/rng/host_api/distributions.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst index 9aecae533..5594351fd 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/distributions.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst @@ -128,19 +128,19 @@ Host Distributions * - Distribution - Method * - \ :ref:`onemath_rng_uniform_continuous`\ - - `oneapi::mkl::rng::unform_method::accurate` + - `oneapi::math::rng::unform_method::accurate` * - \ :ref:`onemath_rng_exponential`\ - - `oneapi::mkl::rng::exponential_method::icdf_accurate` + - `oneapi::math::rng::exponential_method::icdf_accurate` * - \ :ref:`onemath_rng_weibull`\ - - `oneapi::mkl::rng::weibull_method::icdf_accurate` + - `oneapi::math::rng::weibull_method::icdf_accurate` * - \ :ref:`onemath_rng_rayleigh`\ - - `oneapi::mkl::rng::rayleigh_method::icdf_accurate` + - `oneapi::math::rng::rayleigh_method::icdf_accurate` * - \ :ref:`onemath_rng_lognormal`\ - - `oneapi::mkl::rng::lognormal_method::box_muller2_accurate`, `oneapi::mkl::rng::lognormal_method::icdf_accurate` + - `oneapi::math::rng::lognormal_method::box_muller2_accurate`, `oneapi::math::rng::lognormal_method::icdf_accurate` * - \ :ref:`onemath_rng_gamma`\ - - `oneapi::mkl::rng::gamma_method::marsaglia_accurate` + - `oneapi::math::rng::gamma_method::marsaglia_accurate` * - \ :ref:`onemath_rng_beta`\ - - `oneapi::mkl::rng::beta_method::cja_accurate` + - `oneapi::math::rng::beta_method::cja_accurate`   **Parent topic:** :ref:`onemath_rng_manual_offload_routines` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst index fbcaacc1f..d124114fe 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst @@ -54,7 +54,7 @@ class ars5 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class ars5 { public: static constexpr std::uint64_t default_seed = 0; @@ -112,7 +112,7 @@ class ars5 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is 128-bit key, :math:`c` is 128-bit counter. @@ -128,7 +128,7 @@ class ars5 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst index 0baed6f2f..9e2b69e12 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst @@ -13,7 +13,7 @@ Class is used for generation of Bernoulli distributed integer types random numbe .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. The probability distribution is given by: @@ -40,7 +40,7 @@ class bernoulli .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class bernoulli { public: @@ -65,11 +65,11 @@ class bernoulli .. container:: section - typename Method = oneapi::mkl::rng::bernoulli_method::by_default + typename Method = oneapi::math::rng::bernoulli_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::bernoulli_method::by_default`` - * ``oneapi::mkl::rng::bernoulli_method::icdf`` + * ``oneapi::math::rng::bernoulli_method::by_default`` + * ``oneapi::math::rng::bernoulli_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -153,7 +153,7 @@ class bernoulli .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `p > 1.0f`, or `p < 0.0f` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst index c7e5b9034..d75161700 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst @@ -13,7 +13,7 @@ Class is used for generation of beta distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers beta distributed with shape parameters :math:`p` and :math:`q`, displacement :math:`\alpha` and scale parameter :math:`(b, \beta)`, where :math:`p`, :math:`q`. :math:`\alpha`, :math:`\beta` :math:`\in R; p > 0; q > 0; \beta > 0`. @@ -42,7 +42,7 @@ class beta .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class beta { public: @@ -70,12 +70,12 @@ class beta .. container:: section - typename Method = oneapi::mkl::rng::beta_method::by_default + typename Method = oneapi::math::rng::beta_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::beta_method::by_default`` - * ``oneapi::mkl::rng::beta_method::cja`` - * ``oneapi::mkl::rng::beta_method::cja_accurate`` + * ``oneapi::math::rng::beta_method::by_default`` + * ``oneapi::math::rng::beta_method::cja`` + * ``oneapi::math::rng::beta_method::cja_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -165,7 +165,7 @@ class beta .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`p \leq 0.0f`, or :math:`q \leq 0.0f`, or :math:`\beta \leq 0.0f` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst index 31fd0a9bf..af8e186f4 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst @@ -13,7 +13,7 @@ Class is used for generation of binomially distributed integer types random numb .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. A binomially distributed variate represents the number of successes in :math:`m` independent Bernoulli trials with probability of a single trial success :math:`p`. @@ -39,7 +39,7 @@ class binomial .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class binomial { public: @@ -64,11 +64,11 @@ class binomial .. container:: section - typename Method = oneapi::mkl::rng::binomial_method::by_default + typename Method = oneapi::math::rng::binomial_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::binomial_method::by_default`` - * ``oneapi::mkl::rng::binomial_method::btpe`` + * ``oneapi::math::rng::binomial_method::by_default`` + * ``oneapi::math::rng::binomial_method::btpe`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -154,7 +154,7 @@ class binomial .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`p > 1.0`, or :math:`p < 0.0`, or :math:`ntrial < 1` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst index 3354c4aa4..f6cdf37de 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst @@ -13,7 +13,7 @@ Class is used for generation of underlying engine integer recurrence. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. class bits ---------- @@ -22,7 +22,7 @@ class bits .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class bits { public: diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst index 7c8bcf760..bdb6c6674 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst @@ -13,7 +13,7 @@ Class is used for generation of Cauchy distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -36,7 +36,7 @@ class cauchy .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class cauchy { public: @@ -62,11 +62,11 @@ class cauchy .. container:: section - typename Method = oneapi::mkl::rng::cauchy_method::by_default + typename Method = oneapi::math::rng::cauchy_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::cauchy_method::by_default`` - * ``oneapi::mkl::rng::cauchy_method::icdf`` + * ``oneapi::math::rng::cauchy_method::by_default`` + * ``oneapi::math::rng::cauchy_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -152,7 +152,7 @@ class cauchy .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`b \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst index ba6269cd0..5d72e596f 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst @@ -13,7 +13,7 @@ Class is used for generation of chi-square distributed real types random numbers .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. The probability distribution is given by: @@ -37,7 +37,7 @@ class chi_square .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class chi_square { public: @@ -62,11 +62,11 @@ class chi_square .. container:: section - typename Method = oneapi::mkl::rng::chi_square_method::by_default + typename Method = oneapi::math::rng::chi_square_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::chi_square_method::by_default`` - * ``oneapi::mkl::rng::chi_square_method::gamma_based`` + * ``oneapi::math::rng::chi_square_method::by_default`` + * ``oneapi::math::rng::chi_square_method::gamma_based`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -150,7 +150,7 @@ class chi_square .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`n < 1` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst index e0d1e1764..646998054 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst @@ -13,7 +13,7 @@ Class is used for generation of exponentially distributed real types random numb .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -36,7 +36,7 @@ class exponential .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class exponential { public: @@ -62,12 +62,12 @@ class exponential .. container:: section - typename Method = oneapi::mkl::rng::exponential_method::by_default + typename Method = oneapi::math::rng::exponential_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::exponential_method::by_default`` - * ``oneapi::mkl::rng::exponential_method::icdf`` - * ``oneapi::mkl::rng::exponential_method::icdf_accurate`` + * ``oneapi::math::rng::exponential_method::by_default`` + * ``oneapi::math::rng::exponential_method::icdf`` + * ``oneapi::math::rng::exponential_method::icdf_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -153,7 +153,7 @@ class exponential .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`beta \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst index b92dfc408..8933e4937 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst @@ -13,7 +13,7 @@ Class is used for generation of gamma distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers gamma distributed with shape :math:`\alpha`, displacement :math:`a`, and scale parameter :math:`\beta`, where :math:`a, \alpha, \beta \in R; \alpha > 0; \beta > 0`. @@ -39,7 +39,7 @@ class gamma .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class gamma { public: @@ -66,12 +66,12 @@ class gamma .. container:: section - typename Method = oneapi::mkl::rng::gamma_method::by_default + typename Method = oneapi::math::rng::gamma_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::gamma_method::by_default`` - * ``oneapi::mkl::rng::gamma_method::marsaglia`` - * ``oneapi::mkl::rng::gamma_method::marsaglia_accurate`` + * ``oneapi::math::rng::gamma_method::by_default`` + * ``oneapi::math::rng::gamma_method::marsaglia`` + * ``oneapi::math::rng::gamma_method::marsaglia_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -159,7 +159,7 @@ class gamma .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst index 93f3abae4..5fbb56576 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst @@ -13,7 +13,7 @@ Class is used for generation of normally distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. The probability distribution is given by: @@ -37,7 +37,7 @@ class gaussian .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class gaussian { public: @@ -63,13 +63,13 @@ class gaussian .. container:: section - typename Method = oneapi::mkl::rng::gaussian_method::by_default + typename Method = oneapi::math::rng::gaussian_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::gaussian_method::by_default`` - * ``oneapi::mkl::rng::gaussian_method::box_muller`` - * ``oneapi::mkl::rng::gaussian_method::box_muller2`` - * ``oneapi::mkl::rng::gaussian_method::icdf`` + * ``oneapi::math::rng::gaussian_method::by_default`` + * ``oneapi::math::rng::gaussian_method::box_muller`` + * ``oneapi::math::rng::gaussian_method::box_muller2`` + * ``oneapi::math::rng::gaussian_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter` @@ -155,7 +155,7 @@ class gaussian .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `stddev` :math:`\leq` `static_cast(0.0)` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst index a7dea550c..8d66eb1a9 100755 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst @@ -13,7 +13,7 @@ Class is used for generation of multivariate normally distributed real types ran .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. The probability density function is given by: @@ -33,7 +33,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class gaussian_mv { public: @@ -61,21 +61,21 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. container:: section - oneapi::mkl::rng::layout Layout + oneapi::math::rng::layout Layout Matrix layout: - * ``oneapi::mkl::rng::layout::full`` - * ``oneapi::mkl::rng::layout::packed`` - * ``oneapi::mkl::rng::layout::diagonal`` + * ``oneapi::math::rng::layout::full`` + * ``oneapi::math::rng::layout::packed`` + * ``oneapi::math::rng::layout::diagonal`` .. container:: section - typename Method = oneapi::mkl::rng::gaussian_mv_method::by_default + typename Method = oneapi::math::rng::gaussian_mv_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::gaussian_mv_method::by_default`` - * ``oneapi::mkl::rng::gaussian_mv_method::box_muller`` - * ``oneapi::mkl::rng::gaussian_mv_method::box_muller2`` - * ``oneapi::mkl::rng::gaussian_mv_method::icdf`` + * ``oneapi::math::rng::gaussian_mv_method::by_default`` + * ``oneapi::math::rng::gaussian_mv_method::box_muller`` + * ``oneapi::math::rng::gaussian_mv_method::box_muller2`` + * ``oneapi::math::rng::gaussian_mv_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -147,7 +147,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`mean.size() \leq 0`, or :math:`matrix.size() \leq 0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst index d1940a9e1..724275fd8 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst @@ -13,7 +13,7 @@ Entry point to obtain random numbers from a given engine with proper statistics .. rubric:: Description and Assumptions -oneapi::mkl::rng::generate function produces random numbers sequence from the given engine object and applied transformation from a given distribution object. +oneapi::math::rng::generate function produces random numbers sequence from the given engine object and applied transformation from a given distribution object. .. _onemath_rng_generate_buffer: @@ -24,7 +24,7 @@ generate (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template void generate (const DistrType& distr, EngineType& engine, std::int64_t n, sycl::buffer& r); } @@ -63,7 +63,7 @@ generate (Buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when n > r.get_count(), or n < 0 .. _onemath_rng_generate_usm: @@ -75,7 +75,7 @@ generate (USM version) .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template sycl::event generate (const DistrType& distr, EngineType& engine, std::int64_t n, typename DistrType::result_type* r, const std::vector & dependencies); } @@ -117,7 +117,7 @@ generate (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when r == nullptr, or n < 0 .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst index 230c17b72..a01a94d6d 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst @@ -13,7 +13,7 @@ Class is used for generation of geometrically distributed integer types random n .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. The probability distribution is given by: @@ -36,7 +36,7 @@ class geometric .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class geometric { public: @@ -61,11 +61,11 @@ class geometric .. container:: section - typename Method = oneapi::mkl::rng::geometric_method::by_default + typename Method = oneapi::math::rng::geometric_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::geometric_method::by_default`` - * ``oneapi::mkl::rng::geometric_method::icdf`` + * ``oneapi::math::rng::geometric_method::by_default`` + * ``oneapi::math::rng::geometric_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -149,7 +149,7 @@ class geometric .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`p \ge 1.0f`, or :math:`p \leq 0.0f` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst index bd86b232a..ae02b8deb 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst @@ -13,7 +13,7 @@ Class is used for generation of Gumbel distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The probability distribution is given by: @@ -36,7 +36,7 @@ class gumbel .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class gumbel { public: @@ -62,11 +62,11 @@ class gumbel .. container:: section - typename Method = oneapi::mkl::rng::gumbel_method::by_default + typename Method = oneapi::math::rng::gumbel_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::gumbel_method::by_default`` - * ``oneapi::mkl::rng::gumbel_method::icdf`` + * ``oneapi::math::rng::gumbel_method::by_default`` + * ``oneapi::math::rng::gumbel_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -152,7 +152,7 @@ class gumbel .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`b \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst index e8f5fd78c..aa185c39c 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst @@ -13,7 +13,7 @@ Class is used for generation of hypergeometrically distributed integer types ran .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. Consider a lot of :math:`l` elements comprising :math:`m` marked and :math:`l` - :math:`m` unmarked elements. A trial sampling without replacement of exactly :math:`s` elements from this lot helps to define the hypergeometric distribution, which is the probability that the group of :math:`s` elements contains exactly :math:`k` marked elements. @@ -38,7 +38,7 @@ class hypergeometric .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class hypergeometric { public: @@ -65,11 +65,11 @@ class hypergeometric .. container:: section - typename Method = oneapi::mkl::rng::hypergeometric_method::by_default + typename Method = oneapi::math::rng::hypergeometric_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::hypergeometric_method::by_default`` - * ``oneapi::mkl::rng::hypergeometric_method::h2pe`` + * ``oneapi::math::rng::hypergeometric_method::by_default`` + * ``oneapi::math::rng::hypergeometric_method::h2pe`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -157,7 +157,7 @@ class hypergeometric .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`s < 0`, or :math:`m < 0`, or :math:`l < (s > m ? s : m)` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst index 5e2e977ef..f9fc41ca9 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst @@ -13,7 +13,7 @@ Class is used for generation of Laplace distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. The probability distribution is given by: @@ -60,11 +60,11 @@ class laplace .. container:: section - typename Method = oneapi::mkl::rng::laplace_method::by_default + typename Method = oneapi::math::rng::laplace_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::laplace_method::by_default`` - * ``oneapi::mkl::rng::laplace_method::icdf`` + * ``oneapi::math::rng::laplace_method::by_default`` + * ``oneapi::math::rng::laplace_method::icdf`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -150,7 +150,7 @@ class laplace .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`b \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst index 8d473ac86..3365f9024 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst @@ -13,7 +13,7 @@ Proceed state of engine by the leapfrog method. .. rubric:: Description and Assumptions -oneapi::mkl::rng::leapfrog function generates random numbers in an engine with non-unit stride. This feature is particularly useful in distributing random numbers from the original stream across the stride buffers without generating the original random sequence with subsequent manual distribution. see `Figure "Leapfrog Method" <#rng_leapfrog>`__. +oneapi::math::rng::leapfrog function generates random numbers in an engine with non-unit stride. This feature is particularly useful in distributing random numbers from the original stream across the stride buffers without generating the original random sequence with subsequent manual distribution. see `Figure "Leapfrog Method" <#rng_leapfrog>`__. .. container:: figtop :name: rng_leapfrog @@ -31,7 +31,7 @@ leapfrog .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template void leapfrog(EngineType& engine, std::uint64_t idx, std::uint64_t stride); } @@ -61,16 +61,16 @@ leapfrog .. code-block:: cpp // Creating 3 identical engines - oneapi::mkl::rng::mcg31m1 engine_1(queue, seed); + oneapi::math::rng::mcg31m1 engine_1(queue, seed); - oneapi::mkl::rng::mcg31m1 engine_2(engine_1); - oneapi::mkl::rng::mcg31m1 engine_3(engine_1); + oneapi::math::rng::mcg31m1 engine_2(engine_1); + oneapi::math::rng::mcg31m1 engine_3(engine_1); // Leapfrogging the states of engines - oneapi::mkl::rng::leapfrog(engine_1, 0 , 3); - oneapi::mkl::rng::leapfrog(engine_2, 1 , 3); - oneapi::mkl::rng::leapfrog(engine_3, 2 , 3); + oneapi::math::rng::leapfrog(engine_1, 0 , 3); + oneapi::math::rng::leapfrog(engine_2, 1 , 3); + oneapi::math::rng::leapfrog(engine_3, 2 , 3); // Generating random numbers diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst index a763e9d4b..5d22a4007 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst @@ -13,7 +13,7 @@ Class is used for generation of lognormally distributed real types random number .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. The probability distribution is given by: @@ -36,7 +36,7 @@ class lognormal .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class lognormal { public: @@ -64,14 +64,14 @@ class lognormal .. container:: section - typename Method = oneapi::mkl::rng::lognormal_method::by_default + typename Method = oneapi::math::rng::lognormal_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::lognormal_method::by_default`` - * ``oneapi::mkl::rng::lognormal_method::box_muller2`` - * ``oneapi::mkl::rng::lognormal_method::icdf`` - * ``oneapi::mkl::rng::lognormal_method::box_muller2_accurate`` - * ``oneapi::mkl::rng::lognormal_method::icdf_accurate`` + * ``oneapi::math::rng::lognormal_method::by_default`` + * ``oneapi::math::rng::lognormal_method::box_muller2`` + * ``oneapi::math::rng::lognormal_method::icdf`` + * ``oneapi::math::rng::lognormal_method::box_muller2_accurate`` + * ``oneapi::math::rng::lognormal_method::icdf_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -161,7 +161,7 @@ class lognormal .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`s \leq` static_cast(0.0), or :math:`scale \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst index 04ec7f84c..2fc224d40 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst @@ -34,7 +34,7 @@ class mcg31m1 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class mcg31m1 { public: static constexpr std::uint32_t default_seed = 1; @@ -88,7 +88,7 @@ class mcg31m1 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 0x7FFFFFFF`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst index 5d1b9e0a4..f887f6d55 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst @@ -34,7 +34,7 @@ class mcg59 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class mcg59 { public: static constexpr std::uint64_t default_seed = 1; @@ -88,7 +88,7 @@ class mcg59 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 2^{59}`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst index b0154b294..19f265dfa 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst @@ -42,7 +42,7 @@ class mrg32k3a .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class mrg32k3a { public: static constexpr std::uint32_t default_seed = 1; @@ -100,7 +100,7 @@ class mrg32k3a .. rubric:: Input Parameters queue - Valid ``sycl::queue object``, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue object``, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_{-3} = seed \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1`. @@ -116,7 +116,7 @@ class mrg32k3a .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst index f5bbf52b6..b1f8b7123 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst @@ -55,7 +55,7 @@ class mt19937 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class mt19937 { public: static constexpr std::uint32_t default_seed = 1; @@ -113,7 +113,7 @@ class mt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. @@ -129,7 +129,7 @@ class mt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst index 6cc1c6f4b..b7a6ac297 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst @@ -52,7 +52,7 @@ class mt2203 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class mt2203 { public: static constexpr std::uint32_t default_seed = 1; @@ -118,7 +118,7 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. @@ -134,7 +134,7 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. @@ -146,7 +146,7 @@ class mt2203 .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`idx > 6024` .. _`mt2203(sycl::queue queue, std::initializer_list seed)`: @@ -160,7 +160,7 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. @@ -176,7 +176,7 @@ class mt2203 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst index 5b4e11dcc..2750ab124 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst @@ -13,7 +13,7 @@ Class is used for generation of multinomially distributed integer types random n .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. The probability distribution is given by: @@ -33,7 +33,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class multinomial { public: @@ -58,11 +58,11 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. container:: section - typename Method = oneapi::mkl::rng::multinomial_method::by_default + typename Method = oneapi::math::rng::multinomial_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::multinomial_method::by_default`` - * ``oneapi::mkl::rng::multinomial_method::poisson_icdf_based`` + * ``oneapi::math::rng::multinomial_method::by_default`` + * ``oneapi::math::rng::multinomial_method::poisson_icdf_based`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -132,7 +132,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`ntrial < 0`, or :math:`p.size() < 1` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst index 505dbc0ba..f2d6a32a1 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst @@ -13,7 +13,7 @@ Class is used for generation of negative binomially distributed integer types ra .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. The probability distribution is given by: @@ -37,7 +37,7 @@ class negative_binomial .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class negative_binomial { public: @@ -63,11 +63,11 @@ class negative_binomial .. container:: section - typename Method = oneapi::mkl::rng::negative_binomial_method::by_default + typename Method = oneapi::math::rng::negative_binomial_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::negative_binomial_method::by_default`` - * ``oneapi::mkl::rng::negative_binomial_method::nbar`` + * ``oneapi::math::rng::negative_binomial_method::by_default`` + * ``oneapi::math::rng::negative_binomial_method::nbar`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -153,7 +153,7 @@ class negative_binomial .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`p \ge 1.0`, or :math:`p \leq 0.0`, or :math:`a \leq 0.0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst index 0a9560ddb..114a210b6 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst @@ -35,7 +35,7 @@ class niederreiter .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class niederreiter { public: static constexpr std::uint32_t default_dimensions_number = 1; @@ -93,7 +93,7 @@ class niederreiter .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. dimensions Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 318`, assume :math:`dimen = 1`. @@ -109,7 +109,7 @@ class niederreiter .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. irred_polynomials If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own irreducible polynomials. The number of dimensions corresponds to the length of the vector. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst index 8c3b7b112..886c09a51 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst @@ -24,7 +24,7 @@ class nondeterministic .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class nondeterministic { public: nondeterministic(sycl::queue queue); @@ -76,7 +76,7 @@ class nondeterministic .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. .. _`nondeterministic(const nondeterministic& other)`: diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst index fdd737c4a..c2b5d4d0a 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst @@ -53,7 +53,7 @@ class philox4x32x10 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class philox4x32x10 { public: static constexpr std::uint64_t default_seed = 0; @@ -111,7 +111,7 @@ class philox4x32x10 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is a 64-bit key, :math:`c` is a 128-bit counter. @@ -127,7 +127,7 @@ class philox4x32x10 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst index fba554ac6..d7b2c4b24 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst @@ -13,7 +13,7 @@ Class is used for generation of Poisson distributed integer types random numbers .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. The probability distribution is given by: @@ -36,7 +36,7 @@ class poisson .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class poisson { public: @@ -60,12 +60,12 @@ class poisson .. container:: section - typename Method = oneapi::mkl::rng::poisson_method::by_default + typename Method = oneapi::math::rng::poisson_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::poisson_method::by_default`` - * ``oneapi::mkl::rng::poisson_method::ptpe`` - * ``oneapi::mkl::rng::poisson_method::gaussian_icdf_based`` + * ``oneapi::math::rng::poisson_method::by_default`` + * ``oneapi::math::rng::poisson_method::ptpe`` + * ``oneapi::math::rng::poisson_method::gaussian_icdf_based`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -149,7 +149,7 @@ class poisson .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`lambda \leq 0.0` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst index 2c8f66610..1a254bebe 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst @@ -13,7 +13,7 @@ Class is used for generation of Poisson distributed integer types random numbers .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide n random numbers Poisson distributed, with distribution parameter :math:`\lambda_i`, where :math:`\lambda_i \in R; \lambda_i > 0; i = 1, ... , n`. The probability distribution is given by: @@ -40,7 +40,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class poisson_v { public: @@ -63,11 +63,11 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. container:: section - typename Method = oneapi::mkl::rng::poisson_v_method::by_default + typename Method = oneapi::math::rng::poisson_v_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::poisson_v_method::by_default`` - * ``oneapi::mkl::rng::poisson_v_method::gaussian_icdf_based`` + * ``oneapi::math::rng::poisson_v_method::by_default`` + * ``oneapi::math::rng::poisson_v_method::gaussian_icdf_based`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -135,7 +135,7 @@ It's implementation defined which type ``SequenceContainerOrView`` represents. .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`lambda.size() \leq 1` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst index 093041366..948a4c695 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst @@ -34,7 +34,7 @@ class r250 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class r250 { public: static constexpr std::uint32_t default_seed = 1; @@ -92,7 +92,7 @@ class r250 .. rubric:: Input Parameters queue - Valid sycl::queue object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume :math:`x_{-250} = seed`. If :math:`seed = 0`, assume :math:`seed = 1`. Other values in state are initialized according to recurrent correlation :math:`x_{n+1} = 69069x_{n}(mod \ 2 ^ {32})`. Then the values :math:`x_{7k-247}, k = 0, 1, ..., 31` are interpreted as a binary matrix of size 32 x 32 and diagonal bits are set to 0, the under-diagonal bits to 0. @@ -108,7 +108,7 @@ class r250 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst index 03497d5f9..76d584622 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst @@ -13,7 +13,7 @@ Class is used for generation of Rayleigh distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The Rayleigh distribution is a special case of the :ref:`onemath_rng_weibull` distribution, where the shape parameter `\alpha` = 2 . @@ -38,7 +38,7 @@ class rayleigh .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class rayleigh { public: @@ -64,12 +64,12 @@ class rayleigh .. container:: section - typename Method = oneapi::mkl::rng::rayleigh_method::by_default + typename Method = oneapi::math::rng::rayleigh_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::rayleigh_method::by_default`` - * ``oneapi::mkl::rng::rayleigh_method::icdf`` - * ``oneapi::mkl::rng::rayleigh_method::icdf_accurate`` + * ``oneapi::math::rng::rayleigh_method::by_default`` + * ``oneapi::math::rng::rayleigh_method::icdf`` + * ``oneapi::math::rng::rayleigh_method::icdf_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -155,7 +155,7 @@ class rayleigh .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`b \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst index 4310acb27..770d82d03 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst @@ -45,7 +45,7 @@ class sfmt19937 .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class sfmt19937 { public: static constexpr std::uint32_t default_seed = 1; @@ -103,7 +103,7 @@ class sfmt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. @@ -119,7 +119,7 @@ class sfmt19937 .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst index fe8bfb815..dc6c616a7 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst @@ -13,7 +13,7 @@ Proceed state of engine by the skip-ahead method. .. rubric:: Description and Assumptions -oneapi::mkl::rng::skip_ahead function changes the current state of the engine so that with the further call of the generator the output subsequence begins with the specified offset see `Figure "Block-Splitting Method" <#rng_block_splitting>`__. +oneapi::math::rng::skip_ahead function changes the current state of the engine so that with the further call of the generator the output subsequence begins with the specified offset see `Figure "Block-Splitting Method" <#rng_block_splitting>`__. .. container:: figtop :name: rng_block_splitting @@ -31,7 +31,7 @@ skip_ahead .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template void skip_ahead(EngineType& engine, std::uint64_t num_to_skip); } @@ -58,15 +58,15 @@ skip_ahead .. code-block:: cpp // Creating 3 identical engines - oneapi::mkl::rng::mcg31m1 engine_1(queue, seed); - oneapi::mkl::rng::mcg31m1 engine_2(engine_1); - oneapi::mkl::rng::mcg31m1 engine_3(engine_2); + oneapi::math::rng::mcg31m1 engine_1(queue, seed); + oneapi::math::rng::mcg31m1 engine_2(engine_1); + oneapi::math::rng::mcg31m1 engine_3(engine_2); // Skipping ahead by 7 elements the 2nd engine - oneapi::mkl::rng::skip_ahead(engine_2, 7); + oneapi::math::rng::skip_ahead(engine_2, 7); // Skipping ahead by 14 elements the 3rd engine - oneapi::mkl::rng::skip_ahead(engine_3, 14); + oneapi::math::rng::skip_ahead(engine_3, 14); .. _onemath_rng_skip_ahead_ex: @@ -78,9 +78,9 @@ skip_ahead (Interface with a partitioned number of skipped elements) .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template - void oneapi::mkl::rng::skip_ahead(EngineType& engine, std::initializer_list num_to_skip); + void oneapi::math::rng::skip_ahead(EngineType& engine, std::initializer_list num_to_skip); } .. container:: section @@ -105,15 +105,15 @@ skip_ahead (Interface with a partitioned number of skipped elements) .. code-block:: cpp // Creating the first engine - oneapi::mkl::rng::mrg32k3a engine_1(queue, seed); + oneapi::math::rng::mrg32k3a engine_1(queue, seed); // To skip 2^64 elements in the random stream number of skipped elements should be // represented as num_to_skip = 2^64 = 0 + 1 * 2^64 std::initializer_list num_to_skip = {0, 1}; // Creating the 2nd engine based on 1st. Skipping by 2^64 - oneapi::mkl::rng::mrg32k3a engine_2(engine_1); - oneapi::mkl::rng::skip_ahead(engine_2, num_to_skip); + oneapi::math::rng::mrg32k3a engine_2(engine_1); + oneapi::math::rng::skip_ahead(engine_2, num_to_skip); **Parent topic:** :ref:`onemath_rng_service_routines` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst index 5a562181f..4fb71cdf7 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst @@ -35,7 +35,7 @@ class sobol .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class sobol { public: static constexpr std::uint32_t default_dimensions_number = 1; @@ -93,7 +93,7 @@ class sobol .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. dimensions Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 40`, assume :math:`dimen = 1`. @@ -109,7 +109,7 @@ class sobol .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. direction_numbers If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own direction_numbers. The number of dimensions corresponds to direction_numbers.size() / 32. diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst index a1b04cc5e..092080977 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst @@ -13,7 +13,7 @@ Class is used for generation of uniformly distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the interval, respectively, and :math:`a, b \in R; a < b` The probability distribution is given by: @@ -38,7 +38,7 @@ class uniform .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class uniform { public: @@ -64,12 +64,12 @@ class uniform .. container:: section - typename Method = oneapi::mkl::rng::uniform_method::by_default + typename Method = oneapi::math::rng::uniform_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::uniform_method::by_default`` - * ``oneapi::mkl::rng::uniform_method::standard`` - * ``oneapi::mkl::rng::uniform_method::accurate`` + * ``oneapi::math::rng::uniform_method::by_default`` + * ``oneapi::math::rng::uniform_method::standard`` + * ``oneapi::math::rng::uniform_method::accurate`` See description of the methods in :ref:`Distributions methods template parameter` @@ -155,7 +155,7 @@ class uniform .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`a \ge b` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst index 220336705..bdbff1c9f 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst @@ -13,7 +13,7 @@ Class is used for generation of uniformly distributed integer types random numbe .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the interval, respectively, and :math:`a, b \in R; a < b`. The probability distribution is given by: @@ -38,7 +38,7 @@ class uniform .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class uniform { public: @@ -57,11 +57,11 @@ class uniform .. container:: section - typename Method = oneapi::mkl::rng::uniform_method::by_default + typename Method = oneapi::math::rng::uniform_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::uniform_method::by_default`` - * ``oneapi::mkl::rng::uniform_method::standard`` + * ``oneapi::math::rng::uniform_method::by_default`` + * ``oneapi::math::rng::uniform_method::standard`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -147,7 +147,7 @@ class uniform .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`a \ge b` .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst index b82d76ba3..748c16a31 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst @@ -13,7 +13,7 @@ Class is used for generation of uniformly distributed bits in 32/64-bit chunks. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. class uniform_bits ------------------ @@ -22,7 +22,7 @@ class uniform_bits .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class uniform_bits { public: diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst index 6ccf2a63b..bb2ce4cd6 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst @@ -13,7 +13,7 @@ Class is used for generation of Weibull distributed real types random numbers. .. rubric:: Description -The class object is used in the :ref:`oneapi::mkl::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. The probability distribution is given by: @@ -36,7 +36,7 @@ class weibull .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { template class weibull { public: @@ -63,12 +63,12 @@ class weibull .. container:: section - typename Method = oneapi::mkl::rng::weibull_method::by_default + typename Method = oneapi::math::rng::weibull_method::by_default Transformation method, which will be used for generation. Supported types: - * ``oneapi::mkl::rng::weibull_method::by_default`` - * ``oneapi::mkl::rng::weibull_method::icdf`` - * ``oneapi::mkl::rng::weibull_method::icdf_accurate`` + * ``oneapi::math::rng::weibull_method::by_default`` + * ``oneapi::math::rng::weibull_method::icdf`` + * ``oneapi::math::rng::weibull_method::icdf_accurate`` See description of the methods in :ref:`Distributions methods template parameter`. @@ -156,7 +156,7 @@ class weibull .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst index 0f90272f9..cc44cf4c4 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst @@ -41,7 +41,7 @@ class wichmann_hill .. code-block:: cpp - namespace oneapi::mkl::rng { + namespace oneapi::math::rng { class wichmann_hill { public: static constexpr std::uint32_t default_seed = 1; @@ -107,7 +107,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -123,7 +123,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. @@ -135,7 +135,7 @@ class wichmann_hill .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`idx > 273` .. _`wichmann_hill(sycl::queue& queue, std::initializer_list seed)`: @@ -149,7 +149,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume: @@ -177,7 +177,7 @@ class wichmann_hill .. rubric:: Input Parameters queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::mkl::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. seed The initial conditions of the generator state, assume: diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst index cca8f0217..571d120c5 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst @@ -27,17 +27,17 @@ Buffer-based example .. code-block:: cpp - #include "oneapi/mkl/rng.hpp" + #include "oneapi/math/rng.hpp" int main() { sycl::queue q; // Create the random number generator object - oneapi::mkl::rng::philox4x32x10 engine(q, seed); + oneapi::math::rng::philox4x32x10 engine(q, seed); // Create the distribution object - oneapi::mkl::rng::gaussian distr(5.0, 2.0); + oneapi::math::rng::gaussian distr(5.0, 2.0); // Fill the SYCL buffer with random numbers - oneapi::mkl::rng::generate(distr, engine, n, sycl_buffer); + oneapi::math::rng::generate(distr, engine, n, sycl_buffer); // ... } @@ -48,17 +48,17 @@ USM-based example .. code-block:: cpp - #include "oneapi/mkl/rng.hpp" + #include "oneapi/math/rng.hpp" int main() { sycl::queue q; // Create the random number generator object - oneapi::mkl::rng::philox4x32x10 engine(q, seed); + oneapi::math::rng::philox4x32x10 engine(q, seed); // Create the distribution object - oneapi::mkl::rng::gaussian distr(5.0, 2.0); + oneapi::math::rng::gaussian distr(5.0, 2.0); // Fill the USM memory under the pointer with random numbers - auto event = oneapi::mkl::rng::generate(distr, engine, n, usm_ptr); + auto event = oneapi::math::rng::generate(distr, engine, n, usm_ptr); // ... // wait until generation is finalized event.wait(); diff --git a/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst b/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst index 15ff3eab1..1afd22fdb 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/data_handles.rst @@ -16,7 +16,7 @@ Dense vector handle .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct dense_vector_handle; using dense_vector_handle_t = dense_vector_handle*; @@ -46,7 +46,7 @@ Dense matrix handle .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct dense_matrix_handle; using dense_matrix_handle_t = dense_matrix_handle*; @@ -76,7 +76,7 @@ Sparse matrix handle .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct matrix_handle; using matrix_handle_t = matrix_handle*; diff --git a/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst index c980afc7c..4c6c9cf1e 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_coo_matrix.rst @@ -11,7 +11,7 @@ Initializes a ``matrix_handle_t`` object with the provided COO data. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::init_coo_matrix`` function initializes the +The ``oneapi::math::sparse::init_coo_matrix`` function initializes the ``matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -21,7 +21,7 @@ with ``set_coo_matrix_data``. In the case of USM, the object does not take ownership of the data. -The ``oneapi::mkl::sparse::init_coo_matrix`` function defined below takes in the +The ``oneapi::math::sparse::init_coo_matrix`` function defined below takes in the number of non-zero elements in the sparse matrix as an argument. However, in certain math operations where the output is a sparse matrix, e.g., sparse matrix addition (sparse matrix + sparse matrix = sparse matrix), and multiplication of @@ -42,11 +42,11 @@ init_coo_matrix (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_coo_matrix (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t *p_smhandle, + oneapi::math::sparse::matrix_handle_t *p_smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -134,10 +134,10 @@ init_coo_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_init_coo_matrix_usm: @@ -148,11 +148,11 @@ init_coo_matrix (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_coo_matrix (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t *p_smhandle, + oneapi::math::sparse::matrix_handle_t *p_smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -243,9 +243,9 @@ init_coo_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst index e3c701c66..72e44d78c 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_csr_matrix.rst @@ -12,7 +12,7 @@ Initializes a ``matrix_handle_t`` object with the provided Compressed Sparse Row .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::init_csr_matrix`` function initializes the +The ``oneapi::math::sparse::init_csr_matrix`` function initializes the ``matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -22,7 +22,7 @@ with ``set_csr_matrix_data``. In the case of USM, the object does not take ownership of the data. -The ``oneapi::mkl::sparse::init_csr_matrix`` function defined below takes in the +The ``oneapi::math::sparse::init_csr_matrix`` function defined below takes in the number of non-zero elements in the sparse matrix as an argument. However, in certain math operations where the output is a sparse matrix, e.g., sparse matrix addition (sparse matrix + sparse matrix = sparse matrix), and multiplication of @@ -43,11 +43,11 @@ init_csr_matrix (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_csr_matrix (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t *p_smhandle, + oneapi::math::sparse::matrix_handle_t *p_smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -134,10 +134,10 @@ init_csr_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_init_csr_matrix_usm: @@ -148,11 +148,11 @@ init_csr_matrix (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_csr_matrix (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t *p_smhandle, + oneapi::math::sparse::matrix_handle_t *p_smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -242,9 +242,9 @@ init_csr_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst index 3b834dae6..e5a59424b 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_matrix.rst @@ -11,7 +11,7 @@ Initializes a ``dense_matrix_handle_t`` object with the provided data. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::init_dense_matrix`` function initializes the +The ``oneapi::math::sparse::init_dense_matrix`` function initializes the ``dense_matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ init_dense_matrix (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_dense_matrix (sycl::queue &queue, - oneapi::mkl::sparse::dense_matrix_handle_t *p_dmhandle, + oneapi::math::sparse::dense_matrix_handle_t *p_dmhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t ld, @@ -100,10 +100,10 @@ init_dense_matrix (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_init_dense_matrix_usm: @@ -114,11 +114,11 @@ init_dense_matrix (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_dense_matrix (sycl::queue &queue, - oneapi::mkl::sparse::dense_matrix_handle_t *p_dmhandle, + oneapi::math::sparse::dense_matrix_handle_t *p_dmhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t ld, @@ -183,9 +183,9 @@ init_dense_matrix (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst index f785688d2..4d72c1be1 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/init_dense_vector.rst @@ -11,7 +11,7 @@ Initializes a ``dense_vector_handle_t`` object with the provided data. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::init_dense_vector`` function initializes the +The ``oneapi::math::sparse::init_dense_vector`` function initializes the ``dense_vector_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ init_dense_vector (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_dense_vector (sycl::queue &queue, - oneapi::mkl::sparse::dense_vector_handle_t *p_dvhandle, + oneapi::math::sparse::dense_vector_handle_t *p_dvhandle, std::int64_t size, sycl::buffer val); @@ -85,10 +85,10 @@ init_dense_vector (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_init_dense_vector_usm: @@ -99,11 +99,11 @@ init_dense_vector (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void init_dense_vector (sycl::queue &queue, - oneapi::mkl::sparse::dense_vector_handle_t *p_dvhandle, + oneapi::math::sparse::dense_vector_handle_t *p_dvhandle, std::int64_t size, dataType *val); @@ -153,9 +153,9 @@ init_dense_vector (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst index 6f736e23f..69ab4e79c 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_matrix.rst @@ -11,7 +11,7 @@ Destroys a ``dense_matrix_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::release_dense_matrix`` function frees the resources +The ``oneapi::math::sparse::release_dense_matrix`` function frees the resources allocated for the handle. If a buffer was provided, its reference count is decremented. @@ -22,10 +22,10 @@ If a USM pointer was provided, the data is not free'd. .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_dense_matrix (sycl::queue &queue, - oneapi::mkl::sparse::dense_matrix_handle_t dmhandle, + oneapi::math::sparse::dense_matrix_handle_t dmhandle, const std::vector &dependencies = {}); } @@ -60,8 +60,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst index 5eea90af1..41bc6ffc1 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_dense_vector.rst @@ -11,7 +11,7 @@ Destroys a ``dense_vector_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::release_dense_vector`` function frees the resources +The ``oneapi::math::sparse::release_dense_vector`` function frees the resources allocated for the handle. If a buffer was provided, its reference count is decremented. @@ -22,10 +22,10 @@ If a USM pointer was provided, the data is not free'd. .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_dense_vector (sycl::queue &queue, - oneapi::mkl::sparse::dense_vector_handle_t dvhandle, + oneapi::math::sparse::dense_vector_handle_t dvhandle, const std::vector &dependencies = {}); } @@ -60,8 +60,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst b/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst index 0dffa6aba..7448e215e 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/release_sparse_matrix.rst @@ -11,7 +11,7 @@ Destroys a ``matrix_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::release_sparse_matrix`` function frees the resources +The ``oneapi::math::sparse::release_sparse_matrix`` function frees the resources allocated for the handle. If a buffer was provided, its reference count is decremented. @@ -22,10 +22,10 @@ If a USM pointer was provided, the data is not free'd. .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_sparse_matrix (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, const std::vector &dependencies = {}); } @@ -61,8 +61,8 @@ If a USM pointer was provided, the data is not free'd. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` \ No newline at end of file diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst index f9ef07239..832fa23d1 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_coo_matrix_data.rst @@ -11,7 +11,7 @@ Reset the data of a ``matrix_handle_t`` object with the provided COO data. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::set_coo_matrix_data`` function sets new data to the +The ``oneapi::math::sparse::set_coo_matrix_data`` function sets new data to the ``matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ set_coo_matrix_data (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_coo_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -116,10 +116,10 @@ set_coo_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_set_coo_matrix_data_usm: @@ -130,11 +130,11 @@ set_coo_matrix_data (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_coo_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -217,9 +217,9 @@ set_coo_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst index 22f237b72..49a13ac68 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_csr_matrix_data.rst @@ -11,7 +11,7 @@ Reset the data of a ``matrix_handle_t`` object with the provided CSR data. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::set_csr_matrix_data`` function sets new data to the +The ``oneapi::math::sparse::set_csr_matrix_data`` function sets new data to the ``matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ set_csr_matrix_data (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_csr_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -115,10 +115,10 @@ set_csr_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_set_csr_matrix_data_usm: @@ -129,11 +129,11 @@ set_csr_matrix_data (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_csr_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t nnz, @@ -215,9 +215,9 @@ set_csr_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst index 0a4ba2a45..fca0be2f2 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_matrix_data.rst @@ -11,7 +11,7 @@ Reset the data of a ``dense_matrix_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::set_dense_matrix_data`` function sets new data to the +The ``oneapi::math::sparse::set_dense_matrix_data`` function sets new data to the ``dense_matrix_handle_t`` object with the provided data. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ set_dense_matrix_data (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_dense_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::dense_matrix_handle_t dmhandle, + oneapi::math::sparse::dense_matrix_handle_t dmhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t ld, @@ -90,10 +90,10 @@ set_dense_matrix_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_set_dense_matrix_data_usm: @@ -104,11 +104,11 @@ set_dense_matrix_data (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_dense_matrix_data (sycl::queue &queue, - oneapi::mkl::sparse::dense_matrix_handle_t dmhandle, + oneapi::math::sparse::dense_matrix_handle_t dmhandle, std::int64_t num_rows, std::int64_t num_cols, std::int64_t ld, @@ -164,9 +164,9 @@ set_dense_matrix_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst index 37b0d0c8a..7b92e4ccd 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_dense_vector_data.rst @@ -11,7 +11,7 @@ Reset the data of a ``dense_vector_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::set_dense_vector_data`` function sets new data to the +The ``oneapi::math::sparse::set_dense_vector_data`` function sets new data to the ``dense_vector_handle_t`` object. In the case of buffers, the reference count of the provided buffer is @@ -32,11 +32,11 @@ set_dense_vector_data (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_dense_vector_data (sycl::queue &queue, - oneapi::mkl::sparse::dense_vector_handle_t dvhandle, + oneapi::math::sparse::dense_vector_handle_t dvhandle, std::int64_t size, sycl::buffer val); @@ -75,10 +75,10 @@ set_dense_vector_data (Buffer version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_set_dense_vector_data_usm: @@ -89,11 +89,11 @@ set_dense_vector_data (USM version) .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { template void set_dense_vector_data (sycl::queue &queue, - oneapi::mkl::sparse::dense_vector_handle_t dvhandle, + oneapi::math::sparse::dense_vector_handle_t dvhandle, std::int64_t size, dataType *val); @@ -134,9 +134,9 @@ set_dense_vector_data (USM version) implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst index 82db60a23..b06d5674a 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst @@ -14,7 +14,7 @@ Matrix properties .. code:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { enum class matrix_property { symmetric, @@ -82,17 +82,17 @@ Set a property to a ``matrix_handle_t`` object. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::set_matrix_property`` function sets a property to a +The ``oneapi::math::sparse::set_matrix_property`` function sets a property to a matrix handle. .. rubric:: Syntax .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { bool set_matrix_property (sycl::queue &queue, - oneapi::mkl::sparse::matrix_handle_t smhandle, + oneapi::math::sparse::matrix_handle_t smhandle, matrix_property property); } @@ -126,9 +126,9 @@ matrix handle. implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_sparse_data_handles` diff --git a/source/elements/oneMath/source/domains/spblas/matrix_view.rst b/source/elements/oneMath/source/domains/spblas/matrix_view.rst index a4b527bba..e7f9e8c6e 100644 --- a/source/elements/oneMath/source/domains/spblas/matrix_view.rst +++ b/source/elements/oneMath/source/domains/spblas/matrix_view.rst @@ -16,7 +16,7 @@ matrix_descr .. code:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { enum class matrix_descr { general, @@ -60,7 +60,7 @@ matrix_view .. code:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct matrix_view { matrix_descr type_view = matrix_descr::general; @@ -91,7 +91,7 @@ matrix_view .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { matrix_view::matrix_view () = default; @@ -108,7 +108,7 @@ matrix_view .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { matrix_view::matrix_view(matrix_descr type_view); diff --git a/source/elements/oneMath/source/domains/spblas/operations/spmm.rst b/source/elements/oneMath/source/domains/spblas/operations/spmm.rst index 1fcd3a673..4b9366fa9 100644 --- a/source/elements/oneMath/source/domains/spblas/operations/spmm.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spmm.rst @@ -11,7 +11,7 @@ Computes a sparse matrix by dense matrix product. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::spmm`` routine computes a sparse matrix by dense +The ``oneapi::math::sparse::spmm`` routine computes a sparse matrix by dense matrix product defined as: .. math:: @@ -28,9 +28,9 @@ matrix product defined as: .. math:: - \text{op}(A) = \begin{cases} A,& \text{oneapi::mkl::transpose::nontrans}\\ - A^\mathsf{T},& \text{oneapi::mkl::transpose::trans}\\ - A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} + \text{op}(A) = \begin{cases} A,& \text{oneapi::math::transpose::nontrans}\\ + A^\mathsf{T},& \text{oneapi::math::transpose::trans}\\ + A^\mathsf{H},& \text{oneapi::math::transpose::conjtrans} \end{cases} .. _onemath_sparse_spmm_descr: @@ -42,7 +42,7 @@ spmm_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct spmm_descr; using spmm_descr_t = spmm_descr*; @@ -68,10 +68,10 @@ init_spmm_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void init_spmm_descr (sycl::queue &queue, - oneapi::mkl::sparse::spmm_descr_t *p_spmm_descr); + oneapi::math::sparse::spmm_descr_t *p_spmm_descr); } @@ -103,10 +103,10 @@ init_spmm_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_release_spmm_descr: @@ -117,10 +117,10 @@ release_spmm_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_spmm_descr (sycl::queue &queue, - oneapi::mkl::sparse::spmm_descr_t spmm_descr, + oneapi::math::sparse::spmm_descr_t spmm_descr, const std::vector &dependencies = {}); } @@ -155,9 +155,9 @@ release_spmm_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_spmm_alg: @@ -168,7 +168,7 @@ spmm_alg .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { enum class spmm_alg { default_alg, @@ -204,63 +204,63 @@ spmm .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void spmm_buffer_size( sycl::queue &queue, - oneapi::mkl::transpose opA, - oneapi::mkl::transpose opB, + oneapi::math::transpose opA, + oneapi::math::transpose opB, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_matrix_handle_t B_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_matrix_handle_t B_handle, const void* beta, - oneapi::mkl::sparse::dense_matrix_handle_t C_handle, - oneapi::mkl::sparse::spmm_alg alg, - oneapi::mkl::sparse::spmm_descr_t spmm_descr, + oneapi::math::sparse::dense_matrix_handle_t C_handle, + oneapi::math::sparse::spmm_alg alg, + oneapi::math::sparse::spmm_descr_t spmm_descr, std::size_t &temp_buffer_size); void spmm_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, - oneapi::mkl::transpose opB, + oneapi::math::transpose opA, + oneapi::math::transpose opB, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_matrix_handle_t B_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_matrix_handle_t B_handle, const void* beta, - oneapi::mkl::sparse::dense_matrix_handle_t C_handle, - oneapi::mkl::sparse::spmm_alg alg, - oneapi::mkl::sparse::spmm_descr_t spmm_descr, + oneapi::math::sparse::dense_matrix_handle_t C_handle, + oneapi::math::sparse::spmm_alg alg, + oneapi::math::sparse::spmm_descr_t spmm_descr, sycl::buffer workspace); sycl::event spmm_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, - oneapi::mkl::transpose opB, + oneapi::math::transpose opA, + oneapi::math::transpose opB, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_matrix_handle_t B_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_matrix_handle_t B_handle, const void* beta, - oneapi::mkl::sparse::dense_matrix_handle_t C_handle, - oneapi::mkl::sparse::spmm_alg alg, - oneapi::mkl::sparse::spmm_descr_t spmm_descr, + oneapi::math::sparse::dense_matrix_handle_t C_handle, + oneapi::math::sparse::spmm_alg alg, + oneapi::math::sparse::spmm_descr_t spmm_descr, void* workspace, const std::vector &dependencies = {}); sycl::event spmm( sycl::queue &queue, - oneapi::mkl::transpose opA, - oneapi::mkl::transpose opB, + oneapi::math::transpose opA, + oneapi::math::transpose opB, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_matrix_handle_t B_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_matrix_handle_t B_handle, const void* beta, - oneapi::mkl::sparse::dense_matrix_handle_t C_handle, - oneapi::mkl::sparse::spmm_alg alg, - oneapi::mkl::sparse::spmm_descr_t spmm_descr, + oneapi::math::sparse::dense_matrix_handle_t C_handle, + oneapi::math::sparse::spmm_alg alg, + oneapi::math::sparse::spmm_descr_t spmm_descr, const std::vector &dependencies = {}); } @@ -276,10 +276,10 @@ spmm - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spmm_buffer_size`` or ``spmm_optimize`` at least once with a given descriptor will throw an - :ref:`oneapi::mkl::uninitialized` + :ref:`oneapi::math::uninitialized` exception. Calling ``spmm`` with arguments not matching ``spmm_optimize`` will throw a - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` exception, unless stated otherwise. - The data of the dense handles ``B_handle`` and ``C_handle`` and the scalars ``alpha`` and ``beta`` can be reset before each call to ``spmm``. Changing @@ -387,11 +387,11 @@ spmm implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::computation_error` + | :ref:`oneapi::math::device_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMath/source/domains/spblas/operations/spmv.rst b/source/elements/oneMath/source/domains/spblas/operations/spmv.rst index 378326612..2580c6e8b 100644 --- a/source/elements/oneMath/source/domains/spblas/operations/spmv.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spmv.rst @@ -11,7 +11,7 @@ Computes a sparse matrix by dense vector product. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::spmv`` routine computes a sparse matrix by dense +The ``oneapi::math::sparse::spmv`` routine computes a sparse matrix by dense vector product defined as: .. math:: @@ -28,9 +28,9 @@ vector product defined as: .. math:: - \text{op}(A) = \begin{cases} A,& \text{oneapi::mkl::transpose::nontrans}\\ - A^\mathsf{T},& \text{oneapi::mkl::transpose::trans}\\ - A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} + \text{op}(A) = \begin{cases} A,& \text{oneapi::math::transpose::nontrans}\\ + A^\mathsf{T},& \text{oneapi::math::transpose::trans}\\ + A^\mathsf{H},& \text{oneapi::math::transpose::conjtrans} \end{cases} .. _onemath_sparse_spmv_descr: @@ -42,7 +42,7 @@ spmv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct spmv_descr; using spmv_descr_t = spmv_descr*; @@ -68,10 +68,10 @@ init_spmv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void init_spmv_descr (sycl::queue &queue, - oneapi::mkl::sparse::spmv_descr_t *p_spmv_descr); + oneapi::math::sparse::spmv_descr_t *p_spmv_descr); } @@ -103,10 +103,10 @@ init_spmv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_release_spmv_descr: @@ -117,10 +117,10 @@ release_spmv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_spmv_descr (sycl::queue &queue, - oneapi::mkl::sparse::spmv_descr_t spmv_descr, + oneapi::math::sparse::spmv_descr_t spmv_descr, const std::vector &dependencies = {}); } @@ -155,9 +155,9 @@ release_spmv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_spmv_alg: @@ -168,7 +168,7 @@ spmv_alg .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { enum class spmv_alg { default_alg, @@ -202,59 +202,59 @@ spmv .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void spmv_buffer_size( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, const void* beta, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spmv_alg alg, - oneapi::mkl::sparse::spmv_descr_t spmv_descr, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spmv_alg alg, + oneapi::math::sparse::spmv_descr_t spmv_descr, std::size_t &temp_buffer_size); void spmv_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, const void* beta, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spmv_alg alg, - oneapi::mkl::sparse::spmv_descr_t spmv_descr, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spmv_alg alg, + oneapi::math::sparse::spmv_descr_t spmv_descr, sycl::buffer workspace); sycl::event spmv_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, const void* beta, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spmv_alg alg, - oneapi::mkl::sparse::spmv_descr_t spmv_descr, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spmv_alg alg, + oneapi::math::sparse::spmv_descr_t spmv_descr, void* workspace, const std::vector &dependencies = {}); sycl::event spmv( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, const void* beta, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spmv_alg alg, - oneapi::mkl::sparse::spmv_descr_t spmv_descr, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spmv_alg alg, + oneapi::math::sparse::spmv_descr_t spmv_descr, const std::vector &dependencies = {}); } @@ -270,10 +270,10 @@ spmv - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spmv_buffer_size`` or ``spmv_optimize`` at least once with a given descriptor will throw an - :ref:`oneapi::mkl::uninitialized` + :ref:`oneapi::math::uninitialized` exception. Calling ``spmv`` with arguments not matching ``spmv_optimize`` will throw a - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` exception, unless stated otherwise. - The data of the dense handles ``x_handle`` and ``y_handle`` and the scalars ``alpha`` and ``beta`` can be reset before each call to ``spmv``. Changing @@ -377,11 +377,11 @@ spmv implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::computation_error` + | :ref:`oneapi::math::device_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMath/source/domains/spblas/operations/spsv.rst b/source/elements/oneMath/source/domains/spblas/operations/spsv.rst index 0c19783da..4d1d743fb 100644 --- a/source/elements/oneMath/source/domains/spblas/operations/spsv.rst +++ b/source/elements/oneMath/source/domains/spblas/operations/spsv.rst @@ -12,7 +12,7 @@ triangular sparse matrix. .. rubric:: Description and Assumptions -The ``oneapi::mkl::sparse::spsv`` routine solves a system of linear equations +The ``oneapi::math::sparse::spsv`` routine solves a system of linear equations for a square matrix: .. math:: @@ -28,9 +28,9 @@ for a square matrix: .. math:: - \text{op}(A) = \begin{cases} A,& \text{oneapi::mkl::transpose::nontrans}\\ - A^\mathsf{T},& \text{oneapi::mkl::transpose::trans}\\ - A^\mathsf{H},& \text{oneapi::mkl::transpose::conjtrans} + \text{op}(A) = \begin{cases} A,& \text{oneapi::math::transpose::nontrans}\\ + A^\mathsf{T},& \text{oneapi::math::transpose::trans}\\ + A^\mathsf{H},& \text{oneapi::math::transpose::conjtrans} \end{cases} .. _onemath_sparse_spsv_descr: @@ -42,7 +42,7 @@ spsv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { struct spsv_descr; using spsv_descr_t = spsv_descr*; @@ -68,10 +68,10 @@ init_spsv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void init_spsv_descr (sycl::queue &queue, - oneapi::mkl::sparse::spsv_descr_t *p_spsv_descr); + oneapi::math::sparse::spsv_descr_t *p_spsv_descr); } @@ -103,10 +103,10 @@ init_spsv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::host_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::host_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_release_spsv_descr: @@ -117,10 +117,10 @@ release_spsv_descr .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { sycl::event release_spsv_descr (sycl::queue &queue, - oneapi::mkl::sparse::spsv_descr_t spsv_descr, + oneapi::math::sparse::spsv_descr_t spsv_descr, const std::vector &dependencies = {}); } @@ -155,9 +155,9 @@ release_spsv_descr implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::unsupported_device` .. _onemath_sparse_spsv_alg: @@ -168,7 +168,7 @@ spsv_alg .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { enum class spsv_alg { default_alg, @@ -197,55 +197,55 @@ spsv .. code-block:: cpp - namespace oneapi::mkl::sparse { + namespace oneapi::math::sparse { void spsv_buffer_size( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spsv_alg alg, - oneapi::mkl::sparse::spsv_descr_t spsv_descr, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spsv_alg alg, + oneapi::math::sparse::spsv_descr_t spsv_descr, std::size_t &temp_buffer_size); void spsv_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spsv_alg alg, - oneapi::mkl::sparse::spsv_descr_t spsv_descr, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spsv_alg alg, + oneapi::math::sparse::spsv_descr_t spsv_descr, sycl::buffer workspace); sycl::event spsv_optimize( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spsv_alg alg, - oneapi::mkl::sparse::spsv_descr_t spsv_descr, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spsv_alg alg, + oneapi::math::sparse::spsv_descr_t spsv_descr, void* workspace, const std::vector &dependencies = {}); sycl::event spsv( sycl::queue &queue, - oneapi::mkl::transpose opA, + oneapi::math::transpose opA, const void* alpha, - oneapi::mkl::sparse::matrix_view A_view, - oneapi::mkl::sparse::matrix_handle_t A_handle, - oneapi::mkl::sparse::dense_vector_handle_t x_handle, - oneapi::mkl::sparse::dense_vector_handle_t y_handle, - oneapi::mkl::sparse::spsv_alg alg, - oneapi::mkl::sparse::spsv_descr_t spsv_descr, + oneapi::math::sparse::matrix_view A_view, + oneapi::math::sparse::matrix_handle_t A_handle, + oneapi::math::sparse::dense_vector_handle_t x_handle, + oneapi::math::sparse::dense_vector_handle_t y_handle, + oneapi::math::sparse::spsv_alg alg, + oneapi::math::sparse::spsv_descr_t spsv_descr, const std::vector &dependencies = {}); } @@ -261,10 +261,10 @@ spsv - In the general case, not calling the functions in the order specified above is undefined behavior. Not calling ``spsv_buffer_size`` or ``spsv_optimize`` at least once with a given descriptor will throw a - :ref:`oneapi::mkl::uninitialized` + :ref:`oneapi::math::uninitialized` exception. Calling ``spsv`` with arguments not matching ``spsv_optimize`` will throw an - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` exception, unless stated otherwise. - The data of the dense handle ``x_handle`` and scalar ``alpha`` can be reset before each call to ``spsv``. Changing the data of the sparse handle @@ -357,11 +357,11 @@ spsv implementation-specific exception(s) in case of error conditions not covered here. - | :ref:`oneapi::mkl::computation_error` - | :ref:`oneapi::mkl::device_bad_alloc` - | :ref:`oneapi::mkl::invalid_argument` - | :ref:`oneapi::mkl::unimplemented` - | :ref:`oneapi::mkl::uninitialized` - | :ref:`oneapi::mkl::unsupported_device` + | :ref:`oneapi::math::computation_error` + | :ref:`oneapi::math::device_bad_alloc` + | :ref:`oneapi::math::invalid_argument` + | :ref:`oneapi::math::unimplemented` + | :ref:`oneapi::math::uninitialized` + | :ref:`oneapi::math::unsupported_device` **Parent topic:** :ref:`onemath_spblas` diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst index 99c3cea3f..4a88ec7c2 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment.rst @@ -13,7 +13,7 @@ Entry point to compute central moments up to the 4th order. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension). +The oneapi::math::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension). :ref:`onemath_stats_central_moment` supports the following precisions for data: @@ -34,8 +34,8 @@ central_moment (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { - template void central_moment(sycl::queue& queue, const dataset>& data, @@ -51,8 +51,8 @@ central_moment (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -87,7 +87,7 @@ central_moment (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_moment_2.get_count() == 0 & central_moment_3.get_count() == 0 & central_moment_4.get_count() == 0, or dataset object is invalid .. _onemath_stats_central_moment_usm: @@ -100,7 +100,7 @@ central_moment (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event central_moment(sycl::queue& queue, const dataset& data, Type* central_moment_2, @@ -115,8 +115,8 @@ central_moment (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -155,7 +155,7 @@ central_moment (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_moment_2 == nullptr & central_moment_3 == nullptr & central_moment_4 == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst index 69157e915..7288feda4 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_moment_user_mean.rst @@ -13,7 +13,7 @@ Entry point to compute central moments up to the 4th order with the provided mea .. rubric:: Description and Assumptions -The oneapi::mkl::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension) with the provided mean values. +The oneapi::math::stats::central_moment function is used to compute an array of central moments up to the 4th order (central moments for each dataset's dimension) with the provided mean values. :ref:`onemath_stats_central_moment_user_mean` supports the following precisions for data: @@ -34,7 +34,7 @@ central_moment with provided mean (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void central_moment(sycl::queue& queue, sycl::buffer mean, @@ -51,7 +51,7 @@ central_moment with provided mean (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -89,7 +89,7 @@ central_moment with provided mean (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_moment_2.get_count() == 0 & central_moment_3.get_count() == 0 & central_moment_4.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid @@ -102,7 +102,7 @@ central_moment with provided mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event central_moment(sycl::queue& queue, Type* mean, @@ -120,7 +120,7 @@ central_moment with provided mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -161,7 +161,7 @@ central_moment with provided mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_moment_2 == nullptr & central_moment_3 == nullptr & central_moment_4 == nullptr or mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst index c5fb82427..ccce90f45 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum.rst @@ -13,7 +13,7 @@ Entry point to compute central sums up to the 4th order. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension). +The oneapi::math::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension). :ref:`onemath_stats_central_sum` supports the following precisions for data: @@ -34,7 +34,7 @@ central_sum (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void central_sum(sycl::queue& queue, const dataset>& data, @@ -50,8 +50,8 @@ central_sum (Buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -86,7 +86,7 @@ central_sum (Buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_sum_2.get_count() == 0 & central_sum_3.get_count() == 0 & central_sum_4.get_count() == 0, or dataset object is invalid .. _onemath_stats_central_sum_usm: @@ -98,7 +98,7 @@ central_sum (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event central_sum( sycl::queue& queue, @@ -116,8 +116,8 @@ central_sum (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -155,7 +155,7 @@ central_sum (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_sum_2 == nullptr & central_sum_3 == nullptr & central_sum_4 == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst index 806d0cc7c..14b67f9af 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_central_sum_user_mean.rst @@ -13,7 +13,7 @@ Entry point to compute central sums up to the 4th order with the provided mean v .. rubric:: Description and Assumptions -The oneapi::mkl::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension) with the provided mean values. +The oneapi::math::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension) with the provided mean values. :ref:`onemath_stats_central_sum_user_mean` supports the following precisions for data: @@ -34,7 +34,7 @@ central_sum with provided mean (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void central_sum(sycl::queue& queue, sycl::buffer mean, @@ -51,7 +51,7 @@ central_sum with provided mean (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -89,7 +89,7 @@ central_sum with provided mean (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_sum_2.get_count() == 0 & central_sum_3.get_count() == 0 & central_sum_4.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid .. _onemath_stats_central_sum_user_mean_usm: @@ -101,7 +101,7 @@ central_sum with provided mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event central_sum(sycl::queue& queue, Type* mean, @@ -119,7 +119,7 @@ central_sum with provided mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -160,7 +160,7 @@ central_sum with provided mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when central_sum_2 == nullptr & central_sum_3 == nullptr & central_sum_4 == nullptr, or mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst index ade84873c..bba3d9d32 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_dataset.rst @@ -24,7 +24,7 @@ structure dataset (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template struct dataset> { @@ -56,11 +56,11 @@ structure dataset (Buffer version) .. container:: section - oneapi::mkl::stats::layout ObservationsLayout + oneapi::math::stats::layout ObservationsLayout Type of the multi-dimensional data layout. Supported types: - * ``oneapi::mkl::stats::layout::row_major`` - * ``oneapi::mkl::stats::layout::col_major`` + * ``oneapi::math::stats::layout::row_major`` + * ``oneapi::math::stats::layout::col_major`` .. container:: section @@ -106,7 +106,7 @@ structure dataset (Buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `n_dims_` :math:`\leq 0`, or `n_observations_` :math:`\leq 0`, or `observations_.get_count() == 0` .. _onemath_stats_dataset_syntax_usm: @@ -118,7 +118,7 @@ structure dataset (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template struct dataset { explicit dataset(std::int64_t n_dims_, std::int64_t n_observations_, Type* observations_, @@ -148,11 +148,11 @@ structure dataset (USM version) .. container:: section - oneapi::mkl::stats::layout ObservationsLayout + oneapi::math::stats::layout ObservationsLayout Type of the multi-dimensional data layout. Supported types: - * ``oneapi::mkl::stats::layout::row_major`` - * ``oneapi::mkl::stats::layout::col_major`` + * ``oneapi::math::stats::layout::row_major`` + * ``oneapi::math::stats::layout::col_major`` .. container:: section @@ -198,7 +198,7 @@ structure dataset (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when `n_dims_` :math:`\leq 0`, or `n_observations_` :math:`\leq 0`, or `observations_ == nullptr` **Parent topic:** :ref:`onemath_stats` diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst index 76babc5cf..3551c3c67 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis.rst @@ -13,7 +13,7 @@ Entry point to compute kurtosis. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::kurtosis function is used to compute a kurtosis array (kurtosis for each dataset's dimension). +The oneapi::math::stats::kurtosis function is used to compute a kurtosis array (kurtosis for each dataset's dimension). :ref:`onemath_stats_kurtosis` supports the following precisions for data: @@ -34,7 +34,7 @@ kurtosis (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void kurtosis(sycl::queue& queue, const dataset>& data, @@ -48,8 +48,8 @@ kurtosis (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -78,7 +78,7 @@ kurtosis (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when kurtosis.get_count() == 0, or dataset object is invalid .. _onemath_stats_kurtosis_usm: @@ -90,7 +90,7 @@ kurtosis (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event kurtosis(sycl::queue& queue, const dataset& data, @@ -105,8 +105,8 @@ kurtosis (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -138,7 +138,7 @@ kurtosis (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when kurtosis == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst index edaf83806..6d70aeb6b 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_kurtosis_user_mean.rst @@ -13,7 +13,7 @@ Entry point to compute kurtosis with the provided mean values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::kurtosis function is used to compute an array of kurtosis (kurtosis for each dataset's dimension) with the provided mean values. +The oneapi::math::stats::kurtosis function is used to compute an array of kurtosis (kurtosis for each dataset's dimension) with the provided mean values. :ref:`onemath_stats_kurtosis_user_mean` supports the following precisions for data: @@ -34,12 +34,12 @@ kurtosis with provided mean (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template - void oneapi::mkl::stats::kurtosis(sycl::queue& queue, + void oneapi::math::stats::kurtosis(sycl::queue& queue, sycl::buffer mean, - const oneapi::mkl::stats::dataset, ObservationsLayout>& data, + const oneapi::math::stats::dataset, ObservationsLayout>& data, sycl::buffer kurtosis); } @@ -50,7 +50,7 @@ kurtosis with provided mean (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -82,7 +82,7 @@ kurtosis with provided mean (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when kurtosis.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid .. _onemath_stats_kurtosis_user_mean_usm: @@ -94,7 +94,7 @@ kurtosis with provided mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event kurtosis(sycl::queue& queue, Type* mean, @@ -110,7 +110,7 @@ kurtosis with provided mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -145,7 +145,7 @@ kurtosis with provided mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when kurtosis == nullptr, or mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst index e5aece656..0c42d69ed 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_make_dataset.rst @@ -13,7 +13,7 @@ Entry point to create a dataset from the provided parameters. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::make_dataset function is used to create a dataset from the provided storage of the observations matrix, the number of dimensions and observations, and other parameters. +The oneapi::math::stats::make_dataset function is used to create a dataset from the provided storage of the observations matrix, the number of dimensions and observations, and other parameters. :ref:`onemath_stats_make_dataset` supports the following precisions for data: @@ -34,7 +34,7 @@ make_dataset (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template dataset, ObservationsLayout> make_dataset( std::int64_t n_dims, @@ -77,7 +77,7 @@ make_dataset (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math: `n_dims \leq 0`, or :math: `n_observations \leq 0`, or observations.get_count() == 0 .. container:: section @@ -96,7 +96,7 @@ make_dataset (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template dataset make_dataset(std::nt64_t n_dims, std::int64_t n_observations, @@ -136,7 +136,7 @@ make_dataset (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when :math:`n\_dims \leq 0`, or :math:`n\_observations \leq 0`, or observations == nullptr .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst index 7192cf52f..48e3e88e6 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_max.rst @@ -13,7 +13,7 @@ Entry point to compute max values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::max function is used to compute a max values arrays (max value for each dataset's dimension). +The oneapi::math::stats::max function is used to compute a max values arrays (max value for each dataset's dimension). :ref:`onemath_stats_max` supports the following precisions for data: @@ -34,7 +34,7 @@ max (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void max(sycl::queue& queue, const dataset>& data, @@ -48,7 +48,7 @@ max (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -77,7 +77,7 @@ max (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when max.get_count() == 0, or dataset object is invalid .. _onemath_stats_max_usm: @@ -89,7 +89,7 @@ max (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event max(sycl::queue& queue, const dataset& data, @@ -104,7 +104,7 @@ max (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -136,7 +136,7 @@ max (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when max == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst index 54dc14615..993f06175 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_mean.rst @@ -13,7 +13,7 @@ Entry point to compute mean values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::mean function is used to compute a mean array (mean value for each dataset's dimension). +The oneapi::math::stats::mean function is used to compute a mean array (mean value for each dataset's dimension). :ref:`onemath_stats_mean` supports the following precisions for data: @@ -34,7 +34,7 @@ mean (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void mean(sycl::queue& queue, const dataset>& data, @@ -48,8 +48,8 @@ mean (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -78,7 +78,7 @@ mean (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when mean.get_count() == 0, or dataset object is invalid .. _onemath_stats_mean_usm: @@ -90,7 +90,7 @@ mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event mean(sycl::queue& queue, const dataset& data, @@ -105,8 +105,8 @@ mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -138,7 +138,7 @@ mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst index 12401792b..93c90d4ce 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_min.rst @@ -13,7 +13,7 @@ Entry point to compute min values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::min function is used to compute min arrays (min value for each dataset's dimension). +The oneapi::math::stats::min function is used to compute min arrays (min value for each dataset's dimension). :ref:`onemath_stats_min` supports the following precisions for data: @@ -34,7 +34,7 @@ min (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void min(sycl::queue& queue, const dataset>& data, @@ -48,7 +48,7 @@ min (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -77,7 +77,7 @@ min (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when min.get_count() == 0, or dataset object is invalid .. _onemath_stats_min_usm: @@ -89,7 +89,7 @@ min (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event min(sycl::queue& queue, const dataset& data, @@ -104,7 +104,7 @@ min (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -136,7 +136,7 @@ min (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when min == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst index e2908629e..23440e16d 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_min_max.rst @@ -13,7 +13,7 @@ Entry point to compute min and max values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::min_max function is used to compute min and max arrays (min and max values for each dataset's dimension). +The oneapi::math::stats::min_max function is used to compute min and max arrays (min and max values for each dataset's dimension). :ref:`onemath_stats_min_max` supports the following precisions for data: @@ -34,7 +34,7 @@ min_max (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void min_max(sycl::queue& queue, const dataset>& data, @@ -49,7 +49,7 @@ min_max (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -81,7 +81,7 @@ min_max (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when min.get_count() == 0, or max.get_count() == 0, or dataset object is invalid .. _onemath_stats_min_max_usm: @@ -93,7 +93,7 @@ min_max (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event min_max(sycl::queue& queue, const dataset& data, @@ -109,7 +109,7 @@ min_max (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -144,7 +144,7 @@ min_max (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when min == nullptr, or max == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst index 78dcc5138..c9575adf4 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst @@ -13,7 +13,7 @@ Entry point to compute raw moments up to the 4th order. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::raw_moment function is used to compute array of raw moments up to the 4th order (raw moments for each dataset's dimension). +The oneapi::math::stats::raw_moment function is used to compute array of raw moments up to the 4th order (raw moments for each dataset's dimension). :ref:`onemath_stats_raw_moment` supports the following precisions for data: @@ -27,14 +27,14 @@ The oneapi::mkl::stats::raw_moment function is used to compute array of raw mome .. _onemath_stats_raw_moment_buffer: -oneapi::mkl::stats::raw_moment (buffer version) +oneapi::math::stats::raw_moment (buffer version) ----------------------------------------------- .. rubric:: Syntax .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void raw_moment(sycl::queue& queue, const dataset>& data, @@ -51,8 +51,8 @@ oneapi::mkl::stats::raw_moment (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -90,7 +90,7 @@ oneapi::mkl::stats::raw_moment (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when mean.get_count() == 0 & raw_moment_2.get_count() == 0 & raw_moment_3.get_count() == 0 & raw_moment_4.get_count() == 0, or dataset object is invalid .. _onemath_stats_raw_moment_usm: @@ -102,7 +102,7 @@ raw_moment (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event raw_moment( sycl::queue& queue, @@ -121,8 +121,8 @@ raw_moment (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -163,7 +163,7 @@ raw_moment (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when mean == nullptr & raw_moment_2 == nullptr & raw_moment_3 == nullptr & raw_moment_4 == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst index 58817e3b7..dffe1ddf4 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_sum.rst @@ -13,7 +13,7 @@ Entry point to compute raw sums up to the 4th order. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::raw_sum function is used to compute an array of raw sums up to the 4th order (raw sums for each dataset's dimension). +The oneapi::math::stats::raw_sum function is used to compute an array of raw sums up to the 4th order (raw sums for each dataset's dimension). :ref:`onemath_stats_raw_sum` supports the following precisions for data: @@ -34,7 +34,7 @@ raw_sum (Buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void raw_sum(sycl::queue& queue, const dataset>& data, @@ -51,8 +51,8 @@ raw_sum (Buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -90,7 +90,7 @@ raw_sum (Buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when sum.get_count() == 0 & raw_sum_2.get_count() == 0 & raw_sum_3.get_count() == 0 & raw_sum_4.get_count() == 0, or dataset object is invalid .. _onemath_stats_raw_sum_usm: @@ -102,7 +102,7 @@ raw_sum (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event raw_sum(sycl::queue& queue, const dataset& data, @@ -120,8 +120,8 @@ raw_sum (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -162,7 +162,7 @@ raw_sum (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when sum == nullptr & raw_sum_2 == nullptr & raw_sum_3 == nullptr & raw_sum_4 == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst index cea6f4d96..7a03202da 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness.rst @@ -13,7 +13,7 @@ Entry point to compute skewness. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::skewness function is used to compute a skewness array (skewness for each dataset's dimension). +The oneapi::math::stats::skewness function is used to compute a skewness array (skewness for each dataset's dimension). :ref:`onemath_stats_skewness` supports the following precisions for data: @@ -34,7 +34,7 @@ skewness (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void skewness(sycl::queue& queue, const dataset>& data, @@ -48,8 +48,8 @@ skewness (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -78,7 +78,7 @@ skewness (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when skewness.get_count() == 0, or dataset object is invalid .. _onemath_stats_skewness_usm: @@ -90,7 +90,7 @@ skewness (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event skewness(sycl::queue& queue, const dataset& data, @@ -105,8 +105,8 @@ skewness (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -138,7 +138,7 @@ skewness (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when skewness == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst index 01514435e..94570e4df 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_skewness_user_mean.rst @@ -13,7 +13,7 @@ Entry point to compute skewness with the provided mean values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::skewness function is used to compute an array of skewness (skewness for each dataset's dimension) with the provided mean values. +The oneapi::math::stats::skewness function is used to compute an array of skewness (skewness for each dataset's dimension) with the provided mean values. :ref:`onemath_stats_skewness_user_mean` supports the following precisions for data: @@ -34,7 +34,7 @@ skewness with provided mean (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void skewness(sycl::queue& queue, sycl::buffer mean, @@ -49,7 +49,7 @@ skewness with provided mean (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -81,7 +81,7 @@ skewness with provided mean (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when skewness.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid .. _onemath_stats_skewness_user_mean_usm: @@ -93,7 +93,7 @@ skewness with provided mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event skewness(sycl::queue& queue, Type* mean, @@ -109,7 +109,7 @@ skewness with provided mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -144,7 +144,7 @@ skewness with provided mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when skewness == nullptr, or mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst index 4a244f619..a8b1d7057 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst @@ -25,7 +25,7 @@ USM-based example .. code-block:: cpp - #include "oneapi/mkl/stats.hpp" + #include "oneapi/math/stats.hpp" int main() { sycl::queue queue; @@ -36,11 +36,11 @@ USM-based example // allocate Unified Shared Memory for the dataset of the size n_observations * n_dims and fill it with any data // allocate Unified Shared Memory for the mean output of the size n_dims - // create oneapi::mkl::stats::dataset - auto dataset = oneapi::mkl::stats::make_dataset(n_dims, n_observations, dataset_ptr); + // create oneapi::math::stats::dataset + auto dataset = oneapi::math::stats::make_dataset(n_dims, n_observations, dataset_ptr); // call statistics computation routine - auto event = oneapi::mkl::stats::mean(queue, dataset, mean_ptr); + auto event = oneapi::math::stats::mean(queue, dataset, mean_ptr); // wait until computations are completed event.wait(); diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst index f5d1fb095..61b2d6b14 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_variation.rst @@ -13,7 +13,7 @@ Entry point to compute variation. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::variation function is used to compute a variation array (variation for each dataset's dimension). +The oneapi::math::stats::variation function is used to compute a variation array (variation for each dataset's dimension). :ref:`onemath_stats_variation` supports the following precisions for data: @@ -34,7 +34,7 @@ variation (buffer version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void variation(sycl::queue& queue, const dataset>& data, @@ -48,8 +48,8 @@ variation (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -78,7 +78,7 @@ variation (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when variation.get_count() == 0, or dataset object is invalid .. _onemath_stats_variation_usm: @@ -90,7 +90,7 @@ variation (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event variation(sycl::queue& queue, const dataset& data, @@ -105,8 +105,8 @@ variation (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` - * ``oneapi::mkl::stats::method::one_pass`` + * ``oneapi::math::stats::method::fast`` + * ``oneapi::math::stats::method::one_pass`` Type Data precision. @@ -138,7 +138,7 @@ variation (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when variation == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst index b678711b3..21271231f 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst @@ -13,7 +13,7 @@ Entry point to compute variation with the provided mean values. .. rubric:: Description and Assumptions -The oneapi::mkl::stats::variation function is used to compute an array of variation (variation for each dataset's dimension) with the provided mean values. +The oneapi::math::stats::variation function is used to compute an array of variation (variation for each dataset's dimension) with the provided mean values. :ref:`onemath_stats_variation_user_mean` supports the following precisions for data: @@ -27,14 +27,14 @@ The oneapi::mkl::stats::variation function is used to compute an array of variat .. _onemath_stats_variation_user_mean_buffer: -oneapi::mkl::stats::variation (buffer version) +oneapi::math::stats::variation (buffer version) ---------------------------------------------- .. rubric:: Syntax .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template void variation(sycl::queue& queue, sycl::buffer mean, const dataset>& data, @@ -48,7 +48,7 @@ oneapi::mkl::stats::variation (buffer version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -81,7 +81,7 @@ oneapi::mkl::stats::variation (buffer version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when variation.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid .. _onemath_stats_variation_user_mean_usm: @@ -93,7 +93,7 @@ variation with provided mean (USM version) .. code-block:: cpp - namespace oneapi::mkl::stats { + namespace oneapi::math::stats { template sycl::event variation(sycl::queue& queue, Type* mean, @@ -109,7 +109,7 @@ variation with provided mean (USM version) Method Method which is used for estimate computation. The specific values are as follows: - * ``oneapi::mkl::stats::method::fast`` + * ``oneapi::math::stats::method::fast`` Type Data precision. @@ -144,7 +144,7 @@ variation with provided mean (USM version) .. rubric:: Throws - oneapi::mkl::invalid_argument + oneapi::math::invalid_argument Exception is thrown when variation == nullptr, or mean == nullptr, or dataset object is invalid .. container:: section diff --git a/source/elements/oneMath/source/domains/value_or_pointer.rst b/source/elements/oneMath/source/domains/value_or_pointer.rst index 93fdacbb4..2cfaa626d 100644 --- a/source/elements/oneMath/source/domains/value_or_pointer.rst +++ b/source/elements/oneMath/source/domains/value_or_pointer.rst @@ -27,14 +27,14 @@ Scalar Arguments in BLAS float *alpha_ptr = sycl::malloc_shared(1, queue); float *beta_ptr = sycl::malloc_shared(1, queue); // fill alpha_ptr and beta_ptr with desired values - oneapi::mkl::blas::column_major::gemv(queue, trans, m, n, alpha_ptr, lda, x, incx, beta_ptr, + oneapi::math::blas::column_major::gemv(queue, trans, m, n, alpha_ptr, lda, x, incx, beta_ptr, y, incy).wait(); or with literal values: .. code-block:: - oneapi::mkl::blas::column_major::gemv(queue, trans, m, n, 2, lda, x, incx, 2.7, + oneapi::math::blas::column_major::gemv(queue, trans, m, n, 2, lda, x, incx, 2.7, y, incy).wait(); Users can even mix scalar and pointer parameters in a single call: @@ -42,7 +42,7 @@ Scalar Arguments in BLAS .. code-block:: float *alpha_ptr = sycl::malloc_shared(1, queue); - oneapi::mkl::blas::column_major::gemv(queue, trans, m, n, alpha_ptr, lda, x, incx, 2.7, + oneapi::math::blas::column_major::gemv(queue, trans, m, n, alpha_ptr, lda, x, incx, 2.7, y, incy).wait(); Pointers provided for scalar parameters may be SYCL-managed pointers diff --git a/source/elements/oneMath/source/domains/vm/abs.rst b/source/elements/oneMath/source/domains/vm/abs.rst index e0257a2ee..d51df9e28 100644 --- a/source/elements/oneMath/source/domains/vm/abs.rst +++ b/source/elements/oneMath/source/domains/vm/abs.rst @@ -27,16 +27,16 @@ abs .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event abs( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ abs .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event abs( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ abs const T *a, R* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -157,7 +157,7 @@ abs Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -183,7 +183,7 @@ abs Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/acos.rst b/source/elements/oneMath/source/domains/vm/acos.rst index d87bac147..50701280f 100644 --- a/source/elements/oneMath/source/domains/vm/acos.rst +++ b/source/elements/oneMath/source/domains/vm/acos.rst @@ -27,17 +27,17 @@ acos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acos( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ acos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acos( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ acos const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -110,13 +110,13 @@ acos -   * - \|a\| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -233,7 +233,7 @@ acos Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -266,7 +266,7 @@ acos Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/acosh.rst b/source/elements/oneMath/source/domains/vm/acosh.rst index daaa03a93..f05a17cc7 100644 --- a/source/elements/oneMath/source/domains/vm/acosh.rst +++ b/source/elements/oneMath/source/domains/vm/acosh.rst @@ -27,17 +27,17 @@ acosh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acosh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ acosh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acosh( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ acosh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -102,10 +102,10 @@ acosh -   * - a < +1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -225,7 +225,7 @@ acosh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -258,7 +258,7 @@ acosh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/acospi.rst b/source/elements/oneMath/source/domains/vm/acospi.rst index 9891d42a4..85292a6ce 100644 --- a/source/elements/oneMath/source/domains/vm/acospi.rst +++ b/source/elements/oneMath/source/domains/vm/acospi.rst @@ -27,17 +27,17 @@ acospi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acospi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ acospi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event acospi( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ acospi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -110,13 +110,13 @@ acospi -   * - \|\ ``a``\ \| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - - ∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -153,7 +153,7 @@ acospi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -186,7 +186,7 @@ acospi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/add.rst b/source/elements/oneMath/source/domains/vm/add.rst index 24f7e8fe6..54ccab1a8 100644 --- a/source/elements/oneMath/source/domains/vm/add.rst +++ b/source/elements/oneMath/source/domains/vm/add.rst @@ -28,7 +28,7 @@ add .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event add( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ add sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ add .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event add( sycl::queue& exec_queue, @@ -58,10 +58,10 @@ add const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -157,8 +157,8 @@ add are finite numbers, but the real or imaginary part of the computed result is so large that it does not fit the target precision. In this case, the function returns ∞ in that part of the result, and sets the - VM status code to ``oneapi::mkl::vm::status::overflow`` (overriding any possible - ``oneapi::mkl::vm::status::accuracy_warning`` status). + VM status code to ``oneapi::math::vm::status::overflow`` (overriding any possible + ``oneapi::math::vm::status::accuracy_warning`` status). .. container:: section @@ -191,7 +191,7 @@ add Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -228,7 +228,7 @@ add Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/arg.rst b/source/elements/oneMath/source/domains/vm/arg.rst index d9a81550f..cdc6fcb2e 100644 --- a/source/elements/oneMath/source/domains/vm/arg.rst +++ b/source/elements/oneMath/source/domains/vm/arg.rst @@ -27,16 +27,16 @@ arg .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event arg( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ arg .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event arg( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ arg const T *a, R* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -201,7 +201,7 @@ arg Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -227,7 +227,7 @@ arg Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/asin.rst b/source/elements/oneMath/source/domains/vm/asin.rst index 791dca5ba..dc71c4470 100644 --- a/source/elements/oneMath/source/domains/vm/asin.rst +++ b/source/elements/oneMath/source/domains/vm/asin.rst @@ -27,17 +27,17 @@ asin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asin( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ asin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asin( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ asin const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -110,13 +110,13 @@ asin -   * - \|a\| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -160,7 +160,7 @@ asin Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -193,7 +193,7 @@ asin Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/asinh.rst b/source/elements/oneMath/source/domains/vm/asinh.rst index abd6d55de..467252788 100644 --- a/source/elements/oneMath/source/domains/vm/asinh.rst +++ b/source/elements/oneMath/source/domains/vm/asinh.rst @@ -27,16 +27,16 @@ asinh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asinh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ asinh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asinh( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ asinh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -229,7 +229,7 @@ asinh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -255,7 +255,7 @@ asinh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/asinpi.rst b/source/elements/oneMath/source/domains/vm/asinpi.rst index 91ad13bdc..611c514ee 100644 --- a/source/elements/oneMath/source/domains/vm/asinpi.rst +++ b/source/elements/oneMath/source/domains/vm/asinpi.rst @@ -27,17 +27,17 @@ asinpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asinpi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ asinpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event asinpi( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ asinpi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -110,13 +110,13 @@ asinpi -   * - \|\ ``a``\ \| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -153,7 +153,7 @@ asinpi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -186,7 +186,7 @@ asinpi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/atan.rst b/source/elements/oneMath/source/domains/vm/atan.rst index 5e02424b9..58ecf73e5 100644 --- a/source/elements/oneMath/source/domains/vm/atan.rst +++ b/source/elements/oneMath/source/domains/vm/atan.rst @@ -27,16 +27,16 @@ atan .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ atan .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ atan const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -152,7 +152,7 @@ atan Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -178,7 +178,7 @@ atan Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/atan2.rst b/source/elements/oneMath/source/domains/vm/atan2.rst index 9896ed104..e2c4eb0d5 100644 --- a/source/elements/oneMath/source/domains/vm/atan2.rst +++ b/source/elements/oneMath/source/domains/vm/atan2.rst @@ -27,7 +27,7 @@ atan2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan2( sycl::queue& exec_queue, @@ -35,9 +35,9 @@ atan2 sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ atan2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan2( sycl::queue& exec_queue, @@ -56,9 +56,9 @@ atan2 const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -297,7 +297,7 @@ atan2 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -327,7 +327,7 @@ atan2 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/atan2pi.rst b/source/elements/oneMath/source/domains/vm/atan2pi.rst index 6738e6c29..8c6b8a1ba 100644 --- a/source/elements/oneMath/source/domains/vm/atan2pi.rst +++ b/source/elements/oneMath/source/domains/vm/atan2pi.rst @@ -28,7 +28,7 @@ atan2pi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan2pi( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ atan2pi sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ atan2pi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atan2pi( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ atan2pi const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -300,7 +300,7 @@ atan2pi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -330,7 +330,7 @@ atan2pi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/atanh.rst b/source/elements/oneMath/source/domains/vm/atanh.rst index 1c866e814..21af54b93 100644 --- a/source/elements/oneMath/source/domains/vm/atanh.rst +++ b/source/elements/oneMath/source/domains/vm/atanh.rst @@ -27,17 +27,17 @@ atanh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atanh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ atanh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atanh( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ atanh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -99,19 +99,19 @@ atanh - Status code * - +1 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -1 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - \|a\| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -199,7 +199,7 @@ atanh Notes: - - ``atanh(±1±i*0)=±∞±i*0``, and oneapi::mkl::vm::status::sing error is generated + - ``atanh(±1±i*0)=±∞±i*0``, and oneapi::math::vm::status::sing error is generated - ``atanh(CONJ(a))=CONJ(atanh(a))`` @@ -234,7 +234,7 @@ atanh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -267,7 +267,7 @@ atanh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/atanpi.rst b/source/elements/oneMath/source/domains/vm/atanpi.rst index f34976ce3..def0e9896 100644 --- a/source/elements/oneMath/source/domains/vm/atanpi.rst +++ b/source/elements/oneMath/source/domains/vm/atanpi.rst @@ -27,16 +27,16 @@ atanpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atanpi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ atanpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event atanpi( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ atanpi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -145,7 +145,7 @@ atanpi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -171,7 +171,7 @@ atanpi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/cbrt.rst b/source/elements/oneMath/source/domains/vm/cbrt.rst index 4654a503e..b579d0a42 100644 --- a/source/elements/oneMath/source/domains/vm/cbrt.rst +++ b/source/elements/oneMath/source/domains/vm/cbrt.rst @@ -27,16 +27,16 @@ cbrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cbrt( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ cbrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cbrt( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ cbrt const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -143,7 +143,7 @@ cbrt Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -169,7 +169,7 @@ cbrt Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/cdfnorm.rst b/source/elements/oneMath/source/domains/vm/cdfnorm.rst index e7cedcf8a..bb709fe52 100644 --- a/source/elements/oneMath/source/domains/vm/cdfnorm.rst +++ b/source/elements/oneMath/source/domains/vm/cdfnorm.rst @@ -28,17 +28,17 @@ cdfnorm .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cdfnorm( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ cdfnorm .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cdfnorm( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ cdfnorm const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -136,7 +136,7 @@ cdfnorm - Status code * - a < underflow - +0 - - ``oneapi::mkl::vm::status::underflow`` + - ``oneapi::math::vm::status::underflow`` * - +∞ - +1 -   @@ -179,7 +179,7 @@ cdfnorm Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -212,7 +212,7 @@ cdfnorm Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/cdfnorminv.rst b/source/elements/oneMath/source/domains/vm/cdfnorminv.rst index 819329eee..790debdae 100644 --- a/source/elements/oneMath/source/domains/vm/cdfnorminv.rst +++ b/source/elements/oneMath/source/domains/vm/cdfnorminv.rst @@ -28,17 +28,17 @@ cdfnorminv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cdfnorminv( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ cdfnorminv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cdfnorminv( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ cdfnorminv const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -144,25 +144,25 @@ cdfnorminv -   * - +1 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - a < -0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - a > +1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -199,7 +199,7 @@ cdfnorminv Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -232,7 +232,7 @@ cdfnorminv Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/ceil.rst b/source/elements/oneMath/source/domains/vm/ceil.rst index 26409c7d1..7ffd89e31 100644 --- a/source/elements/oneMath/source/domains/vm/ceil.rst +++ b/source/elements/oneMath/source/domains/vm/ceil.rst @@ -28,16 +28,16 @@ ceil .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event ceil( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ ceil .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event ceil( sycl::queue& exec_queue, @@ -55,9 +55,9 @@ ceil const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -149,7 +149,7 @@ ceil Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -175,7 +175,7 @@ ceil Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/cis.rst b/source/elements/oneMath/source/domains/vm/cis.rst index 3a96afe87..f5c9bf4da 100644 --- a/source/elements/oneMath/source/domains/vm/cis.rst +++ b/source/elements/oneMath/source/domains/vm/cis.rst @@ -28,17 +28,17 @@ cis .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cis( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ cis .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cis( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ cis const T *a, R* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -107,10 +107,10 @@ cis -   * - + ∞ - QNAN+i·QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - - ∞ - QNAN+i·QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN+i·QNAN -   @@ -147,7 +147,7 @@ cis Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -180,7 +180,7 @@ cis Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/clear_status.rst b/source/elements/oneMath/source/domains/vm/clear_status.rst index 871610fef..c824610d4 100644 --- a/source/elements/oneMath/source/domains/vm/clear_status.rst +++ b/source/elements/oneMath/source/domains/vm/clear_status.rst @@ -11,7 +11,7 @@ clear_status .. container:: - Resets the global VM status to ``oneapi::mkl::vm::status::success`` and returns the + Resets the global VM status to ``oneapi::math::vm::status::success`` and returns the previous VM status code. @@ -25,12 +25,12 @@ clear_status .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::status clear_status( + oneapi::math::vm::status clear_status( sycl::queue& exec_queue); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm .. rubric:: Description @@ -38,7 +38,7 @@ clear_status The clear_status function sets the VM status code to - ``oneapi::mkl::vm::status::success`` and returns the previous VM status code + ``oneapi::math::vm::status::success`` and returns the previous VM status code for a given queue. @@ -55,23 +55,23 @@ clear_status - Description * - Successful Execution - - * - ``oneapi::mkl::vm::status::success`` + * - ``oneapi::math::vm::status::success`` - VM function execution completed successfully - * - ``oneapi::mkl::vm::status::not_defined`` + * - ``oneapi::math::vm::status::not_defined`` - VM status not defined * - Warnings - - * - ``oneapi::mkl::vm::status::accuracy_warning`` + * - ``oneapi::math::vm::status::accuracy_warning`` - VM function execution completed successfully in a different accuracy mode * - Computational status codes - - * - ``oneapi::mkl::vm::status::errdom`` + * - ``oneapi::math::vm::status::errdom`` - Values are out of a range of definition producing invalid (QNaN) result - * - ``oneapi::mkl::vm::status::sing`` + * - ``oneapi::math::vm::status::sing`` - Values cause divide-by-zero (singularity) computational errors and produce and invalid (QNaN or Inf) result - * - ``oneapi::mkl::vm::status::overflow`` + * - ``oneapi::math::vm::status::overflow`` - An overflow happened during the calculation process - * - ``oneapi::mkl::vm::status::underflow`` + * - ``oneapi::math::vm::status::underflow`` - An underflow happened during the calculation process diff --git a/source/elements/oneMath/source/domains/vm/conj.rst b/source/elements/oneMath/source/domains/vm/conj.rst index 0f12b9d45..668792546 100644 --- a/source/elements/oneMath/source/domains/vm/conj.rst +++ b/source/elements/oneMath/source/domains/vm/conj.rst @@ -27,16 +27,16 @@ conj .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event conj( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ conj .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event conj( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ conj const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -114,7 +114,7 @@ conj Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -140,7 +140,7 @@ conj Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/copysign.rst b/source/elements/oneMath/source/domains/vm/copysign.rst index 48000455c..57b1571a0 100644 --- a/source/elements/oneMath/source/domains/vm/copysign.rst +++ b/source/elements/oneMath/source/domains/vm/copysign.rst @@ -28,7 +28,7 @@ copysign .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event copysign( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ copysign sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ copysign .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event copysign( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ copysign const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -143,7 +143,7 @@ copysign Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -173,7 +173,7 @@ copysign Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/cos.rst b/source/elements/oneMath/source/domains/vm/cos.rst index 60f89465e..bad09164b 100644 --- a/source/elements/oneMath/source/domains/vm/cos.rst +++ b/source/elements/oneMath/source/domains/vm/cos.rst @@ -27,17 +27,17 @@ cos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cos( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ cos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cos( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ cos const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -114,10 +114,10 @@ cos -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -161,7 +161,7 @@ cos Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -194,7 +194,7 @@ cos Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/cosd.rst b/source/elements/oneMath/source/domains/vm/cosd.rst index c48ba7c1d..994854d7e 100644 --- a/source/elements/oneMath/source/domains/vm/cosd.rst +++ b/source/elements/oneMath/source/domains/vm/cosd.rst @@ -27,17 +27,17 @@ cosd .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cosd( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ cosd .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cosd( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ cosd const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -116,10 +116,10 @@ cosd -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -156,7 +156,7 @@ cosd Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -189,7 +189,7 @@ cosd Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/cosh.rst b/source/elements/oneMath/source/domains/vm/cosh.rst index 36d5c86fa..a32856b7c 100644 --- a/source/elements/oneMath/source/domains/vm/cosh.rst +++ b/source/elements/oneMath/source/domains/vm/cosh.rst @@ -27,17 +27,17 @@ cosh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cosh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ cosh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cosh( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ cosh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -120,10 +120,10 @@ cosh -   * - X > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - X < -overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - +∞ - +∞ -   @@ -218,7 +218,7 @@ cosh - The complex cosh(a) function sets the VM status code to - ``oneapi::mkl::vm::status::overflow`` in the case of overflow, that is, when RE(a), + ``oneapi::math::vm::status::overflow`` in the case of overflow, that is, when RE(a), IM(a) are finite non-zero numbers, but the real or imaginary part of the exact result is so large that it does not meet the target precision. @@ -256,7 +256,7 @@ cosh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -289,7 +289,7 @@ cosh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/cospi.rst b/source/elements/oneMath/source/domains/vm/cospi.rst index 4896b1744..681799ff8 100644 --- a/source/elements/oneMath/source/domains/vm/cospi.rst +++ b/source/elements/oneMath/source/domains/vm/cospi.rst @@ -27,17 +27,17 @@ cospi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cospi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ cospi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event cospi( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ cospi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -107,10 +107,10 @@ cospi -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -158,7 +158,7 @@ cospi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -191,7 +191,7 @@ cospi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/create_error_handler.rst b/source/elements/oneMath/source/domains/vm/create_error_handler.rst index 0780cb034..80c241b4e 100644 --- a/source/elements/oneMath/source/domains/vm/create_error_handler.rst +++ b/source/elements/oneMath/source/domains/vm/create_error_handler.rst @@ -27,16 +27,16 @@ create_error_handler .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::error_handler create_error_handler( - sycl::buffer & status_array, + oneapi::math::vm::error_handler create_error_handler( + sycl::buffer & status_array, int64_t length = 1, - oneapi::mkl::vm::status status = oneapi::mkl::vm::status::not_defined, + oneapi::math::vm::status status = oneapi::math::vm::status::not_defined, T fixup = {}, bool copysign = false); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm USM API: @@ -45,16 +45,16 @@ create_error_handler .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::error_handler create_error_handler( - oneapi::mkl::vm::status* status_array, + oneapi::math::vm::error_handler create_error_handler( + oneapi::math::vm::status* status_array, int64_t length = 1, - oneapi::mkl::vm::status status = oneapi::mkl::vm::status::not_defined, + oneapi::math::vm::status status = oneapi::math::vm::status::not_defined, T fixup = {}, bool copysign = false); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm ``create_error_handler`` supports the following precisions. @@ -129,26 +129,26 @@ create_error_handler - Description * - Successful Execution - - * - ``oneapi::mkl::vm::status::success`` + * - ``oneapi::math::vm::status::success`` - VM function execution completed successfully - * - ``oneapi::mkl::vm::status::not_defined`` + * - ``oneapi::math::vm::status::not_defined`` - VM status not defined * - Warnings - - * - ``oneapi::mkl::vm::status::accuracy_warning`` + * - ``oneapi::math::vm::status::accuracy_warning`` - VM function execution completed successfully in a different accuracy mode * - Computational Errors - - * - ``oneapi::mkl::vm::status::errdom`` + * - ``oneapi::math::vm::status::errdom`` - Values are out of a range of definition producing invalid (QNaN) result - * - ``oneapi::mkl::vm::status::sing`` + * - ``oneapi::math::vm::status::sing`` - Values cause divide-by-zero (singularity) computational errors and produce and invalid (QNaN or Inf) result - * - ``oneapi::mkl::vm::status::overflow`` + * - ``oneapi::math::vm::status::overflow`` - An overflow happened during the calculation process - * - ``oneapi::mkl::vm::status::underflow`` + * - ``oneapi::math::vm::status::underflow`` - An underflow happened during the calculation process @@ -185,7 +185,7 @@ create_error_handler status_code Status code to match and fix the results. This is an optional argument, - default value is ``oneapi::mkl::vm::status::not_defined``. + default value is ``oneapi::math::vm::status::not_defined``. fixup diff --git a/source/elements/oneMath/source/domains/vm/div.rst b/source/elements/oneMath/source/domains/vm/div.rst index d6bb1e584..9ca75a13b 100644 --- a/source/elements/oneMath/source/domains/vm/div.rst +++ b/source/elements/oneMath/source/domains/vm/div.rst @@ -27,7 +27,7 @@ div .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event div( sycl::queue& exec_queue, @@ -35,10 +35,10 @@ div sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ div .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event div( sycl::queue& exec_queue, @@ -57,10 +57,10 @@ div const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -103,27 +103,27 @@ div * - X > +0 - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - X > +0 - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - X < +0 - +0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - X < +0 - -0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +0 - +0 - QNAN - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -0 - QNAN - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - X > +0 - +∞ - +0 @@ -163,7 +163,7 @@ div x1, x2, y1, y2 are finite numbers, but the real or imaginary part of the exact result is so large that it does not fit the target precision. In that case, the function returns ∞ in that part of the - result, and sets the VM status code to ``oneapi::mkl::vm::status::overflow``. + result, and sets the VM status code to ``oneapi::math::vm::status::overflow``. .. container:: section @@ -196,7 +196,7 @@ div Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -233,7 +233,7 @@ div Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/erf.rst b/source/elements/oneMath/source/domains/vm/erf.rst index 84d47515c..5a969d7a7 100644 --- a/source/elements/oneMath/source/domains/vm/erf.rst +++ b/source/elements/oneMath/source/domains/vm/erf.rst @@ -27,16 +27,16 @@ erf .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erf( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ erf .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erf( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ erf const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -208,7 +208,7 @@ erf Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -234,7 +234,7 @@ erf Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/erfc.rst b/source/elements/oneMath/source/domains/vm/erfc.rst index 301c18673..8607c65cc 100644 --- a/source/elements/oneMath/source/domains/vm/erfc.rst +++ b/source/elements/oneMath/source/domains/vm/erfc.rst @@ -27,17 +27,17 @@ erfc .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfc( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ erfc .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfc( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ erfc const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -173,7 +173,7 @@ erfc - Status code * - a > underflow - +0 - - ``oneapi::mkl::vm::status::underflow`` + - ``oneapi::math::vm::status::underflow`` * - +∞ - +0 -   @@ -216,7 +216,7 @@ erfc Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -249,7 +249,7 @@ erfc Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/erfcinv.rst b/source/elements/oneMath/source/domains/vm/erfcinv.rst index acf104d6c..c60b32151 100644 --- a/source/elements/oneMath/source/domains/vm/erfcinv.rst +++ b/source/elements/oneMath/source/domains/vm/erfcinv.rst @@ -28,17 +28,17 @@ erfcinv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfcinv( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ erfcinv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfcinv( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ erfcinv const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -146,25 +146,25 @@ erfcinv -   * - +2 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - a < -0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - a > +2 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -201,7 +201,7 @@ erfcinv Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -234,7 +234,7 @@ erfcinv Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/erfinv.rst b/source/elements/oneMath/source/domains/vm/erfinv.rst index 96dc1794d..d08160582 100644 --- a/source/elements/oneMath/source/domains/vm/erfinv.rst +++ b/source/elements/oneMath/source/domains/vm/erfinv.rst @@ -27,17 +27,17 @@ erfinv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfinv( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ erfinv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event erfinv( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ erfinv const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -167,19 +167,19 @@ erfinv -   * - +1 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -1 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - \|a\| > 1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -216,7 +216,7 @@ erfinv Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -249,7 +249,7 @@ erfinv Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/exp.rst b/source/elements/oneMath/source/domains/vm/exp.rst index dd2b49175..cf82176e9 100644 --- a/source/elements/oneMath/source/domains/vm/exp.rst +++ b/source/elements/oneMath/source/domains/vm/exp.rst @@ -27,17 +27,17 @@ exp .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ exp .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ exp const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -120,10 +120,10 @@ exp -   * - a > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - a < underflow - +0 - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - +∞ - +∞ -   @@ -218,7 +218,7 @@ exp - The complex exp(z) function sets the VM status code to - ``oneapi::mkl::vm::status::overflow`` in the case of overflow, + ``oneapi::math::vm::status::overflow`` in the case of overflow, that is, when both ``RE(z)`` and ``IM(z)`` are finite non-zero numbers, but the real or imaginary part of the exact result is so large that it does not meet the target precision. @@ -251,7 +251,7 @@ exp Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -284,7 +284,7 @@ exp Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/exp10.rst b/source/elements/oneMath/source/domains/vm/exp10.rst index 22f5a530b..fb85530ff 100644 --- a/source/elements/oneMath/source/domains/vm/exp10.rst +++ b/source/elements/oneMath/source/domains/vm/exp10.rst @@ -27,17 +27,17 @@ exp10 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp10( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ exp10 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp10( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ exp10 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -119,10 +119,10 @@ exp10 -   * - ``a`` > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - ``a`` < underflow - +0 - - ``oneapi::mkl::vm::status::underflow`` + - ``oneapi::math::vm::status::underflow`` * - +∞ - +∞ -   @@ -165,7 +165,7 @@ exp10 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -198,7 +198,7 @@ exp10 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/exp2.rst b/source/elements/oneMath/source/domains/vm/exp2.rst index 7a07e04e1..4f37237e3 100644 --- a/source/elements/oneMath/source/domains/vm/exp2.rst +++ b/source/elements/oneMath/source/domains/vm/exp2.rst @@ -27,17 +27,17 @@ exp2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp2( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ exp2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event exp2( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ exp2 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -118,10 +118,10 @@ exp2 -   * - ``a`` > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - ``a`` < underflow - +0 - - ``oneapi::mkl::vm::status::underflow`` + - ``oneapi::math::vm::status::underflow`` * - +∞ - +∞ -   @@ -164,7 +164,7 @@ exp2 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -197,7 +197,7 @@ exp2 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/expint1.rst b/source/elements/oneMath/source/domains/vm/expint1.rst index c25ec22af..33061ce48 100644 --- a/source/elements/oneMath/source/domains/vm/expint1.rst +++ b/source/elements/oneMath/source/domains/vm/expint1.rst @@ -27,17 +27,17 @@ expint1 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event expint1( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ expint1 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event expint1( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ expint1 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -109,19 +109,19 @@ expint1 - Status code * - ``x`` < +0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +∞ - +0 -   * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -158,7 +158,7 @@ expint1 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -191,7 +191,7 @@ expint1 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/expm1.rst b/source/elements/oneMath/source/domains/vm/expm1.rst index cb9446dbe..4355fe181 100644 --- a/source/elements/oneMath/source/domains/vm/expm1.rst +++ b/source/elements/oneMath/source/domains/vm/expm1.rst @@ -28,17 +28,17 @@ expm1 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event expm1( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ expm1 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event expm1( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ expm1 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -104,7 +104,7 @@ expm1 -   * - a > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - +∞ - +∞ -   @@ -163,7 +163,7 @@ expm1 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -196,7 +196,7 @@ expm1 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/fdim.rst b/source/elements/oneMath/source/domains/vm/fdim.rst index a9312837a..9377e3bdc 100644 --- a/source/elements/oneMath/source/domains/vm/fdim.rst +++ b/source/elements/oneMath/source/domains/vm/fdim.rst @@ -29,7 +29,7 @@ fdim .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fdim( sycl::queue& exec_queue, @@ -37,9 +37,9 @@ fdim sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ fdim .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fdim( sycl::queue& exec_queue, @@ -58,9 +58,9 @@ fdim const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -152,7 +152,7 @@ fdim Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -182,7 +182,7 @@ fdim Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/floor.rst b/source/elements/oneMath/source/domains/vm/floor.rst index ee2ce8563..a20982fc8 100644 --- a/source/elements/oneMath/source/domains/vm/floor.rst +++ b/source/elements/oneMath/source/domains/vm/floor.rst @@ -28,16 +28,16 @@ floor .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event floor( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ floor .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event floor( sycl::queue& exec_queue, @@ -55,9 +55,9 @@ floor const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -149,7 +149,7 @@ floor Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -175,7 +175,7 @@ floor Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/fmax.rst b/source/elements/oneMath/source/domains/vm/fmax.rst index 2caa78b35..2aced6de1 100644 --- a/source/elements/oneMath/source/domains/vm/fmax.rst +++ b/source/elements/oneMath/source/domains/vm/fmax.rst @@ -28,7 +28,7 @@ fmax .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmax( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ fmax sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ fmax .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmax( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ fmax const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -148,7 +148,7 @@ fmax Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -178,7 +178,7 @@ fmax Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/fmin.rst b/source/elements/oneMath/source/domains/vm/fmin.rst index 07c63d3f2..f3c9e2890 100644 --- a/source/elements/oneMath/source/domains/vm/fmin.rst +++ b/source/elements/oneMath/source/domains/vm/fmin.rst @@ -28,7 +28,7 @@ fmin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmin( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ fmin sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ fmin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmin( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ fmin const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -148,7 +148,7 @@ fmin Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -178,7 +178,7 @@ fmin Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/fmod.rst b/source/elements/oneMath/source/domains/vm/fmod.rst index 3760e3fb1..31a290697 100644 --- a/source/elements/oneMath/source/domains/vm/fmod.rst +++ b/source/elements/oneMath/source/domains/vm/fmod.rst @@ -28,7 +28,7 @@ fmod .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmod( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ fmod sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ fmod .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event fmod( sycl::queue& exec_queue, @@ -58,10 +58,10 @@ fmod const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -112,11 +112,11 @@ fmod * - ``a`` not NAN - ±0 - NAN - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - ±∞ - ``b`` not NAN - NAN - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - ±0 - ``b``\ ≠ 0, not NAN - ±0 @@ -167,7 +167,7 @@ fmod Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -204,7 +204,7 @@ fmod Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/frac.rst b/source/elements/oneMath/source/domains/vm/frac.rst index 1956a797f..bf735dcb4 100644 --- a/source/elements/oneMath/source/domains/vm/frac.rst +++ b/source/elements/oneMath/source/domains/vm/frac.rst @@ -27,16 +27,16 @@ frac .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event frac( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ frac .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event frac( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ frac const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -151,7 +151,7 @@ frac Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -177,7 +177,7 @@ frac Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/get_mode.rst b/source/elements/oneMath/source/domains/vm/get_mode.rst index 9fa2bb526..be8fdc64a 100644 --- a/source/elements/oneMath/source/domains/vm/get_mode.rst +++ b/source/elements/oneMath/source/domains/vm/get_mode.rst @@ -23,12 +23,12 @@ get_mode .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::mode get_mode( + oneapi::math::vm::mode get_mode( sycl::queue& exec_queue); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,13 +47,13 @@ get_mode - Description * - Accuracy Control - - * - ``oneapi::mkl::vm::mode::ha`` + * - ``oneapi::math::vm::mode::ha`` - High accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::la`` + * - ``oneapi::math::vm::mode::la`` - Low accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::ep`` + * - ``oneapi::math::vm::mode::ep`` - Enhanced performance accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::not_defined`` + * - ``oneapi::math::vm::mode::not_defined`` - VM mode not defined. It means that no special provisions for accuracy have been made for this queue. See :ref:`onemath_vm_setmode` for details. diff --git a/source/elements/oneMath/source/domains/vm/get_status.rst b/source/elements/oneMath/source/domains/vm/get_status.rst index 9f074d589..c4670cde1 100644 --- a/source/elements/oneMath/source/domains/vm/get_status.rst +++ b/source/elements/oneMath/source/domains/vm/get_status.rst @@ -24,12 +24,12 @@ get_status .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::status get_status( + oneapi::math::vm::status get_status( sycl::queue& exec_queue); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -53,23 +53,23 @@ get_status - Description * - Successful Execution - - * - ``oneapi::mkl::vm::status::success`` + * - ``oneapi::math::vm::status::success`` - VM function execution completed successfully - * - ``oneapi::mkl::vm::status::not_defined`` + * - ``oneapi::math::vm::status::not_defined`` - VM status not defined * - Warnings - - * - ``oneapi::mkl::vm::status::accuracy_warning`` + * - ``oneapi::math::vm::status::accuracy_warning`` - VM function execution completed successfully in a different accuracy mode * - Computational status codes - - * - ``oneapi::mkl::vm::status::errdom`` + * - ``oneapi::math::vm::status::errdom`` - Values are out of a range of definition producing invalid (QNaN) result - * - ``oneapi::mkl::vm::status::sing`` + * - ``oneapi::math::vm::status::sing`` - Values cause divide-by-zero (singularity) computational errors and produce and invalid (QNaN or Inf) result - * - ``oneapi::mkl::vm::status::overflow`` + * - ``oneapi::math::vm::status::overflow`` - An overflow happened during the calculation process - * - ``oneapi::mkl::vm::status::underflow`` + * - ``oneapi::math::vm::status::underflow`` - An underflow happened during the calculation process diff --git a/source/elements/oneMath/source/domains/vm/hypot.rst b/source/elements/oneMath/source/domains/vm/hypot.rst index 577e1557d..9f7532bf0 100644 --- a/source/elements/oneMath/source/domains/vm/hypot.rst +++ b/source/elements/oneMath/source/domains/vm/hypot.rst @@ -27,7 +27,7 @@ hypot .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event hypot( sycl::queue& exec_queue, @@ -35,9 +35,9 @@ hypot sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ hypot .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event hypot( sycl::queue& exec_queue, @@ -56,9 +56,9 @@ hypot const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -181,7 +181,7 @@ hypot Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -211,7 +211,7 @@ hypot Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/inv.rst b/source/elements/oneMath/source/domains/vm/inv.rst index f57b086d0..101bcca19 100644 --- a/source/elements/oneMath/source/domains/vm/inv.rst +++ b/source/elements/oneMath/source/domains/vm/inv.rst @@ -27,17 +27,17 @@ inv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event inv( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ inv .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event inv( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ inv const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -97,10 +97,10 @@ inv - VM status code * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +∞ - +0 -   @@ -143,7 +143,7 @@ inv Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -176,7 +176,7 @@ inv Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/invcbrt.rst b/source/elements/oneMath/source/domains/vm/invcbrt.rst index 9cdaa87bb..d5b33f5a2 100644 --- a/source/elements/oneMath/source/domains/vm/invcbrt.rst +++ b/source/elements/oneMath/source/domains/vm/invcbrt.rst @@ -27,17 +27,17 @@ invcbrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event invcbrt( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ invcbrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event invcbrt( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ invcbrt const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -97,10 +97,10 @@ invcbrt - Status code * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - +∞ - +0 -   @@ -143,7 +143,7 @@ invcbrt Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -176,7 +176,7 @@ invcbrt Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/invsqrt.rst b/source/elements/oneMath/source/domains/vm/invsqrt.rst index d63fcfedf..80910c1bf 100644 --- a/source/elements/oneMath/source/domains/vm/invsqrt.rst +++ b/source/elements/oneMath/source/domains/vm/invsqrt.rst @@ -27,17 +27,17 @@ invsqrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event invsqrt( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ invsqrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event invsqrt( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ invsqrt const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -97,16 +97,16 @@ invsqrt - VM status code * - a < +0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +0 -   @@ -146,7 +146,7 @@ invsqrt Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -179,7 +179,7 @@ invsqrt Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/lgamma.rst b/source/elements/oneMath/source/domains/vm/lgamma.rst index e94ddc032..092f017b0 100644 --- a/source/elements/oneMath/source/domains/vm/lgamma.rst +++ b/source/elements/oneMath/source/domains/vm/lgamma.rst @@ -28,17 +28,17 @@ lgamma .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event lgamma( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ lgamma .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event lgamma( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ lgamma const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -88,7 +88,7 @@ lgamma writes them to the output vector ``y``. Precision overflow thresholds for the lgamma function are beyond the scope of this document. If the result does not meet the target precision, the function sets the VM - status code to ``oneapi::mkl::vm::status::overflow``. + status code to ``oneapi::math::vm::status::overflow``. .. container:: tablenoborder @@ -108,13 +108,13 @@ lgamma -   * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - negative integer - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -∞ - +∞ -   @@ -123,7 +123,7 @@ lgamma -   * - a > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - QNAN - QNAN -   @@ -160,7 +160,7 @@ lgamma Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -193,7 +193,7 @@ lgamma Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/linearfrac.rst b/source/elements/oneMath/source/domains/vm/linearfrac.rst index f9a0f11dd..2458c6efc 100644 --- a/source/elements/oneMath/source/domains/vm/linearfrac.rst +++ b/source/elements/oneMath/source/domains/vm/linearfrac.rst @@ -28,7 +28,7 @@ linearfrac .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event linearfrac( sycl::queue& exec_queue, @@ -40,10 +40,10 @@ linearfrac T scaleb, T shiftb, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -53,7 +53,7 @@ linearfrac .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event linearfrac( sycl::queue& exec_queue, @@ -66,10 +66,10 @@ linearfrac T shiftb, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -105,7 +105,7 @@ linearfrac The linearfrac function is implemented in the EP accuracy mode only, therefore no special values are defined for this function. If used in HA or LA mode, linearfrac sets the VM status code to - ``oneapi::mkl::vm::status::accuracy_warning``. Correctness is guaranteed within the + ``oneapi::math::vm::status::accuracy_warning``. Correctness is guaranteed within the threshold limitations defined for each input parameter (see the table below); otherwise, the behavior is unspecified. @@ -204,7 +204,7 @@ linearfrac Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -257,7 +257,7 @@ linearfrac Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/ln.rst b/source/elements/oneMath/source/domains/vm/ln.rst index 7150fe622..185be638e 100644 --- a/source/elements/oneMath/source/domains/vm/ln.rst +++ b/source/elements/oneMath/source/domains/vm/ln.rst @@ -27,17 +27,17 @@ ln .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event ln( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ ln .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event ln( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ ln const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -101,16 +101,16 @@ ln -   * - a <+0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -224,7 +224,7 @@ ln Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -257,7 +257,7 @@ ln Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/log10.rst b/source/elements/oneMath/source/domains/vm/log10.rst index d8542cbcc..4e5a40fd7 100644 --- a/source/elements/oneMath/source/domains/vm/log10.rst +++ b/source/elements/oneMath/source/domains/vm/log10.rst @@ -27,17 +27,17 @@ log10 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log10( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ log10 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log10( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ log10 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -102,16 +102,16 @@ log10 -   * - a <+0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -225,7 +225,7 @@ log10 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -258,7 +258,7 @@ log10 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/log1p.rst b/source/elements/oneMath/source/domains/vm/log1p.rst index 970ec0cf3..ea6cdbbc9 100644 --- a/source/elements/oneMath/source/domains/vm/log1p.rst +++ b/source/elements/oneMath/source/domains/vm/log1p.rst @@ -28,17 +28,17 @@ log1p .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log1p( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ log1p .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log1p( sycl::queue& exec_queue, @@ -56,10 +56,10 @@ log1p const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -98,10 +98,10 @@ log1p - VM status code * - -1 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - a <-1 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - +0 -   @@ -110,7 +110,7 @@ log1p -   * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -150,7 +150,7 @@ log1p Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -183,7 +183,7 @@ log1p Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/log2.rst b/source/elements/oneMath/source/domains/vm/log2.rst index 6377de9fc..45581ff96 100644 --- a/source/elements/oneMath/source/domains/vm/log2.rst +++ b/source/elements/oneMath/source/domains/vm/log2.rst @@ -27,17 +27,17 @@ log2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log2( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ log2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event log2( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ log2 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -100,16 +100,16 @@ log2 -   * - ``a`` < +0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -149,7 +149,7 @@ log2 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -182,7 +182,7 @@ log2 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/logb.rst b/source/elements/oneMath/source/domains/vm/logb.rst index 6c5f9a0c6..2c4139d50 100644 --- a/source/elements/oneMath/source/domains/vm/logb.rst +++ b/source/elements/oneMath/source/domains/vm/logb.rst @@ -27,17 +27,17 @@ logb .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event logb( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ logb .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event logb( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ logb const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -100,10 +100,10 @@ logb - VM status code * - +0 - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - +∞ -   @@ -146,7 +146,7 @@ logb Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -179,7 +179,7 @@ logb Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/maxmag.rst b/source/elements/oneMath/source/domains/vm/maxmag.rst index 9e34f449a..d1008ba67 100644 --- a/source/elements/oneMath/source/domains/vm/maxmag.rst +++ b/source/elements/oneMath/source/domains/vm/maxmag.rst @@ -28,7 +28,7 @@ maxmag .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event maxmag( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ maxmag sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ maxmag .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event maxmag( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ maxmag const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -158,7 +158,7 @@ maxmag Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -188,7 +188,7 @@ maxmag Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/minmag.rst b/source/elements/oneMath/source/domains/vm/minmag.rst index 2bd33c2a3..50ce8258f 100644 --- a/source/elements/oneMath/source/domains/vm/minmag.rst +++ b/source/elements/oneMath/source/domains/vm/minmag.rst @@ -28,7 +28,7 @@ minmag .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event minmag( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ minmag sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ minmag .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event minmag( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ minmag const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -158,7 +158,7 @@ minmag Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -188,7 +188,7 @@ minmag Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/modf.rst b/source/elements/oneMath/source/domains/vm/modf.rst index fb755f276..80bc5eec7 100644 --- a/source/elements/oneMath/source/domains/vm/modf.rst +++ b/source/elements/oneMath/source/domains/vm/modf.rst @@ -28,7 +28,7 @@ modf .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event modf( sycl::queue& exec_queue, @@ -36,9 +36,9 @@ modf sycl::buffer& a, sycl::buffer& y, sycl::buffer& z, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ modf .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event modf( sycl::queue& exec_queue, @@ -57,9 +57,9 @@ modf T* y, T* z, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -168,7 +168,7 @@ modf Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -194,7 +194,7 @@ modf Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/mul.rst b/source/elements/oneMath/source/domains/vm/mul.rst index d1fdfa22a..fcd7cce4a 100644 --- a/source/elements/oneMath/source/domains/vm/mul.rst +++ b/source/elements/oneMath/source/domains/vm/mul.rst @@ -28,7 +28,7 @@ mul .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event mul( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ mul sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ mul .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event mul( sycl::queue& exec_queue, @@ -58,10 +58,10 @@ mul const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -197,8 +197,8 @@ mul are finite numbers, but the real or imaginary part of the computed result is so large that it does not fit the target precision. In this case, the function returns ∞ in that part of the result, and sets the - VM status code to ``oneapi::mkl::vm::status::overflow`` (overriding any possible - ``oneapi::mkl::vm::status::accuracy_warning`` status). + VM status code to ``oneapi::math::vm::status::overflow`` (overriding any possible + ``oneapi::math::vm::status::accuracy_warning`` status). .. container:: section @@ -231,7 +231,7 @@ mul Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -268,7 +268,7 @@ mul Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/mulbyconj.rst b/source/elements/oneMath/source/domains/vm/mulbyconj.rst index 58fd1761f..a58ce2a0c 100644 --- a/source/elements/oneMath/source/domains/vm/mulbyconj.rst +++ b/source/elements/oneMath/source/domains/vm/mulbyconj.rst @@ -28,7 +28,7 @@ mulbyconj .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event mulbyconj( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ mulbyconj sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ mulbyconj .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event mulbyconj( sycl::queue& exec_queue, @@ -58,10 +58,10 @@ mulbyconj const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -108,7 +108,7 @@ mulbyconj Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -145,7 +145,7 @@ mulbyconj Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/nearbyint.rst b/source/elements/oneMath/source/domains/vm/nearbyint.rst index fb7314c09..e2a97592b 100644 --- a/source/elements/oneMath/source/domains/vm/nearbyint.rst +++ b/source/elements/oneMath/source/domains/vm/nearbyint.rst @@ -28,16 +28,16 @@ nearbyint .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event nearbyint( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ nearbyint .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event nearbyint( sycl::queue& exec_queue, @@ -55,9 +55,9 @@ nearbyint const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -145,7 +145,7 @@ nearbyint Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -171,7 +171,7 @@ nearbyint Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/nextafter.rst b/source/elements/oneMath/source/domains/vm/nextafter.rst index c9d3d969d..b568b6b72 100644 --- a/source/elements/oneMath/source/domains/vm/nextafter.rst +++ b/source/elements/oneMath/source/domains/vm/nextafter.rst @@ -30,7 +30,7 @@ nextafter .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event nextafter( sycl::queue& exec_queue, @@ -38,10 +38,10 @@ nextafter sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -51,7 +51,7 @@ nextafter .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event nextafter( sycl::queue& exec_queue, @@ -60,10 +60,10 @@ nextafter const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -102,9 +102,9 @@ nextafter * - Arguments/Results - Status code * - Input vector argument element is finite and the corresponding result vector element value is infinite - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - Result vector element value is subnormal or zero, and different from the corresponding input vector argument element - - ``oneapi::mkl::vm::status::underflow`` + - ``oneapi::math::vm::status::underflow`` @@ -143,7 +143,7 @@ nextafter Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -180,7 +180,7 @@ nextafter Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/pow.rst b/source/elements/oneMath/source/domains/vm/pow.rst index e555350c4..d98462f87 100644 --- a/source/elements/oneMath/source/domains/vm/pow.rst +++ b/source/elements/oneMath/source/domains/vm/pow.rst @@ -27,7 +27,7 @@ pow .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow( sycl::queue& exec_queue, @@ -35,10 +35,10 @@ pow sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ pow .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow( sycl::queue& exec_queue, @@ -57,10 +57,10 @@ pow const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -112,27 +112,27 @@ pow * - +0 - neg. odd integer - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - neg. odd integer - -∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - neg. even integer - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - neg. even integer - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - neg. non-integer - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - neg. non-integer - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - pos. odd integer - +0 @@ -240,7 +240,7 @@ pow * - a < +0 - non-integer - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - \|a\| < 1 - -∞ - +∞ @@ -248,11 +248,11 @@ pow * - +0 - -∞ - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -0 - -∞ - +∞ - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - \|a\| > 1 - -∞ - +0 @@ -324,7 +324,7 @@ pow * - Big finite value\* - Big finite value\* - +/-∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - QNAN - QNAN - QNAN @@ -354,7 +354,7 @@ pow #. Returns ∞ in the result. - #. Sets the VM status code to ``oneapi::mkl::vm::status::overflow``. + #. Sets the VM status code to ``oneapi::math::vm::status::overflow``. Overflow in a complex function occurs (supported in the HA/LA @@ -362,14 +362,14 @@ pow are finite numbers, but the real or imaginary part of the computed result is so large that it does not fit the target precision. In this case, the function returns ∞ in that part of the result, and sets the - VM status code to ``oneapi::mkl::vm::status::overflow`` (overriding any possible - ``oneapi::mkl::vm::status::accuracy_warning`` status). + VM status code to ``oneapi::math::vm::status::overflow`` (overriding any possible + ``oneapi::math::vm::status::accuracy_warning`` status). The complex double precision versions of this function are implemented in the EP accuracy mode only. If used in HA or LA mode, the functions set the VM status code to - ``oneapi::mkl::vm::status::accuracy_warning``. + ``oneapi::math::vm::status::accuracy_warning``. .. container:: section @@ -402,7 +402,7 @@ pow Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -439,7 +439,7 @@ pow Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/pow2o3.rst b/source/elements/oneMath/source/domains/vm/pow2o3.rst index 206395362..bb335ff04 100644 --- a/source/elements/oneMath/source/domains/vm/pow2o3.rst +++ b/source/elements/oneMath/source/domains/vm/pow2o3.rst @@ -27,16 +27,16 @@ pow2o3 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow2o3( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ pow2o3 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow2o3( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ pow2o3 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -141,7 +141,7 @@ pow2o3 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -174,7 +174,7 @@ pow2o3 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/pow3o2.rst b/source/elements/oneMath/source/domains/vm/pow3o2.rst index 816eed495..2f02f2b45 100644 --- a/source/elements/oneMath/source/domains/vm/pow3o2.rst +++ b/source/elements/oneMath/source/domains/vm/pow3o2.rst @@ -27,17 +27,17 @@ pow3o2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow3o2( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ pow3o2 .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event pow3o2( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ pow3o2 const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -113,7 +113,7 @@ pow3o2 - VM status code * - a < +0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - +0 -   @@ -122,7 +122,7 @@ pow3o2 -   * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -162,7 +162,7 @@ pow3o2 Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -195,7 +195,7 @@ pow3o2 Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/powr.rst b/source/elements/oneMath/source/domains/vm/powr.rst index a186747d6..ecee06cd2 100644 --- a/source/elements/oneMath/source/domains/vm/powr.rst +++ b/source/elements/oneMath/source/domains/vm/powr.rst @@ -28,7 +28,7 @@ powr .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event powr( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ powr sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -49,7 +49,7 @@ powr .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event powr( sycl::queue& exec_queue, @@ -58,10 +58,10 @@ powr const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -123,7 +123,7 @@ powr * - ``a`` < 0 - any value ``b`` - NAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - 0 < ``a`` < ∞ - ±0 - 1 @@ -191,19 +191,19 @@ powr * - QNAN - QNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - SNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - SNAN - QNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - SNAN - SNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` @@ -238,7 +238,7 @@ powr Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -275,7 +275,7 @@ powr Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/powx.rst b/source/elements/oneMath/source/domains/vm/powx.rst index 8b39fdd50..f3a7d35d8 100644 --- a/source/elements/oneMath/source/domains/vm/powx.rst +++ b/source/elements/oneMath/source/domains/vm/powx.rst @@ -27,7 +27,7 @@ powx .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event powx( sycl::queue& exec_queue, @@ -35,10 +35,10 @@ powx sycl::buffer& a, T b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ powx .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event powx( sycl::queue& exec_queue, @@ -57,10 +57,10 @@ powx T b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -133,7 +133,7 @@ powx Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -170,7 +170,7 @@ powx Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/remainder.rst b/source/elements/oneMath/source/domains/vm/remainder.rst index 33a9353ce..8fdfa93c7 100644 --- a/source/elements/oneMath/source/domains/vm/remainder.rst +++ b/source/elements/oneMath/source/domains/vm/remainder.rst @@ -29,7 +29,7 @@ remainder .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event remainder( sycl::queue& exec_queue, @@ -37,10 +37,10 @@ remainder sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -50,7 +50,7 @@ remainder .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event remainder( sycl::queue& exec_queue, @@ -59,10 +59,10 @@ remainder const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -113,7 +113,7 @@ remainder * - ``a`` not NAN - ±0 - NAN - - oneapi::mkl::vm::status::errdom + - oneapi::math::vm::status::errdom * - ±∞ - ``b`` not NAN - NAN @@ -168,7 +168,7 @@ remainder Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -205,7 +205,7 @@ remainder Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/rint.rst b/source/elements/oneMath/source/domains/vm/rint.rst index d53e00eed..b6c3b300a 100644 --- a/source/elements/oneMath/source/domains/vm/rint.rst +++ b/source/elements/oneMath/source/domains/vm/rint.rst @@ -27,16 +27,16 @@ rint .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event rint( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ rint .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event rint( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ rint const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -163,7 +163,7 @@ rint Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -189,7 +189,7 @@ rint Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/round.rst b/source/elements/oneMath/source/domains/vm/round.rst index c985680ab..6d4e7f862 100644 --- a/source/elements/oneMath/source/domains/vm/round.rst +++ b/source/elements/oneMath/source/domains/vm/round.rst @@ -28,16 +28,16 @@ round .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event round( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ round .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event round( sycl::queue& exec_queue, @@ -55,9 +55,9 @@ round const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -147,7 +147,7 @@ round Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -173,7 +173,7 @@ round Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/set_status.rst b/source/elements/oneMath/source/domains/vm/set_status.rst index d6ec5295c..069a91950 100644 --- a/source/elements/oneMath/source/domains/vm/set_status.rst +++ b/source/elements/oneMath/source/domains/vm/set_status.rst @@ -24,13 +24,13 @@ set_status .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::status set_status( + oneapi::math::vm::status set_status( sycl::queue& exec_queue, - oneapi::mkl::vm::status new_status); + oneapi::math::vm::status new_status); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm .. rubric:: Description @@ -54,23 +54,23 @@ set_status - Description * - Successful Execution - - * - ``oneapi::mkl::vm::status::success`` + * - ``oneapi::math::vm::status::success`` - VM function execution completed successfully - * - ``oneapi::mkl::vm::status::not_defined`` + * - ``oneapi::math::vm::status::not_defined`` - VM status not defined * - Warnings - - * - ``oneapi::mkl::vm::status::accuracy_warning`` + * - ``oneapi::math::vm::status::accuracy_warning`` - VM function execution completed successfully in a different accuracy mode * - Computational status codes - - * - ``oneapi::mkl::vm::status::errdom`` + * - ``oneapi::math::vm::status::errdom`` - Values are out of a range of definition producing invalid (QNaN) result - * - ``oneapi::mkl::vm::status::sing`` + * - ``oneapi::math::vm::status::sing`` - Values cause divide-by-zero (singularity) computational errors and produce and invalid (QNaN or Inf) result - * - ``oneapi::mkl::vm::status::overflow`` + * - ``oneapi::math::vm::status::overflow`` - An overflow happened during the calculation process - * - ``oneapi::mkl::vm::status::underflow`` + * - ``oneapi::math::vm::status::underflow`` - An underflow happened during the calculation process diff --git a/source/elements/oneMath/source/domains/vm/setmode.rst b/source/elements/oneMath/source/domains/vm/setmode.rst index 6f562fd5d..00b873508 100644 --- a/source/elements/oneMath/source/domains/vm/setmode.rst +++ b/source/elements/oneMath/source/domains/vm/setmode.rst @@ -24,13 +24,13 @@ set_mode .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { - oneapi::mkl::vm::mode set_mode( + oneapi::math::vm::mode set_mode( sycl::queue& exec_queue, - oneapi::mkl::vm::mode new_mode); + oneapi::math::vm::mode new_mode); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm .. rubric:: Description @@ -51,17 +51,17 @@ set_mode - Description * - Accuracy Control - - * - ``oneapi::mkl::vm::mode::ha`` + * - ``oneapi::math::vm::mode::ha`` - High accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::la`` + * - ``oneapi::math::vm::mode::la`` - Low accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::ep`` + * - ``oneapi::math::vm::mode::ep`` - Enhanced performance accuracy versions of VM functions. - * - ``oneapi::mkl::vm::mode::not_defined`` + * - ``oneapi::math::vm::mode::not_defined`` - VM mode not defined. This has no effect. The assumed value of the ``mode`` parameter for a new queue, if ``set_mode`` - is not called is ``oneapi::mkl::vm::mode::ha``. + is not called is ``oneapi::math::vm::mode::ha``. diff --git a/source/elements/oneMath/source/domains/vm/sin.rst b/source/elements/oneMath/source/domains/vm/sin.rst index 9ed7f10b4..c21498451 100644 --- a/source/elements/oneMath/source/domains/vm/sin.rst +++ b/source/elements/oneMath/source/domains/vm/sin.rst @@ -27,17 +27,17 @@ sin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sin( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ sin .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sin( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ sin const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -114,10 +114,10 @@ sin -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -161,7 +161,7 @@ sin Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -194,7 +194,7 @@ sin Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sincos.rst b/source/elements/oneMath/source/domains/vm/sincos.rst index 89e0b15ef..24f9cb883 100644 --- a/source/elements/oneMath/source/domains/vm/sincos.rst +++ b/source/elements/oneMath/source/domains/vm/sincos.rst @@ -27,7 +27,7 @@ sincos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sincos( sycl::queue& exec_queue, @@ -35,10 +35,10 @@ sincos sycl::buffer& a, sycl::buffer& y, sycl::buffer& z, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -48,7 +48,7 @@ sincos .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sincos( sycl::queue& exec_queue, @@ -57,10 +57,10 @@ sincos T* y, T* z, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -118,11 +118,11 @@ sincos * - +∞ - QNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN - QNAN @@ -161,7 +161,7 @@ sincos Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -194,7 +194,7 @@ sincos Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sind.rst b/source/elements/oneMath/source/domains/vm/sind.rst index d3efedc13..eb8e1fcc6 100644 --- a/source/elements/oneMath/source/domains/vm/sind.rst +++ b/source/elements/oneMath/source/domains/vm/sind.rst @@ -27,17 +27,17 @@ sind .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sind( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ sind .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sind( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ sind const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -116,10 +116,10 @@ sind -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -156,7 +156,7 @@ sind Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -189,7 +189,7 @@ sind Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sinh.rst b/source/elements/oneMath/source/domains/vm/sinh.rst index 1a614e1c0..16051f303 100644 --- a/source/elements/oneMath/source/domains/vm/sinh.rst +++ b/source/elements/oneMath/source/domains/vm/sinh.rst @@ -27,17 +27,17 @@ sinh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sinh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ sinh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sinh( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ sinh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -120,10 +120,10 @@ sinh -   * - a > overflow - +∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - a < -overflow - -∞ - - ``oneapi::mkl::vm::status::overflow`` + - ``oneapi::math::vm::status::overflow`` * - +∞ - +∞ -   @@ -218,7 +218,7 @@ sinh - The complex sinh(a) function sets the VM status code to - oneapi::mkl::vm::status::overflow in the case of overflow, that is, when RE(a), + oneapi::math::vm::status::overflow in the case of overflow, that is, when RE(a), IM(a) are finite non-zero numbers, but the real or imaginary part of the exact result is so large that it does not meet the target precision. @@ -256,7 +256,7 @@ sinh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -289,7 +289,7 @@ sinh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sinpi.rst b/source/elements/oneMath/source/domains/vm/sinpi.rst index d320bd646..5deb148ac 100644 --- a/source/elements/oneMath/source/domains/vm/sinpi.rst +++ b/source/elements/oneMath/source/domains/vm/sinpi.rst @@ -27,17 +27,17 @@ sinpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sinpi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ sinpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sinpi( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ sinpi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -110,10 +110,10 @@ sinpi -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -161,7 +161,7 @@ sinpi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -194,7 +194,7 @@ sinpi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sqr.rst b/source/elements/oneMath/source/domains/vm/sqr.rst index d7f83ce68..8b0aedb40 100644 --- a/source/elements/oneMath/source/domains/vm/sqr.rst +++ b/source/elements/oneMath/source/domains/vm/sqr.rst @@ -27,16 +27,16 @@ sqr .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sqr( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ sqr .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sqr( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ sqr const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -143,7 +143,7 @@ sqr Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -169,7 +169,7 @@ sqr Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/sqrt.rst b/source/elements/oneMath/source/domains/vm/sqrt.rst index 4afdeab26..2b4a6c5b2 100644 --- a/source/elements/oneMath/source/domains/vm/sqrt.rst +++ b/source/elements/oneMath/source/domains/vm/sqrt.rst @@ -27,17 +27,17 @@ sqrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sqrt( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ sqrt .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sqrt( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ sqrt const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -98,7 +98,7 @@ sqrt - VM status code * - a< +0 - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +0 - +0 -   @@ -107,7 +107,7 @@ sqrt -   * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   @@ -227,7 +227,7 @@ sqrt Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -260,7 +260,7 @@ sqrt Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/sub.rst b/source/elements/oneMath/source/domains/vm/sub.rst index 5beac15d7..afe8c3c9d 100644 --- a/source/elements/oneMath/source/domains/vm/sub.rst +++ b/source/elements/oneMath/source/domains/vm/sub.rst @@ -28,7 +28,7 @@ sub .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sub( sycl::queue& exec_queue, @@ -36,10 +36,10 @@ sub sycl::buffer& a, sycl::buffer& b, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -51,7 +51,7 @@ sub .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event sub( sycl::queue& exec_queue, @@ -60,10 +60,10 @@ sub const T *b, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler - {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler - {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -159,8 +159,8 @@ sub are finite numbers, but the real or imaginary part of the computed result is so large that it does not fit the target precision. In this case, the function returns ∞ in that part of the result, and sets the - VM status code to ``oneapi::mkl::vm::status::overflow`` (overriding any possible - ``oneapi::mkl::vm::status::accuracy_warning`` status). + VM status code to ``oneapi::math::vm::status::overflow`` (overriding any possible + ``oneapi::math::vm::status::accuracy_warning`` status). .. container:: section @@ -193,7 +193,7 @@ sub Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -230,7 +230,7 @@ sub Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/tan.rst b/source/elements/oneMath/source/domains/vm/tan.rst index d02056b14..2bc0ee72a 100644 --- a/source/elements/oneMath/source/domains/vm/tan.rst +++ b/source/elements/oneMath/source/domains/vm/tan.rst @@ -27,17 +27,17 @@ tan .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tan( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ tan .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tan( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ tan const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -114,10 +114,10 @@ tan -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -161,7 +161,7 @@ tan Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -194,7 +194,7 @@ tan Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/tand.rst b/source/elements/oneMath/source/domains/vm/tand.rst index e80875387..c2d8daaba 100644 --- a/source/elements/oneMath/source/domains/vm/tand.rst +++ b/source/elements/oneMath/source/domains/vm/tand.rst @@ -27,17 +27,17 @@ tand .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tand( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ tand .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tand( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ tand const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -116,10 +116,10 @@ tand -   * - ±∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - ±∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -156,7 +156,7 @@ tand Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -189,7 +189,7 @@ tand Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/tanh.rst b/source/elements/oneMath/source/domains/vm/tanh.rst index b0488d850..1d9b39f8c 100644 --- a/source/elements/oneMath/source/domains/vm/tanh.rst +++ b/source/elements/oneMath/source/domains/vm/tanh.rst @@ -27,16 +27,16 @@ tanh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tanh( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -46,7 +46,7 @@ tanh .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tanh( sycl::queue& exec_queue, @@ -54,9 +54,9 @@ tanh const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -228,7 +228,7 @@ tanh Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -254,7 +254,7 @@ tanh Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/tanpi.rst b/source/elements/oneMath/source/domains/vm/tanpi.rst index 7fee6c406..9f93f1752 100644 --- a/source/elements/oneMath/source/domains/vm/tanpi.rst +++ b/source/elements/oneMath/source/domains/vm/tanpi.rst @@ -27,17 +27,17 @@ tanpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tanpi( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ tanpi .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tanpi( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ tanpi const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -116,10 +116,10 @@ tanpi -   * - +∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - QNAN - QNAN -   @@ -172,7 +172,7 @@ tanpi Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -205,7 +205,7 @@ tanpi Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/tgamma.rst b/source/elements/oneMath/source/domains/vm/tgamma.rst index b4b894df7..9e9ec8701 100644 --- a/source/elements/oneMath/source/domains/vm/tgamma.rst +++ b/source/elements/oneMath/source/domains/vm/tgamma.rst @@ -27,17 +27,17 @@ tgamma .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tgamma( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ tgamma .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event tgamma( sycl::queue& exec_queue, @@ -55,10 +55,10 @@ tgamma const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined, - oneapi::mkl::vm::error_handler errhandler = {}); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined, + oneapi::math::vm::error_handler errhandler = {}); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -87,7 +87,7 @@ tgamma Precision overflow thresholds for the tgamma function are beyond the scope of this document. If the result does not meet the target precision, the function raises sets the VM status code to - oneapi::mkl::vm::status::sing. + oneapi::math::vm::status::sing. .. container:: tablenoborder @@ -101,22 +101,22 @@ tgamma - Status code * - +0 - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - -0 - -∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - negative integer - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - -∞ - QNAN - - ``oneapi::mkl::vm::status::errdom`` + - ``oneapi::math::vm::status::errdom`` * - +∞ - +∞ -   * - a > overflow - +∞ - - ``oneapi::mkl::vm::status::sing`` + - ``oneapi::math::vm::status::sing`` * - QNAN - QNAN -   @@ -153,7 +153,7 @@ tgamma Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler @@ -186,7 +186,7 @@ tgamma Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. errhandler diff --git a/source/elements/oneMath/source/domains/vm/trunc.rst b/source/elements/oneMath/source/domains/vm/trunc.rst index 936ce0cfc..f086e8d6c 100644 --- a/source/elements/oneMath/source/domains/vm/trunc.rst +++ b/source/elements/oneMath/source/domains/vm/trunc.rst @@ -28,16 +28,16 @@ trunc .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event trunc( sycl::queue& exec_queue, std::int64_t n, sycl::buffer& a, sycl::buffer& y, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -47,7 +47,7 @@ trunc .. code-block:: cpp - namespace oneapi::mkl::vm { + namespace oneapi::math::vm { sycl::event trunc( sycl::queue& exec_queue, @@ -55,9 +55,9 @@ trunc const T *a, T* y, std::vector const & depends = {}, - oneapi::mkl::vm::mode mode = oneapi::mkl::vm::mode::not_defined); + oneapi::math::vm::mode mode = oneapi::math::vm::mode::not_defined); - } // namespace oneapi::mkl::vm + } // namespace oneapi::math::vm @@ -152,7 +152,7 @@ trunc Overrides the global VM mode setting for this function call. See :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. USM API: @@ -178,7 +178,7 @@ trunc Overrides the global VM mode setting for this function call. See the :ref:`onemath_vm_setmode` function for possible values and their description. This is an - optional parameter. The default value is ``oneapi::mkl::vm::mode::not_defined``. + optional parameter. The default value is ``oneapi::math::vm::mode::not_defined``. .. container:: section diff --git a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst index b6009a7d4..a7650d8db 100644 --- a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst @@ -16,7 +16,7 @@ Exceptions +----------------------------------+------------------------------------+ | exception | when thrown | +----------------------------------+------------------------------------+ - | oneapi::mkl::invalid_argument | buffer API: | + | oneapi::math::invalid_argument | buffer API: | | | n < 0; | | | | | | y.get_count() < n; | @@ -29,13 +29,13 @@ Exceptions | | | | | any pointer argument is nullptr | +----------------------------------+------------------------------------+ - | oneapi::mkl::host_bad_alloc | USM API: | + | oneapi::math::host_bad_alloc | USM API: | | | when internal copying to and | | | from host memory is used | | | and corresponding allocation | | | fails | +----------------------------------+------------------------------------+ - | oneapi::mkl::device_bad_alloc | USM API: | + | oneapi::math::device_bad_alloc | USM API: | | | when internal copying to and | | | from device memory is used | | | and corresponding allocation | From 4fdcd3f845732988c0eb0e96fbc2a7c522249866 Mon Sep 17 00:00:00 2001 From: nscipione Date: Wed, 9 Oct 2024 17:17:09 +0200 Subject: [PATCH 03/16] Renaming part 3 - Rename remaining occurrences of "mkl" to "onemath" Signed-off-by: nscipione --- source/architecture.rst | 4 +- source/conf/common_conf.py | 4 +- .../architecture/execution_model.inc.rst | 4 +- .../source/domains/lapack/getrs_batch.rst | 42 +-- .../lapack/getrs_batch_scratchpad_size.rst | 16 +- .../source/domains/lapack/potrf_batch.rst | 30 +-- .../lapack/potrf_batch_scratchpad_size.rst | 12 +- .../source/domains/lapack/potrs_batch.rst | 26 +- .../lapack/potrs_batch_scratchpad_size.rst | 12 +- .../rng/device_api/device-rng-bernoulli.rst | 2 +- .../rng/device_api/device-rng-poisson.rst | 2 +- ...mplate-parameter-mkl-rng-method-values.rst | 99 ------- .../domains/rng/host_api/distributions.rst | 50 ++-- ...engines-basic-random-number-generators.rst | 28 +- .../domains/rng/host_api/generate-routine.rst | 2 +- .../domains/rng/host_api/mkl-rng-ars5.rst | 200 -------------- .../rng/host_api/mkl-rng-bernoulli.rst | 177 ------------ .../domains/rng/host_api/mkl-rng-beta.rst | 231 ---------------- .../domains/rng/host_api/mkl-rng-binomial.rst | 192 -------------- .../domains/rng/host_api/mkl-rng-bits.rst | 59 ---- .../domains/rng/host_api/mkl-rng-cauchy.rst | 190 ------------- .../rng/host_api/mkl-rng-chi_square.rst | 174 ------------ .../rng/host_api/mkl-rng-default_engine.rst | 30 --- .../rng/host_api/mkl-rng-exponential.rst | 191 ------------- .../domains/rng/host_api/mkl-rng-gamma.rst | 211 --------------- .../domains/rng/host_api/mkl-rng-gaussian.rst | 193 -------------- .../rng/host_api/mkl-rng-gaussian_mv.rst | 199 -------------- .../domains/rng/host_api/mkl-rng-generate.rst | 130 --------- .../rng/host_api/mkl-rng-geometric.rst | 173 ------------ .../domains/rng/host_api/mkl-rng-gumbel.rst | 190 ------------- .../rng/host_api/mkl-rng-hypergeometric.rst | 209 --------------- .../domains/rng/host_api/mkl-rng-laplace.rst | 188 ------------- .../domains/rng/host_api/mkl-rng-leapfrog.rst | 79 ------ .../rng/host_api/mkl-rng-lognormal.rst | 227 ---------------- .../domains/rng/host_api/mkl-rng-mcg31m1.rst | 148 ----------- .../domains/rng/host_api/mkl-rng-mcg59.rst | 148 ----------- .../domains/rng/host_api/mkl-rng-mrg32k3a.rst | 201 -------------- .../domains/rng/host_api/mkl-rng-mt19937.rst | 189 ------------- .../domains/rng/host_api/mkl-rng-mt2203.rst | 239 ----------------- .../rng/host_api/mkl-rng-multinomial.rst | 170 ------------ .../rng/host_api/mkl-rng-negbinomial.rst | 191 ------------- .../rng/host_api/mkl-rng-niederreiter.rst | 169 ------------ .../rng/host_api/mkl-rng-nondeterministic.rst | 134 ---------- .../rng/host_api/mkl-rng-philox4x32x10.rst | 196 -------------- .../domains/rng/host_api/mkl-rng-poisson.rst | 173 ------------ .../rng/host_api/mkl-rng-poisson_v.rst | 159 ----------- .../domains/rng/host_api/mkl-rng-r250.rst | 169 ------------ .../domains/rng/host_api/mkl-rng-rayleigh.rst | 193 -------------- .../rng/host_api/mkl-rng-sfmt19937.rst | 179 ------------- .../rng/host_api/mkl-rng-skip_ahead.rst | 121 --------- .../domains/rng/host_api/mkl-rng-sobol.rst | 169 ------------ .../host_api/mkl-rng-uniform-continuous.rst | 193 -------------- .../rng/host_api/mkl-rng-uniform-discrete.rst | 185 ------------- .../rng/host_api/mkl-rng-uniform_bits.rst | 60 ----- .../domains/rng/host_api/mkl-rng-weibull.rst | 208 --------------- .../rng/host_api/mkl-rng-wichmann_hill.rst | 251 ------------------ .../domains/rng/host_api/service-routines.rst | 4 +- source/elements/oneMath/source/index.rst | 2 +- source/spelling_wordlist.txt | 2 +- 59 files changed, 121 insertions(+), 7308 deletions(-) delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst delete mode 100755 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst delete mode 100755 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst delete mode 100644 source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst diff --git a/source/architecture.rst b/source/architecture.rst index 85072beea..343367082 100644 --- a/source/architecture.rst +++ b/source/architecture.rst @@ -117,7 +117,7 @@ Otherwise this is the standard GEMM C++ interface. buffer b{B, range<1>{N*P}}; buffer c{C, range<1>{M*P}}; - mkl::transpose nT = mkl::transpose::nontrans; + onemath::transpose nT = onemath::transpose::nontrans; // Syntax // void gemm(queue &exec_queue, transpose transa, transpose transb, // int64_t m, int64_t n, int64_t k, T alpha, @@ -125,7 +125,7 @@ Otherwise this is the standard GEMM C++ interface. // buffer &b, int64_t ldb, T beta, // buffer &c, int64_t ldc); // call gemm - mkl::blas::gemm(q, nT, nT, M, P, N, 1.0, a, M, b, N, 0.0, c, M); + onemath::blas::gemm(q, nT, nT, M, P, N, 1.0, a, M, b, N, 0.0, c, M); } // when we exit the block, the buffer destructor will write result back to C. diff --git a/source/conf/common_conf.py b/source/conf/common_conf.py index 51f3938f3..a1e744db0 100644 --- a/source/conf/common_conf.py +++ b/source/conf/common_conf.py @@ -68,8 +68,8 @@ .. |l0_full_name| replace:: oneAPI Level Zero .. |tbb_full_name| replace:: oneAPI Threading Building Blocks .. |tbb_version| replace:: $oneapi_version -.. |mkl_full_name| replace:: oneAPI Math Kernel Library -.. |mkl_version| replace:: $oneapi_version +.. |onemath_full_name| replace:: oneAPI Math Kernel Library +.. |onemath_version| replace:: $oneapi_version .. include:: .. |regsup| replace:: :supsub:`reg` .. |intel_r| replace:: Intel\ :supsub:`reg` diff --git a/source/elements/oneMath/source/architecture/execution_model.inc.rst b/source/elements/oneMath/source/architecture/execution_model.inc.rst index c08fddd8e..750406655 100644 --- a/source/elements/oneMath/source/architecture/execution_model.inc.rst +++ b/source/elements/oneMath/source/architecture/execution_model.inc.rst @@ -24,7 +24,7 @@ Non-Member Functions Each oneMath non-member computational routine takes a ``sycl::queue`` reference as its first parameter:: - mkl::domain::routine(sycl::queue &q, ...); + onemath::domain::routine(sycl::queue &q, ...); All computation performed by the routine shall be done on the hardware device(s) associated with this queue, with possible aid from the host, unless otherwise specified. In the case of an ordered queue, all computation shall also be ordered with respect to other kernels as if enqueued on that queue. @@ -77,7 +77,7 @@ When USM pointers are used as input to, or output from, a oneMath routine, it be To help the calling application, all oneMath routines with at least one USM pointer argument also take an optional reference to a list of *input events*, of type ``std::vector``, and have a return value of type ``sycl::event`` representing computation completion:: - sycl::event mkl::domain::routine(..., std::vector &in_events = {}); + sycl::event onemath::domain::routine(..., std::vector &in_events = {}); The routine shall ensure that all input events (if the list is present and non-empty) have occurred before any USM pointers are accessed. Likewise, the routine's output event shall not be complete until the routine has finished accessing all USM pointer arguments. diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst index a131bece7..62b5d2725 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst @@ -38,9 +38,9 @@ The buffer version of ``getrs_batch`` supports only the strided API. **Strided API** | The routine solves for the following systems of linear equations :math:`X_i`: - | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -50,7 +50,7 @@ The buffer version of ``getrs_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void getrs_batch(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void getrs_batch(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -62,9 +62,9 @@ queue trans | Form of the equations: - | If ``trans = mkl::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`Xi`. - | If ``trans = mkl::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`Xi`. + | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). @@ -150,9 +150,9 @@ The USM version of ``getrs_batch`` supports the group API and strided API. **Group API** | The routine solves the following systems of linear equations for :math:`X_i` (:math:`i \in \{1...batch\_size\}`): - | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` | Before calling this routine, call the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function to compute the LU factorizations of :math:`A_i`. | Total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array. @@ -161,7 +161,7 @@ The USM version of ``getrs_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose *trans, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, std::int64_t **ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event getrs_batch(cl::sycl::queue &queue, onemath::transpose *trans, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, std::int64_t **ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -173,9 +173,9 @@ queue trans | Array of ``group_count`` parameters :math:`trans_g` indicating the form of the equations for the group :math:`g`: - | If ``trans = mkl::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Array of ``group_count`` parameters :math:`n_g` specifying the order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n_g`) belonging to group :math:`g`. @@ -253,9 +253,9 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine solves the following systems of linear equations for :math:`X_i`: - | :math:`A_iX_i = B_i`, if ``trans=mkl::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=mkl::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=mkl::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -265,7 +265,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event getrs_batch(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -277,9 +277,9 @@ queue trans | Form of the equations: - | If ``trans = mkl::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst index f9467dd29..422afc70e 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::transpose *trans, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::transpose *trans, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -48,9 +48,9 @@ queue trans | Array of ``group_count`` parameters :math:`\text{trans}_g` indicating the form of the equations for the group :math:`g`: - | If ``trans = mkl::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::conjtrans``, then :math:`A_iHX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::conjtrans``, then :math:`A_iHX_i = B_i` is solved for :math:`X_i`. n Array of ``group_count`` parameters :math:`n_g` specifying the order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n_g`) belonging to group :math:`g`. @@ -103,7 +103,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) + std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; .. container:: section @@ -115,9 +115,9 @@ queue trans | Indicates the form of the equations: - | ``If trans = mkl::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = mkl::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | ``If trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst index 104286262..a8fc8e437 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst @@ -38,8 +38,8 @@ The buffer version of ``potrf_batch`` supports only the strided API. **Strided API** | The routine forms the Cholesky factorizations of a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = mkl::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. .. container:: section @@ -49,7 +49,7 @@ The buffer version of ``potrf_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void potrf_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void potrf_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -61,8 +61,8 @@ queue uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = mkl::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = mkl::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). @@ -130,8 +130,8 @@ The USM version of ``potrf_batch`` supports the group API and strided API. **Group API** | The routine forms the Cholesky factorizations of symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data (:math:`A_i = U_i^HU_i` for complex), if :math:`\text{uplo}_g` is ``mkl::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data (:math:`A_i = L_iL_i^H` for complex), if :math:`\text{uplo}_g` is ``mkl::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data (:math:`A_i = U_i^HU_i` for complex), if :math:`\text{uplo}_g` is ``onemath::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data (:math:`A_i = L_iL_i^H` for complex), if :math:`\text{uplo}_g` is ``onemath::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular, :math:`g` is an index of group of parameters corresponding to :math:`A_i`, and total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array .. container:: section @@ -141,7 +141,7 @@ The USM version of ``potrf_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrf_batch(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrf_batch(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -153,8 +153,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. Each :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``mkl::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``mkl::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n Array of ``group_count`` :math:`n_g` parameters. Each :math:`n_g` specifies the order of the input matrices from array a belonging to group :math:`g`. @@ -221,8 +221,8 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine forms the Cholesky factorizations of a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = mkl::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. .. container:: section @@ -232,7 +232,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrf_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrf_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -244,8 +244,8 @@ queue uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = mkl::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = mkl::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst index 503985d18..d95ae7605 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -49,8 +49,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``mkl::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``mkl::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -99,7 +99,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size) + std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size) }; .. container:: section @@ -110,8 +110,8 @@ queue Device queue where calculations will be performed. uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = mkl::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = mkl::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst index 589dcbd0c..925e6dc17 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst @@ -38,8 +38,8 @@ The buffer version of ``potrs_batch`` supports only the strided API. **Strided API** | The routine solves for :math:`X_i` the systems of linear equations :math:`A_iX_i = B_i` with a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, given the Cholesky factorization of :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = mkl::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_buffer` function. @@ -51,7 +51,7 @@ The buffer version of ``potrs_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void potrs_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void potrs_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -63,8 +63,8 @@ queue uplo | Indicates how the input matrices have been factored: - | If ``uplo = mkl::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = mkl::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n The order of matrices :math:`A_i` (:math:`0 \le n`). @@ -150,7 +150,7 @@ The USM version of ``potrs_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrs_batch(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -163,8 +163,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``mkl::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``mkl::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -243,8 +243,8 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine solves for :math:`X_i` the systems of linear equations :math:`A_iX_i = B_i` with a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, given the Cholesky factorization of :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = mkl::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = mkl::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_usm` function. @@ -256,7 +256,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrs_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -268,8 +268,8 @@ queue uplo | Indicates how the input matrices have been factored: - | If ``uplo = mkl::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = mkl::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n The order of matrices :math:`A_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst index 8b4b73418..956ffde2b 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -49,8 +49,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``mkl::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``mkl::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -106,7 +106,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) + std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; .. container:: section @@ -117,8 +117,8 @@ queue Device queue where calculations will be performed. uplo | Indicates how the input matrices have been factored: - | If ``uplo = mkl::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = mkl::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n Order of matrices :math:`A_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst index 17c540908..c193011a5 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-bernoulli.rst @@ -82,7 +82,7 @@ class bernoulli * ``oneapi::math::rng::bernoulli_method::by_default`` * ``oneapi::math::rng::bernoulli_method::icdf`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst index 1365cd614..909973bad 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-poisson.rst @@ -76,7 +76,7 @@ class poisson * ``oneapi::math::rng::device::poisson_method::by_default`` * ``oneapi::math::rng::device::poisson_method::devroye`` - See description of the methods in :ref:`Distributions methods template parameter`. + See description of the methods in :ref:`Distributions methods template parameter`. .. container:: section diff --git a/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst deleted file mode 100644 index 11690f56e..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-mkl-rng-method-values.rst +++ /dev/null @@ -1,99 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_distributions_template_parameter_mkl_rng_method_values: - -Distributions Template Parameter Method -======================================= - - -.. container:: section - - .. list-table:: - :header-rows: 1 - - * - Method - - Distributions - - Math Description - * - ``uniform_method::standard``\ \ ``uniform_method::accurate``\ - - \ ``uniform(s,d)``\ \ ``uniform(i)``\ - - Standard method. ``uniform_method::standard_accurate`` supported for ``uniform(s, d)`` only. - * - ``gaussian_method::box_muller`` - - \ ``gaussian``\ - - Generates normally distributed random number x thru the pair of uniformly distributed numbers :math:`u_1` and :math:`u_2` according to the formula: :math:`x = \sqrt{-2lnu_1}\sin(2 \pi u_2)` - * - ``gaussian_method::box_muller2`` - - \ ``gaussian``\ \ ``lognormal``\ - - Generates normally distributed random numbers :math:`x_1` and :math:`x_2` thru the pair of uniformly distributed numbers :math:`u_1` and :math:`u_2` according to the formulas: \ :math:`x_1 = \sqrt{-2lnu_1}\sin{2\pi u_2}`\ \ :math:`x_2 = \sqrt{-2lnu_1}\cos{2\pi u_2}`\ - * - ``gaussian_method::icdf`` - - \ ``gaussian``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``exponential_method::icdf``\ \ ``exponential_method::icdf_accurate``\ - - \ ``exponential``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``weibull_method::icdf``\ \ ``weibull_method::icdf_accurate``\ - - \ ``weibull``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``cauchy_method::icdf``\ - - \ ``cauchy``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``rayleigh_method::icdf``\ \ ``rayleigh_method::icdf_accurate``\ - - \ ``rayleigh``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``bernoulli_method::icdf``\ - - \ ``bernoulli``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``geometric_method::icdf``\ - - \ ``geometric``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``gumbel_method::icdf``\ - - \ ``gumbel``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``lognormal_method::icdf``\ \ ``lognormal_method::icdf_accurate``\ - - \ ``lognormal``\ - - Inverse cumulative distribution function (ICDF) method. - * - \ ``lognormal_method::box_muller2``\ \ ``lognormal_method::box_muller2_accurate``\ - - \ ``lognormal``\ - - Generated normally distributed random numbers :math:`x_1` and :math:`x_2` by box_muller2 method are converted to lognormal distribution. - * - \ ``gamma_method::marsaglia``\ \ ``gamma_method::marsaglia_accurate``\ - - \ ``gamma``\ - - For :math:`\alpha > 1`, a gamma distributed random number is generated as a cube of properly scaled normal random number; for :math:`0.6 \leq \alpha < 1`, a gamma distributed random number is generated using rejection from Weibull distribution; for :math:`\alpha < 0.6`, a gamma distributed random number is obtained using transformation of exponential power distribution; for :math:`\alpha = 1`, gamma distribution is reduced to exponential distribution. - * - \ ``beta_method::cja``\ \ ``beta_method::cja_accurate``\ - - \ ``beta``\ - - Cheng-Jonhnk-Atkinson method. For :math:`min(p, q) > 1`, Cheng method is used; for :math:`min(p, q) < 1`, Johnk method is used, if :math:`q + K*p2 + C \leq 0 (K = 0.852..., C=-0.956...)` otherwise, Atkinson switching algorithm is used; for :math:`max(p, q) < 1`, method of Johnk is used; for :math:`min(p, q) < 1, max(p, q)> 1`, Atkinson switching algorithm is used (CJA stands for Cheng, Johnk, Atkinson); for :math:`p = 1` or :math:`q = 1`, inverse cumulative distribution function method is used; for :math:`p = 1` and :math:`q = 1`, beta distribution is reduced to uniform distribution. - * - ``chi_square_method::gamma_based`` - - \ ``chi_square``\ - - (most common): If :math:`\nu \ge 17` or :math:`\nu` is odd and :math:`5 \leq \nu \leq 15`, a chi-square distribution is reduced to a Gamma distribution with these parameters: Shape :math:`\alpha = \nu / 2`\ Offset :math:`a = 0`\ \Scale factor :math:`\beta = 2`\ The random numbers of the Gamma distribution are generated. - * - ``binomial_method::btpe`` - - \ ``binomial``\ - - Acceptance/rejection method for :math:`ntrial * min(p, 1 - p) \ge 30` with decomposition into four regions: two parallelograms, triangle, left exponential tail, right exponential tail. - * - ``poisson_method::ptpe`` - - \ ``poisson``\ - - Acceptance/rejection method for :math:`\lambda \ge 27` with decomposition into four regions: two parallelograms, triangle, left exponential tail, right exponential tail. - * - ``poisson_method::gaussian_icdf_based`` - - \ ``poisson``\ - - for :math:`\lambda \ge 1`, method based on Poisson inverse CDF approximation by Gaussian inverse CDF; for :math:`\lambda < 1`, table lookup method is used. - * - ``poisson_v_method::gaussian_icdf_based`` - - \ ``poisson_v``\ - - for :math:`\lambda \ge 1`, method based on Poisson inverse CDF approximation by Gaussian inverse CDF; for :math:`\lambda < 1`, table lookup method is used. - * - ``hypergeometric_method::h2pe`` - - \ ``hypergeometric``\ - - Acceptance/rejection method for large mode of distribution with decomposition into three regions: rectangular, left exponential tail, right exponential tail. - * - ``negative_binomial_method::nbar`` - - \ ``negative_binomial``\ - - Acceptance/rejection method for: :math:`\frac{(a - 1)(1 - p)}{p} \ge 100` with decomposition into five regions: rectangular, 2 trapezoid, left exponential tail, right exponential tail. - * - ``multinomial_method::poisson_icdf_based`` - - \ ``multinomial``\ - - Multinomial distribution with parameters :math:`m, k`, and a probability vector :math:`p`. Random numbers of the multinomial distribution are generated by Poisson Approximation method. - * - ``gaussian_mv_method::box_muller`` - - \ ``gaussian_mv``\ - - BoxMuller method for gaussian_mv method. - * - ``gaussian_mv_method::box_muller2`` - - \ ``gaussian_mv``\ - - BoxMuller2 method for gaussian_mv method. - * - ``gaussian_mv_method::icdf`` - - \ ``gaussian_mv``\ - - Inverse cumulative distribution function (ICDF) method. - -**Parent -topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/distributions.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst index 5594351fd..fb9d28570 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/distributions.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/distributions.rst @@ -149,28 +149,28 @@ Host Distributions .. toctree:: :hidden: - distributions-template-parameter-mkl-rng-method-values - mkl-rng-uniform-continuous - mkl-rng-gaussian - mkl-rng-exponential - mkl-rng-laplace - mkl-rng-weibull - mkl-rng-cauchy - mkl-rng-rayleigh - mkl-rng-lognormal - mkl-rng-gumbel - mkl-rng-gamma - mkl-rng-beta - mkl-rng-chi_square - mkl-rng-gaussian_mv - mkl-rng-uniform-discrete - mkl-rng-uniform_bits - mkl-rng-bits - mkl-rng-bernoulli - mkl-rng-geometric - mkl-rng-binomial - mkl-rng-hypergeometric - mkl-rng-poisson - mkl-rng-poisson_v - mkl-rng-negbinomial - mkl-rng-multinomial + distributions-template-parameter-onemath-rng-method-values + onemath-rng-uniform-continuous + onemath-rng-gaussian + onemath-rng-exponential + onemath-rng-laplace + onemath-rng-weibull + onemath-rng-cauchy + onemath-rng-rayleigh + onemath-rng-lognormal + onemath-rng-gumbel + onemath-rng-gamma + onemath-rng-beta + onemath-rng-chi_square + onemath-rng-gaussian_mv + onemath-rng-uniform-discrete + onemath-rng-uniform_bits + onemath-rng-bits + onemath-rng-bernoulli + onemath-rng-geometric + onemath-rng-binomial + onemath-rng-hypergeometric + onemath-rng-poisson + onemath-rng-poisson_v + onemath-rng-negbinomial + onemath-rng-multinomial diff --git a/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst b/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst index 28ac8bbbd..f997f5250 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/engines-basic-random-number-generators.rst @@ -128,17 +128,17 @@ Host Engines (Basic Random Number Generators) .. toctree:: :hidden: - mkl-rng-default_engine - mkl-rng-mrg32k3a - mkl-rng-philox4x32x10 - mkl-rng-mcg31m1 - mkl-rng-mcg59 - mkl-rng-r250 - mkl-rng-wichmann_hill - mkl-rng-mt19937 - mkl-rng-sfmt19937 - mkl-rng-mt2203 - mkl-rng-ars5 - mkl-rng-sobol - mkl-rng-niederreiter - mkl-rng-nondeterministic + onemath-rng-default_engine + onemath-rng-mrg32k3a + onemath-rng-philox4x32x10 + onemath-rng-mcg31m1 + onemath-rng-mcg59 + onemath-rng-r250 + onemath-rng-wichmann_hill + onemath-rng-mt19937 + onemath-rng-sfmt19937 + onemath-rng-mt2203 + onemath-rng-ars5 + onemath-rng-sobol + onemath-rng-niederreiter + onemath-rng-nondeterministic diff --git a/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst b/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst index d4a7b7c79..93563eede 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/generate-routine.rst @@ -19,4 +19,4 @@ Host Generate Routine .. toctree:: :hidden: - mkl-rng-generate + onemath-rng-generate diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst deleted file mode 100644 index d124114fe..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-ars5.rst +++ /dev/null @@ -1,200 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_ars5: - -ars5 -==== - -The ars5 counter-based pseudorandom number generator. - -.. _onemath_rng_ars5_description: - -.. rubric:: Description - -The ars5 engine is a keyed family of counter-based BRNG. The state consists of a 128-bit integer counter :math:`c` and a 128-bit key :math:`k`. The BRNG is based on the AES encryption algorithm [:ref:`FIPS-197 `]. - -.. container:: section - - .. rubric:: Generation algorithm - - The generator has a 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: - - 1. The i-th number is defined by the following formula :math:`r_i=(f(i/ 4) >> ((i \ mod \ 4) * 32)) \ mod \ 2 ^ {32}` - 2. Function :math:`f(c)` takes a 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: - 2.1. :math:`c_0 = c \oplus k` and :math:`k_0 = k`. - - 2.2. The following recurrence is calculated N = 5 times: - - :math:`c_{i+1} = SubBytes(c)` - - :math:`c_{i+1} = ShiftRows(c_{i+1})` - - :math:`c_{i+1} = MixColumns(c_{i+1})`, this step is omitted if :math:`i+1 = N` - - :math:`c_{i+1} = AddRoundKey(c_{i+1}, k_j)` - - :math:`Lo(k_{i+1}) = Lo(k) + 0x9E3779B97F4A7C15` - - :math:`Hi(k_{i+1}) = Hi(k) + 0xBB67AE8584CAA73B` - - Specification for :math:`SubBytes, ShiftRows, MixColumns, AddRoundKey` functions can be found in [:ref:`FIPS-197 `]. - - 2.3. Put :math:`f(c) = c_N`, where :math:`N = 10` - - 3. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` - -.. _onemath_rng_ars5_description_syntax: - -class ars5 ----------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class ars5 { - public: - static constexpr std::uint64_t default_seed = 0; - - ars5(sycl::queue queue, std::uint64_t seed = default_seed); - - ars5(sycl::queue queue, std::initializer_list seed); - - ars5(const ars5& other); - - ars5(ars5&& other); - - ars5& operator=(const ars5& other); - - ars5& operator=(ars5&& other); - - ~ars5(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `ars5(sycl::queue queue, std::uint64_t seed)`_ - - Constructor for common seed initialization of the engine - * - `ars5(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine - * - `ars5(const ars5& other)`_ - - Copy constructor - * - `ars5(ars5&& other)`_ - - Move constructor - * - `ars5& operator=(const ars5& other)`_ - - Copy assignment operator - * - `ars5& operator=(ars5&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`ars5(sycl::queue queue, std::uint64_t seed)`: - - .. code-block:: cpp - - ars5::ars5(sycl::queue queue, std::uint64_t seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is 128-bit key, :math:`c` is 128-bit counter. - - .. _`ars5(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - ars5::ars5(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume - if :math:`n = 0: k = 0, c = 0` - - if :math:`n = 1: k = seed[0], c = 0` - - if :math:`n = 2: k = seed[0] + seed[1] \cdot 2^{64}, c = 0` - - if :math:`n = 3: k = seed[0] + seed[1] \cdot 2^{64}, c = seed[2]` - - if :math:`n = 4: k = seed[0] + seed[1] \cdot 2^{64}, c = seed[2] + seed[3] \cdot 2^{64}` - - for :math:`n > 4` following arguments are ignored - - .. _`ars5(const ars5& other)`: - - .. code-block:: cpp - - ars5::ars5(const ars5& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``ars5`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`ars5(ars5&& other)`: - - .. code-block:: cpp - - ars5::ars5(ars5&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``ars5`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - - - .. _`ars5& operator=(const ars5& other)`: - - .. code-block:: cpp - - ars5::ars5& operator=(const ars5& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``ars5`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`ars5& operator=(ars5&& other)`: - - .. code-block:: cpp - - ars5::ars5& operator=(ars5&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``ars5`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst deleted file mode 100644 index 9e2b69e12..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bernoulli.rst +++ /dev/null @@ -1,177 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_bernoulli: - -bernoulli -========= - -Class is used for generation of Bernoulli distributed integer types random numbers. - -.. _onemath_rng_bernoulli_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. - -The probability distribution is given by: - -.. math:: - - P(X = 1) = p - -.. math:: - - P(X = 0) = 1 - p - -The cumulative distribution function is as follows: - -.. math:: - - F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - p, 0 \leq x < 1, x \in R \\ 1, x \ge 1 \end{array}\right. - -.. _onemath_rng_bernoulli_syntax: - -class bernoulli ---------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class bernoulli { - public: - using method_type = Method; - using result_type = IntType; - bernoulli(); - explicit bernoulli(float p); - float p() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - * ``std::uint32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::bernoulli_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::bernoulli_method::by_default`` - * ``oneapi::math::rng::bernoulli_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `bernoulli()`_ - - Default constructor - * - `explicit bernoulli(float p)`_ - - Constructor with parameters - * - `float p() const`_ - - Method to obtain probability `p` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - bernoulli::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - bernoulli::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`bernoulli()`: - - .. code-block:: cpp - - bernoulli::bernoulli() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `p` = 0.5f. - - .. container:: section - - .. _`explicit bernoulli(float p)`: - - .. code-block:: cpp - - explicit bernoulli::bernoulli(float p) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `p` is a probability. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when `p > 1.0f`, or `p < 0.0f` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`float p() const`: - - .. code-block:: cpp - - float p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `p` - probability. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst deleted file mode 100644 index d75161700..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-beta.rst +++ /dev/null @@ -1,231 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_beta: - -beta -==== - -Class is used for generation of beta distributed real types random numbers. - -.. _onemath_rng_beta_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` -function to provide random numbers beta distributed with shape parameters :math:`p` and :math:`q`, -displacement :math:`\alpha` and scale parameter :math:`(b, \beta)`, where :math:`p`, :math:`q`. -:math:`\alpha`, :math:`\beta` :math:`\in R; p > 0; q > 0; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{p, q, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{B(p, q) * \beta^{p + q - 1}}(x - a)^{p - 1}*(\beta + \alpha - x)^{q - 1}, \alpha \leq x < \alpha + \beta \\ 0, x < \alpha, x \ge \alpha + \beta \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < \alpha \\ \int^x_{\alpha}\frac{1}{B(p, q) * \beta^{p + q - 1}}(y - \alpha)^{p - 1}*(\beta + \alpha - y)^{q - 1}dy, \alpha \leq x < \alpha + \beta, x \in R \\ 1, x \ge \alpha + \beta \end{array}\right. - - -Where :math:`B(p, 1)` is the complete beta function. - -.. _onemath_rng_beta_syntax: - -class beta ----------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class beta { - public: - using method_type = Method; - using result_type = RealType; - beta(); - explicit beta(RealType p, RealType q, RealType a, RealType b); - RealType p() const; - RealType q() const; - RealType a() const; - RealType b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::beta_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::beta_method::by_default`` - * ``oneapi::math::rng::beta_method::cja`` - * ``oneapi::math::rng::beta_method::cja_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `beta()`_ - - Default constructor - * - `explicit beta(RealType p, RealType q, RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType p() const`_ - - Method to obtain shape ``p`` - * - `RealType q() const`_ - - Method to obtain shape ``q`` - * - `RealType a() const`_ - - Method to obtain displacement :math:`\alpha` - * - `RealType b() const`_ - - Method to obtain scalefactor :math:`\beta` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - beta::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - beta::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`beta()`: - - .. code-block:: cpp - - beta::beta() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as ``p`` = 1.0, ``q`` = 0.0, :math:`\alpha` = 1.0, :math:`\beta` = 1.0. - - .. container:: section - - .. _`explicit beta(RealType p, RealType q, RealType a, RealType b)`: - - .. code-block:: cpp - - explicit beta::beta(RealType p, RealType q, RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. ``p`` and ``q`` are shapes, :math:`\alpha` is a displacement, :math:`\beta` is a scalefactor. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`p \leq 0.0f`, or :math:`q \leq 0.0f`, or :math:`\beta \leq 0.0f` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType p() const`: - - .. code-block:: cpp - - RealType beta::p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter ``p`` - shape. - - .. container:: section - - .. _`RealType q() const`: - - .. code-block:: cpp - - RealType beta::q() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter ``q`` - shape. - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType beta::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter :math:`\alpha` - displacement. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType beta::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter :math:`\beta` - scalefactor. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst deleted file mode 100644 index af8e186f4..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-binomial.rst +++ /dev/null @@ -1,192 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_binomial: - -binomial -======== - -Class is used for generation of binomially distributed integer types random numbers. - -.. _onemath_rng_binomial_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. - -A binomially distributed variate represents the number of successes in :math:`m` independent Bernoulli trials with probability of a single trial success :math:`p`. - -The probability distribution is given by: - -.. math:: - - P(X = k) = C^k_{m}p^k(1 - p)^{m - k}, k \in \{0, 1, ... , m\} - -The cumulative distribution function is as follows: - -.. math:: - - F_{m, p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ \sum^{\lfloor x \rfloor}_{k = 0} C^k_{m}p^k(1 - p)^{m - k}, 0 \leq x < m, x \in R \\ 1, x \ge m \end{array}\right. - - -.. _onemath_rng_binomial_syntax: - -class binomial --------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class binomial { - public: - using method_type = Method; - using result_type = IntType; - binomial(); - explicit binomial(std::int32_t ntrial, double p); - std::int32_t ntrial() const; - double p() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::binomial_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::binomial_method::by_default`` - * ``oneapi::math::rng::binomial_method::btpe`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `binomial()`_ - - Default constructor - * - `explicit binomial(std::int32_t ntrial, double p)`_ - - Constructor with parameters - * - `std::int32_t ntrial() const`_ - - Method to obtain number of independent trials `m` - * - `double p() const`_ - - Method to obtain success probability of a single trial `p` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - binomial::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - binomial::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`binomial()`: - - .. code-block:: cpp - - binomial::binomial() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `m` = 5, `p` = 0.5. - - .. container:: section - - .. _`explicit binomial(std::int32_t ntrial, double p)`: - - .. code-block:: cpp - - explicit binomial::binomial(std::int32_t ntrial, double p) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `ntrial` is the number of independent trials, `p` is the success probability of a single trial. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`p > 1.0`, or :math:`p < 0.0`, or :math:`ntrial < 1` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t ntrial() const`: - - .. code-block:: cpp - - std::int32_t binomial::ntrial() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `m` - number of independent trials. - - .. container:: section - - .. _`double p() const`: - - .. code-block:: cpp - - double binomial::p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `p` - success probability of a single trial. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst deleted file mode 100644 index f6cdf37de..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-bits.rst +++ /dev/null @@ -1,59 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_bits: - -bits -==== - -Class is used for generation of underlying engine integer recurrence. - -.. _onemath_rng_bits_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. - -class bits ----------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class bits { - public: - using result_type = UIntType; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename UIntType - Type of the produced values. Supported types: - * ``std::uint32_t`` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - bits::result_type = UIntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst deleted file mode 100644 index bdb6c6674..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-cauchy.rst +++ /dev/null @@ -1,190 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_cauchy: - -cauchy -====== - -Class is used for generation of Cauchy distributed real types random numbers. - -.. _onemath_rng_cauchy_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \beta}(x) = \frac{1}{\pi\beta(1 + (\frac{x - a}{\beta})^2)}, x \in R. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \beta}(x) = \frac{1}{2} + \frac{1}{\pi} \arctan{(\frac{x - a}{\beta})}, x \in R. - -.. _onemath_rng_cauchy_syntax: - -class cauchy ------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class cauchy { - public: - using method_type = Method; - using result_type = RealType; - cauchy(); - explicit cauchy(RealType a, RealType b); - RealType a() const; - RealType b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::cauchy_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::cauchy_method::by_default`` - * ``oneapi::math::rng::cauchy_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `cauchy()`_ - - Default constructor - * - `explicit cauchy(RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType b() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - cauchy::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - cauchy::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`cauchy()`: - - .. code-block:: cpp - - cauchy::cauchy() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, and `b` = 1.0. - - .. container:: section - - .. _`explicit cauchy(RealType a, RealType b)`: - - .. code-block:: cpp - - explicit cauchy::cauchy(RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a displacement value, `b` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`b \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType cauchy::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement value. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType cauchy::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst deleted file mode 100644 index 5d72e596f..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-chi_square.rst +++ /dev/null @@ -1,174 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_chi_square: - -chi_square -========== - -Class is used for generation of chi-square distributed real types random numbers. - -.. _onemath_rng_chi_square_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. - -The probability distribution is given by: - -.. math:: - - f_{n}(x) = \left\{ \begin{array}{rcl} \frac{x^{\frac{n - 2}{2}}e^{-\frac{x}{2}}}{2^{n/2}\Gamma(n/2)}, x \ge 0 \\ 0, x < 0 \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{n}(x) = \left\{ \begin{array}{rcl} \int^{x}_{0}\frac{y^{\frac{n - 2}{2}}e^{-\frac{x}{2}}}{2^{n/2}\Gamma(n/2)}dy, x \ge 0 \\ 0, x < 0 \end{array}\right. - - -.. _onemath_rng_chi_square_syntax: - -class chi_square ----------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class chi_square { - public: - using method_type = Method; - using result_type = RealType; - chi_square(); - explicit chi_square(std::int32_t n); - std::int32_t n() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::chi_square_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::chi_square_method::by_default`` - * ``oneapi::math::rng::chi_square_method::gamma_based`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `chi_square()`_ - - Default constructor - * - `explicit chi_square(std::int32_t n)`_ - - Constructor with parameters - * - `std::int32_t n() const`_ - - Method to obtain number of degrees of freedom `n` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - chi_square::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - chi_square::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`chi_square()`: - - .. code-block:: cpp - - chi_square::chi_square() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `n` = 5. - - .. container:: section - - .. _`explicit chi_square(std::int32_t n)`: - - .. code-block:: cpp - - explicit chi_square::chi_square(std::int32_t n) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `n` is the number of degrees of freedom. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`n < 1` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t n() const`: - - .. code-block:: cpp - - std::int32_t chi_square::n() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `n` - number of degrees of freedom. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst deleted file mode 100755 index 9d11919a2..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-default_engine.rst +++ /dev/null @@ -1,30 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_default_engine: - -default_engine -============== - -Default random engine. - -.. _onemath_rng_default_engine_description: - -.. rubric:: Description - -The choice of engine type named by default_engine is implementation-defined. The implementation may select this type on the basis of performance, size, quality, or any combination of such factors. - -.. _onemath_rng_default_engine_description_syntax: - -type alias default_engine -------------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - using default_engine = implementation-defined; - - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst deleted file mode 100644 index 646998054..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-exponential.rst +++ /dev/null @@ -1,191 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_exponential: - -exponential -=========== - -Class is used for generation of exponentially distributed real types random numbers. - -.. _onemath_rng_exponential_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\beta}exp(-\frac{x - a}{\beta}), x \ge a \\ 0, x < a \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{x - a}{\beta}), x \ge a \\ 0, x < a \end{array}\right. - -.. _onemath_rng_exponential_syntax: - -class exponential ------------------ - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class exponential { - public: - using method_type = Method; - using result_type = RealType; - exponential(); - explicit exponential(RealType a, RealType beta); - RealType a() const; - RealType beta() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::exponential_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::exponential_method::by_default`` - * ``oneapi::math::rng::exponential_method::icdf`` - * ``oneapi::math::rng::exponential_method::icdf_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `exponential()`_ - - Default constructor - * - `explicit exponential(RealType a, RealType beta)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType beta() const`_ - - Method to obtain scalefactor - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - exponential::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - exponential::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`exponential()`: - - .. code-block:: cpp - - exponential::exponential() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, `beta` = 1.0. - - .. container:: section - - .. _`explicit exponential(RealType a, RealType beta)`: - - .. code-block:: cpp - - explicit exponential::exponential(RealType a, RealType beta) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a displacement, `beta` is a scalefactor. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`beta \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType exponential::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement. - - .. container:: section - - .. _`RealType beta() const`: - - .. code-block:: cpp - - RealType exponential::beta() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `beta` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst deleted file mode 100644 index 8933e4937..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gamma.rst +++ /dev/null @@ -1,211 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_gamma: - -gamma -===== - -Class is used for generation of gamma distributed real types random numbers. - -.. _onemath_rng_gamma_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` -function to provide random numbers gamma distributed with shape :math:`\alpha`, -displacement :math:`a`, and scale parameter :math:`\beta`, where -:math:`a, \alpha, \beta \in R; \alpha > 0; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\Gamma(\alpha)\beta^{\alpha}}(x - a)^{\alpha - 1}e^{-(x - a) / \beta}, x \ge a \\ 0, x < a \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \int^x_a\frac{1}{\Gamma(\alpha)\beta^{\alpha}}(y - a)^{\alpha - 1}e^{-(y - a) / \beta}dy, x \ge a \\ 0, x < a \end{array}\right. - -.. _onemath_rng_gamma_syntax: - -class gamma ------------ - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class gamma { - public: - using method_type = Method; - using result_type = RealType; - gamma(); - explicit gamma(RealType alpha, RealType a, RealType beta); - RealType alpha() const; - RealType a() const; - RealType beta() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::gamma_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::gamma_method::by_default`` - * ``oneapi::math::rng::gamma_method::marsaglia`` - * ``oneapi::math::rng::gamma_method::marsaglia_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `gamma()`_ - - Default constructor - * - `explicit gamma(RealType alpha, RealType a, RealType beta)`_ - - Constructor with parameters - * - `RealType alpha() const`_ - - Method to obtain shape value - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType beta() const`_ - - Method to obtain scale value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - gamma::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - gamma::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`gamma()`: - - .. code-block:: cpp - - gamma::gamma() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `alpha` = 1.0, `a` = 0.0, and `beta` = 1.0. - - .. container:: section - - .. _`explicit gamma(RealType alpha, RealType a, RealType beta)`: - - .. code-block:: cpp - - explicit gamma::gamma(RealType alpha, RealType a, RealType beta) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `alpha` is a shape value, `a` is a displacement value, `beta` is a scale parameter. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType alpha() const`: - - .. code-block:: cpp - - RealType gamma::alpha() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `alpha` - shape value. - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType gamma::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement value. - - .. container:: section - - .. _`RealType beta() const`: - - .. code-block:: cpp - - RealType gamma::beta() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `beta` - scale parameter. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst deleted file mode 100644 index 5fbb56576..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian.rst +++ /dev/null @@ -1,193 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_gaussian: - -gaussian -======== - -Class is used for generation of normally distributed real types random numbers. - -.. _onemath_rng_gaussian_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \sigma}(x) = \frac{1}{\sigma\sqrt{2\pi}}exp(-\frac{(x - a)^2}{2*\sigma^2}), x \in R. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \sigma}(x) = \int^x_{-\infty}\frac{1}{\sigma\sqrt{2\pi}}exp(-\frac{(y - a)^2}{2*\sigma^2})dy, x \in R. - - -.. _onemath_rng_gaussian_syntax: - -class gaussian --------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class gaussian { - public: - using method_type = Method; - using result_type = RealType; - gaussian(); - explicit gaussian(RealType mean, RealType stddev); - RealType mean() const; - RealType stddev() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::gaussian_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::gaussian_method::by_default`` - * ``oneapi::math::rng::gaussian_method::box_muller`` - * ``oneapi::math::rng::gaussian_method::box_muller2`` - * ``oneapi::math::rng::gaussian_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter` - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `gaussian()`_ - - Default constructor - * - `explicit gaussian(RealType mean, RealType stddev)`_ - - Constructor with parameters - * - `RealType mean() const`_ - - Method to obtain mean value - * - `RealType stddev() const`_ - - Method to obtain standard deviation value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - gaussian::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - gaussian::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`gaussian()`: - - .. code-block:: cpp - - gaussian::gaussian() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `mean` = 0.0, `stddev` = 1.0. - - .. container:: section - - .. _`explicit gaussian(RealType mean, RealType stddev)`: - - .. code-block:: cpp - - explicit gaussian::gaussian(RealType mean, RealType stddev) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `mean` is a mean value, `stddev` is a standard deviation value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when `stddev` :math:`\leq` `static_cast(0.0)` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType mean() const`: - - .. code-block:: cpp - - RealType gaussian::mean() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `mean` - mean value. - - .. container:: section - - .. _`RealType stddev() const`: - - .. code-block:: cpp - - RealType gaussian::stddev() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `stddev` - standard deviation value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst deleted file mode 100755 index 8d66eb1a9..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gaussian_mv.rst +++ /dev/null @@ -1,199 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_gaussian_mv: - -gaussian_mv -=========== - -Class is used for generation of multivariate normally distributed real types random numbers. - -.. _onemath_rng_gaussian_mv_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. - -The probability density function is given by: - -.. math:: - - f_{a, C}(x) = \frac{1}{\sqrt{det(2\pi C)}}exp(-1 / 2(x - a)^T C^{-1}(x-a)). - -.. _onemath_rng_gaussian_mv_syntax: - -class gaussian_mv ------------------ - -Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). -It's implementation defined which type ``SequenceContainerOrView`` represents. - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class gaussian_mv { - public: - using method_type = Method; - using result_type = RealType; - explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix); - std::int32_t dimen() const; - SequenceContainerOrView mean() const; - SequenceContainerOrView matrix() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. rubric:: Template parameters - - .. container:: section - - oneapi::math::rng::layout Layout - Matrix layout: - * ``oneapi::math::rng::layout::full`` - * ``oneapi::math::rng::layout::packed`` - * ``oneapi::math::rng::layout::diagonal`` - - .. container:: section - - typename Method = oneapi::math::rng::gaussian_mv_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::gaussian_mv_method::by_default`` - * ``oneapi::math::rng::gaussian_mv_method::box_muller`` - * ``oneapi::math::rng::gaussian_mv_method::box_muller2`` - * ``oneapi::math::rng::gaussian_mv_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix)`_ - - Constructor with parameters - * - `std::int32_t dimen() const`_ - - Method to obtain number of dimensions in output random vectors - * - `SequenceContainerOrView mean() const`_ - - Method to obtain mean vector `a` of dimension d. - * - `SequenceContainerOrView matrix() const`_ - - Method to obtain variance-covariance matrix `C` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - gaussian_mv::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - gaussian_mv::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix)`: - - .. code-block:: cpp - - explicit gaussian_mv::gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. ``dimen`` is the number of dimensions, ``mean`` is a mean vector, ``matrix`` is a variance-covariance matrix. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`mean.size() \leq 0`, or :math:`matrix.size() \leq 0` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t dimen() const`: - - .. code-block:: cpp - - std::int32_t gaussian_mv::dimen() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `dimen`. - - .. container:: section - - .. _`SequenceContainerOrView mean() const`: - - .. code-block:: cpp - - SequenceContainerOrView gaussian_mv::mean() const - - .. container:: section - - .. rubric:: Return Value - - Returns the mean vector. - - .. container:: section - - .. _`SequenceContainerOrView matrix() const`: - - .. code-block:: cpp - - SequenceContainerOrView gaussian_mv::matrix() const - - .. container:: section - - .. rubric:: Return Value - - Returns the variance-covariance matrix. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst deleted file mode 100644 index 724275fd8..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-generate.rst +++ /dev/null @@ -1,130 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_generate: - -generate -======== - -Entry point to obtain random numbers from a given engine with proper statistics of a given distribution. - -.. _onemath_rng_generate_description: - -.. rubric:: Description and Assumptions - -oneapi::math::rng::generate function produces random numbers sequence from the given engine object and applied transformation from a given distribution object. - -.. _onemath_rng_generate_buffer: - -generate (Buffer version) -------------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - void generate (const DistrType& distr, EngineType& engine, std::int64_t n, sycl::buffer& r); - } - -.. container:: section - - .. rubric:: Template Parameters - - DistrType - Type of distribution which is used for random number generation. - - EngineType - Type of engine which is used for random number generation. - -.. container:: section - - .. rubric:: Input Parameters - - distr - Distribution object. See :ref:`onemath_rng_distributions` for details. - - engine - Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. - - n - Number of random values to be generated. - -.. container:: section - - .. rubric:: Output Parameters - - r - sycl::buffer of generated values. - -.. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when n > r.get_count(), or n < 0 - -.. _onemath_rng_generate_usm: - -generate (USM version) ----------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - sycl::event generate (const DistrType& distr, EngineType& engine, std::int64_t n, typename DistrType::result_type* r, const std::vector & dependencies); - } - -.. container:: section - - .. rubric:: Template Parameters - - DistrType - Type of distribution which is used for random number generation. - - EngineType - Type of engine which is used for random number generation. - -.. container:: section - - .. rubric:: Input Parameters - - distr - Distribution object. See :ref:`onemath_rng_distributions` for details. - - engine - Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. - - n - Number of random values to be generated. - - dependencies - Optional parameter. List of events to wait for before starting computation, if any. - -.. container:: section - - .. rubric:: Output Parameters - - r - pointer to generated values. - -.. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when r == nullptr, or n < 0 - -.. container:: section - - .. rubric:: Return Value - - Output event to wait on to ensure computation is complete. - - -**Parent topic:** :ref:`onemath_rng_generate_routine` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst deleted file mode 100644 index a01a94d6d..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-geometric.rst +++ /dev/null @@ -1,173 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_geometric: - -geometric -========= - -Class is used for generation of geometrically distributed integer types random numbers. - -.. _onemath_rng_geometric_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. - -The probability distribution is given by: - -.. math:: - - P(X = k) = p * (1 - p)^k, k = \{0, 1, 2, ... \}. - -The cumulative distribution function is as follows: - -.. math:: - - F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - (1 - p)^{\lfloor x + 1 \rfloor}, x \ge 0 \end{array}\right. - -.. _onemath_rng_geometric_syntax: - -class geometric ---------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class geometric { - public: - using method_type = Method; - using result_type = IntType; - geometric(); - explicit geometric(float p); - float p() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - * ``std::uint32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::geometric_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::geometric_method::by_default`` - * ``oneapi::math::rng::geometric_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `geometric()`_ - - Default constructor - * - `explicit geometric(float p)`_ - - Constructor with parameters - * - `float p() const`_ - - Method to obtain probability value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - geometric::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - geometric::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`geometric()`: - - .. code-block:: cpp - - geometric::geometric() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `p` = 0.5. - - .. container:: section - - .. _`explicit geometric(float p)`: - - .. code-block:: cpp - - explicit geometric::geometric(float p) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `p` is a probability value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`p \ge 1.0f`, or :math:`p \leq 0.0f` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`float p() const`: - - .. code-block:: cpp - - float geometric::p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `p` - probability value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst deleted file mode 100644 index ae02b8deb..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-gumbel.rst +++ /dev/null @@ -1,190 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_gumbel: - -gumbel -====== - -Class is used for generation of Gumbel distributed real types random numbers. - -.. _onemath_rng_gumbel_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \beta}(x) = \frac{1}{\beta}exp(-\frac{x - a}{\beta})exp(-exp(\frac{x - a}{\beta})), x \in R. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \beta}(x) = 1 - exp(-exp(\frac{x - a}{\beta})), x \in R. - -.. _onemath_rng_gumbel_syntax: - -class gumbel ------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class gumbel { - public: - using method_type = Method; - using result_type = RealType; - gumbel(); - explicit gumbel(RealType a, RealType b); - RealType a() const; - RealType b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::gumbel_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::gumbel_method::by_default`` - * ``oneapi::math::rng::gumbel_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `gumbel()`_ - - Default constructor - * - `explicit gumbel(RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType b() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - gumbel::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - gumbel::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`gumbel()`: - - .. code-block:: cpp - - gumbel::gumbel() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, and `beta` = 1.0. - - .. container:: section - - .. _`explicit gumbel(RealType a, RealType b)`: - - .. code-block:: cpp - - explicit gumbel::gumbel(RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a displacement value, `beta` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`b \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType gumbel::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement value. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType gumbel::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst deleted file mode 100644 index aa185c39c..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-hypergeometric.rst +++ /dev/null @@ -1,209 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_hypergeometric: - -hypergeometric -============== - -Class is used for generation of hypergeometrically distributed integer types random numbers. - -.. _onemath_rng_hypergeometric_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. - -Consider a lot of :math:`l` elements comprising :math:`m` marked and :math:`l` - :math:`m` unmarked elements. A trial sampling without replacement of exactly :math:`s` elements from this lot helps to define the hypergeometric distribution, which is the probability that the group of :math:`s` elements contains exactly :math:`k` marked elements. - -The probability distribution is given by: - -.. math:: - - P_(X = k) = \frac{C^k_mC^{s-k}_{l-m}}{C^s_l}, k \in \{max(0, s + m - l), ... , min(s, m)\}. - -The cumulative distribution function is as follows: - -.. math:: - - F_{l, s, m}(x) = \left\{ \begin{array}{rcl} 0, x < max(0, s + m - l) \\ \sum^{\lfloor x \rfloor}_{k = max(0, s + m - l)}\frac{C^k_mC^{s-k}_{l-m}}{C^s_l}, max(0, s + m - l) \leq x \leq min(s, m) \\ 1, x > min(s, m) \end{array}\right. - -.. _onemath_rng_hypergeometric_syntax: - -class hypergeometric --------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class hypergeometric { - public: - using method_type = Method; - using result_type = IntType; - hypergeometric(); - explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m); - std::int32_t s() const; - std::int32_t m() const; - std::int32_t l() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - * ``std::uint32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::hypergeometric_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::hypergeometric_method::by_default`` - * ``oneapi::math::rng::hypergeometric_method::h2pe`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `hypergeometric()`_ - - Default constructor - * - `explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m)`_ - - Constructor with parameters - * - `std::int32_t s() const`_ - - Method to obtain lot size - * - `std::int32_t m() const`_ - - Method to obtain size of sampling without replacement - * - `std::int32_t l() const`_ - - Method to obtain number of marked elements - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - hypergeometric::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - hypergeometric::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`hypergeometric()`: - - .. code-block:: cpp - - hypergeometric::hypergeometric() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `l` = 1, `s` = 1, `m` = 1. - - .. container:: section - - .. _`explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m)`: - - .. code-block:: cpp - - explicit hypergeometric::hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `l` is a lot size, `s` is a size of sampling without replacement, `m` is a number of marked elements. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`s < 0`, or :math:`m < 0`, or :math:`l < (s > m ? s : m)` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t l() const`: - - .. code-block:: cpp - - std::int32_t hypergeometric::l() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `l` - lot size value. - - .. container:: section - - .. _`std::int32_t s() const`: - - .. code-block:: cpp - - std::int32_t hypergeometric::s() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `s` - size of sampling without replacement. - - .. container:: section - - .. _`std::int32_t m() const`: - - .. code-block:: cpp - - std::int32_t hypergeometric::m() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `m` - number of marked elements. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst deleted file mode 100644 index f9fc41ca9..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-laplace.rst +++ /dev/null @@ -1,188 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_laplace: - -laplace -======= - -Class is used for generation of Laplace distributed real types random numbers. - -.. _onemath_rng_laplace_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. - -The probability distribution is given by: - -.. math:: - - f_{a, \beta}(x) = \frac{1}{\sqrt{2\beta}}exp(-\frac{|x - a|}{\beta}), x \in R. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x \ge a \\ 1 - \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x < a \end{array}\right. - -.. _onemath_rng_laplace_syntax: - -class laplace -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - template - class laplace { - public: - using method_type = Method; - using result_type = RealType; - laplace(); - explicit laplace(RealType a, RealType b); - RealType a() const; - RealType b() const; - }; - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::laplace_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::laplace_method::by_default`` - * ``oneapi::math::rng::laplace_method::icdf`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `laplace()`_ - - Default constructor - * - `explicit laplace(RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain mean value - * - `RealType b() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - laplace::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - laplace::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`laplace()`: - - .. code-block:: cpp - - laplace::laplace() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, and `beta` = 1.0. - - .. container:: section - - .. _`explicit laplace(RealType a, RealType b)`: - - .. code-block:: cpp - - explicit laplace::laplace(RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a mean value, `beta` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`b \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType laplace::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - mean value. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType laplace::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst deleted file mode 100644 index 3365f9024..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-leapfrog.rst +++ /dev/null @@ -1,79 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_leapfrog: - -leapfrog -======== - -Proceed state of engine by the leapfrog method. - -.. _onemath_rng_leapfrog_description: - -.. rubric:: Description and Assumptions - -oneapi::math::rng::leapfrog function generates random numbers in an engine with non-unit stride. This feature is particularly useful in distributing random numbers from the original stream across the stride buffers without generating the original random sequence with subsequent manual distribution. see `Figure "Leapfrog Method" <#rng_leapfrog>`__. - -.. container:: figtop - :name: rng_leapfrog - - Leapfrog Method - - |image0| - -.. _onemath_rng_leapfrog_common: - -leapfrog --------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - void leapfrog(EngineType& engine, std::uint64_t idx, std::uint64_t stride); - } - -.. container:: section - - .. rubric:: Template Parameters - - EngineType - Type of engine. Note: may not be supported by all available engine classes. - -.. container:: section - - .. rubric:: Input Parameters - - engine - Engine which state would be skipped. - - idx - Index of the computational node. - - stride - Largest number of computational nodes, or stride. - -.. rubric:: Example - -.. code-block:: cpp - - // Creating 3 identical engines - oneapi::math::rng::mcg31m1 engine_1(queue, seed); - - oneapi::math::rng::mcg31m1 engine_2(engine_1); - oneapi::math::rng::mcg31m1 engine_3(engine_1); - - - // Leapfrogging the states of engines - oneapi::math::rng::leapfrog(engine_1, 0 , 3); - oneapi::math::rng::leapfrog(engine_2, 1 , 3); - oneapi::math::rng::leapfrog(engine_3, 2 , 3); - // Generating random numbers - - -**Parent topic:** :ref:`onemath_rng_service_routines` - -.. |image0| image:: ../../equations/rng-leapfrog.png diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst deleted file mode 100644 index 5d22a4007..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-lognormal.rst +++ /dev/null @@ -1,227 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_lognormal: - -lognormal -========= - -Class is used for generation of lognormally distributed real types random numbers. - -.. _onemath_rng_lognormal_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \sigma, b, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\sigma(x - b)\sqrt{2\pi}}exp(-\frac{[ln((x - b) / \beta) - a]^2}{2*\sigma^2}), x > b \\ 0, x \leq b \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \sigma, b, \beta}(x) = \left\{ \begin{array}{rcl} \Phi( \frac{(ln((x - b) / \beta) - a)}{\sigma}), x > b \\ 0, x \leq b \end{array}\right. - -.. _onemath_rng_lognormal_syntax: - -class lognormal ---------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class lognormal { - public: - using method_type = Method; - using result_type = RealType; - lognormal(); - explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0)); - RealType m() const; - RealType s() const; - RealType displ() const; - RealType scale() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::lognormal_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::lognormal_method::by_default`` - * ``oneapi::math::rng::lognormal_method::box_muller2`` - * ``oneapi::math::rng::lognormal_method::icdf`` - * ``oneapi::math::rng::lognormal_method::box_muller2_accurate`` - * ``oneapi::math::rng::lognormal_method::icdf_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `lognormal()`_ - - Default constructor - * - `explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0))`_ - - Constructor with parameters - * - `RealType m() const`_ - - Method to obtain mean value - * - `RealType s() const`_ - - Method to obtain standard deviation value - * - `RealType displ() const`_ - - Method to obtain displacement value - * - `RealType scale() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - lognormal::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - lognormal::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`lognormal()`: - - .. code-block:: cpp - - lognormal::lognormal() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `m` = 0.0, `s` = 1.0, `displ` = 0.0, `scale` = 1.0. - - .. container:: section - - .. _`explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0))`: - - .. code-block:: cpp - - explicit lognormal::lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0)) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `m` is a mean value, `s` is a standard deviation value, `displ` is a displacement value, `scale` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`s \leq` static_cast(0.0), or :math:`scale \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType m() const`: - - .. code-block:: cpp - - RealType lognormal::m() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `m` - mean value. - - .. container:: section - - .. _`RealType s() const`: - - .. code-block:: cpp - - RealType lognormal::s() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `s` - standard deviation value. - - .. container:: section - - .. _`RealType displ() const`: - - .. code-block:: cpp - - RealType lognormal::displ() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `displ` - displacement value. - - .. container:: section - - .. _`RealType scale() const`: - - .. code-block:: cpp - - RealType lognormal::scale() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `scale` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst deleted file mode 100644 index 2fc224d40..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg31m1.rst +++ /dev/null @@ -1,148 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_mcg31m1: - -mcg31m1 -======= - -The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1). - -.. _onemath_rng_mcg31m1_description: - -.. rubric:: Description - -The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. The mcg31m1 generator belongs to linear congruential generators with the period length of approximately :math:`2^{31}`. Such generators are still used as default random number generators in various software systems, mainly due to the simplicity of the portable versions implementation, speed, and compatibility with the earlier systems versions. However, their period length does not meet the requirements for modern basic generators. Still, the mcg31m1 generator possesses good statistic properties and you may successfully use it to generate random numbers of different distributions for small samplings. - -.. container:: section - - .. rubric:: Generation algorithm - - :math:`x_n=ax_{n-1}(mod \ m)` - - :math:`u_n = x_n / m` - - :math:`a = 1132489760, m=2^{31} - 1` - -.. _onemath_rng_mcg31m1_description_syntax: - -class mcg31m1 -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class mcg31m1 { - public: - static constexpr std::uint32_t default_seed = 1; - - mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed); - - mcg31m1(const mcg31m1& other); - - mcg31m1(mcg31m1&& other); - - mcg31m1& operator=(const mcg31m1& other); - - mcg31m1& operator=(mcg31m1&& other); - - ~mcg31m1(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `mcg31m1(const mcg31m1& other)`_ - - Copy constructor - * - `mcg31m1(mcg31m1&& other)`_ - - Move constructor - * - `mcg31m1& operator=(const mcg31m1& other)`_ - - Copy assignment operator - * - `mcg31m1& operator=(mcg31m1&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - mcg31m1::mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 0x7FFFFFFF`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - .. _`mcg31m1(const mcg31m1& other)`: - - .. code-block:: cpp - - mcg31m1::mcg31m1(const mcg31m1& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mcg31m1(mcg31m1&& other)`: - - .. code-block:: cpp - - mcg31m1::mcg31m1(mcg31m1&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`mcg31m1& operator=(const mcg31m1& other)`: - - .. code-block:: cpp - - mcg31m1::mcg31m1& operator=(const mcg31m1& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mcg31m1& operator=(mcg31m1&& other)`: - - .. code-block:: cpp - - mcg31m1::mcg31m1& operator=(mcg31m1&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg31m1`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst deleted file mode 100644 index f887f6d55..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mcg59.rst +++ /dev/null @@ -1,148 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_mcg59: - -mcg59 -===== - -The 59-bit multiplicative congruential pseudorandom number generator. - -.. _onemath_rng_mcg59_description: - -.. rubric:: Description - -The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. The mcg59 generator belongs to linear congruential generators with the period length of approximately :math:`2^{57}`. - -.. container:: section - - .. rubric:: Generation algorithm - - :math:`x_n=ax_{n-1}(mod \ m)` - - :math:`u_n = x_n / m` - - :math:`a = 13^{13}, m=2^{59}` - -.. _onemath_rng_mcg59_description_syntax: - -class mcg59 ------------ - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class mcg59 { - public: - static constexpr std::uint64_t default_seed = 1; - - mcg59(sycl::queue queue, std::uint64_t seed = default_seed); - - mcg59(const mcg59& other); - - mcg59(mcg59&& other); - - mcg59& operator=(const mcg59& other); - - mcg59& operator=(mcg59&& other); - - ~mcg59(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `mcg59(sycl::queue queue, std::uint64_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `mcg59(const mcg59& other)`_ - - Copy constructor - * - `mcg59(mcg59&& other)`_ - - Move constructor - * - `mcg59& operator=(const mcg59& other)`_ - - Copy assignment operator - * - `mcg59& operator=(mcg59&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`mcg59(sycl::queue queue, std::uint64_t seed = default_seed)`: - - .. code-block:: cpp - - mcg59::mcg59(sycl::queue queue, std::uint64_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 2^{59}`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - .. _`mcg59(const mcg59& other)`: - - .. code-block:: cpp - - mcg59::mcg59(const mcg59& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg59`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mcg59(mcg59&& other)`: - - .. code-block:: cpp - - mcg59::mcg59(mcg59&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg59`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`mcg59& operator=(const mcg59& other)`: - - .. code-block:: cpp - - mcg59::mcg59& operator=(const mcg59& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg59`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mcg59& operator=(mcg59&& other)`: - - .. code-block:: cpp - - mcg59::mcg59& operator=(mcg59&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mcg59`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst deleted file mode 100644 index 19f265dfa..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mrg32k3a.rst +++ /dev/null @@ -1,201 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_mrg32k3a: - -mrg32k3a -======== - -The combined multiple recursive pseudorandom number generator MRG32k3a. - -.. _onemath_rng_mrg32k3a_description: - -.. rubric:: Description - -MRG32k3a engine is a 32-bit combined multiple recursive generator with two components of order 3 :ref:`[L'Ecuyer99a] `. MRG32k3a combined generator meets the requirements for modern RNGs, such as good multidimensional uniformity, or a long period (:math:`p \approx 2^{191}`). - -.. container:: section - - .. rubric:: Generation algorithm - - - :math:`x_n=a_{11} x_{n-1} + a_{12} x_{n-2} + a_{13} x_{n-3}(mod \ m_{1})` - - :math:`y_n = a_{21} y_{n-1} + a_{22} y_{n-2} + a_{23} (mod \ m_2)` - - :math:`z_n = x_n - y_n (mod \ m_{1})` - - :math:`u_n = z_n / m_1` - - :math:`a_{11} = 0, a_{12} = 1403580, a_{13} = -810728, m_1 = 2^{32} - 209` - - :math:`a_{21} = 527612, a_{22} = 0, a_{23} = -1370589, m_2 = 2^{32} - 22853` - - -.. _onemath_rng_mrg32k3a_description_syntax: - -class mrg32k3a --------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class mrg32k3a { - public: - static constexpr std::uint32_t default_seed = 1; - - mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed); - - mrg32k3a(sycl::queue queue, std::initializer_list seed); - - mrg32k3a(const mrg32k3a& other); - - mrg32k3a(mrg32k3a&& other); - - mrg32k3a& operator=(const mrg32k3a& other); - - mrg32k3a& operator=(mrg32k3a&& other); - - ~mrg32k3a(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `mrg32k3a(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine - * - `mrg32k3a(const mrg32k3a& other)`_ - - Copy constructor - * - `mrg32k3a(mrg32k3a&& other)`_ - - Move constructor - * - `mrg32k3a& operator=(const mrg32k3a& other)`_ - - Copy assignment operator - * - `mrg32k3a& operator=(mrg32k3a&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue object``, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`x_{-3} = seed \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1`. - - .. _`mrg32k3a(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume - if :math:`n = 0: x_{-3} = x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` - - if :math:`n = 1: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` - - if :math:`n = 2: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` - - if :math:`n = 3: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` - - :math:`y_{-3} = y_{-2} = y_{-1} = 1` - - if :math:`n = 4: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` - - :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = y_{-1} = 1` - - if :math:`n = 5: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` - - :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = seed[4] \ mod \ m_2, y_{-1} = 1` - - if :math:`n \geqslant 6: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` - - :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = seed[4] \ mod \ m_2, y_{-1} = seed[5] \ mod \ m_2` - - if the values prove to be :math:`x_{-3} = x_{-2} = x_{-1} = 0`, assume :math:`x_{-3} = 1` - - if the values prove to be :math:`y_{-3} = y_{-2} = y_{-1} = 0`, assume :math:`y_{-3} = 1` - - .. _`mrg32k3a(const mrg32k3a& other)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a(const mrg32k3a& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mrg32k3a(mrg32k3a&& other)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a(mrg32k3a&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`mrg32k3a& operator=(const mrg32k3a& other)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a& operator=(const mrg32k3a& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mrg32k3a& operator=(mrg32k3a&& other)`: - - .. code-block:: cpp - - mrg32k3a::mrg32k3a& operator=(mrg32k3a&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mrg32k3a`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst deleted file mode 100644 index b1f8b7123..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt19937.rst +++ /dev/null @@ -1,189 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_mt19937: - -mt19937 -======= - -Mersenne Twister pseudorandom number generator. - -.. _onemath_rng_mt19937_description: - -.. rubric:: Description - -The Mersenne Twister pseudorandom number generator, mt19937, is a modification of twisted generalized feedback shift register generator [:ref:`Matsumoto98 `]. MT19937 has the period length of :math:`2^{19937} - 1` and is 623-dimensionally equidistributed with up to 32-bit accuracy. These properties make the generator applicable for simulations in various fields of science and engineering. The state of the generator is represented by 624 32-bit unsigned integer numbers. - -.. container:: section - - .. rubric:: Generation algorithm - - :math:`x_{n}=x_{n-(624-397)} \oplus ( (x_{n-624} \& 0x80000000) | (x_{n - 624 + 1} \& 0x7FFFFFFF) )A` - - :math:`y_{n} = x_{n}` - - :math:`y_{n} = y_{n} \oplus (y_{n} >> 11)` - - :math:`y_{n} = y_{n} \oplus ( (y_{n} << 7) \& 0x9D2C5680)` - - :math:`y_{n} = y_{n} \oplus ( (y_{n} << 15) \& 0xEFC60000)` - - :math:`y_{n} = y_{n} \oplus (y_{n} >> 18)` - - :math:`u_{n} = y_{n} / 2^{32}` - - -.. container:: section - - Matrix :math:`A_j(32x32)` has the following format: - -.. math:: - - \left [ \begin{array}{ccccc} 0 & 1 & 0 & ... & ... \\ 0 & 0 & ... & 0 & ... \\ ... & ... & ... & ... & ... \\ 0 & ... & 0 & 0 & 1 \\ a_{31} & a_{30} & ... & ... & a_{0} \end{array}\right ] - -.. container:: section - - Where the 32-bit vector :math:`a = a_{31}..a_{0}` has the value :math:`a=0x9908B0DF`. - -.. _onemath_rng_mt19937_description_syntax: - -class mt19937 --------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class mt19937 { - public: - static constexpr std::uint32_t default_seed = 1; - - mt19937(sycl::queue queue, std::uint32_t seed = default_seed); - - mt19937(sycl::queue queue, std::initializer_list seed); - - mt19937(const mt19937& other); - - mt19937(mt19937&& other); - - mt19937& operator=(const mt19937& other); - - mt19937& operator=(mt19937&& other); - - ~mt19937(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `mt19937(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `mt19937(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine - * - `mt19937(const mt19937& other)`_ - - Copy constructor - * - `mt19937(mt19937&& other)`_ - - Move constructor - * - `mt19937& operator=(const mt19937& other)`_ - - Copy assignment operator - * - `mt19937& operator=(mt19937&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`mt19937(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - mt19937::mt19937(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - .. _`mt19937(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - mt19937::mt19937(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - .. _`mt19937(const mt19937& other)`: - - .. code-block:: cpp - - mt19937::mt19937(const mt19937& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mt19937(mt19937&& other)`: - - .. code-block:: cpp - - mt19937::mt19937(mt19937&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt19937`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`mt19937& operator=(const mt19937& other)`: - - .. code-block:: cpp - - mt19937::mt19937& operator=(const mt19937& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mt19937& operator=(mt19937&& other)`: - - .. code-block:: cpp - - mt19937::mt19937& operator=(mt19937&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst deleted file mode 100644 index b7a6ac297..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-mt2203.rst +++ /dev/null @@ -1,239 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_mt2203: - -mt2203 -====== - -The mt2203 engine is the set of 6024 Mersenne Twister pseudorandom number generators MT2203 [:ref:`Matsumoto98 `], [:ref:`Matsumoto00 `]. - -.. _onemath_rng_mt2203_description: - -.. rubric:: Description - -The set of 6024 basic pseudorandom number generators MT2203 is a natural addition to the MT19937 generator. MT2203 generators are intended for use in large scale Monte Carlo simulations performed on multi-processor computer systems. - -.. container:: section - - .. rubric:: Generation algorithm - - For :math:`j = 1,..., 6024`: - - :math:`x_{n, j} =x_{n - (69 - 34), j} \oplus ( (x_{n - 69, j} \& 0xFFFFFFE0) | (x_{n + 69 + 1, j} \& 0x1F) ) A_{j}` - - :math:`y_{n, j} = x_{n, j}` - - :math:`y_{n, j} = y_{n, j} \oplus (y_{n, j} >> 12)` - - :math:`y_{n, j} = y_{n, j} \oplus ( (y_{n, j} << 7) \& b_j)` - - :math:`y_{n, j} = y_{n, j} \oplus ( (y_{n, j} << 15) \& c_j)` - - :math:`y_{n, j} = y_{n, j} \oplus (y_{n, j} >> 18)` - - -.. container:: section - - Matrix :math:`A_j(32x32)` has the following format: - -.. math:: - - \left [ \begin{array}{ccccc} 0 & 1 & 0 & ... & ... \\ 0 & 0 & ... & 0 & ... \\ ... & ... & ... & ... & ... \\ 0 & ... & 0 & 0 & 1 \\ a_{31, j} & a_{30, j} & ... & ... & a_{0, 1} \end{array}\right ] - - -.. _onemath_rng_mt2203_description_syntax: - -class mt2203 ------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class mt2203 { - public: - static constexpr std::uint32_t default_seed = 1; - - mt2203(sycl::queue queue, std::uint32_t seed = default_seed); - - mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx); - - mt2203(sycl::queue queue, std::initializer_list seed); - - mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx); - - mt2203(const mt2203& other); - - mt2203(mt2203&& other); - - mt2203& operator=(const mt2203& other); - - mt2203& operator=(mt2203&& other); - - ~mt2203(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `mt2203(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine (for this case multiple generators of the set would be used) - * - `mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`_ - - Constructor for common seed initialization of the engine (for this case single generator of the set would be used) - * - `mt2203(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine (for this case multiple generators of the set would be used) - * - `mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx)`_ - - Constructor for extended seed initialization of the engine (for this case single generator of the set would be used) - * - `mt2203(const mt2203& other)`_ - - Copy constructor - * - `mt2203(mt2203&& other)`_ - - Move constructor - * - `mt2203& operator=(const mt2203& other)`_ - - Copy assignment operator - * - `mt2203& operator=(mt2203&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`mt2203(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - mt2203::mt2203(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - .. _`mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`: - - .. code-block:: cpp - - mt2203::mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - engine_idx - The index of the set 1, ..., 6024. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`idx > 6024` - - .. _`mt2203(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - mt2203::mt2203(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - .. _`mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx)`: - - .. code-block:: cpp - - mt2203::mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. - - engine_idx - The index of the set 1, ..., 6024. - - .. _`mt2203(const mt2203& other)`: - - .. code-block:: cpp - - mt2203::mt2203(const mt2203& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt2203`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mt2203(mt2203&& other)`: - - .. code-block:: cpp - - mt2203::mt2203(mt2203&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt2203`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`mt2203& operator=(const mt2203& other)`: - - .. code-block:: cpp - - mt2203::mt2203& operator=(const mt2203& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt2203`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`mt2203& operator=(mt2203&& other)`: - - .. code-block:: cpp - - mt2203::mt2203& operator=(mt2203&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``mt2203`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst deleted file mode 100644 index 2750ab124..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-multinomial.rst +++ /dev/null @@ -1,170 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_multinomial: - -multinomial -=========== - -Class is used for generation of multinomially distributed integer types random numbers. - -.. _onemath_rng_multinomial_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. - -The probability distribution is given by: - -.. math:: - - P(X_1 = x_1, ..., X_k = x_k) = \frac{m!}{\Pi^k_{i = 1}x_i!}\Pi^k_{i = 1}p_i^{x_i}, 0 \leq x_i \leq m, \sum^{k}_{i = 1}x_i = m - -.. _onemath_rng_multinomial_syntax: - -class multinomial ------------------ - -Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). -It's implementation defined which type ``SequenceContainerOrView`` represents. - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class multinomial { - public: - using method_type = Method; - using result_type = IntType; - explicit multinomial(double ntrial, SequenceContainerOrView p); - std::int32_t ntrial() const; - SequenceContainerOrView p() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - * ``std::uint32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::multinomial_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::multinomial_method::by_default`` - * ``oneapi::math::rng::multinomial_method::poisson_icdf_based`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `explicit multinomial(double ntrial, SequenceContainerOrView p)`_ - - Constructor with parameters - * - `std::int32_t ntrial() const`_ - - Method to obtain number of independent trials - * - `SequenceContainerOrView p() const`_ - - Method to obtain a probability parameter of possible outcomes - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - multinomial::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines the transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - multinomial::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines the type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`explicit multinomial(double ntrial, SequenceContainerOrView p)`: - - .. code-block:: cpp - - explicit multinomial::multinomial(double ntrial, SequenceContainerOrView p) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. ``ntrial`` is a number of independent trials, ``p`` is a probability parameter. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`ntrial < 0`, or :math:`p.size() < 1` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t ntrial() const`: - - .. code-block:: cpp - - std::int32_t multinomial::ntrial() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `ntrial`. - - .. container:: section - - .. _`SequenceContainerOrView p() const`: - - .. code-block:: cpp - - SequenceContainerOrView multinomial::p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `p`. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst deleted file mode 100644 index f2d6a32a1..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-negbinomial.rst +++ /dev/null @@ -1,191 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_negative_binomial: - -negative_binomial -================= - -Class is used for generation of negative binomially distributed integer types random numbers. - -.. _onemath_rng_negative_binomial_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. - -The probability distribution is given by: - -.. math:: - - P(X = k) = C^k_{a + k - 1}p^a(1 - p)^{k}, k \in \{0, 1, 2, ...\} - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, p}(x) = \left\{ \begin{array}{rcl} \sum^{\lfloor x \rfloor}_{k = 0} C^k_{a + k - 1}p^a(1 - p)^{k}, x \ge 0, x \in R \\ 0, x < 0 \end{array}\right. - - -.. _onemath_rng_negative_binomial_syntax: - -class negative_binomial ------------------------ - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class negative_binomial { - public: - using method_type = Method; - using result_type = IntType; - negative_binomial(); - explicit negative_binomial(double a, double p); - double a() const; - double p() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - * ``std::uint32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::negative_binomial_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::negative_binomial_method::by_default`` - * ``oneapi::math::rng::negative_binomial_method::nbar`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `negative_binomial()`_ - - Default constructor - * - `explicit negative_binomial(double a, double p)`_ - - Constructor with parameters - * - `double a() const`_ - - Method to obtain the first distribution parameter `a` - * - `double p() const`_ - - Method to obtain the second distribution parameter `p` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - negative_binomial::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - negative_binomial::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`negative_binomial()`: - - .. code-block:: cpp - - negative_binomial::negative_binomial() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.1, `p` = 0.5. - - .. container:: section - - .. _`explicit negative_binomial(double a, double p)`: - - .. code-block:: cpp - - explicit negative_binomial::negative_binomial(double a, double p) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is the first distribution parameter, `p` is the second distribution parameter. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`p \ge 1.0`, or :math:`p \leq 0.0`, or :math:`a \leq 0.0` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`double a() const`: - - .. code-block:: cpp - - double negative_binomial::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - the first distribution parameter. - - .. container:: section - - .. _`double p() const`: - - .. code-block:: cpp - - double negative_binomial::p() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `p` - the second distribution parameter. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst deleted file mode 100644 index 114a210b6..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-niederreiter.rst +++ /dev/null @@ -1,169 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_niederreiter: - -niederreiter -============ - -The niederreiter generator is a 32-bit Gray code-based quasi-random number generator. - -.. _onemath_rng_niederreiter_description: - -.. rubric:: Description - -According to results of Bratley, Fox and Niederreiter :ref:`[Bratley92] ` Niederreiter sequences have the best known theoretical asymptotic properties. The default dimension of quasi-random vectors can vary from 1 to 318 inclusive. It is also allowed to register user-defined parameters (irreducible polynomials). - -.. container:: section - - .. rubric:: Generation algorithm - - - :math:`x_n=x_{n_1} \oplus v_c` - - :math:`u_n=x_n / 2 ^ {32}` - - The value :math:`c` is the right-most zero bit in :math:`n-1`; :math:`x_n` is s-dimensional vector of 32-bit values. The s-dimensional vectors (calculated during engine initialization) :math:`v_i, i = 1, 32` are called direction numbers. The vector :math:`u_n` is the generator output normalized to the unit hypercube :math:`(0, 1) ^ s`. - -.. _onemath_rng_niederreiter_description_syntax: - -class niederreiter ------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class niederreiter { - public: - static constexpr std::uint32_t default_dimensions_number = 1; - - niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number); - - niederreiter(sycl::queue queue, std::vector& irred_polynomials); - - niederreiter(const niederreiter& other); - - niederreiter(niederreiter&& other); - - niederreiter& operator=(const niederreiter& other); - - niederreiter& operator=(niederreiter&& other); - - ~niederreiter(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`_ - - Constructor with specified number of dimensions. The value should be :math:`1..318`. - * - `niederreiter(sycl::queue queue, std::vector& irred_polynomials)`_ - - Constructor for extended use-case, when it's needed to use the number of dimensions greater than 318 or obtain another sequence. - * - `niederreiter(const niederreiter& other)`_ - - Copy constructor - * - `niederreiter(niederreiter&& other)`_ - - Move constructor - * - `niederreiter& operator=(const niederreiter& other)`_ - - Copy assignment operator - * - `niederreiter& operator=(niederreiter&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`: - - .. code-block:: cpp - - niederreiter::niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - dimensions - Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 318`, assume :math:`dimen = 1`. - - .. _`niederreiter(sycl::queue queue, std::vector& irred_polynomials)`: - - .. code-block:: cpp - - niederreiter::niederreiter(sycl::queue queue, std::vector& irred_polynomials) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - irred_polynomials - If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own irreducible polynomials. The number of dimensions corresponds to the length of the vector. - - .. _`niederreiter(const niederreiter& other)`: - - .. code-block:: cpp - - niederreiter::niederreiter(const niederreiter& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``niederreiter`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`niederreiter(niederreiter&& other)`: - - .. code-block:: cpp - - niederreiter::niederreiter(niederreiter&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``niederreiter`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`niederreiter& operator=(const niederreiter& other)`: - - .. code-block:: cpp - - niederreiter::niederreiter& operator=(const niederreiter& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``niederreiter`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`niederreiter& operator=(niederreiter&& other)`: - - .. code-block:: cpp - - niederreiter::niederreiter& operator=(niederreiter&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``niederreiter`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst deleted file mode 100644 index 886c09a51..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-nondeterministic.rst +++ /dev/null @@ -1,134 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_nondeterministic: - -nondeterministic -================ - -Non-deterministic random number generator. - -.. _onemath_rng_nondeterministic_description: - -.. rubric:: Description - -Implementation defined generator with non-deterministic source of randomness (for example, a hardware device). - -.. _onemath_rng_nondeterministic_description_syntax: - -class nondeterministic ----------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class nondeterministic { - public: - nondeterministic(sycl::queue queue); - - nondeterministic(const nondeterministic& other); - - nondeterministic(nondeterministic&& other); - - nondeterministic& operator=(const nondeterministic& other); - - nondeterministic& operator=(nondeterministic&& other); - - ~nondeterministic(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `nondeterministic(sycl::queue queue)`_ - - Constructor for the particular device - * - `nondeterministic(const nondeterministic& other)`_ - - Copy constructor - * - `nondeterministic(nondeterministic&& other)`_ - - Move constructor - * - `nondeterministic& operator=(const nondeterministic& other)`_ - - Copy assignment operator - * - `nondeterministic& operator=(nondeterministic&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`nondeterministic(sycl::queue queue)`: - - .. code-block:: cpp - - nondeterministic::nondeterministic(sycl::queue queue) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - - .. _`nondeterministic(const nondeterministic& other)`: - - .. code-block:: cpp - - nondeterministic::nondeterministic(const nondeterministic& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`nondeterministic(nondeterministic&& other)`: - - .. code-block:: cpp - - nondeterministic::nondeterministic(nondeterministic&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`nondeterministic& operator=(const nondeterministic& other)`: - - .. code-block:: cpp - - nondeterministic::nondeterministic& operator=(const nondeterministic& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`nondeterministic& operator=(nondeterministic&& other)`: - - .. code-block:: cpp - - nondeterministic::nondeterministic& operator=(nondeterministic&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``nondeterministic`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst deleted file mode 100644 index c2b5d4d0a..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-philox4x32x10.rst +++ /dev/null @@ -1,196 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_philox4x32x10: - -philox4x32x10 -============= - -The Philox4x32x10 counter-based pseudorandom number generator. - -.. _onemath_rng_philox4x32x10_description: - -.. rubric:: Description - -The Philox4x32x10 engine is a keyed family of generator of counter-based BRNG. The state consists of 128-bit integer counter :math:`c` and two 32-bits keys :math:`k_0` and :math:`k_1`. - -.. container:: section - - .. rubric:: Generation algorithm - - The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: - - 1. :math:`c_n=c_{n-1} + 1` - 2. :math:`\omega_n = f(c_n)`, where :math:`f` is a function that takes 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: - 2.1. The argument :math:`c` is interpreted as four 32-bit numbers :math:`c = \overline{L_1 R_1 L_0 R_0}`, where :math:`\overline{A B C D} = A \cdot 2^{96} + B \cdot 2^{64} + C \cdot 2^{32} + D`, put :math:`k_0^0 =k_0, k_1^0=k_1`. - - 2.2. The following recurrence is calculated: - - :math:`L_1^{i+1} =mullo(R_1^i, 0xD2511F53)` - - :math:`R_1^{i+1} =mulhi(R_0^i, 0xCD9E8D57) \oplus k_0^i \oplus L_0^i` - - :math:`L_0^{i+1} =mullo(R_0^i, 0xCD9E8D57)` - - :math:`R_0^{i+1} =mulhi(R_1^i, 0xD2511F53) \oplus k_1^i \oplus L_1^i` - - :math:`k_0^{i+1} =k_0^i + 0xBB67AE85` - - :math:`k_1^{i+1} =k_1^i + 0x9E3779B9`, where :math:`mulhi(a, b)` and :math:`mullo(a, b)` are high and low parts of the :math:`a \cdot b` product respectively. - - 2.3. Put :math:`f(c) = \overline{L_1^N R_1^N L_0^N R_0^N}`, where :math:`N = 10` - - 3. Integer output: :math:`r_{4n + k} = \omega_n(k)`, where :math:`\omega_n(k)` is the k-th 32-bit integer in quadruple :math:`\omega_n, k = 0, 1, 2, 3` - 4. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` - -.. _onemath_rng_philox4x32x10_description_syntax: - -class philox4x32x10 -------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class philox4x32x10 { - public: - static constexpr std::uint64_t default_seed = 0; - - philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed); - - philox4x32x10(sycl::queue queue, std::initializer_list seed); - - philox4x32x10(const philox4x32x10& other); - - philox4x32x10(philox4x32x10&& other); - - philox4x32x10& operator=(const philox4x32x10& other); - - philox4x32x10& operator=(philox4x32x10&& other); - - ~philox4x32x10(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `philox4x32x10(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine - * - `philox4x32x10(const philox4x32x10& other)`_ - - Copy constructor - * - `philox4x32x10(philox4x32x10&& other)`_ - - Move constructor - * - `philox4x32x10& operator=(const philox4x32x10& other)`_ - - Copy assignment operator - * - `philox4x32x10& operator=(philox4x32x10&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is a 64-bit key, :math:`c` is a 128-bit counter. - - .. _`philox4x32x10(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume - if :math:`n = 0: k = 0, c = 0` - - if :math:`n = 1: k = seed[0], c = 0` - - if :math:`n = 2: k = seed[0], c = seed[1]` - - if :math:`n = 3: k = seed[0], c = seed[1] + seed[2] \cdot 2^{64}` - - for :math:`n > 3` following arguments are ignored - - .. _`philox4x32x10(const philox4x32x10& other)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10(const philox4x32x10& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``philox4x32x10`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`philox4x32x10(philox4x32x10&& other)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10(philox4x32x10&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``philox4x32x10`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`philox4x32x10& operator=(const philox4x32x10& other)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10& operator=(const philox4x32x10& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``philox4x32x10`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`philox4x32x10& operator=(philox4x32x10&& other)`: - - .. code-block:: cpp - - philox4x32x10::philox4x32x10& operator=(philox4x32x10&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``philox4x32x10`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst deleted file mode 100644 index d7b2c4b24..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson.rst +++ /dev/null @@ -1,173 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_poisson: - -poisson -======= - -Class is used for generation of Poisson distributed integer types random numbers. - -.. _onemath_rng_poisson_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. - -The probability distribution is given by: - -.. math:: - - P(X = k) = \frac{\lambda^ke^{-\lambda}}{k!}. - -The cumulative distribution function is as follows: - -.. math:: - - F_{\lambda}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda^ke^{-\lambda}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. - -.. _onemath_rng_poisson_syntax: - -class poisson -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class poisson { - public: - using method_type = Method; - using result_type = IntType; - poisson(); - explicit poisson(double lambda); - double lambda() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::poisson_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::poisson_method::by_default`` - * ``oneapi::math::rng::poisson_method::ptpe`` - * ``oneapi::math::rng::poisson_method::gaussian_icdf_based`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `poisson()`_ - - Default constructor - * - `explicit poisson(double lambda)`_ - - Constructor with parameters - * - `double lambda() const`_ - - Method to obtain distribution parameter - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - poisson::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - poisson::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`poisson()`: - - .. code-block:: cpp - - poisson::poisson() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `lambda` = 0.5. - - .. container:: section - - .. _`explicit poisson(double lambda)`: - - .. code-block:: cpp - - explicit poisson::poisson(double lambda) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `lambda` is a distribution parameter. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`lambda \leq 0.0` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`double lambda() const`: - - .. code-block:: cpp - - double poisson::lambda() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `lambda`. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst deleted file mode 100644 index 1a254bebe..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-poisson_v.rst +++ /dev/null @@ -1,159 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_poisson_v: - -poisson_v -========= - -Class is used for generation of Poisson distributed integer types random numbers with varying mean. - -.. _onemath_rng_poisson_v_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide -n random numbers Poisson distributed, with distribution parameter :math:`\lambda_i`, where :math:`\lambda_i \in R; \lambda_i > 0; i = 1, ... , n`. - -The probability distribution is given by: - -.. math:: - - P(X_i = k) = \frac{\lambda_i^ke^{-\lambda_i}}{k!}, k \in \{0, 1, 2, ... \}. - -The cumulative distribution function is as follows: - -.. math:: - - F_{\lambda_i}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda_i^ke^{-\lambda_i}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. - -.. _onemath_rng_poisson_v_syntax: - -class poisson_v ---------------- - -Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). -It's implementation defined which type ``SequenceContainerOrView`` represents. - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class poisson_v { - public: - using method_type = Method; - using result_type = IntType; - explicit poisson_v(SequenceContainerOrView lambda); - SequenceContainerOrView lambda() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename IntType - Type of the produced values. Supported types: - * ``std::int32_t`` - - .. container:: section - - typename Method = oneapi::math::rng::poisson_v_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::poisson_v_method::by_default`` - * ``oneapi::math::rng::poisson_v_method::gaussian_icdf_based`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `explicit poisson_v(SequenceContainerOrView lambda)`_ - - Constructor with parameters - * - `SequenceContainerOrView lambda() const`_ - - Method to obtain distribution parameter - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - poisson_v::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - poisson_v::result_type = IntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`explicit poisson_v(SequenceContainerOrView lambda)`: - - .. code-block:: cpp - - explicit poisson_v::poisson_v(SequenceContainerOrView lambda) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. ``lambda`` is a distribution parameter. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`lambda.size() \leq 1` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`SequenceContainerOrView lambda() const`: - - .. code-block:: cpp - - SequenceContainerOrView poisson_v::lambda() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter ``lambda``. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst deleted file mode 100644 index 948a4c695..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-r250.rst +++ /dev/null @@ -1,169 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_r250: - -r250 -==== - -The 32-bit generalized feedback shift register pseudorandom number generator GFSR(250,103) :ref:`[Kirkpatrick81] `. - -.. _onemath_rng_r250_description: - -.. rubric:: Description - -Feedback shift register generators possess ample theoretical foundation and were initially intended for cryptographic and communication applications. The stream state is the array of 250 32-bit integers. - -.. container:: section - - .. rubric:: Generation algorithm - - - :math:`x_n=x_{n-103} \oplus x_{n-250}` - - :math:`u_n=x_n / 2 ^ {32}` - - -.. _onemath_rng_r250_description_syntax: - -class r250 ----------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class r250 { - public: - static constexpr std::uint32_t default_seed = 1; - - r250(sycl::queue queue, std::uint32_t seed = default_seed); - - r250(sycl::queue queue, std::vector seed); - - r250(const r250& other); - - r250(r250&& other); - - r250& operator=(const r250& other); - - r250& operator=(r250&& other); - - ~r250(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `r250(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `r250(sycl::queue queue, std::vector seed)`_ - - Constructor for extended seed initialization of the engine - * - `r250(const r250& other)`_ - - Copy constructor - * - `r250(r250&& other)`_ - - Move constructor - * - `r250& operator=(const r250& other)`_ - - Copy assignment operator - * - `r250& operator=(r250&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`r250(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - r250::r250(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume :math:`x_{-250} = seed`. If :math:`seed = 0`, assume :math:`seed = 1`. Other values in state are initialized according to recurrent correlation :math:`x_{n+1} = 69069x_{n}(mod \ 2 ^ {32})`. Then the values :math:`x_{7k-247}, k = 0, 1, ..., 31` are interpreted as a binary matrix of size 32 x 32 and diagonal bits are set to 0, the under-diagonal bits to 0. - - .. _`r250(sycl::queue queue, std::vector seed)`: - - .. code-block:: cpp - - r250::r250(sycl::queue queue, std::vector seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state - if :math:`n \geqslant 0: x_{k-250} = seed[k], k = 0, 1, ..., 249` - - .. _`r250(const r250& other)`: - - .. code-block:: cpp - - r250::r250(const r250& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``r250`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`r250(r250&& other)`: - - .. code-block:: cpp - - r250::r250(r250&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``r250`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`r250& operator=(const r250& other)`: - - .. code-block:: cpp - - r250::r250& operator=(const r250& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``r250`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`r250& operator=(r250&& other)`: - - .. code-block:: cpp - - r250::r250& operator=(r250&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``r250`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst deleted file mode 100644 index 76d584622..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-rayleigh.rst +++ /dev/null @@ -1,193 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_rayleigh: - -rayleigh -======== - -Class is used for generation of Rayleigh distributed real types random numbers. - -.. _onemath_rng_rayleigh_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. - -The Rayleigh distribution is a special case of the :ref:`onemath_rng_weibull` distribution, where the shape parameter `\alpha` = 2 . - -The probability distribution is given by: - -.. math:: - - f_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{2(x - a)}{\beta^2}exp(-\frac{(x - a)^2)}{\beta^2}), x \ge a \\ 0, x < a \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{(x - a)^2)}{\beta^2}), x \ge a \\ 0, x < a \end{array}\right. - -.. _onemath_rng_rayleigh_syntax: - -class rayleigh --------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class rayleigh { - public: - using method_type = Method; - using result_type = RealType; - rayleigh(); - explicit rayleigh(RealType a, RealType b); - RealType a() const; - RealType b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::rayleigh_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::rayleigh_method::by_default`` - * ``oneapi::math::rng::rayleigh_method::icdf`` - * ``oneapi::math::rng::rayleigh_method::icdf_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `rayleigh()`_ - - Default constructor - * - `explicit rayleigh(RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType b() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - rayleigh::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - rayleigh::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`rayleigh()`: - - .. code-block:: cpp - - rayleigh::rayleigh() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, and `b` = 1.0. - - .. container:: section - - .. _`explicit rayleigh(RealType a, RealType b)`: - - .. code-block:: cpp - - explicit rayleigh::rayleigh(RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a displacement value, `b` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`b \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType rayleigh::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement value. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType rayleigh::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst deleted file mode 100644 index 770d82d03..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sfmt19937.rst +++ /dev/null @@ -1,179 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_sfmt19937: - -sfmt19937 -========= - -The SIMD-oriented Mersenne Twister pseudorandom number generator. - -.. _onemath_rng_sfmt19937_description: - -.. rubric:: Description - -SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [:ref:`Saito08 `] with a period length equal to :math:`2 ^ {19937}-1` of the produced sequence. The state of the engine contains the array of 156 128-bit integers. - -.. container:: section - - .. rubric:: Generation algorithm - - :math:`w_n = w_0 A \oplus w_M B \oplus w_{n-2} C \oplus w_{n-1} D` - - Where :math:`w_0, w_M, w_{n-2}, ...` are the 128-bit integers, and :math:`wA, wB, wC, wD` operations are defined as follows: - - :math:`wA = (w << 8) \oplus w`, left shift of 128-bit integer :math:`w` by :math:`a` followed by exclusive-or operation - - :math:`wB = (w >> 8) \& mask`, right shift of each 32-bit integer in quadruple :math:`w` by and-operator with quadruple of 32-bit masks :math:`mask = (0xBFFFFFF6, 0xDFFAFFFF, 0xDDFECB7F, 0xDFFFFFEF)` - - :math:`wC = (w >> 8) \oplus w`, right shift of 128-bit integer :math:`w` - - :math:`wD = (w << 8)`, left shift of each 32-bit integer in quadruple :math:`w` - - Integer output: :math:`r_{4n+k} = w_{n}(k)`, where :math:`w_{n}(k)` is the k-th 32-bit integer in quadruple :math:`w_{n}, k = 0, 1, 2, 3` - - :math:`u_n = (int) r_n / 2^{32} + 1/2` - - -.. _onemath_rng_sfmt19937_description_syntax: - -class sfmt19937 ---------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class sfmt19937 { - public: - static constexpr std::uint32_t default_seed = 1; - - sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed); - - sfmt19937(sycl::queue queue, std::initializer_list seed); - - sfmt19937(const sfmt19937& other); - - sfmt19937(sfmt19937&& other); - - sfmt19937& operator=(const sfmt19937& other); - - sfmt19937& operator=(sfmt19937&& other); - - ~sfmt19937(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine - * - `sfmt19937(sycl::queue queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine - * - `sfmt19937(const sfmt19937& other)`_ - - Copy constructor - * - `sfmt19937(sfmt19937&& other)`_ - - Move constructor - * - `sfmt19937& operator=(const sfmt19937& other)`_ - - Copy assignment operator - * - `sfmt19937& operator=(sfmt19937&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. - - .. _`sfmt19937(sycl::queue queue, std::initializer_list seed)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937(sycl::queue queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. - - .. _`sfmt19937(const sfmt19937& other)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937(const sfmt19937& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`sfmt19937(sfmt19937&& other)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937(sfmt19937&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`sfmt19937& operator=(const sfmt19937& other)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937& operator=(const sfmt19937& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`sfmt19937& operator=(sfmt19937&& other)`: - - .. code-block:: cpp - - sfmt19937::sfmt19937& operator=(sfmt19937&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sfmt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst deleted file mode 100644 index dc6c616a7..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-skip_ahead.rst +++ /dev/null @@ -1,121 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_skip_ahead: - -skip_ahead -========== - -Proceed state of engine by the skip-ahead method. - -.. _onemath_rng_skip_ahead_description: - -.. rubric:: Description and Assumptions - -oneapi::math::rng::skip_ahead function changes the current state of the engine so that with the further call of the generator the output subsequence begins with the specified offset see `Figure "Block-Splitting Method" <#rng_block_splitting>`__. - -.. container:: figtop - :name: rng_block_splitting - - Block-Splitting Method - - |image0| - -.. _onemath_rng_skip_ahead_common: - -skip_ahead ----------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - void skip_ahead(EngineType& engine, std::uint64_t num_to_skip); - } - -.. container:: section - - .. rubric:: Template Parameters - - EngineType - Type of engine. Note: may not be supported by all available engine classes. - -.. container:: section - - .. rubric:: Input Parameters - - engine - Engine which state would be skipped. - - num_to_skip - Number of elements to skip in the engine's sequence. - -.. rubric:: Example - -.. code-block:: cpp - - // Creating 3 identical engines - oneapi::math::rng::mcg31m1 engine_1(queue, seed); - oneapi::math::rng::mcg31m1 engine_2(engine_1); - oneapi::math::rng::mcg31m1 engine_3(engine_2); - - // Skipping ahead by 7 elements the 2nd engine - oneapi::math::rng::skip_ahead(engine_2, 7); - - // Skipping ahead by 14 elements the 3rd engine - oneapi::math::rng::skip_ahead(engine_3, 14); - - -.. _onemath_rng_skip_ahead_ex: - -skip_ahead (Interface with a partitioned number of skipped elements) --------------------------------------------------------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - void oneapi::math::rng::skip_ahead(EngineType& engine, std::initializer_list num_to_skip); - } - -.. container:: section - - .. rubric:: Template Parameters - - EngineType - Type of engine. Note: may not be supported by all available engine classes. - -.. container:: section - - .. rubric:: Input Parameters - - engine - Engine which state would be skipped. - - num_to_skip - Partitioned number of elements to skip in the engine's sequence. The total number of skipped elements would be: :math:`num\_to\_skip[0] + num\_to\_skip[1] \cdot 2^{64} + ... + num\_to\_skip[1] \cdot 2^{64 (n - 1)}`, where n is a number of elements in num_to_skip list. - -.. rubric:: Example with Partitioned Numer of Elements - -.. code-block:: cpp - - // Creating the first engine - oneapi::math::rng::mrg32k3a engine_1(queue, seed); - - // To skip 2^64 elements in the random stream number of skipped elements should be - // represented as num_to_skip = 2^64 = 0 + 1 * 2^64 - std::initializer_list num_to_skip = {0, 1}; - - // Creating the 2nd engine based on 1st. Skipping by 2^64 - oneapi::math::rng::mrg32k3a engine_2(engine_1); - oneapi::math::rng::skip_ahead(engine_2, num_to_skip); - - -**Parent topic:** :ref:`onemath_rng_service_routines` - -.. |image0| image:: ../../equations/rng-skip-ahead.png diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst deleted file mode 100644 index 4fb71cdf7..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-sobol.rst +++ /dev/null @@ -1,169 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_sobol: - -sobol -===== - -The sobol is a 32-bit Gray code-based quasi-random number generator. - -.. _onemath_rng_sobol_description: - -.. rubric:: Description - -Bratley and Fox :ref:`[Bratley88] ` provide an implementation of the SOBOL quasi-random number generator. The default dimensions of quasi-random vectors can vary from 1 to 40 inclusive. It is also allowed to register user-defined parameters (direction numbers). - -.. container:: section - - .. rubric:: Generation algorithm - - - :math:`x_n=x_{n_1} \oplus v_c` - - :math:`u_n=x_n / 2 ^ {32}` - - The value :math:`c` is the right-most zero bit in :math:`n-1`; :math:`x_n` is s-dimensional vector of 32-bit values. The s-dimensional vectors (calculated during engine initialization) :math:`v_i, i = 1, 32` are called direction numbers. The vector :math:`u_n` is the generator output normalized to the unit hypercube :math:`(0, 1) ^ s`. - -.. _onemath_rng_sobol_description_syntax: - -class sobol ------------ - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class sobol { - public: - static constexpr std::uint32_t default_dimensions_number = 1; - - sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number); - - sobol(sycl::queue queue, std::vector& direction_numbers); - - sobol(const sobol& other); - - sobol(sobol&& other); - - sobol& operator=(const sobol& other); - - sobol& operator=(sobol&& other); - - ~sobol(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`_ - - Constructor with specified number of dimensions. The value should be :math:`1..40`. - * - `sobol(sycl::queue queue, std::vector& direction_numbers)`_ - - Constructor for extended use-case, when it's needed to use the number of dimensions greater than 40 or obtain another sequence. - * - `sobol(const sobol& other)`_ - - Copy constructor - * - `sobol(sobol&& other)`_ - - Move constructor - * - `sobol& operator=(const sobol& other)`_ - - Copy assignment operator - * - `sobol& operator=(sobol&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`: - - .. code-block:: cpp - - sobol::sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - dimensions - Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 40`, assume :math:`dimen = 1`. - - .. _`sobol(sycl::queue queue, std::vector& direction_numbers)`: - - .. code-block:: cpp - - sobol::sobol(sycl::queue queue, std::vector& direction_numbers) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - direction_numbers - If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own direction_numbers. The number of dimensions corresponds to direction_numbers.size() / 32. - - .. _`sobol(const sobol& other)`: - - .. code-block:: cpp - - sobol::sobol(const sobol& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sobol`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`sobol(sobol&& other)`: - - .. code-block:: cpp - - sobol::sobol(sobol&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sobol`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`sobol& operator=(const sobol& other)`: - - .. code-block:: cpp - - sobol::sobol& operator=(const sobol& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sobol`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`sobol& operator=(sobol&& other)`: - - .. code-block:: cpp - - sobol::sobol& operator=(sobol&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``sobol`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst deleted file mode 100644 index 092080977..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-continuous.rst +++ /dev/null @@ -1,193 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_uniform_continuous: - -uniform (continuous) -==================== - -Class is used for generation of uniformly distributed real types random numbers. - -.. _onemath_rng_uniform_continuous_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the -interval, respectively, and :math:`a, b \in R; a < b` - -The probability distribution is given by: - -.. math:: - - f_{a, b}(x) = \left\{ \begin{array}{rcl} \frac{1}{b-a}, x \in [a, b) \\ 0, x \notin [a, b) \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{x - a}{b - a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. - - -.. _onemath_rng_uniform_continuous_syntax: - -class uniform -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class uniform { - public: - using method_type = Method; - using result_type = RealType; - uniform(); - explicit uniform(RealType a, RealType b); - RealType a() const; - RealType b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::uniform_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::uniform_method::by_default`` - * ``oneapi::math::rng::uniform_method::standard`` - * ``oneapi::math::rng::uniform_method::accurate`` - - See description of the methods in :ref:`Distributions methods template parameter` - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `uniform()`_ - - Default constructor - * - `explicit uniform(RealType a, RealType b)`_ - - Constructor with parameters - * - `RealType a() const`_ - - Method to obtain left bound `a` - * - `RealType b() const`_ - - Method to obtain right bound `b` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - uniform::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - uniform::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`uniform()`: - - .. code-block:: cpp - - uniform::uniform() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0.0, `b` = 1.0. - - .. container:: section - - .. _`explicit uniform(RealType a, RealType b)`: - - .. code-block:: cpp - - explicit uniform::uniform(RealType a, RealType b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a left bound, `b` is a right bound, assume :math:`a < b`. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`a \ge b` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType uniform::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - left bound. - - .. container:: section - - .. _`RealType b() const`: - - .. code-block:: cpp - - RealType uniform::b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - right bound. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst deleted file mode 100644 index bdbff1c9f..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform-discrete.rst +++ /dev/null @@ -1,185 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_uniform_discrete: - -uniform (discrete) -================== - -Class is used for generation of uniformly distributed integer types random numbers. - -.. _onemath_rng_uniform_discrete_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the -interval, respectively, and :math:`a, b \in R; a < b`. - -The probability distribution is given by: - -.. math:: - - P(X = k) = \frac{1}{b - a}, k \in \{a, a + 1, ... , b - 1\} - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{\lfloor x - a + 1 \rfloor}{b-a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. - - -.. _onemath_rng_uniform_discrete_syntax: - -class uniform -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class uniform { - public: - using method_type = Method; - using result_type = std::int32_t; - uniform(); - explicit uniform(std::int32_t a, std::int32_t b); - std::int32_t a() const; - std::int32_t b() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename Method = oneapi::math::rng::uniform_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::uniform_method::by_default`` - * ``oneapi::math::rng::uniform_method::standard`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `uniform()`_ - - Default constructor - * - `explicit uniform(std::int32_t a, std::int32_t b)`_ - - Constructor with parameters - * - `std::int32_t a() const`_ - - Method to obtain left bound `a` - * - `std::int32_t b() const`_ - - Method to obtain right bound `b` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - result_type = std::int32_t - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`uniform()`: - - .. code-block:: cpp - - uniform() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `a` = 0, `b` = std::numeric_limits::max(). - - .. container:: section - - .. _`explicit uniform(std::int32_t a, std::int32_t b)`: - - .. code-block:: cpp - - uniform(std::int32_t a, std::int32_t b) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `a` is a left bound, `b` is a right bound, assume :math:`a < b`. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`a \ge b` - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`std::int32_t a() const`: - - .. code-block:: cpp - - a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - left bound. - - .. container:: section - - .. _`std::int32_t b() const`: - - .. code-block:: cpp - - b() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `b` - right bound. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst deleted file mode 100644 index 748c16a31..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-uniform_bits.rst +++ /dev/null @@ -1,60 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_uniform_bits: - -uniform_bits -============ - -Class is used for generation of uniformly distributed bits in 32/64-bit chunks. - -.. _onemath_rng_uniform_bits_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. - -class uniform_bits ------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class uniform_bits { - public: - using result_type = UIntType; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename UIntType - Type of the produced values. Supported types: - * ``std::uint32_t`` - * ``std::uint64_t`` - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - uniform_bits::result_type = UIntType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst deleted file mode 100644 index bb2ce4cd6..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-weibull.rst +++ /dev/null @@ -1,208 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_weibull: - -weibull -======= - -Class is used for generation of Weibull distributed real types random numbers. - -.. _onemath_rng_weibull_description: - -.. rubric:: Description - -The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. - -The probability distribution is given by: - -.. math:: - - f_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{\alpha}{\beta^\alpha}(x - a)^{\alpha - 1}exp((-\frac{x - a}{\beta})^{\alpha}), x \ge a \\ 0, x < a \end{array}\right. - -The cumulative distribution function is as follows: - -.. math:: - - F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp((-\frac{x - a}{\beta})^{\alpha}), x \ge a \\ 0, x < a \end{array}\right. - -.. _onemath_rng_weibull_syntax: - -class weibull -------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - template - class weibull { - public: - using method_type = Method; - using result_type = RealType; - weibull(); - explicit weibull(RealType alpha, RealType a, RealType b); - RealType alpha() const; - RealType a() const; - RealType beta() const; - }; - } - -.. container:: section - - .. rubric:: Template parameters - - .. container:: section - - typename RealType - Type of the produced values. Supported types: - * ``float`` - * ``double`` - - .. container:: section - - typename Method = oneapi::math::rng::weibull_method::by_default - Transformation method, which will be used for generation. Supported types: - - * ``oneapi::math::rng::weibull_method::by_default`` - * ``oneapi::math::rng::weibull_method::icdf`` - * ``oneapi::math::rng::weibull_method::icdf_accurate`` - - See description of the methods in :ref:`Distributions methods template parameter`. - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `weibull()`_ - - Default constructor - * - `explicit weibull(RealType alpha, RealType a, RealType beta)`_ - - Constructor with parameters - * - `RealType alpha() const`_ - - Method to obtain shape value - * - `RealType a() const`_ - - Method to obtain displacement value - * - `RealType beta() const`_ - - Method to obtain scalefactor value - -.. container:: section - - .. rubric:: Member types - - .. container:: section - - .. code-block:: cpp - - weibull::method_type = Method - - .. container:: section - - .. rubric:: Description - - The type which defines transformation method for generation. - - .. container:: section - - .. code-block:: cpp - - weibull::result_type = RealType - - .. container:: section - - .. rubric:: Description - - The type which defines type of generated random numbers. - -.. container:: section - - .. rubric:: Constructors - - .. container:: section - - .. _`weibull()`: - - .. code-block:: cpp - - weibull::weibull() - - .. container:: section - - .. rubric:: Description - - Default constructor for distribution, parameters set as `alpha` = 1.0, `a` = 0.0, and `b` = 1.0. - - .. container:: section - - .. _`explicit weibull(RealType alpha, RealType a, RealType beta)`: - - .. code-block:: cpp - - explicit weibull::weibull(RealType alpha, RealType a, RealType beta) - - .. container:: section - - .. rubric:: Description - - Constructor with parameters. `alpha` is a shape value, `a` is a displacement value, `beta` is a scalefactor value. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) - -.. container:: section - - .. rubric:: Characteristics - - .. container:: section - - .. _`RealType alpha() const`: - - .. code-block:: cpp - - RealType weibull::alpha() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `alpha` - shape value. - - .. container:: section - - .. _`RealType a() const`: - - .. code-block:: cpp - - RealType weibull::a() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `a` - displacement value. - - .. container:: section - - .. _`RealType beta() const`: - - .. code-block:: cpp - - RealType weibull::beta() const - - .. container:: section - - .. rubric:: Return Value - - Returns the distribution parameter `beta` - scalefactor value. - -**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst b/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst deleted file mode 100644 index cc44cf4c4..000000000 --- a/source/elements/oneMath/source/domains/rng/host_api/mkl-rng-wichmann_hill.rst +++ /dev/null @@ -1,251 +0,0 @@ -.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation -.. -.. SPDX-License-Identifier: CC-BY-4.0 - -.. _onemath_rng_wichmann_hill: - -wichmann_hill -============= - -The wichmann_hill engine is the set of 273 Wichmann-Hill's combined multiplicative congruential generators from NAG Numerical Libraries :ref:`[NAG] `. - -.. _onemath_rng_wichmann_hill_description: - -.. rubric:: Description - -The set of 372 different basic pseudorandom number generators wichmann_hill is the second basic generator in the NAG libraries. - -.. container:: section - - .. rubric:: Generation algorithm - - :math:`x_n=a_{1, j} x_{n-1} (mod \ m_{1, j})` - - :math:`y_n = a_{2, j} y_{n-1} (mod \ m_{2, j})` - - :math:`z_n = a_{3, j} z_{n-1} (mod \ m_{3, j})` - - :math:`w_n = a_{4, j} w_{n-1} (mod \ m_{4, j})` - - :math:`u_n = (x_n / m_{1, j} + y_n / m_{2, j} + z_n / m_{3, j} + w_n / m_{4, j}) mod \ 1` - - The constants :math:`a_{i, j}` range from 112 to 127, the constants :math:`m_{i, j}` are prime numbers ranging from 16718909 to 16776917, close to :math:`2 ^ {24}`. - - -.. _onemath_rng_wichmann_hill_description_syntax: - -class wichmann_hill -------------------- - -.. rubric:: Syntax - -.. code-block:: cpp - - namespace oneapi::math::rng { - class wichmann_hill { - public: - static constexpr std::uint32_t default_seed = 1; - - wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed); - - wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx); - - wichmann_hill(sycl::queue queue, std::initializer_list seed); - - wichmann_hill(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx); - - wichmann_hill(const wichmann_hill& other); - - wichmann_hill(wichmann_hill&& other); - - wichmann_hill& operator=(const wichmann_hill& other); - - wichmann_hill& operator=(wichmann_hill&& other); - - ~wichmann_hill(); - }; - } - -.. container:: section - - .. rubric:: Class Members - - .. list-table:: - :header-rows: 1 - - * - Routine - - Description - * - `wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed)`_ - - Constructor for common seed initialization of the engine (for this case multiple generators of the set would be used) - * - `wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`_ - - Constructor for common seed initialization of the engine (for this case single generator of the set would be used) - * - `wichmann_hill(sycl::queue& queue, std::initializer_list seed)`_ - - Constructor for extended seed initialization of the engine (for this case multiple generators of the set would be used) - * - `wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx)`_ - - Constructor for extended seed initialization of the engine (for this case single generator of the set would be used) - * - `wichmann_hill(const wichmann_hill& other)`_ - - Copy constructor - * - `wichmann_hill(wichmann_hill&& other)`_ - - Move constructor - * - `wichmann_hill& operator=(const wichmann_hill& other)`_ - - Copy assignment operator - * - `wichmann_hill& operator=(wichmann_hill&& other)`_ - - Move assignment operator - -.. container:: section - - .. rubric:: Constructors - - .. _`wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - .. _`wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - engine_idx - The index of the set 1, ..., 273. - - .. container:: section - - .. rubric:: Throws - - oneapi::math::invalid_argument - Exception is thrown when :math:`idx > 273` - - .. _`wichmann_hill(sycl::queue& queue, std::initializer_list seed)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(sycl::queue& queue, std::initializer_list seed) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume: - if :math:`n = 0: x_{0} = y_{0} = z_{0} = w_{0} = 1` - - if :math:`n = 1: x_{0} = seed[0] \ mod \ m_1, y_{0} = z_{0} = w_{0} = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - if :math:`n = 2: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = w_{0} = 1`. - - if :math:`n = 3: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = seed[2] \ mod \ m_3, w_{0} = 1`. - - if :math:`n \geqslant 4: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2` - - :math:`z_{0} = seed[2] \ mod \ m_3, w_{0} = seed[3] \ mod \ m_4`. - - - .. _`wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx) - - .. container:: section - - .. rubric:: Input Parameters - - queue - Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. - - seed - The initial conditions of the generator state, assume: - if :math:`n = 0: x_{0} = y_{0} = z_{0} = w_{0} = 1` - - if :math:`n = 1: x_{0} = seed[0] \ mod \ m_1, y_{0} = z_{0} = w_{0} = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. - - if :math:`n = 2: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = w_{0} = 1`. - - if :math:`n = 3: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = seed[2] \ mod \ m_3, w_{0} = 1`. - - if :math:`n \geqslant 4: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2` - - :math:`z_{0} = seed[2] \ mod \ m_3, w_{0} = seed[3] \ mod \ m_4`. - - engine_idx - The index of the set 1, ..., 273. - - .. _`wichmann_hill(const wichmann_hill& other)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(const wichmann_hill& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`wichmann_hill(wichmann_hill&& other)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill(wichmann_hill&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is moved to the current engine. - - .. _`wichmann_hill& operator=(const wichmann_hill& other)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill& operator=(const wichmann_hill& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. - - .. _`wichmann_hill& operator=(wichmann_hill&& other)`: - - .. code-block:: cpp - - wichmann_hill::wichmann_hill& operator=(wichmann_hill&& other) - - .. container:: section - - .. rubric:: Input Parameters - - other - Valid ``wichmann_hill`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. - -**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst b/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst index 78cb46e30..8c5d98231 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/service-routines.rst @@ -31,5 +31,5 @@ Host Service Routines .. toctree:: :hidden: - mkl-rng-leapfrog - mkl-rng-skip_ahead + onemath-rng-leapfrog + onemath-rng-skip_ahead diff --git a/source/elements/oneMath/source/index.rst b/source/elements/oneMath/source/index.rst index 8d4d608ef..471720b0a 100644 --- a/source/elements/oneMath/source/index.rst +++ b/source/elements/oneMath/source/index.rst @@ -8,7 +8,7 @@ oneMath ====== -The |mkl_full_name| (oneMath) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMath is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math. +The |onemath_full_name| (oneMath) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMath is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math. The general assumptions, design features and requirements for the oneMath library and host-to-device computational routines will be described in :ref:`onemath_architecture`. diff --git a/source/spelling_wordlist.txt b/source/spelling_wordlist.txt index 57ad846a4..2f3a58e21 100644 --- a/source/spelling_wordlist.txt +++ b/source/spelling_wordlist.txt @@ -496,7 +496,7 @@ microarchitecture middleware minibatch minmag -mkl +onemath modf moveassignable mrg From 358f8b120177b0fbfb2dc296672f1099219b3557 Mon Sep 17 00:00:00 2001 From: nscipione Date: Fri, 11 Oct 2024 17:32:34 +0200 Subject: [PATCH 04/16] Address warnings and removing trailing white-spaces Signed-off-by: nscipione --- .../source/architecture/api_design.inc.rst | 10 +- .../source/architecture/architecture.rst | 8 +- .../architecture/execution_model.inc.rst | 2 +- .../domains/blas/blas-level-1-routines.rst | 26 +- .../domains/blas/blas-level-2-routines.rst | 48 ++-- .../domains/blas/blas-level-3-routines.rst | 18 +- .../domains/blas/blas-like-extensions.rst | 10 +- .../rng/device_api/device-rng-usage-model.rst | 2 +- ...te-parameter-onemath-rng-method-values.rst | 99 +++++++ .../domains/rng/host_api/onemath-rng-ars5.rst | 200 ++++++++++++++ .../rng/host_api/onemath-rng-bernoulli.rst | 177 ++++++++++++ .../domains/rng/host_api/onemath-rng-beta.rst | 231 ++++++++++++++++ .../rng/host_api/onemath-rng-binomial.rst | 192 ++++++++++++++ .../domains/rng/host_api/onemath-rng-bits.rst | 59 ++++ .../rng/host_api/onemath-rng-cauchy.rst | 190 +++++++++++++ .../rng/host_api/onemath-rng-chi_square.rst | 174 ++++++++++++ .../host_api/onemath-rng-default_engine.rst | 30 +++ .../rng/host_api/onemath-rng-exponential.rst | 191 +++++++++++++ .../rng/host_api/onemath-rng-gamma.rst | 211 +++++++++++++++ .../rng/host_api/onemath-rng-gaussian.rst | 193 ++++++++++++++ .../rng/host_api/onemath-rng-gaussian_mv.rst | 199 ++++++++++++++ .../rng/host_api/onemath-rng-generate.rst | 130 +++++++++ .../rng/host_api/onemath-rng-geometric.rst | 173 ++++++++++++ .../rng/host_api/onemath-rng-gumbel.rst | 190 +++++++++++++ .../host_api/onemath-rng-hypergeometric.rst | 209 +++++++++++++++ .../rng/host_api/onemath-rng-laplace.rst | 188 +++++++++++++ .../rng/host_api/onemath-rng-leapfrog.rst | 79 ++++++ .../rng/host_api/onemath-rng-lognormal.rst | 227 ++++++++++++++++ .../rng/host_api/onemath-rng-mcg31m1.rst | 148 +++++++++++ .../rng/host_api/onemath-rng-mcg59.rst | 148 +++++++++++ .../rng/host_api/onemath-rng-mrg32k3a.rst | 201 ++++++++++++++ .../rng/host_api/onemath-rng-mt19937.rst | 189 +++++++++++++ .../rng/host_api/onemath-rng-mt2203.rst | 239 +++++++++++++++++ .../rng/host_api/onemath-rng-multinomial.rst | 170 ++++++++++++ .../rng/host_api/onemath-rng-negbinomial.rst | 191 +++++++++++++ .../rng/host_api/onemath-rng-niederreiter.rst | 169 ++++++++++++ .../host_api/onemath-rng-nondeterministic.rst | 134 ++++++++++ .../host_api/onemath-rng-philox4x32x10.rst | 196 ++++++++++++++ .../rng/host_api/onemath-rng-poisson.rst | 173 ++++++++++++ .../rng/host_api/onemath-rng-poisson_v.rst | 159 +++++++++++ .../domains/rng/host_api/onemath-rng-r250.rst | 169 ++++++++++++ .../rng/host_api/onemath-rng-rayleigh.rst | 193 ++++++++++++++ .../rng/host_api/onemath-rng-sfmt19937.rst | 179 +++++++++++++ .../rng/host_api/onemath-rng-skip_ahead.rst | 121 +++++++++ .../rng/host_api/onemath-rng-sobol.rst | 169 ++++++++++++ .../onemath-rng-uniform-continuous.rst | 193 ++++++++++++++ .../host_api/onemath-rng-uniform-discrete.rst | 185 +++++++++++++ .../rng/host_api/onemath-rng-uniform_bits.rst | 60 +++++ .../rng/host_api/onemath-rng-usage-model.rst | 2 +- .../rng/host_api/onemath-rng-weibull.rst | 208 +++++++++++++++ .../host_api/onemath-rng-wichmann_hill.rst | 251 ++++++++++++++++++ .../stats/onemath_stats_raw_moment.rst | 2 +- .../stats/onemath_stats_usage_model.rst | 2 +- .../onemath_stats_variation_user_mean.rst | 2 +- .../source/domains/vm/vm-exceptions.rst | 6 +- source/elements/oneMath/source/index.rst | 4 +- 56 files changed, 7258 insertions(+), 71 deletions(-) create mode 100644 source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-onemath-rng-method-values.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-ars5.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bernoulli.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-beta.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-binomial.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bits.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-cauchy.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-chi_square.rst create mode 100755 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-default_engine.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-exponential.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gamma.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian.rst create mode 100755 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian_mv.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-generate.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-geometric.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gumbel.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-hypergeometric.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-laplace.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-leapfrog.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-lognormal.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg31m1.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg59.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mrg32k3a.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt19937.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt2203.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-multinomial.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-negbinomial.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-niederreiter.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-nondeterministic.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-philox4x32x10.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson_v.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-r250.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-rayleigh.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sfmt19937.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-skip_ahead.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sobol.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-continuous.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-discrete.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform_bits.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-weibull.rst create mode 100644 source/elements/oneMath/source/domains/rng/host_api/onemath-rng-wichmann_hill.rst diff --git a/source/elements/oneMath/source/architecture/api_design.inc.rst b/source/elements/oneMath/source/architecture/api_design.inc.rst index 10093c729..c91c08b3a 100644 --- a/source/elements/oneMath/source/architecture/api_design.inc.rst +++ b/source/elements/oneMath/source/architecture/api_design.inc.rst @@ -31,11 +31,11 @@ namespace oneMath domain or content .. note:: :name: Implementation Requirement - Inside each oneMath domain, there are many routines, classes, enums and objects defined which constitute the breadth and scope of that oneMath domain. + Inside each oneMath domain, there are many routines, classes, enums and objects defined which constitute the breadth and scope of that oneMath domain. It is permitted for a library implementation of the oneMath specification to implement either all, one or more than one of the domains in oneMath. However, within an implementation of a specific domain, all relevant routines, classes, enums and objects (including those relevant enums and objects which live outside a particular domain in the general ``oneapi::math`` namespace must be both declared and defined in the library so that an application that uses that domain could build and link against that library implementation successfully. - It is however acceptable to throw the runtime exception :ref:`oneapi::math::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. - For instance, a library may choose to implement the oneMath BLAS functionality and in particular may choose to implement only the :ref:`onemath_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::math::unimplemented` exception inside all the others. + It is however acceptable to throw the runtime exception :ref:`oneapi::math::unimplemented` inside of the routines or class member functions in that domain that have not been fully implemented. + For instance, a library may choose to implement the oneMath BLAS functionality and in particular may choose to implement only the :ref:`onemath_blas_gemm` api for their library, in which case they must also include all the other blas namespaced routines and throw the :ref:`oneapi::math::unimplemented` exception inside all the others. In such a case, the implemented routines in such a library should be communicated clearly and easily understood by users of that library. @@ -71,9 +71,9 @@ oneMath uses the following DPC++ data types: .. _onemath_datatypes: oneMath defined datatypes -++++++++++++++++++++++++ ++++++++++++++++++++++++++ -oneMath dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::math`` namespace. +oneMath dense and sparse linear algebra routines use scoped enum types as type-safe replacements for the traditional character arguments used in C/Fortran implementations of BLAS and LAPACK. These types all belong to the ``oneapi::math`` namespace. Each enumeration value comes with two names: A single-character name (the traditional BLAS/LAPACK character) and a longer, more descriptive name. The two names are exactly equivalent and may be used interchangeably. diff --git a/source/elements/oneMath/source/architecture/architecture.rst b/source/elements/oneMath/source/architecture/architecture.rst index 248132c2c..64d76726f 100644 --- a/source/elements/oneMath/source/architecture/architecture.rst +++ b/source/elements/oneMath/source/architecture/architecture.rst @@ -7,12 +7,12 @@ oneMath Architecture ==================== -The oneMath element of oneAPI has several general assumptions, requirements and recommendations for all domains contained therein. These will be addressed in this architecture section. -In particular, DPC++ allows for a great control over the execution of kernels on the various devices. We discuss the supported execution models of oneMath APIs in :ref:`onemath_execution_model`. +The oneMath element of oneAPI has several general assumptions, requirements and recommendations for all domains contained therein. These will be addressed in this architecture section. +In particular, DPC++ allows for a great control over the execution of kernels on the various devices. We discuss the supported execution models of oneMath APIs in :ref:`onemath_execution_model`. A discussion of how data is stored and passed in and out of the APIs is addressed in :ref:`onemath_memory_model`. The general structure and design of oneMath APIs including namespaces and common data types are expressed in :ref:`onemath_api_design`. -The exceptions and error handling are described in :ref:`onemath_exceptions`. -Finally all the other necessary aspects related to oneMath architecture can be found in :ref:`onemath_arch_other` including versioning and discussion of pre and post conditions. +The exceptions and error handling are described in :ref:`onemath_exceptions`. +Finally all the other necessary aspects related to oneMath architecture can be found in :ref:`onemath_arch_other` including versioning and discussion of pre and post conditions. Other nonessential, but useful aspects of the oneMath architecture and design may also be found in the :ref:`onemath_appendix`. diff --git a/source/elements/oneMath/source/architecture/execution_model.inc.rst b/source/elements/oneMath/source/architecture/execution_model.inc.rst index 750406655..1b01302db 100644 --- a/source/elements/oneMath/source/architecture/execution_model.inc.rst +++ b/source/elements/oneMath/source/architecture/execution_model.inc.rst @@ -7,7 +7,7 @@ Execution Model --------------- -This section describes the execution environment common to all oneMath functionality. The execution environment includes how data is provided to computational routines in :ref:`onemath_queues`, support for several devices in :ref:`onemath_device_usage`, synchronous and asynchronous execution models in :ref:`onemath_asynchronous_synchronous_execution` and :ref:`onemath_host_thread_safety`. +This section describes the execution environment common to all oneMath functionality. The execution environment includes how data is provided to computational routines in :ref:`onemath_queues`, support for several devices in :ref:`onemath_device_usage`, synchronous and asynchronous execution models in :ref:`onemath_asynchronous_synchronous_execution` and :ref:`onemath_host_thread_safety`. .. _onemath_queues: diff --git a/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst index 0721fbc82..aa13886dc 100644 --- a/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-1-routines.rst @@ -23,37 +23,37 @@ BLAS Level 1 Routines * - Routines - Description - * - :ref:`onemath_blas_asum` + * - :ref:`onemath_blas_asum` - Sum of vector magnitudes - * - :ref:`onemath_blas_axpy` + * - :ref:`onemath_blas_axpy` - Scalar-vector product - * - :ref:`onemath_blas_copy` + * - :ref:`onemath_blas_copy` - Copy vector - * - :ref:`onemath_blas_dot` + * - :ref:`onemath_blas_dot` - Dot product - * - :ref:`onemath_blas_sdsdot` + * - :ref:`onemath_blas_sdsdot` - Dot product with double precision - * - :ref:`onemath_blas_dotc` + * - :ref:`onemath_blas_dotc` - Dot product conjugated * - :ref:`onemath_blas_dotu` - Dot product unconjugated - * - :ref:`onemath_blas_nrm2` + * - :ref:`onemath_blas_nrm2` - Vector 2-norm (Euclidean norm) * - :ref:`onemath_blas_rot` - Plane rotation of points - * - :ref:`onemath_blas_rotg` + * - :ref:`onemath_blas_rotg` - Generate Givens rotation of points - * - :ref:`onemath_blas_rotm` + * - :ref:`onemath_blas_rotm` - Modified Givens plane rotation of points - * - :ref:`onemath_blas_rotmg` + * - :ref:`onemath_blas_rotmg` - Generate modified Givens plane rotation of points * - :ref:`onemath_blas_scal` - Vector-scalar product - * - :ref:`onemath_blas_swap` + * - :ref:`onemath_blas_swap` - Vector-vector swap - * - :ref:`onemath_blas_iamax` + * - :ref:`onemath_blas_iamax` - Index of the maximum absolute value element of a vector - * - :ref:`onemath_blas_iamin` + * - :ref:`onemath_blas_iamin` - Index of the minimum absolute value element of a vector .. toctree:: diff --git a/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst index 260a29022..618246d70 100644 --- a/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-2-routines.rst @@ -23,55 +23,55 @@ BLAS Level 2 Routines * - Routines - Description - * - :ref:`onemath_blas_gbmv` + * - :ref:`onemath_blas_gbmv` - Matrix-vector product using a general band matrix - * - :ref:`onemath_blas_gemv` + * - :ref:`onemath_blas_gemv` - Matrix-vector product using a general matrix - * - :ref:`onemath_blas_ger` + * - :ref:`onemath_blas_ger` - Rank-1 update of a general matrix - * - :ref:`onemath_blas_gerc` + * - :ref:`onemath_blas_gerc` - Rank-1 update of a conjugated general matrix - * - :ref:`onemath_blas_geru` + * - :ref:`onemath_blas_geru` - Rank-1 update of a general matrix, unconjugated - * - :ref:`onemath_blas_hbmv` + * - :ref:`onemath_blas_hbmv` - Matrix-vector product using a Hermitian band matrix * - :ref:`onemath_blas_hemv` - Matrix-vector product using a Hermitian matrix - * - :ref:`onemath_blas_her` + * - :ref:`onemath_blas_her` - Rank-1 update of a Hermitian matrix - * - :ref:`onemath_blas_her2` + * - :ref:`onemath_blas_her2` - Rank-2 update of a Hermitian matrix - * - :ref:`onemath_blas_hpmv` + * - :ref:`onemath_blas_hpmv` - Matrix-vector product using a Hermitian packed matrix - * - :ref:`onemath_blas_hpr` + * - :ref:`onemath_blas_hpr` - Rank-1 update of a Hermitian packed matrix - * - :ref:`onemath_blas_hpr2` + * - :ref:`onemath_blas_hpr2` - Rank-2 update of a Hermitian packed matrix - * - :ref:`onemath_blas_sbmv` + * - :ref:`onemath_blas_sbmv` - Matrix-vector product using symmetric band matrix - * - :ref:`onemath_blas_spmv` + * - :ref:`onemath_blas_spmv` - Matrix-vector product using a symmetric packed matrix - * - :ref:`onemath_blas_spr` + * - :ref:`onemath_blas_spr` - Rank-1 update of a symmetric packed matrix - * - :ref:`onemath_blas_spr2` + * - :ref:`onemath_blas_spr2` - Rank-2 update of a symmetric packed matrix - * - :ref:`onemath_blas_symv` + * - :ref:`onemath_blas_symv` - Matrix-vector product using a symmetric matrix - * - :ref:`onemath_blas_syr` + * - :ref:`onemath_blas_syr` - Rank-1 update of a symmetric matrix - * - :ref:`onemath_blas_syr2` + * - :ref:`onemath_blas_syr2` - Rank-2 update of a symmetric matrix - * - :ref:`onemath_blas_tbmv` + * - :ref:`onemath_blas_tbmv` - Matrix-vector product using a triangular band matrix - * - :ref:`onemath_blas_tbsv` + * - :ref:`onemath_blas_tbsv` - Solution of a linear system of equations with a triangular band matrix - * - :ref:`onemath_blas_tpmv` + * - :ref:`onemath_blas_tpmv` - Matrix-vector product using a triangular packed matrix - * - :ref:`onemath_blas_tpsv` + * - :ref:`onemath_blas_tpsv` - Solution of a linear system of equations with a triangular packed matrix - * - :ref:`onemath_blas_trmv` + * - :ref:`onemath_blas_trmv` - Matrix-vector product using a triangular matrix - * - :ref:`onemath_blas_trsv` + * - :ref:`onemath_blas_trsv` - Solution of a linear system of equations with a triangular matrix diff --git a/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst b/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst index 160eb0d24..28529b240 100644 --- a/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst +++ b/source/elements/oneMath/source/domains/blas/blas-level-3-routines.rst @@ -22,23 +22,23 @@ BLAS Level 3 Routines * - Routines - Description - * - :ref:`onemath_blas_gemm` + * - :ref:`onemath_blas_gemm` - Computes a matrix-matrix product with general matrices. - * - :ref:`onemath_blas_hemm` + * - :ref:`onemath_blas_hemm` - Computes a matrix-matrix product where one input matrix is Hermitian and one is general. - * - :ref:`onemath_blas_herk` + * - :ref:`onemath_blas_herk` - Performs a Hermitian rank-k update. - * - :ref:`onemath_blas_her2k` + * - :ref:`onemath_blas_her2k` - Performs a Hermitian rank-2k update. - * - :ref:`onemath_blas_symm` + * - :ref:`onemath_blas_symm` - Computes a matrix-matrix product where one input matrix is symmetric and one matrix is general. - * - :ref:`onemath_blas_syrk` + * - :ref:`onemath_blas_syrk` - Performs a symmetric rank-k update. - * - :ref:`onemath_blas_syr2k` + * - :ref:`onemath_blas_syr2k` - Performs a symmetric rank-2k update. - * - :ref:`onemath_blas_trmm` + * - :ref:`onemath_blas_trmm` - Computes a matrix-matrix product where one input matrix is triangular and one input matrix is general. - * - :ref:`onemath_blas_trsm` + * - :ref:`onemath_blas_trsm` - Solves a triangular matrix equation (forward or backward solve). diff --git a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst index 4b9750501..08cbf7454 100644 --- a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst +++ b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst @@ -26,16 +26,16 @@ BLAS-like Extensions * - Routines - Description - * - :ref:`onemath_blas_axpy_batch` + * - :ref:`onemath_blas_axpy_batch` - Computes groups of vector-scalar products added to a vector. - * - :ref:`onemath_blas_gemm_batch` + * - :ref:`onemath_blas_gemm_batch` - Computes groups of matrix-matrix products with general matrices. - * - :ref:`onemath_blas_trsm_batch` + * - :ref:`onemath_blas_trsm_batch` - Solves a triangular matrix equation for a group of matrices. - * - :ref:`onemath_blas_gemmt` + * - :ref:`onemath_blas_gemmt` - Computes a matrix-matrix product with general matrices, but updates only the upper or lower triangular part of the result matrix. - * - :ref:`onemath_blas_gemm_bias` + * - :ref:`onemath_blas_gemm_bias` - Computes a matrix-matrix product using general integer matrices with bias * - :ref:`onemath_blas_imatcopy` - Computes an in-place matrix transposition or copy. diff --git a/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst index 46c603c3f..697feb7bd 100644 --- a/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/device_api/device-rng-usage-model.rst @@ -5,7 +5,7 @@ .. _onemath_device_rng_usage_model: oneMath RNG Device Usage Model -============================= +============================== .. contents:: :local: diff --git a/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-onemath-rng-method-values.rst b/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-onemath-rng-method-values.rst new file mode 100644 index 000000000..d575c6f95 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/distributions-template-parameter-onemath-rng-method-values.rst @@ -0,0 +1,99 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_distributions_template_parameter_onemath_rng_method_values: + +Distributions Template Parameter Method +======================================= + + +.. container:: section + + .. list-table:: + :header-rows: 1 + + * - Method + - Distributions + - Math Description + * - ``uniform_method::standard``\ \ ``uniform_method::accurate``\ + - \ ``uniform(s,d)``\ \ ``uniform(i)``\ + - Standard method. ``uniform_method::standard_accurate`` supported for ``uniform(s, d)`` only. + * - ``gaussian_method::box_muller`` + - \ ``gaussian``\ + - Generates normally distributed random number x thru the pair of uniformly distributed numbers :math:`u_1` and :math:`u_2` according to the formula: :math:`x = \sqrt{-2lnu_1}\sin(2 \pi u_2)` + * - ``gaussian_method::box_muller2`` + - \ ``gaussian``\ \ ``lognormal``\ + - Generates normally distributed random numbers :math:`x_1` and :math:`x_2` thru the pair of uniformly distributed numbers :math:`u_1` and :math:`u_2` according to the formulas: \ :math:`x_1 = \sqrt{-2lnu_1}\sin{2\pi u_2}`\ \ :math:`x_2 = \sqrt{-2lnu_1}\cos{2\pi u_2}`\ + * - ``gaussian_method::icdf`` + - \ ``gaussian``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``exponential_method::icdf``\ \ ``exponential_method::icdf_accurate``\ + - \ ``exponential``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``weibull_method::icdf``\ \ ``weibull_method::icdf_accurate``\ + - \ ``weibull``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``cauchy_method::icdf``\ + - \ ``cauchy``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``rayleigh_method::icdf``\ \ ``rayleigh_method::icdf_accurate``\ + - \ ``rayleigh``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``bernoulli_method::icdf``\ + - \ ``bernoulli``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``geometric_method::icdf``\ + - \ ``geometric``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``gumbel_method::icdf``\ + - \ ``gumbel``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``lognormal_method::icdf``\ \ ``lognormal_method::icdf_accurate``\ + - \ ``lognormal``\ + - Inverse cumulative distribution function (ICDF) method. + * - \ ``lognormal_method::box_muller2``\ \ ``lognormal_method::box_muller2_accurate``\ + - \ ``lognormal``\ + - Generated normally distributed random numbers :math:`x_1` and :math:`x_2` by box_muller2 method are converted to lognormal distribution. + * - \ ``gamma_method::marsaglia``\ \ ``gamma_method::marsaglia_accurate``\ + - \ ``gamma``\ + - For :math:`\alpha > 1`, a gamma distributed random number is generated as a cube of properly scaled normal random number; for :math:`0.6 \leq \alpha < 1`, a gamma distributed random number is generated using rejection from Weibull distribution; for :math:`\alpha < 0.6`, a gamma distributed random number is obtained using transformation of exponential power distribution; for :math:`\alpha = 1`, gamma distribution is reduced to exponential distribution. + * - \ ``beta_method::cja``\ \ ``beta_method::cja_accurate``\ + - \ ``beta``\ + - Cheng-Jonhnk-Atkinson method. For :math:`min(p, q) > 1`, Cheng method is used; for :math:`min(p, q) < 1`, Johnk method is used, if :math:`q + K*p2 + C \leq 0 (K = 0.852..., C=-0.956...)` otherwise, Atkinson switching algorithm is used; for :math:`max(p, q) < 1`, method of Johnk is used; for :math:`min(p, q) < 1, max(p, q)> 1`, Atkinson switching algorithm is used (CJA stands for Cheng, Johnk, Atkinson); for :math:`p = 1` or :math:`q = 1`, inverse cumulative distribution function method is used; for :math:`p = 1` and :math:`q = 1`, beta distribution is reduced to uniform distribution. + * - ``chi_square_method::gamma_based`` + - \ ``chi_square``\ + - (most common): If :math:`\nu \ge 17` or :math:`\nu` is odd and :math:`5 \leq \nu \leq 15`, a chi-square distribution is reduced to a Gamma distribution with these parameters: Shape :math:`\alpha = \nu / 2`\ Offset :math:`a = 0`\ \Scale factor :math:`\beta = 2`\ The random numbers of the Gamma distribution are generated. + * - ``binomial_method::btpe`` + - \ ``binomial``\ + - Acceptance/rejection method for :math:`ntrial * min(p, 1 - p) \ge 30` with decomposition into four regions: two parallelograms, triangle, left exponential tail, right exponential tail. + * - ``poisson_method::ptpe`` + - \ ``poisson``\ + - Acceptance/rejection method for :math:`\lambda \ge 27` with decomposition into four regions: two parallelograms, triangle, left exponential tail, right exponential tail. + * - ``poisson_method::gaussian_icdf_based`` + - \ ``poisson``\ + - for :math:`\lambda \ge 1`, method based on Poisson inverse CDF approximation by Gaussian inverse CDF; for :math:`\lambda < 1`, table lookup method is used. + * - ``poisson_v_method::gaussian_icdf_based`` + - \ ``poisson_v``\ + - for :math:`\lambda \ge 1`, method based on Poisson inverse CDF approximation by Gaussian inverse CDF; for :math:`\lambda < 1`, table lookup method is used. + * - ``hypergeometric_method::h2pe`` + - \ ``hypergeometric``\ + - Acceptance/rejection method for large mode of distribution with decomposition into three regions: rectangular, left exponential tail, right exponential tail. + * - ``negative_binomial_method::nbar`` + - \ ``negative_binomial``\ + - Acceptance/rejection method for: :math:`\frac{(a - 1)(1 - p)}{p} \ge 100` with decomposition into five regions: rectangular, 2 trapezoid, left exponential tail, right exponential tail. + * - ``multinomial_method::poisson_icdf_based`` + - \ ``multinomial``\ + - Multinomial distribution with parameters :math:`m, k`, and a probability vector :math:`p`. Random numbers of the multinomial distribution are generated by Poisson Approximation method. + * - ``gaussian_mv_method::box_muller`` + - \ ``gaussian_mv``\ + - BoxMuller method for gaussian_mv method. + * - ``gaussian_mv_method::box_muller2`` + - \ ``gaussian_mv``\ + - BoxMuller2 method for gaussian_mv method. + * - ``gaussian_mv_method::icdf`` + - \ ``gaussian_mv``\ + - Inverse cumulative distribution function (ICDF) method. + +**Parent +topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-ars5.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-ars5.rst new file mode 100644 index 000000000..d124114fe --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-ars5.rst @@ -0,0 +1,200 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_ars5: + +ars5 +==== + +The ars5 counter-based pseudorandom number generator. + +.. _onemath_rng_ars5_description: + +.. rubric:: Description + +The ars5 engine is a keyed family of counter-based BRNG. The state consists of a 128-bit integer counter :math:`c` and a 128-bit key :math:`k`. The BRNG is based on the AES encryption algorithm [:ref:`FIPS-197 `]. + +.. container:: section + + .. rubric:: Generation algorithm + + The generator has a 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: + + 1. The i-th number is defined by the following formula :math:`r_i=(f(i/ 4) >> ((i \ mod \ 4) * 32)) \ mod \ 2 ^ {32}` + 2. Function :math:`f(c)` takes a 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: + 2.1. :math:`c_0 = c \oplus k` and :math:`k_0 = k`. + + 2.2. The following recurrence is calculated N = 5 times: + + :math:`c_{i+1} = SubBytes(c)` + + :math:`c_{i+1} = ShiftRows(c_{i+1})` + + :math:`c_{i+1} = MixColumns(c_{i+1})`, this step is omitted if :math:`i+1 = N` + + :math:`c_{i+1} = AddRoundKey(c_{i+1}, k_j)` + + :math:`Lo(k_{i+1}) = Lo(k) + 0x9E3779B97F4A7C15` + + :math:`Hi(k_{i+1}) = Hi(k) + 0xBB67AE8584CAA73B` + + Specification for :math:`SubBytes, ShiftRows, MixColumns, AddRoundKey` functions can be found in [:ref:`FIPS-197 `]. + + 2.3. Put :math:`f(c) = c_N`, where :math:`N = 10` + + 3. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` + +.. _onemath_rng_ars5_description_syntax: + +class ars5 +---------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class ars5 { + public: + static constexpr std::uint64_t default_seed = 0; + + ars5(sycl::queue queue, std::uint64_t seed = default_seed); + + ars5(sycl::queue queue, std::initializer_list seed); + + ars5(const ars5& other); + + ars5(ars5&& other); + + ars5& operator=(const ars5& other); + + ars5& operator=(ars5&& other); + + ~ars5(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `ars5(sycl::queue queue, std::uint64_t seed)`_ + - Constructor for common seed initialization of the engine + * - `ars5(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine + * - `ars5(const ars5& other)`_ + - Copy constructor + * - `ars5(ars5&& other)`_ + - Move constructor + * - `ars5& operator=(const ars5& other)`_ + - Copy assignment operator + * - `ars5& operator=(ars5&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`ars5(sycl::queue queue, std::uint64_t seed)`: + + .. code-block:: cpp + + ars5::ars5(sycl::queue queue, std::uint64_t seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is 128-bit key, :math:`c` is 128-bit counter. + + .. _`ars5(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + ars5::ars5(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume + if :math:`n = 0: k = 0, c = 0` + + if :math:`n = 1: k = seed[0], c = 0` + + if :math:`n = 2: k = seed[0] + seed[1] \cdot 2^{64}, c = 0` + + if :math:`n = 3: k = seed[0] + seed[1] \cdot 2^{64}, c = seed[2]` + + if :math:`n = 4: k = seed[0] + seed[1] \cdot 2^{64}, c = seed[2] + seed[3] \cdot 2^{64}` + + for :math:`n > 4` following arguments are ignored + + .. _`ars5(const ars5& other)`: + + .. code-block:: cpp + + ars5::ars5(const ars5& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``ars5`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`ars5(ars5&& other)`: + + .. code-block:: cpp + + ars5::ars5(ars5&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``ars5`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + + + .. _`ars5& operator=(const ars5& other)`: + + .. code-block:: cpp + + ars5::ars5& operator=(const ars5& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``ars5`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`ars5& operator=(ars5&& other)`: + + .. code-block:: cpp + + ars5::ars5& operator=(ars5&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``ars5`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bernoulli.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bernoulli.rst new file mode 100644 index 000000000..3991b199e --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bernoulli.rst @@ -0,0 +1,177 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_bernoulli: + +bernoulli +========= + +Class is used for generation of Bernoulli distributed integer types random numbers. + +.. _onemath_rng_bernoulli_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Bernoulli distributed with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p; p \leq 1`. + +The probability distribution is given by: + +.. math:: + + P(X = 1) = p + +.. math:: + + P(X = 0) = 1 - p + +The cumulative distribution function is as follows: + +.. math:: + + F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - p, 0 \leq x < 1, x \in R \\ 1, x \ge 1 \end{array}\right. + +.. _onemath_rng_bernoulli_syntax: + +class bernoulli +--------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class bernoulli { + public: + using method_type = Method; + using result_type = IntType; + bernoulli(); + explicit bernoulli(float p); + float p() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + * ``std::uint32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::bernoulli_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::bernoulli_method::by_default`` + * ``oneapi::math::rng::bernoulli_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `bernoulli()`_ + - Default constructor + * - `explicit bernoulli(float p)`_ + - Constructor with parameters + * - `float p() const`_ + - Method to obtain probability `p` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + bernoulli::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + bernoulli::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`bernoulli()`: + + .. code-block:: cpp + + bernoulli::bernoulli() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `p` = 0.5f. + + .. container:: section + + .. _`explicit bernoulli(float p)`: + + .. code-block:: cpp + + explicit bernoulli::bernoulli(float p) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `p` is a probability. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when `p > 1.0f`, or `p < 0.0f` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`float p() const`: + + .. code-block:: cpp + + float p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `p` - probability. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-beta.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-beta.rst new file mode 100644 index 000000000..1bb6018e4 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-beta.rst @@ -0,0 +1,231 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_beta: + +beta +==== + +Class is used for generation of beta distributed real types random numbers. + +.. _onemath_rng_beta_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` +function to provide random numbers beta distributed with shape parameters :math:`p` and :math:`q`, +displacement :math:`\alpha` and scale parameter :math:`(b, \beta)`, where :math:`p`, :math:`q`. +:math:`\alpha`, :math:`\beta` :math:`\in R; p > 0; q > 0; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{p, q, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{B(p, q) * \beta^{p + q - 1}}(x - a)^{p - 1}*(\beta + \alpha - x)^{q - 1}, \alpha \leq x < \alpha + \beta \\ 0, x < \alpha, x \ge \alpha + \beta \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < \alpha \\ \int^x_{\alpha}\frac{1}{B(p, q) * \beta^{p + q - 1}}(y - \alpha)^{p - 1}*(\beta + \alpha - y)^{q - 1}dy, \alpha \leq x < \alpha + \beta, x \in R \\ 1, x \ge \alpha + \beta \end{array}\right. + + +Where :math:`B(p, 1)` is the complete beta function. + +.. _onemath_rng_beta_syntax: + +class beta +---------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class beta { + public: + using method_type = Method; + using result_type = RealType; + beta(); + explicit beta(RealType p, RealType q, RealType a, RealType b); + RealType p() const; + RealType q() const; + RealType a() const; + RealType b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::beta_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::beta_method::by_default`` + * ``oneapi::math::rng::beta_method::cja`` + * ``oneapi::math::rng::beta_method::cja_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `beta()`_ + - Default constructor + * - `explicit beta(RealType p, RealType q, RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType p() const`_ + - Method to obtain shape ``p`` + * - `RealType q() const`_ + - Method to obtain shape ``q`` + * - `RealType a() const`_ + - Method to obtain displacement :math:`\alpha` + * - `RealType b() const`_ + - Method to obtain scalefactor :math:`\beta` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + beta::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + beta::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`beta()`: + + .. code-block:: cpp + + beta::beta() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as ``p`` = 1.0, ``q`` = 0.0, :math:`\alpha` = 1.0, :math:`\beta` = 1.0. + + .. container:: section + + .. _`explicit beta(RealType p, RealType q, RealType a, RealType b)`: + + .. code-block:: cpp + + explicit beta::beta(RealType p, RealType q, RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. ``p`` and ``q`` are shapes, :math:`\alpha` is a displacement, :math:`\beta` is a scalefactor. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`p \leq 0.0f`, or :math:`q \leq 0.0f`, or :math:`\beta \leq 0.0f` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType p() const`: + + .. code-block:: cpp + + RealType beta::p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter ``p`` - shape. + + .. container:: section + + .. _`RealType q() const`: + + .. code-block:: cpp + + RealType beta::q() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter ``q`` - shape. + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType beta::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter :math:`\alpha` - displacement. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType beta::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter :math:`\beta` - scalefactor. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-binomial.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-binomial.rst new file mode 100644 index 000000000..6c4fc2e5d --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-binomial.rst @@ -0,0 +1,192 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_binomial: + +binomial +======== + +Class is used for generation of binomially distributed integer types random numbers. + +.. _onemath_rng_binomial_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers binomially distributed with a number of independent Bernoulli trials :math:`m`, and with probability :math:`p` of a single trial success, where :math:`p \in R; 0 \leq p \leq 1, m \in N`. + +A binomially distributed variate represents the number of successes in :math:`m` independent Bernoulli trials with probability of a single trial success :math:`p`. + +The probability distribution is given by: + +.. math:: + + P(X = k) = C^k_{m}p^k(1 - p)^{m - k}, k \in \{0, 1, ... , m\} + +The cumulative distribution function is as follows: + +.. math:: + + F_{m, p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ \sum^{\lfloor x \rfloor}_{k = 0} C^k_{m}p^k(1 - p)^{m - k}, 0 \leq x < m, x \in R \\ 1, x \ge m \end{array}\right. + + +.. _onemath_rng_binomial_syntax: + +class binomial +-------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class binomial { + public: + using method_type = Method; + using result_type = IntType; + binomial(); + explicit binomial(std::int32_t ntrial, double p); + std::int32_t ntrial() const; + double p() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::binomial_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::binomial_method::by_default`` + * ``oneapi::math::rng::binomial_method::btpe`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `binomial()`_ + - Default constructor + * - `explicit binomial(std::int32_t ntrial, double p)`_ + - Constructor with parameters + * - `std::int32_t ntrial() const`_ + - Method to obtain number of independent trials `m` + * - `double p() const`_ + - Method to obtain success probability of a single trial `p` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + binomial::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + binomial::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`binomial()`: + + .. code-block:: cpp + + binomial::binomial() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `m` = 5, `p` = 0.5. + + .. container:: section + + .. _`explicit binomial(std::int32_t ntrial, double p)`: + + .. code-block:: cpp + + explicit binomial::binomial(std::int32_t ntrial, double p) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `ntrial` is the number of independent trials, `p` is the success probability of a single trial. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`p > 1.0`, or :math:`p < 0.0`, or :math:`ntrial < 1` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t ntrial() const`: + + .. code-block:: cpp + + std::int32_t binomial::ntrial() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `m` - number of independent trials. + + .. container:: section + + .. _`double p() const`: + + .. code-block:: cpp + + double binomial::p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `p` - success probability of a single trial. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bits.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bits.rst new file mode 100644 index 000000000..f6cdf37de --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-bits.rst @@ -0,0 +1,59 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_bits: + +bits +==== + +Class is used for generation of underlying engine integer recurrence. + +.. _onemath_rng_bits_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide integer random numbers. Each integer can be treated as a vector of several bits. In a truly random generator, these bits are random, while in pseudorandom generators this randomness can be violated. + +class bits +---------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class bits { + public: + using result_type = UIntType; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename UIntType + Type of the produced values. Supported types: + * ``std::uint32_t`` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + bits::result_type = UIntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-cauchy.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-cauchy.rst new file mode 100644 index 000000000..8a10ef78a --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-cauchy.rst @@ -0,0 +1,190 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_cauchy: + +cauchy +====== + +Class is used for generation of Cauchy distributed real types random numbers. + +.. _onemath_rng_cauchy_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Cauchy distributed with displacement :math:`a`, and scale parameter :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \beta}(x) = \frac{1}{\pi\beta(1 + (\frac{x - a}{\beta})^2)}, x \in R. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \beta}(x) = \frac{1}{2} + \frac{1}{\pi} \arctan{(\frac{x - a}{\beta})}, x \in R. + +.. _onemath_rng_cauchy_syntax: + +class cauchy +------------ + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class cauchy { + public: + using method_type = Method; + using result_type = RealType; + cauchy(); + explicit cauchy(RealType a, RealType b); + RealType a() const; + RealType b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::cauchy_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::cauchy_method::by_default`` + * ``oneapi::math::rng::cauchy_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `cauchy()`_ + - Default constructor + * - `explicit cauchy(RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType b() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + cauchy::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + cauchy::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`cauchy()`: + + .. code-block:: cpp + + cauchy::cauchy() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, and `b` = 1.0. + + .. container:: section + + .. _`explicit cauchy(RealType a, RealType b)`: + + .. code-block:: cpp + + explicit cauchy::cauchy(RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a displacement value, `b` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`b \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType cauchy::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement value. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType cauchy::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-chi_square.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-chi_square.rst new file mode 100644 index 000000000..0978b8c49 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-chi_square.rst @@ -0,0 +1,174 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_chi_square: + +chi_square +========== + +Class is used for generation of chi-square distributed real types random numbers. + +.. _onemath_rng_chi_square_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers chi-square distributed with :math:`n` degrees of freedom, :math:`n \in N; n > 0`. + +The probability distribution is given by: + +.. math:: + + f_{n}(x) = \left\{ \begin{array}{rcl} \frac{x^{\frac{n - 2}{2}}e^{-\frac{x}{2}}}{2^{n/2}\Gamma(n/2)}, x \ge 0 \\ 0, x < 0 \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{n}(x) = \left\{ \begin{array}{rcl} \int^{x}_{0}\frac{y^{\frac{n - 2}{2}}e^{-\frac{x}{2}}}{2^{n/2}\Gamma(n/2)}dy, x \ge 0 \\ 0, x < 0 \end{array}\right. + + +.. _onemath_rng_chi_square_syntax: + +class chi_square +---------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class chi_square { + public: + using method_type = Method; + using result_type = RealType; + chi_square(); + explicit chi_square(std::int32_t n); + std::int32_t n() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::chi_square_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::chi_square_method::by_default`` + * ``oneapi::math::rng::chi_square_method::gamma_based`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `chi_square()`_ + - Default constructor + * - `explicit chi_square(std::int32_t n)`_ + - Constructor with parameters + * - `std::int32_t n() const`_ + - Method to obtain number of degrees of freedom `n` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + chi_square::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + chi_square::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`chi_square()`: + + .. code-block:: cpp + + chi_square::chi_square() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `n` = 5. + + .. container:: section + + .. _`explicit chi_square(std::int32_t n)`: + + .. code-block:: cpp + + explicit chi_square::chi_square(std::int32_t n) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `n` is the number of degrees of freedom. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`n < 1` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t n() const`: + + .. code-block:: cpp + + std::int32_t chi_square::n() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `n` - number of degrees of freedom. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-default_engine.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-default_engine.rst new file mode 100755 index 000000000..9d11919a2 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-default_engine.rst @@ -0,0 +1,30 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_default_engine: + +default_engine +============== + +Default random engine. + +.. _onemath_rng_default_engine_description: + +.. rubric:: Description + +The choice of engine type named by default_engine is implementation-defined. The implementation may select this type on the basis of performance, size, quality, or any combination of such factors. + +.. _onemath_rng_default_engine_description_syntax: + +type alias default_engine +------------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + using default_engine = implementation-defined; + + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-exponential.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-exponential.rst new file mode 100644 index 000000000..ab21ecdff --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-exponential.rst @@ -0,0 +1,191 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_exponential: + +exponential +=========== + +Class is used for generation of exponentially distributed real types random numbers. + +.. _onemath_rng_exponential_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers exponentially distributed with displacement :math:`a` and scalefactor :math:`\beta`, where :math:`a, \beta \in R; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\beta}exp(-\frac{x - a}{\beta}), x \ge a \\ 0, x < a \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{x - a}{\beta}), x \ge a \\ 0, x < a \end{array}\right. + +.. _onemath_rng_exponential_syntax: + +class exponential +----------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class exponential { + public: + using method_type = Method; + using result_type = RealType; + exponential(); + explicit exponential(RealType a, RealType beta); + RealType a() const; + RealType beta() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::exponential_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::exponential_method::by_default`` + * ``oneapi::math::rng::exponential_method::icdf`` + * ``oneapi::math::rng::exponential_method::icdf_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `exponential()`_ + - Default constructor + * - `explicit exponential(RealType a, RealType beta)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType beta() const`_ + - Method to obtain scalefactor + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + exponential::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + exponential::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`exponential()`: + + .. code-block:: cpp + + exponential::exponential() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, `beta` = 1.0. + + .. container:: section + + .. _`explicit exponential(RealType a, RealType beta)`: + + .. code-block:: cpp + + explicit exponential::exponential(RealType a, RealType beta) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a displacement, `beta` is a scalefactor. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`beta \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType exponential::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement. + + .. container:: section + + .. _`RealType beta() const`: + + .. code-block:: cpp + + RealType exponential::beta() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `beta` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gamma.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gamma.rst new file mode 100644 index 000000000..afe899bc1 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gamma.rst @@ -0,0 +1,211 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_gamma: + +gamma +===== + +Class is used for generation of gamma distributed real types random numbers. + +.. _onemath_rng_gamma_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` +function to provide random numbers gamma distributed with shape :math:`\alpha`, +displacement :math:`a`, and scale parameter :math:`\beta`, where +:math:`a, \alpha, \beta \in R; \alpha > 0; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\Gamma(\alpha)\beta^{\alpha}}(x - a)^{\alpha - 1}e^{-(x - a) / \beta}, x \ge a \\ 0, x < a \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \int^x_a\frac{1}{\Gamma(\alpha)\beta^{\alpha}}(y - a)^{\alpha - 1}e^{-(y - a) / \beta}dy, x \ge a \\ 0, x < a \end{array}\right. + +.. _onemath_rng_gamma_syntax: + +class gamma +----------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class gamma { + public: + using method_type = Method; + using result_type = RealType; + gamma(); + explicit gamma(RealType alpha, RealType a, RealType beta); + RealType alpha() const; + RealType a() const; + RealType beta() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::gamma_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::gamma_method::by_default`` + * ``oneapi::math::rng::gamma_method::marsaglia`` + * ``oneapi::math::rng::gamma_method::marsaglia_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `gamma()`_ + - Default constructor + * - `explicit gamma(RealType alpha, RealType a, RealType beta)`_ + - Constructor with parameters + * - `RealType alpha() const`_ + - Method to obtain shape value + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType beta() const`_ + - Method to obtain scale value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + gamma::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + gamma::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`gamma()`: + + .. code-block:: cpp + + gamma::gamma() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `alpha` = 1.0, `a` = 0.0, and `beta` = 1.0. + + .. container:: section + + .. _`explicit gamma(RealType alpha, RealType a, RealType beta)`: + + .. code-block:: cpp + + explicit gamma::gamma(RealType alpha, RealType a, RealType beta) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `alpha` is a shape value, `a` is a displacement value, `beta` is a scale parameter. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType alpha() const`: + + .. code-block:: cpp + + RealType gamma::alpha() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `alpha` - shape value. + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType gamma::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement value. + + .. container:: section + + .. _`RealType beta() const`: + + .. code-block:: cpp + + RealType gamma::beta() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `beta` - scale parameter. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian.rst new file mode 100644 index 000000000..0a88916c6 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian.rst @@ -0,0 +1,193 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_gaussian: + +gaussian +======== + +Class is used for generation of normally distributed real types random numbers. + +.. _onemath_rng_gaussian_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers normally distributed with mean :math:`(mean, a)` and standard deviation :math:`(stddev, \sigma)`, where :math:`a, \sigma \in R; \sigma > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \sigma}(x) = \frac{1}{\sigma\sqrt{2\pi}}exp(-\frac{(x - a)^2}{2*\sigma^2}), x \in R. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \sigma}(x) = \int^x_{-\infty}\frac{1}{\sigma\sqrt{2\pi}}exp(-\frac{(y - a)^2}{2*\sigma^2})dy, x \in R. + + +.. _onemath_rng_gaussian_syntax: + +class gaussian +-------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class gaussian { + public: + using method_type = Method; + using result_type = RealType; + gaussian(); + explicit gaussian(RealType mean, RealType stddev); + RealType mean() const; + RealType stddev() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::gaussian_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::gaussian_method::by_default`` + * ``oneapi::math::rng::gaussian_method::box_muller`` + * ``oneapi::math::rng::gaussian_method::box_muller2`` + * ``oneapi::math::rng::gaussian_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter` + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `gaussian()`_ + - Default constructor + * - `explicit gaussian(RealType mean, RealType stddev)`_ + - Constructor with parameters + * - `RealType mean() const`_ + - Method to obtain mean value + * - `RealType stddev() const`_ + - Method to obtain standard deviation value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + gaussian::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + gaussian::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`gaussian()`: + + .. code-block:: cpp + + gaussian::gaussian() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `mean` = 0.0, `stddev` = 1.0. + + .. container:: section + + .. _`explicit gaussian(RealType mean, RealType stddev)`: + + .. code-block:: cpp + + explicit gaussian::gaussian(RealType mean, RealType stddev) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `mean` is a mean value, `stddev` is a standard deviation value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when `stddev` :math:`\leq` `static_cast(0.0)` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType mean() const`: + + .. code-block:: cpp + + RealType gaussian::mean() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `mean` - mean value. + + .. container:: section + + .. _`RealType stddev() const`: + + .. code-block:: cpp + + RealType gaussian::stddev() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `stddev` - standard deviation value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian_mv.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian_mv.rst new file mode 100755 index 000000000..7ff58d8e7 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gaussian_mv.rst @@ -0,0 +1,199 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_gaussian_mv: + +gaussian_mv +=========== + +Class is used for generation of multivariate normally distributed real types random numbers. + +.. _onemath_rng_gaussian_mv_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide n random numbers :math:`d`-variate normally distributed, with mean :math:`a` and variance-covariance matrix :math:`C`, where :math:`a \in R^d;` :math:`C` is dxd symmetric positive matrix. + +The probability density function is given by: + +.. math:: + + f_{a, C}(x) = \frac{1}{\sqrt{det(2\pi C)}}exp(-1 / 2(x - a)^T C^{-1}(x-a)). + +.. _onemath_rng_gaussian_mv_syntax: + +class gaussian_mv +----------------- + +Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). +It's implementation defined which type ``SequenceContainerOrView`` represents. + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class gaussian_mv { + public: + using method_type = Method; + using result_type = RealType; + explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix); + std::int32_t dimen() const; + SequenceContainerOrView mean() const; + SequenceContainerOrView matrix() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. rubric:: Template parameters + + .. container:: section + + oneapi::math::rng::layout Layout + Matrix layout: + * ``oneapi::math::rng::layout::full`` + * ``oneapi::math::rng::layout::packed`` + * ``oneapi::math::rng::layout::diagonal`` + + .. container:: section + + typename Method = oneapi::math::rng::gaussian_mv_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::gaussian_mv_method::by_default`` + * ``oneapi::math::rng::gaussian_mv_method::box_muller`` + * ``oneapi::math::rng::gaussian_mv_method::box_muller2`` + * ``oneapi::math::rng::gaussian_mv_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix)`_ + - Constructor with parameters + * - `std::int32_t dimen() const`_ + - Method to obtain number of dimensions in output random vectors + * - `SequenceContainerOrView mean() const`_ + - Method to obtain mean vector `a` of dimension d. + * - `SequenceContainerOrView matrix() const`_ + - Method to obtain variance-covariance matrix `C` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + gaussian_mv::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + gaussian_mv::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`explicit gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix)`: + + .. code-block:: cpp + + explicit gaussian_mv::gaussian_mv(std::uint32_t dimen, SequenceContainerOrView mean, SequenceContainerOrView matrix) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. ``dimen`` is the number of dimensions, ``mean`` is a mean vector, ``matrix`` is a variance-covariance matrix. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`mean.size() \leq 0`, or :math:`matrix.size() \leq 0` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t dimen() const`: + + .. code-block:: cpp + + std::int32_t gaussian_mv::dimen() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `dimen`. + + .. container:: section + + .. _`SequenceContainerOrView mean() const`: + + .. code-block:: cpp + + SequenceContainerOrView gaussian_mv::mean() const + + .. container:: section + + .. rubric:: Return Value + + Returns the mean vector. + + .. container:: section + + .. _`SequenceContainerOrView matrix() const`: + + .. code-block:: cpp + + SequenceContainerOrView gaussian_mv::matrix() const + + .. container:: section + + .. rubric:: Return Value + + Returns the variance-covariance matrix. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-generate.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-generate.rst new file mode 100644 index 000000000..724275fd8 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-generate.rst @@ -0,0 +1,130 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_generate: + +generate +======== + +Entry point to obtain random numbers from a given engine with proper statistics of a given distribution. + +.. _onemath_rng_generate_description: + +.. rubric:: Description and Assumptions + +oneapi::math::rng::generate function produces random numbers sequence from the given engine object and applied transformation from a given distribution object. + +.. _onemath_rng_generate_buffer: + +generate (Buffer version) +------------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + void generate (const DistrType& distr, EngineType& engine, std::int64_t n, sycl::buffer& r); + } + +.. container:: section + + .. rubric:: Template Parameters + + DistrType + Type of distribution which is used for random number generation. + + EngineType + Type of engine which is used for random number generation. + +.. container:: section + + .. rubric:: Input Parameters + + distr + Distribution object. See :ref:`onemath_rng_distributions` for details. + + engine + Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. + + n + Number of random values to be generated. + +.. container:: section + + .. rubric:: Output Parameters + + r + sycl::buffer of generated values. + +.. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when n > r.get_count(), or n < 0 + +.. _onemath_rng_generate_usm: + +generate (USM version) +---------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + sycl::event generate (const DistrType& distr, EngineType& engine, std::int64_t n, typename DistrType::result_type* r, const std::vector & dependencies); + } + +.. container:: section + + .. rubric:: Template Parameters + + DistrType + Type of distribution which is used for random number generation. + + EngineType + Type of engine which is used for random number generation. + +.. container:: section + + .. rubric:: Input Parameters + + distr + Distribution object. See :ref:`onemath_rng_distributions` for details. + + engine + Engine object. See :ref:`onemath_rng_engines_basic_random_number_generators` for details. + + n + Number of random values to be generated. + + dependencies + Optional parameter. List of events to wait for before starting computation, if any. + +.. container:: section + + .. rubric:: Output Parameters + + r + pointer to generated values. + +.. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when r == nullptr, or n < 0 + +.. container:: section + + .. rubric:: Return Value + + Output event to wait on to ensure computation is complete. + + +**Parent topic:** :ref:`onemath_rng_generate_routine` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-geometric.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-geometric.rst new file mode 100644 index 000000000..696860659 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-geometric.rst @@ -0,0 +1,173 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_geometric: + +geometric +========= + +Class is used for generation of geometrically distributed integer types random numbers. + +.. _onemath_rng_geometric_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers geometrically distributed with probability :math:`p` of a single success trial, where :math:`p \in R; 0 < p < 1`. + +The probability distribution is given by: + +.. math:: + + P(X = k) = p * (1 - p)^k, k = \{0, 1, 2, ... \}. + +The cumulative distribution function is as follows: + +.. math:: + + F_{p}(x) = \left\{ \begin{array}{rcl} 0, x < 0 \\ 1 - (1 - p)^{\lfloor x + 1 \rfloor}, x \ge 0 \end{array}\right. + +.. _onemath_rng_geometric_syntax: + +class geometric +--------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class geometric { + public: + using method_type = Method; + using result_type = IntType; + geometric(); + explicit geometric(float p); + float p() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + * ``std::uint32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::geometric_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::geometric_method::by_default`` + * ``oneapi::math::rng::geometric_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `geometric()`_ + - Default constructor + * - `explicit geometric(float p)`_ + - Constructor with parameters + * - `float p() const`_ + - Method to obtain probability value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + geometric::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + geometric::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`geometric()`: + + .. code-block:: cpp + + geometric::geometric() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `p` = 0.5. + + .. container:: section + + .. _`explicit geometric(float p)`: + + .. code-block:: cpp + + explicit geometric::geometric(float p) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `p` is a probability value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`p \ge 1.0f`, or :math:`p \leq 0.0f` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`float p() const`: + + .. code-block:: cpp + + float geometric::p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `p` - probability value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gumbel.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gumbel.rst new file mode 100644 index 000000000..ba3b58db2 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-gumbel.rst @@ -0,0 +1,190 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_gumbel: + +gumbel +====== + +Class is used for generation of Gumbel distributed real types random numbers. + +.. _onemath_rng_gumbel_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Gumbel distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \beta}(x) = \frac{1}{\beta}exp(-\frac{x - a}{\beta})exp(-exp(\frac{x - a}{\beta})), x \in R. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \beta}(x) = 1 - exp(-exp(\frac{x - a}{\beta})), x \in R. + +.. _onemath_rng_gumbel_syntax: + +class gumbel +------------ + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class gumbel { + public: + using method_type = Method; + using result_type = RealType; + gumbel(); + explicit gumbel(RealType a, RealType b); + RealType a() const; + RealType b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::gumbel_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::gumbel_method::by_default`` + * ``oneapi::math::rng::gumbel_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `gumbel()`_ + - Default constructor + * - `explicit gumbel(RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType b() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + gumbel::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + gumbel::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`gumbel()`: + + .. code-block:: cpp + + gumbel::gumbel() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, and `beta` = 1.0. + + .. container:: section + + .. _`explicit gumbel(RealType a, RealType b)`: + + .. code-block:: cpp + + explicit gumbel::gumbel(RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a displacement value, `beta` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`b \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType gumbel::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement value. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType gumbel::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-hypergeometric.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-hypergeometric.rst new file mode 100644 index 000000000..0a66d761e --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-hypergeometric.rst @@ -0,0 +1,209 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_hypergeometric: + +hypergeometric +============== + +Class is used for generation of hypergeometrically distributed integer types random numbers. + +.. _onemath_rng_hypergeometric_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers hypergeometrically distributed with lot size :math:`l`, size of sampling :math:`s`, and number of marked elements in the lot :math:`m`, where :math:`l, m, s \in N \bigcup \{0\}; l \ge max (s, m)`. + +Consider a lot of :math:`l` elements comprising :math:`m` marked and :math:`l` - :math:`m` unmarked elements. A trial sampling without replacement of exactly :math:`s` elements from this lot helps to define the hypergeometric distribution, which is the probability that the group of :math:`s` elements contains exactly :math:`k` marked elements. + +The probability distribution is given by: + +.. math:: + + P_(X = k) = \frac{C^k_mC^{s-k}_{l-m}}{C^s_l}, k \in \{max(0, s + m - l), ... , min(s, m)\}. + +The cumulative distribution function is as follows: + +.. math:: + + F_{l, s, m}(x) = \left\{ \begin{array}{rcl} 0, x < max(0, s + m - l) \\ \sum^{\lfloor x \rfloor}_{k = max(0, s + m - l)}\frac{C^k_mC^{s-k}_{l-m}}{C^s_l}, max(0, s + m - l) \leq x \leq min(s, m) \\ 1, x > min(s, m) \end{array}\right. + +.. _onemath_rng_hypergeometric_syntax: + +class hypergeometric +-------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class hypergeometric { + public: + using method_type = Method; + using result_type = IntType; + hypergeometric(); + explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m); + std::int32_t s() const; + std::int32_t m() const; + std::int32_t l() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + * ``std::uint32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::hypergeometric_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::hypergeometric_method::by_default`` + * ``oneapi::math::rng::hypergeometric_method::h2pe`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `hypergeometric()`_ + - Default constructor + * - `explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m)`_ + - Constructor with parameters + * - `std::int32_t s() const`_ + - Method to obtain lot size + * - `std::int32_t m() const`_ + - Method to obtain size of sampling without replacement + * - `std::int32_t l() const`_ + - Method to obtain number of marked elements + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + hypergeometric::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + hypergeometric::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`hypergeometric()`: + + .. code-block:: cpp + + hypergeometric::hypergeometric() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `l` = 1, `s` = 1, `m` = 1. + + .. container:: section + + .. _`explicit hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m)`: + + .. code-block:: cpp + + explicit hypergeometric::hypergeometric(std::int32_t l, std::int32_T s, std::int32_T m) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `l` is a lot size, `s` is a size of sampling without replacement, `m` is a number of marked elements. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`s < 0`, or :math:`m < 0`, or :math:`l < (s > m ? s : m)` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t l() const`: + + .. code-block:: cpp + + std::int32_t hypergeometric::l() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `l` - lot size value. + + .. container:: section + + .. _`std::int32_t s() const`: + + .. code-block:: cpp + + std::int32_t hypergeometric::s() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `s` - size of sampling without replacement. + + .. container:: section + + .. _`std::int32_t m() const`: + + .. code-block:: cpp + + std::int32_t hypergeometric::m() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `m` - number of marked elements. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-laplace.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-laplace.rst new file mode 100644 index 000000000..54a26233f --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-laplace.rst @@ -0,0 +1,188 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_laplace: + +laplace +======= + +Class is used for generation of Laplace distributed real types random numbers. + +.. _onemath_rng_laplace_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Laplace distributed with mean value (or average) :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. The scalefactor value determines the standard deviation as :math:`\sigma = \beta\sqrt{2}`. + +The probability distribution is given by: + +.. math:: + + f_{a, \beta}(x) = \frac{1}{\sqrt{2\beta}}exp(-\frac{|x - a|}{\beta}), x \in R. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x \ge a \\ 1 - \frac{1}{2}exp(-\frac{|x - a|}{\beta}), x < a \end{array}\right. + +.. _onemath_rng_laplace_syntax: + +class laplace +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + template + class laplace { + public: + using method_type = Method; + using result_type = RealType; + laplace(); + explicit laplace(RealType a, RealType b); + RealType a() const; + RealType b() const; + }; + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::laplace_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::laplace_method::by_default`` + * ``oneapi::math::rng::laplace_method::icdf`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `laplace()`_ + - Default constructor + * - `explicit laplace(RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain mean value + * - `RealType b() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + laplace::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + laplace::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`laplace()`: + + .. code-block:: cpp + + laplace::laplace() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, and `beta` = 1.0. + + .. container:: section + + .. _`explicit laplace(RealType a, RealType b)`: + + .. code-block:: cpp + + explicit laplace::laplace(RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a mean value, `beta` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`b \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType laplace::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - mean value. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType laplace::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-leapfrog.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-leapfrog.rst new file mode 100644 index 000000000..3365f9024 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-leapfrog.rst @@ -0,0 +1,79 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_leapfrog: + +leapfrog +======== + +Proceed state of engine by the leapfrog method. + +.. _onemath_rng_leapfrog_description: + +.. rubric:: Description and Assumptions + +oneapi::math::rng::leapfrog function generates random numbers in an engine with non-unit stride. This feature is particularly useful in distributing random numbers from the original stream across the stride buffers without generating the original random sequence with subsequent manual distribution. see `Figure "Leapfrog Method" <#rng_leapfrog>`__. + +.. container:: figtop + :name: rng_leapfrog + + Leapfrog Method + + |image0| + +.. _onemath_rng_leapfrog_common: + +leapfrog +-------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + void leapfrog(EngineType& engine, std::uint64_t idx, std::uint64_t stride); + } + +.. container:: section + + .. rubric:: Template Parameters + + EngineType + Type of engine. Note: may not be supported by all available engine classes. + +.. container:: section + + .. rubric:: Input Parameters + + engine + Engine which state would be skipped. + + idx + Index of the computational node. + + stride + Largest number of computational nodes, or stride. + +.. rubric:: Example + +.. code-block:: cpp + + // Creating 3 identical engines + oneapi::math::rng::mcg31m1 engine_1(queue, seed); + + oneapi::math::rng::mcg31m1 engine_2(engine_1); + oneapi::math::rng::mcg31m1 engine_3(engine_1); + + + // Leapfrogging the states of engines + oneapi::math::rng::leapfrog(engine_1, 0 , 3); + oneapi::math::rng::leapfrog(engine_2, 1 , 3); + oneapi::math::rng::leapfrog(engine_3, 2 , 3); + // Generating random numbers + + +**Parent topic:** :ref:`onemath_rng_service_routines` + +.. |image0| image:: ../../equations/rng-leapfrog.png diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-lognormal.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-lognormal.rst new file mode 100644 index 000000000..b541ea69e --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-lognormal.rst @@ -0,0 +1,227 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_lognormal: + +lognormal +========= + +Class is used for generation of lognormally distributed real types random numbers. + +.. _onemath_rng_lognormal_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers lognormally distributed with mean :math:`(m, a)` and standard deviation :math:`(s, \sigma)` of subject normal distribution, displacement :math:`(displ, b)`, and scalefactor :math:`(scale, \beta)`, where :math:`a, \sigma, b, \beta \in R; \sigma > 0; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \sigma, b, \beta}(x) = \left\{ \begin{array}{rcl} \frac{1}{\sigma(x - b)\sqrt{2\pi}}exp(-\frac{[ln((x - b) / \beta) - a]^2}{2*\sigma^2}), x > b \\ 0, x \leq b \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \sigma, b, \beta}(x) = \left\{ \begin{array}{rcl} \Phi( \frac{(ln((x - b) / \beta) - a)}{\sigma}), x > b \\ 0, x \leq b \end{array}\right. + +.. _onemath_rng_lognormal_syntax: + +class lognormal +--------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class lognormal { + public: + using method_type = Method; + using result_type = RealType; + lognormal(); + explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0)); + RealType m() const; + RealType s() const; + RealType displ() const; + RealType scale() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::lognormal_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::lognormal_method::by_default`` + * ``oneapi::math::rng::lognormal_method::box_muller2`` + * ``oneapi::math::rng::lognormal_method::icdf`` + * ``oneapi::math::rng::lognormal_method::box_muller2_accurate`` + * ``oneapi::math::rng::lognormal_method::icdf_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `lognormal()`_ + - Default constructor + * - `explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0))`_ + - Constructor with parameters + * - `RealType m() const`_ + - Method to obtain mean value + * - `RealType s() const`_ + - Method to obtain standard deviation value + * - `RealType displ() const`_ + - Method to obtain displacement value + * - `RealType scale() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + lognormal::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + lognormal::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`lognormal()`: + + .. code-block:: cpp + + lognormal::lognormal() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `m` = 0.0, `s` = 1.0, `displ` = 0.0, `scale` = 1.0. + + .. container:: section + + .. _`explicit lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0))`: + + .. code-block:: cpp + + explicit lognormal::lognormal(RealType m, RealType s, RealType displ = static_cast(0.0), RealType scale = static_cast(1.0)) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `m` is a mean value, `s` is a standard deviation value, `displ` is a displacement value, `scale` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`s \leq` static_cast(0.0), or :math:`scale \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType m() const`: + + .. code-block:: cpp + + RealType lognormal::m() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `m` - mean value. + + .. container:: section + + .. _`RealType s() const`: + + .. code-block:: cpp + + RealType lognormal::s() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `s` - standard deviation value. + + .. container:: section + + .. _`RealType displ() const`: + + .. code-block:: cpp + + RealType lognormal::displ() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `displ` - displacement value. + + .. container:: section + + .. _`RealType scale() const`: + + .. code-block:: cpp + + RealType lognormal::scale() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `scale` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg31m1.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg31m1.rst new file mode 100644 index 000000000..2fc224d40 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg31m1.rst @@ -0,0 +1,148 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_mcg31m1: + +mcg31m1 +======= + +The 31-bit multiplicative congruential pseudorandom number generator MCG(1132489760, 231 -1). + +.. _onemath_rng_mcg31m1_description: + +.. rubric:: Description + +The mcg31m1 engine is a 31-bit multiplicative congruential generator :ref:`[L'Ecuyer99] `. The mcg31m1 generator belongs to linear congruential generators with the period length of approximately :math:`2^{31}`. Such generators are still used as default random number generators in various software systems, mainly due to the simplicity of the portable versions implementation, speed, and compatibility with the earlier systems versions. However, their period length does not meet the requirements for modern basic generators. Still, the mcg31m1 generator possesses good statistic properties and you may successfully use it to generate random numbers of different distributions for small samplings. + +.. container:: section + + .. rubric:: Generation algorithm + + :math:`x_n=ax_{n-1}(mod \ m)` + + :math:`u_n = x_n / m` + + :math:`a = 1132489760, m=2^{31} - 1` + +.. _onemath_rng_mcg31m1_description_syntax: + +class mcg31m1 +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class mcg31m1 { + public: + static constexpr std::uint32_t default_seed = 1; + + mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed); + + mcg31m1(const mcg31m1& other); + + mcg31m1(mcg31m1&& other); + + mcg31m1& operator=(const mcg31m1& other); + + mcg31m1& operator=(mcg31m1&& other); + + ~mcg31m1(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `mcg31m1(const mcg31m1& other)`_ + - Copy constructor + * - `mcg31m1(mcg31m1&& other)`_ + - Move constructor + * - `mcg31m1& operator=(const mcg31m1& other)`_ + - Copy assignment operator + * - `mcg31m1& operator=(mcg31m1&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + mcg31m1::mcg31m1(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 0x7FFFFFFF`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + .. _`mcg31m1(const mcg31m1& other)`: + + .. code-block:: cpp + + mcg31m1::mcg31m1(const mcg31m1& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mcg31m1(mcg31m1&& other)`: + + .. code-block:: cpp + + mcg31m1::mcg31m1(mcg31m1&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`mcg31m1& operator=(const mcg31m1& other)`: + + .. code-block:: cpp + + mcg31m1::mcg31m1& operator=(const mcg31m1& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg31m1`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mcg31m1& operator=(mcg31m1&& other)`: + + .. code-block:: cpp + + mcg31m1::mcg31m1& operator=(mcg31m1&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg31m1`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg59.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg59.rst new file mode 100644 index 000000000..f887f6d55 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mcg59.rst @@ -0,0 +1,148 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_mcg59: + +mcg59 +===== + +The 59-bit multiplicative congruential pseudorandom number generator. + +.. _onemath_rng_mcg59_description: + +.. rubric:: Description + +The mcg59 engine is a 59-bit multiplicative congruential generator from NAG Numerical Libraries :ref:`NAG `. The mcg59 generator belongs to linear congruential generators with the period length of approximately :math:`2^{57}`. + +.. container:: section + + .. rubric:: Generation algorithm + + :math:`x_n=ax_{n-1}(mod \ m)` + + :math:`u_n = x_n / m` + + :math:`a = 13^{13}, m=2^{59}` + +.. _onemath_rng_mcg59_description_syntax: + +class mcg59 +----------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class mcg59 { + public: + static constexpr std::uint64_t default_seed = 1; + + mcg59(sycl::queue queue, std::uint64_t seed = default_seed); + + mcg59(const mcg59& other); + + mcg59(mcg59&& other); + + mcg59& operator=(const mcg59& other); + + mcg59& operator=(mcg59&& other); + + ~mcg59(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `mcg59(sycl::queue queue, std::uint64_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `mcg59(const mcg59& other)`_ + - Copy constructor + * - `mcg59(mcg59&& other)`_ + - Move constructor + * - `mcg59& operator=(const mcg59& other)`_ + - Copy assignment operator + * - `mcg59& operator=(mcg59&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`mcg59(sycl::queue queue, std::uint64_t seed = default_seed)`: + + .. code-block:: cpp + + mcg59::mcg59(sycl::queue queue, std::uint64_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`x_0 = seed \ mod \ 2^{59}`, if :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + .. _`mcg59(const mcg59& other)`: + + .. code-block:: cpp + + mcg59::mcg59(const mcg59& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg59`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mcg59(mcg59&& other)`: + + .. code-block:: cpp + + mcg59::mcg59(mcg59&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg59`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`mcg59& operator=(const mcg59& other)`: + + .. code-block:: cpp + + mcg59::mcg59& operator=(const mcg59& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg59`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mcg59& operator=(mcg59&& other)`: + + .. code-block:: cpp + + mcg59::mcg59& operator=(mcg59&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mcg59`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mrg32k3a.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mrg32k3a.rst new file mode 100644 index 000000000..19f265dfa --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mrg32k3a.rst @@ -0,0 +1,201 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_mrg32k3a: + +mrg32k3a +======== + +The combined multiple recursive pseudorandom number generator MRG32k3a. + +.. _onemath_rng_mrg32k3a_description: + +.. rubric:: Description + +MRG32k3a engine is a 32-bit combined multiple recursive generator with two components of order 3 :ref:`[L'Ecuyer99a] `. MRG32k3a combined generator meets the requirements for modern RNGs, such as good multidimensional uniformity, or a long period (:math:`p \approx 2^{191}`). + +.. container:: section + + .. rubric:: Generation algorithm + + + :math:`x_n=a_{11} x_{n-1} + a_{12} x_{n-2} + a_{13} x_{n-3}(mod \ m_{1})` + + :math:`y_n = a_{21} y_{n-1} + a_{22} y_{n-2} + a_{23} (mod \ m_2)` + + :math:`z_n = x_n - y_n (mod \ m_{1})` + + :math:`u_n = z_n / m_1` + + :math:`a_{11} = 0, a_{12} = 1403580, a_{13} = -810728, m_1 = 2^{32} - 209` + + :math:`a_{21} = 527612, a_{22} = 0, a_{23} = -1370589, m_2 = 2^{32} - 22853` + + +.. _onemath_rng_mrg32k3a_description_syntax: + +class mrg32k3a +-------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class mrg32k3a { + public: + static constexpr std::uint32_t default_seed = 1; + + mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed); + + mrg32k3a(sycl::queue queue, std::initializer_list seed); + + mrg32k3a(const mrg32k3a& other); + + mrg32k3a(mrg32k3a&& other); + + mrg32k3a& operator=(const mrg32k3a& other); + + mrg32k3a& operator=(mrg32k3a&& other); + + ~mrg32k3a(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `mrg32k3a(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine + * - `mrg32k3a(const mrg32k3a& other)`_ + - Copy constructor + * - `mrg32k3a(mrg32k3a&& other)`_ + - Move constructor + * - `mrg32k3a& operator=(const mrg32k3a& other)`_ + - Copy assignment operator + * - `mrg32k3a& operator=(mrg32k3a&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue object``, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`x_{-3} = seed \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1`. + + .. _`mrg32k3a(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume + if :math:`n = 0: x_{-3} = x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` + + if :math:`n = 1: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` + + if :math:`n = 2: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = y_{-3} = y_{-2} = y_{-1} = 1` + + if :math:`n = 3: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` + + :math:`y_{-3} = y_{-2} = y_{-1} = 1` + + if :math:`n = 4: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` + + :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = y_{-1} = 1` + + if :math:`n = 5: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` + + :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = seed[4] \ mod \ m_2, y_{-1} = 1` + + if :math:`n \geqslant 6: x_{-3} = seed[0] \ mod \ m_1, x_{-2} = seed[1] \ mod \ m_1, x_{-1} = seed[2] \ mod \ m_1` + + :math:`y_{-3} = seed[3] \ mod \ m_2, y_{-2} = seed[4] \ mod \ m_2, y_{-1} = seed[5] \ mod \ m_2` + + if the values prove to be :math:`x_{-3} = x_{-2} = x_{-1} = 0`, assume :math:`x_{-3} = 1` + + if the values prove to be :math:`y_{-3} = y_{-2} = y_{-1} = 0`, assume :math:`y_{-3} = 1` + + .. _`mrg32k3a(const mrg32k3a& other)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a(const mrg32k3a& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mrg32k3a(mrg32k3a&& other)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a(mrg32k3a&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`mrg32k3a& operator=(const mrg32k3a& other)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a& operator=(const mrg32k3a& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mrg32k3a`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mrg32k3a& operator=(mrg32k3a&& other)`: + + .. code-block:: cpp + + mrg32k3a::mrg32k3a& operator=(mrg32k3a&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mrg32k3a`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt19937.rst new file mode 100644 index 000000000..b1f8b7123 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt19937.rst @@ -0,0 +1,189 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_mt19937: + +mt19937 +======= + +Mersenne Twister pseudorandom number generator. + +.. _onemath_rng_mt19937_description: + +.. rubric:: Description + +The Mersenne Twister pseudorandom number generator, mt19937, is a modification of twisted generalized feedback shift register generator [:ref:`Matsumoto98 `]. MT19937 has the period length of :math:`2^{19937} - 1` and is 623-dimensionally equidistributed with up to 32-bit accuracy. These properties make the generator applicable for simulations in various fields of science and engineering. The state of the generator is represented by 624 32-bit unsigned integer numbers. + +.. container:: section + + .. rubric:: Generation algorithm + + :math:`x_{n}=x_{n-(624-397)} \oplus ( (x_{n-624} \& 0x80000000) | (x_{n - 624 + 1} \& 0x7FFFFFFF) )A` + + :math:`y_{n} = x_{n}` + + :math:`y_{n} = y_{n} \oplus (y_{n} >> 11)` + + :math:`y_{n} = y_{n} \oplus ( (y_{n} << 7) \& 0x9D2C5680)` + + :math:`y_{n} = y_{n} \oplus ( (y_{n} << 15) \& 0xEFC60000)` + + :math:`y_{n} = y_{n} \oplus (y_{n} >> 18)` + + :math:`u_{n} = y_{n} / 2^{32}` + + +.. container:: section + + Matrix :math:`A_j(32x32)` has the following format: + +.. math:: + + \left [ \begin{array}{ccccc} 0 & 1 & 0 & ... & ... \\ 0 & 0 & ... & 0 & ... \\ ... & ... & ... & ... & ... \\ 0 & ... & 0 & 0 & 1 \\ a_{31} & a_{30} & ... & ... & a_{0} \end{array}\right ] + +.. container:: section + + Where the 32-bit vector :math:`a = a_{31}..a_{0}` has the value :math:`a=0x9908B0DF`. + +.. _onemath_rng_mt19937_description_syntax: + +class mt19937 +-------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class mt19937 { + public: + static constexpr std::uint32_t default_seed = 1; + + mt19937(sycl::queue queue, std::uint32_t seed = default_seed); + + mt19937(sycl::queue queue, std::initializer_list seed); + + mt19937(const mt19937& other); + + mt19937(mt19937&& other); + + mt19937& operator=(const mt19937& other); + + mt19937& operator=(mt19937&& other); + + ~mt19937(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `mt19937(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `mt19937(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine + * - `mt19937(const mt19937& other)`_ + - Copy constructor + * - `mt19937(mt19937&& other)`_ + - Move constructor + * - `mt19937& operator=(const mt19937& other)`_ + - Copy assignment operator + * - `mt19937& operator=(mt19937&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`mt19937(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + mt19937::mt19937(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + .. _`mt19937(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + mt19937::mt19937(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + .. _`mt19937(const mt19937& other)`: + + .. code-block:: cpp + + mt19937::mt19937(const mt19937& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mt19937(mt19937&& other)`: + + .. code-block:: cpp + + mt19937::mt19937(mt19937&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt19937`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`mt19937& operator=(const mt19937& other)`: + + .. code-block:: cpp + + mt19937::mt19937& operator=(const mt19937& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mt19937& operator=(mt19937&& other)`: + + .. code-block:: cpp + + mt19937::mt19937& operator=(mt19937&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt2203.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt2203.rst new file mode 100644 index 000000000..b7a6ac297 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-mt2203.rst @@ -0,0 +1,239 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_mt2203: + +mt2203 +====== + +The mt2203 engine is the set of 6024 Mersenne Twister pseudorandom number generators MT2203 [:ref:`Matsumoto98 `], [:ref:`Matsumoto00 `]. + +.. _onemath_rng_mt2203_description: + +.. rubric:: Description + +The set of 6024 basic pseudorandom number generators MT2203 is a natural addition to the MT19937 generator. MT2203 generators are intended for use in large scale Monte Carlo simulations performed on multi-processor computer systems. + +.. container:: section + + .. rubric:: Generation algorithm + + For :math:`j = 1,..., 6024`: + + :math:`x_{n, j} =x_{n - (69 - 34), j} \oplus ( (x_{n - 69, j} \& 0xFFFFFFE0) | (x_{n + 69 + 1, j} \& 0x1F) ) A_{j}` + + :math:`y_{n, j} = x_{n, j}` + + :math:`y_{n, j} = y_{n, j} \oplus (y_{n, j} >> 12)` + + :math:`y_{n, j} = y_{n, j} \oplus ( (y_{n, j} << 7) \& b_j)` + + :math:`y_{n, j} = y_{n, j} \oplus ( (y_{n, j} << 15) \& c_j)` + + :math:`y_{n, j} = y_{n, j} \oplus (y_{n, j} >> 18)` + + +.. container:: section + + Matrix :math:`A_j(32x32)` has the following format: + +.. math:: + + \left [ \begin{array}{ccccc} 0 & 1 & 0 & ... & ... \\ 0 & 0 & ... & 0 & ... \\ ... & ... & ... & ... & ... \\ 0 & ... & 0 & 0 & 1 \\ a_{31, j} & a_{30, j} & ... & ... & a_{0, 1} \end{array}\right ] + + +.. _onemath_rng_mt2203_description_syntax: + +class mt2203 +------------ + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class mt2203 { + public: + static constexpr std::uint32_t default_seed = 1; + + mt2203(sycl::queue queue, std::uint32_t seed = default_seed); + + mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx); + + mt2203(sycl::queue queue, std::initializer_list seed); + + mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx); + + mt2203(const mt2203& other); + + mt2203(mt2203&& other); + + mt2203& operator=(const mt2203& other); + + mt2203& operator=(mt2203&& other); + + ~mt2203(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `mt2203(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine (for this case multiple generators of the set would be used) + * - `mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`_ + - Constructor for common seed initialization of the engine (for this case single generator of the set would be used) + * - `mt2203(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine (for this case multiple generators of the set would be used) + * - `mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx)`_ + - Constructor for extended seed initialization of the engine (for this case single generator of the set would be used) + * - `mt2203(const mt2203& other)`_ + - Copy constructor + * - `mt2203(mt2203&& other)`_ + - Move constructor + * - `mt2203& operator=(const mt2203& other)`_ + - Copy assignment operator + * - `mt2203& operator=(mt2203&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`mt2203(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + mt2203::mt2203(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + .. _`mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`: + + .. code-block:: cpp + + mt2203::mt2203(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + engine_idx + The index of the set 1, ..., 6024. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`idx > 6024` + + .. _`mt2203(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + mt2203::mt2203(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + .. _`mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx)`: + + .. code-block:: cpp + + mt2203::mt2203(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`MT2203 `]. + + engine_idx + The index of the set 1, ..., 6024. + + .. _`mt2203(const mt2203& other)`: + + .. code-block:: cpp + + mt2203::mt2203(const mt2203& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt2203`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mt2203(mt2203&& other)`: + + .. code-block:: cpp + + mt2203::mt2203(mt2203&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt2203`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`mt2203& operator=(const mt2203& other)`: + + .. code-block:: cpp + + mt2203::mt2203& operator=(const mt2203& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt2203`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`mt2203& operator=(mt2203&& other)`: + + .. code-block:: cpp + + mt2203::mt2203& operator=(mt2203&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``mt2203`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-multinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-multinomial.rst new file mode 100644 index 000000000..73700c3ca --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-multinomial.rst @@ -0,0 +1,170 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_multinomial: + +multinomial +=========== + +Class is used for generation of multinomially distributed integer types random numbers. + +.. _onemath_rng_multinomial_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide `n` random numbers multinomially distributed, with independent trials :math:`(ntrial, m)` and possible mutually exclusive outcomes :math:`k`, with corresponding probabilities :math:`p_i`, where :math:`p_i \in R; 0 \leq p_i \leq 1; m, k \in N`. + +The probability distribution is given by: + +.. math:: + + P(X_1 = x_1, ..., X_k = x_k) = \frac{m!}{\Pi^k_{i = 1}x_i!}\Pi^k_{i = 1}p_i^{x_i}, 0 \leq x_i \leq m, \sum^{k}_{i = 1}x_i = m + +.. _onemath_rng_multinomial_syntax: + +class multinomial +----------------- + +Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). +It's implementation defined which type ``SequenceContainerOrView`` represents. + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class multinomial { + public: + using method_type = Method; + using result_type = IntType; + explicit multinomial(double ntrial, SequenceContainerOrView p); + std::int32_t ntrial() const; + SequenceContainerOrView p() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + * ``std::uint32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::multinomial_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::multinomial_method::by_default`` + * ``oneapi::math::rng::multinomial_method::poisson_icdf_based`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `explicit multinomial(double ntrial, SequenceContainerOrView p)`_ + - Constructor with parameters + * - `std::int32_t ntrial() const`_ + - Method to obtain number of independent trials + * - `SequenceContainerOrView p() const`_ + - Method to obtain a probability parameter of possible outcomes + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + multinomial::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines the transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + multinomial::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines the type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`explicit multinomial(double ntrial, SequenceContainerOrView p)`: + + .. code-block:: cpp + + explicit multinomial::multinomial(double ntrial, SequenceContainerOrView p) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. ``ntrial`` is a number of independent trials, ``p`` is a probability parameter. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`ntrial < 0`, or :math:`p.size() < 1` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t ntrial() const`: + + .. code-block:: cpp + + std::int32_t multinomial::ntrial() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `ntrial`. + + .. container:: section + + .. _`SequenceContainerOrView p() const`: + + .. code-block:: cpp + + SequenceContainerOrView multinomial::p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `p`. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-negbinomial.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-negbinomial.rst new file mode 100644 index 000000000..8711da3fc --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-negbinomial.rst @@ -0,0 +1,191 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_negative_binomial: + +negative_binomial +================= + +Class is used for generation of negative binomially distributed integer types random numbers. + +.. _onemath_rng_negative_binomial_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers negative binomially distributed with distribution parameters :math:`a` and :math:`p`, where :math:`p, a \in R; 0 \leq p \leq 1, a > 0`. + +The probability distribution is given by: + +.. math:: + + P(X = k) = C^k_{a + k - 1}p^a(1 - p)^{k}, k \in \{0, 1, 2, ...\} + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, p}(x) = \left\{ \begin{array}{rcl} \sum^{\lfloor x \rfloor}_{k = 0} C^k_{a + k - 1}p^a(1 - p)^{k}, x \ge 0, x \in R \\ 0, x < 0 \end{array}\right. + + +.. _onemath_rng_negative_binomial_syntax: + +class negative_binomial +----------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class negative_binomial { + public: + using method_type = Method; + using result_type = IntType; + negative_binomial(); + explicit negative_binomial(double a, double p); + double a() const; + double p() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + * ``std::uint32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::negative_binomial_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::negative_binomial_method::by_default`` + * ``oneapi::math::rng::negative_binomial_method::nbar`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `negative_binomial()`_ + - Default constructor + * - `explicit negative_binomial(double a, double p)`_ + - Constructor with parameters + * - `double a() const`_ + - Method to obtain the first distribution parameter `a` + * - `double p() const`_ + - Method to obtain the second distribution parameter `p` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + negative_binomial::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + negative_binomial::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`negative_binomial()`: + + .. code-block:: cpp + + negative_binomial::negative_binomial() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.1, `p` = 0.5. + + .. container:: section + + .. _`explicit negative_binomial(double a, double p)`: + + .. code-block:: cpp + + explicit negative_binomial::negative_binomial(double a, double p) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is the first distribution parameter, `p` is the second distribution parameter. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`p \ge 1.0`, or :math:`p \leq 0.0`, or :math:`a \leq 0.0` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`double a() const`: + + .. code-block:: cpp + + double negative_binomial::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - the first distribution parameter. + + .. container:: section + + .. _`double p() const`: + + .. code-block:: cpp + + double negative_binomial::p() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `p` - the second distribution parameter. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-niederreiter.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-niederreiter.rst new file mode 100644 index 000000000..114a210b6 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-niederreiter.rst @@ -0,0 +1,169 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_niederreiter: + +niederreiter +============ + +The niederreiter generator is a 32-bit Gray code-based quasi-random number generator. + +.. _onemath_rng_niederreiter_description: + +.. rubric:: Description + +According to results of Bratley, Fox and Niederreiter :ref:`[Bratley92] ` Niederreiter sequences have the best known theoretical asymptotic properties. The default dimension of quasi-random vectors can vary from 1 to 318 inclusive. It is also allowed to register user-defined parameters (irreducible polynomials). + +.. container:: section + + .. rubric:: Generation algorithm + + + :math:`x_n=x_{n_1} \oplus v_c` + + :math:`u_n=x_n / 2 ^ {32}` + + The value :math:`c` is the right-most zero bit in :math:`n-1`; :math:`x_n` is s-dimensional vector of 32-bit values. The s-dimensional vectors (calculated during engine initialization) :math:`v_i, i = 1, 32` are called direction numbers. The vector :math:`u_n` is the generator output normalized to the unit hypercube :math:`(0, 1) ^ s`. + +.. _onemath_rng_niederreiter_description_syntax: + +class niederreiter +------------------ + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class niederreiter { + public: + static constexpr std::uint32_t default_dimensions_number = 1; + + niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number); + + niederreiter(sycl::queue queue, std::vector& irred_polynomials); + + niederreiter(const niederreiter& other); + + niederreiter(niederreiter&& other); + + niederreiter& operator=(const niederreiter& other); + + niederreiter& operator=(niederreiter&& other); + + ~niederreiter(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`_ + - Constructor with specified number of dimensions. The value should be :math:`1..318`. + * - `niederreiter(sycl::queue queue, std::vector& irred_polynomials)`_ + - Constructor for extended use-case, when it's needed to use the number of dimensions greater than 318 or obtain another sequence. + * - `niederreiter(const niederreiter& other)`_ + - Copy constructor + * - `niederreiter(niederreiter&& other)`_ + - Move constructor + * - `niederreiter& operator=(const niederreiter& other)`_ + - Copy assignment operator + * - `niederreiter& operator=(niederreiter&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`: + + .. code-block:: cpp + + niederreiter::niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + dimensions + Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 318`, assume :math:`dimen = 1`. + + .. _`niederreiter(sycl::queue queue, std::vector& irred_polynomials)`: + + .. code-block:: cpp + + niederreiter::niederreiter(sycl::queue queue, std::vector& irred_polynomials) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + irred_polynomials + If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own irreducible polynomials. The number of dimensions corresponds to the length of the vector. + + .. _`niederreiter(const niederreiter& other)`: + + .. code-block:: cpp + + niederreiter::niederreiter(const niederreiter& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``niederreiter`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`niederreiter(niederreiter&& other)`: + + .. code-block:: cpp + + niederreiter::niederreiter(niederreiter&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``niederreiter`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`niederreiter& operator=(const niederreiter& other)`: + + .. code-block:: cpp + + niederreiter::niederreiter& operator=(const niederreiter& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``niederreiter`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`niederreiter& operator=(niederreiter&& other)`: + + .. code-block:: cpp + + niederreiter::niederreiter& operator=(niederreiter&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``niederreiter`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-nondeterministic.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-nondeterministic.rst new file mode 100644 index 000000000..886c09a51 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-nondeterministic.rst @@ -0,0 +1,134 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_nondeterministic: + +nondeterministic +================ + +Non-deterministic random number generator. + +.. _onemath_rng_nondeterministic_description: + +.. rubric:: Description + +Implementation defined generator with non-deterministic source of randomness (for example, a hardware device). + +.. _onemath_rng_nondeterministic_description_syntax: + +class nondeterministic +---------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class nondeterministic { + public: + nondeterministic(sycl::queue queue); + + nondeterministic(const nondeterministic& other); + + nondeterministic(nondeterministic&& other); + + nondeterministic& operator=(const nondeterministic& other); + + nondeterministic& operator=(nondeterministic&& other); + + ~nondeterministic(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `nondeterministic(sycl::queue queue)`_ + - Constructor for the particular device + * - `nondeterministic(const nondeterministic& other)`_ + - Copy constructor + * - `nondeterministic(nondeterministic&& other)`_ + - Move constructor + * - `nondeterministic& operator=(const nondeterministic& other)`_ + - Copy assignment operator + * - `nondeterministic& operator=(nondeterministic&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`nondeterministic(sycl::queue queue)`: + + .. code-block:: cpp + + nondeterministic::nondeterministic(sycl::queue queue) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + + .. _`nondeterministic(const nondeterministic& other)`: + + .. code-block:: cpp + + nondeterministic::nondeterministic(const nondeterministic& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`nondeterministic(nondeterministic&& other)`: + + .. code-block:: cpp + + nondeterministic::nondeterministic(nondeterministic&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`nondeterministic& operator=(const nondeterministic& other)`: + + .. code-block:: cpp + + nondeterministic::nondeterministic& operator=(const nondeterministic& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``nondeterministic`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`nondeterministic& operator=(nondeterministic&& other)`: + + .. code-block:: cpp + + nondeterministic::nondeterministic& operator=(nondeterministic&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``nondeterministic`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-philox4x32x10.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-philox4x32x10.rst new file mode 100644 index 000000000..c2b5d4d0a --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-philox4x32x10.rst @@ -0,0 +1,196 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_philox4x32x10: + +philox4x32x10 +============= + +The Philox4x32x10 counter-based pseudorandom number generator. + +.. _onemath_rng_philox4x32x10_description: + +.. rubric:: Description + +The Philox4x32x10 engine is a keyed family of generator of counter-based BRNG. The state consists of 128-bit integer counter :math:`c` and two 32-bits keys :math:`k_0` and :math:`k_1`. + +.. container:: section + + .. rubric:: Generation algorithm + + The generator has 32-bit integer output obtained in the following way [:ref:`Salmon11 `]: + + 1. :math:`c_n=c_{n-1} + 1` + 2. :math:`\omega_n = f(c_n)`, where :math:`f` is a function that takes 128-bit argument and returns a 128-bit number. The returned number is obtained as follows: + 2.1. The argument :math:`c` is interpreted as four 32-bit numbers :math:`c = \overline{L_1 R_1 L_0 R_0}`, where :math:`\overline{A B C D} = A \cdot 2^{96} + B \cdot 2^{64} + C \cdot 2^{32} + D`, put :math:`k_0^0 =k_0, k_1^0=k_1`. + + 2.2. The following recurrence is calculated: + + :math:`L_1^{i+1} =mullo(R_1^i, 0xD2511F53)` + + :math:`R_1^{i+1} =mulhi(R_0^i, 0xCD9E8D57) \oplus k_0^i \oplus L_0^i` + + :math:`L_0^{i+1} =mullo(R_0^i, 0xCD9E8D57)` + + :math:`R_0^{i+1} =mulhi(R_1^i, 0xD2511F53) \oplus k_1^i \oplus L_1^i` + + :math:`k_0^{i+1} =k_0^i + 0xBB67AE85` + + :math:`k_1^{i+1} =k_1^i + 0x9E3779B9`, where :math:`mulhi(a, b)` and :math:`mullo(a, b)` are high and low parts of the :math:`a \cdot b` product respectively. + + 2.3. Put :math:`f(c) = \overline{L_1^N R_1^N L_0^N R_0^N}`, where :math:`N = 10` + + 3. Integer output: :math:`r_{4n + k} = \omega_n(k)`, where :math:`\omega_n(k)` is the k-th 32-bit integer in quadruple :math:`\omega_n, k = 0, 1, 2, 3` + 4. Real output: :math:`u_n=(int)r_n / 2^{32} + 1/2` + +.. _onemath_rng_philox4x32x10_description_syntax: + +class philox4x32x10 +------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class philox4x32x10 { + public: + static constexpr std::uint64_t default_seed = 0; + + philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed); + + philox4x32x10(sycl::queue queue, std::initializer_list seed); + + philox4x32x10(const philox4x32x10& other); + + philox4x32x10(philox4x32x10&& other); + + philox4x32x10& operator=(const philox4x32x10& other); + + philox4x32x10& operator=(philox4x32x10&& other); + + ~philox4x32x10(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `philox4x32x10(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine + * - `philox4x32x10(const philox4x32x10& other)`_ + - Copy constructor + * - `philox4x32x10(philox4x32x10&& other)`_ + - Move constructor + * - `philox4x32x10& operator=(const philox4x32x10& other)`_ + - Copy assignment operator + * - `philox4x32x10& operator=(philox4x32x10&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10(sycl::queue queue, std::uint64_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`k = seed, c = 0`, where :math:`k` is a 64-bit key, :math:`c` is a 128-bit counter. + + .. _`philox4x32x10(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume + if :math:`n = 0: k = 0, c = 0` + + if :math:`n = 1: k = seed[0], c = 0` + + if :math:`n = 2: k = seed[0], c = seed[1]` + + if :math:`n = 3: k = seed[0], c = seed[1] + seed[2] \cdot 2^{64}` + + for :math:`n > 3` following arguments are ignored + + .. _`philox4x32x10(const philox4x32x10& other)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10(const philox4x32x10& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``philox4x32x10`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`philox4x32x10(philox4x32x10&& other)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10(philox4x32x10&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``philox4x32x10`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`philox4x32x10& operator=(const philox4x32x10& other)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10& operator=(const philox4x32x10& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``philox4x32x10`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`philox4x32x10& operator=(philox4x32x10&& other)`: + + .. code-block:: cpp + + philox4x32x10::philox4x32x10& operator=(philox4x32x10&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``philox4x32x10`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson.rst new file mode 100644 index 000000000..79d881c61 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson.rst @@ -0,0 +1,173 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_poisson: + +poisson +======= + +Class is used for generation of Poisson distributed integer types random numbers. + +.. _onemath_rng_poisson_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Poisson distributed with distribution parameter :math:`\lambda`, where :math:`\lambda \in R; \lambda > 0;`. + +The probability distribution is given by: + +.. math:: + + P(X = k) = \frac{\lambda^ke^{-\lambda}}{k!}. + +The cumulative distribution function is as follows: + +.. math:: + + F_{\lambda}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda^ke^{-\lambda}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. + +.. _onemath_rng_poisson_syntax: + +class poisson +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class poisson { + public: + using method_type = Method; + using result_type = IntType; + poisson(); + explicit poisson(double lambda); + double lambda() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::poisson_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::poisson_method::by_default`` + * ``oneapi::math::rng::poisson_method::ptpe`` + * ``oneapi::math::rng::poisson_method::gaussian_icdf_based`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `poisson()`_ + - Default constructor + * - `explicit poisson(double lambda)`_ + - Constructor with parameters + * - `double lambda() const`_ + - Method to obtain distribution parameter + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + poisson::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + poisson::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`poisson()`: + + .. code-block:: cpp + + poisson::poisson() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `lambda` = 0.5. + + .. container:: section + + .. _`explicit poisson(double lambda)`: + + .. code-block:: cpp + + explicit poisson::poisson(double lambda) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `lambda` is a distribution parameter. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`lambda \leq 0.0` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`double lambda() const`: + + .. code-block:: cpp + + double poisson::lambda() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `lambda`. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson_v.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson_v.rst new file mode 100644 index 000000000..d9a93424e --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-poisson_v.rst @@ -0,0 +1,159 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_poisson_v: + +poisson_v +========= + +Class is used for generation of Poisson distributed integer types random numbers with varying mean. + +.. _onemath_rng_poisson_v_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide +n random numbers Poisson distributed, with distribution parameter :math:`\lambda_i`, where :math:`\lambda_i \in R; \lambda_i > 0; i = 1, ... , n`. + +The probability distribution is given by: + +.. math:: + + P(X_i = k) = \frac{\lambda_i^ke^{-\lambda_i}}{k!}, k \in \{0, 1, 2, ... \}. + +The cumulative distribution function is as follows: + +.. math:: + + F_{\lambda_i}(x) = \left\{ \begin{array}{rcl} \sum_{k = 0}^{\lfloor x \rfloor} \frac{\lambda_i^ke^{-\lambda_i}}{k!}, x \ge 0 \\ 0, x < 0 \end{array}\right. + +.. _onemath_rng_poisson_v_syntax: + +class poisson_v +--------------- + +Let ``SequenceContainerOrView`` be a type that can be one of C++ Sequence containers or C++ Views (``span``, ``mdspan``). +It's implementation defined which type ``SequenceContainerOrView`` represents. + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class poisson_v { + public: + using method_type = Method; + using result_type = IntType; + explicit poisson_v(SequenceContainerOrView lambda); + SequenceContainerOrView lambda() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename IntType + Type of the produced values. Supported types: + * ``std::int32_t`` + + .. container:: section + + typename Method = oneapi::math::rng::poisson_v_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::poisson_v_method::by_default`` + * ``oneapi::math::rng::poisson_v_method::gaussian_icdf_based`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `explicit poisson_v(SequenceContainerOrView lambda)`_ + - Constructor with parameters + * - `SequenceContainerOrView lambda() const`_ + - Method to obtain distribution parameter + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + poisson_v::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + poisson_v::result_type = IntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`explicit poisson_v(SequenceContainerOrView lambda)`: + + .. code-block:: cpp + + explicit poisson_v::poisson_v(SequenceContainerOrView lambda) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. ``lambda`` is a distribution parameter. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`lambda.size() \leq 1` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`SequenceContainerOrView lambda() const`: + + .. code-block:: cpp + + SequenceContainerOrView poisson_v::lambda() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter ``lambda``. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-r250.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-r250.rst new file mode 100644 index 000000000..948a4c695 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-r250.rst @@ -0,0 +1,169 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_r250: + +r250 +==== + +The 32-bit generalized feedback shift register pseudorandom number generator GFSR(250,103) :ref:`[Kirkpatrick81] `. + +.. _onemath_rng_r250_description: + +.. rubric:: Description + +Feedback shift register generators possess ample theoretical foundation and were initially intended for cryptographic and communication applications. The stream state is the array of 250 32-bit integers. + +.. container:: section + + .. rubric:: Generation algorithm + + + :math:`x_n=x_{n-103} \oplus x_{n-250}` + + :math:`u_n=x_n / 2 ^ {32}` + + +.. _onemath_rng_r250_description_syntax: + +class r250 +---------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class r250 { + public: + static constexpr std::uint32_t default_seed = 1; + + r250(sycl::queue queue, std::uint32_t seed = default_seed); + + r250(sycl::queue queue, std::vector seed); + + r250(const r250& other); + + r250(r250&& other); + + r250& operator=(const r250& other); + + r250& operator=(r250&& other); + + ~r250(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `r250(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `r250(sycl::queue queue, std::vector seed)`_ + - Constructor for extended seed initialization of the engine + * - `r250(const r250& other)`_ + - Copy constructor + * - `r250(r250&& other)`_ + - Move constructor + * - `r250& operator=(const r250& other)`_ + - Copy assignment operator + * - `r250& operator=(r250&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`r250(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + r250::r250(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid sycl::queue object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume :math:`x_{-250} = seed`. If :math:`seed = 0`, assume :math:`seed = 1`. Other values in state are initialized according to recurrent correlation :math:`x_{n+1} = 69069x_{n}(mod \ 2 ^ {32})`. Then the values :math:`x_{7k-247}, k = 0, 1, ..., 31` are interpreted as a binary matrix of size 32 x 32 and diagonal bits are set to 0, the under-diagonal bits to 0. + + .. _`r250(sycl::queue queue, std::vector seed)`: + + .. code-block:: cpp + + r250::r250(sycl::queue queue, std::vector seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state + if :math:`n \geqslant 0: x_{k-250} = seed[k], k = 0, 1, ..., 249` + + .. _`r250(const r250& other)`: + + .. code-block:: cpp + + r250::r250(const r250& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``r250`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`r250(r250&& other)`: + + .. code-block:: cpp + + r250::r250(r250&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``r250`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`r250& operator=(const r250& other)`: + + .. code-block:: cpp + + r250::r250& operator=(const r250& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``r250`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`r250& operator=(r250&& other)`: + + .. code-block:: cpp + + r250::r250& operator=(r250&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``r250`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-rayleigh.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-rayleigh.rst new file mode 100644 index 000000000..eb608e1d3 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-rayleigh.rst @@ -0,0 +1,193 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_rayleigh: + +rayleigh +======== + +Class is used for generation of Rayleigh distributed real types random numbers. + +.. _onemath_rng_rayleigh_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Rayleigh distributed with displacement :math:`a`, and scalefactor :math:`(b, \beta)`, where :math:`a, \beta \in R; \beta > 0`. + +The Rayleigh distribution is a special case of the :ref:`onemath_rng_weibull` distribution, where the shape parameter `\alpha` = 2 . + +The probability distribution is given by: + +.. math:: + + f_{a, \beta}(x) = \left\{ \begin{array}{rcl} \frac{2(x - a)}{\beta^2}exp(-\frac{(x - a)^2)}{\beta^2}), x \ge a \\ 0, x < a \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp(-\frac{(x - a)^2)}{\beta^2}), x \ge a \\ 0, x < a \end{array}\right. + +.. _onemath_rng_rayleigh_syntax: + +class rayleigh +-------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class rayleigh { + public: + using method_type = Method; + using result_type = RealType; + rayleigh(); + explicit rayleigh(RealType a, RealType b); + RealType a() const; + RealType b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::rayleigh_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::rayleigh_method::by_default`` + * ``oneapi::math::rng::rayleigh_method::icdf`` + * ``oneapi::math::rng::rayleigh_method::icdf_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `rayleigh()`_ + - Default constructor + * - `explicit rayleigh(RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType b() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + rayleigh::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + rayleigh::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`rayleigh()`: + + .. code-block:: cpp + + rayleigh::rayleigh() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, and `b` = 1.0. + + .. container:: section + + .. _`explicit rayleigh(RealType a, RealType b)`: + + .. code-block:: cpp + + explicit rayleigh::rayleigh(RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a displacement value, `b` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`b \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType rayleigh::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement value. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType rayleigh::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sfmt19937.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sfmt19937.rst new file mode 100644 index 000000000..770d82d03 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sfmt19937.rst @@ -0,0 +1,179 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_sfmt19937: + +sfmt19937 +========= + +The SIMD-oriented Mersenne Twister pseudorandom number generator. + +.. _onemath_rng_sfmt19937_description: + +.. rubric:: Description + +SIMD-oriented Fast Mersenne Twister pseudorandom number generator SFMT19937 [:ref:`Saito08 `] with a period length equal to :math:`2 ^ {19937}-1` of the produced sequence. The state of the engine contains the array of 156 128-bit integers. + +.. container:: section + + .. rubric:: Generation algorithm + + :math:`w_n = w_0 A \oplus w_M B \oplus w_{n-2} C \oplus w_{n-1} D` + + Where :math:`w_0, w_M, w_{n-2}, ...` are the 128-bit integers, and :math:`wA, wB, wC, wD` operations are defined as follows: + + :math:`wA = (w << 8) \oplus w`, left shift of 128-bit integer :math:`w` by :math:`a` followed by exclusive-or operation + + :math:`wB = (w >> 8) \& mask`, right shift of each 32-bit integer in quadruple :math:`w` by and-operator with quadruple of 32-bit masks :math:`mask = (0xBFFFFFF6, 0xDFFAFFFF, 0xDDFECB7F, 0xDFFFFFEF)` + + :math:`wC = (w >> 8) \oplus w`, right shift of 128-bit integer :math:`w` + + :math:`wD = (w << 8)`, left shift of each 32-bit integer in quadruple :math:`w` + + Integer output: :math:`r_{4n+k} = w_{n}(k)`, where :math:`w_{n}(k)` is the k-th 32-bit integer in quadruple :math:`w_{n}, k = 0, 1, 2, 3` + + :math:`u_n = (int) r_n / 2^{32} + 1/2` + + +.. _onemath_rng_sfmt19937_description_syntax: + +class sfmt19937 +--------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class sfmt19937 { + public: + static constexpr std::uint32_t default_seed = 1; + + sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed); + + sfmt19937(sycl::queue queue, std::initializer_list seed); + + sfmt19937(const sfmt19937& other); + + sfmt19937(sfmt19937&& other); + + sfmt19937& operator=(const sfmt19937& other); + + sfmt19937& operator=(sfmt19937&& other); + + ~sfmt19937(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine + * - `sfmt19937(sycl::queue queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine + * - `sfmt19937(const sfmt19937& other)`_ + - Copy constructor + * - `sfmt19937(sfmt19937&& other)`_ + - Move constructor + * - `sfmt19937& operator=(const sfmt19937& other)`_ + - Copy assignment operator + * - `sfmt19937& operator=(sfmt19937&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. + + .. _`sfmt19937(sycl::queue queue, std::initializer_list seed)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937(sycl::queue queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. The initialization algorithm described in [:ref:`Saito08 `]. + + .. _`sfmt19937(const sfmt19937& other)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937(const sfmt19937& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`sfmt19937(sfmt19937&& other)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937(sfmt19937&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`sfmt19937& operator=(const sfmt19937& other)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937& operator=(const sfmt19937& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sfmt19937`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`sfmt19937& operator=(sfmt19937&& other)`: + + .. code-block:: cpp + + sfmt19937::sfmt19937& operator=(sfmt19937&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sfmt19937`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-skip_ahead.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-skip_ahead.rst new file mode 100644 index 000000000..dc6c616a7 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-skip_ahead.rst @@ -0,0 +1,121 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_skip_ahead: + +skip_ahead +========== + +Proceed state of engine by the skip-ahead method. + +.. _onemath_rng_skip_ahead_description: + +.. rubric:: Description and Assumptions + +oneapi::math::rng::skip_ahead function changes the current state of the engine so that with the further call of the generator the output subsequence begins with the specified offset see `Figure "Block-Splitting Method" <#rng_block_splitting>`__. + +.. container:: figtop + :name: rng_block_splitting + + Block-Splitting Method + + |image0| + +.. _onemath_rng_skip_ahead_common: + +skip_ahead +---------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + void skip_ahead(EngineType& engine, std::uint64_t num_to_skip); + } + +.. container:: section + + .. rubric:: Template Parameters + + EngineType + Type of engine. Note: may not be supported by all available engine classes. + +.. container:: section + + .. rubric:: Input Parameters + + engine + Engine which state would be skipped. + + num_to_skip + Number of elements to skip in the engine's sequence. + +.. rubric:: Example + +.. code-block:: cpp + + // Creating 3 identical engines + oneapi::math::rng::mcg31m1 engine_1(queue, seed); + oneapi::math::rng::mcg31m1 engine_2(engine_1); + oneapi::math::rng::mcg31m1 engine_3(engine_2); + + // Skipping ahead by 7 elements the 2nd engine + oneapi::math::rng::skip_ahead(engine_2, 7); + + // Skipping ahead by 14 elements the 3rd engine + oneapi::math::rng::skip_ahead(engine_3, 14); + + +.. _onemath_rng_skip_ahead_ex: + +skip_ahead (Interface with a partitioned number of skipped elements) +-------------------------------------------------------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + void oneapi::math::rng::skip_ahead(EngineType& engine, std::initializer_list num_to_skip); + } + +.. container:: section + + .. rubric:: Template Parameters + + EngineType + Type of engine. Note: may not be supported by all available engine classes. + +.. container:: section + + .. rubric:: Input Parameters + + engine + Engine which state would be skipped. + + num_to_skip + Partitioned number of elements to skip in the engine's sequence. The total number of skipped elements would be: :math:`num\_to\_skip[0] + num\_to\_skip[1] \cdot 2^{64} + ... + num\_to\_skip[1] \cdot 2^{64 (n - 1)}`, where n is a number of elements in num_to_skip list. + +.. rubric:: Example with Partitioned Numer of Elements + +.. code-block:: cpp + + // Creating the first engine + oneapi::math::rng::mrg32k3a engine_1(queue, seed); + + // To skip 2^64 elements in the random stream number of skipped elements should be + // represented as num_to_skip = 2^64 = 0 + 1 * 2^64 + std::initializer_list num_to_skip = {0, 1}; + + // Creating the 2nd engine based on 1st. Skipping by 2^64 + oneapi::math::rng::mrg32k3a engine_2(engine_1); + oneapi::math::rng::skip_ahead(engine_2, num_to_skip); + + +**Parent topic:** :ref:`onemath_rng_service_routines` + +.. |image0| image:: ../../equations/rng-skip-ahead.png diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sobol.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sobol.rst new file mode 100644 index 000000000..4fb71cdf7 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-sobol.rst @@ -0,0 +1,169 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_sobol: + +sobol +===== + +The sobol is a 32-bit Gray code-based quasi-random number generator. + +.. _onemath_rng_sobol_description: + +.. rubric:: Description + +Bratley and Fox :ref:`[Bratley88] ` provide an implementation of the SOBOL quasi-random number generator. The default dimensions of quasi-random vectors can vary from 1 to 40 inclusive. It is also allowed to register user-defined parameters (direction numbers). + +.. container:: section + + .. rubric:: Generation algorithm + + + :math:`x_n=x_{n_1} \oplus v_c` + + :math:`u_n=x_n / 2 ^ {32}` + + The value :math:`c` is the right-most zero bit in :math:`n-1`; :math:`x_n` is s-dimensional vector of 32-bit values. The s-dimensional vectors (calculated during engine initialization) :math:`v_i, i = 1, 32` are called direction numbers. The vector :math:`u_n` is the generator output normalized to the unit hypercube :math:`(0, 1) ^ s`. + +.. _onemath_rng_sobol_description_syntax: + +class sobol +----------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class sobol { + public: + static constexpr std::uint32_t default_dimensions_number = 1; + + sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number); + + sobol(sycl::queue queue, std::vector& direction_numbers); + + sobol(const sobol& other); + + sobol(sobol&& other); + + sobol& operator=(const sobol& other); + + sobol& operator=(sobol&& other); + + ~sobol(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`_ + - Constructor with specified number of dimensions. The value should be :math:`1..40`. + * - `sobol(sycl::queue queue, std::vector& direction_numbers)`_ + - Constructor for extended use-case, when it's needed to use the number of dimensions greater than 40 or obtain another sequence. + * - `sobol(const sobol& other)`_ + - Copy constructor + * - `sobol(sobol&& other)`_ + - Move constructor + * - `sobol& operator=(const sobol& other)`_ + - Copy assignment operator + * - `sobol& operator=(sobol&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number)`: + + .. code-block:: cpp + + sobol::sobol(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + dimensions + Number of dimensions. If :math:`dimen < 1` or :math:`dimen > 40`, assume :math:`dimen = 1`. + + .. _`sobol(sycl::queue queue, std::vector& direction_numbers)`: + + .. code-block:: cpp + + sobol::sobol(sycl::queue queue, std::vector& direction_numbers) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + direction_numbers + If you want to generate quasi-random vectors of greater dimension or obtain another sequence, you can register a set of your own direction_numbers. The number of dimensions corresponds to direction_numbers.size() / 32. + + .. _`sobol(const sobol& other)`: + + .. code-block:: cpp + + sobol::sobol(const sobol& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sobol`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`sobol(sobol&& other)`: + + .. code-block:: cpp + + sobol::sobol(sobol&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sobol`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`sobol& operator=(const sobol& other)`: + + .. code-block:: cpp + + sobol::sobol& operator=(const sobol& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sobol`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`sobol& operator=(sobol&& other)`: + + .. code-block:: cpp + + sobol::sobol& operator=(sobol&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``sobol`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-continuous.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-continuous.rst new file mode 100644 index 000000000..2feb34f87 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-continuous.rst @@ -0,0 +1,193 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_uniform_continuous: + +uniform (continuous) +==================== + +Class is used for generation of uniformly distributed real types random numbers. + +.. _onemath_rng_uniform_continuous_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +interval, respectively, and :math:`a, b \in R; a < b` + +The probability distribution is given by: + +.. math:: + + f_{a, b}(x) = \left\{ \begin{array}{rcl} \frac{1}{b-a}, x \in [a, b) \\ 0, x \notin [a, b) \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{x - a}{b - a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. + + +.. _onemath_rng_uniform_continuous_syntax: + +class uniform +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class uniform { + public: + using method_type = Method; + using result_type = RealType; + uniform(); + explicit uniform(RealType a, RealType b); + RealType a() const; + RealType b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::uniform_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::uniform_method::by_default`` + * ``oneapi::math::rng::uniform_method::standard`` + * ``oneapi::math::rng::uniform_method::accurate`` + + See description of the methods in :ref:`Distributions methods template parameter` + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `uniform()`_ + - Default constructor + * - `explicit uniform(RealType a, RealType b)`_ + - Constructor with parameters + * - `RealType a() const`_ + - Method to obtain left bound `a` + * - `RealType b() const`_ + - Method to obtain right bound `b` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + uniform::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + uniform::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`uniform()`: + + .. code-block:: cpp + + uniform::uniform() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0.0, `b` = 1.0. + + .. container:: section + + .. _`explicit uniform(RealType a, RealType b)`: + + .. code-block:: cpp + + explicit uniform::uniform(RealType a, RealType b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a left bound, `b` is a right bound, assume :math:`a < b`. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`a \ge b` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType uniform::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - left bound. + + .. container:: section + + .. _`RealType b() const`: + + .. code-block:: cpp + + RealType uniform::b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - right bound. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-discrete.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-discrete.rst new file mode 100644 index 000000000..9babc632d --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform-discrete.rst @@ -0,0 +1,185 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_uniform_discrete: + +uniform (discrete) +================== + +Class is used for generation of uniformly distributed integer types random numbers. + +.. _onemath_rng_uniform_discrete_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers uniformly distributed over the interval :math:`[a, b)`, where :math:`a`, :math:`b` are the left and right bounds of the +interval, respectively, and :math:`a, b \in R; a < b`. + +The probability distribution is given by: + +.. math:: + + P(X = k) = \frac{1}{b - a}, k \in \{a, a + 1, ... , b - 1\} + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, b}(x) = \left\{ \begin{array}{rcl} 0, x < a \\ \frac{\lfloor x - a + 1 \rfloor}{b-a}, a \leq x < b, x \in R \\ 1, x \ge b \end{array}\right. + + +.. _onemath_rng_uniform_discrete_syntax: + +class uniform +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class uniform { + public: + using method_type = Method; + using result_type = std::int32_t; + uniform(); + explicit uniform(std::int32_t a, std::int32_t b); + std::int32_t a() const; + std::int32_t b() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename Method = oneapi::math::rng::uniform_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::uniform_method::by_default`` + * ``oneapi::math::rng::uniform_method::standard`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `uniform()`_ + - Default constructor + * - `explicit uniform(std::int32_t a, std::int32_t b)`_ + - Constructor with parameters + * - `std::int32_t a() const`_ + - Method to obtain left bound `a` + * - `std::int32_t b() const`_ + - Method to obtain right bound `b` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + result_type = std::int32_t + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`uniform()`: + + .. code-block:: cpp + + uniform() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `a` = 0, `b` = std::numeric_limits::max(). + + .. container:: section + + .. _`explicit uniform(std::int32_t a, std::int32_t b)`: + + .. code-block:: cpp + + uniform(std::int32_t a, std::int32_t b) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `a` is a left bound, `b` is a right bound, assume :math:`a < b`. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`a \ge b` + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`std::int32_t a() const`: + + .. code-block:: cpp + + a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - left bound. + + .. container:: section + + .. _`std::int32_t b() const`: + + .. code-block:: cpp + + b() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `b` - right bound. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform_bits.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform_bits.rst new file mode 100644 index 000000000..748c16a31 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-uniform_bits.rst @@ -0,0 +1,60 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_uniform_bits: + +uniform_bits +============ + +Class is used for generation of uniformly distributed bits in 32/64-bit chunks. + +.. _onemath_rng_uniform_bits_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide uniformly distributed bits in 32/64-bit chunks. It is designed to ensure each bit in the 32/64-bit chunk is uniformly distributed. Can be not supported by the specific engine. + +class uniform_bits +------------------ + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class uniform_bits { + public: + using result_type = UIntType; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename UIntType + Type of the produced values. Supported types: + * ``std::uint32_t`` + * ``std::uint64_t`` + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + uniform_bits::result_type = UIntType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst index 571d120c5..4a4ad5a32 100644 --- a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-usage-model.rst @@ -5,7 +5,7 @@ .. _onemath_rng_usage_model: oneMath RNG Host Usage Model -=========================== +============================ .. rubric:: Description diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-weibull.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-weibull.rst new file mode 100644 index 000000000..1ae31a887 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-weibull.rst @@ -0,0 +1,208 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_weibull: + +weibull +======= + +Class is used for generation of Weibull distributed real types random numbers. + +.. _onemath_rng_weibull_description: + +.. rubric:: Description + +The class object is used in the :ref:`oneapi::math::rng::generate()` function to provide random numbers Weibull distributed with displacement :math:`a`, scalefactor :math:`\beta`, and shape :math:`\alpha`, where :math:`a, \beta, \alpha \in R; \alpha > 0; \beta > 0`. + +The probability distribution is given by: + +.. math:: + + f_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} \frac{\alpha}{\beta^\alpha}(x - a)^{\alpha - 1}exp((-\frac{x - a}{\beta})^{\alpha}), x \ge a \\ 0, x < a \end{array}\right. + +The cumulative distribution function is as follows: + +.. math:: + + F_{a, \alpha, \beta}(x) = \left\{ \begin{array}{rcl} 1 - exp((-\frac{x - a}{\beta})^{\alpha}), x \ge a \\ 0, x < a \end{array}\right. + +.. _onemath_rng_weibull_syntax: + +class weibull +------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + template + class weibull { + public: + using method_type = Method; + using result_type = RealType; + weibull(); + explicit weibull(RealType alpha, RealType a, RealType b); + RealType alpha() const; + RealType a() const; + RealType beta() const; + }; + } + +.. container:: section + + .. rubric:: Template parameters + + .. container:: section + + typename RealType + Type of the produced values. Supported types: + * ``float`` + * ``double`` + + .. container:: section + + typename Method = oneapi::math::rng::weibull_method::by_default + Transformation method, which will be used for generation. Supported types: + + * ``oneapi::math::rng::weibull_method::by_default`` + * ``oneapi::math::rng::weibull_method::icdf`` + * ``oneapi::math::rng::weibull_method::icdf_accurate`` + + See description of the methods in :ref:`Distributions methods template parameter`. + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `weibull()`_ + - Default constructor + * - `explicit weibull(RealType alpha, RealType a, RealType beta)`_ + - Constructor with parameters + * - `RealType alpha() const`_ + - Method to obtain shape value + * - `RealType a() const`_ + - Method to obtain displacement value + * - `RealType beta() const`_ + - Method to obtain scalefactor value + +.. container:: section + + .. rubric:: Member types + + .. container:: section + + .. code-block:: cpp + + weibull::method_type = Method + + .. container:: section + + .. rubric:: Description + + The type which defines transformation method for generation. + + .. container:: section + + .. code-block:: cpp + + weibull::result_type = RealType + + .. container:: section + + .. rubric:: Description + + The type which defines type of generated random numbers. + +.. container:: section + + .. rubric:: Constructors + + .. container:: section + + .. _`weibull()`: + + .. code-block:: cpp + + weibull::weibull() + + .. container:: section + + .. rubric:: Description + + Default constructor for distribution, parameters set as `alpha` = 1.0, `a` = 0.0, and `b` = 1.0. + + .. container:: section + + .. _`explicit weibull(RealType alpha, RealType a, RealType beta)`: + + .. code-block:: cpp + + explicit weibull::weibull(RealType alpha, RealType a, RealType beta) + + .. container:: section + + .. rubric:: Description + + Constructor with parameters. `alpha` is a shape value, `a` is a displacement value, `beta` is a scalefactor value. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`alpha \leq` static_cast(0.0), or :math:`beta \leq` static_cast(0.0) + +.. container:: section + + .. rubric:: Characteristics + + .. container:: section + + .. _`RealType alpha() const`: + + .. code-block:: cpp + + RealType weibull::alpha() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `alpha` - shape value. + + .. container:: section + + .. _`RealType a() const`: + + .. code-block:: cpp + + RealType weibull::a() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `a` - displacement value. + + .. container:: section + + .. _`RealType beta() const`: + + .. code-block:: cpp + + RealType weibull::beta() const + + .. container:: section + + .. rubric:: Return Value + + Returns the distribution parameter `beta` - scalefactor value. + +**Parent topic:** :ref:`onemath_rng_distributions` diff --git a/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-wichmann_hill.rst b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-wichmann_hill.rst new file mode 100644 index 000000000..cc44cf4c4 --- /dev/null +++ b/source/elements/oneMath/source/domains/rng/host_api/onemath-rng-wichmann_hill.rst @@ -0,0 +1,251 @@ +.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation +.. +.. SPDX-License-Identifier: CC-BY-4.0 + +.. _onemath_rng_wichmann_hill: + +wichmann_hill +============= + +The wichmann_hill engine is the set of 273 Wichmann-Hill's combined multiplicative congruential generators from NAG Numerical Libraries :ref:`[NAG] `. + +.. _onemath_rng_wichmann_hill_description: + +.. rubric:: Description + +The set of 372 different basic pseudorandom number generators wichmann_hill is the second basic generator in the NAG libraries. + +.. container:: section + + .. rubric:: Generation algorithm + + :math:`x_n=a_{1, j} x_{n-1} (mod \ m_{1, j})` + + :math:`y_n = a_{2, j} y_{n-1} (mod \ m_{2, j})` + + :math:`z_n = a_{3, j} z_{n-1} (mod \ m_{3, j})` + + :math:`w_n = a_{4, j} w_{n-1} (mod \ m_{4, j})` + + :math:`u_n = (x_n / m_{1, j} + y_n / m_{2, j} + z_n / m_{3, j} + w_n / m_{4, j}) mod \ 1` + + The constants :math:`a_{i, j}` range from 112 to 127, the constants :math:`m_{i, j}` are prime numbers ranging from 16718909 to 16776917, close to :math:`2 ^ {24}`. + + +.. _onemath_rng_wichmann_hill_description_syntax: + +class wichmann_hill +------------------- + +.. rubric:: Syntax + +.. code-block:: cpp + + namespace oneapi::math::rng { + class wichmann_hill { + public: + static constexpr std::uint32_t default_seed = 1; + + wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed); + + wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx); + + wichmann_hill(sycl::queue queue, std::initializer_list seed); + + wichmann_hill(sycl::queue queue, std::initializer_list seed, std::uint32_t engine_idx); + + wichmann_hill(const wichmann_hill& other); + + wichmann_hill(wichmann_hill&& other); + + wichmann_hill& operator=(const wichmann_hill& other); + + wichmann_hill& operator=(wichmann_hill&& other); + + ~wichmann_hill(); + }; + } + +.. container:: section + + .. rubric:: Class Members + + .. list-table:: + :header-rows: 1 + + * - Routine + - Description + * - `wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed)`_ + - Constructor for common seed initialization of the engine (for this case multiple generators of the set would be used) + * - `wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`_ + - Constructor for common seed initialization of the engine (for this case single generator of the set would be used) + * - `wichmann_hill(sycl::queue& queue, std::initializer_list seed)`_ + - Constructor for extended seed initialization of the engine (for this case multiple generators of the set would be used) + * - `wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx)`_ + - Constructor for extended seed initialization of the engine (for this case single generator of the set would be used) + * - `wichmann_hill(const wichmann_hill& other)`_ + - Copy constructor + * - `wichmann_hill(wichmann_hill&& other)`_ + - Move constructor + * - `wichmann_hill& operator=(const wichmann_hill& other)`_ + - Copy assignment operator + * - `wichmann_hill& operator=(wichmann_hill&& other)`_ + - Move assignment operator + +.. container:: section + + .. rubric:: Constructors + + .. _`wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(sycl::queue queue, std::uint32_t seed = default_seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + .. _`wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(sycl::queue queue, std::uint32_t seed, std::uint32_t engine_idx) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state. Assume :math:`x_0=seed \ mod \ m_1, y_0 = z_0 = w_0 = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + engine_idx + The index of the set 1, ..., 273. + + .. container:: section + + .. rubric:: Throws + + oneapi::math::invalid_argument + Exception is thrown when :math:`idx > 273` + + .. _`wichmann_hill(sycl::queue& queue, std::initializer_list seed)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(sycl::queue& queue, std::initializer_list seed) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume: + if :math:`n = 0: x_{0} = y_{0} = z_{0} = w_{0} = 1` + + if :math:`n = 1: x_{0} = seed[0] \ mod \ m_1, y_{0} = z_{0} = w_{0} = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + if :math:`n = 2: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = w_{0} = 1`. + + if :math:`n = 3: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = seed[2] \ mod \ m_3, w_{0} = 1`. + + if :math:`n \geqslant 4: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2` + + :math:`z_{0} = seed[2] \ mod \ m_3, w_{0} = seed[3] \ mod \ m_4`. + + + .. _`wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(sycl::queue& queue, std::initializer_list seed, std::uint32_t engine_idx) + + .. container:: section + + .. rubric:: Input Parameters + + queue + Valid ``sycl::queue`` object, calls of the :ref:`oneapi::math::rng::generate()` routine submits kernels in this queue to obtain random numbers from a given engine. + + seed + The initial conditions of the generator state, assume: + if :math:`n = 0: x_{0} = y_{0} = z_{0} = w_{0} = 1` + + if :math:`n = 1: x_{0} = seed[0] \ mod \ m_1, y_{0} = z_{0} = w_{0} = 1`. If :math:`x_0 = 0`, assume :math:`x_0 = 1`. + + if :math:`n = 2: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = w_{0} = 1`. + + if :math:`n = 3: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2, z_{0} = seed[2] \ mod \ m_3, w_{0} = 1`. + + if :math:`n \geqslant 4: x_{0} = seed[0] \ mod \ m_1, y_{0} = seed[1] \ mod \ m_2` + + :math:`z_{0} = seed[2] \ mod \ m_3, w_{0} = seed[3] \ mod \ m_4`. + + engine_idx + The index of the set 1, ..., 273. + + .. _`wichmann_hill(const wichmann_hill& other)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(const wichmann_hill& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`wichmann_hill(wichmann_hill&& other)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill(wichmann_hill&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is moved to the current engine. + + .. _`wichmann_hill& operator=(const wichmann_hill& other)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill& operator=(const wichmann_hill& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``wichmann_hill`` object. The ``queue`` and state of the other engine is copied and applied to the current engine. + + .. _`wichmann_hill& operator=(wichmann_hill&& other)`: + + .. code-block:: cpp + + wichmann_hill::wichmann_hill& operator=(wichmann_hill&& other) + + .. container:: section + + .. rubric:: Input Parameters + + other + Valid ``wichmann_hill`` r-value object. The ``queue`` and state of the other engine is moved to the current engine. + +**Parent topic:** :ref:`onemath_rng_engines_basic_random_number_generators` diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst index c9575adf4..3414fbbda 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_raw_moment.rst @@ -28,7 +28,7 @@ The oneapi::math::stats::raw_moment function is used to compute array of raw mom .. _onemath_stats_raw_moment_buffer: oneapi::math::stats::raw_moment (buffer version) ------------------------------------------------ +------------------------------------------------ .. rubric:: Syntax diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst index a8b1d7057..487f2af9e 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_usage_model.rst @@ -5,7 +5,7 @@ .. _onemath_stats_usage_model: oneMath Summary Statistics Usage Model -===================================== +====================================== .. rubric:: Description diff --git a/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst index 21271231f..eb424e0a6 100755 --- a/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst +++ b/source/elements/oneMath/source/domains/stats/onemath_stats_variation_user_mean.rst @@ -28,7 +28,7 @@ The oneapi::math::stats::variation function is used to compute an array of varia .. _onemath_stats_variation_user_mean_buffer: oneapi::math::stats::variation (buffer version) ----------------------------------------------- +----------------------------------------------- .. rubric:: Syntax diff --git a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst index a7650d8db..70deb1017 100644 --- a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst @@ -16,7 +16,7 @@ Exceptions +----------------------------------+------------------------------------+ | exception | when thrown | +----------------------------------+------------------------------------+ - | oneapi::math::invalid_argument | buffer API: | + | oneapi::math::invalid_argument | buffer API: | | | n < 0; | | | | | | y.get_count() < n; | @@ -29,13 +29,13 @@ Exceptions | | | | | any pointer argument is nullptr | +----------------------------------+------------------------------------+ - | oneapi::math::host_bad_alloc | USM API: | + | oneapi::math::host_bad_alloc | USM API: | | | when internal copying to and | | | from host memory is used | | | and corresponding allocation | | | fails | +----------------------------------+------------------------------------+ - | oneapi::math::device_bad_alloc | USM API: | + | oneapi::math::device_bad_alloc | USM API: | | | when internal copying to and | | | from device memory is used | | | and corresponding allocation | diff --git a/source/elements/oneMath/source/index.rst b/source/elements/oneMath/source/index.rst index 471720b0a..62517ce14 100644 --- a/source/elements/oneMath/source/index.rst +++ b/source/elements/oneMath/source/index.rst @@ -4,9 +4,9 @@ .. _oneMath-section: -====== +======= oneMath -====== +======= The |onemath_full_name| (oneMath) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMath is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math. From c3fee8ee09906c0b9c47ac525cd9c09bc337fa04 Mon Sep 17 00:00:00 2001 From: nscipione Date: Wed, 16 Oct 2024 12:31:20 +0200 Subject: [PATCH 05/16] Update onemkl to onemath after rebasing Signed-off-by: nscipione --- .../source/domains/dft/compute_backward.rst | 18 +-- .../source/domains/dft/compute_forward.rst | 18 +-- .../dft/config_params/data_layouts.rst | 24 ++-- .../dft/config_params/storage_formats.rst | 6 +- .../dft/config_params/workspace_placement.rst | 10 +- .../oneMath/source/domains/dft/descriptor.rst | 118 +++++++++--------- .../oneMath/source/domains/dft/dft.rst | 48 +++---- .../domains/dft/enums_and_config_params.rst | 62 ++++----- 8 files changed, 152 insertions(+), 152 deletions(-) diff --git a/source/elements/oneMath/source/domains/dft/compute_backward.rst b/source/elements/oneMath/source/domains/dft/compute_backward.rst index d5e7ae678..b84be0535 100644 --- a/source/elements/oneMath/source/domains/dft/compute_backward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_backward.rst @@ -7,11 +7,11 @@ The ``compute_backward`` function templates =========================================== -The ``oneapi::mkl::dft::compute_backward`` function templates enable the +The ``oneapi::math::dft::compute_backward`` function templates enable the computation of backward DFT(s), as defined by a (committed) -``oneapi::mkl::dft::descriptor`` object, on user-provided data. These function -templates are declared in the ``oneapi::mkl::dft`` namespace; the usage of -prepended namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. +``oneapi::math::dft::descriptor`` object, on user-provided data. These function +templates are declared in the ``oneapi::math::dft`` namespace; the usage of +prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. .. _onemath_dft_compute_backward_description: @@ -34,7 +34,7 @@ progress of the enqueued DFT calculations. The ``compute_backward`` functions may need to access the internals and private/protected members of (some) ``descriptor`` classes. This could be done, for instance, by labeling them as friend functions to the - ``descriptor`` :ref:`class template`. + ``descriptor`` :ref:`class template`. .. onemath_dft_compute_backward_buffer: @@ -198,11 +198,11 @@ progress of the enqueued DFT calculations. .. rubric:: Throws The ``compute_backward`` functions shall throw the following - :ref:`exception` if the associated condition is + :ref:`exception` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If ``desc`` is invalid. For instance, if its configuration value associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. @@ -374,11 +374,11 @@ progress of the enqueued DFT calculations. .. rubric:: Throws The ``compute_backward`` functions shall throw the following - :ref:`exception` if the associated condition is + :ref:`exception` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If ``desc`` is invalid. For instance, if its configuration value associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. It will also be thrown if any required diff --git a/source/elements/oneMath/source/domains/dft/compute_forward.rst b/source/elements/oneMath/source/domains/dft/compute_forward.rst index bdae5bdb3..6923b5e57 100644 --- a/source/elements/oneMath/source/domains/dft/compute_forward.rst +++ b/source/elements/oneMath/source/domains/dft/compute_forward.rst @@ -7,11 +7,11 @@ The ``compute_forward`` function templates ========================================== -The ``oneapi::mkl::dft::compute_forward`` function templates enable the +The ``oneapi::math::dft::compute_forward`` function templates enable the computation of forward DFT(s), as defined by a (committed) -``oneapi::mkl::dft::descriptor`` object, on user-provided data. These function -templates are declared in the ``oneapi::mkl::dft`` namespace; the usage of -prepended namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. +``oneapi::math::dft::descriptor`` object, on user-provided data. These function +templates are declared in the ``oneapi::math::dft`` namespace; the usage of +prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. .. _onemath_dft_compute_forward_description: @@ -34,7 +34,7 @@ progress of the enqueued DFT calculations. The ``compute_forward`` functions may need to access the internals and private/protected members of (some) ``descriptor`` classes. This could be done, for instance, by labeling them as friend functions to the - ``descriptor`` :ref:`class template`. + ``descriptor`` :ref:`class template`. .. onemath_dft_compute_forward_buffer: @@ -199,11 +199,11 @@ progress of the enqueued DFT calculations. .. rubric:: Throws The ``compute_forward`` functions shall throw the following - :ref:`exception` if the associated condition is + :ref:`exception` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If ``desc`` is invalid. For instance, if its configuration value associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. @@ -375,11 +375,11 @@ progress of the enqueued DFT calculations. .. rubric:: Throws The ``compute_forward`` functions shall throw the following - :ref:`exception` if the associated condition is + :ref:`exception` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If ``desc`` is invalid. For instance, if its configuration value associated with configuration parameter ``config_param::COMMIT_STATUS`` is not ``config_param::COMMITTED``. It will also be thrown if any required diff --git a/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst b/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst index 796366ae0..01b5ca865 100644 --- a/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/data_layouts.rst @@ -7,7 +7,7 @@ Configuration of data layouts ----------------------------- -The usage of prepended namespace specifiers ``oneapi::mkl::dft`` is +The usage of prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. The DFT interface provides the configuration parameters @@ -24,7 +24,7 @@ Using the notations from the :ref:`introduction` and th superscript :math:`\text{fwd}` (resp. :math:`\text{bwd}`) for data sequences belonging to forward (resp. backward) domain, for any :math:`m` and multi-index :math:`\left(k_1, k_2, \ldots, k_d\right)` within :ref:`valid -range`, the corresponding entry +range`, the corresponding entry :math:`\left(\cdot\right)^{m}_{k_{1}, k_{2}, \dots, k_d }` – or the real or imaginary part thereof – of the relevant data sequence is located at index @@ -69,7 +69,7 @@ re-interpret the base data type of that data container into an implicitly-assumed elementary data type. That implicitly-assumed data type depends on the object type, *i.e.*, on the specialization values used for the template parameters when instantiating the -``descriptor`` :ref:`class template`, and, in case of +``descriptor`` :ref:`class template`, and, in case of complex descriptors, on the configuration value set for its configuration parameter ``config_param::COMPLEX_STORAGE``. The table below lists the implicitly-assumed data type in either domain (last 2 columns) based on the object type and @@ -225,10 +225,10 @@ relevant data sequence entries are accessed as elements of data containers (``sycl::buffer`` objects or device-accessible USM allocations) provided to the compute function, the base data type of which is (possibly implicitly re-interpreted) as documented in the above -:ref:`table`. If +:ref:`table`. If using input and output strides, for any :math:`m` and multi-index :math:`\left(k_1, k_2, \ldots, k_d\right)` within :ref:`valid -range`, the index to be used when +range`, the index to be used when accessing a data sequence entry – or part thereof – in forward domain is .. math:: @@ -248,21 +248,21 @@ As a consequence, configuring ``descriptor`` objects using these deprecated configuration parameters makes their configuration direction-dependent when different stride values are used in forward and backward domains. Since the intended compute direction is unknown to the object when -:ref:`committing` it, every direction that results -in a :ref:`consistent data layout` in +:ref:`committing` it, every direction that results +in a :ref:`consistent data layout` in forward and backward domains must be supported by successfully-committed ``descriptor`` objects. .. note:: For ``descriptor`` objects with strides configured via these deprecated configuration parameters, the - :ref:`consistency requirements` may be + :ref:`consistency requirements` may be satisfied for only one of the two compute directions, *i.e.*, for only one of the forward or backward DFT(s). Such a configuration should not cause an exception to be thrown by the descriptor's ``commit`` - :ref:`member function` but the behavior of - oneMKL is undefined if using that object for the compute direction that does - not align with the :ref:`consistency requirements`. + :ref:`member function` but the behavior of + oneMath is undefined if using that object for the compute direction that does + not align with the :ref:`consistency requirements`. .. note:: Setting either of ``config_param::INPUT_STRIDES`` or @@ -285,7 +285,7 @@ the reverse direction as shown below. .. code-block:: cpp - namespace dft = oneapi::mkl::dft; + namespace dft = oneapi::math::dft; // ... desc.set_value(dft::config_param::INPUT_STRIDES, fwd_domain_strides); desc.set_value(dft::config_param::OUTPUT_STRIDES, bwd_domain_strides); diff --git a/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst index 897dd2e52..17d2fc657 100644 --- a/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/storage_formats.rst @@ -7,7 +7,7 @@ Data storage ============ -The usage of prepended namespace specifiers ``oneapi::mkl::dft`` is +The usage of prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. The data storage convention observed by a ``descriptor`` object depends on @@ -47,7 +47,7 @@ allocation or ``sycl::buffer`` object). Any relevant entry :math:`\left(\cdot\right)^{m}_{k_1, k_2,\dots ,k_d}` is accessed/stored from/in a data container provided at compute time at the index value expressed in eq. :eq:`eq_idx_data_layout` (see the page dedicated to the -:ref:`configuration of data layout`) +:ref:`configuration of data layout`) of that data container, whose elementary data type is (possibly implicitly re-interpreted as) ``std::complex`` (resp. ``std::complex``) for single-precision (resp. double-precision) descriptors. @@ -100,7 +100,7 @@ the real and imaginary parts of the relevant entries separately. The real and imaginary parts of any relevant complex entry :math:`\left(\cdot\right)^{m}_{k_1, k_2,\dots ,k_d}` are both stored at the index value expressed in eq. :eq:`eq_idx_data_layout` (see the page dedicated to -the :ref:`configuration of data layout`) of +the :ref:`configuration of data layout`) of their respective data containers, whose elementary data type is (possibly implicitly re-interpreted as) ``float`` (resp. ``double``) for single-precision (resp. double-precision) descriptors. diff --git a/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst b/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst index 517779cb8..55ffcf94f 100644 --- a/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst +++ b/source/elements/oneMath/source/domains/dft/config_params/workspace_placement.rst @@ -7,7 +7,7 @@ Workspace placement ------------------- -The usage of prepended namespace specifiers ``oneapi::mkl::dft`` is +The usage of prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. DFT implementations often require temporary storage for intermediate data whilst computing DFTs. @@ -25,7 +25,7 @@ For some backends and configurations, externally-managed workspaces may reduce performance. A typical workflow for using externally-managed workspaces is given -:ref:`below`. +:ref:`below`. Automatically- and externally-managed workspaces ++++++++++++++++++++++++++++++++++++++++++++++++ @@ -55,8 +55,8 @@ When a descriptor is committed with ``config_value::WORKSPACE_EXTERNAL`` set for ``config_param::WORKSPACE_PLACEMENT``, the user must provide an external workspace before calling any compute function. More details can be found in the section dedicated to the ``set_workspace`` -:ref:`member function` and in the typical -usage illustrated :ref:`below`. +:ref:`member function` and in the typical +usage illustrated :ref:`below`. .. _onemath_dft_typical_usage_of_workspace_external: @@ -77,7 +77,7 @@ This is shown in the following example code: .. code-block:: cpp - namespace dft = oneapi::mkl::dft; + namespace dft = oneapi::math::dft; // Create a descriptor dft::descriptor desc(n); // 1. Set the workspace placement to WORKSPACE_EXTERNAL diff --git a/source/elements/oneMath/source/domains/dft/descriptor.rst b/source/elements/oneMath/source/domains/dft/descriptor.rst index 1eff4318a..0bff502f9 100644 --- a/source/elements/oneMath/source/domains/dft/descriptor.rst +++ b/source/elements/oneMath/source/domains/dft/descriptor.rst @@ -7,16 +7,16 @@ The ``descriptor`` class template ================================= -Instances of any ``oneapi::mkl::dft::descriptor`` class define DFT(s) to be -computed. The usage of prepended namespace specifiers ``oneapi::mkl::dft`` is +Instances of any ``oneapi::math::dft::descriptor`` class define DFT(s) to be +computed. The usage of prepended namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. Description +++++++++++ Any desired DFT is fully defined by an instance of a specialization of the -``descriptor`` class template, declared in the ``oneapi::mkl::dft`` namespace. -The :ref:`scoped enumeration types` ``precision``, ``domain``, +``descriptor`` class template, declared in the ``oneapi::math::dft`` namespace. +The :ref:`scoped enumeration types` ``precision``, ``domain``, ``config_param`` and ``config_value`` defined in the same namespace (and the corresponding ranges of values) are relevant to the definition and configurations of such objects. Users can set several (resp. query all) @@ -29,7 +29,7 @@ device encapsulated by the ``sycl::queue`` object required by that function. The desired forward (resp. backward) DFT calculations may then be computed by passing such a committed ``descriptor`` object to a ``compute_forward`` (resp. -``compute_backward``) function (defined in the ``oneapi::mkl::dft`` namespace as +``compute_backward``) function (defined in the ``oneapi::math::dft`` namespace as well), along with the relevant data containers (``sycl::buffer`` object(s) or pointer(s) to a device-accessible USM allocations) for the desired DFT(s). This function makes the ``descriptor`` object enqueue the operations relevant for the @@ -136,29 +136,29 @@ desired calculations to the ``sycl::queue`` object it was given when committing * - Routines - Description - * - :ref:`constructors` + * - :ref:`constructors` - Create a ``descriptor`` object. The parameterized constructors enable the (one-time) definition of the length(s) :math:`\lbrace n_1, \ldots, n_d\rbrace` (the dimension :math:`d` is deduced accordingly). The parameterized constructors default-initialize the object; copy and move constructors do not. - * - :ref:`assignment operators` + * - :ref:`assignment operators` - Perform a deep copy of or moves the argument. - * - ``set_value`` :ref:`member functions` + * - ``set_value`` :ref:`member functions` - Set a configuration value for a specific configuration parameter. - * - ``get_value`` :ref:`member functions` + * - ``get_value`` :ref:`member functions` - Query the configuration value associated with a particular configuration parameter. - * - ``set_workspace`` :ref:`member function` + * - ``set_workspace`` :ref:`member function` - Equips the ``descriptor`` object with an external workspace. - * - ``commit`` :ref:`member function` + * - ``commit`` :ref:`member function` - Commits the ``descriptor`` object to enqueue the operations relevant to the DFT(s) it determines to a given, user-provided ``sycl::queue`` object; completes all initialization work relevant to and required by the chosen, device-compliant implementation for the particular DFT, as defined by the ``descriptor`` object. -.. _onemkl_dft_descriptor_constructors: +.. _onemath_dft_descriptor_constructors: Constructors ++++++++++++ @@ -168,7 +168,7 @@ all the relevant default configuration settings (which may depend on the specialization values for ``prec`` and ``dom``). The constructors do not perform any significant initialization work as changes in the object's configuration(s) may be operated thereafter (via its ``set_value`` -:ref:`member functions`) and modify +:ref:`member functions`) and modify significantly the nature of that work. The copy constructor performs a deep copy of ``descriptor`` objects. @@ -244,15 +244,15 @@ without copying them. .. rubric:: Throws The constructors shall throw the following - :ref:`exceptions` if the associated condition is + :ref:`exceptions` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::host_bad_alloc()`` + ``oneapi::math::host_bad_alloc()`` If any memory allocations on host have failed, for instance due to insufficient memory. - ``oneapi::mkl::unimplemented()`` + ``oneapi::math::unimplemented()`` If the dimension :math:`d`, *i.e.*, the size of ``lengths``, is larger than what is supported by the library implementation. @@ -260,7 +260,7 @@ without copying them. **Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` -.. _onemkl_dft_descriptor_assignment_operators: +.. _onemath_dft_descriptor_assignment_operators: Assignment operators ++++++++++++++++++++ @@ -302,11 +302,11 @@ The copy assignment operator results in a deep copy. .. rubric:: Throws The assignment operators shall throw the following - :ref:`exception` if the associated condition is + :ref:`exception` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::host_bad_alloc()`` + ``oneapi::math::host_bad_alloc()`` If any memory allocations on host have failed, for instance due to insufficient memory. @@ -322,14 +322,14 @@ configuration value corresponding to a (read-write) configuration parameter for the DFT(s) that it defines. These functions are to be used as many times as required for all the necessary configuration parameters to be set prior to committing the object (by calling its ``commit`` -:ref:`member function`). +:ref:`member function`). All these functions require and expect exactly **two** arguments: they set the given configuration value (second argument) for a desired configuration parameter (first argument), represented by ``param`` of type ``config_param``. The expected type of the associated configuration value (second argument) depends on ``param`` and is specified in the -:ref:`section` dedicated to the ``config_param`` +:ref:`section` dedicated to the ``config_param`` type and its enumerators (unless a deprecated version is used). The expected type of configuration value determines which of the ``set_value`` overloads is to be used for a specific value of ``param``. @@ -354,7 +354,7 @@ This version of ``set_value`` supports the following values of ``param``: .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, real_scalar_t value); @@ -370,7 +370,7 @@ This version of ``set_value`` supports the following values of ``param``: .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, const std::vector& value); @@ -385,13 +385,13 @@ This version of ``set_value`` supports the following values of ``param``: ``value`` must be a vector of :math:`\left(d+1\right)` ``std::int64_t`` elements. More information about setting strides may be found in the page dedicated to -the :ref:`configuration of data layouts`. +the :ref:`configuration of data layouts`. .. rubric:: Syntax for parameters associated with non-numeric values .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, config_value value); @@ -407,7 +407,7 @@ This version of ``set_value`` supports the following values of ``param``: .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, const std::int64_t* value); @@ -432,7 +432,7 @@ recommended by the compile-time deprecation warning. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::set_value(config_param param, ...); @@ -442,7 +442,7 @@ recommended by the compile-time deprecation warning. This version supports all values of ``param`` corresponding to a writable configuration parameter. The variadic argument list must contain a unique element. When reading the latter (after default argument promotions of variadic -arguments, if applicable), oneMKL *assumes* that it is +arguments, if applicable), oneMath *assumes* that it is - an ``std::int64_t`` value if ``param`` is any of ``config_param::NUMBER_OF_TRANSFORMS``, ``config_param::FWD_DISTANCE``, or ``config_param::BWD_DISTANCE``; - a ``double`` value if ``param`` is any of ``FORWARD_SCALE``, ``BACKWARD_SCALE``; @@ -467,27 +467,27 @@ to inform about the recommended alternative. ``...`` The value to be set for the targeted configuration parameter, passed as a variadic argument list of **one** element. This usage is deprecated. - Note the type assumed by oneMKL when reading that value (specified above). + Note the type assumed by oneMath when reading that value (specified above). .. container:: section .. rubric:: Throws The ``set_value`` member functions shall throw the following - :ref:`exceptions` if the associated condition is + :ref:`exceptions` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` - If the provided ``param`` corresponds to a read-only configuration parameter; - If the overloaded version being used does not support ``param``; - If the provided ``param`` and/or configuration value are/is not valid. - ``oneapi::mkl::unimplemented()`` + ``oneapi::math::unimplemented()`` If the provided ``param`` and configuration value are valid, but not supported by the library implementation. -**Descriptor class member table:** :ref:`onemkl_dft_descriptor_member_table` +**Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` .. _onemath_dft_descriptor_get_value: @@ -504,7 +504,7 @@ configuration value (into the element pointed by the second argument) corresponding to the queried configuration parameter (first argument) ``param`` of type ``config_param``. The second argument is a valid *pointer* to a configuration value whose type corresponds to ``param``, as specified in the -:ref:`section` dedicated to the ``config_param`` +:ref:`section` dedicated to the ``config_param`` type and its enumerators (unless a deprecated version is used). The expected type of configuration value determines which of the ``get_value`` overloads is to be used for a specific value of ``param``. @@ -532,7 +532,7 @@ This version of ``get_value`` supports only ``config_param::FORWARD_DOMAIN`` for .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, precision* value_ptr) const; @@ -545,7 +545,7 @@ This version of ``get_value`` supports only ``config_param::PRECISION`` for .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, std::int64_t* value_ptr) const; @@ -558,11 +558,11 @@ This version of ``get_value`` supports the following values of ``param``: - ``config_param::BWD_DISTANCE``; - ``config_param::DIMENSION``; - ``config_param::WORKSPACE_EXTERNAL_BYTES`` (requires the calling object to be committed); -- ``config_param::LENGTHS`` (deprecated usage if :math:`d > 1`, :math:`d` contiguous ``std::int64_t`` written by oneMKL) -- ``config_param::INPUT_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMKL); -- ``config_param::OUTPUT_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMKL); -- ``config_param::FWD_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMKL); -- ``config_param::BWD_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMKL); +- ``config_param::LENGTHS`` (deprecated usage if :math:`d > 1`, :math:`d` contiguous ``std::int64_t`` written by oneMath) +- ``config_param::INPUT_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMath); +- ``config_param::OUTPUT_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMath); +- ``config_param::FWD_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMath); +- ``config_param::BWD_STRIDES`` (deprecated usage, :math:`\left(d+1\right)` contiguous ``std::int64_t`` written by oneMath); Using this version for querying configuration values encapsulating more than one ``std::int64_t`` values is deprecated. A runtime deprecation warning may be @@ -572,7 +572,7 @@ emitted to inform about the recommended alternative in such cases. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, real_scalar_t* value_ptr) const; @@ -590,7 +590,7 @@ single-precision (resp. double-precision) descriptors. .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, std::vector* value_ptr) const; @@ -613,7 +613,7 @@ This version of ``get_value`` supports the following values of ``param``: .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, config_value* value_ptr) const; @@ -630,7 +630,7 @@ This version of ``get_value`` supports the following values of ``param``: .. code-block:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { template void descriptor::get_value(config_param param, ...) const; @@ -639,7 +639,7 @@ This version of ``get_value`` supports the following values of ``param``: This version supports all values of ``param``. The variadic argument list must contain a unique element. When reading the latter (after default argument -promotions of variadic arguments, if applicable), oneMKL assumes that it is of +promotions of variadic arguments, if applicable), oneMath assumes that it is of type - ``domain*`` if ``param`` is ``config_param::FORWARD_DOMAIN``; @@ -667,13 +667,13 @@ to inform about the recommended alternative. ``value_ptr`` A valid *pointer* to a configuration value (or configuration values) in - which oneMKL is allowed to write (return) the queried value(s). The type + which oneMath is allowed to write (return) the queried value(s). The type of this input argument depends on ``param`` as specified above. ``...`` A valid *pointer* to a configuration value (or configuration values), passed as a variadic argument list of **one** element. This usage is - deprecated. Note the type assumed by oneMKL when accessing that pointer + deprecated. Note the type assumed by oneMath when accessing that pointer (specified above) .. container:: section @@ -681,20 +681,20 @@ to inform about the recommended alternative. .. rubric:: Throws The ``get_value`` member functions shall throw the following - :ref:`exceptions` if the associated condition is + :ref:`exceptions` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` - If the overloaded version being used does not support ``param``; - If ``value_ptr`` is ``nullptr``; - If ``value_ptr->size()`` is not as expected when querying a vector-valued parameter. - ``oneapi::mkl::uninitialized`` + ``oneapi::math::uninitialized`` If ``param`` is ``config_param::WORKSPACE_EXTERNAL_BYTES`` and the calling object is not committed. - ``oneapi::mkl::unimplemented()`` + ``oneapi::math::unimplemented()`` If the queried ``param`` is valid, but not supported by the library implementation. @@ -774,18 +774,18 @@ be used in compute calls. However, the aforementioned restrictions will still ap .. rubric:: Throws The ``set_workspace`` member function shall throw the following - :ref:`exceptions` if the associated condition is + :ref:`exceptions` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here: - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If the provided buffer ``workspaceBuf`` is not sufficiently large or is a sub-buffer, or if the provided USM allocation ``workspaceUSM`` is ``nullptr`` when an external workspace of size greater than zero is required, or if the provided USM allocation ``workspaceUSM`` is not accessible by the device. - ``oneapi::mkl::uninitialized()`` + ``oneapi::math::uninitialized()`` If ``set_workspace`` is called before the descriptor is committed. @@ -835,20 +835,20 @@ called again. .. rubric:: Throws The ``commit`` member function shall throw the following - :ref:`exceptions` if the associated condition is + :ref:`exceptions` if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here (if the ``descriptor`` object's configuration was found to be inconsistent, for instance): - ``oneapi::mkl::invalid_argument()`` + ``oneapi::math::invalid_argument()`` If ``queue`` is found to be invalid in any way. - ``oneapi::mkl::host_bad_alloc()`` + ``oneapi::math::host_bad_alloc()`` If any host side only memory allocations fail, for instance due to lack of memory. - ``oneapi::mkl::device_bad_alloc()`` + ``oneapi::math::device_bad_alloc()`` If any device or shared memory allocation fail. **Descriptor class member table:** :ref:`onemath_dft_descriptor_member_table` diff --git a/source/elements/oneMath/source/domains/dft/dft.rst b/source/elements/oneMath/source/domains/dft/dft.rst index 92a3358a3..31a859142 100644 --- a/source/elements/oneMath/source/domains/dft/dft.rst +++ b/source/elements/oneMath/source/domains/dft/dft.rst @@ -45,7 +45,7 @@ backward) DFT is referred to as "forward domain". Conversely, the domain of output (resp. input) discrete sequences for forward (resp. backward) DFT is referred to as "backward domain". -oneMKL supports single-precision (fp32) and double-precision (fp64) +oneMath supports single-precision (fp32) and double-precision (fp64) floating-point arithmetic for the calculation of DFTs, using two kinds of forward domains: @@ -62,7 +62,7 @@ The calculation of the same DFT for several, *i.e.*, :math:`M > 1`, data sets of the same kind of forward domain, using the same precision is referred to as a "batched DFT". -.. _onemkl_dft_elementary_range_of_indices: +.. _onemath_dft_elementary_range_of_indices: Elementary range of indices +++++++++++++++++++++++++++ @@ -82,12 +82,12 @@ and :math:`\lambda^{*}` represents the conjugate of complex number redundant in backward domain: in case of real DFTs, the data sequences in backward domain can be fully determined even if one of the :math:`d` indices :math:`k_{\ell}` is limited to the range -:math:`0\leq k_{\ell} \leq \lfloor \frac{n_{\ell}}{2}\rfloor`. In oneMKL, the +:math:`0\leq k_{\ell} \leq \lfloor \frac{n_{\ell}}{2}\rfloor`. In oneMath, the index :math:`k_d`, *i.e.*, the last dimension's index, is restricted as such to capture an elementary set of non-redundant entries for data sequences belonging to the backward domain of real DFTs. -In other words, oneMKL expects and produces a set of :math:`M` +In other words, oneMath expects and produces a set of :math:`M` :math:`d`-dimensional data sequences :math:`\left(\cdot \right)^{m}_{k_1, k_2,\ldots, k_d}` with integer indices :math:`m` and @@ -132,31 +132,31 @@ Recommended usage +++++++++++++++++ The desired DFT to be computed is entirely defined by an object ``desc`` of a -specialization of the ``oneapi::mkl::dft::descriptor`` -:ref:`class template`. +specialization of the ``oneapi::math::dft::descriptor`` +:ref:`class template`. The desired floating-point format and kind of forward domain are determined by ``desc``'s particular class, *i.e.*, by the specialization values of the -:ref:`template parameters` ``prec`` +:ref:`template parameters` ``prec`` and ``dom`` of the ``descriptor`` class template, respectively. Once ``desc`` is created, the length(s) :math:`\lbrace n_1, n_2, \ldots, n_d\rbrace` (and the dimension :math:`d`) cannot be changed, as they are read-only parameters. Other configuration details for the DFT under consideration may be specified by invoking the appropriate -:ref:`configuration-setting member function(s)` +:ref:`configuration-setting member function(s)` of ``desc`` for every relevant configuration parameter (*e.g.*, the number :math:`M` of sequences to consider in case of a batched DFT). Once configured as desired, ``desc`` must be initialized for computation by using its -:ref:`committing member function`, which requires +:ref:`committing member function`, which requires a ``sycl::queue`` object. The successful completion of that operation makes ``desc`` ready to compute the desired DFT *as configured*, for the particular device and context encapsulated by the latter. ``desc`` may then be used with user-provided, device-accessible data, in a -``oneapi::mkl::dft::compute_forward`` (resp. -``oneapi::mkl::dft::compute_backward``) function to enqueue operations relevant +``oneapi::math::dft::compute_forward`` (resp. +``oneapi::math::dft::compute_backward``) function to enqueue operations relevant to the desired forward (resp. backward) DFT calculations. .. note:: - Objects of any ``oneapi::mkl::dft::descriptor`` class + Objects of any ``oneapi::math::dft::descriptor`` class - must be successfully committed prior to providing them to any compute function; @@ -164,14 +164,14 @@ to the desired forward (resp. backward) DFT calculations. after they were already successfully committed; - deliver best performance for DFT calculations when created, configured and committed outside applications' hotpath(s) that use them multiple times for - identically-configured DFTs. ``oneapi::mkl::dft::compute_forward`` and/or - ``oneapi::mkl::dft::compute_backward`` should be the only oneMKL DFT-related + identically-configured DFTs. ``oneapi::math::dft::compute_forward`` and/or + ``oneapi::math::dft::compute_backward`` should be the only oneMath DFT-related routines invoked in programs' hotpaths. Summary table ~~~~~~~~~~~~~ -The table below summarizes the identifiers of the ``oneapi::mkl::dft`` namespace +The table below summarizes the identifiers of the ``oneapi::math::dft`` namespace relevant to computing DFTs. .. _onemath_dft_summary_table: @@ -186,47 +186,47 @@ relevant to computing DFTs. :header-rows: 1 :widths: 33 64 - * - Identifier in ``oneapi::mkl::dft`` + * - Identifier in ``oneapi::math::dft`` - Description * - ``descriptor`` - A template for classes whose instances define a specific DFT to be calculated and its configuration. Template parameters are omitted in this table for conciseness (more details are available in the page dedicated to - :ref:`the descriptor class template`). + :ref:`the descriptor class template`). * - ``domain``, ``precision``, ``config_param`` and ``config_value`` - - :ref:`Scoped enumerations` pertaining to the + - :ref:`Scoped enumerations` pertaining to the definition of any configuration parameter or its associated value, for any instance of a ``descriptor`` class. * - ``descriptor::set_value`` - Member functions to - :ref:`set (writable) configuration parameters` + :ref:`set (writable) configuration parameters` for any instance of a ``descriptor`` class. * - ``descriptor::get_value`` - Member functions to - :ref:`query configuration parameters` + :ref:`query configuration parameters` from any instance of a ``descriptor`` class. * - ``descriptor::commit`` - A member function to - :ref:`commit` any instance + :ref:`commit` any instance of a ``descriptor`` class to the DFT calculations it defines, on a given queue. * - ``descriptor::set_workspace`` - A member function to equip any instance of a ``descriptor`` class with an - :ref:`externally-allocated workspace`. + :ref:`externally-allocated workspace`. * - ``compute_forward`` - Function templates for computing a forward DFT, as defined by a (successfully-committed) instance of a ``descriptor`` class (required argument). Template parameters are omitted in this table for conciseness (more details are available in the - :ref:`dedicated page`). + :ref:`dedicated page`). * - ``compute_backward`` - Function templates for computing a backward DFT, as defined by a (successfully-committed) instance of a ``descriptor`` class (required argument). Template parameters are omitted in this table for conciseness (more details are available in the - :ref:`dedicated page`). + :ref:`dedicated page`). **Parent topic:** :ref:`onemath_domains` diff --git a/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst b/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst index f88828221..7554aa27b 100644 --- a/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst +++ b/source/elements/oneMath/source/domains/dft/enums_and_config_params.rst @@ -7,10 +7,10 @@ DFT-related scoped enumeration types ------------------------------------ -The following scoped enumeration types, defined in the ``oneapi::mkl::dft`` +The following scoped enumeration types, defined in the ``oneapi::math::dft`` namespace, are used for constructing and configuring ``descriptor`` objects consistently with the DFT(s) they are meant to define. The usage of prepended -namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. +namespace specifiers ``oneapi::math::dft`` is omitted below for conciseness. .. list-table:: :header-rows: 1 @@ -22,16 +22,16 @@ namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. - Type for the floating-point format to be used in the desired DFT calculations (for arithmetic operations and data representation). A template parameter ``prec`` of this type is used for the - ``descriptor`` :ref:`class template`. + ``descriptor`` :ref:`class template`. * - ``domain`` - Type for the kind of forward domain for the desired DFT calculations. A template parameter ``dom`` of this type is used for the - ``descriptor`` :ref:`class template`. + ``descriptor`` :ref:`class template`. * - ``config_param`` - Type for configuration parameters of ``descriptor`` objects. * - ``config_value`` - Type for non-numeric configuration values corresponding to some of - the :ref:`configuration parameters`. + the :ref:`configuration parameters`. .. _onemath_dft_enum_precision: @@ -40,7 +40,7 @@ namespace specifiers ``oneapi::mkl::dft`` is omitted below for conciseness. Values in this scoped enumeration type represent the floating-point format to be used for the desired DFT(s). The same format is to be used for the user-provided -data, the computation being carried out by oneMKL and the delivered results. +data, the computation being carried out by oneMath and the delivered results. .. container:: section @@ -48,7 +48,7 @@ data, the computation being carried out by oneMKL and the delivered results. .. code:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { enum class precision { SINGLE, DOUBLE @@ -74,7 +74,7 @@ data, the computation being carried out by oneMKL and the delivered results. ++++++++++ Values in this scoped enumeration type represent the kind of forward domain for -the desired DFT(s). As explained in the :ref:`introduction`, +the desired DFT(s). As explained in the :ref:`introduction`, the backward domain type is always complex. .. container:: section @@ -83,7 +83,7 @@ the backward domain type is always complex. .. code:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { enum class domain { REAL, COMPLEX @@ -114,7 +114,7 @@ Values in this scoped enumeration type represent configuration parameters for .. code:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { enum class config_param { // read-only parameters: FORWARD_DOMAIN, @@ -164,7 +164,7 @@ Values in this scoped enumeration type represent configuration parameters for - Kind of forward domain for the DFT. This parameter is read-only. - | ``domain`` | [specialization value used for template parameter ``dom`` of the - ``descriptor`` :ref:`class template`] + ``descriptor`` :ref:`class template`] * - ``DIMENSION`` - Dimension :math:`d` of the DFT. This parameter is read-only. - | ``std::int64_t`` @@ -172,7 +172,7 @@ Values in this scoped enumeration type represent configuration parameters for * - ``LENGTHS`` - Lengths :math:`\lbrace n_1, \ldots, n_d\rbrace` of the DFT. This parameter is read-only and can only be set via the - :ref:`parameterized constructors`. + :ref:`parameterized constructors`. - | ``std::vector`` of size :math:`d` or, if :math:`d = 1`, ``std::int64_t`` | [``std::vector({n_1,...,n_d})``] * - ``PRECISION`` @@ -180,11 +180,11 @@ Values in this scoped enumeration type represent configuration parameters for parameter is read-only. - | ``precision`` | [specialization value used for template parameter ``prec`` of the - ``descriptor`` :ref:`class template`] + ``descriptor`` :ref:`class template`] * - ``COMMIT_STATUS`` - Status flag indicating whether the object is ready for computations after a successful call to its ``commit`` - :ref:`member function`. This parameter + :ref:`member function`. This parameter is read-only. - | ``config_value`` (possible values are ``config_value::COMMITTED`` or ``config_value::UNCOMMITTED``). | [``config_value::UNCOMMITTED``] @@ -202,7 +202,7 @@ Values in this scoped enumeration type represent configuration parameters for - | ``std::int64_t`` | [:math:`1`] * - ``COMPLEX_STORAGE`` - - :ref:`Data storage` type used (relevant + - :ref:`Data storage` type used (relevant for complex descriptors only). - | ``config_value`` (possible values are ``config_value::COMPLEX_COMPLEX`` or ``config_value::REAL_REAL``) | [``config_value::COMPLEX_COMPLEX``] @@ -212,29 +212,29 @@ Values in this scoped enumeration type represent configuration parameters for - | ``config_value`` (possible values are ``config_value::INPLACE`` or ``config_value::NOT_INPLACE``) | [``config_value::INPLACE``] * - ``FWD_STRIDES`` - - Offset and strides :ref:`defining the layout` + - Offset and strides :ref:`defining the layout` within a given data sequence in the forward domain. - | ``std::vector`` of size :math:`(d+1)` - | [see the :ref:`dedicated section`] + | [see the :ref:`dedicated section`] * - ``BWD_STRIDES`` - - Offset and strides :ref:`defining the layout` + - Offset and strides :ref:`defining the layout` within a given data sequence in the backward domain. - | ``std::vector`` of size :math:`(d+1)` - | [see the :ref:`dedicated section`] + | [see the :ref:`dedicated section`] * - ``INPUT_STRIDES`` (deprecated) - - Offset and strides :ref:`defining the layout` + - Offset and strides :ref:`defining the layout` within a given *input* data sequence. - | ``std::vector`` of size :math:`(d+1)` | [``std::vector(d+1, 0)``] * - ``OUTPUT_STRIDES`` (deprecated) - - Offset and strides :ref:`defining the layout` + - Offset and strides :ref:`defining the layout` within a given *output* data sequence. - | ``std::vector`` of size :math:`(d+1)` | [``std::vector(d+1, 0)``] * - ``FWD_DISTANCE`` - - :ref:`Distance` in + - :ref:`Distance` in number of elements of - :ref:`implicitly-assumed data type` + :ref:`implicitly-assumed data type` between forward-domain entries :math:`\left(\cdot\right)^{m}_{k_1, k_2, \ldots, k_d}` and :math:`\left(\cdot\right)^{m + 1}_{k_1, k_2, \ldots, k_d}` for all @@ -246,9 +246,9 @@ Values in this scoped enumeration type represent configuration parameters for - | ``std::int64_t`` | [:math:`0`] * - ``BWD_DISTANCE`` - - :ref:`Distance` in + - :ref:`Distance` in number of elements of - :ref:`implicitly-assumed data type` + :ref:`implicitly-assumed data type` between backward-domain entries :math:`\left(\cdot\right)^{m}_{k_1, k_2, \ldots, k_d}` and :math:`\left(\cdot\right)^{m + 1}_{k_1, k_2, \ldots, k_d}` for all @@ -261,14 +261,14 @@ Values in this scoped enumeration type represent configuration parameters for | [:math:`0`] * - ``WORKSPACE_PLACEMENT`` - Some FFT algorithm computation steps require a - :ref:`scratch space` for + :ref:`scratch space` for permutations or other purposes. This parameter controls whether this scratch space is automatically allocated or provided by the user. - | ``config_value`` (possible values are ``config_value::WORKSPACE_AUTOMATIC`` or ``config_value::WORKSPACE_EXTERNAL``). | [``config_value::WORKSPACE_AUTOMATIC``] * - ``WORKSPACE_EXTERNAL_BYTES`` - The required minimum external workspace size for use by the - ``set_workspace`` :ref:`member function`. + ``set_workspace`` :ref:`member function`. This parameter is read-only and can be queried only if the ``descriptor`` object is committed. - | ``std::int64_t`` @@ -281,13 +281,13 @@ Values in this scoped enumeration type represent configuration parameters for Values in this scoped enumeration type represent possible non-numeric configuration values associated with some -:ref:`configuration parameters`. +:ref:`configuration parameters`. .. container:: section .. code:: cpp - namespace oneapi::mkl::dft { + namespace oneapi::math::dft { enum class config_value { // for config_param::COMMIT_STATUS COMMITTED, @@ -327,7 +327,7 @@ configuration values associated with some and imaginary parts of complex entries are stored separately (``config_value::REAL_REAL``) or not (``config_value::COMPLEX_COMPLEX``). More details are available in the page dedicated to - :ref:`data storage`. + :ref:`data storage`. * - | ``INPLACE`` | ``NOT_INPLACE`` - Possible configuration values associated with the configuration @@ -339,7 +339,7 @@ configuration values associated with some - Possible configuration values associated with the configuration parameter ``config_param::WORKSPACE_PLACEMENT``. More details are available in the page dedicated to - :ref:`workspace placement`. + :ref:`workspace placement`. **Parent topic:** :ref:`onemath_dft` From 0cda1f9f9dbd9d843839988916976935cc648c7f Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 17 Oct 2024 10:52:51 +0200 Subject: [PATCH 06/16] Address last Warning Fix table format Signed-off-by: nscipione --- source/elements/oneMath/source/domains/vm/vm-exceptions.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst index 70deb1017..b9702d47a 100644 --- a/source/elements/oneMath/source/domains/vm/vm-exceptions.rst +++ b/source/elements/oneMath/source/domains/vm/vm-exceptions.rst @@ -16,7 +16,7 @@ Exceptions +----------------------------------+------------------------------------+ | exception | when thrown | +----------------------------------+------------------------------------+ - | oneapi::math::invalid_argument | buffer API: | + | oneapi::math::invalid_argument | buffer API: | | | n < 0; | | | | | | y.get_count() < n; | @@ -29,13 +29,13 @@ Exceptions | | | | | any pointer argument is nullptr | +----------------------------------+------------------------------------+ - | oneapi::math::host_bad_alloc | USM API: | + | oneapi::math::host_bad_alloc | USM API: | | | when internal copying to and | | | from host memory is used | | | and corresponding allocation | | | fails | +----------------------------------+------------------------------------+ - | oneapi::math::device_bad_alloc | USM API: | + | oneapi::math::device_bad_alloc | USM API: | | | when internal copying to and | | | from device memory is used | | | and corresponding allocation | From 77cfe553dbad6b9b240d4713c435fb2ebf864a52 Mon Sep 17 00:00:00 2001 From: nscipione Date: Fri, 18 Oct 2024 17:08:12 +0200 Subject: [PATCH 07/16] Replace wrong namespace Replace wrong usage of "onemath" as namespace in favor of the correct "math" Signed-off-by: nscipione --- source/architecture.rst | 4 +- .../architecture/execution_model.inc.rst | 4 +- .../source/domains/lapack/getrs_batch.rst | 42 +++++++++---------- .../lapack/getrs_batch_scratchpad_size.rst | 16 +++---- .../source/domains/lapack/potrf_batch.rst | 30 ++++++------- .../lapack/potrf_batch_scratchpad_size.rst | 12 +++--- .../source/domains/lapack/potrs_batch.rst | 26 ++++++------ .../lapack/potrs_batch_scratchpad_size.rst | 12 +++--- 8 files changed, 73 insertions(+), 73 deletions(-) diff --git a/source/architecture.rst b/source/architecture.rst index 343367082..94b2da27c 100644 --- a/source/architecture.rst +++ b/source/architecture.rst @@ -117,7 +117,7 @@ Otherwise this is the standard GEMM C++ interface. buffer b{B, range<1>{N*P}}; buffer c{C, range<1>{M*P}}; - onemath::transpose nT = onemath::transpose::nontrans; + math::transpose nT = math::transpose::nontrans; // Syntax // void gemm(queue &exec_queue, transpose transa, transpose transb, // int64_t m, int64_t n, int64_t k, T alpha, @@ -125,7 +125,7 @@ Otherwise this is the standard GEMM C++ interface. // buffer &b, int64_t ldb, T beta, // buffer &c, int64_t ldc); // call gemm - onemath::blas::gemm(q, nT, nT, M, P, N, 1.0, a, M, b, N, 0.0, c, M); + math::blas::gemm(q, nT, nT, M, P, N, 1.0, a, M, b, N, 0.0, c, M); } // when we exit the block, the buffer destructor will write result back to C. diff --git a/source/elements/oneMath/source/architecture/execution_model.inc.rst b/source/elements/oneMath/source/architecture/execution_model.inc.rst index 1b01302db..5c7671f6c 100644 --- a/source/elements/oneMath/source/architecture/execution_model.inc.rst +++ b/source/elements/oneMath/source/architecture/execution_model.inc.rst @@ -24,7 +24,7 @@ Non-Member Functions Each oneMath non-member computational routine takes a ``sycl::queue`` reference as its first parameter:: - onemath::domain::routine(sycl::queue &q, ...); + math::domain::routine(sycl::queue &q, ...); All computation performed by the routine shall be done on the hardware device(s) associated with this queue, with possible aid from the host, unless otherwise specified. In the case of an ordered queue, all computation shall also be ordered with respect to other kernels as if enqueued on that queue. @@ -77,7 +77,7 @@ When USM pointers are used as input to, or output from, a oneMath routine, it be To help the calling application, all oneMath routines with at least one USM pointer argument also take an optional reference to a list of *input events*, of type ``std::vector``, and have a return value of type ``sycl::event`` representing computation completion:: - sycl::event onemath::domain::routine(..., std::vector &in_events = {}); + sycl::event math::domain::routine(..., std::vector &in_events = {}); The routine shall ensure that all input events (if the list is present and non-empty) have occurred before any USM pointers are accessed. Likewise, the routine's output event shall not be complete until the routine has finished accessing all USM pointer arguments. diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst index 62b5d2725..fd27db7c4 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst @@ -38,9 +38,9 @@ The buffer version of ``getrs_batch`` supports only the strided API. **Strided API** | The routine solves for the following systems of linear equations :math:`X_i`: - | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=math::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=math::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=math::transpose::conjtrans`` | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch_buffer` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -50,7 +50,7 @@ The buffer version of ``getrs_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void getrs_batch(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void getrs_batch(cl::sycl::queue &queue, math::transpose trans, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &ipiv, std::int64_t stride_ipiv, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -62,9 +62,9 @@ queue trans | Form of the equations: - | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`Xi`. - | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`Xi`. + | If ``trans = math::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). @@ -150,9 +150,9 @@ The USM version of ``getrs_batch`` supports the group API and strided API. **Group API** | The routine solves the following systems of linear equations for :math:`X_i` (:math:`i \in \{1...batch\_size\}`): - | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=math::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=math::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=math::transpose::conjtrans`` | Before calling this routine, call the Group API of the :ref:`onemath_lapack_getrf_batch_usm` function to compute the LU factorizations of :math:`A_i`. | Total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array. @@ -161,7 +161,7 @@ The USM version of ``getrs_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, onemath::transpose *trans, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, std::int64_t **ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event getrs_batch(cl::sycl::queue &queue, math::transpose *trans, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, std::int64_t **ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -173,9 +173,9 @@ queue trans | Array of ``group_count`` parameters :math:`trans_g` indicating the form of the equations for the group :math:`g`: - | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Array of ``group_count`` parameters :math:`n_g` specifying the order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n_g`) belonging to group :math:`g`. @@ -253,9 +253,9 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine solves the following systems of linear equations for :math:`X_i`: - | :math:`A_iX_i = B_i`, if ``trans=onemath::transpose::nontrans`` - | :math:`A_i^TX_i = B_i`, if ``trans=onemath::transpose::trans`` - | :math:`A_i^HX_i = B_i`, if ``trans=onemath::transpose::conjtrans`` + | :math:`A_iX_i = B_i`, if ``trans=math::transpose::nontrans`` + | :math:`A_i^TX_i = B_i`, if ``trans=math::transpose::trans`` + | :math:`A_i^HX_i = B_i`, if ``trans=math::transpose::conjtrans`` | Before calling this routine, the Strided API of the :ref:`onemath_lapack_getrf_batch` function should be called to compute the LU factorizations of :math:`A_i`. .. container:: section @@ -265,7 +265,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event getrs_batch(cl::sycl::queue &queue, math::transpose trans, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -277,9 +277,9 @@ queue trans | Form of the equations: - | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst index 422afc70e..879b19706 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::transpose *trans, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, math::transpose *trans, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -48,9 +48,9 @@ queue trans | Array of ``group_count`` parameters :math:`\text{trans}_g` indicating the form of the equations for the group :math:`g`: - | If ``trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::conjtrans``, then :math:`A_iHX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::conjtrans``, then :math:`A_iHX_i = B_i` is solved for :math:`X_i`. n Array of ``group_count`` parameters :math:`n_g` specifying the order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n_g`) belonging to group :math:`g`. @@ -103,7 +103,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) + std::int64_t getrs_batch_scratchpad_size(cl::sycl::queue &queue, math::transpose trans, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t stride_ipiv, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; .. container:: section @@ -115,9 +115,9 @@ queue trans | Indicates the form of the equations: - | ``If trans = onemath::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. - | If ``trans = onemath::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. + | ``If trans = math::transpose::nontrans``, then :math:`A_iX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::trans``, then :math:`A_i^TX_i = B_i` is solved for :math:`X_i`. + | If ``trans = math::transpose::conjtrans``, then :math:`A_i^HX_i = B_i` is solved for :math:`X_i`. n Order of the matrices :math:`A_i` and the number of rows in matrices :math:`B_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst index a8fc8e437..1db1d881b 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch.rst @@ -38,8 +38,8 @@ The buffer version of ``potrf_batch`` supports only the strided API. **Strided API** | The routine forms the Cholesky factorizations of a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = math::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = math::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. .. container:: section @@ -49,7 +49,7 @@ The buffer version of ``potrf_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void potrf_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void potrf_batch(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -61,8 +61,8 @@ queue uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = math::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = math::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). @@ -130,8 +130,8 @@ The USM version of ``potrf_batch`` supports the group API and strided API. **Group API** | The routine forms the Cholesky factorizations of symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data (:math:`A_i = U_i^HU_i` for complex), if :math:`\text{uplo}_g` is ``onemath::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data (:math:`A_i = L_iL_i^H` for complex), if :math:`\text{uplo}_g` is ``onemath::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data (:math:`A_i = U_i^HU_i` for complex), if :math:`\text{uplo}_g` is ``math::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data (:math:`A_i = L_iL_i^H` for complex), if :math:`\text{uplo}_g` is ``math::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular, :math:`g` is an index of group of parameters corresponding to :math:`A_i`, and total number of problems to solve, ``batch_size``, is a sum of sizes of all of the groups of parameters as provided by ``group_sizes`` array .. container:: section @@ -141,7 +141,7 @@ The USM version of ``potrf_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrf_batch(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrf_batch(cl::sycl::queue &queue, math::uplo *uplo, std::int64_t *n, T **a, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -153,8 +153,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. Each :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``math::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``math::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n Array of ``group_count`` :math:`n_g` parameters. Each :math:`n_g` specifies the order of the input matrices from array a belonging to group :math:`g`. @@ -221,8 +221,8 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine forms the Cholesky factorizations of a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = math::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = math::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. .. container:: section @@ -232,7 +232,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrf_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrf_batch(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -244,8 +244,8 @@ queue uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = math::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = math::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst index d95ae7605..cc2d43a61 100644 --- a/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrf_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, math::uplo *uplo, std::int64_t *n, std::int64_t *lda, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -49,8 +49,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``math::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``math::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -99,7 +99,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size) + std::int64_t potrf_batch_scratchpad_size(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, std::int64_t lda, std::int64_t stride_a, std::int64_t batch_size) }; .. container:: section @@ -110,8 +110,8 @@ queue Device queue where calculations will be performed. uplo | Indicates whether the upper or lower triangular part of :math:`A_i` is stored and how :math:`A_i` is factored: - | If ``uplo = onemath::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, - | If ``uplo = onemath::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. + | If ``uplo = math::uplo::upper``, the array ``a`` stores the upper triangular parts of the matrices :math:`A_i`, + | If ``uplo = math::uplo::lower``, the array ``a`` stores the lower triangular parts of the matrices :math:`A_i`. n Order of the matrices :math:`A_i`, (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst index 925e6dc17..9d8615c3e 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst @@ -38,8 +38,8 @@ The buffer version of ``potrs_batch`` supports only the strided API. **Strided API** | The routine solves for :math:`X_i` the systems of linear equations :math:`A_iX_i = B_i` with a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, given the Cholesky factorization of :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = math::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = math::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_buffer` function. @@ -51,7 +51,7 @@ The buffer version of ``potrs_batch`` supports only the strided API. .. code-block:: cpp namespace oneapi::math::lapack { - void potrs_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) + void potrs_batch(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, std::int64_t nrhs, cl::sycl::buffer &a, std::int64_t lda, std::int64_t stride_a, cl::sycl::buffer &b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, cl::sycl::buffer &scratchpad, std::int64_t scratchpad_size) } .. container:: section @@ -63,8 +63,8 @@ queue uplo | Indicates how the input matrices have been factored: - | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = math::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = math::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n The order of matrices :math:`A_i` (:math:`0 \le n`). @@ -150,7 +150,7 @@ The USM version of ``potrs_batch`` supports the group API and strided API. .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrs_batch(cl::sycl::queue &queue, math::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, T **a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -163,8 +163,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``math::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``math::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -243,8 +243,8 @@ This routine shall throw the following exceptions if the associated condition is **Strided API** | The routine solves for :math:`X_i` the systems of linear equations :math:`A_iX_i = B_i` with a symmetric positive-definite or, for complex data, Hermitian positive-definite matrices :math:`A_i`, given the Cholesky factorization of :math:`A_i`, :math:`i \in \{1...batch\_size\}`: - | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = onemath::uplo::upper``, - | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = onemath::uplo::lower``, + | :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data if ``uplo = math::uplo::upper``, + | :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data if ``uplo = math::uplo::lower``, | where :math:`L_i` is a lower triangular matrix and :math:`U_i` is upper triangular. | The systems are solved with multiple right-hand sides stored in the columns of the matrices :math:`B_i`. | Before calling this routine, matrices :math:`A_i` should be factorized by call to the Strided API of the :ref:`onemath_lapack_potrf_batch_usm` function. @@ -256,7 +256,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp namespace oneapi::math::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + cl::sycl::event potrs_batch(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, std::int64_t nrhs, T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section @@ -268,8 +268,8 @@ queue uplo | Indicates how the input matrices have been factored: - | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = math::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = math::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n The order of matrices :math:`A_i` (:math:`0 \le n`). diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst index 956ffde2b..19659a650 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch_scratchpad_size.rst @@ -36,7 +36,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) + std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, math::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, std::int64_t *lda, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes) } .. container:: section @@ -49,8 +49,8 @@ queue uplo | Array of ``group_count`` :math:`\text{uplo}_g` parameters. | Each of :math:`\text{uplo}_g` indicates whether the upper or lower triangular parts of the input matrices are provided: - | If :math:`\text{uplo}_g` is ``onemath::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, - | If :math:`\text{uplo}_g` is ``onemath::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. + | If :math:`\text{uplo}_g` is ``math::uplo::upper``, input matrices from array ``a`` belonging to group :math:`g` store the upper triangular parts, + | If :math:`\text{uplo}_g` is ``math::uplo::lower``, input matrices from array ``a`` belonging to group :math:`g` store the lower triangular parts. n | Array of ``group_count`` :math:`n_g` parameters. @@ -106,7 +106,7 @@ Computes the number of elements of type ``T`` the scratchpad memory should able namespace oneapi::math::lapack { template - std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, onemath::uplo uplo, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) + std::int64_t potrs_batch_scratchpad_size(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, std::int64_t nrhs, std::int64_t lda, std::int64_t stride_a, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size) }; .. container:: section @@ -117,8 +117,8 @@ queue Device queue where calculations will be performed. uplo | Indicates how the input matrices have been factored: - | If ``uplo = onemath::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. - | If ``uplo = onemath::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. + | If ``uplo = math::uplo::upper``, the upper triangle :math:`U_i` of :math:`A_i` is stored, where :math:`A_i = U_i^TU_i` for real data, :math:`A_i = U_i^HU_i` for complex data. + | If ``uplo = math::uplo::lower``, the upper triangle :math:`L_i` of :math:`A_i` is stored, where :math:`A_i = L_iL_i^T` for real data, :math:`A_i = L_iL_i^H` for complex data. n Order of matrices :math:`A_i` (:math:`0 \le n`). From 47a7e000751ffac4d54ad54410d8fb548edcf75d Mon Sep 17 00:00:00 2001 From: nscipione Date: Fri, 18 Oct 2024 17:33:09 +0200 Subject: [PATCH 08/16] Fix full name of the specification Set full name to "oneAPI Math Library" and update reference to it Signed-off-by: nscipione --- source/conf/common_conf.py | 2 +- .../oneMath/source/domains/blas/blas-like-extensions.rst | 4 ++-- .../source/domains/lapack/lapack-like-extensions.inc.rst | 4 ++-- .../oneMath/source/domains/random_number_generators.inc.rst | 4 ++-- .../oneMath/source/domains/sparse_linear_algebra.inc.rst | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/source/conf/common_conf.py b/source/conf/common_conf.py index a1e744db0..2c31126c0 100644 --- a/source/conf/common_conf.py +++ b/source/conf/common_conf.py @@ -68,7 +68,7 @@ .. |l0_full_name| replace:: oneAPI Level Zero .. |tbb_full_name| replace:: oneAPI Threading Building Blocks .. |tbb_version| replace:: $oneapi_version -.. |onemath_full_name| replace:: oneAPI Math Kernel Library +.. |onemath_full_name| replace:: oneAPI Math Library .. |onemath_version| replace:: $oneapi_version .. include:: .. |regsup| replace:: :supsub:`reg` diff --git a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst index 08cbf7454..f3d932690 100644 --- a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst +++ b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst @@ -11,8 +11,8 @@ BLAS-like Extensions .. container:: - oneAPI Math Kernel Library DPC++ provides additional routines to - extend the functionality of the BLAS routines. These include routines + oneAPI Math Library DPC++ provides additional routines to extend + the functionality of the BLAS routines. These include routines to compute many independent vector-vector and matrix-matrix operations. The following table lists the BLAS-like extensions with their descriptions. diff --git a/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst index 38213aa1c..e2f1f995a 100644 --- a/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst @@ -11,8 +11,8 @@ LAPACK-like Extensions Routines .. container:: - oneAPI Math Kernel Library DPC++ provides additional routines to - extend the functionality of the LAPACK routines. These include routines + oneAPI Math Library DPC++ provides additional routines to extend + the functionality of the LAPACK routines. These include routines to compute many independent factorizations, linear equation solutions, and similar. The following table lists the LAPACK-like Extensions routine groups. diff --git a/source/elements/oneMath/source/domains/random_number_generators.inc.rst b/source/elements/oneMath/source/domains/random_number_generators.inc.rst index e316dc3fd..dee89a0c0 100644 --- a/source/elements/oneMath/source/domains/random_number_generators.inc.rst +++ b/source/elements/oneMath/source/domains/random_number_generators.inc.rst @@ -7,11 +7,11 @@ Random Number Generators ------------------------- -The oneAPI Math Kernel Library Random Number Generators provides a :ref:`set of routines ` implementing commonly +The oneAPI Math Library Random Number Generators provides a :ref:`set of routines ` implementing commonly used :ref:`pseudorandom, quasi-random, and non-deterministic generators ` with :ref:`continuous and discrete distributions `. .. toctree:: :hidden: - rng/onemath-rng-overview.rst \ No newline at end of file + rng/onemath-rng-overview.rst diff --git a/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst index 2546026f4..4542b10c8 100644 --- a/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst +++ b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst @@ -9,7 +9,7 @@ Sparse Linear Algebra .. container:: - The oneAPI Math Kernel Library provides a C++ interface to a set of Sparse + The oneAPI Math Library provides a C++ interface to a set of Sparse Linear Algebra routines using SYCL. :ref:`onemath_spblas` provides basic operations on sparse vectors and From 876ecf4dbbcdbe34f16c0867a766012aeb2af18e Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 24 Oct 2024 10:51:10 +0200 Subject: [PATCH 09/16] Removing MKL from "spelling_wordlist" and fixing onemath double entry Signed-off-by: nscipione --- source/spelling_wordlist.txt | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/spelling_wordlist.txt b/source/spelling_wordlist.txt index 2f3a58e21..b27e011bb 100644 --- a/source/spelling_wordlist.txt +++ b/source/spelling_wordlist.txt @@ -80,7 +80,6 @@ LSTM Levitan Lognormal MByte -MKL Matsumoto Mersenne Multinomial @@ -496,7 +495,6 @@ microarchitecture middleware minibatch minmag -onemath modf moveassignable mrg From 5149a8c0b058eddcdfd1b0d68434193e29089dd0 Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 24 Oct 2024 10:59:22 +0200 Subject: [PATCH 10/16] Rename macros from ONEMKL to ONEMATH Rename macros for domain and for version Signed-off-by: nscipione --- .../architecture/other_architecture.inc.rst | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/elements/oneMath/source/architecture/other_architecture.inc.rst b/source/elements/oneMath/source/architecture/other_architecture.inc.rst index df2c21ba5..380ec7f41 100644 --- a/source/elements/oneMath/source/architecture/other_architecture.inc.rst +++ b/source/elements/oneMath/source/architecture/other_architecture.inc.rst @@ -18,13 +18,13 @@ Each oneMath domain must define a preprocessor macro to represent the version of The macros for each domain are listed as follows: - | ONEMKL_BLAS_SPEC_VERSION - | ONEMKL_LAPACK_SPEC_VERSION - | ONEMKL_SPBLAS_SPEC_VERSION - | ONEMKL_DFT_SPEC_VERSION - | ONEMKL_RNG_SPEC_VERSION - | ONEMKL_STATS_SPEC_VERSION - | ONEMKL_VM_SPEC_VERSION + | ONEMATH_BLAS_SPEC_VERSION + | ONEMATH_LAPACK_SPEC_VERSION + | ONEMATH_SPBLAS_SPEC_VERSION + | ONEMATH_DFT_SPEC_VERSION + | ONEMATH_RNG_SPEC_VERSION + | ONEMATH_STATS_SPEC_VERSION + | ONEMATH_VM_SPEC_VERSION The specification version can be created by appending all digits of the specification version in the format of . MINOR version always uses two digits. This version can be used to check the compatibility of the implementation with the specification version. Note that the revision is not included here because it reflects changes only for the specification document without affecting the implementation. If the implementation is not compliant with any release of the specification, then the macro must have a numerical value of `000`. @@ -39,13 +39,13 @@ Macro Example .. code-block:: c // For oneAPI 1.2 rev 1 - #define ONEMKL_BLAS_SPEC_VERSION 102 + #define ONEMATH_BLAS_SPEC_VERSION 102 // For oneAPI 1.2 rev 2 - #define ONEMKL_DFT_SPEC_VERSION 102 + #define ONEMATH_DFT_SPEC_VERSION 102 // For oneAPI 1.3 rev 1 - #define ONEMKL_VM_SPEC_VERSION 103 + #define ONEMATH_VM_SPEC_VERSION 103 Versioning details are defined here: https://github.com/uxlfoundation/oneAPI-spec/blob/main/doc/versioning.rst#provisional-versions From 19c21e49b8017fb635fd93c534752442aed33918 Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 24 Oct 2024 11:01:26 +0200 Subject: [PATCH 11/16] Substitute full name with its template Signed-off-by: nscipione --- .../oneMath/source/domains/blas/blas-like-extensions.rst | 2 +- .../source/domains/lapack/lapack-like-extensions.inc.rst | 2 +- .../oneMath/source/domains/random_number_generators.inc.rst | 2 +- .../oneMath/source/domains/sparse_linear_algebra.inc.rst | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst index f3d932690..65143cbae 100644 --- a/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst +++ b/source/elements/oneMath/source/domains/blas/blas-like-extensions.rst @@ -11,7 +11,7 @@ BLAS-like Extensions .. container:: - oneAPI Math Library DPC++ provides additional routines to extend + |onemath_full_name| DPC++ provides additional routines to extend the functionality of the BLAS routines. These include routines to compute many independent vector-vector and matrix-matrix operations. diff --git a/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst index e2f1f995a..df72edcbf 100644 --- a/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst +++ b/source/elements/oneMath/source/domains/lapack/lapack-like-extensions.inc.rst @@ -11,7 +11,7 @@ LAPACK-like Extensions Routines .. container:: - oneAPI Math Library DPC++ provides additional routines to extend + |onemath_full_name| DPC++ provides additional routines to extend the functionality of the LAPACK routines. These include routines to compute many independent factorizations, linear equation solutions, and similar. The following table lists the LAPACK-like Extensions routine groups. diff --git a/source/elements/oneMath/source/domains/random_number_generators.inc.rst b/source/elements/oneMath/source/domains/random_number_generators.inc.rst index dee89a0c0..0f882e73d 100644 --- a/source/elements/oneMath/source/domains/random_number_generators.inc.rst +++ b/source/elements/oneMath/source/domains/random_number_generators.inc.rst @@ -7,7 +7,7 @@ Random Number Generators ------------------------- -The oneAPI Math Library Random Number Generators provides a :ref:`set of routines ` implementing commonly +The |onemath_full_name| Random Number Generators provides a :ref:`set of routines ` implementing commonly used :ref:`pseudorandom, quasi-random, and non-deterministic generators ` with :ref:`continuous and discrete distributions `. diff --git a/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst index 4542b10c8..bd7b33c94 100644 --- a/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst +++ b/source/elements/oneMath/source/domains/sparse_linear_algebra.inc.rst @@ -9,7 +9,7 @@ Sparse Linear Algebra .. container:: - The oneAPI Math Library provides a C++ interface to a set of Sparse + The |onemath_full_name| provides a C++ interface to a set of Sparse Linear Algebra routines using SYCL. :ref:`onemath_spblas` provides basic operations on sparse vectors and From 2a63ce85a699cf2cf41e14c56f9e33a592aabd07 Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 24 Oct 2024 11:02:51 +0200 Subject: [PATCH 12/16] Fix renaming after last rebase Signed-off-by: nscipione --- .../source/domains/spblas/data_types/set_matrix_property.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst index b06d5674a..a277c3c91 100644 --- a/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst +++ b/source/elements/oneMath/source/domains/spblas/data_types/set_matrix_property.rst @@ -69,7 +69,7 @@ details the property for each matrix format: - Description * - CSR - Setting this property for a matrix using the CSR format will throw a - :ref:`oneapi::mkl::invalid_argument` + :ref:`oneapi::math::invalid_argument` exception. * - COO - Guarantees that the indices are sorted by rows in ascending order. From c3301d5a0b7b0bf1d12008a954ffb5218a46a829 Mon Sep 17 00:00:00 2001 From: nscipione Date: Thu, 24 Oct 2024 11:18:46 +0200 Subject: [PATCH 13/16] Update image path for copyright to fix pre-commit check Signed-off-by: nscipione --- .reuse/dep5 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.reuse/dep5 b/.reuse/dep5 index 4d4b4dddb..59b92dd2b 100644 --- a/.reuse/dep5 +++ b/.reuse/dep5 @@ -35,7 +35,7 @@ Files: source/elements/oneDAL/source/*.cpp Copyright: 2020 Intel Corporation License: MIT -Files: source/elements/oneMKL/source/domains/equations/*.png source/elements/oneMKL/source/domains/equations/*.gif source/elements/oneMKL/source/domains/equations/*.jpg +Files: source/elements/oneMath/source/domains/equations/*.png source/elements/oneMath/source/domains/equations/*.gif source/elements/oneMath/source/domains/equations/*.jpg Copyright: 2020 Intel Corporation License: CC-BY-4.0 From a46021514a1d63412ab903f79b7411f805d50d55 Mon Sep 17 00:00:00 2001 From: nscipione Date: Fri, 8 Nov 2024 14:12:03 +0100 Subject: [PATCH 14/16] Update namespace after pulling newest chages Signed-off-by: nscipione --- source/elements/oneMath/source/domains/lapack/getri.rst | 2 +- .../oneMath/source/domains/lapack/getri_batch.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/getrs.rst | 4 ++-- .../oneMath/source/domains/lapack/getrs_batch.rst | 8 ++++---- source/elements/oneMath/source/domains/lapack/orgbr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/orgqr.rst | 2 +- .../oneMath/source/domains/lapack/orgqr_batch.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/orgtr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ormqr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ormrq.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ormtr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/potrs.rst | 4 ++-- .../oneMath/source/domains/lapack/potrs_batch.rst | 8 ++++---- source/elements/oneMath/source/domains/lapack/trtrs.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ungbr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ungqr.rst | 2 +- .../oneMath/source/domains/lapack/ungqr_batch.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/ungtr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/unmqr.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/unmrq.rst | 4 ++-- source/elements/oneMath/source/domains/lapack/unmtr.rst | 4 ++-- 21 files changed, 43 insertions(+), 43 deletions(-) diff --git a/source/elements/oneMath/source/domains/lapack/getri.rst b/source/elements/oneMath/source/domains/lapack/getri.rst index c6189206b..8d8f11db2 100644 --- a/source/elements/oneMath/source/domains/lapack/getri.rst +++ b/source/elements/oneMath/source/domains/lapack/getri.rst @@ -110,7 +110,7 @@ getri (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri(cl::sycl::queue &queue, std::int64_t n, T *a, std::int64_t lda, const std::int64_t *ipiv, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } diff --git a/source/elements/oneMath/source/domains/lapack/getri_batch.rst b/source/elements/oneMath/source/domains/lapack/getri_batch.rst index 81c05576b..e3dd03f4e 100644 --- a/source/elements/oneMath/source/domains/lapack/getri_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getri_batch.rst @@ -133,7 +133,7 @@ Total number of problems to solve, ``batch_size``, is a sum of sizes of all of t .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri_batch(cl::sycl::queue &queue, std::int64_t *n, T **a, std::int64_t *lda, const std::int64_t * const *ipiv, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -216,7 +216,7 @@ The routine computes the inverses :math:`A_i^{-1}` of general matrices :math:`A_ .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event getri_batch(cl::sycl::queue &queue, std::int64_t n, T *a, std::int64_t lda, std::int64_t stride_a, const std::int64_t *ipiv, std::int64_t stride_ipiv, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; diff --git a/source/elements/oneMath/source/domains/lapack/getrs.rst b/source/elements/oneMath/source/domains/lapack/getrs.rst index 8e7504ae7..aa963e17c 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs.rst @@ -151,8 +151,8 @@ getrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event getrs(cl::sycl::queue &queue, oneapi::mkl::transpose trans, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, const std::int64_t *ipiv, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event getrs(cl::sycl::queue &queue, oneapi::math::transpose trans, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, const std::int64_t *ipiv, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst index 9e00533b5..50a55b7b3 100644 --- a/source/elements/oneMath/source/domains/lapack/getrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/getrs_batch.rst @@ -160,8 +160,8 @@ The USM version of ``getrs_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose *trans, std::int64_t *n, std::int64_t *nrhs, const T * const *a, std::int64_t *lda, const std::int64_t * const *ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event getrs_batch(cl::sycl::queue &queue, math::transpose *trans, std::int64_t *n, std::int64_t *nrhs, const T * const *a, std::int64_t *lda, const std::int64_t * const *ipiv, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -264,8 +264,8 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event getrs_batch(cl::sycl::queue &queue, mkl::transpose trans, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, std::int64_t stride_a, const std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event getrs_batch(cl::sycl::queue &queue, math::transpose trans, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, std::int64_t stride_a, const std::int64_t *ipiv, std::int64_t stride_ipiv, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/orgbr.rst b/source/elements/oneMath/source/domains/lapack/orgbr.rst index 9b83f437e..10d05ac30 100644 --- a/source/elements/oneMath/source/domains/lapack/orgbr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgbr.rst @@ -168,8 +168,8 @@ orgbr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event orgbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event orgbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/orgqr.rst b/source/elements/oneMath/source/domains/lapack/orgqr.rst index e9ae7408b..c5d2be04e 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr.rst @@ -146,7 +146,7 @@ orgqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } diff --git a/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst index aa78832a6..ba55b8c22 100644 --- a/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/orgqr_batch.rst @@ -145,7 +145,7 @@ The USM version of ``orgqr_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, T **a, std::int64_t *lda, const T * const *tau, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -243,7 +243,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event orgqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, std::int64_t stride_a, const T *tau, std::int64_t stride_tau, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; diff --git a/source/elements/oneMath/source/domains/lapack/orgtr.rst b/source/elements/oneMath/source/domains/lapack/orgtr.rst index d9bdf2b31..a09d3fe2a 100644 --- a/source/elements/oneMath/source/domains/lapack/orgtr.rst +++ b/source/elements/oneMath/source/domains/lapack/orgtr.rst @@ -114,8 +114,8 @@ orgtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event orgtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event orgtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/ormqr.rst b/source/elements/oneMath/source/domains/lapack/ormqr.rst index a8ccc0bf9..255359a76 100644 --- a/source/elements/oneMath/source/domains/lapack/ormqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormqr.rst @@ -147,8 +147,8 @@ ormqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/ormrq.rst b/source/elements/oneMath/source/domains/lapack/ormrq.rst index 9dc047712..504d2b567 100644 --- a/source/elements/oneMath/source/domains/lapack/ormrq.rst +++ b/source/elements/oneMath/source/domains/lapack/ormrq.rst @@ -147,8 +147,8 @@ ormrq (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/ormtr.rst b/source/elements/oneMath/source/domains/lapack/ormtr.rst index 4e5065304..e34cf2cf5 100644 --- a/source/elements/oneMath/source/domains/lapack/ormtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ormtr.rst @@ -158,8 +158,8 @@ ormtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ormtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ormtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/potrs.rst b/source/elements/oneMath/source/domains/lapack/potrs.rst index 13b04ecf2..e95483ae5 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs.rst @@ -139,8 +139,8 @@ potrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst index bb7717cfd..2a31b772e 100644 --- a/source/elements/oneMath/source/domains/lapack/potrs_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/potrs_batch.rst @@ -149,8 +149,8 @@ The USM version of ``potrs_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, const T * const *a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potrs_batch(cl::sycl::queue &queue, math::uplo *uplo, std::int64_t *n, std::int64_t *nrhs, const T * const *a, std::int64_t *lda, T **b, std::int64_t *ldb, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section @@ -255,8 +255,8 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event potrs_batch(cl::sycl::queue &queue, mkl::uplo uplo, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event potrs_batch(cl::sycl::queue &queue, math::uplo uplo, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, std::int64_t stride_a, T *b, std::int64_t ldb, std::int64_t stride_b, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/trtrs.rst b/source/elements/oneMath/source/domains/lapack/trtrs.rst index d7455c432..2258eeb78 100644 --- a/source/elements/oneMath/source/domains/lapack/trtrs.rst +++ b/source/elements/oneMath/source/domains/lapack/trtrs.rst @@ -146,8 +146,8 @@ trtrs (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event trtrs(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose transa, oneapi::mkl::diag unit_diag, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event trtrs(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, oneapi::math::transpose transa, oneapi::math::diag unit_diag, std::int64_t n, std::int64_t nrhs, const T *a, std::int64_t lda, T *b, std::int64_t ldb, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/ungbr.rst b/source/elements/oneMath/source/domains/lapack/ungbr.rst index bfabd72af..fa899f3a9 100644 --- a/source/elements/oneMath/source/domains/lapack/ungbr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungbr.rst @@ -170,8 +170,8 @@ ungbr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ungbr(cl::sycl::queue &queue, oneapi::mkl::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ungbr(cl::sycl::queue &queue, oneapi::math::generate gen, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/ungqr.rst b/source/elements/oneMath/source/domains/lapack/ungqr.rst index b4b5aec58..98ed3ecfb 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr.rst @@ -145,7 +145,7 @@ ungqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } diff --git a/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst index b4b63bc53..87d63bfd4 100644 --- a/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst +++ b/source/elements/oneMath/source/domains/lapack/ungqr_batch.rst @@ -155,7 +155,7 @@ The USM version of ``ungqr_batch`` supports the group API and strided API. .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr_batch(cl::sycl::queue &queue, std::int64_t *m, std::int64_t *n, std::int64_t *k, T **a, std::int64_t *lda, const T * const *tau, std::int64_t group_count, std::int64_t *group_sizes, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } @@ -253,7 +253,7 @@ This routine shall throw the following exceptions if the associated condition is .. code-block:: cpp - namespace oneapi::mkl::lapack { + namespace oneapi::math::lapack { cl::sycl::event ungqr_batch(cl::sycl::queue &queue, std::int64_t m, std::int64_t n, std::int64_t k, T *a, std::int64_t lda, std::int64_t stride_a, const T *tau, std::int64_t stride_tau, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) }; diff --git a/source/elements/oneMath/source/domains/lapack/ungtr.rst b/source/elements/oneMath/source/domains/lapack/ungtr.rst index bb5cd7747..0e490fdc8 100644 --- a/source/elements/oneMath/source/domains/lapack/ungtr.rst +++ b/source/elements/oneMath/source/domains/lapack/ungtr.rst @@ -117,8 +117,8 @@ ungtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event ungtr(cl::sycl::queue &queue, oneapi::mkl::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event ungtr(cl::sycl::queue &queue, oneapi::math::uplo upper_lower, std::int64_t n, T *a, std::int64_t lda, const T *tau, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/unmqr.rst b/source/elements/oneMath/source/domains/lapack/unmqr.rst index 3289d0ed5..b924422a3 100644 --- a/source/elements/oneMath/source/domains/lapack/unmqr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmqr.rst @@ -147,8 +147,8 @@ unmqr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmqr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmqr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/unmrq.rst b/source/elements/oneMath/source/domains/lapack/unmrq.rst index 859e702a5..5f924c441 100644 --- a/source/elements/oneMath/source/domains/lapack/unmrq.rst +++ b/source/elements/oneMath/source/domains/lapack/unmrq.rst @@ -147,8 +147,8 @@ unmrq (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmrq(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmrq(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, std::int64_t k, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section diff --git a/source/elements/oneMath/source/domains/lapack/unmtr.rst b/source/elements/oneMath/source/domains/lapack/unmtr.rst index 8d1648271..99253c20d 100644 --- a/source/elements/oneMath/source/domains/lapack/unmtr.rst +++ b/source/elements/oneMath/source/domains/lapack/unmtr.rst @@ -169,8 +169,8 @@ unmtr (USM Version) .. code-block:: cpp - namespace oneapi::mkl::lapack { - cl::sycl::event unmtr(cl::sycl::queue &queue, oneapi::mkl::side side, oneapi::mkl::uplo upper_lower, oneapi::mkl::transpose trans, std::int64_t m, std::int64_t n, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) + namespace oneapi::math::lapack { + cl::sycl::event unmtr(cl::sycl::queue &queue, oneapi::math::side side, oneapi::math::uplo upper_lower, oneapi::math::transpose trans, std::int64_t m, std::int64_t n, const T *a, std::int64_t lda, const T *tau, T *c, std::int64_t ldc, T *scratchpad, std::int64_t scratchpad_size, const std::vector &events = {}) } .. container:: section From 4469fccafccdcbd6d22f7452270fdcbbab545590 Mon Sep 17 00:00:00 2001 From: nscipione Date: Fri, 29 Nov 2024 11:12:25 +0100 Subject: [PATCH 15/16] Address PR feedback Add `const` to dependency where needed Signed-off-by: nscipione --- .../oneMath/source/architecture/execution_model.inc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/elements/oneMath/source/architecture/execution_model.inc.rst b/source/elements/oneMath/source/architecture/execution_model.inc.rst index 5c7671f6c..8d01cf682 100644 --- a/source/elements/oneMath/source/architecture/execution_model.inc.rst +++ b/source/elements/oneMath/source/architecture/execution_model.inc.rst @@ -77,7 +77,7 @@ When USM pointers are used as input to, or output from, a oneMath routine, it be To help the calling application, all oneMath routines with at least one USM pointer argument also take an optional reference to a list of *input events*, of type ``std::vector``, and have a return value of type ``sycl::event`` representing computation completion:: - sycl::event math::domain::routine(..., std::vector &in_events = {}); + sycl::event math::domain::routine(..., const std::vector &in_events = {}); The routine shall ensure that all input events (if the list is present and non-empty) have occurred before any USM pointers are accessed. Likewise, the routine's output event shall not be complete until the routine has finished accessing all USM pointer arguments. From ddfe85b9df2274d8c44191fed4151b50f7d5c538 Mon Sep 17 00:00:00 2001 From: nscipione Date: Mon, 2 Dec 2024 11:28:26 +0100 Subject: [PATCH 16/16] Update SIG reference and link Signed-off-by: nscipione --- source/elements/oneMath/source/appendix/acknowledgment.inc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/elements/oneMath/source/appendix/acknowledgment.inc.rst b/source/elements/oneMath/source/appendix/acknowledgment.inc.rst index 41677b3a7..d9ef2743f 100644 --- a/source/elements/oneMath/source/appendix/acknowledgment.inc.rst +++ b/source/elements/oneMath/source/appendix/acknowledgment.inc.rst @@ -6,6 +6,6 @@ Acknowledgment --------------- -The oneMath `Technical Advisory Board `__ members +The oneMath `Special Interest Group `__ members provided valuable feedback to the specification and are thanked for their contributions.