This repo contains the code associated with the paper: "Mixed Precision Iterative Refinement"
System | Status | More information |
---|---|---|
FOSSA Status | Open-source license dependency scanner | |
GitHub Actions | Latest Linux/MacOS/Windows builds and regression tests |
This repo uses git submodules. The first step after pulling the repository is to configure the submodules:
> git submodule init && git submodule update
After that, the repo is ready to be build:
> mkdir build
> cd build
> cmake ..
> make
This will build the libraries, the CLI command projects, and the tests in test/mpir_tests
.
When using VSCode, the repository contains a devcontainer spec in the directory $MPIR_ROOT/.devcontainer.
The default container provides a build environment based on GCC11:
{
"image": "stillwater/universal:gcc11builder"
}
There is a set of builders that can be used that contain specific compilers. Other environments are:
gcc9builder
gcc10builder
gcc12builder
clang11builder
clang12builder
clang13builder
clang14builder
If you want to change your development container, simply replace the json with the container of your choice.
You can also build natively. The .gitignore of this repo filters out the following directories:
build/
build_msvc/
build_gcc/
build_clang/
You can use these build directories to organize your native and specific build containers so that they can run concurrently. For example, you can use the build/
directory to hold native builds, and build_gcc/
directory to hold the default build container builds.
To install the command line tools for ease of use, issue the install
target:
> make install
This command will populate the $MPIR_ROOT/bin, $MPIR_ROOT/lib, and $MPIR_ROOT/include directories, where $MPIR_ROOT represents the directory path of the mixed-precision-ir repository clone.
If you are on a Linux or MacOS system, you can add the bin directory to your path to pick up the command line tools:
> export PATH=$PATH:$MPIR_ROOT/bin
For Windows, use the environment variable editor to do the same.
To just build the projects in mixed-precision-ir and ignore build targets in Universal and MTL4, use:
> cmake -DBUILD_DEMONSTRATION=OFF -DENABLE_TESTS=OFF ..
The following figure shows the project structure of this repository: