diff --git a/projects/hip/.gitignore b/projects/hip/.gitignore index ffb0b5f8c0..7a7d7f63db 100644 --- a/projects/hip/.gitignore +++ b/projects/hip/.gitignore @@ -1,6 +1,8 @@ .* !.gitignore +!..markdownlint-cli2.yaml !.spellcheck.local.yaml +!.wordlist.txt *.o *.exe *.swp diff --git a/projects/hip/.readthedocs.yaml b/projects/hip/.readthedocs.yaml index 76f837ede8..38feb90748 100644 --- a/projects/hip/.readthedocs.yaml +++ b/projects/hip/.readthedocs.yaml @@ -22,12 +22,3 @@ build: apt_packages: - "gfortran" # For pre-processing fortran sources - "graphviz" # For dot graphs in doxygen - jobs: - post_checkout: - - if [ -d ../clr ]; then rm -rf ../clr; fi - - if [ -d ../ROCR-Runtime ]; then rm -rf ../ROCR-Runtime; fi - - git clone --depth=1 --single-branch --branch docs/develop https://github.com/ROCm/clr.git ../clr - - git clone --depth=1 --single-branch --branch master https://github.com/ROCm/ROCR-Runtime.git ../ROCR-Runtime - post_build: - - rm -rf ../clr - - rm -rf ../ROCR-Runtime diff --git a/projects/hip/.wordlist.txt b/projects/hip/.wordlist.txt index c19f407f1d..ab60553039 100644 --- a/projects/hip/.wordlist.txt +++ b/projects/hip/.wordlist.txt @@ -1,15 +1,19 @@ .hip_fatbin ALU ALUs +amd +amdclang AmgX APU APUs AQL AXPY asm +async Asynchronicity Asynchrony asynchrony +backproject backtrace bfloat Bitcode @@ -17,6 +21,7 @@ bitcode bitcodes blockDim blockIdx +bp builtins Builtins CAS @@ -32,13 +37,16 @@ cuda cuDNN cuModule dataflow +DCMAKE deallocate decompositions +dedent denormal Dereferencing DFT dll DirectX +DOI DPP dst EIGEN @@ -52,6 +60,9 @@ embeded extern fatbin fatbinary +FDK +FeDK +Feldkamp foundationally framebuffer frontends @@ -59,6 +70,7 @@ fnuz FNUZ fp gedit +GiB GPGPU gridDim GROMACS @@ -82,6 +94,7 @@ IILE iGPU inlined inplace +interdependencies interop interoperation interoperate @@ -94,12 +107,15 @@ IPC IPs isa iteratively +Kress Lapack latencies libc +libTIFF libstdc lifecycle linearizing +literalinclude LOC LUID ltrace @@ -125,11 +141,13 @@ ns Nsight ocp omnitrace +outDir overindex overindexing oversubscription overutilized parallelizable +pftrace pipelining parallelized pixelated @@ -139,6 +157,7 @@ preconditioners predefining prefetched preprocessor +proj printf profilers PTX @@ -149,6 +168,7 @@ quad representable RMW rocgdb +rocprofv rocTX roundtrip rst @@ -159,6 +179,8 @@ SAXPY scalarizing sceneries shaders +ShLo +Shepp SIMT sinewave sinf @@ -183,9 +205,11 @@ uncoalesced unmap unmapped unmapping +unnormalized unregister upscaled variadic +voxel vulkan warpSize WinGDB diff --git a/projects/hip/docs/data/tutorial/graph_api/capture_trace.png b/projects/hip/docs/data/tutorial/graph_api/capture_trace.png new file mode 100644 index 0000000000..6ee320e323 Binary files /dev/null and b/projects/hip/docs/data/tutorial/graph_api/capture_trace.png differ diff --git a/projects/hip/docs/data/tutorial/graph_api/creation_trace.png b/projects/hip/docs/data/tutorial/graph_api/creation_trace.png new file mode 100644 index 0000000000..db94271838 Binary files /dev/null and b/projects/hip/docs/data/tutorial/graph_api/creation_trace.png differ diff --git a/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.drawio b/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.drawio new file mode 100644 index 0000000000..49ff6261a9 --- /dev/null +++ b/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.drawio @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.png b/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.png new file mode 100644 index 0000000000..1537299ed6 Binary files /dev/null and b/projects/hip/docs/data/tutorial/graph_api/ct_reconstruction_overview.png differ diff --git a/projects/hip/docs/data/tutorial/graph_api/diamond.drawio b/projects/hip/docs/data/tutorial/graph_api/diamond.drawio new file mode 100644 index 0000000000..203efb02ce --- /dev/null +++ b/projects/hip/docs/data/tutorial/graph_api/diamond.drawio @@ -0,0 +1,46 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/projects/hip/docs/data/tutorial/graph_api/diamond.svg b/projects/hip/docs/data/tutorial/graph_api/diamond.svg new file mode 100644 index 0000000000..4c648ac7c9 --- /dev/null +++ b/projects/hip/docs/data/tutorial/graph_api/diamond.svg @@ -0,0 +1,4 @@ + + + +
A
B
C
D
 \ No newline at end of file diff --git a/projects/hip/docs/data/tutorial/graph_api/streams_trace.png b/projects/hip/docs/data/tutorial/graph_api/streams_trace.png new file mode 100644 index 0000000000..7dc56f3333 Binary files /dev/null and b/projects/hip/docs/data/tutorial/graph_api/streams_trace.png differ diff --git a/projects/hip/docs/doxygen/Doxyfile b/projects/hip/docs/doxygen/Doxyfile index fb4eaae2de..6022eb70cd 100644 --- a/projects/hip/docs/doxygen/Doxyfile +++ b/projects/hip/docs/doxygen/Doxyfile @@ -834,7 +834,7 @@ INPUT = ../../include/hip \ ../../../clr/hipamd/include/hip/amd_detail/amd_hip_gl_interop.h \ ../../../clr/hipamd/include/hip/amd_detail/amd_surface_functions.h \ ../../../clr/hipamd/include/hip/amd_detail/amd_hip_cooperative_groups.h \ - ../../../ROCR-Runtime/src/inc/hsa_ext_amd.h + ../../../rocr-runtime/src/inc/hsa_ext_amd.h # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses @@ -1230,7 +1230,7 @@ HTML_FOOTER = ../_doxygen/footer.html # obsolete. # This tag requires that the tag GENERATE_HTML is set to YES. -HTML_STYLESHEET = ../_doxygen/stylesheet.css +HTML_STYLESHEET = # The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined # cascading style sheets that are included after the standard style sheets diff --git a/projects/hip/docs/environment.yml b/projects/hip/docs/environment.yml index a3dbd898d7..15080a11c5 100644 --- a/projects/hip/docs/environment.yml +++ b/projects/hip/docs/environment.yml @@ -7,4 +7,4 @@ dependencies: - pip - doxygen=1.9.8 - pip: - - -r ./sphinx/requirements.txt + - -r ./docs/sphinx/requirements.txt