[CompFin] Installing QuantLib and QuantLib-Python in Windows
In our recent paper introducing QuantLib, we had an appendix which described how to set both QuantLib and QuantLib-Python up for use in Ubuntu and Windows. Since I rarely use Windows these days, for instructions for Windows we mostly relied on what was available on the QuantLib website and answers to relevant questions on stackoverflow.
When I got my hands on a Windows laptop recently, to my embarrassment I realized I could not use those instructions to get
QuantLib and QuantLib-Python working on a Windows 7 machine. Needless to say this needed sorting out, and now it has been.
I’ll have the paper updated on our website
shortly, but in the mean time here are the instructions for installing QuantLib and QuantLib-Python in Windows. These have been tested on three different Windows machines, so we are reasonably sure they work. However, if something doesn’t work for you, do drop in a comment.
Step-by-step by instructions for installing QuantLib and QuantLib-Python in Windows
- QuantLib requires a working C++ Environment, and for the purposes of instructions here (meant for a novice), it is recommended that the user install the free Microsoft Visual Express Desktop 2013 edition which comes with Visual C++ 12 (MSVC12).
- QuantLib-Python requires a working Python environment, and we recommend working with the Anaconda meta-package. Instructions are available from the Anaconda install page. For our purpose here, Windows users should work with the 32-bit version of Anaconda. It is recommended to install Anaconda with all the default settings, and update it by running and . Again, it does not matter if one installs Anaconda-2.x (with Python 2.7) or Anaconda-3.x (with Python 3), but it is recommended that the user install the Python 3 version, as that’s where the Python language seems to be headed.
- Compiling QuantLib requires Boost C++ libraries installed. And this is where the utility of working with MSVC becomes most apparent. Pre-packaged binaries for Boost are available for specific versions of MSVC (in our case MSVC12) from its sourceforge page, and installing Boost on MSVC is no more difficult than installing any other software in Windows. (Users should download the executable for the 32-bit architecture, as the free version of MSVC does not seem to contain the necessary utilities for compiling in 64-bit. There is no such problem if you have access to a professional edition of MSVC though.)
- After installing Boost, we need to install SWIG. Pre-packaged binaries for SWIG for Windows are available from its source page (latest version 3.0.5), and it is enough to extract the SWIG zip file in a convenient folder.
- Download the same version of QuantLib and QuantLib-Python (latest version 1.6)
- Launch the Visual Studio command prompt: All the commands below assume that we are working in Visual Studio command prompt (or if not, all the relevant Visual Studio related environment variables have been set). It can be launched from the Start menu (in Windows 7) or from Apps (in Windows 8). If you can’t find it, see here.
- NB: Though we haven’t encountered any issue when using MSVC12, as pointed out by Andres in comments, when working with VS 2015, it might be safest to work with x64 Native Tools Command Prompt.
- After the above steps, installing QuantLib in Windows simply requires the following steps (mind the gaps):
cd \path\to\QuantLib-1.6 set myboost=\path\to\boost\boost_1_58_0 msbuild /p:AdditionalLibPaths=&quot;%myboost\lib32-msvc-12.0&quot; /p:Configuration=Release /p:Platform=Win32 QuantLib_vc12.sln
The last step above may take a while (on an Intel i5, Windows 7 machine with 4 GB RAM it took almost 45 minutes).
Note that throughout in this post represents the directory of . For example, if is installed in , should be taken to mean .
- One should ensure that QuantLib is correctly installed in the previous step, as what follows assume a working QuantLib. If it is correctly installed, you should see something like the following message at some stage before the installation completes:
Tests completed in 16m 50s Test suite &quot;Master Test Suite&quot; passed with: 1002021 assertions out of 1002021 assertions passed 609 test cases out of 609 passed
And at the very end:
Build succeeded. 0 Warning(s) 0 Error(s) Time Elapsed 00:44:20.07
- Although not absolutely necessary, to ensure that all is well, it is recommended to also build QuantLib in Debug mode (replace ‘Release’ by ‘Debug’ in the command in step 7 above; and will take roughly half the time it took to build the Release version), and test the code in the QuantLib Usage section on the QuantLib install page for Windows.
- Installing QuantLib-Python requires a few extra settings. At the Visual Studio command prompt, set the following (again, mind the gaps):
cd \path\to\QuantLib-SWIG-1.6\Python set PATH=\path\to\Anaconda3;\path\to\Anaconda3\scripts;\path\to\swigwin-3.0.5;\path\to\QuantLib-1.6\lib;%PATH% set QL_DIR=\path\to\QuantLib-1.6 set VS100COMNTOOLS=%VS120COMNTOOLS% set INCLUDE=\path\to\boost_1_58_0;%INCLUDE% set LIB=\path\to\boost\lib32-msvc-12.0;%LIB% echo [build] &gt; setup.cfg &amp;&amp; echo compiler=msvc &gt;&gt; setup.cfg
- Once the environment variables have been set in step 10 above, all we need is to run the following steps:
cd \path\to\QuantLib-SWIG-1.6\Python python setup.py wrap python setup.py build python setup.py test python setup.py install
If you are wondering how would you know that QuantLib-Python has been installed correctly, after the step, you should see a message something like this:
--------------------------------------- Ran 36 tests in 1.253s Ok
- To be doubly sure, you should now go to Luigi Ballabio’s QuantLib page and run the examples there.
My co-author has a more detailed post on his blog discussing this, and in addition to providing motivation for some of our choices, he also describes how to install QuantLib and QuantLib-Python using only open-source tools (for “free as in free speech”) and without using Visual Studio. Highly recommended.
Update (8th July): Paper updated with these instructions.