Deprecate distributed algorithms in DAAL by Vika-F · Pull Request #3481 · uxlfoundation/oneDAL

Vika-F · 2026-01-16T11:29:03Z

Description

This PR deprecates all distributed algorithms APIs in DAAL.
The actual removal of the deprecated APIs is expected in 2026.X releases.

Checklist:

Completeness and readability

I have updated the documentation to reflect the changes or created a separate PR with updates and provided its number in the description, if necessary.
Git commit message contains an appropriate signed-off-by string (see CONTRIBUTING.md for details).
I have resolved any merge conflicts that might occur with the base branch.

Testing

I have run it locally and tested the changes extensively.
All CI jobs are green or I have provided justification why they aren't.
No failures related to the changes in CI:
http://intel-ci.intel.com/f106607e-c718-f169-a79a-a4bf010d0e2d
I have extended testing suite if new functionality was introduced in this PR.
No new functionality is introduced.

Performance

not applicable.

Vika-F · 2026-01-19T15:24:43Z

/intelci: run

ethanglaser

Looks like implicit_als still needs deprecations - if we are planning to deprecate those distributed interfaces. Also covariance_types.h.

cpp/daal/include/algorithms/covariance/covariance_distributed.h

cpp/daal/include/algorithms/kmeans/kmeans_init_distributed.h

ethanglaser · 2026-01-26T19:04:57Z

Looks like implicit_als still needs deprecations - if we are planning to deprecate those distributed interfaces. Also covariance_types.h.

Does it make sense to apply deprecations to https://github.com/uxlfoundation/oneDAL/blob/main/cpp/daal/include/algorithms/covariance/covariance_types.h and https://github.com/uxlfoundation/oneDAL/tree/main/cpp/daal/include/algorithms/implicit_als ?

cpp/daal/include/algorithms/implicit_als/implicit_als_predict_ratings_types.h

cpp/daal/include/algorithms/implicit_als/implicit_als_training_distributed.h

ethanglaser · 2026-01-27T19:14:06Z

docs/source/deprecation.rst

+
+- :ref:`Correlation and Variance-Covariance Matrices <cor_cov>`
+- :ref:`K-Means Clustering <kmeans>`
+- :ref:`Linear <linear_regression>` and :ref:`Ridge <ridge>` Regression


Can add DBSCAN and implicit ALS here

Copilot

Pull request overview

This PR deprecates all distributed algorithm APIs in DAAL as part of transitioning distributed functionality from the legacy DAAL interface to the modern oneAPI interface. The deprecation marks these APIs for removal in 2026.x releases, with complete transition to oneAPI expected by 2027.0.

Changes:

Documentation added describing deprecation timeline and affected algorithms
DAAL_DEPRECATED macro added to constructors and initializer lists across distributed algorithm classes
Reference anchors added to documentation files for cross-referencing

Reviewed changes

Copilot reviewed 28 out of 28 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/source/deprecation.rst	Added deprecation notice section documenting affected algorithms and migration path
docs/source/daal/algorithms/qr/qr-without-pivoting.rst	Added reference anchor for QR decomposition
docs/source/daal/algorithms/implicit_als/implicit-alternating-least-squares.rst	Added reference anchor for Implicit ALS
cpp/daal/include/algorithms/svd/*.h	Deprecated distributed SVD constructors and input/result classes
cpp/daal/include/algorithms/ridge_regression/*.h	Deprecated distributed ridge regression constructors and input classes
cpp/daal/include/algorithms/qr/*.h	Deprecated distributed QR decomposition constructors and input/result classes
cpp/daal/include/algorithms/pca/*.h	Deprecated distributed PCA constructors, parameters, and input classes
cpp/daal/include/algorithms/moments/*.h	Deprecated distributed low order moments constructors and input classes
cpp/daal/include/algorithms/linear_regression/*.h	Deprecated distributed linear regression constructors and input classes
cpp/daal/include/algorithms/kmeans/*.h	Deprecated distributed K-Means constructors, inputs, and partial results
cpp/daal/include/algorithms/implicit_als/*.h	Deprecated distributed Implicit ALS constructors, parameters, inputs, and results
cpp/daal/include/algorithms/dbscan/*.h	Deprecated all distributed DBSCAN constructors, containers, inputs, and results across 13 steps
cpp/daal/include/algorithms/covariance/*.h	Deprecated distributed covariance constructors and input classes

docs/source/deprecation.rst

cpp/daal/include/algorithms/pca/pca_types.h

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 6 comments.

Copilot · 2026-02-06T14:04:28Z

docs/source/deprecation.rst

+**Deprecation:** The distributed DAAL functionality in the oneDAL library is marked as deprecated.
+The 2026.x releases are the last to provide it. The list of the deprecated DAAL distributed algorithms includes:


The timeline stated here is internally inconsistent: it says 2026.x are the last releases to provide distributed DAAL, while also stating that by 2027.0 everything will be available via oneDAL-only interfaces. If 2026.x is the last to provide DAAL distributed APIs, the removal point should be clearly stated (e.g., removed starting 2027.0). Please clarify the timeline and align the wording so it unambiguously communicates last supported version vs. first removed version.

The exact dates of the removal cannot be specified now, because they are unknown yet. The removals will happen in 2026.x timeframe.

Copilot · 2026-02-06T14:04:29Z

docs/source/deprecation.rst

+**Reasons for deprecation:** The distributed functionality running on CPUs is being transitioned from DAAL to oneDAL.
+By 2027.0 release, all distributed algorithms will be available through oneDAL interfaces only.


The timeline stated here is internally inconsistent: it says 2026.x are the last releases to provide distributed DAAL, while also stating that by 2027.0 everything will be available via oneDAL-only interfaces. If 2026.x is the last to provide DAAL distributed APIs, the removal point should be clearly stated (e.g., removed starting 2027.0). Please clarify the timeline and align the wording so it unambiguously communicates last supported version vs. first removed version.

docs/source/deprecation.rst

cpp/daal/include/algorithms/pca/pca_types.h

Copilot · 2026-02-06T14:04:30Z

cpp/daal/include/algorithms/svd/svd_distributed.h

    typedef typename super::PartialResultType PartialResultType;

-    Distributed() : Online<algorithmFPType, method>() {}
+    DAAL_DEPRECATED Distributed() : Online<algorithmFPType, method>() {}


Only the default constructor is marked deprecated here, but the class still exposes other public constructors (e.g., copy constructors) that remain non-deprecated. If the goal is to deprecate the distributed API surface, consider deprecating the class itself (or consistently marking all public constructors/assignment operators) to ensure users get a deprecation warning for any use of the type, not just one construction path.

It is enough to deprecate only constructors, because those classes can only be created through those constructors.

cpp/daal/include/algorithms/pca/pca_types.h

Copilot

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 1 comment.

Copilot · 2026-02-06T14:07:09Z

cpp/daal/include/algorithms/pca/pca_types.h

+                                             services::SharedPtr<covariance::Distributed<step2Master, algorithmFPType, covariance::defaultDense> >(
+                                                 new covariance::Distributed<step2Master, algorithmFPType, covariance::defaultDense>()));


This deprecated constructor’s default argument instantiates covariance::Distributed<step2Master,...>, whose default ctor is now deprecated (in this PR). Many compilers emit deprecation diagnostics at the point of the default-argument declaration, which can cause warnings (or -Werror build breaks) for any TU that includes this header, even if the constructor is never called. Consider changing the default to an empty SharedPtr and performing the fallback initialization in the constructor definition (or otherwise avoiding a deprecated constructor call in the default argument expression).

Suggested change

services::SharedPtr<covariance::Distributed<step2Master, algorithmFPType, covariance::defaultDense> >(

new covariance::Distributed<step2Master, algorithmFPType, covariance::defaultDense>()));

services::SharedPtr<covariance::DistributedIface<step2Master> >());

If this leads to problems in the future, this can be changed. But for now I prefer to leave it as is.
Also, this API is planned for removal by 2027.0 release.

david-cortes-intel · 2026-02-06T14:14:21Z

/intelci: run

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated no new comments.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 4 comments.

Copilot · 2026-02-06T14:59:18Z

docs/source/deprecation.rst

+******************************
+
+**Deprecation:** The distributed DAAL functionality in the oneDAL library is marked as deprecated.
+The 2026.x releases are the last to provide it. The list of the deprecated DAAL distributed algorithms includes:


Minor grammar/readability: 'The list of the deprecated ... includes' reads awkwardly. Consider rephrasing to 'The following DAAL distributed algorithms are deprecated:' (and optionally split the long sentence for easier scanning).

Suggested change

The 2026.x releases are the last to provide it. The list of the deprecated DAAL distributed algorithms includes:

The 2026.x releases are the last to provide it. The following DAAL distributed algorithms are deprecated:

Copilot · 2026-02-06T14:59:19Z

cpp/daal/include/algorithms/qr/qr_distributed.h

    typedef typename super::PartialResultType PartialResultType;

-    Distributed() : Online<algorithmFPType, method>() {}
+    DAAL_DEPRECATED Distributed() : Online<algorithmFPType, method>() {}


Deprecation is currently applied to specific constructors, but the type itself (and potentially other public construction/usage paths) may remain non-deprecated. If the goal is to deprecate the distributed API surface, consider deprecating the Distributed<...> class template/specializations themselves (or consistently marking all public constructors and key entry points), so any use triggers a diagnostic regardless of which constructor a user calls.

It is enough to deprecate only constructors, because those classes can only be created through those constructors.

cpp/daal/include/algorithms/qr/qr_distributed.h

Vika-F · 2026-02-09T14:03:50Z

/intelci: run

david-cortes-intel · 2026-02-11T10:18:44Z

/intelci: run

david-cortes-intel · 2026-02-11T10:19:35Z

The CI error:

 Linking cpp/oneapi/dal/table/backend_test_copy_convert_dpc failed: (Exit 1): dpc_dynamic_link.sh failed: error executing CppLink command (from target //cpp/oneapi/dal/table:backend_test_copy_convert_dpc)  ... (remaining 2 arguments skipped)

Vika-F · 2026-02-12T11:56:27Z

/intelci: run

david-cortes-intel · 2026-02-12T13:50:59Z

I'm unable to access all the logs, but I see an issue with msvc likely popping up with this example: mn_naive_bayes_dense_online.

Vika-F · 2026-02-12T14:01:10Z

I'm unable to access all the logs, but I see an issue with msvc likely popping up with this example: mn_naive_bayes_dense_online.

@david-cortes-intel yes, I also see the errors in python examples and tests. I will investigate.

Copilot

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated no new comments.

Vika-F · 2026-02-19T12:19:37Z

/intelci: run

DAAL distributed algorithm deprecations

fc28391

Vika-F added the interfaces Update interfaces label Jan 16, 2026

Update docs

e28b3e1

Vika-F marked this pull request as ready for review January 20, 2026 11:59

Vika-F requested review from Alexandr-Solovev, avolkov-intel, david-cortes-intel, ethanglaser, icfaust, maria-Petrova and yuejiaointel as code owners January 20, 2026 11:59

ethanglaser reviewed Jan 23, 2026

View reviewed changes

cpp/daal/include/algorithms/covariance/covariance_distributed.h Show resolved Hide resolved

cpp/daal/include/algorithms/kmeans/kmeans_init_distributed.h Show resolved Hide resolved

Vika-F added 2 commits January 27, 2026 02:01

Add deprecatrions in implicit ALS and Covariance types

eb18588

Fix a typo

d850e52

ethanglaser reviewed Jan 27, 2026

View reviewed changes

cpp/daal/include/algorithms/implicit_als/implicit_als_predict_ratings_types.h Outdated Show resolved Hide resolved

ethanglaser reviewed Jan 27, 2026

View reviewed changes

cpp/daal/include/algorithms/implicit_als/implicit_als_training_distributed.h Outdated Show resolved Hide resolved

ethanglaser reviewed Jan 27, 2026

View reviewed changes

cpp/daal/include/algorithms/implicit_als/implicit_als_training_distributed.h Outdated Show resolved Hide resolved

ethanglaser reviewed Jan 27, 2026

View reviewed changes

Vika-F added 3 commits January 28, 2026 02:27

Fixes

2583694

Docs fix

3f042d1

Merge branch 'main' into dev/distr_depr

349c12e

Copilot AI review requested due to automatic review settings February 6, 2026 09:54