Jithin Jose (jithinjosepkl) · Sep 25, 2019 · Sep 9, 2019 · Sep 9, 2019 · Sep 9, 2019 · Sep 9, 2019
diff --git a/example/MPIHelloWorld.cpp b/example/MPIHelloWorld.cpp
@@ -0,0 +1,21 @@
+// A simple MPI code printing a message by each MPI rank
+
+#include <iostream>
+#include <mpi.h>
+
+
+int main()
+{
+	int my_rank;
+	int world_size;
+
+	MPI_Init(NULL, NULL);
+
+	MPI_Comm_size(MPI_COMM_WORLD, &world_size);
+	MPI_Comm_rank(MPI_COMM_WORLD, &my_rank);
+
+	std::cout << "Hello World from process " << my_rank << " out of " << world_size << " processes!!!" << std::endl;
+
+	MPI_Finalize();
+	return 0;
+}
diff --git a/example/Makefile b/example/Makefile
@@ -0,0 +1,19 @@
+ld=link
+cc=cl
+
+cflags=/I"C:\Program Files (x86)\Microsoft SDKs\MPI\Include"
+ldflags=/libpath:"C:\Program Files (x86)\Microsoft SDKs\MPI\Lib\x64"
+
+libs=msmpi.lib
+
+output=affinity.exe
+objs=affinity.obj
+
+all: $(objs)
+	$(ld) $(libs) $(ldflags) -out:$(output) $(objs)
+
+.cpp.obj:
+	$(cc) $(cflags) /c $*.cpp
+clean:
+	@del /Q $(objs)
+	@del /Q $(output)
diff --git a/example/Run_MPIHelloWorld.md b/example/Run_MPIHelloWorld.md
@@ -0,0 +1,35 @@
+## Compile and run a sample MPI code on Windows
+1. Download MS-MPI SDK and Redist installers and install them. The download link can be found on 
+our [homepage](https://docs.microsoft.com/en-us/message-passing-interface/microsoft-mpi)
+2. After installation, you can verify that the MS-MPI environment variables have been set (you will want to use these environment 
+variables in Visual Studio)
+![inline](./screenshots/set_msmpi.png)
+3. Open Visual Studio and create a Console App project. Let's name the project `MPIHelloWorld`
+4. Use [this](MPIHelloWorld.cpp) code in the newly created project
+5. Setup the include directories so that the compiler can find the MS-MPI header files. Note that we will be building 
+for 64 bits so we will point the include directory to `$(MSMPI_INC);$(MSMPI_INC)\x64`. If you will be building for 32 bits 
+please use `$(MSMPI_INC);$(MSMPI_INC)\x86`
+![inline](./screenshots/inc_dir.png)
+6. Setup the linker options. Add `msmpi.lib` to the Additional Dependencies and also add `$(MSMPI_LIB64)` to the Additional 
+Library Directories. Note that we will be building for 64 bits so we will point the Additional Library Directories to $(MSMPI_LIB64). 
+If you will be building for 32 bits please use `$(MSMPI_LIB32)`
+![inline](./screenshots/lib_dir.png)
+7. Build the MPIHelloWorld project
+![inline](./screenshots/vs_build.png)
+8. Test run the program on the command line
+![inline](./screenshots/mpiexec.png)
+
+Alternatively, you can use Developer Command Prompt for your version of Visual Studio to compile and link the `MPIHelloWorld.cpp` 
+code (replacing steps 3-7 above). To build a 64-bit application, choose x64 Native Tools Command Prompt from the Visual Studio folder 
+in the Start menu.
+![inline](./screenshots/x64_prompt.png)
+
+To compile your program into an `.obj` file, go to the folder where `MPIHelloWorld.cpp` exists and run (you may ignore the warning message):<br>
+`cl /I"C:\Program Files (x86)\Microsoft SDKs\MPI\Include" /c MPIHelloWorld.cpp`
+![inline](./screenshots/compile.png)
+
+To create an executable file from the .obj file created in the previous step, run:<br>
+`link /machine:x64 /out:MPIHelloWorld.exe "msmpi.lib" /libpath:"C:\Program Files (x86)\Microsoft SDKs\MPI\Lib\x64" MPIHelloWorld.obj`
+![inline](./screenshots/link.png)
+
+You may use the `nmake` command from Developer Command Prompt to compile and build the exmaple using the provided [`Makefile`](Makefile).
diff --git a/example/screenshots/compile.png b/example/screenshots/compile.png
diff --git a/example/screenshots/inc_dir.png b/example/screenshots/inc_dir.png
diff --git a/example/screenshots/lib_dir.png b/example/screenshots/lib_dir.png
diff --git a/example/screenshots/link.png b/example/screenshots/link.png
diff --git a/example/screenshots/mpiexec.png b/example/screenshots/mpiexec.png
diff --git a/example/screenshots/set_msmpi.png b/example/screenshots/set_msmpi.png
diff --git a/example/screenshots/vs_build.png b/example/screenshots/vs_build.png
diff --git a/example/screenshots/x64_prompt.png b/example/screenshots/x64_prompt.png