Overview | Installation | Dependencies | Parallelism | Examples | Acknowledgments | License | Authors

ParaMonte is a serial/parallel library of Monte Carlo routines for sampling mathematical density functions of arbitrary dimensions and Machine Learning (ML) algorithms for scientific inference, with the design goal of unifying automation (of simulations and tasks), user-friendliness (of algorithms), accessibility (from any platform or programming environment), high-performance (at runtime), and scalability (across many parallel processors).

For more information on the installation, usage, and examples, visit https://www.cdslab.org/paramonte

ParaMonte has been developed while bearing the following design goals in mind:

• Full automation of Monte Carlo and Machine Learning simulations as much as possible to ensure user-friendliness of the library and minimal time investment requirements for building, running, and post-processing simulation models.

• Interoperability of the core library with as many programming languages as currently possible, including C, C++, Fortran, MATLAB, and Python, with ongoing efforts to support other popular programming languages.

• High-Performance meticulously-low-level library implementation to ensure the fastest-possible inferences.

• Parallelizability of all simulations via shared-memory OpenMP threads and two-sided and one-sided MPI/Coarray distributed communications while requiring zero-parallel-coding efforts by the user.

• Zero-dependence on external libraries to ensure hassle-free ParaMonte library builds and ParaMonte simulation runs.

• Fully-deterministic reproducibility and automatically-enabled restart functionality for all simulations with arbitrary digits of precision as requested by the user.

• Comprehensive reporting and post-processing of simulations and ML tasks, as well as their automatic storage in external files to ensure the simulation results will be understandable and reproducible at any time in the foreseeable future.

• Follow the quick start instructions in this QUICKSTART.md file.
• For programming languages other than C, C++, Fortran, see the quick start section of the README.md file in the corresponding language's source subfolder in the src folder in the root directory of the ParaMonte repository.

The prebuilt, ready-to-use libraries are available on the release page of the ParaMonte library on GitHub. Each prebuilt ParaMonte library automatically ships with a full-fledged set of example codes and build scripts.

Alternatively, you can build the library from the source in the project's GitHub repository. The ParaMonte library installation/build process is fully automated for all supported programming languages. Currently, the following compiler suites are supported for builds from source:

• Read the install.md installation instruction notes to learn more about the library's many optional build configurations.
• For more information and a quickstart in the programming language of your choice, visit the ParaMonte library homepage.

Beyond an optional MPI runtime library for MPI-parallel simulations, the ParaMonte library core has zero dependency on external third-party libraries or packages.

The ParaMonte library relies on three independent parallelism paradigms for parallel applications:

1. The Coarray parallelism (only available for select routines in the Fortran programming language).
2. The Message Passing Interface (MPI) standard for inter-processor distributed parallelism.
   • On Windows and Linux operating systems, we highly recommend downloading and installing the Intel MPI runtime libraries, which is available to the public free of charge. This requires the ParaMonte library to be (or have been prebuilt) using the Intel compilers.
   • On macOS, the Intel MPI library is not available. Therefore, we recommend installing either Open-MPI or MPICH MPI runtime libraries depending on the prebuilt version of the ParaMonte library that you have downloaded or the configuration with which you intend to build the library.

Read the install.md installation instruction notes to learn more about the library's optional parallel build configurations.

For more information, visit https://www.cdslab.org/paramonte/.

• For complete, clear, organized, up-to-date instructions on the build process and the installation of the ParaMonte library, visit: cdslab.org/pm

• Go to the release page of the ParaMonte library on GitHub,
• Decide on the parallelism paradigm that you want to use: serial / MPI / OpenMP (the Coarray Fortran implementation is not available as a prebuilt dynamic library),
• Decide on the Operating System (OS) on which you want to run the ParaMonte simulations: Windows / macOS / Linux,
• Learn about the naming convention used for the ParaMonte prebuilt libraries here,
• Download the prebuilt ParaMonte library of your choice based on the decisions you have made above. If you are unsure which prebuilt library is suitable for your needs, use the prebuilt library recommended here for Windows, or here for Linux, or here for macOS.
• Each prebuilt library ships with a full-fledged set of example codes and build scripts. Uncompress the prebuilt library:
  • On Windows: Simply double-click on the zip-file and select extract files from the Windows Explorer menu.
  • On macOS/Linux: Open a Bash terminal and navigate to the compressed library folder. Use the following command to untar the compressed file,

    ls libparamonte*.tar.gz | xargs -i tar xvzf {}
    

    to extract all libparamonte tar files in the current directory.

• Note: Theoretically, you can use any C/C++ compiler on Windows to build and link your applications against the ParaMonte library. However, remember that the ParaMonte library example build scripts have only been tested with the GNU, Microsoft, and Intel C/C++ compilers.

• Note: Theoretically, you can use any C/C++ compiler on macOS or Linux to build and link your applications against the ParaMonte library. However, as described below, the ParaMonte library example build scripts only recognize the Intel and GNU C/C++ compilers.

• For the generic library build instructions, follow the guidelines provided in install.md in the root directory of the repository.

The ParaMonte library is an honor-ware and its currency is acknowledgment and citations.

If you use ParaMonte or any ideas from this software, please acknowledge it by citing the ParaMonte library's main publications as listed in ACKNOWLEDGMENT.md.

Visit the ParaMonte library homepage to access the PDF version of these files free of charge.

The majority of the ParaMonte library routines are distributed under the permissive MIT License plus acknowledgments that are detailed in LICENSE.md.

However, there are occasionally modernized and extended routines from external projects, particularly within the ParaMonte Fortran library. These routines may have a license that does not fully overlap with the default ParaMonte library license LICENSE.md. In such cases, the documentation and source code of the specific routine explicitly list the original license information.

This is free software, so help us keep it freely available to the public by acknowledging the usage and contributing to it. If you have questions or concerns about the license, please get in touch with the project's lead ([email protected]).

• Amir Shahmoradi

  • Astrophysicist/bioinformatician by training,
  • Ph.D. in computational physics/bioinformatics, The University of Texas at Austin,
  • Currently a faculty member of the Data Science and Physics programs at UT Arlington,
  • Contact: [email protected]

• Fatemeh Bagheri

  • PhD in Astronomy,
  • PhD in Space Physics,
  • Deep philosophical thinker,
  • Currently at NASA Goddard Space Flight Center (GSFC),
  • Contact: [email protected]

Please read the generic contribution guidelines listed in CONTRIBUTING.md.

For more information, visit cdslab.org/pm or contact Amir Shahmoradi: [email protected]