landmarker "FULL": Download and Installation

Installation instructions for landmarker version 2.0.6f (Full tcl version) (Aug. 13, 2014)

Platform: Microsoft Windows 7, Vista, XP or 2000.

Note: landmarker is under development - apologies for bugs and errors.
THE SOFTWARE IS PROVIDED AS IS, WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER.
THE DEVELOPER TAKES NO RESPONSIBILITY FOR ANY DAMAGE CAUSED BY ITS USE.
THE SOFTWARE MUST NOT BE USED FOR PATIENT TREATMENT.

1) Install vtk 

Here you can choose betwee A (advanced) and B (simpler) below:

A) Install vtk from http://www.vtk.org/VTK/resources/software.html

__OR__ 

B) Download a vtk executable VTK5.8.0.zip

Create a new directory c:\programs\ on your computer (if it does not already exist)

Put the VTK5.8.0.zip in c:\programs\ and unpack (unzip) it there.

There will now be a folder called c:\programs\VTK5.8.0 containing a bin and a lib directory.

2) Download and install the Hume linear algebra package.

Goto www.hume.com/la.
Read the License Terms.

Choose "LA Package Download" from the left panel.
Choose la101win and save in e.g. c:\programs\hume (you need to create this directory if it does not already exist).
Unpack the downloaded zip file and copy the directory named la1.0 to the tcl directory under
the vtk installation: i.e. under C:\programs\VTK5.8\lib\vtk-5.8\tcl8.5.
So you should now have a directory named C:\programs\VTK5.8\lib\vtk-5.10\tcl8.5\la1.0.

3) Download and install landmarker.

Download:
landmarker2.0.6f.zip  for Windows (Vista, XP or 2000).
Download: some_landmarker_data.zip (some example data).

Download landmarker2.0.6f.zip to e.g. c:\programs\ and unpack the zip-file, this will create a directory named c:\programs\landmarker2.0.6f.

Copy the folder in the landmarker distribution named landmarker_preferences to your user home directory.
Under XP the user home is typically C:\Documents and Settings\username where username is the user id.
Under Vista the user home is typically C:\Users\username where username is the user id.
(Exceptions exist e.g. on networked computers.)
If you are in doubt, execute the program named determine_user_home.exe in the landmarker distribution, it will tell you the name of your home directory.

------------------------------------------------------------

If you, for some reason, installed landmarker2.0.6f in a directory OTHER than c:\programs\ you need to do the following:

In the landmarker_preferences directory, now in your home directory, edit the file named landmarker_preferences.tcl in a text editor (e.g. Wordpad or NotePad).
You need to change the following setting:

Locate the line containing the following code:
if {$platform == "windows"} {set landmarker_home "C:/programs/landmarker2.0.6f/"}
and change this line to:
if {$platform == "windows"} {set landmarker_home "XXXX/landmarker2.0.6f/"}
(Here assuming that XXXX /landmarker2.0.6f/ is the name of the directory where you installed the landmarker files, including the landmarker.tcl file.)
(Please note the use of forward slashes even on a Windows platform.)

Save the landmarker_preferences.tcl after finishing the editing.

-----------------------------------------------------------------

Create a directory named c:\tmp

Goto the directory where you downloaded the landmarker distribution (e.g. C:/programs/landmarker2.0.6f/) and open the landmarker.tcl using the program vtk.exe.
This is typically done like this:

Under XP, right click the landmarker.tcl icon and chosse "Open WIth" and "Choose default program", check the "Always use the selected program to open this kind of file", then use the Browse button to select the file "vtk.exe" in the "bin" directory under the vtk distributon (see item 1 above), e.g. in C:\programs\VTK5.8\bin

Under Vista, double click the landmarker.tcl icon, then select "Select a program from a list of installed programs" and press "OK", select "Always use the selected program to open this kind of file", the use the Browse button and choose the file named vtk.exe in the bin directory under the vtk distributon (see item 1 above), e.g. in C:\programs\VTK5.8\bin.

Double clicking the landmarker.tcl icon should now start landmarker (a menu window and a blue surface window should appear).

Make a shortcut to the landmarker.tcl program and place it on you desktop.

4) Test landmarker.

Load a surface file: File->Load(New)->SurfaceFile, select e.g.cooked_deci.stl

Load an image file: File->Load(New)->ImageFile, select e.g. cooked.hea

To get some help: Help->Help for landmarker




 


Copyright (c) 2003-2015 by Tron Darvann, 3D Craniofacial Image Research Laboratory, Copenhagen,
trd@sund.ku.dk.
This software (landmarker.tcl and associated files) is provided as is, without any express or implied  warranties whatsoever.  The software may be used, copied, modified and/or redistributed  as long as it is not used for commercial purposes, and a reference (see below) is given in any  publication to which it has contributed.
The software uses the VTK library: for copyrights that apply to the VTK software, see
www.kitware.com.

Reference:
Darvann TA. Landmarker: A VTK-based tool for landmarking of polygonal surfaces. In: Takada K, Kreiborg S.
(eds) In Silico Dentistry - The Evolution of Computational Oral Health Science. Medigit, Osaka, Japan, 2008; 160-62.