Use intersphinx links for deep learning (#5859 )

* Use intersphinx links for deep learning * Update deep-learning-rocm.rst remove Taichi * Update deep-learning-rocm.rst Change Install link to "link" * Apply suggestion from @randyh62 OK
Add missing APU entries to GPU hardware specifications (#646 ) (#5862 )
2026-01-16 18:18:15 -05:00 · 2026-01-16 13:17:47 -08:00 · 2026-01-16 12:55:55 -05:00 · 2026-01-16 10:25:40 -05:00 · 2026-01-16 06:54:25 -07:00
6 changed files with 175 additions and 70 deletions
--- a/.azuredevops/components/hipSPARSE.yml
+++ b/.azuredevops/components/hipSPARSE.yml
@@ -32,7 +32,6 @@ parameters:
 - name: aptPackages
  type: object
  default:
-    - cmake
    - gfortran
    - git
    - libboost-program-options-dev
@@ -42,6 +41,7 @@ parameters:
 - name: rocmDependencies
  type: object
  default:
+    - aomp
    - clr
    - llvm-project
    - rocminfo
@@ -51,6 +51,7 @@ parameters:
 - name: rocmTestDependencies
  type: object
  default:
+    - aomp
    - clr
    - llvm-project
    - hipBLAS-common
@@ -103,6 +104,7 @@ jobs:
      parameters:
        aptPackages: ${{ parameters.aptPackages }}
        packageManager: ${{ job.packageManager }}
+    - template: ${{ variables.CI_TEMPLATE_PATH }}/steps/dependencies-cmake-custom.yml
    - template: ${{ variables.CI_TEMPLATE_PATH }}/steps/preamble.yml
    - template: ${{ variables.CI_TEMPLATE_PATH }}/steps/checkout.yml
      parameters:
@@ -128,6 +130,7 @@ jobs:
          -DCMAKE_PREFIX_PATH=$(Agent.BuildDirectory)/rocm;$(Agent.BuildDirectory)/vendor
          -DCMAKE_CXX_COMPILER=$(Agent.BuildDirectory)/rocm/llvm/bin/amdclang++
          -DCMAKE_C_COMPILER=$(Agent.BuildDirectory)/rocm/bin/amdclang
+          -DCMAKE_Fortran_COMPILER=gfortran
          -DCMAKE_BUILD_TYPE=Release
          -DBUILD_CLIENTS_TESTS=ON
          -DBUILD_CLIENTS_SAMPLES=OFF
--- a/docs/how-to/deep-learning-rocm.rst
+++ b/docs/how-to/deep-learning-rocm.rst
@@ -19,117 +19,95 @@ The table below summarizes information about ROCm-enabled deep learning framewor
    :widths: 5 3 6 3

    * - Framework
-      - Installation
+      - Installation guide
      - Installation options
      - GitHub

-    * - `PyTorch <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/pytorch-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/pytorch-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`PyTorch <../compatibility/ml-compatibility/pytorch-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/pytorch-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/pytorch-install.html#using-a-docker-image-with-pytorch-pre-installed>`__
-        - `Wheels package <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/pytorch-install.html#using-a-wheels-package>`__
-        - `ROCm Base Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/pytorch-install.html#using-the-pytorch-rocm-base-docker-image>`__
-        - `Upstream Docker file <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/pytorch-install.html#using-the-pytorch-upstream-dockerfile>`__
+        - Docker image
+        - Wheels package
+        - ROCm Base Docker image
+        - Upstream Docker file
      - .. raw:: html

          <a href="https://github.com/ROCm/pytorch"><i class="fab fa-github fa-lg"></i></a>

-    * - `TensorFlow <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/tensorflow-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/tensorflow-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`TensorFlow <../compatibility/ml-compatibility/tensorflow-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/tensorflow-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/tensorflow-install.html#using-a-docker-image-with-tensorflow-pre-installed>`__
-        - `Wheels package <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/tensorflow-install.html#using-a-wheels-package>`__
+        - Docker image
+        - Wheels package

      - .. raw:: html

          <a href="https://github.com/ROCm/tensorflow-upstream"><i class="fab fa-github fa-lg"></i></a> 

-    * - `JAX <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/jax-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/jax-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`JAX <../compatibility/ml-compatibility/jax-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/jax-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/jax-install.html#using-a-prebuilt-docker-image>`__
+        - Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/jax"><i class="fab fa-github fa-lg"></i></a>

-    * - `verl <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/verl-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/verl-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`verl <../compatibility/ml-compatibility/verl-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/verl-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/verl-install.html#use-a-prebuilt-docker-image-with-verl-pre-installed>`__
+        - Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/verl"><i class="fab fa-github fa-lg"></i></a>

-    * - `Stanford Megatron-LM <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/stanford-megatron-lm-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/stanford-megatron-lm-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`Stanford Megatron-LM <../compatibility/ml-compatibility/stanford-megatron-lm-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/stanford-megatron-lm-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/stanford-megatron-lm-install.html#use-a-prebuilt-docker-image-with-stanford-megatron-lm-pre-installed>`__
+        - Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/Stanford-Megatron-LM"><i class="fab fa-github fa-lg"></i></a>

-    * - `DGL <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/dgl-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/dgl-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`DGL <../compatibility/ml-compatibility/dgl-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/dgl-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/dgl-install.html#use-a-prebuilt-docker-image-with-dgl-pre-installed>`__
-        - `Wheels package <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/dgl-install.html#use-a-wheels-package>`__
-
+        - Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/dgl"><i class="fab fa-github fa-lg"></i></a> 

-    * - `Megablocks <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/megablocks-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/megablocks-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`Megablocks <../compatibility/ml-compatibility/megablocks-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/megablocks-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/megablocks-install.html#using-a-prebuilt-docker-image-with-megablocks-pre-installed>`__
+        - Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/megablocks"><i class="fab fa-github fa-lg"></i></a>

-    * - `Ray <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/ray-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/ray-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`Ray <../compatibility/ml-compatibility/ray-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/ray-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/ray-install.html#using-a-prebuilt-docker-image-with-ray-pre-installed>`__
-        - `Wheels package <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/ray-install.html#install-ray-on-bare-metal-or-a-custom-container>`__
-        - `ROCm Base Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/ray-install.html#build-your-own-docker-image>`__
+        - Docker image
+        - Wheels package
+        - ROCm Base Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/ray"><i class="fab fa-github fa-lg"></i></a>

-    * - `llama.cpp <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/llama-cpp-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/llama-cpp-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`llama.cpp <../compatibility/ml-compatibility/llama-cpp-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/llama-cpp-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/llama-cpp-install.html#use-a-prebuilt-docker-image-with-llama-cpp-pre-installed>`__
-        - `ROCm Base Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/llama-cpp-install.html#build-your-own-docker-image>`__
+        - Docker image
+        - ROCm Base Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/llama.cpp"><i class="fab fa-github fa-lg"></i></a>

-    * - `FlashInfer <https://rocm.docs.amd.com/en/latest/compatibility/ml-compatibility/flashinfer-compatibility.html>`__
-      - .. raw:: html
-
-          <a href="https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/flashinfer-install.html"><i class="fas fa-link fa-lg"></i></a>
+    * - :doc:`FlashInfer <../compatibility/ml-compatibility/flashinfer-compatibility>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/flashinfer-install>`
      - 
-        - `Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/flashinfer-install.html#use-a-prebuilt-docker-image-with-flashinfer-pre-installed>`__
-        - `ROCm Base Docker image <https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/3rd-party/flashinfer-install.html#build-your-own-docker-image>`__
+        - Docker image
+        - ROCm Base Docker image
      - .. raw:: html

          <a href="https://github.com/ROCm/flashinfer"><i class="fab fa-github fa-lg"></i></a>
--- a/docs/reference/gpu-arch-specs.rst
+++ b/docs/reference/gpu-arch-specs.rst
@@ -5,7 +5,7 @@
 GPU hardware specifications
 ===========================================

-The following tables provide an overview of the hardware specifications for AMD Instinct™ GPUs, and AMD Radeon™ PRO and Radeon™ GPUs.
+The following tables provide an overview of the hardware specifications for AMD Instinct™ GPUs, AMD Radeon™ PRO and Radeon™ GPUs, and AMD Ryzen™ APUs.

 For more information about ROCm hardware compatibility, see the ROCm `Compatibility matrix <https://rocm.docs.amd.com/en/latest/compatibility/compatibility-matrix.html>`_.

@@ -18,7 +18,7 @@ For more information about ROCm hardware compatibility, see the ROCm `Compatibil
        :name: instinct-arch-spec-table

        *
-          - Model
+          - Name
          - Architecture
          - LLVM target name
          - VRAM (GiB)
@@ -297,7 +297,7 @@ For more information about ROCm hardware compatibility, see the ROCm `Compatibil
        :name: radeon-pro-arch-spec-table

        *
-          - Model
+          - Name
          - Architecture
          - LLVM target name

@@ -539,7 +539,7 @@ For more information about ROCm hardware compatibility, see the ROCm `Compatibil
        :name: radeon-arch-spec-table

        *
-          - Model
+          - Name
          - Architecture
          - LLVM target name
          - VRAM (GiB)
@@ -953,6 +953,127 @@ For more information about ROCm hardware compatibility, see the ROCm `Compatibil
          - 9
          - 0

+  .. tab-item:: AMD Ryzen APUs
+
+    .. list-table::
+        :header-rows: 1
+        :name: ryzen-arch-spec-table
+
+        *
+          - Name
+          - Graphics model
+          - Architecture
+          - LLVM target name
+          - VRAM (GiB)
+          - Compute Units
+          - Wavefront Size
+          - LDS (KiB)
+          - Infinity Cache (MiB)
+          - L2 Cache (MiB)
+          - Graphics L1 Cache (KiB)
+          - L0 Vector Cache (KiB)
+          - L0 Scalar Cache (KiB)
+          - L0 Instruction Cache (KiB)
+          - VGPR File (KiB)
+          - SGPR File (KiB)
+          - GFXIP Major version
+          - GFXIP Minor version
+        *
+          - AMD Ryzen 7 7840U
+          - Radeon 780M
+          - RDNA3
+          - gfx1103
+          - Dynamic + carveout
+          - 12
+          - 32 or 64
+          - 128
+          - N/A
+          - 2
+          - 256
+          - 32
+          - 16
+          - 32
+          - 512
+          - 32
+          - 11
+          - 0
+        *
+          - AMD Ryzen 9 270
+          - Radeon 780M
+          - RDNA3
+          - gfx1103
+          - Dynamic + carveout
+          - 12
+          - 32 or 64
+          - 128
+          - N/A
+          - 2
+          - 256
+          - 32
+          - 16
+          - 32
+          - 512
+          - 32
+          - 11
+          - 0
+        *
+          - AMD Ryzen AI 9 HX 375
+          - Radeon 890M
+          - RDNA3.5
+          - gfx1150
+          - Dynamic + carveout
+          - 16
+          - 32 or 64
+          - 128
+          - N/A
+          - 2
+          - 256
+          - 32
+          - 16
+          - 32
+          - 512
+          - 32
+          - 11
+          - 5
+        *
+          - AMD Ryzen AI Max+ PRO 395
+          - Radeon 8060S
+          - RDNA3.5
+          - gfx1151
+          - Dynamic + carveout
+          - 40
+          - 32 or 64
+          - 128
+          - 32
+          - 2
+          - 256
+          - 32
+          - 16
+          - 32
+          - 768
+          - 32
+          - 11
+          - 5
+        *
+          - AMD Ryzen Al 7 350
+          - Radeon 860M
+          - RDNA3.5
+          - gfx1152
+          - Dynamic + carveout
+          - 8
+          - 32 or 64
+          - 128
+          - N/A
+          - 1
+          - 256
+          - 32
+          - 16
+          - 32
+          - 512
+          - 32
+          - 11
+          - 5
+
 Glossary
 ========

--- a/docs/sphinx/_toc.yml.in
+++ b/docs/sphinx/_toc.yml.in
@@ -25,7 +25,7 @@ subtrees:
    title: HIP SDK on Windows
  - url: https://rocm.docs.amd.com/projects/radeon-ryzen/en/latest/index.html
    title: ROCm on Radeon and Ryzen
-  - file: how-to/deep-learning-rocm.md
+  - file: how-to/deep-learning-rocm
    title: Deep learning frameworks
    subtrees:
    - entries:
--- a/docs/sphinx/requirements.in
+++ b/docs/sphinx/requirements.in
@@ -1,4 +1,4 @@
-rocm-docs-core==1.31.2
+rocm-docs-core==1.31.3
 sphinx-reredirects
 sphinx-sitemap
 sphinxcontrib.datatemplates==0.11.0
--- a/docs/sphinx/requirements.txt
+++ b/docs/sphinx/requirements.txt
@@ -188,7 +188,7 @@ requests==2.32.5
    # via
    #   pygithub
    #   sphinx
-rocm-docs-core==1.31.2
+rocm-docs-core==1.31.3
    # via -r requirements.in
 rpds-py==0.30.0
    # via
@@ -214,6 +214,7 @@ sphinx==8.1.3
    #   sphinx-design
    #   sphinx-external-toc
    #   sphinx-last-updated-by-git
+    #   sphinx-multitoc-numbering
    #   sphinx-notfound-page
    #   sphinx-reredirects
    #   sphinxcontrib-datatemplates
@@ -224,10 +225,12 @@ sphinx-copybutton==0.5.2
    # via rocm-docs-core
 sphinx-design==0.6.1
    # via rocm-docs-core
-sphinx-external-toc==1.0.1
+sphinx-external-toc==1.1.0
    # via rocm-docs-core
 sphinx-last-updated-by-git==0.3.8
    # via sphinx-sitemap
+sphinx-multitoc-numbering==0.1.3
+    # via sphinx-external-toc
 sphinx-notfound-page==1.1.0
    # via rocm-docs-core
 sphinx-reredirects==0.1.6
Author	SHA1	Message	Date
randyh62	45bd726f55	Use intersphinx links for deep learning (#5859 ) * Use intersphinx links for deep learning * Update deep-learning-rocm.rst remove Taichi * Update deep-learning-rocm.rst Change Install link to "link" * Apply suggestion from @randyh62 OK	2026-01-16 13:17:47 -08:00
Jeffrey Novotny	33fbde69db	Add missing APU entries to GPU hardware specifications (#646 ) (#5862 ) * Add missing APU entries to GPU hardware specifications * Move Ryzen APUs to new tab * Add new column to Ryzen table and rename column elsewhere --------- (cherry picked from commit 7ab402a3b3e580ca27321635596ca14eca8c1277) Co-authored-by: alexxu-amd <159800977+alexxu-amd@users.noreply.github.com>	2026-01-16 12:55:55 -05:00
Alex Xu	2851f89992	update rocm-docs-core version to 1.31.3	2026-01-16 10:25:40 -05:00
David Dixon	d31ca06bea	Fix Azure failures introduced by hipsparse build system refactor (#5857 )	2026-01-16 06:54:25 -07:00