Configuring OpenStudio Build Environments
Wiki ▸ Configuring OpenStudio Build Environments
Recommended: Using the Superbuild
Advanced: Manual Build Instructions
This is the fastest, most reliable method of getting a working OpenStudio build. These instructions assume that you have successfully cloned the OpenStudio repository already, and installed Qt (Note that creating a universal mac build will require that you build Qt yourself - follow the instructions below).
Install Visual Studio 2013, Visual Studio 2013 Update 2, CMake, Qt, msysGit, and EnergyPlus 8.1.
Add C:\Qt\Qt5.3.1\5.3\msvc2013_opengl\bin to the System Path variable.
Clone the repository, create a build directory, and launch CMake:
Install the command line tools and EnergyPlus 8.1.
sudo apt-get install dpkg-dev git cmake-curses-gui libqt4-dev libboost-all-dev libxt-dev
Clone the repository, create a build directory, and launch CMake:
Install Xcode, CMake, and EnergyPlus 8.1.
Clone the repository, create a build directory, and launch CMake:
Install msysGit
Extract SWIG to C:\swig
Append C:\swig\swigwin-3.0.2; to the System Path variable
Latest v3.0.2 tested and working
Install CMake
Latest v3.0.0 tested and working
Install EnergyPlus 8.1
Install Doxygen
Latest v1.8.7 tested and working
Install Graphviz
Latest v2.38 tested and working
Install Sandcastle
Latest v2.6.1062.1 tested and working
Install Radiance using the installer
Latest v4.2a tested and working
Install NSIS
v2.46 tested and working
Install Boost to the default directory of C:\local
v1.55.0 tested and working
Install Qt
v5.3.1 VS2013 OpenGL tested and working
Install Visual Studio 2013 Update 2
Follow the previous instructions above to configure the environment for VS2013 Professional. Within CMake, choose Visual Studio 12 2013 Win64 as the generator for the project.
Ensure that you have installed 64-bit Qt.
BUILD_BOOST, and BUILD_SWIG CMake options are required for 64-bit builds, so they should be enabled. Other options can be chosen like usual.
Install Visual C++ 2013 Express (all of the optional installs are unnecessary and may be unchecked)
The MSVC_IS_EXPRESS CMake option is required and should be enabled.
Follow the previous instructions to configure the environment for VS2013 Express.
Install Windows SDK 8, and then add C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin;C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin\amd64 to the System Path variable.
Within CMake, choose Visual Studio 12 2013 Win64 as the generator for the project.
Ensure that you have installed 64-bit Qt.
The BUILD_BOOST, and BUILD_SWIG CMake options are required for 64-bit builds, so they should be enabled. Other options can be chosen like usual.
The MSVC_IS_EXPRESS CMake option is required and should be enabled.
Build Dependencies:
sudo apt-get install dpkg-dev git cmake-curses-gui qt5-default libqt5webkit5-dev libboost1.55-all-dev swig libssl-dev libxt-dev doxygen graphviz
wget ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p451.tar.gz
tar -xzf ruby-2.0.0-p451.tar.gz
rm ruby-2.0.0-p451.tar.gz
cd ruby-2.0.0-p451
./configure --enable-shared --prefix=/usr/local
make -j2
sudo make install
cd ..
rm -rf ruby-2.0.0-p451
sudo ln -fs /usr/local/bin/ruby /usr/bin/rubyEnergyPlus 8.1
# Download from http://apps1.eere.energy.gov/buildings/energyplus/register.cfm?goto=eplus with the correct architecture
sudo sh SetEPlusV810009-lin-64.sh
rm SetEPlusV810009-lin-64.shInstall EnergyPlus 8.1
Install CMake with the option of creating symbolic links in /usr/bin
Install Xcode from the App Store
Install SWIG
curl -LO ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.35.tar.gz
tar -xzf pcre-8.35.tar.gz
rm pcre-8.35.tar.gz
cd pcre-8.35
./configure
make
sudo make install
cd ..
rm -rf pcre-8.35
curl -LO http://developer.nrel.gov/downloads/buildings/openstudio/src/swig-3.0.2.tar.gz
tar -xzf swig-3.0.2.tar.gz
rm swig-3.0.2.tar.gz
cd swig-3.0.2
./configure
make
sudo make install
cd ..
rm -rf swig-3.0.2Modify ~/.bash_profile to help give CMake defaults for the build options
export CMAKE_OSX_ARCHITECTURES='i386;x86_64'
export MACOSX_DEPLOYMENT_TARGET=10.9Download the Auxiliary Tools for Xcode - Late July 2012 from https://developer.apple.com/downloads/ then drag PackageMaker.app to
/Applications/
Download Doxygen and drag it to Applications
Install Graphviz
Install Boost
curl -LO http://downloads.sourceforge.net/project/boost/boost/1.55.0/boost_1_55_0.tar.gz
tar -xzf boost_1_55_0.tar.gz
rm boost_1_55_0.tar.gz
cd boost_1_55_0
sh ./bootstrap.sh
# *Deprecated*
sudo ./b2 cxxflags="-stdlib=libstdc++" linkflags="-stdlib=libstdc++" variant=release variant=debug address-model=32_64 architecture=x86 --layout=tagged macosx-version-min=10.9 macosx-version=10.9 --without-python --without-math install --prefix=/usr/local -j2
cd ..
rm -rf boost_1_55_0Install Qt
curl -LO http://qt.mirror.constant.com/archive/qt/5.3/5.3.1/single/qt-everywhere-opensource-src-5.3.1.tar.gz
tar -xzf qt-everywhere-opensource-src-5.3.1.tar.gz
rm qt-everywhere-opensource-src-5.3.1.tar.gz
cd qt-everywhere-opensource-src-5.3.1
# *Deprecated*
./configure -sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk -debug-and-release -opensource -openssl -arch x86 -arch x86_64 -qt-sql-sqlite -plugin-sql-sqlite -nomake examples -nomake demos -nomake docs -no-phonon -no-phonon-backend -no-qt3support -confirm-license
make -j2
sudo make install
cd ..
rm -rf qt-everywhere-opensource-src-5.3.1
# *Deprecated*
echo 'export PATH=$PATH:/usr/local/Trolltech/Qt-5.3.1/bin' >> ~/.bash_profile