FsTutorial/TkmeditReference - Free Surfer Wiki

Reference

1.0 Mouse commands

Mouse Controls for Tools
	Key Shortcut	Button 1	Button 2	Button 3
Navigation Tool	n	Clicking and dragging pans the view across the current slice. No effect when the zoom level is 1.	Clicking once in the top half of the window increases the slice by 1, clicking in the bottom decreases the slice. Dragging up increases the slice, dragging down decreases it.	Clicking once in the top half of the window zooms in, clicking in the bottom zooms out. Dragging up zooms in continuously, dragging down zooms out.
Select Voxel Tool	s	Clicking sets the cursor.	Clicking adds a voxel to the selection. Sets the cursor when the button is released. Shift+click performs a flood select.	Clicking removes a voxel from the selection. Sets the cursor when the button is released.Shift+click performs a flood deselect.
Edit Voxel Tool	a	Clicking sets the cursor.	Clicking edits a voxel with the Button 2 settings. Shift+click undoes a undoable voxel region. Sets the cursor when the button is released.	Clicking edits a voxel with the Button 3 settings.
Edit Segmentation Tool	g	Clicking sets the cursor. If the ROI Volume Count display option is on, displays the ROI volume in the Tools Window.	Clicking paints a segmentation voxel. Shift+click performs a flood fill. Shift+Ctrl+click sets the color to the color of the voxel clicked. Sets the cursor when the button is released.	Clicking erases a segmentation voxel (sets to label 0). Sets the cursor when the button is released. Shift+click performs a flood erase.
Edit Control Points Tool	c	Clicking sets the cursor.	Clicking makes a new control point. Sets the cursor when the button is released.	Clicking removes nearest control point. Sets the cursor when the button is released.

	Mouse Controls for Zooming
Control+Button 1:	Zoom in, doubling the zoom level
Control+Button 2:	When zoomed in, sets the cursor and re-centers the view around the new cursor without changing the zoom level.
Control+Button 3:	Zoom out, halving the zoom level

2.0 Menus

2.1 File

Load Main Volume...	Loads the Main volume from a directory of COR- files.
Load Aux Volume...	Loads the Auxiliary volume from a directory of COR- files.
Import Main Volume from File...	Reads a specified file as the Main volume.
Import Aux Volume from File...	Reads a specified file as the Aux volume.
Load Transform for Main Volume...	Loads an LTA or XFM file to use as the display transform for the Main volume.
Load Transform for Aux Volume...	Loads an LTA or XFM file to use as the display transform for the Aux volume.
Unload Transform for Main Volume	Removes the display transform for the Main volume.
Unload Transform for Aux Volume	Removes the display transform for the Main volume.
Save Main Volume	Saves the Main volume in its original COR- file directory.
Save Main Volume As...	Saves the Main volume in a new directory.
Load Main Surface...	Loads a surface overlay (e.g. orig.?h, white.?h, pial.?h), looking for other configurations and loading them available.
Load Surface Configuration	Loads an alternate (Original or Pial) surface configuration.
Unload Surface	Removes the surface and all configurations.
Load Overlay Data...	Reads in coregistered functional data for in-plane overlay.
Load Time Course Data...	Loads in coregistered functional data for graphing over multiple time points.
Save Overlay Registration	If registration has been enabled, this will save the registration to the register.dat file.
Load Segmentation...	Loads a segmentation, requiring a COR- file directory and a color lookup table file.
Save Segmentation	Saves the segmentation in its original COR- file directory.
Save Segmentation As...	Saves the segmentation in a new directory.
Load Label...	Reads in a cortical label file as the selection.
Save Label As...	Saves the selection as a cortical label file.
Load Head Points....	Loads a head points transform file and a list of MEG/EEG sensor points.
Save Head Point Transform	Saves an edited head points transform file.
Save Head Points	Saves head points.
Save Control Points	Saves control points to control.dat file. (Done automatically.)
Quit	Exits the program.

2.1.1 Load surface configuration

Original Vertices	Load the Original vertex set for an existing surface
Pial Vertices	Load the Pial vertex set for an existing surface

2.1.2 Transforms

Load Transform for Main Volume...	Load a display transform for the Main anatomical volume.
Load Transform for Aux Volume...	Load a display transform for the Aux anatomical volume.
Unload Transform for Main Volume	Unload a display transform from the Main anatomical volume.
Unload Transform for Aux Volume	Unload a display transform from the Aux anatomical volume.

2.1.3 Label

Load Label...	Load a label file and add it to the current selection.
Save Label As...	Save the current selection as a label file.

2.1.4 GCA

Load GCA	Load GCA volumes.
Save GCA	Save GCA volumes.
Unload GCA	Unload GCA volumes.

2.1.5 Head points

Load Head Points...	Load a list of head points.
Save Head Point Transform	Save a modified head point transform (overwrites existing).
Save Head Points	Save list of head points.

2.1.6 DTI

Load DTI Volumes...

Load DTI volumes.

2.1.7 Edit

Undo Last Edit	Undoes the last volume or segmentation edit.
Take Snapshot of Volume	Makes a copy of the current Main volume.
Restore Volume to Snapshot	Restores the Main volume to the saved copy.
Clear Label / Selection	Clears the current selection.
Clear Undo Volume	Clears the Undo Volume.

2.2 View

View Configurations	Shows a submenu of view configurations.
Tool Bars	Shows a submenu of available toolbars. Check or uncheck the toolbar in this submenu to show or hide the toolbar.
Information	Shows a submenu of available information area items such as coordinate labels. Check or uncheck the item in this submenu to show or hide the item.
Configure...	Shows a submenu of viewing characteristics that can be configured.
Anatomical Volume	Check to display the anatomical volume.
Main Volume	Toggle between showing the Main or Aux volume.
Aux Volume
Maximum Intensity Projection	Check to display the maximum intensity projection of the current volume, or the highest values in the current plane for each voxel.
Main Surface	Check to display the Main surface configuration.
Original Surface	Check to display the Original surface configuration.
Pial Surface	Check to display the Pial surface configuration.
Surface Vertices	Check to display the surface vertices on top of the surface overlay.
Interpolate Surface Vertices	Check to use interpolation to draw surface vertices. Uncheck to use projection.
Functional Overlay	Check to show the functional overlay volume.
Functional Scale Color Bar	Check to show the color scale bar for the overlay.
Mask to Functional Overlay	Check to mask the anatomical volume to valid functional overlay space.
Show Histogram Percent Change	Check to show the window displaying changes in VLI label volumes.
Segmentation Overlay	Check to show the segmentation overlay.
Segmentation Label Volume Count	Check to count the volume of a label in the segmentation when clicking with the left mouse button when the Edit Segmentation Tool is selected.
Selection / Label	Check to show the selection.
Head Points	Check to show the head points.
Control Points	Check to show the control points.
Cursor	Check to show the cursor.
Axes	Check to show the coordinate space axes.
Undoable Voxels	Check to show the undoable voxels in the Undo Volume.

2.2.1 View configurations

Single View	Displays one pane with a single orientation.
Multiple Orientations	Displays four panes, allowing all orientations to be viewed at the same time around the cursor.
Mosaic	Displays a 4x4 grid of different slices in the same orientation.

2.2.2 Tool bars

Main	Check to display the Main toolbar, which has the following controls: Tool Selector (Navigation, Select Voxels, Edit Voxels, Edit Segmentation, Edit Control Points), View Configuration (Single, Multiple, Mosaic), Surface Display (Main, Original, Pial), Current Volume (Main, Aux)
Navigation	Check to display the Navigation toolbar, which has the following controls: Orientation (Coronal, Horizontal, Sagittal), Slice number, Zoom Out, Zoom In, Zoom Level, Save Point, Go To Saved Point, Linked Cursors
Reconstruction	Check to display the Reconstruction toolbar, which has the following controls: Brush shape (Circular, Square), 3D brush, Radius, Make Snapshot , Restore to Snapshot, TkTimer on

2.2.3 Information

Volume Index Coordinates	Check to show the volume index coordinates (0..255).
Volume RAS Coordinates	Check to show the RAS coordinates. The origin is at the center of the volume.
Volume Scanner Coordinates	Check to show the scanner coordinates, usually the RAS coordinates.
MNI Coordinates	Check to show the MNI Talairach coordinates. This was the old Talairach coordinate system, but has been replaced by a slightly modified version.
Talairach Coordinates	Check to show the Talairach coordinates, determined by the talairach.xfm file for a subject. May not be available if this file is missing.
Volume Value	Check to show the value of the Main volume voxel.
Aux Volume Value	Check to show the value of the Aux volume voxel.
Functional Overlay Index Coordinates	Check to show the functional overlay volume index coordinates.
Functional Overlay RAS Coordinates	Check to show the functional overlay RAS coordinates. The origin is at the center of the functional volume.
Functional Overlay Value	Check to show the value of the functional overlay volume voxel.
Segmentation Label	Check to show the name of the ROI in the Main segmentation that the voxel is a part of.
Aux Segmentation Label	Check to show the name of the ROI in the Aux segmentation that the voxel is a part of.
Head Point Label	Check to show the name of the head point nearest the cursor or mouse.
Surface Distance	Check to show the distance from the last cursor location to the present mouse or cursor location. (Used in setting surface distance values.)

2.2.4 Configure...

Brightness / Contrast...	Opens a dialog box in which you can set the brightness and contrast of the Main and Aux volumes.
Cursor...	Opens a dialog box in which you can change the color and shape of the cursor.
Surface...	Opens a dialog box in which you can change the color and line width of each surface configuration.
Functional Overlay...	Opens a dialog box in which you can change various characteristics of the functional overlay.
Time Course Graph...	Opens a dialog box in which you can change various characteristics of the time course graph.
Segmentation Display...	Opens a dialog box in which you can change the overlay opacity of the segmentation display.
DTI Display...	Opens a dialog box in which you can change the overlay opacity of the DTI display.

2.3 Tools

Navigate	Changes the current tool to the Navigation Tool.
Select Voxels	Changes the current tool to the Select Voxels Tool.
Edit Voxels	Changes the current tool to the Edit Voxels Tool.
Edit Segmentation	Changes the current tool to the Edit Segmentation Tool.
Edit Control Points	Changes the current tool to the Edit Control Points Tool.
Configure Brush Info...	Opens a dialog box in which you can change the size, shape, and depth of the brush.
Configure Volume Brush...	Opens a dialog box in which you can change the threshold and color values for the Edit Voxels Tool.
Configure Segmentation Brush...	Opens a dialog box in which you can change the color and fill settings for the Edit Segmentation Tool.
Configure Flood Select...	Opens a dialog box in which you can change the parameters for the flood action of the Select Voxels Tool.
Save Point	Saves the current cursor so that tksurfer can use its Go To Point function to go to that point.
Goto Saved Point	Sets the cursor to the one last saved in tksurfer for this subject.
Goto Point...	Opens a dialog box in which you can enter specific numerical values in multiple coordinate systems and go to that point.
Volume	Opens a submenu of tools and commands for anatomical data.
Surface	Opens a submenu of tools and commands for surface data.
fMRI	Opens a submenu of tools and commands for to functional data.
Head Points	Opens a submenu of tools and commands for EEG/MEG head point data.
Save RGB...	Saves the contents of the Display Window to an RGB file.
Save RGB Series...	Opens a dialog box in which you can tell tkmedit to automatically scroll through a series of slices and save their images to RGB files.

2.3.1 Volume

Threshold Volume...	A tool for changing all Main volume values above or below a specific value to a new value.
Flip Volume...	A tool for flipping the Main volume, creating a mirror image.
Rotate Volume...	A tool for rotating the Main volume any number of degrees around a main axis.
Smart Cut	A tool for setting large sections of the Main anatomical volume to 0. See the Working With Data section for details.

2.3.2 Surface

Show Nearest Main Vertex	Sets the cursor to the point of the nearest vertex on the Main surface configuration.
Show Nearest Original Vertex	Sets the cursor to the point of the nearest vertex on the Original surface configuration.
Show Nearest Pial Vertex	Sets the cursor to the point of the nearest vertex on the Pial surface configuration.
Show Nearest Main Surface Edge	Sets the cursor to the point of the nearest interpolated vertex on the Main surface configuration.
Show Nearest Original Surface Edge	Sets the cursor to the point of the nearest interpolated vertex on the Original surface configuration.
Show Nearest Pial Surface Edge	Sets the cursor to the point of the nearest interpolated vertex on the Pial surface configuration.
Find Main Vertex...	Opens a dialog in which you can enter a vertex index on the Main surface. The cursor will be set to that index.
Find Original Vertex...	Opens a dialog in which you can enter a vertex index on the Original surface. The cursor will be set to that index.
Find Pial Vertex...	Opens a dialog in which you can enter a vertex index on the Pial surface. The cursor will be set to that index.
Set Vertex Distance at Cursor	Sets the value in the Surface Distance information field for the closest vertex in the Main surface.
Average Vertex Positions...	Opens a dialog in which you can execute a command to average surface vertex positions in the Main surface.

2.3.3 fMRI

Select Contiguous Voxels by Func Value	Selects contiguous voxels to the cursor whose corresponding functional values are greater than or equal to the functional value at the cursor.
Select Contiguous Voxels by Threshold	Selects contiguous voxels to the cursor whose corresponding functional values are greater than or equal to the minimum functional threshold value.
Select Functional Voxel	Selects an entire functional voxel.
Register Functional Overlay...	A tool for aligning (registering) the functional overlay data with the anatomical data.
Restore Overlay Registration	Restores the overlay registration to its original value.
Set Registration to Identity	Sets the overlay registration matrix to the identity matrix, removing all transformations.
Graph Current Selection	Graphs the average of all voxel values in the selection in the Time Course graph window.
Print Time Course Summary to File...	Creates a file containing a table version of the time course information for the current voxel or selection.
Save Time Course Graph to Postscript File...	Saves the contents of the Time Course graph window to a Postscript file suitable for printing or including in other documents.

2.3.4 Segmentation

Select Current Label	Selects all the anatomical voxels in the segmentation label under the cursor.
Recompute Segmentation	Recomputes the Main segmentation using the Main anatomical volume and the GCA volume.
Graph Current Label Average	Graphs the average time course for all the anatomical voxels in the segmentation label under the cursor. Only works with a time course loaded.

2.3.5 Head points

Restore Head Points	Restores the head points registration to its original value.
Edit Current Head Point Label...	Edits the label of the head point closest to the cursor.
Register Head Points...	A tool for aligning the head point data with the anatomical data.

3.0 File name substitution

Whenever a file name is required to load or save data, the following system is used. First, on startup, tkmedit attempts to acquire a User Home Directory and a Subject Home Directory. The User Home Directory is always the current directory from which tkmedit was launched. The Subject Home Directory is based on the way in which the anatomical data was loaded. If the default tkmedit loading method is used, it is the concatenated contents of $SUBJECTS_DIR and the subject name. If the -f switch is used, it is the value of that parameter.

If the first character of the file name is ~ (tilde) or . (period), it is substituted with the Subject Home Directory or User Home Directory, respectively. If the first character is another alphanumeric character, a default location directory is prepended to the file name. If the first character is / (slash), it is left alone. This behavior is summarized below:

If the first character of FILENAME is....	The final file name is...
~ (tilde)	SubjectHomeDir/FILENAME
. (period)	UserHomeDir/FILENAME
/ (slash)	FILENAME
other character	SubjectHomeDir/Subdirectory/FILENAME

...where FILENAME is the file name that was input.

The subdirectory used in the last substitution depends on the file type being loaded, and is appropriate for the standard NMR center directory structure. These are:

Data Type	Subdirectory
Functional data	fmri
Head Points	bem
Surface	surf
Anatomical	mri
ROI/Label	label
RGB	image/rgb
Control Points (control.dat)	tmp
Edit (edit.dat)	tmp
Segmentation	mri
Color Table	$CSURF_DIR
Label	label
Anatomical Transform	mri/transforms

4.0 Command line options

4.1 Script

To automatically run a script, use the -tcl option, passing a script name. Tkmedit still requires anatomical data to be loaded before doing anything.

tkmedit -tcl SCRIPT_NAME

4.2 Anatomical volume

There are two ways to load anatomical data from the command line. The first is the default tkmedit mode for loading COR- volumes.

tkmedit SUBJECT IMAGE_TYPE

Where SUBJECT is a subject directory relative to the value of the SUBJECTS_DIR environment variable, and IMAGE_TYPE is a subdirectory of ${SUBJECTS_DIR}/<subject name>/mri. i.e.

tkmedit <subject name> T1

looks in ${SUBJECTS_DIR}/<subject name>/mri/T1. If there is a COR- volume in this directory, or another kind of readable data, it will be loaded as the Main anatomical volume.

Another way to load anatomical data is with an explicit path or file name using the -f switch:

tkmedit -f PATH/TO/DATA/[FILENAME]

This method looks in the given directory or file for any recognizable data. It will be loaded as the Main volume.

The Aux volume can be loaded with the -aux switch, i.e.

tkmedit <subject name> T1 -aux wm

This looks in ${SUBJECTS_DIR}/<subject name>/mri/wm for a COR- volume.

Note that tkmedit will not load without specifying a Main anatomical volume with the subject/image type method or the -f method.

4.3 Surface

To load a surface from the command line, add the name after the subject:

tkmedit <subject name> IMAGE_TYPE SURFACE

tkmedit -f /path/to/volume/data SURFACE

4.4 Functional volume

Overlay data is loaded with the -overlay switch and time course data with the -timecourse option, with the concatenated path and stem as the argument i.e.:

tkmedit -overlay DATA_DIRECTORY/STEM -timecourse DATA_DIRECTORY/STEM

where STEM is the portion of the bfloat file data that comes before the _xxx slice number. i.e. the stem of a file set named minsig_000.bfloat through minsig_015.bfloat is minsig.

To enable functional registration, pass -register on the command line with no arguments.

To specify a registration file that is not in the same directory as the functional volume, use the -overlay-reg or -timecourse-reg option with the registration file as the argument, i.e:

tkmedit -overlay DATA_DIRECTORY/STEM -overlay-reg /PATH/TO/REGISTRATION_FILE.DAT

To load an offset volume for the Time Course volume, specify it the same way as the Time Course volume but with the -timecourse-offset switch:

tkmedit -timecourse-offset DATA_DIRECTORY/STEM

4.5 Segmentation

Use the -segmentation switch to load a COR- volume representing a segmentation. A color file is also necessary.

tkmedit -segmentation COR_DIRECTORY COLOR_FILE

The COR_DIRECTORY is the directory of the COR- files and the COLOR_FILE is the file to use as a color lookup table.

You can specify the opacity of the segmentation overlay with the -segmentation-opacity option:

tkmedit -segmentation COR_DIRECTORY COLOR_FILE -segmentation-opacity 0.6

4.6 Head Points

Use the -headpts switch to load a head points file. This is a file of points indicating MEG/EEG sensor placement. A transform file is also required and can be specified on the command line.

tkmedit -headpts POINTS_FILE TRANSFORM_FILE

5.0 Crash recovery

If tkmedit segfaults (makes a memory access violation), and it will, and the user has edited the Main volume, the volume will be saved in the /tmp directory. This can be reloaded by loading the volume from that directory, i.e.

tkmedit -f /tmp