caret

Debian packaging of good old caret

Building on Ubuntu

pre-patch

The debianization requires that all modifications to the upstream source be put in patches. If changes are made to files outside of the debian/ folder, then the patch should be added to git, but the patched file should remain unmodified. The dquilt patch -a command applies the patch and restores the modifications.

Changes made to files inside the debian/ folder and subfolders should be committed directly - do not patch files in debian/!

I've done away with this nonsense and hassle with the patched branches - see below. These notes are for posterity....

1. Build deps
2. git clone
3. dquilt patch -a
4. debian/rules build | tee build.log 2>&1
5. dpkg-buildpackage -b -us -uc -nc -rfakeroot

• -b : binary package, please
• -us : unsigned package
• -uc : unsigned changes file
• -nc : no clean - saves a LOT of time in building. Without this, build will clean first.
• -rfakeroot : needed to build deb package right

post-patch branches

These branches (splash-patched and beyond) have the patches applied and changes committed. For one thing this makes development on windows a lot easier. For another thing, why not? Upstream caret development is basically dead, so preserving these patches in the event some upstream change makes its way down here to caret is, well, a waste IMHO.

Building windows packages

1. Qt 4.8 - have to build this to make it all work. I found a site that patched a version of the source.
   • git clone https://github.com/scharsig/Qt.git
   • run MSVC "vcvars32.bat" to set environment for building 32 bit stuff (though I think the platform arg below takes care of that)
   • cd qt-4.8.7-vs2017
   • configure.exe -release -opensource -static -platform win32-msvc2017
   • nmake
2. VTK
3. QWT
   • download qwt 5.2.3 source (compatible with qt4)
   • set PATH to use qmake from Qt4.8 (32 bit)
   • nmake install puts all in c:\Qwt-5.2.3 (configurable in qwtConfig.pri)
4. netCDF
   • Download binaries for 32-bit netCDF-4 (legacy) here
   • Install in a directory without spaces! Something like c:\netCDF-2.4.3. Default uses "Program Files (x86)" which is terrible. Don't.
5. HDF5
   • must register at HDF site before downloading installer.
   • download 32 bit version, older builds only, 1.8.20 has 32 bit msvc 2015 build....
   • this lib will give us zlib (used to build NIFTI and CARET)
6. nifti
   • git clone https://github.com/djsperka/NIFTI.git
   • cd NIFTI
   • set ZLIB_ROOT=C:/HDF5-1.8.20-win32 (NOTE: forward slash, no spaces) - run cmake-gui with this in env.
   • installs in c:/NIFTI
7. libminc
   • git clone https://github.com/djsperka/libminc.git
   • (switch branch) git checkout libmin1-win32
   • env var: set NETCDF_DIR="C:\Program Files (x86)\netCDF 4.7.3" (adjust dir accordingly)
   • env var: set HDF5_DIR="C:\Program Files (x86)\HDF_Group\HDF5\1.8.20\cmake" (adjust dir accordingly, and yes, use cmake dir)
   • run cmake-gui, click "Generate", select "Win32" generator. (will fail first time)
   • fix these values:
     • BUILD_TESTING (OFF)
     • LIBMINC_MINC1_SUPPORT - check this box
     • LIBMINC_USE_SYSTEM_NIFTI - check this box (requires setting the 4 vals below)
   • re-run
   • Open MSVC project, build "Release" "Win32", for project "ALL_BUILD"
   • Build "INSTALL" project