Add README

Author: IgorOchocki

DirectProgramming/C++SYCL/guided_cuRAND_examples_SYCL_migration/README.md

@@ -1,11 +1,11 @@
-# `cuBLAS Migration` Sample
+# `cuRAND Migration` Sample
 
-The `cuBLAS Migration` sample is a collection of code samples that demonstrate the cuBLAS equivalent in Intel® oneAPI Math Kernel Library (oneMKL). 
+The `cuRAND Migration` sample is a collection of code samples that demonstrate the cuBLAS equivalent in Intel® oneAPI Math Kernel Library (oneMKL). 
 
 | Area                   | Description
 |:---                    |:---
 | What you will learn    | How to begin migrating CUDA code to a SYCL*-compliant equivalent
-| Time to complete       | 90 minutes
+| Time to complete       | 30 minutes
 | Category               | Code Optimization
 
 For more information on oneMKL and complete documentation of all oneMKL routines, see https://www.intel.com/content/www/us/en/developer/tools/oneapi/onemkl-documentation.html.
@@ -14,9 +14,9 @@ For more information on oneMKL and complete documentation of all oneMKL routines
 
 The samples source code using SYCL were migrated from CUDA source code for offloading computations to a GPU/CPU. The sample demonstrates how to migrate code to SYCL, optimize the migration steps, and improve processing time.
 
-Each of the cuBLAS samples source files shows the usage of oneMKL cuBLAS routines. All are basic programs containing the usage of a single function.
+Each of the cuRAND samples source files shows the usage of different oneMKL cuRAND routines. All are basic programs containing the usage of a single method of generating pseudorandom numbers.
 
->**Note**: This sample is based on the [*cuBLAS Library - APIs Examples*](https://github.com/NVIDIA/CUDALibrarySamples/tree/master/cuBLAS) samples in the NVIDIA/CUDALibrary GitHub repository.
+>**Note**: This sample is based on the [*cuRAND Library - APIs Examples*](https://github.com/NVIDIA/CUDALibrarySamples/tree/master/cuRAND) samples in the NVIDIA/CUDALibrary GitHub repository.
 
 ## Prerequisites
 
@@ -35,17 +35,13 @@ This sample contains two sets of sources in the following folders:
 | `01_sycl_dpct_output`   | Contains output of Intel® DPC++ Compatibility Tool used to migrate SYCL-compliant code from CUDA code. <br> This SYCL code has some unmigrated or incorrectly generated code that has to be manually fixed before it is functional. (The code does not work as supplied.)
 | `02_sycl_dpct_migrated` | Contains SYCL to CUDA migrated code generated by using the Intel® DPC++ Compatibility Tool with the manual changes implemented to make the code fully functional.
 
-These functions are classified into three levels of difficulty. There are **52** samples:
-
-- **14** Level 1 samples
-- **23** Level 2 samples
-- **15** Level 3 samples
+These functions are classified into eight different directories, each based on a RNG engine. There are **48** samples:
 
 ## Set Environment Variables
 
 When working with the command-line interface (CLI), you should configure the oneAPI toolkits using environment variables. Set up your CLI environment by sourcing the `setvars` script every time you open a new terminal window. This practice ensures that your compiler, libraries, and tools are ready for development.
 
-## Build the `cuBLAS Migration` Sample
+## Build the `cuRAND Migration` Sample
 
 > **Note**: If you have not already done so, set up your CLI
 > environment by sourcing  the `setvars` script in the root of your oneAPI installation.
@@ -80,18 +76,18 @@ make VERBOSE=1
 If you receive an error message, troubleshoot the problem using the **Diagnostics Utility for Intel® oneAPI Toolkits**. The diagnostic utility provides configuration and system checks to help find missing dependencies, permissions errors, and other issues. See the [Diagnostics Utility for Intel® oneAPI Toolkits User Guide](https://www.intel.com/content/www/us/en/develop/documentation/diagnostic-utility-user-guide/top.html) for more information on using the utility.
 
 
-## Run the `cuBLAS Migration` Sample
+## Run the `cuRAND Migration` Sample
 
 ### On Linux
 
 Run the programs on a CPU or GPU. Each sample uses a default device, which in most cases is a GPU.
 
 1. Run the samples in the `02_sycl_dpct_migrated` folder.
    ```
-   make run_amax
+   make run_mt19937_uniform
    ```
 
-### Build and Run the `cuBLAS Migration` Sample in Intel® DevCloud (Optional)
+### Build and Run the `cuRAND Migration` Sample in Intel® DevCloud (Optional)
 
 When running a sample in the Intel® DevCloud, you must specify the compute node (CPU, GPU, FPGA) and whether to run in batch or interactive mode. For more information, see the Intel® oneAPI Base Toolkit [Get Started Guide](https://devcloud.intel.com/oneapi/get_started/).
 
@@ -136,19 +132,42 @@ You can submit build and run jobs through a Portable Bash Script (PBS). A job is
 
 ## Example Output
 
-This is example output if you built the default and ran `run_amax`.
+This is example output if you built the default and ran `run_mt19937_uniform`.
 
 ```
-[  0%] Building CXX object 02_sycl_dpct_migrated/Level-1/CMakeFiles/amax.dir/amax.cpp.o
-[100%] Linking CXX executable amax
-[100%] Built target amax
-A
-1.00 2.00 3.00 4.00 
+Scanning dependencies of target mt19937_uniform
+[ 50%] Building CXX object 02_sycl_dpct_migrated/mt19937/CMakeFiles/mt19937_uniform.dir/mt19937_uniform.cpp.o
+[100%] Linking CXX executable ../../bin/mt19937_uniform
+[100%] Built target mt19937_uniform
+Host
+0.966454
+0.778166
+0.440733
+0.116851
+0.007491
+0.090644
+0.910976
+0.942535
+0.939269
+0.807002
+0.582228
+0.034926
 =====
-result
-4
+Device
+0.966454
+0.778166
+0.440733
+0.116851
+0.007491
+0.090644
+0.910976
+0.942535
+0.939269
+0.807002
+0.582228
+0.034926
 =====
-[100%] Built target run_amax
+[100%] Built target run_mt19937_uniform
 ```
 
 ## License