The purpose of makelmarks is to generate a set of coronary artery landmarks from a set of points that lie on the surface of the heart. This allows us to create landmarks even if the heart was never digitized directly, or design somewhat schematic coronaries based on a sock mold or generic heart model.
The program reads most of what it needs from files that have to be prepared beforehand. Running makelmarks involves telling the program the names of those files, as follows:
makelmarks points-filename pnum-filename outfilename
where points-filename is the name of a standard CVRTI points (.pts) file containing all the points on the surface of the heart1 and pnum-filename is the name of a file that contains lists of points to be used for the coronaries, as described in section 3.3. The value of outfilename is the name of the landmarks file (usually using the extension .lmarks) that will contain the coronaries.
Based on past experience, the best way to proceed is as follows:
The program itself is located in macleod/bin/makelmarks (executable) and in macleod/torso/lmarks/makelmarks (source code). Make sure that ROBHOME is defined in your account and then typing makelmarks should find the correct files.
The first of the input files is just a .pts file containing the coordinates of points that define the epicardial surface. These are usually created either from a digitization of the heart or perhaps computed somehow, but we assume that such a file exists. This is the file that should be used with map3d in order to generate the points that belong in the second input file and to check the results.
This is a special file, developed for this program. Its content direct makelmarks as to how to construct the coronaries based on the points in the associated .pts file. This file is in text format and must be created manually beforehand using a text editor. The format of the file is as follows:
|Format of .pnum file|
|ncorsegs||Number of individual segments of coronaries in the whole file.|
|ncorpts1 radius1||Number of points in segment 1 and the starting radius of the coronary in segment 1|
|p1.1 [p1.2 p1.3]||numbers of the points from the .pts file that define this node in the coronaries. There can be up to three point numbers specified here and points can be repeated; we compute the mean location of all those supplied, so that repetition serves as weighting.|
|p2.1 [p2.2 p2.3]||number(s) of the next point(s) to be used to define the coronary segment|
|ncorpts2 radius2||Same as above but for the second segment of the coronaries|
|p1.1 [p1.2 p1.3]||Same as above|
Note that all the point numbers specified above are relative to the associated .pts file, with the first point in the file assigned the value one, the next two, and so on. So make sure to select a .pts file and stick with that same file throughout the process.
The single output file produced by makelmarks is a landmarks file (.lmarks), which is described in the manual for map3d.
This document was generated using the LaTeX2HTML translator Version 99.2beta6 (1.42)
Copyright © 1993, 1994, 1995, 1996,
Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.
The command line arguments were:
latex2html -split 3 -no_white -link 3 -no_navigation -nomath -html_version 3.2,math makelmarks
The translation was initiated by Rob MacLeod on 2000-11-30