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.
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:
Compiler Suite | Linux | macOS | Windows (64bit) |
---|---|---|---|
GNU Compiler Collection > 10.3 | ✓ | ✓ | ✗ |
Intel OneAPI > 2021.8.0 | ✓ | ✓ | ✓ |
install.md
installation instruction notes to learn more about the library's many optional build configurations.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:
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/.
Generally, the best way to get started with example usage is to build the language-specific library examples.
The library example build and run scripts are automatically generated for each ParaMonte build and
are automatically stored in the output installation directory of the build.
For complete, organized, up-to-date instructions, visit: cdslab.org/pm
For a quick look into language-specific README.md instructions, visit:
The ParaMonte libraries for MATLAB and Python are currently undergoing internal testing before their impending release.
For now, the previous versions (1) of the ParaMonte MATLAB and Python libraries can be downloaded and used from the previous library major release on GitHub Release Page.
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 (shahmoradi@utexas.edu).
Please read the generic contribution guidelines listed in CONTRIBUTING.md.
For more information, visit cdslab.org/pm or contact Amir Shahmoradi: shahmoradi@utexas.edu