QuantLib Installation in VC++ 2010
Dominik Holenstein
Based on the VC++ 2008 instructions by Dimitri Reiswich
These are step-by-step instructions to install QuantLib and Boost on the Microsoft Visual C++ 2010 IDE (you can download the free Express edition at http://www.microsoft.com/express/vc/.) I tried to include almost every step in the installation procedure. Something that is obvious to one person might not be obvious to someone else. The only thing that I assume you have on your computer is the Visual C++ 2010 IDE (VC10).
These instructions are for MS Visual C++ 2010 only. If you have earlier versions of this IDE (2008, 2005...) then have a look at this page.
Before using QuantLib you need to install the Boost library on your computer. Detailed instructions follow in the next section.
Boost Installation
We use the installer provided by BoostPro Computing, that can be downloaded at http://www.boostpro.com/download.
At the time of this writing, the current version is the executable boost_1_47_setup.exe and can be downloaded for free in just a few seconds. Double clicking the installer yields the screen shown below. Select the download mirror of your choice or "Nearest SourceForge Mirror" (recommended).
The next step asks you to select the binaries to download. Since we are using Visual Studio 2010, we will select this version in the left panel. In the right panel, select Multithreaded, Multithreaded Debug, Multithreaded static runtime, and Multithreaded Debug static runtime. The others are not needed by QuantLib, but you might want to download them anyway. The resulting screen is shown below.
The next window asks you which libraries you'd like to install. You can add any library that you want besides the ones selected by default; the one needed for a complete QuantLib build is the unit test framework, which can be found at the end of the list. Here is the corresponding screen.
Choose the VC10.0 to include the unit test framework. You can also open the VC10.0 list and select specific build versions.
The next step asks for a destination folder. I will install everything in the folder C:\Program Files\boost\boost_1_47. Feel free to choose your own folder.
Clicking Install starts the download, which takes a while. After finishing, the final screen should say:
Boost and QuantLib Installation
If you go to the Tools/Options page in VC10 to set the necessary VC++ directories, you get this confusing screen:
VC++ Directories are no longer supported in VC10 through the Tools/Options page. Instead, VC10 introduces the user settings file Microsoft.cpp.<Platform>.users.props to control global settings including the global search path. These files are located in the $(USERPROFILE)\appdata\local\microsoft\msbuild\v4.0 directory.
These changes require a different workflow regarding the installation of QuantLib in connection with Boost compared to VC9 and older.
Here are the steps to change the settings file accordingly:
1. Open VC10 and make sure you have activated the expert settings. Go to Tools/Settings and make sure "Expert Settings" is checked.
2. If you haven't downloaded QuantLib yet, go to its download page on SourceForge, located at http://sourceforge.net/projects/quantlib/files/QuantLib
3. Open the QuantLib tree, find the latest version (at the time of this writing the current version is 1.1, but this might have changed when you read this) and download the zip archive to your local drive. This is illustrated in the screenshot below. Unzip the file wherever you want; in the following, we'll assume that the QuantLib directory is C:\Program Files\QuantLib.
4. Open the QuantLib folder, then open the Visual Studio solution called QuantLib_vc10.sln by double clicking. Choose Release from the configuration menu in the toolbar.
5. Open the Property Manager by clicking on View/Property Manager and activate it. Expand the project node of QuantLib in the Property Manager and then the Configuration/Platform nodes (see screenshot below). You will see a Microsoft.cpp.<Platform>.users file for each Configuration/Platform folder. These are the files for the global settings, similar to the old Tools/Options/VC++ Directories settings. Select any of them (or multi-select them all), right-click, and select Properties to bring up the property page window.
6. In the property page window, click on VC++ Directories on the left pane and add the paths for the Boost directories in Include Directories and Library Directories in the right pane. If you installed Boost in C:\Program Files\boost\boost_1_47, you'll have to add C:\Program Files\boost\boost_1_47 to the include directories and C:\Program Files\boost\boost_1_47\lib to the library directories. Click the OK button to set your changes.
7. Switch back to the Solutions Explorer, right-click on the solution icon and choose Build Solution to build all projects. Besides QuantLib, this will build the examples and run the test suite. The process takes a while (it took 1h and 7 minutes to build QuantLib and run the tests on a three-years old WinXP notebook with 3 GB RAM and a 2 GHz Intel dual core processor).
After finishing, the output should show no errors:
14> Test suite "Master Test Suite" passed with: 14> 1703 assertions out of 1703 passed 14> 460 test cases out of 460 passed 14> 14> 14> Tests completed in 29 m 8 s 14> ========== Build: 15 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
You are done with building QuantLib. If you want, you can build the Debug version in the same way by choosing Debug from the configuration menu as shown below. This will allow you to debug your application later.
Quantlib Usage
As an example of QuantLib usage, I create a QuantLibTest folder in the C:\Program Files\QuantLib folder and set up a Win32 Console Application in Visual Studio by clicking File/New Project/Win32 Console Application.
I've chosen the project name TestingQuantLib, then I clicked on OK. Click on the Next button on the Win32 Application Wizard. Choose "Console application" as application type and check "Empty project" in the additional options. Click on Finish.
Choose, for example, the Release mode for that project. Note that very often, users don't setup a project correctly since they build QuantLib in one mode and try to call it from a test program which runs in some other mode. If you built QuantLib in release mode, you should build your project in release mode. If you build your project in debug mode without ever building QuantLib in debug mode, you'll have link errors.
To tell your project where to find QuantLib, open the project properties by right-clicking on the project icon in the IDE.
Go to VC++ Directories. You can see that the Boost folders are already there, so you don't have to do anything to configure them.
Add the QuantLib path (C:\Program Files\QuantLib in this example) to the include directories. The result should be as shown below.
Finally, you can add the QuantLib library path C:\QuantLib\QuantLib-0.9.7\lib to the library directories, or you can go to Configuration Properties/Linker/General and add it to Additional Library Directories. Click OK.
To test if the setup works, add the following program to the TestingQuantLib project. The program tests some Date and Calendar classes.
#include <ql/quantlib.hpp>
#include <iostream>
int main()
{
QuantLib::Calendar myCal=QuantLib::UnitedKingdom();
QuantLib::Date newYearsEve(31,QuantLib::Dec,2008);
std::cout << "Name: " << myCal.name()<< std::endl;
std::cout << "New Year is Holiday: " << myCal.isHoliday(newYearsEve)<< std::endl;
std::cout << "New Year is Business Day: " << myCal.isBusinessDay(newYearsEve)<< std::endl;
std::cout << "--------------- Date Counter --------------------" << std::endl;
QuantLib::Date date1(28,QuantLib::Dec,2008);
QuantLib::Date date2(04,QuantLib::Jan,2009);
std::cout << "First Date: " << date1 << std::endl;
std::cout << "Second Date: " << date2 << std::endl;
std::cout << "Business Days Betweeen: "<< myCal.businessDaysBetween(date1,date2) << std::endl;
std::cout << "End of Month 1. Date: " << myCal.endOfMonth(date1) << std::endl;
std::cout << "End of Month 2. Date: " << myCal.endOfMonth(date2) << std::endl;
double tmp;
std::cin >> tmp;
return 0;
}
Hit F5 to run the program. The output of the program should be:
One last thing: If you see some warnings after building, to get rid of them open the project properties again, go to Configuration Properties/C/C++/Preprocessor/Preprocessor Definitions and add _SCL_SECURE_NO_DEPRECATE and _CRT_SECURE_NO_DEPRECATE to the definitions, as shown here:
Now, building the TestingQuantLib project again shouldn't show you any warnings anymore, just as in the Output window below.
We're done!