From 7037335bff215496930b0698a9e3661d51a1b522 Mon Sep 17 00:00:00 2001
From: Anthony Scemama <scemama@irsamc.ups-tlse.fr>
Date: Sat, 20 Nov 2021 23:19:20 +0100
Subject: [PATCH] Starting MPI

---
 parallelism_scemama.org | 377 +++++++++++++++++++++++++++++++++++++++-
 socket.png              | Bin 0 -> 28969 bytes
 2 files changed, 372 insertions(+), 5 deletions(-)
 create mode 100644 socket.png

diff --git a/parallelism_scemama.org b/parallelism_scemama.org
index dcf03a7..a559ed2 100644
--- a/parallelism_scemama.org
+++ b/parallelism_scemama.org
@@ -17,6 +17,7 @@
 #+LaTeX_HEADER: \definecolor{darkblue}{rgb}{0.,0.2,0.7}
 #+LaTeX_HEADER: \definecolor{darkred}{rgb}{0.6,0.1,0.1}
 #+LaTeX_HEADER: \definecolor{darkpink}{rgb}{0.7,0.0,0.7}
+#+PROPERTY: header-args  :exports code
 #+EXPORT_EXCLUDE_TAGS: noexport
 
 #+startup: beamer
@@ -645,7 +646,7 @@ user  0m3.359s
 sys   0m3.172s
    #+end_src
    
-* Inter-process communication
+* Inter-process communication                                      :noexport:
 
 ** Processes /vs/ threads
 
@@ -862,9 +863,10 @@ if __name__ == "__main__":
    #+ATTR_LATEX: :height 0.6\textheight
      [[./pi_convergence.png]]
 
-** Computation of $\pi$ with pipes in Python
+** Computation of \pi with pipes in Python
 
    #+begin_src python :tangle Codes/pi_python.py
+#!/usr/bin/env python
 import os, sys
 from random import random, seed
 from math import sqrt
@@ -885,7 +887,7 @@ def compute_pi():
    return 4.* float(result)/float(NMAX) # Estimate of pi
    #+end_src
 
-** Computation of $\pi$ with pipes in Python
+** Computation of \pi with pipes in Python
 
    #+begin_src python :tangle Codes/pi_python.py
 def main():
@@ -911,7 +913,7 @@ def main():
                sys.exit(0)
    #+end_src 
 
-** Computation of $\pi$ with pipes in Python
+** Computation of \pi with pipes in Python
 
    #+begin_src python :tangle Codes/pi_python.py
    data = []
@@ -926,7 +928,7 @@ def main():
            else:
                variance = 0.
            error = sqrt(variance)/sqrt(N)    # Compute error
-           print(f"%{average} +/- %{error}  %{N}")
+           print("%f +/- %f %d"%(average, error, N))
 
            if N > 2 and error < error_threshold:  # Stopping condition
                for i in range(NPROC):             # Kill all children
@@ -937,8 +939,372 @@ def main():
 if __name__ == '__main__':  main()
    #+end_src 
 
+** Computation of \pi with pipes in Python
+
+   #+begin_src text
+$ python pi_python.py 
+3.141974 +/- 0.000000 1
+3.142569 +/- 0.000000 2
+3.142168 +/- 0.000528 3
+3.141938 +/- 0.000439 4
+3.141947 +/- 0.000340 5
+[...]
+3.141625 +/- 0.000107 33
+3.141614 +/- 0.000104 34
+3.141617 +/- 0.000101 35
+3.141606 +/- 0.000099 36
+   #+end_src
+
+** Sockets
+
+   Sockets are analogous to pipes, but they allow both ends of the pipe to be
+   on different machines connected by a network interface.
+   An Internet socket is characterized by a unique combination of:
+
+   - A transport protocol: TCP, UDP, raw IP, ...
+   - A local socket address: Local IP address and port number, for example 192.168.2.2:22
+   - A remote socket address: Optional (TCP)
+
+** Sockets
+
+   #+ATTR_LATEX: :height 0.9\textheight
+   [[./socket.png]]
+
+** Sockets: server code in Python
+
+   #+begin_src python :tangle Codes/socket_server.py
+#!/usr/bin/env python                                                                         
+
+import sys, os, socket, datetime
+now = datetime.datetime.now
+
+def main():
+   HOSTNAME = socket.gethostname()
+   PORT     = 11279
+   print(now(), "I am the server : %s:%d"%(HOSTNAME,PORT))
+   
+   s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)  # Create an INET socket
+   s.bind( (HOSTNAME, PORT) )           # Bind the socket to the address and port
+   s.listen(5)                          # Wait for incoming connections
+   conn, addr = s.accept()              # Accept connection
+   print(now(), "Connected by", addr)
+   
+  #+end_src
+  
+** Sockets: server code in Python
+
+   #+begin_src python :tangle Codes/socket_server.py
+   data = ""
+   while True:                          # Buffered read of the socket
+       message = conn.recv(8).decode('utf-8')
+       print(now(), "Buffer : "+message)
+       data += message
+       if len(message) < 8:  break
+   print(now(), "Received data : ", data)
+
+   print(now(), "Sending thank you...")
+   conn.send("Thank you".encode())
+   conn.close()
+
+if __name__ == "__main__":
+    main()
+   #+end_src
+
+** Sockets: client code in Python
+   
+   #+begin_src python :tangle Codes/socket_client.py
+#!/usr/bin/env python                                                                         
+import sys, os, socket, datetime
+now = datetime.datetime.now
+
+def main():
+   HOSTNAME = sys.argv[1]         # Get host name from command line
+   PORT     = int(sys.argv[2])    # Get port from command line
+   print(now(), "The target server is : %s:%d"%(HOSTNAME,PORT))
+   
+   s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)  # Create an INET socket
+   s.connect( (HOSTNAME, PORT) )  # Connect the socket to the address and port
+   # of the server
+   message = "Hello, world!!!!!!!"
+   print(now(), "Sending : "+message)
+   s.send(message.encode())  # Send the data
+   
+   data = s.recv(1024)  # Read the reply of the server
+   s.close()
+   print(now(), 'Received: ', data.decode('utf-8'))
+   
+if __name__ == "__main__": main()
+   #+end_src
+   
+** Sockets: Execution
+
+  #+begin_src text
+$ python Codes/socket_client.py lpqdh82 11279
+2021-11-20 21:20:32.258632 The target server is : lpqdh82:11279
+2021-11-20 21:20:32.258959 Sending : Hello, world!!!!!!!
+2021-11-20 21:20:32.259042 Connected by ('127.0.0.1', 36798)
+2021-11-20 21:20:32.259068 Buffer : Hello, w
+2021-11-20 21:20:32.259076 Buffer : orld!!!!
+2021-11-20 21:20:32.259083 Buffer : !!!
+2021-11-20 21:20:32.259088 Received data :  Hello, world!!!!!!!
+2021-11-20 21:20:32.259093 Sending thank you...
+2021-11-20 21:20:32.259133 Received:  Thank you
+  #+end_src
+
+  Note that the client and server can be written in different languages.
+
+** Server for \pi with sockets in Python
+
+   #+begin_src python :tangle Codes/pi_server_python.py
+#!/usr/bin/env python
+import sys, os,  socket
+from math import sqrt
+HOSTNAME = "localhost"
+PORT     = 1666
+error_threshold = 1.e-4   # Stopping criterion
+
+def main():
+   data = []
+   s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)  # Create an INET socket
+   s.bind( (HOSTNAME, PORT) )  # Bind the socket to the address and port
+   while True:
+      s.listen(5)                # Wait for incoming connections
+      conn, addr = s.accept()    # Accept connection
+      X = ""
+      while True:                # Buffered read of the socket
+         message = conn.recv(128)
+         X += message.decode('utf-8')
+         if len(message) < 128: break
+      data.append( float(X) )
+      N = len(data)
+   #+end_src
+
+** Server for \pi with sockets in Python
+
+   #+begin_src python :tangle Codes/pi_server_python.py
+      average = sum(data)/N      # Compute average
+      if N > 2:                  # Compute variance
+         l = [ (x-average)*(x-average) for x in data ]
+         variance = sum(l)/(N-1.)
+      else:
+         variance = 0.
+      error = sqrt(variance)/sqrt(N)    # Compute error
+
+      print('%f +/- %f'%(average,error))
+
+      # Stopping condition
+      if N > 2 and error < error_threshold:
+         conn.send("STOP".encode())
+         break
+      else:
+         conn.send("OK".encode())
+   conn.close()
+
+if __name__ == "__main__":
+   main()
+   #+end_src
+
+** Client for \pi with sockets in Python
+
+   #+begin_src python :tangle Codes/pi_client_python.py
+#!/usr/bin/env python
+import os, sys, socket
+from random import random, seed
+from math import sqrt
+HOSTNAME = "localhost"
+PORT     = 1666
+NMAX     = 10000000        # Nb of MC steps/process
+error_threshold = 1.0e-4   # Stopping criterion 
+NPROC=4                    # Use 4 processes
+
+def compute_pi():
+   """Local Monte Carlo calculation of pi"""
+   seed(None)  # Initialize random number generator
+   
+   result = 0.
+   for i in range(NMAX):         # Loop NMAX times
+      x,y = random(), random()   # Draw 2 random numbers x and y
+      if x*x + y*y <= 1.:        # Check if (x,y) is in the circle
+         result += 1
+   return 4.* float(result)/float(NMAX) # Estimate of pi
+   #+end_src 
+
+** Client for \pi with sockets in Python
+   
+   #+begin_src python :tangle Codes/pi_client_python.py
+def main():
+
+   while True:
+      X = compute_pi()
+      s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)    # Create an INET socket
+      try:     # Connect the socket to the address and port of the server
+         s.connect( (HOSTNAME, PORT) )
+      except socket.error:
+         break
+      message = str(X)
+      s.send(message.encode())              # Send the data
+      reply = s.recv(128).decode('utf-8')   # Read the reply of the server
+      s.close()
+    
+      if reply == "STOP": break
+
+if __name__ == '__main__':
+  main()
+
+   #+end_src 
+
+** Execution of \pi with sockets in Python
+
+   #+begin_src text
+$ python pi_server_python.py &
+> for i in {1..8} ; do
+>     python pi_client_python.py &
+> done ; wait
+
+3.142136 +/- 0.000000
+3.141783 +/- 0.000000
+3.141992 +/- 0.000291
+3.141804 +/- 0.000279
+[...]
+3.141687 +/- 0.000104
+3.141666 +/- 0.000102
+3.141651 +/- 0.000098
+
+   #+end_src
+
+
 * Message Passing Interface (MPI)
 
+** Message Passing Interface
+
+   - Application Programming Interface for inter-process communication
+   - Takes advantage of HPC hardware:
+     - TCP/IP: 50 $\mu \text{s}$ latency
+     - Remote Direct Memory Access (RDMA): <2 $\mu \text{s}$
+        (low-latency network)
+   - Portable
+   - Each vendor has its own implementation adapted to the hardware
+   - Standard in HPC
+   - Initially designed for fixed number of processes:
+     - No problem for the discovery of peers
+     - Fast collective communications
+   - Single Program Multiple Data (SPMD) paradigm
+   
+** Communicators
+
+   - Group of processes that can communicate together
+   - Each process has an ID in the communicator: no need for IP
+     adresses and port numbers
+   - ~MPI_COMM_WORLD~: Global communicator, default
+   - ~size~: number of processes in the communicator
+   - ~rank~: ID of the process in the communicator
+
+** Point-to-point communication
+   
+*** Python
+    - Send: 
+      ~comm.send(data, dest, tag)~
+    - Receive: 
+      ~comm.recv(source, tag)~
+*** Fortran
+    - Send: 
+      ~MPI_SEND(buffer, count, datatype, destination, tag, communicator, ierror)~
+    - Receive: 
+      ~MPI_RECV(buffer, count, datatype, source, tag, communicator,
+      status, ierror)~
+** Point-to-point communication (Python)
+
+   #+begin_src python  :tangle Codes/mpi_rank.py
+from mpi4py import MPI
+
+def main():
+    comm = MPI.COMM_WORLD
+    rank = comm.Get_rank()
+    size = comm.Get_size()
+
+    if rank == 0:
+        data = 42
+        print("Before: Rank: %d    Size: %d    Data: %d"%(rank, size, data))
+        comm.send(data, dest=1, tag=11)
+        print("After : Rank: %d    Size: %d    Data: %d"%(rank, size, data))
+    elif rank == 1:
+        data = 0
+        print("Before: Rank: %d    Size: %d    Data: %d"%(rank, size, data))
+        data = comm.recv(source=0, tag=11)
+        print("After : Rank: %d    Size: %d    Data: %d"%(rank, size, data))
+
+if __name__ == "__main__": main()        
+   #+end_src
+
+** Point-to-point communication (Python)
+
+   #+begin_src text
+$ mpiexec -n 4 python mpi_rank.py 
+Before: Rank: 0    Size: 4    Data: 42
+Before: Rank: 1    Size: 4    Data: 0
+After : Rank: 0    Size: 4    Data: 42
+After : Rank: 1    Size: 4    Data: 42
+   #+end_src
+
+   In Fortran, compile using =mpif90= and execute using =mpiexec= (or =mpirun=).
+
+** Point-to-point communication (Fortran)
+
+   #+begin_src fortran :tangle Codes/mpi_rank.f90
+program test_rank
+      use mpi
+      implicit none
+      integer :: rank, size, data, ierr, status(mpi_status_size)
+
+      call MPI_INIT(ierr)      ! Initialize library (required)
+      if (ierr /= MPI_SUCCESS) then
+         call MPI_ABORT(MPI_COMM_WORLD, 1, ierr)
+      end if
+      
+      call MPI_COMM_SIZE(MPI_COMM_WORLD, size, ierr)
+      if (ierr /= MPI_SUCCESS) then
+         call MPI_ABORT(MPI_COMM_WORLD, 2, ierr)
+      end if
+
+      call MPI_COMM_RANK(MPI_COMM_WORLD, rank, ierr)
+      if (ierr /= MPI_SUCCESS) then
+         call MPI_ABORT(MPI_COMM_WORLD, 3, ierr)
+      end if
+   #+end_src
+
+** Point-to-point communication (Fortran)
+
+   #+begin_src fortran :tangle Codes/mpi_rank.f90
+    if (rank == 0) then
+        data = 42
+        print *, "Before: Rank:", rank, "Size:", size, "Data: ", data
+        call MPI_SEND(data, 1, MPI_INTEGER, 1, 11, MPI_COMM_WORLD, ierr)
+        print *, "After : Rank:", rank, "Size:", size, "Data: ", data
+
+    else if (rank == 1) then
+        data = 0
+        print *, "Before: Rank:", rank, "Size:", size, "Data: ", data
+        call MPI_RECV(data, 1, MPI_INTEGER, 0, 11, MPI_COMM_WORLD, &
+                      status, ierr)
+        print *, "After : Rank:", rank, "Size:", size, "Data: ", data
+
+    end if
+    call MPI_FINALIZE(ierr)      ! De-initialize library (required)
+end program
+   #+end_src
+
+** Collective communications
+
+*** One-to-all
+    - Broadcast: send same data to all
+    - Scatter: distribute an array
+*** All-to-one
+    - Reduction: Sum/product/... of data coming from all ranks
+    - Gather: collect a distributed array
+*** All-to-all
+    - Reduction and broadcast
+
+** Deadlocks
 * OpenMP
 
 * Exercises
@@ -1246,3 +1612,4 @@ digraph G {
 
   #+RESULTS:
   : /home/scemama/MEGA/TEX/Cours/TCCM/TCCM2022/Parallelism/parallelism_scemama.pdf
+  
diff --git a/socket.png b/socket.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea26cc3870af1163e043ff6422da493df8a6b408
GIT binary patch
literal 28969
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%0DlLO_#=VDkI8&NF-GCUk)W<|
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

literal 0
HcmV?d00001