bayesmix is a C++ library for running MCMC simulations in Bayesian mixture models.
Current state of the software:
bayesmixperforms inference for mixture models of the kind
For descriptions of the models supported in our library, discussion of software design, and examples, please refer to the following paper: https://arxiv.org/abs/2205.08144
Warning: make sure you have a recent version of cmake installed (at least 3.20.x) or install protobuf beforehand (see the section for developers)!
To install and use bayesmix, please cd to the folder to which you wish to install it, and clone this repository with the following command-line instruction:
git clone --recurse-submodules [email protected]:bayesmix-dev/bayesmix.gitThen, by using cd bayesmix, you will enter the newly downloaded folder.
To build the executable for the main file run_mcmc.cc, please use the following list of commands:
mkdir build
cd build
cmake .. -DDISABLE_DOCS=ON -DDISABLE_BENCHMARKS=ON -DDISABLE_TESTS=ON
make run_mcmc
cd ..The build/run_mcmc executable can be used to perform all the necessary analysis, but it needs some command-line arguments to be passed.
To perform your first run of the library right out of the box, you can call the following script from the command line:
examples/tutorial/run.shThis is an example script that runs said executable by passing appropriate arguments to it. In order to use your custom datasets, algorithm settings, and prior specifications, you can create a copy of the above script and change the arguments as appropriate. Please refer to the documentation for more information.
We heavily depend on the protobuf library to move and store structured data.
The CMakeLists.txt file is set up to install such library if it does not find it in the computer.
However any call to make clean will uninstall it, causing a huge waste of time... so make sure to install it manually beforehand!
If you're using a Linux machine, you can do so as follows:
sudo apt-get install autoconf automake libtool curl make g++ unzip cmake
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.14.0/protobuf-python-3.14.0.zip
unzip protobuf-python-3.14.0.zip
cd protobuf-3.14.0/
./configure --prefix=/usr
make check
sudo make install
sudo ldconfigOn Mac and Windows machines, please follow the steps from the official protobuf installation guide.
Another very useful tool is ccache that can significantly speed up the compilation process.
Finally, to compile unit tests, please use the following commands:
cd build
cmake ..
make test_bayesmix
cd ..The corresponding executable is located at build/test/test_bayesmix.
Documentation is available at https://bayesmix.readthedocs.io.
Please check out CONTRIBUTING.md for details on how to collaborate with us. You can also head to our issues page to check for useful enhancements needed.