Building on Windows
Installing on Windows
Install Dependencies
Visual Studio
Accera requires a C++ compiler that supports C++ 17. You can download Visual Studio 2019 Enterprise Edition or Visual Studio 2022 Community Edition. Install Update 10 or later, which includes the LLVM OpenMP libraries only for VS 2019.
Select Desktop Development with C++.
Accera requires Spectre-mitigated libraries:
- Go to Individual Components
- Type in "Spectre" in the search box
- Select the latest version of the MSVC libraries, e.g., MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) (your actual version may vary)
CMake
Accera requires CMake 3.14 or newer. A version of CMake that satisfies this requirement is included with Visual Studio 2019 and Visual Studio 2022.
Python
Accera's packages require Python 3.7 64-bit or newer, plus a version of pip that supports 64-bit packages (win_amd64). One way to obtain this is to download and install Miniconda. Download "Miniconda3 Windows 64-bit".
Optional: Create a conda environment
After installing Miniconda, you can optionally create an environment to manage different Python versions.
From an "Anaconda Prompt", create and then activate an environment for Python 3.7 (or a newer version if you prefer). Make sure to activate an environment from other applications that you use to develop Accera.
conda create -n py37 python=3.7
conda activate py37
Clone Accera
Visual Studio 2019 and 2022 include a version of git. To use it, launch Visual Studio 2019 or 2022, and select Clone a repository.
Repository location:
https://github.com/microsoft/Accera
Build and install Accera
From a command line with Python in your PATH, such as an Anaconda Command Prompt, setup the Visual Studio command line environment (vcvars64.bat) and then run build.bat to generate the Accera Python packages.
For Visual Studio 2022:
"%ProgramFiles%\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"
For Visual Studio 2019:
"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"
cd <path_to_accera>
build.bat
Replace <path_to_accera> with the path to the cloned Accera repository.
Update or install the resulting .whl file from the dist subdirectory. The --find-links option tells pip to look at the dist subdirectory for the dependent packages.
The whl filename depends on your Python version, your OS, and your CPU architecture.
pip install -U dist\accera-0.0.1-cp37-cp37m-win_amd64.whl --find-links=dist
Build and install using CMake
Accera can also be built using CMake (intended for expert users).
Install dependencies
cd <path_to_accera>
git submodule init
git submodule update
external\vcpkg\bootstrap-vcpkg.bat
external\vcpkg\vcpkg install catch2:x64-windows tomlplusplus:x64-windows accera-llvm:x64-windows --overlay-ports=external\llvm
The last command typically takes a few hours to build and then install Accera's fork of LLVM. We recommend reserving at least 20GB of disk space for the LLVM build.
Configure CMake
cd <path_to_accera>
mkdir build
cd build
# For Visual Studio 2019:
cmake .. -DCMAKE_BUILD_TYPE=Release -G"Visual Studio 16 2019" -Ax64
# For Visual Studio 2022:
cmake .. -DCMAKE_BUILD_TYPE=Release -G"Visual Studio 17 2022" -Ax64
Build and run tests
cmake --build . --config Release -- /m
ctest -C Release
Install
cmake --build . --config Release --target install -- /m