Add AMD GPU support, resized images and LICENSE file

Author: yanncaniouoracle

cloud-infrastructure/ai-infra-gpu/ai-infrastructure/opm-flow-gpu/README.md

@@ -26,9 +26,13 @@ Oracle Cloud Infrastructure offers GPU shapes for all kinds of workloads, includ
     - BM with 8 GPUs, NVLink and RDMA cluster networking
 - AMD MI300X 192GB
     - BM with 8 GPUs, HIP and RDMA cluster networking
-This tutorial covers NVIDIA GPU shapes only but can be easily adapted for AMD GPU shapes. A single A100 80 GB virtual machine (VM.GPU.A100.80GB.1) with a Cannonical Ubuntu 22.04 image is used.
 
-It is necessary to install the NVIDIA CUDA Compiler (NVCC) to build Flow:
+This tutorial covers both NVIDIA and AMD GPU shapes. More specifically, we use here:
+- A 1 x A100 80 GB virtual machine (VM.GPU.A100.80GB.1),
+- A 8 x MI300X 192 GB bare metal (BM.GPU.MI300X.8),
+both with a Cannonical Ubuntu 22.04 image with respectively CUDA and ROCm preinstaled. 
+
+On the NVIDIA GPU shapes, it is necessary to install the NVIDIA CUDA Compiler (NVCC) to build Flow:
 ```
 sudo apt-get install -y nvidia-cuda-toolkit
 ```
@@ -71,7 +75,7 @@ However, for `opm-simulators` it is necessary to turn off the `USE_GPU_BRIDGE` o
 ```
 git clone https://github.com/OPM/opm-simulators.git
 mkdir opm-simulators/build && cd opm-simulators/build
-cmake .. -DUSE_GPU_BRIDGE=OFF
+cmake .. -DUSE_GPU_BRIDGE=OFF # add the -DCONVERT_CUDA_TO_HIP=ON option for AMD GPUs
 make
 ```
 The following error might occur at the `make` stage:
@@ -134,7 +138,7 @@ Running the Flow simulator on one or more GPUs requires to use GPU-specific solv
     }
 }
 ```
-To run the simulation, open datasets are available [here](git clone https://github.com/OPM/opm-data.git). For example, to run the Norne use case, simply execute:
+To run the simulation, open datasets are available [here](https://github.com/OPM/opm-data.git). For example, to run the Norne use case, simply execute:
 ```
 /home/ubuntu/opm-simulators/build/bin/flow NORNE_ATW2013.DATA --output-dir=out_gpu --matrix-add-well-contributions=true --linear-solver=/home/ubuntu/gpu-solver.json
 ```
@@ -149,9 +153,18 @@ for N GPUs.
 Here are a few comments to take into account when considering running Flow on GPUs:
 * The options `--matrix-add-well-contributions=true` and `--threads-per-process=1` are recommended by OPM.
 * Because of the import CPU/GPU traffic, running Flow on GPU is only relevant for models above a certain size (few hundreds of thousands of cells).
-* Using a CUDA-aware version of Open MPI may improve the overall performance of the simulation.
+* Using a CUDA-aware or ROCm-aware version of Open MPI may improve the overall performance of the simulation.
 
 ## External Links
 
 * [The Open Porous Media Initiative](https://opm-project.org/)
-* [Building CUDA-aware Open MPI](https://www.open-mpi.org/faq/?category=buildcuda)
+* [The Best Public Cloud for Oil and Gas Reservoir Simulation](https://blogs.oracle.com/cloud-infrastructure/post/the-best-public-cloud-for-oil-and-gas-reservoir-simulation)
+* [Building CUDA-aware Open MPI](https://www.open-mpi.org/faq/?category=buildcuda)
+
+## License
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/ai-infra-gpu/ai-infrastructure/opm-flow-gpu/assets/images/OPM-Flow.png

@@ -0,0 +1,35 @@
+Copyright (c) 2024 Oracle and/or its affiliates.
+ 
+The Universal Permissive License (UPL), Version 1.0
+ 
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+ 
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+ 
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+ 
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloud-infrastructure/ai-infra-gpu/ai-infrastructure/opm-flow-gpu/assets/images/SLEIPNER_ORG_3D_View_SGAS_170_01_Dec_2010_FILTER.png

@@ -11,27 +11,12 @@ done
 
 git clone https://github.com/OPM/opm-simulators.git
 mkdir opm-simulators/build && cd opm-simulators/build
-cmake .. -DUSE_GPU_BRIDGE=OFF
+cmake .. -DUSE_GPU_BRIDGE=OFF # add the -DCONVERT_CUDA_TO_HIP=ON option for AMD GPUs
 make -j 8
 cd ../..
 
 git clone https://github.com/OPM/opm-upscaling.git
 mkdir opm-upscaling/build && cd opm-upscaling/build
 cmake ..
 make -j 8
-cd ../..
-
-
-
-/usr/include/c++/11/bits/std_function.h:435:145: error: parameter packs not expanded with ‘...’:
-  435 |         function(_Functor&& __f)
-      |                                                                                                                                                 ^
-/usr/include/c++/11/bits/std_function.h:435:145: note:         ‘_ArgTypes’
-/usr/include/c++/11/bits/std_function.h:530:146: error: parameter packs not expanded with ‘...’:
-  530 |         operator=(_Functor&& __f)
-      |                                                                                                                                                  ^
-/usr/include/c++/11/bits/std_function.h:530:146: note:         ‘_ArgTypes’
-make[2]: *** [CMakeFiles/opmsimulators.dir/build.make:2680: CMakeFiles/opmsimulators.dir/opm/simulators/linalg/gpuistl/detail/vector_operations.cu.o] Error 1
-make[2]: *** Waiting for unfinished jobs....
-make[1]: *** [CMakeFiles/Makefile2:530: CMakeFiles/opmsimulators.dir/all] Error 2
-make: *** [Makefile:146: all] Error 2
+cd ../..