# Compiling from source on Windows platforms

**URL:** <https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606>\
**Category:** radiance-dev\
**Created:** [September 6, 2012, 4:10pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606 "2012-09-06T16:10:41Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Pally\_Sandher](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/p/0ea827/32.png) [@Pally\_Sandher](https://discourse.radiance-online.org/u/Pally_Sandher)\
**Post date:** [September 6, 2012, 4:10pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/1 "2012-09-06T16:10:41Z")

</div>

As [http://radiance-online.org/download-install/installation-information/windows-installation.html](http://radiance-online.org/download-install/installation-information/windows-installation.html) has nothing other than a placeholder for a link and neither does [http://openstudio.nrel.gov/getting-started-developer/getting-started-radiance](http://openstudio.nrel.gov/getting-started-developer/getting-started-radiance) I thought I'd post my experience with this now that I've had some time to give it a go.

Building a project which implements CMake on Windows is usually quite straightforward but this ultimately depends on the project being built. Thankfully Radiance isn't much of an exception to this.

Stuff you'll need:  
1 - A Windows system (obviously). I used Windows 7 x64.  
2 - A compiler (obviously). I used Visual Studio 2010 SP1 but the steps should be similar for Visual Studio 2008. minGW will likely require extra hoops as it doesn't have an IDE to simplify the build process.  
3 - CMake (obviously). I used CMake 2.8.9 since it's the latest release as of 9th August -\> [http://www.cmake.org/cmake/resources/software.html](http://www.cmake.org/cmake/resources/software.html)  
4 - The Radiance source including CMake files. Easiest way to get these is to go to [http://public.kitware.com/gitweb?p=radiance.git;a=tree](http://public.kitware.com/gitweb?p=radiance.git;a=tree) & click the "snapshot" link in the top left corner to download a .tar.gz archive. The 4.1 release of the source doesn't have any of the CMake files so you have to use the latest from the repository until an official 4.2 is released.  
5 - Qt libraries. These can either be installed using the pre-built packages or built from source, all of which are available from [http://qt.nokia.com/downloads](http://qt.nokia.com/downloads). I had built the Qt v4.8.2 libraries from source previously so used that.  
6 - Tiff library for Windows. Again this can either be installed using a pre-built package or built from source. You can find this at [http://gnuwin32.sourceforge.net/packages/tiff.htm](http://gnuwin32.sourceforge.net/packages/tiff.htm) I used the pre-built package as the sources are configured to be built with Visual Studio 6 & wasn't in the mood to update it just to build a .lib file.

You should then be able to load up CMake, point it at the root of the Radiance source tree, give it a build directory (I suggest something like "build" inside the extracted source directory to keep things together) & click Configure. Assuming no errors, you should then be able to click Generate & you'll get a load of projects & solutions built. You can then open the solution and build the projects. It will output the files to \<build directory\>\bin\Release or \<build directory\>\bin\Debug\

At this point I suggest you download the zip archive of binaries and library files from [https://openstudio.nrel.gov/getting-started-developer/getting-started-radiance](https://openstudio.nrel.gov/getting-started-developer/getting-started-radiance) as you only have a load of binaries which is great but you'll be missing crucial library files so you can't really do anything with your binaries (and no manuals either).

A few issues I have with the above are as follows:  
1 - Qt and libtiff are \*required\* for CMake to generate a build source. They should be optional & when not available the relevant projects which require them (rvu, ra\_tiff etc) should be omitted from the generated source. Zlib can be omitted without issue (not sure which project uses it though).

2 - CMake generates projects using Absolute paths rather than Relative paths. Major failure point as this requires manual updating of over 100 projects with a minimum of 5 paths per project if you wish to fix this otherwise you must replicate the file structure on every machine you want to use the CMake generated build source. All other projects I've used which implement CMake will give you the option of using relative paths if you so wish.

3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in the CMake build source. I assume this is due to them being Perl & Ruby scripts in the NREL binaries archive (falsecolor appears to have C source code available?)

4 - manuals are in unix man/postscript format which unsurprisingly isn't widely supported on Windows. Should preferably be Compiled HTML Help (.chm) or at the very least converted to HTML or PDF to make them more readable.

5 - Radiance source is littered with the now defunct Scons build files. Not a massive issue but they should probably be cleaned out since they're no longer relevant.

6 - Building using Shared libraries doesn't work. Code is generated but attempting to build generates loads of linker errors. Again not a massive issue since static builds work fine & the compiled binaries are small enough that they're unlikely to save much anyway but I thought I should mention it.

7 - 2107 warnings during build. Some of these may be due to me using VS 2010 while NREL use VS 2008 however but even still it's rather high for such a small code base.

That's it so far. I have to say it's a giant leap from the old decrepit Scons system. Building now takes minutes once you've downloaded the code rather than hours (and actually works 'out of the box' without requiring a load of manual tweaking).

Palbinder Sandher  
Software Platform Engineer  
T: +44 (0) 141 945 8500  
F: +44 (0) 141 945 8501  
[http://www.iesve.com](http://www.iesve.com)

\*\*Design, Simulate + Innovate with the \<Virtual Environment\>\*\*  
Integrated Environmental Solutions Limited. Registered in Scotland No. SC151456  
Registered Office - Helix Building, West Of Scotland Science Park, Glasgow G20 0SP  
Email Disclaimer

---

<div class="post-metadata">

**Author:** ![Axel\_Jacobs2](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/a/46a35a/32.png) [@Axel\_Jacobs2](https://discourse.radiance-online.org/u/Axel_Jacobs2)\
**Post date:** [September 6, 2012, 4:26pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/2 "2012-09-06T16:26:26Z")

</div>

> 3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in the CMake build source. I assume this is due to them being Perl & Ruby scripts in the NREL binaries archive (falsecolor appears to have C source code available?)

falsecolor , genBSDF, genklemsamp, genskyvec are all Perl scripts. At  
present, they require a Perl interpreter to be installed. It is  
possible to compile them into exe files using PAR::Packer. I've  
successfully done this with falsecolor, but this is not part of the  
build system yet (not in Classic and not in NREL). I believe it's one  
of Rob's nice-but-not-essential items on his to-do list.

objview for Windows is a Ruby script. This should probably be  
re-written in Perl to avoid unnecessary folking of the source tree and  
extra deps for non-OpenStudio users.

Cheers

Axel

---

<div class="post-metadata">

**Author:** ![Guglielmetti\_Robert](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/g/bb73d2/32.png) [@Guglielmetti\_Robert](https://discourse.radiance-online.org/u/Guglielmetti_Robert)\
**Post date:** [September 6, 2012, 6:13pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/3 "2012-09-06T18:13:42Z")

</div>

Thanks Pally for this nice summary overview. I am very remiss in getting  
something like this posted to the OpenStudio support page. Thanks Axel for  
your responses as well. Replies to both of you within...

- Rob

> 4 - The Radiance source including CMake files. Easiest way to get these  
> is to go to [http://public.kitware.com/gitweb?p=radiance.git;a=tree](http://public.kitware.com/gitweb?p=radiance.git;a=tree) &  
> click the "snapshot" link in the top left corner to download a .tar.gz  
> archive. The 4.1 release of the source doesn't have any of the CMake  
> files so you have to use the latest from the repository until an official  
> 4.2 is released.

Actually the easiest way to grab the latest source tree is to install git  
and just make a clone of the repo on your system:

$ git clone [http://public.kitware.com/radiance.git](http://public.kitware.com/radiance.git)

This is a copy of the CVS repository, and it's updated nightly. To update  
your git clone after the initial download, simply do a git pull while in  
the CVS directory:

$ git pull

NREL plans to host a repo on Github which will allow me to update the repo  
manually whenever Greg checks in a change. But for now the Kitware repo is  
at least updated every evening at midnight.

> 5 - Qt libraries. These can either be installed using the pre-built  
> packages or built from source, all of which are available from  
> [http://qt.nokia.com/downloads\](http://qt.nokia.com/downloads%5C). I had built the Qt v4.8.2 libraries from  
> source previously so used that.

The installer works fine too.

> 6 - Tiff library for Windows. Again this can either be installed using a  
> pre-built package or built from source. You can find this at  
> [Tiff for Windows](http://gnuwin32.sourceforge.net/packages/tiff.htm) I used the pre-built  
> package as the sources are configured to be built with Visual Studio 6 &  
> wasn't in the mood to update it just to build a .lib file.

Yup, I use the installer for this as well. Easier.

> You should then be able to load up CMake, point it at the root of the  
> Radiance source tree, give it a build directory (I suggest something like  
> "build" inside the extracted source directory to keep things together) &  
> click Configure. Assuming no errors, you should then be able to click  
> Generate & you'll get a load of projects & solutions built. You can then  
> open the solution and build the projects. It will output the files to  
> \<build directory\>\bin\Release or \<build directory\>\bin\Debug\
> 
> At this point I suggest you download the zip archive of binaries and  
> library files from  
> [OpenStudio](https://openstudio.nrel.gov/getting-started-developer/getting-started-radi)  
> ance as you only have a load of binaries which is great but you'll be  
> missing crucial library files so you can't really do anything with your  
> binaries (and no manuals either).

Make by default merely builds the executables. If you build the INSTALL  
target, everything will be installed, including libraries, manual pages  
and all the scripts (Perl and Ruby only on Windows, of course). This is  
the same on the other platforms. "make install" will build all the  
executables and copy everything else. The default behavior is to do this:

Binaries in /usr/local/radiance/bin  
Library files in /usr/local/radiance/lib  
Manpages in /usr/local/radiance/man

> A few issues I have with the above are as follows:  
> 1 - Qt and libtiff are \*required\* for CMake to generate a build source.  
> They should be optional & when not available the relevant projects which  
> require them (rvu, ra\_tiff etc) should be omitted from the generated  
> source. Zlib can be omitted without issue (not sure which project uses it  
> though).

It would be more user-friendly to do that Pally, but honestly a LOT of the  
effort around this project was to give Windows users access to programs  
like rvu. I consider ra\_tiff and rvu to be critical programs in the  
Radiance suite and to include them was a major goal of this project. We  
can re-write the CMakeLists.txt files to function as you state, but it's  
way down there on my priority list.

> 2 - CMake generates projects using Absolute paths rather than Relative  
> paths. Major failure point as this requires manual updating of over 100  
> projects with a minimum of 5 paths per project if you wish to fix this  
> otherwise you must replicate the file structure on every machine you want  
> to use the CMake generated build source. All other projects I've used  
> which implement CMake will give you the option of using relative paths if  
> you so wish.

I'm not sure I follow you here, but if you explain maybe I can fix what's  
busted for you.

> 3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in  
> the CMake build source. I assume this is due to them being Perl & Ruby  
> scripts in the NREL binaries archive (falsecolor appears to have C source  
> code available?)

Right. Again, these are installed and suffixed per convention (i.e. The  
suffixes are removed on UNIX systems), when the INSTALL target is made.

> 4 - manuals are in unix man/postscript format which unsurprisingly isn't  
> widely supported on Windows. Should preferably be Compiled HTML Help  
> (.chm) or at the very least converted to HTML or PDF to make them more  
> readable.

Totally agree. This is also on the list of nice-to-haves, I just haven't  
had time to figure out an automated way to do that on Windows. The  
manpages are updated on the radiance-online.org site, however. Maybe we  
should just generate a link to them in the /man directory on Windows  
builds for now. (?)

Andy, how do those updates work? I can't access the radiance-online.org  
site from work because of our firewall crap, but I'm pretty sure there's a  
link there with links to pdf versions of all the manpages, right?

> 5 - Radiance source is littered with the now defunct Scons build files.  
> Not a massive issue but they should probably be cleaned out since they're  
> no longer relevant.

This was discussed when the CMake system was implemented and it was agreed  
that it is absolutely still relevant. They are not defunct, and Georg  
Mischler for one still uses them. So, they should stay.

> 6 - Building using Shared libraries doesn't work. Code is generated but  
> attempting to build generates loads of linker errors. Again not a massive  
> issue since static builds work fine & the compiled binaries are small  
> enough that they're unlikely to save much anyway but I thought I should  
> mention it.

Good point. Something else for the to-do list.

> 7 - 2107 warnings during build. Some of these may be due to me using VS  
> 2010 while NREL use VS 2008 however but even still it's rather high for  
> such a small code base.

Mmm, I generally don't get too worked up about warnings, but maybe we can  
look into this at some point.

> That's it so far. I have to say it's a giant leap from the old decrepit  
> Scons system. Building now takes minutes once you've downloaded the code  
> rather than hours (and actually works 'out of the box' without requiring  
> a load of manual tweaking).

Good news Pally, glad you're able to make use of it. I just got a new  
MacBook Pro and the very first thing I installed on it was CMake, and  
grabbed the Radiance source. The whole project built in 11 seconds (using  
all "eight" cores), no kidding.

Thanks very much for this summary. I would like to use some of your info  
when I eventually get around to making a HOWTO for this.

> falsecolor , genBSDF, genklemsamp, genskyvec are all Perl scripts. At  
> present, they require a Perl interpreter to be installed. It is  
> possible to compile them into exe files using PAR::Packer. I've  
> successfully done this with falsecolor, but this is not part of the  
> build system yet (not in Classic and not in NREL). I believe it's one  
> of Rob's nice-but-not-essential items on his to-do list.

Yeah, it would be nice to compile all of those, but then again since there  
are still a great many Radiance bits implemented as csh scripts, I sorta  
feel like converting those should be more of a priority than eliminating a  
couple of simple deps. Believe it or not, I just got an email from someone  
yesterday asking where "phisto" was in his Windows installation. I didn't  
even know that one was a csh script until I looked!

> objview for Windows is a Ruby script. This should probably be  
> re-written in Perl to avoid unnecessary folking of the source tree and  
> extra deps for non-OpenStudio users.

I respectfully disagree, Axel. I think reimplementing objview in Perl  
would be a step backwards, and just another duplicated effort. I'd rather  
see other csh scripts get converted (and then compiled, at which point the  
language of choice becomes moot), personally.

- Rob

> **···**
>
> On 9/6/12 10:10 AM, "Pally Sandher" \<pally.sandher@iesve.com\> wrote:  
> On 9/6/12 10:26 AM, "Axel Jacobs" \<jacobs.axel@gmail.com\> wrote:

---

<div class="post-metadata">

**Author:** ![Guglielmetti\_Robert](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/g/bb73d2/32.png) [@Guglielmetti\_Robert](https://discourse.radiance-online.org/u/Guglielmetti_Robert)\
**Post date:** [September 7, 2012, 1:55am UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/4 "2012-09-07T01:55:56Z")

</div>

Following up on my post from earlier today, this project seems promising for making Windows executables from Ruby code:

[http://ocra.rubyforge.org](http://ocra.rubyforge.org)

It's not cross platform, but it's something.

Andy, here is the page I was thinking about:

[http://www.radiance-online.org/learning/documentation/manual-pages](http://www.radiance-online.org/learning/documentation/manual-pages)

We could easily make a link to this page in the /man folder for Windows installs. The thing is I see that rcontrib is not linked on that page. What is the mechanism for updating that page and the linked pages? We'd only want to link to something that's always up to date. Alternatively, does anyone have any ideas or workflows for automatically generating pdfs of manpages on Windows? I'd much rather just include pdf versions on the Windows installers (or as Pally mentioned, maybe there's a way to build a Windows help file from them? I know nothing about Windows help files).

Just thinking out loud.

- Rob

> **···**
>
> \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_  
> From: Guglielmetti, Robert  
> Sent: Thursday, September 06, 2012 12:13 PM  
> To: code development; Andrew McNeil  
> Subject: Re: [Radiance-dev] Compiling from source on Windows platforms
> 
> Thanks Pally for this nice summary overview. I am very remiss in getting  
> something like this posted to the OpenStudio support page. Thanks Axel for  
> your responses as well. Replies to both of you within...
> 
> - Rob
> 
> On 9/6/12 10:10 AM, "Pally Sandher" \<pally.sandher@iesve.com\> wrote:
> 
> > 4 - The Radiance source including CMake files. Easiest way to get these  
> > is to go to [http://public.kitware.com/gitweb?p=radiance.git;a=tree](http://public.kitware.com/gitweb?p=radiance.git;a=tree) &  
> > click the "snapshot" link in the top left corner to download a .tar.gz  
> > archive. The 4.1 release of the source doesn't have any of the CMake  
> > files so you have to use the latest from the repository until an official  
> > 4.2 is released.
> 
> Actually the easiest way to grab the latest source tree is to install git  
> and just make a clone of the repo on your system:
> 
> $ git clone [http://public.kitware.com/radiance.git](http://public.kitware.com/radiance.git)
> 
> This is a copy of the CVS repository, and it's updated nightly. To update  
> your git clone after the initial download, simply do a git pull while in  
> the CVS directory:
> 
> $ git pull
> 
> NREL plans to host a repo on Github which will allow me to update the repo  
> manually whenever Greg checks in a change. But for now the Kitware repo is  
> at least updated every evening at midnight.
> 
> > 5 - Qt libraries. These can either be installed using the pre-built  
> > packages or built from source, all of which are available from  
> > [http://qt.nokia.com/downloads\](http://qt.nokia.com/downloads%5C). I had built the Qt v4.8.2 libraries from  
> > source previously so used that.
> 
> The installer works fine too.
> 
> > 6 - Tiff library for Windows. Again this can either be installed using a  
> > pre-built package or built from source. You can find this at  
> > [Tiff for Windows](http://gnuwin32.sourceforge.net/packages/tiff.htm) I used the pre-built  
> > package as the sources are configured to be built with Visual Studio 6 &  
> > wasn't in the mood to update it just to build a .lib file.
> 
> Yup, I use the installer for this as well. Easier.
> 
> > You should then be able to load up CMake, point it at the root of the  
> > Radiance source tree, give it a build directory (I suggest something like  
> > "build" inside the extracted source directory to keep things together) &  
> > click Configure. Assuming no errors, you should then be able to click  
> > Generate & you'll get a load of projects & solutions built. You can then  
> > open the solution and build the projects. It will output the files to  
> > \<build directory\>\bin\Release or \<build directory\>\bin\Debug\
> > 
> > At this point I suggest you download the zip archive of binaries and  
> > library files from  
> > [OpenStudio](https://openstudio.nrel.gov/getting-started-developer/getting-started-radi)  
> > ance as you only have a load of binaries which is great but you'll be  
> > missing crucial library files so you can't really do anything with your  
> > binaries (and no manuals either).
> 
> Make by default merely builds the executables. If you build the INSTALL  
> target, everything will be installed, including libraries, manual pages  
> and all the scripts (Perl and Ruby only on Windows, of course). This is  
> the same on the other platforms. "make install" will build all the  
> executables and copy everything else. The default behavior is to do this:
> 
> Binaries in /usr/local/radiance/bin  
> Library files in /usr/local/radiance/lib  
> Manpages in /usr/local/radiance/man
> 
> > A few issues I have with the above are as follows:  
> > 1 - Qt and libtiff are \*required\* for CMake to generate a build source.  
> > They should be optional & when not available the relevant projects which  
> > require them (rvu, ra\_tiff etc) should be omitted from the generated  
> > source. Zlib can be omitted without issue (not sure which project uses it  
> > though).
> 
> It would be more user-friendly to do that Pally, but honestly a LOT of the  
> effort around this project was to give Windows users access to programs  
> like rvu. I consider ra\_tiff and rvu to be critical programs in the  
> Radiance suite and to include them was a major goal of this project. We  
> can re-write the CMakeLists.txt files to function as you state, but it's  
> way down there on my priority list.
> 
> > 2 - CMake generates projects using Absolute paths rather than Relative  
> > paths. Major failure point as this requires manual updating of over 100  
> > projects with a minimum of 5 paths per project if you wish to fix this  
> > otherwise you must replicate the file structure on every machine you want  
> > to use the CMake generated build source. All other projects I've used  
> > which implement CMake will give you the option of using relative paths if  
> > you so wish.
> 
> I'm not sure I follow you here, but if you explain maybe I can fix what's  
> busted for you.
> 
> > 3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in  
> > the CMake build source. I assume this is due to them being Perl & Ruby  
> > scripts in the NREL binaries archive (falsecolor appears to have C source  
> > code available?)
> 
> Right. Again, these are installed and suffixed per convention (i.e. The  
> suffixes are removed on UNIX systems), when the INSTALL target is made.
> 
> > 4 - manuals are in unix man/postscript format which unsurprisingly isn't  
> > widely supported on Windows. Should preferably be Compiled HTML Help  
> > (.chm) or at the very least converted to HTML or PDF to make them more  
> > readable.
> 
> Totally agree. This is also on the list of nice-to-haves, I just haven't  
> had time to figure out an automated way to do that on Windows. The  
> manpages are updated on the radiance-online.org site, however. Maybe we  
> should just generate a link to them in the /man directory on Windows  
> builds for now. (?)
> 
> Andy, how do those updates work? I can't access the radiance-online.org  
> site from work because of our firewall crap, but I'm pretty sure there's a  
> link there with links to pdf versions of all the manpages, right?
> 
> > 5 - Radiance source is littered with the now defunct Scons build files.  
> > Not a massive issue but they should probably be cleaned out since they're  
> > no longer relevant.
> 
> This was discussed when the CMake system was implemented and it was agreed  
> that it is absolutely still relevant. They are not defunct, and Georg  
> Mischler for one still uses them. So, they should stay.
> 
> > 6 - Building using Shared libraries doesn't work. Code is generated but  
> > attempting to build generates loads of linker errors. Again not a massive  
> > issue since static builds work fine & the compiled binaries are small  
> > enough that they're unlikely to save much anyway but I thought I should  
> > mention it.
> 
> Good point. Something else for the to-do list.
> 
> > 7 - 2107 warnings during build. Some of these may be due to me using VS  
> > 2010 while NREL use VS 2008 however but even still it's rather high for  
> > such a small code base.
> 
> Mmm, I generally don't get too worked up about warnings, but maybe we can  
> look into this at some point.
> 
> > That's it so far. I have to say it's a giant leap from the old decrepit  
> > Scons system. Building now takes minutes once you've downloaded the code  
> > rather than hours (and actually works 'out of the box' without requiring  
> > a load of manual tweaking).
> 
> Good news Pally, glad you're able to make use of it. I just got a new  
> MacBook Pro and the very first thing I installed on it was CMake, and  
> grabbed the Radiance source. The whole project built in 11 seconds (using  
> all "eight" cores), no kidding.
> 
> Thanks very much for this summary. I would like to use some of your info  
> when I eventually get around to making a HOWTO for this.
> 
> On 9/6/12 10:26 AM, "Axel Jacobs" \<jacobs.axel@gmail.com\> wrote:
> 
> > falsecolor , genBSDF, genklemsamp, genskyvec are all Perl scripts. At  
> > present, they require a Perl interpreter to be installed. It is  
> > possible to compile them into exe files using PAR::Packer. I've  
> > successfully done this with falsecolor, but this is not part of the  
> > build system yet (not in Classic and not in NREL). I believe it's one  
> > of Rob's nice-but-not-essential items on his to-do list.
> 
> Yeah, it would be nice to compile all of those, but then again since there  
> are still a great many Radiance bits implemented as csh scripts, I sorta  
> feel like converting those should be more of a priority than eliminating a  
> couple of simple deps. Believe it or not, I just got an email from someone  
> yesterday asking where "phisto" was in his Windows installation. I didn't  
> even know that one was a csh script until I looked!
> 
> > objview for Windows is a Ruby script. This should probably be  
> > re-written in Perl to avoid unnecessary folking of the source tree and  
> > extra deps for non-OpenStudio users.
> 
> I respectfully disagree, Axel. I think reimplementing objview in Perl  
> would be a step backwards, and just another duplicated effort. I'd rather  
> see other csh scripts get converted (and then compiled, at which point the  
> language of choice becomes moot), personally.
> 
> - Rob

---

<div class="post-metadata">

**Author:** ![Andrew\_McNeil2](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/a/958977/32.png) [@Andrew\_McNeil2](https://discourse.radiance-online.org/u/Andrew_McNeil2)\
**Post date:** [September 7, 2012, 5:01pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/5 "2012-09-07T17:01:15Z")

</div>

I have a script that creates all the pdfs, then I upload them. New  
programs require manually adding new links. Not ideal, but not difficult.  
I was only planning to update the man page pdfs at each official release.  
I figured those using the online pdf's were probably also using official  
releases — using the HEAD used to require compiling so HEAD users were  
likely familiar with the "man" command.

Installers of the HEAD release changes all my assumptions, so maybe pdfs  
need to be automatically updated.

Andy

> **···**
>
> On Thu, Sep 6, 2012 at 6:55 PM, Guglielmetti, Robert \< Robert.Guglielmetti@nrel.gov\> wrote:
> 
> > Following up on my post from earlier today, this project seems promising  
> > for making Windows executables from Ruby code:
> > 
> > [http://ocra.rubyforge.org](http://ocra.rubyforge.org)
> > 
> > It's not cross platform, but it's something.
> > 
> > Andy, here is the page I was thinking about:
> > 
> > [http://www.radiance-online.org/learning/documentation/manual-pages](http://www.radiance-online.org/learning/documentation/manual-pages)
> > 
> > We could easily make a link to this page in the /man folder for Windows  
> > installs. The thing is I see that rcontrib is not linked on that page. What  
> > is the mechanism for updating that page and the linked pages? We'd only  
> > want to link to something that's always up to date. Alternatively, does  
> > anyone have any ideas or workflows for automatically generating pdfs of  
> > manpages on Windows? I'd much rather just include pdf versions on the  
> > Windows installers (or as Pally mentioned, maybe there's a way to build a  
> > Windows help file from them? I know nothing about Windows help files).
> > 
> > Just thinking out loud.
> > 
> > - Rob
> > 
> > \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_  
> > From: Guglielmetti, Robert  
> > Sent: Thursday, September 06, 2012 12:13 PM  
> > To: code development; Andrew McNeil  
> > Subject: Re: [Radiance-dev] Compiling from source on Windows platforms
> > 
> > Thanks Pally for this nice summary overview. I am very remiss in getting  
> > something like this posted to the OpenStudio support page. Thanks Axel for  
> > your responses as well. Replies to both of you within...
> > 
> > - Rob
> > 
> > On 9/6/12 10:10 AM, "Pally Sandher" \<pally.sandher@iesve.com\> wrote:  
> > \>4 - The Radiance source including CMake files. Easiest way to get these  
> > \>is to go to [http://public.kitware.com/gitweb?p=radiance.git;a=tree](http://public.kitware.com/gitweb?p=radiance.git;a=tree) &  
> > \>click the "snapshot" link in the top left corner to download a .tar.gz  
> > \>archive. The 4.1 release of the source doesn't have any of the CMake  
> > \>files so you have to use the latest from the repository until an official  
> > \>4.2 is released.
> > 
> > Actually the easiest way to grab the latest source tree is to install git  
> > and just make a clone of the repo on your system:
> > 
> > $ git clone [http://public.kitware.com/radiance.git](http://public.kitware.com/radiance.git)
> > 
> > This is a copy of the CVS repository, and it's updated nightly. To update  
> > your git clone after the initial download, simply do a git pull while in  
> > the CVS directory:
> > 
> > $ git pull
> > 
> > NREL plans to host a repo on Github which will allow me to update the repo  
> > manually whenever Greg checks in a change. But for now the Kitware repo is  
> > at least updated every evening at midnight.
> > 
> > \>5 - Qt libraries. These can either be installed using the pre-built  
> > \>packages or built from source, all of which are available from  
> > \>[http://qt.nokia.com/downloads\](http://qt.nokia.com/downloads%5C). I had built the Qt v4.8.2 libraries from  
> > \>source previously so used that.
> > 
> > The installer works fine too.
> > 
> > \>6 - Tiff library for Windows. Again this can either be installed using a  
> > \>pre-built package or built from source. You can find this at  
> > \>[Tiff for Windows](http://gnuwin32.sourceforge.net/packages/tiff.htm) I used the pre-built  
> > \>package as the sources are configured to be built with Visual Studio 6 &  
> > \>wasn't in the mood to update it just to build a .lib file.
> > 
> > Yup, I use the installer for this as well. Easier.
> > 
> > \>You should then be able to load up CMake, point it at the root of the  
> > \>Radiance source tree, give it a build directory (I suggest something like  
> > \>"build" inside the extracted source directory to keep things together) &  
> > \>click Configure. Assuming no errors, you should then be able to click  
> > \>Generate & you'll get a load of projects & solutions built. You can then  
> > \>open the solution and build the projects. It will output the files to  
> > \>\<build directory\>\bin\Release or \<build directory\>\bin\Debug\  
> > \>  
> > \>At this point I suggest you download the zip archive of binaries and  
> > \>library files from  
> > \>  
> > [OpenStudio](https://openstudio.nrel.gov/getting-started-developer/getting-started-radi)  
> > \>ance as you only have a load of binaries which is great but you'll be  
> > \>missing crucial library files so you can't really do anything with your  
> > \>binaries (and no manuals either).
> > 
> > Make by default merely builds the executables. If you build the INSTALL  
> > target, everything will be installed, including libraries, manual pages  
> > and all the scripts (Perl and Ruby only on Windows, of course). This is  
> > the same on the other platforms. "make install" will build all the  
> > executables and copy everything else. The default behavior is to do this:
> > 
> > Binaries in /usr/local/radiance/bin  
> > Library files in /usr/local/radiance/lib  
> > Manpages in /usr/local/radiance/man
> > 
> > \>A few issues I have with the above are as follows:  
> > \>1 - Qt and libtiff are \*required\* for CMake to generate a build source.  
> > \>They should be optional & when not available the relevant projects which  
> > \>require them (rvu, ra\_tiff etc) should be omitted from the generated  
> > \>source. Zlib can be omitted without issue (not sure which project uses it  
> > \>though).
> > 
> > It would be more user-friendly to do that Pally, but honestly a LOT of the  
> > effort around this project was to give Windows users access to programs  
> > like rvu. I consider ra\_tiff and rvu to be critical programs in the  
> > Radiance suite and to include them was a major goal of this project. We  
> > can re-write the CMakeLists.txt files to function as you state, but it's  
> > way down there on my priority list.
> > 
> > \>2 - CMake generates projects using Absolute paths rather than Relative  
> > \>paths. Major failure point as this requires manual updating of over 100  
> > \>projects with a minimum of 5 paths per project if you wish to fix this  
> > \>otherwise you must replicate the file structure on every machine you want  
> > \>to use the CMake generated build source. All other projects I've used  
> > \>which implement CMake will give you the option of using relative paths if  
> > \>you so wish.
> > 
> > I'm not sure I follow you here, but if you explain maybe I can fix what's  
> > busted for you.
> > 
> > \>3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in  
> > \>the CMake build source. I assume this is due to them being Perl & Ruby  
> > \>scripts in the NREL binaries archive (falsecolor appears to have C source  
> > \>code available?)
> > 
> > Right. Again, these are installed and suffixed per convention (i.e. The  
> > suffixes are removed on UNIX systems), when the INSTALL target is made.
> > 
> > \>4 - manuals are in unix man/postscript format which unsurprisingly isn't  
> > \>widely supported on Windows. Should preferably be Compiled HTML Help  
> > \>(.chm) or at the very least converted to HTML or PDF to make them more  
> > \>readable.
> > 
> > Totally agree. This is also on the list of nice-to-haves, I just haven't  
> > had time to figure out an automated way to do that on Windows. The  
> > manpages are updated on the radiance-online.org site, however. Maybe we  
> > should just generate a link to them in the /man directory on Windows  
> > builds for now. (?)
> > 
> > Andy, how do those updates work? I can't access the radiance-online.org  
> > site from work because of our firewall crap, but I'm pretty sure there's a  
> > link there with links to pdf versions of all the manpages, right?
> > 
> > \>5 - Radiance source is littered with the now defunct Scons build files.  
> > \>Not a massive issue but they should probably be cleaned out since they're  
> > \>no longer relevant.
> > 
> > This was discussed when the CMake system was implemented and it was agreed  
> > that it is absolutely still relevant. They are not defunct, and Georg  
> > Mischler for one still uses them. So, they should stay.
> > 
> > \>6 - Building using Shared libraries doesn't work. Code is generated but  
> > \>attempting to build generates loads of linker errors. Again not a massive  
> > \>issue since static builds work fine & the compiled binaries are small  
> > \>enough that they're unlikely to save much anyway but I thought I should  
> > \>mention it.
> > 
> > Good point. Something else for the to-do list.
> > 
> > \>7 - 2107 warnings during build. Some of these may be due to me using VS  
> > \>2010 while NREL use VS 2008 however but even still it's rather high for  
> > \>such a small code base.
> > 
> > Mmm, I generally don't get too worked up about warnings, but maybe we can  
> > look into this at some point.
> > 
> > \>That's it so far. I have to say it's a giant leap from the old decrepit  
> > \>Scons system. Building now takes minutes once you've downloaded the code  
> > \>rather than hours (and actually works 'out of the box' without requiring  
> > \>a load of manual tweaking).
> > 
> > Good news Pally, glad you're able to make use of it. I just got a new  
> > MacBook Pro and the very first thing I installed on it was CMake, and  
> > grabbed the Radiance source. The whole project built in 11 seconds (using  
> > all "eight" cores), no kidding.
> > 
> > Thanks very much for this summary. I would like to use some of your info  
> > when I eventually get around to making a HOWTO for this.
> > 
> > On 9/6/12 10:26 AM, "Axel Jacobs" \<jacobs.axel@gmail.com\> wrote:
> > 
> > \>falsecolor , genBSDF, genklemsamp, genskyvec are all Perl scripts. At  
> > \>present, they require a Perl interpreter to be installed. It is  
> > \>possible to compile them into exe files using PAR::Packer. I've  
> > \>successfully done this with falsecolor, but this is not part of the  
> > \>build system yet (not in Classic and not in NREL). I believe it's one  
> > \>of Rob's nice-but-not-essential items on his to-do list.
> > 
> > Yeah, it would be nice to compile all of those, but then again since there  
> > are still a great many Radiance bits implemented as csh scripts, I sorta  
> > feel like converting those should be more of a priority than eliminating a  
> > couple of simple deps. Believe it or not, I just got an email from someone  
> > yesterday asking where "phisto" was in his Windows installation. I didn't  
> > even know that one was a csh script until I looked!
> > 
> > \>objview for Windows is a Ruby script. This should probably be  
> > \>re-written in Perl to avoid unnecessary folking of the source tree and  
> > \>extra deps for non-OpenStudio users.
> > 
> > I respectfully disagree, Axel. I think reimplementing objview in Perl  
> > would be a step backwards, and just another duplicated effort. I'd rather  
> > see other csh scripts get converted (and then compiled, at which point the  
> > language of choice becomes moot), personally.
> > 
> > - Rob

---

<div class="post-metadata">

**Author:** ![Guglielmetti\_Robert](https://discourse.radiance-online.org/letter_avatar_proxy/v4/letter/g/bb73d2/32.png) [@Guglielmetti\_Robert](https://discourse.radiance-online.org/u/Guglielmetti_Robert)\
**Post date:** [September 7, 2012, 5:25pm UTC](https://discourse.radiance-online.org/t/compiling-from-source-on-windows-platforms/606/6 "2012-09-07T17:25:54Z")

</div>

Mmm. Definitely a fair assumption, but for sure our HEAD installers turn that on its head. Well, this is definitely an item for the ole' todo list. I just don't know when we'll get around to it.

Pally, if you have any good leads on how to create chm files from manpages, I'm all ears…

Rob Guglielmetti  
National Renewable Energy Laboratory (NREL)  
Commercial Buildings Research Group  
15013 Denver West Parkway MS:RSF202  
Golden, CO 80401  
303.275.4319  
robert.guglielmetti@nrel.gov

> **···**
>
> On 9/7/12 11:01 AM, "Andrew McNeil" \<amcneil@lbl.gov\<mailto:amcneil@lbl.gov\>\> wrote:
> 
> I have a script that creates all the pdfs, then I upload them. New programs require manually adding new links. Not ideal, but not difficult. I was only planning to update the man page pdfs at each official release. I figured those using the online pdf's were probably also using official releases — using the HEAD used to require compiling so HEAD users were likely familiar with the "man" command.
> 
> Installers of the HEAD release changes all my assumptions, so maybe pdfs need to be automatically updated.
> 
> Andy
> 
> On Thu, Sep 6, 2012 at 6:55 PM, Guglielmetti, Robert \<Robert.Guglielmetti@nrel.gov\<mailto:Robert.Guglielmetti@nrel.gov\>\> wrote:  
> Following up on my post from earlier today, this project seems promising for making Windows executables from Ruby code:
> 
> [http://ocra.rubyforge.org](http://ocra.rubyforge.org)
> 
> It's not cross platform, but it's something.
> 
> Andy, here is the page I was thinking about:
> 
> [http://www.radiance-online.org/learning/documentation/manual-pages](http://www.radiance-online.org/learning/documentation/manual-pages)
> 
> We could easily make a link to this page in the /man folder for Windows installs. The thing is I see that rcontrib is not linked on that page. What is the mechanism for updating that page and the linked pages? We'd only want to link to something that's always up to date. Alternatively, does anyone have any ideas or workflows for automatically generating pdfs of manpages on Windows? I'd much rather just include pdf versions on the Windows installers (or as Pally mentioned, maybe there's a way to build a Windows help file from them? I know nothing about Windows help files).
> 
> Just thinking out loud.
> 
> - Rob
> 
> \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_  
> From: Guglielmetti, Robert  
> Sent: Thursday, September 06, 2012 12:13 PM  
> To: code development; Andrew McNeil  
> Subject: Re: [Radiance-dev] Compiling from source on Windows platforms
> 
> Thanks Pally for this nice summary overview. I am very remiss in getting  
> something like this posted to the OpenStudio support page. Thanks Axel for  
> your responses as well. Replies to both of you within...
> 
> - Rob
> 
> On 9/6/12 10:10 AM, "Pally Sandher" \<pally.sandher@iesve.com\<mailto:pally.sandher@iesve.com\>\> wrote:
> 
> > 4 - The Radiance source including CMake files. Easiest way to get these  
> > is to go to [http://public.kitware.com/gitweb?p=radiance.git;a=tree](http://public.kitware.com/gitweb?p=radiance.git;a=tree) &  
> > click the "snapshot" link in the top left corner to download a .tar.gz  
> > archive. The 4.1 release of the source doesn't have any of the CMake  
> > files so you have to use the latest from the repository until an official  
> > 4.2 is released.
> 
> Actually the easiest way to grab the latest source tree is to install git  
> and just make a clone of the repo on your system:
> 
> $ git clone [http://public.kitware.com/radiance.git](http://public.kitware.com/radiance.git)
> 
> This is a copy of the CVS repository, and it's updated nightly. To update  
> your git clone after the initial download, simply do a git pull while in  
> the CVS directory:
> 
> $ git pull
> 
> NREL plans to host a repo on Github which will allow me to update the repo  
> manually whenever Greg checks in a change. But for now the Kitware repo is  
> at least updated every evening at midnight.
> 
> > 5 - Qt libraries. These can either be installed using the pre-built  
> > packages or built from source, all of which are available from  
> > [http://qt.nokia.com/downloads\](http://qt.nokia.com/downloads%5C). I had built the Qt v4.8.2 libraries from  
> > source previously so used that.
> 
> The installer works fine too.
> 
> > 6 - Tiff library for Windows. Again this can either be installed using a  
> > pre-built package or built from source. You can find this at  
> > [Tiff for Windows](http://gnuwin32.sourceforge.net/packages/tiff.htm) I used the pre-built  
> > package as the sources are configured to be built with Visual Studio 6 &  
> > wasn't in the mood to update it just to build a .lib file.
> 
> Yup, I use the installer for this as well. Easier.
> 
> > You should then be able to load up CMake, point it at the root of the  
> > Radiance source tree, give it a build directory (I suggest something like  
> > "build" inside the extracted source directory to keep things together) &  
> > click Configure. Assuming no errors, you should then be able to click  
> > Generate & you'll get a load of projects & solutions built. You can then  
> > open the solution and build the projects. It will output the files to  
> > \<build directory\>\bin\Release or \<build directory\>\bin\Debug\
> > 
> > At this point I suggest you download the zip archive of binaries and  
> > library files from  
> > [OpenStudio](https://openstudio.nrel.gov/getting-started-developer/getting-started-radi)  
> > ance as you only have a load of binaries which is great but you'll be  
> > missing crucial library files so you can't really do anything with your  
> > binaries (and no manuals either).
> 
> Make by default merely builds the executables. If you build the INSTALL  
> target, everything will be installed, including libraries, manual pages  
> and all the scripts (Perl and Ruby only on Windows, of course). This is  
> the same on the other platforms. "make install" will build all the  
> executables and copy everything else. The default behavior is to do this:
> 
> Binaries in /usr/local/radiance/bin  
> Library files in /usr/local/radiance/lib  
> Manpages in /usr/local/radiance/man
> 
> > A few issues I have with the above are as follows:  
> > 1 - Qt and libtiff are \*required\* for CMake to generate a build source.  
> > They should be optional & when not available the relevant projects which  
> > require them (rvu, ra\_tiff etc) should be omitted from the generated  
> > source. Zlib can be omitted without issue (not sure which project uses it  
> > though).
> 
> It would be more user-friendly to do that Pally, but honestly a LOT of the  
> effort around this project was to give Windows users access to programs  
> like rvu. I consider ra\_tiff and rvu to be critical programs in the  
> Radiance suite and to include them was a major goal of this project. We  
> can re-write the CMakeLists.txt files to function as you state, but it's  
> way down there on my priority list.
> 
> > 2 - CMake generates projects using Absolute paths rather than Relative  
> > paths. Major failure point as this requires manual updating of over 100  
> > projects with a minimum of 5 paths per project if you wish to fix this  
> > otherwise you must replicate the file structure on every machine you want  
> > to use the CMake generated build source. All other projects I've used  
> > which implement CMake will give you the option of using relative paths if  
> > you so wish.
> 
> I'm not sure I follow you here, but if you explain maybe I can fix what's  
> busted for you.
> 
> > 3 - falsecolor , genBSDF, genklemsamp, genskyvec & objview don't exist in  
> > the CMake build source. I assume this is due to them being Perl & Ruby  
> > scripts in the NREL binaries archive (falsecolor appears to have C source  
> > code available?)
> 
> Right. Again, these are installed and suffixed per convention (i.e. The  
> suffixes are removed on UNIX systems), when the INSTALL target is made.
> 
> > 4 - manuals are in unix man/postscript format which unsurprisingly isn't  
> > widely supported on Windows. Should preferably be Compiled HTML Help  
> > (.chm) or at the very least converted to HTML or PDF to make them more  
> > readable.
> 
> Totally agree. This is also on the list of nice-to-haves, I just haven't  
> had time to figure out an automated way to do that on Windows. The  
> manpages are updated on the radiance-online.org\<[http://radiance-online.org](http://radiance-online.org)\> site, however. Maybe we  
> should just generate a link to them in the /man directory on Windows  
> builds for now. (?)
> 
> Andy, how do those updates work? I can't access the radiance-online.org\<[http://radiance-online.org](http://radiance-online.org)\>  
> site from work because of our firewall crap, but I'm pretty sure there's a  
> link there with links to pdf versions of all the manpages, right?
> 
> > 5 - Radiance source is littered with the now defunct Scons build files.  
> > Not a massive issue but they should probably be cleaned out since they're  
> > no longer relevant.
> 
> This was discussed when the CMake system was implemented and it was agreed  
> that it is absolutely still relevant. They are not defunct, and Georg  
> Mischler for one still uses them. So, they should stay.
> 
> > 6 - Building using Shared libraries doesn't work. Code is generated but  
> > attempting to build generates loads of linker errors. Again not a massive  
> > issue since static builds work fine & the compiled binaries are small  
> > enough that they're unlikely to save much anyway but I thought I should  
> > mention it.
> 
> Good point. Something else for the to-do list.
> 
> > 7 - 2107 warnings during build. Some of these may be due to me using VS  
> > 2010 while NREL use VS 2008 however but even still it's rather high for  
> > such a small code base.
> 
> Mmm, I generally don't get too worked up about warnings, but maybe we can  
> look into this at some point.
> 
> > That's it so far. I have to say it's a giant leap from the old decrepit  
> > Scons system. Building now takes minutes once you've downloaded the code  
> > rather than hours (and actually works 'out of the box' without requiring  
> > a load of manual tweaking).
> 
> Good news Pally, glad you're able to make use of it. I just got a new  
> MacBook Pro and the very first thing I installed on it was CMake, and  
> grabbed the Radiance source. The whole project built in 11 seconds (using  
> all "eight" cores), no kidding.
> 
> Thanks very much for this summary. I would like to use some of your info  
> when I eventually get around to making a HOWTO for this.
> 
> On 9/6/12 10:26 AM, "Axel Jacobs" \<jacobs.axel@gmail.com\<mailto:jacobs.axel@gmail.com\>\> wrote:
> 
> > falsecolor , genBSDF, genklemsamp, genskyvec are all Perl scripts. At  
> > present, they require a Perl interpreter to be installed. It is  
> > possible to compile them into exe files using PAR::Packer. I've  
> > successfully done this with falsecolor, but this is not part of the  
> > build system yet (not in Classic and not in NREL). I believe it's one  
> > of Rob's nice-but-not-essential items on his to-do list.
> 
> Yeah, it would be nice to compile all of those, but then again since there  
> are still a great many Radiance bits implemented as csh scripts, I sorta  
> feel like converting those should be more of a priority than eliminating a  
> couple of simple deps. Believe it or not, I just got an email from someone  
> yesterday asking where "phisto" was in his Windows installation. I didn't  
> even know that one was a csh script until I looked!
> 
> > objview for Windows is a Ruby script. This should probably be  
> > re-written in Perl to avoid unnecessary folking of the source tree and  
> > extra deps for non-OpenStudio users.
> 
> I respectfully disagree, Axel. I think reimplementing objview in Perl  
> would be a step backwards, and just another duplicated effort. I'd rather  
> see other csh scripts get converted (and then compiled, at which point the  
> language of choice becomes moot), personally.
> 
> - Rob
