Up to TkSurferGuide

Back to [:../TkSurferPatch: TkSurferPatch]

Continue to [:../TkSurferFieldSign: TkSurferFieldSign]


Labels, or ROIs, are collections of vertices that can be treated as a group for various applications. In TkSurfer, you can use labels to get average values for overlays or time courses. You can also export label files for use in other FreeSurfer programs, or export a collection of labels as an annotation.

TkSurfer can have multiple labels, each with a different designation. Labels in TkSurfer can be associated with anatomical areas or just be given a color for display purposes. TkSurfer has drawing and filling tools to assist you in creating new lables based on surface data.

The label file format is interchangable with TkMedit. You can create a label in TkSurfer, save it, and load it in TkMedit, or vice versa.

Selecting Labels

Many operations use labels, such as graphing the average of a label in the Time Course. You must select a label for these operations. The currenlty selected label is drawn with a yellow outline in the Display window, and its name is highlighted in the list of labels in the Labels window. To select a label, click on it in the Display window, or click on its name in the Labels window.

Loading Labels

Use File->Label->Load Label... item to load an individual label file. A label file is a list of RAS coordinates and associated vertex indices that make up the label

You can also import an annotation file as a series of labels. An annotation file is a binary file that assigns a label index to each vertex in a surface. When the annotation is imported, a label is created for each unique index, and the vertices with those values are added to that label. This can be done with the File->Label->Import Annotation... command.

Label files can be associated with anatomical labels, analogous to a segementation volume in TkMedit. To do this, TkSurfer must load a lookup table to get its list of structures. Each structure is associated with a number and color. Each label assigned an anatomical structure will be drawn in that color. When an annotation is loaded, it uses the numbers in this table to assign structures to the imported labels. TkSurfer loads surface_labels.txt by default, but you can load a new table with the File->Label->Load Color Table... command.

Saving Labels

Use File->Label->Save Selected Label... command to save a new label file in a new location. You can select a label by clicking on it in the Display window or by selecting its name in the Labels Window.

Labels Window

The Labels window, accessible through the View->Windows->Labels command, displays all labels and their properties. On the left side is a list of labels. Click on one to select it. You will the label selected in the Display window if it is visible in the current surface orientation.

When you click on a label, you can edit its properties on the right side of the Labels window. The following properties are available:

Creating Labels

TkSurfer also lets you create new labels with the Custom Fill dialog. This is available from the attachment:icon_fill_label.gif button on the toolbar. Click this button to open the Custom Fill dialog. This dialog lets you begin filling from one or more vertices. Fills will continue outward until one of the "Up to..." conditions are met. All filled vertices will be added to a new or existing label, or removed from a label.

There are two tool buttons for drawing lines, the Fill Boundary tool attachment:icon_draw_line.gif and the Closed Fill Boundary tool attachment:icon_draw_line_closed.gif. These tools make a fill boundary by joining all marked vertices. The latter tool also connects the last marked vertex to the first. Fill boundaries are drawn as red lines.

attachment:draw_line_1.gif attachment:draw_line_2.gif

After drawing a fill boundary, you can use it to make a label by clicking inside the region around which you drew a boundary, clicking the Custom Fill button, checking the Up to and including fill boundaries checkbox, and clicking the Fill button.

attachment:fill_1.gif attachment:fill_2.gif

You can select and delete fill boundaries by clicking near or on them. A selected fill boundary will be drawn as a red line. To delete it, click the Delete Fill Boundary button attachment:icon_erase_line.gif.

Marked Vertices and Labels