This is the first major commit toward releasing the ParaMonte 2 C, C+…

…+, Fortran library.

.gitattributes

@@ -0,0 +1,55 @@
+# Handle line endings automatically for files detected as text
+# and leave all files detected as binary untouched.
+* text=auto
+
+#
+# The above will handle all files NOT found below
+#
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           eol=lf
+*.df            eol=lf
+*.htm           eol=lf
+*.html          eol=lf
+*.java          eol=lf
+*.js            eol=lf
+*.json          eol=lf
+*.jsp           eol=lf
+*.jspf          eol=lf
+*.jspx          eol=lf
+*.properties    eol=lf
+*.sh            eol=lf
+*.tld           eol=lf
+*.txt           eol=lf
+*.tag           eol=lf
+*.tagx          eol=lf
+*.xml           eol=lf
+*.yml           eol=lf
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.gif           binary
+*.ico           binary
+*.jar           binary
+*.jpg           binary
+*.jpeg          binary
+*.png           binary
+*.so            binary
+*.war           binary
+
+# Prevent development files from making it into the release archives
+*.enc export-ignore
+.github export-ignore
+.gitignore export-ignore
+.travis.yml export-ignore
+.Dockerfiles export-ignore
+.gitattributes export-ignore
+.pullapprove.yml export-ignore
+**/.travis/* export-ignore
+**/pubs/* export-ignore
+codecov.yml export-ignore
+
+# override github-liguist's automatic detection of m-files as M code.
+*.m linguist-language=MATLAB

.gitignore

@@ -112,25 +112,26 @@ Thumbs.db
 #########################
 
 *.mex*
-src/interface/MATLAB/paramonte/vis/colornames/htm/*
+src/matlab/paramonte/vis/colornames/htm/*
 
 #########################
 # ParaMonte temp folders
 #########################
 
-**/src/kernel/ParaMonte_mod@version@kernel.inc.f90
-**/getCompilerVersion.f90
-**/paramonte-kernel-doc
+**/pm_paramonte@version.inc.F90
+#**/getCompilerVersion.F90
+**/doc/fortran
 **/.ipynb_checkpoints
 **/paramonte-codecov
-**/paramonte-julia
-**/paramonte-doc
-**/paramontex
-**/benchmark
+**/src/matlab/main
+**/src/matlab/test
+**/src/python/main
+**/src/python/test
 **/codecov
 **/build
-**/trash
+#**/trash
 **/temp
+**/bld
 **/bin
 **/R
 **/___*___
@@ -197,7 +198,7 @@ _deps
 # documentation
 #########################
 
-**/paramonte-kernel-doc/*
+**/external/fortran/*
 **/devscripts/*
 **/draft/*
 **/doc/*

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "OpenBLAS"]
+	path = OpenBLAS
+	url = [email protected]:xianyi/OpenBLAS.git
+[submodule "external/paramonted"]
+	path = external/paramonted
+	url = https://github.com/cdslaborg/paramonted

.travis.yml

@@ -4,6 +4,13 @@ sudo: true
 branches:
   only:
     - main
+    #- master
+    #- revive
+    #- archive
+    #- ParaDISE
+    #- ParaTemp
+    #- ParaNest
+    #- dev
 
 before_cache:
   - if [ "${TRAVIS_OS_NAME}" = "osx" ]; then brew cleanup; fi
@@ -53,13 +60,13 @@ matrix:
 #        - MPI_LIB_DIR="${MPI_BIN_DIR}/../lib"
 #        - PATH="${MPI_BIN_DIR}:${PATH}"
 #        - export LD_LIBRARY_PATH="${MPI_LIB_DIR}:${LD_LIBRARY_PATH}"
-#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_c_linux_x64_gnu_release_shared_heap_openmpi.tar.gz"
-#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_cpp_linux_x64_gnu_release_shared_heap_openmpi.tar.gz"
-#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_fortran_linux_x64_gnu_release_shared_heap_openmpi.tar.gz"
+#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_c_linux_amd64_gnu_release_shared_heap_openmpi.tar.gz"
+#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_cpp_linux_amd64_gnu_release_shared_heap_openmpi.tar.gz"
+#        - "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_fortran_linux_amd64_gnu_release_shared_heap_openmpi.tar.gz"
 #        - ls libparamonte*.tar.gz* | xargs -i tar xvzf {}
-#        - cd libparamonte_c_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
-#        - cd libparamonte_cpp_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
-#        - cd libparamonte_fortran_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
+#        - cd libparamonte_c_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
+#        - cd libparamonte_cpp_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
+#        - cd libparamonte_fortran_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2 && cd ..
 
     ################################################################################################################################
     ####  linux test latest MPICH release
@@ -89,19 +96,20 @@ matrix:
         - MPIEXEC_PATH="$(dpkg -L mpich | egrep bin/mpiexec.mpich)"
         - MPI_BIN_DIR="$(dirname "${MPIEXEC_PATH}")"
         - PATH="${MPI_BIN_DIR}:${PATH}"
+        - ulimit -s unlimited
         #- sudo apt install python3-pip
         #- pip3 install --user --upgrade numpy
         #- pip3 install --user --upgrade pandas
         - cd "${pmAuxilDir}" && ./testRelease.sh --par "none mpich" --build "debug release" --lang "c cpp"
         - cd "${pmAuxilDir}" && ./testRelease.sh --par "none" --build "debug release" --lang "fortran" -s intel
         #- cd "${pmAuxilDir}" && ./testRelease.sh --par "none" --build "debug release" --lang "fortran" -s gnu
-        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_c_linux_x64_gnu_release_shared_heap_mpich.tar.gz"
-        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_cpp_linux_x64_gnu_release_shared_heap_mpich.tar.gz"
-        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_fortran_linux_x64_gnu_release_shared_heap_mpich.tar.gz"
+        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_c_linux_amd64_gnu_release_shared_heap_mpich.tar.gz"
+        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_cpp_linux_amd64_gnu_release_shared_heap_mpich.tar.gz"
+        #- "wget https://github.com/cdslaborg/paramonte/releases/latest/download/libparamonte_fortran_linux_amd64_gnu_release_shared_heap_mpich.tar.gz"
         #- ls libparamonte*.tar.gz* | xargs -i tar xvzf {}
-        #- cd libparamonte_c_linux_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
-        #- cd libparamonte_cpp_linux_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
-        #- cd libparamonte_fortran_linux_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
+        #- cd libparamonte_c_linux_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
+        #- cd libparamonte_cpp_linux_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
+        #- cd libparamonte_fortran_linux_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2 && cd ..
 
     ################################################################################################################################
     ####  linux complete build
@@ -148,13 +156,14 @@ matrix:
         - gfortran-9 --version && FCFLAG="-f $(which gfortran-9)" || echo "gfortran-9 not found..."
         - ./install.sh --lang "C C++ Fortran" --build release --lib shared --mem heap --par "none" --yes-to-all ${FCFLAG} ${mpiexecFlag}
         - pmRootDir="$(pwd)"
+        - ulimit -s unlimited
         - ls ${pmRootDir}/bin/
-        - cd ${pmRootDir}/bin/libparamonte_c_linux_x64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
-        - cd ${pmRootDir}/bin/libparamonte_cpp_linux_x64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
-        - cd ${pmRootDir}/bin/libparamonte_fortran_linux_x64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
-        #- cd ${pmRootDir}/bin/libparamonte_c_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
-        #- cd ${pmRootDir}/bin/libparamonte_cpp_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
-        #- cd ${pmRootDir}/bin/libparamonte_fortran_linux_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+        - cd ${pmRootDir}/bin/libparamonte_c_linux_amd64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
+        - cd ${pmRootDir}/bin/libparamonte_cpp_linux_amd64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
+        - cd ${pmRootDir}/bin/libparamonte_fortran_linux_amd64_gnu_release_shared_heap && ls && ./build.sh && ./run.sh
+        #- cd ${pmRootDir}/bin/libparamonte_c_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+        #- cd ${pmRootDir}/bin/libparamonte_cpp_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+        #- cd ${pmRootDir}/bin/libparamonte_fortran_linux_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
 
     ################################################################################################################################
     #### code coverage
@@ -175,6 +184,7 @@ matrix:
             - libmpich-dev
             - mpich
       script:
+        - ulimit -s unlimited
         - echo >&2 "FCFLAG = ${FCFLAG}"
         - cmake --version || echo "cmake not found..."
         - gfortran --version && FCFLAG="-f $(which gfortran)" || echo "gfortran not found..."
@@ -257,12 +267,12 @@ matrix:
 #        - ./install.sh --lang "C C++ Fortran" --build release --lib shared --mem heap --par "none mpi" #-s gnu
 #        - echo $(pwd)
 #        - pmRootDir="$(pwd)";
-#        - cd ${pmRootDir}/bin/libparamonte_c_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        - cd ${pmRootDir}/bin/libparamonte_cpp_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        - cd ${pmRootDir}/bin/libparamonte_fortran_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        - cd ${pmRootDir}/bin/libparamonte_c_darwin_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
-#        - cd ${pmRootDir}/bin/libparamonte_cpp_darwin_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
-#        - cd ${pmRootDir}/bin/libparamonte_fortran_darwin_x64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+#        - cd ${pmRootDir}/bin/libparamonte_c_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        - cd ${pmRootDir}/bin/libparamonte_cpp_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        - cd ${pmRootDir}/bin/libparamonte_fortran_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        - cd ${pmRootDir}/bin/libparamonte_c_darwin_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+#        - cd ${pmRootDir}/bin/libparamonte_cpp_darwin_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
+#        - cd ${pmRootDir}/bin/libparamonte_fortran_darwin_amd64_gnu_release_shared_heap_openmpi && ./build.sh && ./run.sh --nproc 2
 
 #    - &ubuntu
 #      os: linux
@@ -291,12 +301,12 @@ matrix:
 #        - gfortran-8 --version
 #        #- echo >&2 "The MPIEXEC binday path: $(which mpiexec) || echo >&2 "MPI library not found...skipping"
 #        - ./install.sh --lang "C C++ Fortran" --build release --lib shared --mem heap --par "none" --yes-to-all
-#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_c_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_cpp_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_fortran_darwin_x64_gnu_release_shared_heap && ./build.sh && ./run.sh
-#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_c_darwin_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
-#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_cpp_darwin_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
-#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_fortran_darwin_x64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
+#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_c_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_cpp_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        - cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_fortran_darwin_amd64_gnu_release_shared_heap && ./build.sh && ./run.sh
+#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_c_darwin_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
+#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_cpp_darwin_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
+#        #- cd /Users/travis/build/cdslaborg/paramonte/bin/libparamonte_fortran_darwin_amd64_gnu_release_shared_heap_mpich && ./build.sh && ./run.sh --nproc 2
 
 #    - os: linux
 #      addons:
@@ -338,8 +348,8 @@ matrix:
 
 #    - os: osx
 #      script:
-#        - wget "https://github.com/cdslaborg/paramonte/releases/download/v1.4.0/libparamonte_c_darwin_x64_gnu_release_shared_heap.tar.gz"
-#        - tar xvzf libparamonte_c_darwin_x64_gnu_release_shared_heap.tar.gz
-#        - cd libparamonte_c_darwin_x64_gnu_release_shared_heap
+#        - wget "https://github.com/cdslaborg/paramonte/releases/download/v1.4.0/libparamonte_c_darwin_amd64_gnu_release_shared_heap.tar.gz"
+#        - tar xvzf libparamonte_c_darwin_amd64_gnu_release_shared_heap.tar.gz
+#        - cd libparamonte_c_darwin_amd64_gnu_release_shared_heap
 #        - ./build.sh
 #        - ./run.sh

ACKNOWLEDGMENT.md

@@ -5,15 +5,15 @@ If you use ParaMonte, please acknowledge it by citing the ParaMonte library's ma
 ### The ParaMonte Python library  
 
 +   Amir Shahmoradi, Fatemeh Bagheri, Joshua Alexander Osborne (2020). 
-    **Fast fully-reproducible streamlined serial/parallel Monte Carlo/MCMC simulations and visualizations via `ParaMonte::Python` library.**. 
+    **Fast fully-reproducible streamlined serial/parallel Monte Carlo/MCMC simulations and visualizations via ParaMonte Python library.**. 
     Journal of Open Source Software (JOSS), to be submitted, [**PDF link**](https://www.cdslab.org/pubs/2020_Shahmoradi_III.pdf).  
     **BibTeX citation entries:**  
     ```text  
     
     @article{2020arXiv201000724S,
            author = { {Shahmoradi}, Amir and {Bagheri}, Fatemeh and {Osborne}, Joshua Alexand
             er},
-            title = "{Fast fully-reproducible serial/parallel Monte Carlo and MCMC simulations and visualizations via ParaMonte::Python library}",
+            title = "{Fast fully-reproducible serial/parallel Monte Carlo and MCMC simulations and visualizations via ParaMonte Python library}",
           journal = {arXiv e-prints},
          keywords = {Computer Science - Mathematical Software, Astrophysics - Instrumentation and Methods for Astrophysics, Quantitative Biology - Quantitative Methods, Statistics - Machine Learning},
              year = 2020,