diff --git a/docs/hpc-apps/compatibility-list.rst b/docs/hpc-apps/compatibility-list.rst new file mode 100644 index 00000000..8288c36d --- /dev/null +++ b/docs/hpc-apps/compatibility-list.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Known Compatibility List for AMD Instinct + :keywords: AMD, Instinct, ROCm, GPU, applications, compatibility + +**************************************************************** +Known Compatibility List for AMD Instinct +**************************************************************** diff --git a/docs/hpc-apps/recommended-apps.rst b/docs/hpc-apps/recommended-apps.rst new file mode 100644 index 00000000..0843cd14 --- /dev/null +++ b/docs/hpc-apps/recommended-apps.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Recommended Applications for Scientific Computing on AMD Instinct + :keywords: AMD, Instinct, ROCm, GPU, applications, compatibility + +**************************************************************** +Recommended Applications for Scientific Computing on AMD Instinct +**************************************************************** diff --git a/docs/introduction/getting-started-on-a-supercomputer.rst b/docs/introduction/getting-started-on-a-supercomputer.rst new file mode 100644 index 00000000..d58c4926 --- /dev/null +++ b/docs/introduction/getting-started-on-a-supercomputer.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Getting Started on an AMD Instinct Supercomputer + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, supercomputer + +**************************************************************** +Getting Started on an AMD Instinct Supercomputer +**************************************************************** diff --git a/docs/introduction/getting-started.rst b/docs/introduction/getting-started.rst new file mode 100644 index 00000000..d1c7dc35 --- /dev/null +++ b/docs/introduction/getting-started.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Getting Started with AMD Instinct and ROCm + :keywords: AMD, Instinct, ROCm, HIP, GPU + +**************************************************************** +Getting Started with AMD Instinct and ROCm +**************************************************************** diff --git a/docs/introduction/index.rst b/docs/introduction/index.rst new file mode 100644 index 00000000..94e442e0 --- /dev/null +++ b/docs/introduction/index.rst @@ -0,0 +1,15 @@ +.. meta:: + :description: Introduction to AMD Instinct™ Accelerators + :keywords: AMD, Instinct, ROCm, HIP, GPU + +Introduction to AMD Instinct™ Accelerators +****************************************** + +* :doc:`intro-to-hpc` +* :doc:`intro-to-gpu-programming` + +Getting Started with AMD Instinct™ +================================== + +* :doc:`getting-started` +* :doc:`getting-started-on-a-supercomputer` \ No newline at end of file diff --git a/docs/introduction/intro-to-gpu-programming.rst b/docs/introduction/intro-to-gpu-programming.rst new file mode 100644 index 00000000..223b3f35 --- /dev/null +++ b/docs/introduction/intro-to-gpu-programming.rst @@ -0,0 +1,48 @@ +.. meta:: + :description: Introduction to GPU Programming + :keywords: AMD, Instinct, ROCm, HIP, GPU + +Introduction to GPU Programming +******************************* + +This document is intended for programmers, computational scientists, and others who are interested in the use of GPUs +to accelerate applications. + +GPU Architecture Basics +======================= + +* How does a GPU differ from a CPU? +* Homogeneous vs heterogenous Computing +* Highly parallel design +* Memory architectures in heterogeneous architectures +* What kind of algorithms map well to GPUs? + +Programming Models +================== + +* How to choose a programming model + +Native Programming +------------------ + +Directive-based Programming +--------------------------- + +Standards-based Paralleism +-------------------------- + +High-level languages and frameworks +----------------------------------- + +Parallel Frameworks +^^^^^^^^^^^^^^^^^^^ + +* Kokkos +* Raja + +AI Frameworks +^^^^^^^^^^^^^ + +* PyTorch +* TensorFlow +* Triton \ No newline at end of file diff --git a/docs/introduction/intro-to-hpc.rst b/docs/introduction/intro-to-hpc.rst new file mode 100644 index 00000000..2ac1dcad --- /dev/null +++ b/docs/introduction/intro-to-hpc.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Introduction to HPC and Scientific Computing + :keywords: AMD, Instinct, ROCm, GPU, HPC + +**************************************************************** +Introduction to HPC and Scientific Computing +**************************************************************** diff --git a/docs/library-manual/hipfft.rst b/docs/library-manual/hipfft.rst new file mode 100644 index 00000000..41d0442d --- /dev/null +++ b/docs/library-manual/hipfft.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: ROCm Library Manual - hipFFT + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, libraries, math libraries, fft + +**************************************************************** +ROCm Library Manual - hipFFT +**************************************************************** diff --git a/docs/library-manual/index.rst b/docs/library-manual/index.rst new file mode 100644 index 00000000..c4987706 --- /dev/null +++ b/docs/library-manual/index.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: ROCm Library Manual + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, libraries, math libraries, linear algebra, fft + +**************************************************************** +ROCm Library Manual +**************************************************************** diff --git a/docs/porting-guide/cuda-to-hip.rst b/docs/porting-guide/cuda-to-hip.rst new file mode 100644 index 00000000..ce995168 --- /dev/null +++ b/docs/porting-guide/cuda-to-hip.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Porting Applications from CUDA to HIP + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, porting, CUDA + +**************************************************************** +Porting Applications from CUDA to HIP +**************************************************************** diff --git a/docs/porting-guide/openacc-to-openmp.rst b/docs/porting-guide/openacc-to-openmp.rst new file mode 100644 index 00000000..61e24b1b --- /dev/null +++ b/docs/porting-guide/openacc-to-openmp.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Porting Applications from OpenMP to OpenACC + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, porting, OpenMP, OpenACC + +**************************************************************** +Porting Applications from CUDA to HIP +**************************************************************** diff --git a/docs/programming-guide/debugger.rst b/docs/programming-guide/debugger.rst new file mode 100644 index 00000000..2309445e --- /dev/null +++ b/docs/programming-guide/debugger.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Debugging Applications on AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, debugging + +**************************************************************** +Debugging Applications on AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/design-patterns/index.rst b/docs/programming-guide/design-patterns/index.rst new file mode 100644 index 00000000..be38cc60 --- /dev/null +++ b/docs/programming-guide/design-patterns/index.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Design Patterns and Algorithms for AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, design patterns, algorithms + +**************************************************************** +Design Patterns and Algorithms for AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/fortran.rst b/docs/programming-guide/fortran.rst new file mode 100644 index 00000000..d689540c --- /dev/null +++ b/docs/programming-guide/fortran.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Fortran Programming Manual for AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, Fortran + +**************************************************************** +Fortran Programming Manual for AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/hip-manual/index.rst b/docs/programming-guide/hip-manual/index.rst new file mode 100644 index 00000000..1cc63d73 --- /dev/null +++ b/docs/programming-guide/hip-manual/index.rst @@ -0,0 +1,58 @@ +.. meta:: + :description: HIP Programming Manual + :keywords: AMD, Instinct, ROCm, HIP, GPU + +HIP Programming Manual +********************** + +* Link to Instinct Architecture Guide + +Introduction +============ + +* Simple example of a kernel + +Programming Model +================= + +Device Code +----------- + +* Device vs host execution + +Structure of a Kernel +--------------------- + +* SIMT model +* Blocks, grids, warps + + +Inherent Thread Model +^^^^^^^^^^^^^^^^^^^^^ + +Cooperative Groups Thread Model +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Mapping to Hardware +------------------- + +Memory Architecture +=================== + +Runtime API +=========== + +Sychronization and Asychronous Execution +---------------------------------------- + +Streams +------- + +Task Graphs +----------- + +Error Handling +-------------- + +Compiler Toolchain +================== \ No newline at end of file diff --git a/docs/programming-guide/index.rst b/docs/programming-guide/index.rst new file mode 100644 index 00000000..884a36c5 --- /dev/null +++ b/docs/programming-guide/index.rst @@ -0,0 +1,8 @@ +.. meta:: + :description: Progrmaming Guide for AMD Instinct™ + :keywords: AMD, Instinct, ROCm, HIP, GPU, Fortran, C++, OpenMP + +Programming Guide for AMD Instinct™ +*********************************** + +* :doc:`instinct-architecture` diff --git a/docs/programming-guide/instinct-architecture/index.rst b/docs/programming-guide/instinct-architecture/index.rst new file mode 100644 index 00000000..83b70c9a --- /dev/null +++ b/docs/programming-guide/instinct-architecture/index.rst @@ -0,0 +1,8 @@ +.. meta:: + :description: AMD Instinct Architecture + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, computer architecture + +**************************************************************** +AMD Instinct Architecture +**************************************************************** + diff --git a/docs/programming-guide/multinode/index.rst b/docs/programming-guide/multinode/index.rst new file mode 100644 index 00000000..9712bfb9 --- /dev/null +++ b/docs/programming-guide/multinode/index.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Multi-node and Multi-GPU programming with AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, multinode, multigpu, supercomputer + +**************************************************************** +Multi-node and Multi-GPU programming with AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/openmp-for-gpu.rst b/docs/programming-guide/openmp-for-gpu.rst new file mode 100644 index 00000000..6f9bc1ad --- /dev/null +++ b/docs/programming-guide/openmp-for-gpu.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: OpenMP for GPU Specification + :keywords: AMD, Instinct, ROCm, HIP, GPU, OpenMP + +**************************************************************** +OpenMP for GPU Specification +**************************************************************** diff --git a/docs/programming-guide/openmp.rst b/docs/programming-guide/openmp.rst new file mode 100644 index 00000000..9e60d353 --- /dev/null +++ b/docs/programming-guide/openmp.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: OpenMP Programming Manual for AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, Fortran, C++, OpenMP + +**************************************************************** +OpenMP Programming Manual for AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/optimization/index.rst b/docs/programming-guide/optimization/index.rst new file mode 100644 index 00000000..d659d47a --- /dev/null +++ b/docs/programming-guide/optimization/index.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Optimization Applications for AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, HPC, supercomputer, profiling, optimization + +**************************************************************** +Optimization Applications for AMD Instinct +**************************************************************** diff --git a/docs/programming-guide/profiler.rst b/docs/programming-guide/profiler.rst new file mode 100644 index 00000000..833e3912 --- /dev/null +++ b/docs/programming-guide/profiler.rst @@ -0,0 +1,7 @@ +.. meta:: + :description: Profiling Applications on AMD Instinct + :keywords: AMD, Instinct, ROCm, HIP, GPU, profiling + +**************************************************************** +Profiling Applications on AMD Instinct +****************************************************************