cran / rhpc Goto Github PK

!!! This package require MPI Library. !!!

<<build>>
   OpenMPI or MPICH2
       R CMD INSTALL Rhpc_0.yy-yday.tar.gz

   other MPI *nix.
       R CMD INSTALL Rhpc_0.yy-yday.tar.gz \
          --configure-args='--with-mpi-cflags=-I/opt/FJSVplang/include64/mpi/fujitsu \
                            --with-mpi-ldflags="-lmpi_f -lfjgmp64 -L/opt/FJSVpnple/lib -ljrm -L/opt/FJSVpnidt/lib -lfjidt -L/opt/FJSVplang/lib64 -lfj90i -lfj90f -lelf -lm -lpthread -lrt -ldl"'
       
   MS-MPI for Windows
       require set MSMPI environment variable

       c.f. Default install MS-MPI v6
       C:\Users\boofoo>set MSMPI
       MSMPI_INC=C:\Program Files (x86)\Microsoft SDKs\MPI\Include\
       MSMPI_LIB32=C:\Program Files (x86)\Microsoft SDKs\MPI\Lib\x86\
       MSMPI_LIB64=C:\Program Files (x86)\Microsoft SDKs\MPI\Lib\x64\

<<program launch>>

  <*nix OS's>
   Generated in the package top directory, please use the Rhpc shell.

   ex.
     $ mpirun -n 4 ~/R/x86_64-unknown-linux-gnu-library/3.2/Rhpc/Rhpc CMD BATCH -q --no-save test.R

   MPI_Comm_Spawn if available,
   ex.
     $ R -q
     > library(Rhpc)
     > Rhpc_initialize()
     > cl<-Rhpc_getHandle(4)    # set number of workers
     > Rhpc_worker_call(cl,Sys.getpid)
     [[1]]
     [1] 10571
     
     [[2]]
     [1] 10572
     
     [[3]]
     [1] 10573
     
     [[4]]
     [1] 10574
     
     > Rhpc_finalize()
     > q("no")
   

  <MS-Windows>
     please get and install MS-MPI
     http://www.microsoft.com/en-us/download/details.aspx?id=47259

   * Cheaty usage:D
     We have upgraded the package Rhpc, especially for Windows OS. In the
     former Windows MPI version, batch process using mpiexec was required
     for execusion. Recently, MS-MPI supports MPI_Comm_Spawn.
     However, we still need to execute master process by mpiexec.
     So we make a program fakemaster which enables to execute mpiexec
     in the background and extract environments in MPI and pass them
     to original R process, then it performs MPI_Init.
     This is very tricky but it works, and make it possible to execute
     MPI from RGui and Rstudio.
     Caution that mpiexec and fakemaster start command line console
     windows, which should not be stopped during execution.
     If you hope to perform MPI on several machines, msmpilauchsvc is
     required, but we did not test it sufficiently.
     Arguments of mpiexec can be specified such as
          options(Rhpc.mpiexec="mpiexec -n 1")
     and it adds fakemaster at the end of mpiexec command like
          "mpiexec -n 1 fakemaster"
     when Rhpc_initialize.
     There seems to be no way to activate processes of other nodes
     at MPI_Comm_spawn on MS-MPI v9.01.
     (only single node MPI-Comm-spawn on MS-MPI v 9.01)

     ex. launch Rgui,Rstudio or Rterm
     follow input
     > library(Rhpc)
     > Rhpc_initialize()
     > cl<-Rhpc_getHandle(3)
     > Rhpc_worker_call(cl,Sys.getpid)
     > Rhpc_finalize()
     > q("no")


    * Traditional usage (Really hard to use...)

     Installed in the package top directory, please look and use the Rhpc*.cmd shell.
     R_home reference from registry.

     ex. launch Rgui(x64)
       Click %USERPROFILE%\Documents\R\win-binary\3.2\Rhpc\RhpcWin64.cmd
     follow input 
     > library(Rhpc)
     > Rhpc_initialize()
     > cl<-Rhpc_getHandle()
     > Rhpc_worker_call(cl,Sys.getpid)
     > Rhpc_finalize()
     > q("no")
     
     ex. launch batch(x64)
     C:> %USERPROFILE%\Documents\R\win-binary\3.2\Rhpc\Rhpc64.cmd BATCH test.R