====== Installation of Therion including Loch on MacOS X ====== \\ * //This guide is for system 10.5 (checked for 10.6.5 too). Older systems may require more pieces of the puzzle to install.// * //The installation is not complicated, but it is not the "double-click on image and drag and drop" kind of installation. // * //You should have administrator rights to install all of the parts. // * //Try to play a bit with Terminal program before you start. You'll need to use it to change several parameters of the installation packages and at the end to start Xtherion editor itself.// * //It is recommended to run the system disk "Repair Disk Permissions" from Disk Utility program after each step. // * //If you are *X guru, you may do all the steps your way, of course.// ---- \\ === 1. MacOSX === First of all install Mac OS X system and all updates. There could be problem with MacOS X **10.6.n** - xtherion doesn't recognize **thconfig** files to open it directly from Xtherion. So you should start Xtherion together with particular **thconfig**: xtherion your_thconfig_file The trick you may use it to use "thconfig" as file extension - file.thconfig and Xtherion will recognize you configuration file. ---- \\ === 2. X-Code === Install **X-Code** (developer tools) from installation DVD of Mac OS X. You have to update it to the latest version of XCode - version 3.2.1 (20091102). ---- \\ === 3. Tcl/Tk === The **Tcl/Tk** distribution is part of X-Code installation, but the latest version you'll find here: http://www.activestate.com/downloads'' -> click Tcl tab -> download Active Tcl'' \\ And you can find help on site of some [[http://cvresumewriters.com/cv-writer.php|cv writer]] Installation is straightforward – just mount the image by double-click and run install program. \\ \\ To use your newly installed latest version of ''Tcl'' you must modify the link where programs are looking for ''Tcl''. Open the application ''Terminal'' and write on the command line: sudo rm /usr/bin/wish press ''[Enter]'' and write your administrator password when prompted, press ''[Enter]''.\\ Update instalation of ActiveTCL: sudo teacup update press ''[Enter]'' and write your administrator password if prompted (perhaps not), press ''[Enter]''. \\After update create softlink to application wish: sudo ln -s /usr/local/bin/wish8.5 /opt/local/bin/wish (the number must be the actual version of ''Active Tcl'' you installed) \\ press ''[Enter]'' and write your administrator password if prompted (perhaps not), press ''[Enter]''. \\ \\ The others programs should find your latest version of ''Tcl'' now. \\ \\ You may verify it by typing on command line: wish [Enter] The application ''Wish'' should start. Switch to ''Wish'' application and check the version at ''About Tcl & Tk...'' under application menu. You may stop the ''Wish'' as usual - ''[Command]+Q''. \\ There could be a problem the wish application stopped with message it is not able to find something. In that case you should find and delete all other wish applicationsothers than in /usr/local/bin/wish8.5 directory or soft links from those in /usr/local/bin/wish8.5 and /opt/local/bin/wish directories. ---- \\ === 4. TeX === **TeX** package you'll find at: http://tug.org/mactex/morepackages.html Just download ''BasicTeX-2008.dmg'', mount the image and run install program. Find the ''therion.ini'' file (the path to it is on second line of compilation log - bottom window when run compile in xtherion) and change the path therion will look for ''metapost'' and ''pdftex'' programs: ### Paths to called executable files ### mpost-path "/usr/texbin/mpost" pdftex-path "/usr/texbin/pdfetex" #cavern-path "cavern" **SnowLeopard:** If there are problems with Metapost in compilation time check http://www.tug.org/mactex/faq/ section QM.09 and QM.10. You should download full instalation of MacTeX [[http://mirror.ctan.org/systems/mac/mactex/MacTeX.mpkg.zip|here]].\\ Christian Sandrini: When installing TeX make sure to use the big MacTeX application. Otherwise you will get some compilation errors when trying to compile the maps. ---- \\ === 5. Survex === **Survex** package for more sophisticated closure loops: http://survex.com/download.html?platform=macosx \\ -> click on MacOS X link, download image and install from it in the usual way. ---- \\ === 6. Therion === You may install **Therion** right now, but without **3D viewer Loch**. \\ Download the Therion package: http://therion.speleo.sk/download.php click on link ''Source code'' under paragraph ''Unstable version...'' That one is the latest version. Double-click on downloaded file and move the uncompressed folder to your Applications folder. Type in the terminal windov: cd /Applications/therion [Enter] make config-macosx [Enter] make [Enter] and wait until the compilation has finished. If you receive an error that reads "make[1]: pdftex: Command not found", you may need to add MacTeX to the beginning of your BASH path: PATH=/usr/texbin:$PATH Then, retry the make command. There could be an error at the end of compilation: "You have not right ... tclsh". In that case try to renew the symbolic link: sudo ln -s /usr/local/bin/tclsh8.5 /opt/local/bin/tclsh If there were no errors (excluding ''Loch'') then you may install ''therion'': sudo make install [Enter] After ''install'' is finished (there should be error message about Loch) you may start **Xtherion** editor by typing in Terminal window: xtherion [Enter] and the Xtherion editor should start. \\ \\ To use ''Survex'' loop closure method you should change two lines in ''therion.ini'' file: \\ Open application **TextEdit** and press ''[Command]+O'' (open file). When dialog window is opened press ''[Command]+[Shift]+G'' and write there ''/etc'' and press ''[Enter]''. Finder jumps to folder ''etc''. Scroll down to file ''therion.ini'', highlight it and press ''[Enter]''. It will open the file in ''TextEdit''. You should change two lines: \\ In section ''### Prefered loop closure method ###'' change # loop-closure therion to loop-closure survex (remove #). In section ''### Paths to called executable files ###'' change #cavern-path "cavern" to cavern-path "/Applications/Survex/cavern" (check if the path is OK). \\ \\ '' Save As'' the file to **Desktop** as ''therion.ini'' (check if the name is not the ''therion.ini.txt''!) Open new Finder window (double-click on icon of your system disk or press ''[Command]+N'' in Finder. When window is opened press ''[Command]+[Shift]+G'' and write there ''/etc'' and press ''[Enter]''. Move the ''therion.ini'' file from Desktop to ''etc'' folder. You should accept "replace original file" and authenticate it. ---- \\ === 7. VTK === And now follows the most complicated step - to install **VTK** (Visualization Toolkit) to run ''Loch''. == Installing VTK on Mac OS X == By drewmccormack at Thu, Jun 7 2007 7:01am http://macresearch.org/category/tutorials modified by Martin Sluka May 6 2009 (tested on 10.6.5 December 26 2010) **Mac OS X** is a great platform for 3D visualization. It includes ''OpenGL'' as standard, which means many existing libraries and applications can easily be ported to the platform. One such library is the ''Visualization Toolkit (VTK)'', an open source project run by ''Kitware, Inc''. ''VTK'' is at a level above ''OpenGL'': where ''OpenGL'' deals with simple polygons, ''VTK'' deals with isosurfaces, cut planes, and other 3D actors. It’s at a level useful to scientists, and relatively easy to learn. \\ \\ ''VTK'' works great on the Mac, and even has built in support for ''Carbon'' and ''Cocoa''. In the coming weeks, I will show you how to use ''VTK'' in ''Cocoa'' applications, but in this tutorial we will do a bit of preparation: we are going to compile and install ''VTK''. \\ \\ **Name Your Sources** \\ I want to begin by giving credit where it’s due: most of the information presented here has been stolen from a great piece on the VTK wiki by //Ryan Glover//. He covers building and installing ''VTK'' on the Mac for use with ''Cocoa'', and I will follow his instructions fairly closely here, just adding my experiences where appropriate. I also want to thank //Marc Baaden// before I get started, because this tutorial, and future ones, were largely inspired by him. He recently rewrote some code that I developed to demonstrate ''Cocoa'' and ''VTK'' integration many years ago, making it work on the latest versions of Mac OS X. We’ll meet that code in the next tutorial. **Installing CMake** \\ ''VTK'' uses an autoconf like tool called ''CMake'' to configure the make files used to build ''VTK''. So before you can build ''VTK'', you need to install ''CMake''. Go to the [[http://www.cmake.org/cmake/resources/software.html|CMake download site]] and locate the most recent binaries for your system (it doesn't matter that it is written .dmg installer only for Tiger there). The file is called something like ''cmake-2.x.x-Darwin-universal.dmg''. Download it, open the disk image and double click the package to install.\\ **Installing VTK5 (current version VTK6)** \\ Keep a watch of lowercase and uppercase characters. VTK_ALL is not the same as VTK_All!. \\ \\ Now to ''VTK'' itself. Go to the [[http://www.vtk.org/VTK/resources/software.html | VTK download page]] and download the latest **source** files. The file is called something like ''vtk-x.x.x.tar.gz'' file. Create folder ''VTK_All'' in folder ''Applications''. We will use that path for the rest of this tutorial. Move the downloaded file to folder ''/Applications/VTK_All''. Unpack the sources by double clicking the tar bundle. After unpacking, the sources themselves will be in ''/Applications/VTK_All/VTK''. Now we need to create a couple of folders: one is used for building, and one is for installing the ''VTK'' binaries. Create two folders in folder ''/Applications/VTK_All'' as follows ''/VTK_Build'' and ''/VTK_Bin''. To configure ready for building, change working folder to the ''VTK_Build'' folder, and run ''cmake'' passing the path to the ''VTK'' source root as argument. Write in ''Terminal'' window: cd /Applications/VTK_All/VTK_Build [Enter] cmake ../VTK [Enter] This will generate a file called ''CMakeCache.txt'' in the ''VTK_Build'' folder; this file contains the configuration that will be used to build ''VTK''. \\ \\ The default configuration may target ''Carbon'', rather than ''Cocoa'', so we need to make a few changes. Use ''TextEdit'' to open ''CMakeCache.txt'', and one by one, locate the lines shown below. Edit them as shown.\\ Thanks to Christian Sandrini: CMAKE_INSTALL_PREFIX:PATH=/Applications/VTK_ALL/VTK_Bin VTK_USE_COCOA:BOOL=ON VTK_USE_CARBON:BOOL=OFF CMAKE_OSX_DEPLOYMENT_TARGET:STRING=10.4 Check the following line CMAKE_OSX_ARCHITECTURES:STRING= and change to ''=ppc'' or ''=i386;x86_64'' according to processor in your computer. Save the file. Be sure the name of file is still ''CMakeCache.txt''. \\ \\ To update the build settings based on the changes you just made, rerun ''cmake'' from the ''VTK_Build'' folder. It will read the ''CMakeCache.txt'' file, and propagate the changes to the make files. Make sure you are in VTKBuild folder and issue the command: cmake ../VTK [Enter] We are finally ready to compile. Set the following environment variable to target ''Tiger'' export MACOSX_DEPLOYMENT_TARGET=10.4 [Enter] and then enter make -j 2 [Enter] The ''-j'' option will run the build in parallel, so that if you have a multi-core Mac, things will go much faster.\\ \\ Assuming that all goes well, the last step is to install the binaries in the ''VTK_Bin'' folder: sudo make install [Enter] With any luck, you should see that /''Applications/VTK_All/VT_KBin/'' contains ''include'' and ''lib'' folders, and you are ready to start using ''VTK'' in your ''Cocoa'' apps. ---- \\ === 8. Loch === At the end you need to edit the file ''Makefile'' in the ''loch'' folder of ''/Applications/therion'' folder. \\ \\ Open ''Makefile'' in ''TextEdit''. Find section ''# PLATFORM MACOSX'' and check the lines below (Thanks to Christian Sandrini): # PLATFORM MACOSX BITTINESS = -m32 CXX = c++ ${BITTINESS} CC = cc ${BITTINESS} VTKPATH = /Applications/VTK_All/VTK_Bin # change x.x to yours version of VTK VTKINCLUDEPATH = $(VTKPATH)/include/vtk-x.x VTKLIBPATH = $(VTKPATH)/lib/vtk-x.x VTKLIBS = -lvtkHybrid -lvtkImaging -lvtkIO -lvtkGraphics -lvtkFiltering -lvtkCommon -lvtkjpeg -lvtkpng -lvtkzlib -lvtksys -lfreetype -lGLU -lGL POBJECTS = getline.o CXXPFLAGS = -W -Wall -DLXMACOSX $(shell wx-config --cxxflags) -I$(VTKINCLUDEPATH) -Wno-deprecated -I/usr/X11R6/include -I/usr/X11R6/include/freetype2 CCPFLAGS = -W -Wall -DLXMACOSX $(shell wx-config --cflags) -I/usr/X11R6/include LXLIBDIR = PLIBS = -lz -L/usr/X11R6/lib $(shell wx-config --libs gl) -L$(VTKLIBPATH) $(VTKLIBS) POSTMAKE = cp -f ./loch ./loch.app/Contents/MacOS STRIPFLAG = # PLATFORM ENDCONFIG Adjust VTK path if needed. If necessary change the lines according the ones above. \\ Save ''Makefile'' (check the name - ''Makefile'' only without any extension).\\ In ''Terminal'' window write: cd /Applications/therion/loch [Enter] make [Enter] The compilation starts run. It should finish without error. Try to write: open ./loch.app [Enter] The ''Loch'' application should start to run. You may open it by double-clicking from ''Finder'' window too. There is still a bug there so you should open the 3D files from application ''Loch''. The double-click on or drag&drop of 3D file doesn't work.\\ ---- \\ === 9. Therion Samples === Just as the icing on the cake you may compile the **Samples**:\\ Be sure you have ''Survex'' (survex.com) installed and ''cavern'' worked first! cd /Applications/therion/samples [Enter] make [Enter] and wait until the compilation finished. You should see folder named ''samples.doc'' in the Therion folder. There you will find the html documentation of several interesting features of Therion. \\ \\ To add samples to the end of therion book you should compile the ''thbook'' again but you should to delete the already compiled version of Thbook: cd /Applications/therion/thbook [Enter] rm thbook.pdf [Enter] make [Enter] \\ And that should be all. //**Good luck!**// ====== Modern MacOS from source (tested 10.14.3) ====== * Use [[https://brew.sh|Homebrew Package Manager]] to install dependencies * ''git clone https://github.com/therion/therion.git && cd therion'' * ''brew install lcdf-typetools proj ghostscript vtk libpng zlib libjpeg wxmac freetype ImageMagick tcl-tk'' You shouldn't be an administrator to make install * ''make config-macosx && make && make install'' You could also try [[https://github.com/ladislavb/homebrew-therion|this Homebrew Formula]].