Differences between revisions 11 and 12
Deletions are marked like this. Additions are marked like this.
Line 51: Line 51:
GetSubjectDir

Returns the subject directory path. volume should be 0 for the Main volume, and 1 for the Aux volume.
''Get``Subject``Dir'' '''''volume'''''

 Returns the subject directory path. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume.
Line 56: Line 56:
GetSubjectName

Returns the subject name. volume should be 0 for the Main volume, and 1 for the Aux volume.
''Get``Subject``Name'' '''''volume'''''

 Returns the subject name. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume.
Line 61: Line 61:
GotoMainVertex vertexNumber

Sets the cursor to the location of the numbered vertex in the Main surface. vertexNumber should be between 0 and the number of vertices in the surface.
''Goto``Main``Vertex'' '''''vertexNumber'''''

 Sets the cursor to the location of the numbered vertex in the Main surface. '''vertexNumber''' should be between 0 and the number of vertices in the surface.
Line 66: Line 66:
GotoOriginalVertex vertexNumber

Sets the cursor to the location of the numbered vertex in the Original surface. vertexNumber should be between 0 and the number of vertices in the surface.
''Goto``Original``Vertex'' '''''vertexNumber'''''

 Sets the cursor to the location of the numbered vertex in the Original surface. '''vertexNumber''' should be between 0 and the number of vertices in the surface.
Line 71: Line 71:
GotoPialVertex vertexNumber

Sets the cursor to the location of the numbered vertex in the Pial surface. vertexNumber should be between 0 and the number of vertices in the surface.
''Goto``Pial``Vertex'' '''''vertexNumber'''''

 Sets the cursor to the location of the numbered vertex in the Pial surface. '''vertexNumber''' should be between 0 and the number of vertices in the surface.
Line 76: Line 76:
GraphSelectedRegion

Graphs the average timecourse for the selected voxels.
''Graph``Selected``Region''

 Graphs the average timecourse for the selected voxels.
Line 81: Line 81:
ImportSurfaceAnnotationToSegmentation surface annotationFileName colorTableFileName

Loads annotationFileName into a surface, creates a new segmentation volume, and goes through the surface, mapping a vertex location to a voxel in the segmentation volume. For each, it looks up a label value from the RGB color stored in the annotation value using colorTableFileName and sets the segmentation value to the label value. surface should be 0 for the Main surface, and 1 for the Aux surface.
''Import``Surface``Annotation``To``Segmentation'' '''''surface annotationFileName colorTableFileName'''''

 Loads '''annotationFileName''' into a surface, creates a new segmentation volume, and goes through the surface, mapping a vertex location to a voxel in the segmentation volume. For each, it looks up a label value from the RGB color stored in the annotation value using '''colorTableFileName''' and sets the segmentation value to the label value. '''surface''' should be 0 for the Main surface, and 1 for the Aux surface.
Line 86: Line 86:
LoadAuxVolume volumeFileName

Loads volumeFileName as the Aux volume.
''Load``Aux``Volume'' '''''volumeFileName'''''

Loads '''volumeFileName''' as the Aux volume.
Line 91: Line 91:
LoadDTIVolumes vectorVolumeFileName intensityVolumeFileName redAxis greenAxis blueAxis

Loads a DTI volume using vectorVolumeFileName as the volume containing the vectors, and intensityVolumeFileNameas the volume containing the scaling factor. The former should be a three frame volume and the latter should be a one frame volume. The redAxis, greenAxis, and blueAxis parameters should be x, y, or z, indicating which value in the vector volume corresponds to which color.
''Load``DTI``Volumes'' '''''vectorVolumeFileName intensityVolumeFileName redAxis greenAxis blueAxis'''''

 Loads a DTI volume using '''vectorVolumeFileName''' as the volume containing the vectors, and '''intensityVolumeFileName''' as the volume containing the scaling factor. The former should be a three frame volume and the latter should be a one frame volume. The '''redAxis''', '''greenAxis''', and '''blueAxis''' parameters should be x, y, or z, indicating which value in the vector volume corresponds to which color.
Line 96: Line 96:
LoadFunctionalOverlay volumeFileName [registrationFileName]

Loads a functional overlay volume from volumeFileName. Can also apply an option registration transformation from registrationFileName. The overlay will be displayed in the graphics widnow.
''Load``Functional``Overlay'' '''''volumeFileName registrationType [registrationFileName]'''''

 Loads a functional overlay volume from '''volumeFileName'''. You must also specify a '''registrationType''', which should be 0 to find a registration file in the same directory as the data, 1 to use an identity registration, and 2 to specify a file. If 2 is the '''registrationType''', use '''registrationFileName''' to specify the file. The overlay will be displayed in the graphics widnow.
Line 101: Line 101:
LoadFunctionalTimeCourse volumeFileName [registrationFileName]

Loads a functional time course volume from volumeFileName. Can also apply an option registration transformation from registrationFileName. The time course graph will be displayed in a separate window.
''Load``Functional``Time``Course'' '''''volumeFileName registrationType [registrationFileName]'''''

 Loads a functional time course volume from '''volumeFileName'''. You must also specify a '''registrationType''', which should be 0 to find a registration file in the same directory as the data, 1 to use an identity registration, and 2 to specify a file. If 2 is the '''registrationType''', use '''registrationFileName''' to specify the file. The time course graph will be displayed in a separate window.
Line 106: Line 106:
LoadGCA volumeFileName transformFileName

Loads a GCA volume from volumeFileName using the transform in transformFileName.
''Load``GCA'' '''''volumeFileName transformFileName'''''

 Loads a GCA volume from ''volumeFileName'' using the transform in '''transformFileName'''.
Line 111: Line 111:
LoadGCARenormalization renormalizationVolumeFileName

Loads a GCA renormalization volume from renormalizationVolumeFileName.
''Load``GCA``Renormalization'' '''''renormalizationVolumeFileName'''''

 Loads a GCA renormalization volume from '''renormalizationVolumeFileName'''.
Line 116: Line 116:
LoadHeadPts headPointsFileName transformFileName

Loads a head points array from headPointsFileName using the transform in transformFileName .
''Load``Head``Pts'' '''''headPointsFileName transformFileName'''''

Loads a head points array from '''headPointsFileName''' using the transform in '''transformFileName'''.
Line 121: Line 121:
LoadLabel labelFileName

Loads a label file from labelFileName. This will add the voxels in the label file to the selection.
''Load``Label'' '''''labelFileName'''''

 Loads a label file from '''labelFileName'''. This will add the voxels in the label file to the selection.
Line 126: Line 126:
LoadMainSurface surface surfaceFileName

Loads a surface file from surfaceFileName. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that this loads the main surface object, and will unload the Original or Pial surface configurations if they exist.
''Load``Main``Surface'' '''''surface surfaceFileName'''''

 Loads a surface file from '''surfaceFileName'''. '''surface''' should be 0 for the Main surface, and 1 for the Aux surface. Note that this loads the main surface object, and will unload the Original or Pial surface configurations if they exist.
Line 131: Line 131:
LoadOriginalSurface surface surfaceFileName

Loads the Original vertex configuration from surfaceFileName into an existing surface. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.
''Load``Original``Surface'' '''''surface surfaceFileName'''''

 Loads the Original vertex configuration from '''surfaceFileName''' into an existing surface. '''surface''' should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.
Line 136: Line 136:
LoadPialSurface surface surfaceFileName

Loads the Pial vertex configuration from surfaceFileName into an existing surface. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.
''Load``Pial``Surface'' '''''surface surfaceFileName'''''

 Loads the Pial vertex configuration from '''surfaceFileName''' into an existing surface. '''surface''' should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.
Line 141: Line 141:
LoadSegmentationVolume volume volumeFileName colorTableFileName

Loads a segmentation volume from volumeFileName using the color table in colorTableFileName. volume should be 0 for the Main volume, and 1 for the Aux volume.
''Load``Segmentation``Volume'' '''''volume volumeFileName colorTableFileName'''''

 Loads a segmentation volume from '''volumeFileName''' using the color table in '''colorTableFileName'''. volume should be 0 for the Main volume, and 1 for the Aux volume.
Line 146: Line 146:
LoadSurfaceAnnotation surface annotationFileName

Loads a surface annotation file from annotationFileName into a surface. surface should be 0 for the Main surface, and 1 for the Aux surface. This will color the vertices and edges of the surface display using the RGB annotation values.
''Load``Surface``Annotation'' '''''surface annotationFileName'''''

 Loads a surface annotation file from '''annotationFileName''' into a surface. '''surface''' should be 0 for the Main surface, and 1 for the Aux surface. This will color the vertices and edges of the surface display using the RGB annotation values.
Line 151: Line 151:
LoadVolumeDisplayTransform volume transformFileName

Loads a display transform from transformFileName for an anatomical volume. volume should be 0 for the Main volume, and 1 for the Aux volume.
''Load``Volume``Display``Transform'' '''''volume transformFileName'''''

 Loads a display transform from '''transformFileName''' for an anatomical volume. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume.
Line 156: Line 156:
LoadVolume volumeFileName

Loads volumeFileName as the Main volume.
''Load``Volume'' '''''volumeFileName'''''

 Loads '''volumeFileName''' as the Main volume.
Line 161: Line 161:
NewControlPoint

Creates a new control point where the cursor is.
''New``Control``Point''

 Creates a new control point where the cursor is.
Line 166: Line 166:
NewSegmentationVolume volume fromAnatomicalVolume colorTableFileName

Creates a new segmentation volume based on one of the anatomical volumes using the color table in colorTableFileName. volume should be 0 for the Main segmentation volume, and 1 for the Aux segmentation volume, and fromAnatomicalVolume should be 0 for the Main anatomical volume, and 1 for the Aux anatomical volume.
''New``Segmentation``Volume'' '''''volume fromAnatomicalVolume colorTableFileName'''''

 
Creates a new segmentation volume based on one of the anatomical volumes using the color table in '''colorTableFileName'''. '''volume''' should be 0 for the Main segmentation volume, and 1 for the Aux segmentation volume, and '''fromAnatomicalVolume''' should be 0 for the Main anatomical volume, and 1 for the Aux anatomical volume.

[[Anchor(Overlay_RestoreRegistration)]]
''Overlay_``Restore``Registration''

 Restores the functional overlay registration to the last saved value.

[[Anchor(Overlay_SaveRegistration)]]
''Overlay_``Save``Registration''

 Saves the current overlay registration. Overwrites previous file.

[[Anchor(Overlay_SetCondition)]]
''Overlay_``Set``Condition'' '''''condition'''''

 Sets the functional overlay's current condition. '''condition''' must be with in the valid range of conditions.
Line 171: Line 186:
Overlay RestoreRegistration

Restores the functional overlay registration to the last saved value.

[[Anchor(Overlay)]]
Overlay SaveRegistration

Saves the current overlay registration. Overwrites previous file.

[[Anchor(Overlay)]]
Overlay_SetCondition condition

Sets the functional overlay's current condition. condition must be with in the valid range of conditions.

[[Anchor(Overlay)]]
Overlay_SetDisplayFlag flag value

Sets a display flag for the functional overlay in the current display pane. value should be 0 or 1. flag should be one of the following, corresponding to an item in the View, Configure Overlay... dialog box:

0 Truncate Negative Values
1 Truncate Positive Values

2 Reverse Phase

3 Offset Values

4 Ignore Threshold

5 Grayscale Overlay

6 Opaque Overlay


[[Anchor(Overlay)]]
Overlay_SetRegistrationToIdentity

Sets the functional overlay registration to the identity matrix.

[[Anchor(Overlay)]]
Overlay_SetThreshold min mid slope

Sets the functional overlay threshold. min and mid should be valid functional values, and slope should a positive floating point number.

[[Anchor(Overlay)]]
Overlay_SetTimePoint timePoint

Sets the functional overlay's current time point. timePoint must be with in the valid range of time points

[[Anchor(Overlay)]]
Overlay_SetVolumeSampleType sampleType

Sets the functional overlay sampling method. sampleType should be 0 for nearest neighbor sampling and 1 for trilinear sampling.
''Overlay_``Set``Display``Flag'' '''''flag value'''''

 Sets a display flag for the functional overlay in the current display pane. '''value''' should be 0 or 1. '''flag''' should be one of the following, corresponding to an item in the View, Configure Overlay... dialog box:

||0||Truncate Negative Values||
||1||Truncate Positive Values||
||2||Reverse Phase||
||3||Offset Values||
||4||Ignore Threshold||
||5||Grayscale Overlay||
||6||Opaque Overlay||

[[Anchor(Overlay_SetRegistrationToIdentity)]]
''Overlay_``Set``Registration``To``Identity''

  Sets the functional overlay registration to the identity matrix.

[[Anchor(Overlay_SetThreshold)]]
''Overlay_``Set``Threshold'' '''''min mid slope'''''

 Sets the functional overlay threshold. '''min''' and '''mid''' should be valid functional values, and '''slope''' should a positive floating point number.

[[Anchor(Overlay_SetTimePoint)]]
''Overlay_``Set``Time``Point'' '''''timePoint'''''

 Sets the functional overlay's current time point. '''timePoint''' must be with in the valid range of time points

[[Anchor(Overlay_SetVolumeSampleType)]]
''Overlay_``Set``Volume``Sample``Type'' '''''sampleType'''''

 Sets the functional overlay sampling method. '''sampleType''' should be 0 for nearest neighbor sampling and 1 for trilinear sampling.
Line 225: Line 219:
QuitMedit

Quits the program.
''Quit``Medit''

 Quits the program.
Line 230: Line 224:
ReadCursor

Reads a location from the edit.dat file and sets the cursor to that location.
 ''Read``Cursor''

 Reads a location from the {{{edit.dat}}} file and sets the cursor to that location.
Line 235: Line 229:
ReadVoxelLabels voxelLabelVolume1FileName voxelLabelVolume2FileName

Reads VLI volumes from voxelLabelVolume1FileName and voxelLabelVolume2FileName.
''Read``Voxel``Labels'' '''''voxelLabelVolume1FileName voxelLabelVolume2FileName'''''

 Reads VLI volumes from '''voxelLabelVolume1FileName''' and '''voxelLabelVolume2FileName'''.
Line 240: Line 234:
RecomputeSegmentation volume

Recomputes the Main or Aux segmentation volume based on the Main anatomical volume, the GCA volume, and the specified segmentation volume and its changed values. volume should be 0 for the Main volume, and 1 for the Aux volume.
''Recompute``Segmentation'' '''''volume'''''

 Recomputes the Main or Aux segmentation volume based on the Main anatomical volume, the GCA volume, and the specified segmentation volume and its changed values. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume.
Line 245: Line 239:
RedrawAll

This schedules a redraw of the graphics window which will happen at the next update. It is best suited when a redraw does not need to happen until a series of script commands is finished.

RedrawScreen

This forces an immediate redraw of the graphics window. This should be used when a script takes multiple screen captures in the middle of a loop.
script commands index

RestoreHeadPts

Restores the head points transformation to the original matrix.
script commands index

RestorePreviousSegmentation volume

Restores a segmentation volume to the state it was in before it was recomputed. volume should be 0 for the Main volume, and 1 for the Aux volume.
script commands index

RestoreVolumeFromSnapshot

Restores the Main volume to the state it was in when the snapshot was taken.
script commands index

RotateHeadPts degrees axis

Rotates the head points orientation by degrees degrees over the x, y, or z axis. degrees can be a floating point number and axis should be x, y, or z.
script commands index

RotateOverlayRegistration degrees axis

Rotates the functional overlay registration by degrees degrees over the x, y, or z axis. degrees can be a floating point number and axis should be x, y, or z.
script commands index

RotateVolume axis degrees

Rotates the Main anatomical volume over the x, y, or z axis by degrees degrees. degrees can be a floating point number and axis should be x, y, or z.
script commands index

SaveGCA volumeFileName

Saves the
GCA volume as volumeFileName.
script commands index

SaveLabel labelFileName

Saves the current selection as a label file in labelFileName.
script commands index

SaveRGB image
FileName

Takes a screen shot of the graphics window and saves it as an RGB file in imageFileName.
script commands index

SaveSegmentationVolume volume [destinationDirectory]

Saves the specified segmentation volume in its original location (overwriting the old file), or in a new location if destinationDirectory is specified. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.
script commands index

SaveVolume volume

Saves the anatomical volume in its original location, overwriting the old file. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.
script commands index

SaveVolumeAs volume destinationDirectory

Saves the anatomical volume in
destinationDirectory. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.
script commands index

ScaleOverlayRegistration distance axis

Scales the functional overlay registration by distance over the x, y, or z axis. distance can be a floating point number and axis should be x, y, or z.
script commands index

SelectVoxelsByFuncValuecompareType compareType

Adds to the selection all contiguous voxels whose functional value pass the comparison with the value under the cursor. compareType should be one of the following:
script commands index

0 G
reater than or equal to, or less than or equal to: If the value is positive, this will select all voxels whose value are greater than or equal to the value, and if negative, less than or equal to. 1 Equal to: Values must be equal 2 Greater than or equal to threshold minimum: This will select all voxels whose values are above the threshold minimum  SendCursor

Writes the location of the cursor to the edit.dat file, to be shared with tksurfer.
script commands index

SetBrushInfo
brush low high new

Sets information about the anatomical Edit Voxel Tool shape. brush
should be 2 or 3, for the brush associated with button 2 or 3. low, high, and new should be within the range of voxel values, and set the threshold and new values for the brush.
script commands index

SetBrushInfoToDefaults

Restores the brush info (see above) to the default values.
script commands index

SetBrushShape radius shape 3D

Sets the brush shape, which affects both edit tools and the Select Voxels tool. radius should be an integer greater than 0. shape should be 0 for circle, and 1 for square. 3D should be 0 for in-plane edits only, and 1 for three dimensional editing.
script commands index

SetBrush
Target target

Sets the
brush Edit Voxel Tool target. target should be 0 for the Main volume, and 1 for the Main and Aux volume.
script commands index

SetCursor coordinateSpace x y z

Sets the cursor in the volume and moves the current slice to display it. coordinateSpace
should be 0 for volume index space, 1 for RAS world space, and 2 for Talairach space. x, y, and z can be floating point numbers.
script commands index

SetCursorColor r g b

Sets the display color for the cursor. r, g, and b should be floating point values from 0 to 1.
script commands index

SetCursorShape shape

Sets the display shape for the cursor. shape should be 0 for crosshair and 1 for diamond.
script commands index

SetCursorToCenterOfSelection

Sets the cursor location to the center of the current selection, changing the view appropriately.
script commands index

SetDTIAlpha alpha

Sets the opacity alpha for the
DTI overlay. alpha should be a floating point number between 0 and 1.
script commands index

SetDisplayConfig numberOfColumns numberOfRows linkPolicy

Sets the number of rows and columns of display panes in the graphics window. Calling this function will configure the panes in default orientations and slice numbers. numberOfCols and numberOfRows should be between 1 and 4. linkPolicy should be one of the following:
script commands index

0 None: Normal link policy; cursor actions in other panes don't affect each other. 1 Cursor: Changing the cursor in one pane will set the cursor in other panes. Zoom levels are linked. Orientation changes are linked. When the display is set to this configuration, all panes are set to different orientations around the cursor. 2 Slice: Changing the slice number in one view will change all other views by the same amount. Cursor changes are not linked. Zoom levels are linked. Orientation changes are linked. When the display is first set to this configuration, all panes are set to the same orientation but to different slices.
SetDisplayFlag flag value

Sets a display flag for the current display pane. value should be 0 or 1. flag should be one of the following, corresponding to an item in the View menu:
script commands index

1 Aux Volume
2 Anatomical Volume
3 Cursor
4 Main Surface
5 Original Surface
6 Pial Surface
7 Interpolate Surface Vertices
8 Surface Vertices
9 Control Points
10 Selection
11 Functional Overlay
12 Functional Color Scale Bar
13 Mask to Functional Overlay
14 Histogram Percent Change
15 Segmentation Volume Overlay
16 Aux Segmentation Volume
17 Segmentation Label Volume Count
18
DTI Overlay  20 Focus Frame  21 Undoable Voxels  22 Axes  23 Maximum Intensity Porjection  24 Head Points   SetFloodSelectParams 3D sourceVolume fuzziness distance

Sets the parameters for the flood select part of the Select Voxels tool. 3D should be 0 or 1. sourceVolume should be 0 for the Main anatomical volume, 1 for the Aux anatomical volume, 2 for the Main segmentation volume, and 3 for the Aux segmentation volume. fuzziness and distance should be floating point numbers.
script commands index

SetFuncOverlayAlpha alpha

Sets the opacity alpha for the functional overlay. alpha should be a floating point number between 0 and 1.
script commands index

SetGCADisplayStatus displayIntermediateResults

Sets the display status for
GCA operations. displayIntermediateResults should be 0 or 1.
script commands index

SetLinkedCursorFlag linked

Sets cursor
linking on or off. linked should be 0 or 1.
script commands index

SetOrientation orientation

Sets the orientation of the current display pane. orientation should be 0 for coronal, 1 for horizontal, or 2 for sagittal.
script commands index
''Redraw``All''

 
This schedules a redraw of the graphics window which will happen at the next update. It is best suited when a redraw does not need to happen until a series of script commands is finished.

[[Anchor(RedrawScreen)]]
''Redraw``Screen''

 
This forces an immediate redraw of the graphics window. This should be used when a script takes multiple screen captures in the middle of a loop.

[[Anchor(
RestoreHeadPts)]]
''Restore``Head``Pts''

 
Restores the head points transformation to the original matrix.

[[Anchor(RestorePreviousSegmentation)]]
''Restore``Previous``Segmentation'' '''''volume'''''

 Restores a segmentation volume to the state it was in before it was recomputed. '''volume''' should be 0 for the Main volume, and 1 for the Au
x volume.

[[Anchor(
RestoreVolumeFromSnapshot)]]
''Restore``Volume``From``Snapshot''

 Restores the Main volume to the state it was in when the snapshot was taken.

[[Anchor(RotateHead
Pts)]]
''
Rotate``Head``Pts'' '''''degrees axis'''''

 
Rotates the head points orientation by '''degrees''' degrees over the x, y, or z axis. '''degrees''' can be a floating point number and '''axis''' should be x, y, or z.

[[Anchor(
RotateOverlayRegistration)]]
''Rotate``Overlay``Registration'' '''''
degrees axis'''''

 
Rotates the functional overlay registration by '''degrees''' degrees over the x, y, or z axis. '''degrees''' can be a floating point number and '''axis''' should be x, y, or z.

[[Anchor(RotateVolume)]]
''Rotate``Volume'' '''''a
xis degrees'''''

 
Rotates the Main anatomical volume over the x, y, or z axis by '''degrees''' degrees. '''degrees''' can be a floating point number and '''axis''' should be x, y, or z.

[[Anchor(
SaveGCA)]]
''Save``
GCA'' '''''volumeFileName'''''

 Saves the GCA volume as '''volumeFileName'''
.

[[Anchor(
SaveLabel)]]
''Save``L
abel'' '''''labelFileName'''''

 
Saves the current selection as a label file in '''labelFileName'''.

[[Anchor(SaveTI
FF)]]
''Save``TIFF'' '''''imageF
ileName'''''

 
Takes a screen shot of the graphics window and saves it as an TIFF file in '''imageFileName'''.

[[Anchor(
SaveSegmentationVolume)]]
''Save``Segmentation``Volume'' '''''
volume [destinationDirectory]'''''

 
Saves the specified segmentation volume in its original location (overwriting the old file), or in a new location if '''destinationDirectory''' is specified. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

[[Anchor(
SaveVolume)]]
''Save``Volume'' '''''volume'''''

 
Saves the anatomical volume in its original location, overwriting the old file. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

[[Anchor(
SaveVolumeAs)]]
''Save``Volume``As'' '''''
volume destinationDirectory'''''

 Saves the anatomical volume in '''
destinationDirectory'''. '''volume''' should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

[[Anchor(
ScaleOverlayRegistration)]]
''Scale``Overlay``Registration'' '''''
distance axis'''''

 
Scales the functional overlay registration by '''distance''' over the x, y, or z axis. '''distance''' can be a floating point number and '''axis''' should be x, y, or z.

[[Anchor(
SelectVoxelsByFuncValuecompareType)]]
''Select``Voxels``By``Func``Value'' '''''
compareType'''''

 
Adds to the selection all contiguous voxels whose functional value pass the comparison with the value under the cursor. '''compareType''' should be one of the following:

||0||Greater than or equal to, or less than or equal to: If the value is positive, this will select all vo
xels whose value are greater than or equal to the value, and if negative, less than or equal to.||
||
1||Equal to: Values must be equal||
||
2||Greater than or equal to threshold minimum: This will select all voxels whose values are above the threshold minimum||

[[Anchor(
SendCursor)]]
''Send``Cursor''

 
Writes the location of the cursor to the {{{edit.dat}}} file, to be shared with tksurfer.

[[Anchor(SetBrushInfo)]]
''Set``Brush``Info'' '''''brush low high new'''''

 Sets information about the anatomical Edit Vo
xel Tool shape. '''brush''' should be 2 or 3, for the brush associated with button 2 or 3. '''low''', '''high''', and '''new''' should be within the range of voxel values, and set the threshold and new values for the brush.

[[Anchor(
SetBrushInfoToDefaults)]]
''Set``Brush``Info``To``Defaults''

 
Restores the brush info (see above) to the default values.

[[Anchor(
SetBrushShape)]]
''Set``Brush``Shape'' '''''
radius shape 3D'''''

 
Sets the brush shape, which affects both edit tools and the Select Voxels tool. '''radius''' should be an integer greater than 0. '''shape''' should be 0 for circle, and 1 for square. '''3D''' should be 0 for in-plane edits only, and 1 for three dimensional editing.

[[Anchor(SetBrushTarget)]]
''Set``Brush``Target'' '''''target'''''

 Sets the brush Edit Vo
xel Tool target. '''target''' should be 0 for the Main volume, and 1 for the Main and Aux volume.

[[
Anchor(SetCursor)]]
''Set``Cursor'' '''''coordinateSpace
x y z'''''

 Sets the cursor in the volume and moves the current slice to display it
. '''coordinateSpace''' should be 0 for volume index space, 1 for RAS world space, and 2 for Talairach space. '''x''', '''y''', and '''z''' can be floating point numbers.

[[Anchor(
SetCursorColor)]]
''Set``Cursor``Color'' '''''
r g b'''''

 
Sets the display color for the cursor. '''r''', '''g''', and '''b''' should be floating point values from 0 to 1.

[[Anchor(
SetCursorShape)]]
''Set``Cursor``Shape'' '''''shape'''''

 
Sets the display shape for the cursor. '''shape''' should be 0 for crosshair and 1 for diamond.

[[Anchor(
SetCursorToCenterOfSelection)]]
''Set``Cursor``To``Center``Of``Selection''

 
Sets the cursor location to the center of the current selection, changing the view appropriately.

[[Anchor(
SetDTIAlpha)]]
''Set``
DTI``Alpha'' '''''alpha'''''

 Sets the opacit
y alpha for the DTI overlay. '''alpha''' should be a floating point number between 0 and 1.

[[Anchor(SetDisplayConfig)]]
''Set``Display``Config'' '''''number
OfColumns numberOfRows linkPolicy'''''

 Sets the number of rows and columns of display panes in the graphics window. Calling this function will configure the panes in default orientations and slice numbers. '''numberOfCols''' and '''numberOfRows''' should be between 1 and 4. '''linkPolicy''' should be one of the following:

||0||None: Normal link policy; cursor actions in other panes don't affect each other.||
||1||Cursor: Changing the cursor in one pane will set the cursor in other panes. Zoom levels are linked. Orientation changes are linked. When the display is set to this configuration, all panes are set to different orientations around the cursor.||
||2||Slice: Changing the slice number in one view will change all other views by the same amount. Cursor changes are not linked. Zoom levels are linked. Orientation changes are linked. When the display is first set to this configuration, all panes are set to the same orientation but to different slices.||

[[Anchor(SetDisplayFlag)]]
''Set``Display``Flag'' '''''flag value'''''

 Sets a display flag for the current display pane. '''value''' should be 0 or 1. flag should be one of the following, corresponding to an item in the View menu:

||1||Aux Volume||
||2||Anatomical Volume||
||3||Cursor||
||4||Main Surface||
||5||Original Surface||
||6||Pial Surface||
||7||Interpolate Surface Vertices||
||8||Surface Vertices||
||9||Control Points||
||10||Selection||
||11||Functional Overlay||
||12||Functional Color Scale Bar||
||13||Mask to Functional Overlay||
||14||Histogram Percent Change||
||15||Segmentation Volume Overlay||
||16||Aux Segmentation Volume||
||17||Segmentation Label Volume Count||
||18||DTI Overlay||
||
20||Focus Frame||
||
21||Undoable Voxels||
||
22||Axes||
||
23||Maximum Intensity Porjection||
||
24||Head Points||
||25||Verbose GCA Dump||

[[Anchor(
SetFloodSelectParams)]]
''Set``Flood``Select``Params'' '''''
3D sourceVolume fuzziness distance'''''

 
Sets the parameters for the flood select part of the Select Voxels tool. '''3D''' should be 0 or 1. '''sourceVolume''' should be 0 for the Main anatomical volume, 1 for the Aux anatomical volume, 2 for the Main segmentation volume, and 3 for the Aux segmentation volume. '''fuzziness''' and '''distance''' should be floating point numbers.

[[Anchor(
SetFuncOverlayAlpha)]]
''Set``Func``Overlay``Alpha'' '''''alpha'''''

 
Sets the opacity alpha for the functional overlay. '''alpha''' should be a floating point number between 0 and 1.

[[Anchor(
SetGCADisplayStatus)]]
''Set``
GCA``Display``Status'' '''''displayIntermediateResults'''''

 Sets the display status for GCA operations. '''displayIntermediateResults'''
should be 0 or 1.

[[Anchor(
SetLinkedCursorFlag)]]
''Set``L
inked``Cursor``Flag'' '''''linked'''''

 Sets cursor link
ing on or off. '''linked''' should be 0 or 1.

[[Anchor(
SetOrientation)]]
''Set``Orientation'' '''''orientation'''''

 
Sets the orientation of the current display pane. '''orientation''' should be 0 for coronal, 1 for horizontal, or 2 for sagittal.

[[Anchor(SetSegBrushInfo)]]
Line 438: Line 440:
script commands index

[[Anchor(SetSegmentationAlpha)]]
Line 443: Line 445:
script commands index

[[Anchor(SetSelectedHeadPointLabel)]]
Line 448: Line 450:
script commands index

[[Anchor(SetSlice)]]
Line 453: Line 455:
script commands index

[[Anchor(SetSurfaceDistanceAtCursor)]]
Line 458: Line 460:
script commands index

[[Anchor(SetSurfaceLineColor)]]
Line 463: Line 465:
script commands index

[[Anchor(SetSurfaceLineWidth)]]
Line 468: Line 470:
script commands index

[[Anchor(SetTool)]]
Line 473: Line 475:
script commands index

[[Anchor(SetVolumeBrightnessContrast)]]
Line 477: Line 479:
Sets the brightness and contrast values for a volume. volume should be 0 for the Main volume, and 1 for the Aux volume. brightness should be a floating point number from 0 to 1 (0 is brighter than 1) and contrast should be a floating point number from 0 to 30.script commands index Sets the brightness and contrast values for a volume. volume should be 0 for the Main volume, and 1 for the Aux volume. brightness should be a floating point number from 0 to 1 (0 is brighter than 1) and contrast should be a floating point number from 0 to 30.

[[Anchor(SetVolumeColorScale)]]
Line 482: Line 485:
script commands index

[[Anchor(SetVolumeMinMax)]]
Line 487: Line 490:
script commands index

[[Anchor(SetVolumeResampleMethod)]]
Line 492: Line 495:
script commands index

[[Anchor(SetVolumeSampleTypevolume)]]
Line 497: Line 500:
script commands index

[[Anchor(SetZoomCenter)]]
Line 502: Line 505:
script commands index

[[Anchor(SetZoomLevel)]]
Line 507: Line 510:
script commands index

[[Anchor(ShowNearestInterpolatedMainVertex)]]
Line 512: Line 515:
script commands index

[[Anchor(ShowNearestInterpolatedOriginalVertex)]]
Line 517: Line 520:
script commands index

[[Anchor(ShowNearestInterpolatedPialVertex)]]
Line 522: Line 525:
script commands index

[[Anchor(ShowNearestMainVertex)]]
Line 527: Line 530:
script commands index

[[Anchor(ShowNearestOriginalVertex)]]
Line 532: Line 535:
script commands index

[[Anchor(ShowNearestPialVertex)]]
Line 537: Line 540:
script commands index

[[Anchor(SmartCutAtCursor)]]
Line 542: Line 545:
script commands index

[[Anchor(SmoothFunctionalOverlay)]]
Line 547: Line 550:
script commands index

[[Anchor(SnapshotVolume)]]
Line 552: Line 555:
script commands index

[[Anchor(ThresholdVolume)]]
Line 557: Line 560:
script commands index

[[Anchor(TimeCourse)]]
Line 562: Line 565:
script commands index

[[Anchor(TimeCourse)]]
Line 567: Line 570:
script commands index
Line 573: Line 575:
[[Anchor(TimeCourse)]]
Line 576: Line 579:
script commands index

[[Anchor(TimeCourse)]]
Line 581: Line 584:
script commands index

[[Anchor(TranslateHeadPts)]]
Line 586: Line 589:
script commands index

[[Anchor(UndoLastEdit)]]
Line 591: Line 594:
script commands index

[[Anchor(UnloadAllSurfaces)]]
Line 596: Line 599:
script commands index

[[Anchor(UnloadGCA)]]
Line 601: Line 604:
script commands index

[[Anchor(UnloadSurface)]]
Line 606: Line 609:
script commands index

[[Anchor(UnloadVolume)]]
Line 611: Line 614:
script commands index

[[Anchor(UnloadVolumeDisplayTransformvolume)]]
Line 616: Line 619:
script commands index

[[Anchor(WriteControlPointFile)]]
Line 621: Line 624:
script commands index

[[Anchor(WriteHeadPointsFile)]]
Line 626: Line 629:
script commands index

[[Anchor(WriteHeadPointsTransform)]]
Line 631: Line 634:
script commands index

[[Anchor(WriteSurfaceValues)]]
Line 636: Line 639:
script commands index

Up to TkMeditGuide

Back to [:../TkMeditScripting: TkMeditScripting]

Continue to [:../TkMeditFileNameSubstitution: TkMeditFileNameSubstitution]

Scripting

This section assumes you are familiar with Tcl and how to write basic scripts.

Most of TkMedit's functions have Tcl bindings. As you have probably noticed, the interface is just a Tk/Tix window. You can look at the interface script, TkMedit.tcl, to see how most of the functionality is used. Following is a list of Tcl commands defined by TkMedit. You can use these commands in your own scripts and call them with the -tcl command line option to execute them on startup. TkMedit can run in a kind of batch mode in this fashion, altho it still requires X and has to be able to open its main window.

You can also enter these script commands from the shell that TkMedit was launched in. You can use the Tcl source command to load a script file from the Tcl shell as well.

This list is provided for reference. If you can figure out something that works, great, but it is not officially a feature of TkMedit.

Index

[#AverageSurfaceVertexPositions AverageSurfaceVertexPositions]

Commands

Functions arguments are listed by their name followed by their arguments. Arguments in square brackets are optional.

Anchor(AverageSurfaceVertexPositions) AverageSurfaceVertexPositions numberOfAverages

  • Averages the vertex positions of the Main surface numberOfAverages times.

Anchor() ClearSelection

  • Clears the current voxel selection.

Anchor() ClearUndoVolume

  • Clears the undoable voxels.

Anchor() DebugPrint string

  • Prints string to debugging output (either the xdebug_TkMedit.txt file or the screen).

Anchor() ExportChangedSegmentationVolume volume [destinationDirectory]

  • Saves the segmentation volume in its original location (overwriting the original), or a new location if destinationDirectory is specified. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

Anchor() FlipVolume xAxis yAxis zAxis

  • Flips the Main anatomical volume over an axis. Specify 0 or 1 for xAxis, yAxis, and zAxis to not flip or flip, respectively, on that axis. Axes are in anatomical index coordinate space.

Anchor(GetSubjectDir) GetSubjectDir volume

  • Returns the subject directory path. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(GetSubjectName) GetSubjectName volume

  • Returns the subject name. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(GotoMainVertex) GotoMainVertex vertexNumber

  • Sets the cursor to the location of the numbered vertex in the Main surface. vertexNumber should be between 0 and the number of vertices in the surface.

Anchor(GotoOriginalVertex) GotoOriginalVertex vertexNumber

  • Sets the cursor to the location of the numbered vertex in the Original surface. vertexNumber should be between 0 and the number of vertices in the surface.

Anchor(GotoPialVertex) GotoPialVertex vertexNumber

  • Sets the cursor to the location of the numbered vertex in the Pial surface. vertexNumber should be between 0 and the number of vertices in the surface.

Anchor(GraphSelectedRegion) GraphSelectedRegion

  • Graphs the average timecourse for the selected voxels.

Anchor(ImportSurfaceAnnotationToSegmentation) ImportSurfaceAnnotationToSegmentation surface annotationFileName colorTableFileName

  • Loads annotationFileName into a surface, creates a new segmentation volume, and goes through the surface, mapping a vertex location to a voxel in the segmentation volume. For each, it looks up a label value from the RGB color stored in the annotation value using colorTableFileName and sets the segmentation value to the label value. surface should be 0 for the Main surface, and 1 for the Aux surface.

Anchor(LoadAuxVolume) LoadAuxVolume volumeFileName

Loads volumeFileName as the Aux volume.

Anchor(LoadDTIVolumes) LoadDTIVolumes vectorVolumeFileName intensityVolumeFileName redAxis greenAxis blueAxis

  • Loads a DTI volume using vectorVolumeFileName as the volume containing the vectors, and intensityVolumeFileName as the volume containing the scaling factor. The former should be a three frame volume and the latter should be a one frame volume. The redAxis, greenAxis, and blueAxis parameters should be x, y, or z, indicating which value in the vector volume corresponds to which color.

Anchor(LoadFunctionalOverlay) LoadFunctionalOverlay volumeFileName registrationType [registrationFileName]

  • Loads a functional overlay volume from volumeFileName. You must also specify a registrationType, which should be 0 to find a registration file in the same directory as the data, 1 to use an identity registration, and 2 to specify a file. If 2 is the registrationType, use registrationFileName to specify the file. The overlay will be displayed in the graphics widnow.

Anchor(LoadFunctionalTimeCourse) LoadFunctionalTimeCourse volumeFileName registrationType [registrationFileName]

  • Loads a functional time course volume from volumeFileName. You must also specify a registrationType, which should be 0 to find a registration file in the same directory as the data, 1 to use an identity registration, and 2 to specify a file. If 2 is the registrationType, use registrationFileName to specify the file. The time course graph will be displayed in a separate window.

Anchor(LoadGCA) LoadGCA volumeFileName transformFileName

  • Loads a GCA volume from volumeFileName using the transform in transformFileName.

Anchor(LoadGCARenormalization) LoadGCARenormalization renormalizationVolumeFileName

  • Loads a GCA renormalization volume from renormalizationVolumeFileName.

Anchor(LoadHeadPts) LoadHeadPts headPointsFileName transformFileName

Loads a head points array from headPointsFileName using the transform in transformFileName.

Anchor(LoadLabel) LoadLabel labelFileName

  • Loads a label file from labelFileName. This will add the voxels in the label file to the selection.

Anchor(LoadMainSurface) LoadMainSurface surface surfaceFileName

  • Loads a surface file from surfaceFileName. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that this loads the main surface object, and will unload the Original or Pial surface configurations if they exist.

Anchor(LoadOriginalSurface) LoadOriginalSurface surface surfaceFileName

  • Loads the Original vertex configuration from surfaceFileName into an existing surface. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.

Anchor(LoadPialSurface) LoadPialSurface surface surfaceFileName

  • Loads the Pial vertex configuration from surfaceFileName into an existing surface. surface should be 0 for the Main surface, and 1 for the Aux surface. Note that the Main surface (that is, the Main Main or Aux Main) must already be loaded; this just loads in an alternate vertex configuration.

Anchor(LoadSegmentationVolume) LoadSegmentationVolume volume volumeFileName colorTableFileName

  • Loads a segmentation volume from volumeFileName using the color table in colorTableFileName. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(LoadSurfaceAnnotation) LoadSurfaceAnnotation surface annotationFileName

  • Loads a surface annotation file from annotationFileName into a surface. surface should be 0 for the Main surface, and 1 for the Aux surface. This will color the vertices and edges of the surface display using the RGB annotation values.

Anchor(LoadVolumeDisplayTransform) LoadVolumeDisplayTransform volume transformFileName

  • Loads a display transform from transformFileName for an anatomical volume. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(LoadVolume) LoadVolume volumeFileName

  • Loads volumeFileName as the Main volume.

Anchor(NewControlPoint) NewControlPoint

  • Creates a new control point where the cursor is.

Anchor(NewSegmentationVolume) NewSegmentationVolume volume fromAnatomicalVolume colorTableFileName

  • Creates a new segmentation volume based on one of the anatomical volumes using the color table in colorTableFileName. volume should be 0 for the Main segmentation volume, and 1 for the Aux segmentation volume, and fromAnatomicalVolume should be 0 for the Main anatomical volume, and 1 for the Aux anatomical volume.

Anchor(Overlay_RestoreRegistration) Overlay_RestoreRegistration

  • Restores the functional overlay registration to the last saved value.

Anchor(Overlay_SaveRegistration) Overlay_SaveRegistration

  • Saves the current overlay registration. Overwrites previous file.

Anchor(Overlay_SetCondition) Overlay_SetCondition condition

  • Sets the functional overlay's current condition. condition must be with in the valid range of conditions.

Anchor(Overlay) Overlay_SetDisplayFlag flag value

  • Sets a display flag for the functional overlay in the current display pane. value should be 0 or 1. flag should be one of the following, corresponding to an item in the View, Configure Overlay... dialog box:

0

Truncate Negative Values

1

Truncate Positive Values

2

Reverse Phase

3

Offset Values

4

Ignore Threshold

5

Grayscale Overlay

6

Opaque Overlay

Anchor(Overlay_SetRegistrationToIdentity) Overlay_SetRegistrationToIdentity

  • Sets the functional overlay registration to the identity matrix.

Anchor(Overlay_SetThreshold) Overlay_SetThreshold min mid slope

  • Sets the functional overlay threshold. min and mid should be valid functional values, and slope should a positive floating point number.

Anchor(Overlay_SetTimePoint) Overlay_SetTimePoint timePoint

  • Sets the functional overlay's current time point. timePoint must be with in the valid range of time points

Anchor(Overlay_SetVolumeSampleType) Overlay_SetVolumeSampleType sampleType

  • Sets the functional overlay sampling method. sampleType should be 0 for nearest neighbor sampling and 1 for trilinear sampling.

Anchor(QuitMedit) QuitMedit

  • Quits the program.

Anchor(ReadCursor)

  • ReadCursor

    Reads a location from the edit.dat file and sets the cursor to that location.

Anchor(ReadVoxelLabels) ReadVoxelLabels voxelLabelVolume1FileName voxelLabelVolume2FileName

  • Reads VLI volumes from voxelLabelVolume1FileName and voxelLabelVolume2FileName.

Anchor(RecomputeSegmentation) RecomputeSegmentation volume

  • Recomputes the Main or Aux segmentation volume based on the Main anatomical volume, the GCA volume, and the specified segmentation volume and its changed values. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(RedrawAll) RedrawAll

  • This schedules a redraw of the graphics window which will happen at the next update. It is best suited when a redraw does not need to happen until a series of script commands is finished.

Anchor(RedrawScreen) RedrawScreen

  • This forces an immediate redraw of the graphics window. This should be used when a script takes multiple screen captures in the middle of a loop.

Anchor(RestoreHeadPts) RestoreHeadPts

  • Restores the head points transformation to the original matrix.

Anchor(RestorePreviousSegmentation) RestorePreviousSegmentation volume

  • Restores a segmentation volume to the state it was in before it was recomputed. volume should be 0 for the Main volume, and 1 for the Aux volume.

Anchor(RestoreVolumeFromSnapshot) RestoreVolumeFromSnapshot

  • Restores the Main volume to the state it was in when the snapshot was taken.

Anchor(RotateHeadPts) RotateHeadPts degrees axis

  • Rotates the head points orientation by degrees degrees over the x, y, or z axis. degrees can be a floating point number and axis should be x, y, or z.

Anchor(RotateOverlayRegistration) RotateOverlayRegistration degrees axis

  • Rotates the functional overlay registration by degrees degrees over the x, y, or z axis. degrees can be a floating point number and axis should be x, y, or z.

Anchor(RotateVolume) RotateVolume axis degrees

  • Rotates the Main anatomical volume over the x, y, or z axis by degrees degrees. degrees can be a floating point number and axis should be x, y, or z.

Anchor(SaveGCA) SaveGCA volumeFileName

  • Saves the GCA volume as volumeFileName.

Anchor(SaveLabel) SaveLabel labelFileName

  • Saves the current selection as a label file in labelFileName.

Anchor(SaveTIFF) SaveTIFF imageFileName

  • Takes a screen shot of the graphics window and saves it as an TIFF file in imageFileName.

Anchor(SaveSegmentationVolume) SaveSegmentationVolume volume [destinationDirectory]

  • Saves the specified segmentation volume in its original location (overwriting the old file), or in a new location if destinationDirectory is specified. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

Anchor(SaveVolume) SaveVolume volume

  • Saves the anatomical volume in its original location, overwriting the old file. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

Anchor(SaveVolumeAs) SaveVolumeAs volume destinationDirectory

  • Saves the anatomical volume in destinationDirectory. volume should be 0 for the Main volume, and 1 for the Aux volume. The volume will be saved in COR format.

Anchor(ScaleOverlayRegistration) ScaleOverlayRegistration distance axis

  • Scales the functional overlay registration by distance over the x, y, or z axis. distance can be a floating point number and axis should be x, y, or z.

Anchor(SelectVoxelsByFuncValuecompareType) SelectVoxelsByFuncValue compareType

  • Adds to the selection all contiguous voxels whose functional value pass the comparison with the value under the cursor. compareType should be one of the following:

0

Greater than or equal to, or less than or equal to: If the value is positive, this will select all voxels whose value are greater than or equal to the value, and if negative, less than or equal to.

1

Equal to: Values must be equal

2

Greater than or equal to threshold minimum: This will select all voxels whose values are above the threshold minimum

Anchor(SendCursor) SendCursor

  • Writes the location of the cursor to the edit.dat file, to be shared with tksurfer.

Anchor(SetBrushInfo) SetBrushInfo brush low high new

  • Sets information about the anatomical Edit Voxel Tool shape. brush should be 2 or 3, for the brush associated with button 2 or 3. low, high, and new should be within the range of voxel values, and set the threshold and new values for the brush.

Anchor(SetBrushInfoToDefaults) SetBrushInfoToDefaults

  • Restores the brush info (see above) to the default values.

Anchor(SetBrushShape) SetBrushShape radius shape 3D

  • Sets the brush shape, which affects both edit tools and the Select Voxels tool. radius should be an integer greater than 0. shape should be 0 for circle, and 1 for square. 3D should be 0 for in-plane edits only, and 1 for three dimensional editing.

Anchor(SetBrushTarget) SetBrushTarget target

  • Sets the brush Edit Voxel Tool target. target should be 0 for the Main volume, and 1 for the Main and Aux volume.

Anchor(SetCursor) SetCursor coordinateSpace x y z

  • Sets the cursor in the volume and moves the current slice to display it. coordinateSpace should be 0 for volume index space, 1 for RAS world space, and 2 for Talairach space. x, y, and z can be floating point numbers.

Anchor(SetCursorColor) SetCursorColor r g b

  • Sets the display color for the cursor. r, g, and b should be floating point values from 0 to 1.

Anchor(SetCursorShape) SetCursorShape shape

  • Sets the display shape for the cursor. shape should be 0 for crosshair and 1 for diamond.

Anchor(SetCursorToCenterOfSelection) SetCursorToCenterOfSelection

  • Sets the cursor location to the center of the current selection, changing the view appropriately.

Anchor(SetDTIAlpha) SetDTIAlpha alpha

  • Sets the opacity alpha for the DTI overlay. alpha should be a floating point number between 0 and 1.

Anchor(SetDisplayConfig) SetDisplayConfig numberOfColumns numberOfRows linkPolicy

  • Sets the number of rows and columns of display panes in the graphics window. Calling this function will configure the panes in default orientations and slice numbers. numberOfCols and numberOfRows should be between 1 and 4. linkPolicy should be one of the following:

0

None: Normal link policy; cursor actions in other panes don't affect each other.

1

Cursor: Changing the cursor in one pane will set the cursor in other panes. Zoom levels are linked. Orientation changes are linked. When the display is set to this configuration, all panes are set to different orientations around the cursor.

2

Slice: Changing the slice number in one view will change all other views by the same amount. Cursor changes are not linked. Zoom levels are linked. Orientation changes are linked. When the display is first set to this configuration, all panes are set to the same orientation but to different slices.

Anchor(SetDisplayFlag) SetDisplayFlag flag value

  • Sets a display flag for the current display pane. value should be 0 or 1. flag should be one of the following, corresponding to an item in the View menu:

1

Aux Volume

2

Anatomical Volume

3

Cursor

4

Main Surface

5

Original Surface

6

Pial Surface

7

Interpolate Surface Vertices

8

Surface Vertices

9

Control Points

10

Selection

11

Functional Overlay

12

Functional Color Scale Bar

13

Mask to Functional Overlay

14

Histogram Percent Change

15

Segmentation Volume Overlay

16

Aux Segmentation Volume

17

Segmentation Label Volume Count

18

DTI Overlay

20

Focus Frame

21

Undoable Voxels

22

Axes

23

Maximum Intensity Porjection

24

Head Points

25

Verbose GCA Dump

Anchor(SetFloodSelectParams) SetFloodSelectParams 3D sourceVolume fuzziness distance

  • Sets the parameters for the flood select part of the Select Voxels tool. 3D should be 0 or 1. sourceVolume should be 0 for the Main anatomical volume, 1 for the Aux anatomical volume, 2 for the Main segmentation volume, and 3 for the Aux segmentation volume. fuzziness and distance should be floating point numbers.

Anchor(SetFuncOverlayAlpha) SetFuncOverlayAlpha alpha

  • Sets the opacity alpha for the functional overlay. alpha should be a floating point number between 0 and 1.

Anchor(SetGCADisplayStatus) SetGCADisplayStatus displayIntermediateResults

  • Sets the display status for GCA operations. displayIntermediateResults should be 0 or 1.

Anchor(SetLinkedCursorFlag) SetLinkedCursorFlag linked

  • Sets cursor linking on or off. linked should be 0 or 1.

Anchor(SetOrientation) SetOrientation orientation

  • Sets the orientation of the current display pane. orientation should be 0 for coronal, 1 for horizontal, or 2 for sagittal.

Anchor(SetSegBrushInfo) SetSegBrushInfo newValue 3D sourceVolume fuzziness distance

Sets the parameters for the Edit Segmentation tool, both brush and fill parameters. newValue should be a valid index in the currently loaded color table. 3D should be 0 or 1. sourceVolume should be 0 for the Main anatomical volume, 1 for the Aux anatomical volume, 2 for the Main segmentation volume, and 3 for the Aux segmentation volume. fuzziness and distance should be floating point numbers.

Anchor(SetSegmentationAlpha) SetSegmentationAlpha alpha

Sets the opacity alpha for the segmentation overlay. alpha should be a floating point number between 0 and 1.

Anchor(SetSelectedHeadPointLabel) SetSelectedHeadPointLabel label

Sets the label for the currently selected head point. label should be a string.

Anchor(SetSlice) SetSlice sliceNumber

Sets the slice number in the currently selected display pane for the anatomical volume. Note that this may trigger updates in other panes due to cursor linking. sliceNumber should be within the valid range of volume index coordinates.

Anchor(SetSurfaceDistanceAtCursor) SetSurfaceDistanceAtCursor

Copies the current surface distance value into the Main surface vertex nearest the cursor.

Anchor(SetSurfaceLineColor) SetSurfaceLineColor surface set r g b

Sets the surface line color. surface should be 0 for the Main surface, and 1 for the Aux surface. set should be 0 for Main, 1 for Original, and 2 for Pial. r, g, and b should be floating numbers from 0 to 1.

Anchor(SetSurfaceLineWidth) SetSurfaceLineWidth surface set width

Sets the surface line width. surface should be 0 for the Main surface, and 1 for the Aux surface. set should be 0 for Main, 1 for Original, and 2 for Pial. width should be an integer.

Anchor(SetTool) SetTool tool

Sets the currently active tool. tool should be 0 for Navigate, 1 for Select Voxels, 2 for Edit Voxels, 3 for Edit Segmentation, or 4 for Edit Control Points.

Anchor(SetVolumeBrightnessContrast) SetVolumeBrightnessContrast volume brightness contrast

Sets the brightness and contrast values for a volume. volume should be 0 for the Main volume, and 1 for the Aux volume. brightness should be a floating point number from 0 to 1 (0 is brighter than 1) and contrast should be a floating point number from 0 to 30.

Anchor(SetVolumeColorScale) SetVolumeColorScale volume brightness contrast min max

Sets the color (grayscale, really) scale for a volume. volume should be 0 for the Main volume, and 1 for the Aux volume. brightness should be a floating point number from 0 to 1 (0 is brighter than 1) and contrast should be a floating point number from 0 to 30. min and max define the values for black and white and should be valid numbers in the voxel value range.

Anchor(SetVolumeMinMax) SetVolumeMinMax volume min max

Sets the color (grayscale, really) scale for a volume. volume should be 0 for the Main volume, and 1 for the Aux volume. min and max define the values for black and white and should be valid numbers in the voxel value range.

Anchor(SetVolumeResampleMethod) SetVolumeResampleMethod volume method

Sets the resampling method for an anatomical volume. volume should be 0 for the Main volume, and 1 for the Aux volume. method should be 0 for RAS and 1 for slice.

Anchor(SetVolumeSampleTypevolume) SetVolumeSampleTypevolume sampleType

Sets the sampling method for an anatomical volume. volume should be 0 for the Main volume, and 1 for the Aux volume. sampleType should be 0 for nearest neighbor, 1 for trilinear, and 2 for sinc.

Anchor(SetZoomCenter) SetZoomCenter x y z

Sets the zoom center of the current display pane, changing the visible area without setting the cursor. x, y, and z should be integers in the anatomical index space.

Anchor(SetZoomLevel) SetZoomLevel level

Sets the zoom level of the current display pane. level should be an integer from 1 to 128.

Anchor(ShowNearestInterpolatedMainVertex) ShowNearestInterpolatedMainVertex

Sets the cursor to the point of the nearest interpolated vertex on the Main surface configuration.

Anchor(ShowNearestInterpolatedOriginalVertex) ShowNearestInterpolatedOriginalVertex

Sets the cursor to the point of the nearest interpolated vertex on the Original surface configuration.

Anchor(ShowNearestInterpolatedPialVertex) ShowNearestInterpolatedPialVertex

Sets the cursor to the point of the nearest interpolated vertex on the Pial surface configuration.

Anchor(ShowNearestMainVertex) ShowNearestMainVertex

Sets the cursor to the point of the vertex on the Main surface configuration.

Anchor(ShowNearestOriginalVertex) ShowNearestOriginalVertex

Sets the cursor to the point of the vertex on the Original surface configuration.

Anchor(ShowNearestPialVertex) ShowNearestPialVertex

Sets the cursor to the point of the vertex on the Pial surface configuration.

Anchor(SmartCutAtCursor) SmartCutAtCursor

Performs a smart cut operation at the current cursor location.

Anchor(SmoothFunctionalOverlay) SmoothFunctionalOverlay sigma

Smooths the functional overlay volume with given sigma. sigma should be a floating point number.

Anchor(SnapshotVolume) SnapshotVolume

Saves the state of the Main anatomical volume so it can be restored later.

Anchor(ThresholdVolume) ThresholdVolume thresholdValue direction newValue

Performs a thresholding operation on the Main anatomical volume. thresholdValue is the value above or below which all values will be set to newValue, and both must be valid anatomical values. direction should be 0 for below, or 1 for above.

Anchor(TimeCourse) TimeCourse_PrintSelectionRangeToFile fileName

Prints information about the averaged time course values over all time points for the selected voxels to a text file fileName.

Anchor(TimeCourse) TimeCourse_SetDisplayFlagflag flag value

Sets a display flag for the functional time course. value should be 0 or 1. flag should be one of the following, corresponding to an item in the View, Configure Time Course... dialog box:

7 Open Graph Window 8 Offset Values 9 Show Prestim Offset

Anchor(TimeCourse) TimeCourse_SetNumPreStimPoints numPoints

Sets the number of pre-stim time points in the time course volume to numPoints.

Anchor(TimeCourse) TimeCourse_SetTimeResolution resolution

Sets the time resolution of the time course volume to resolution.

Anchor(TranslateHeadPts) TranslateHeadPts distance axis

Translates the head points orientation by distance units over the x, y, or z axis. axis can be x, y, or z.

Anchor(UndoLastEdit) UndoLastEdit

Performs and undo.

Anchor(UnloadAllSurfaces) UnloadAllSurfaces

Unloads the Main and Aux surface.

Anchor(UnloadGCA) UnloadGCA

Unloads the GCA volume.

Anchor(UnloadSurface) UnloadSurface surface

Unloads a surface. surface should be 0 for the Main surface, or 1 for the Aux surface.

Anchor(UnloadVolume) UnloadVolume volume

Unloads an anatomical volume. volume should be 0 for the Main volume, or 1 for the Aux volume.

Anchor(UnloadVolumeDisplayTransformvolume) UnloadVolumeDisplayTransformvolume

Unloads an anatomical volume display transform. volume should be 0 for the Main volume's transform, or 1 for the Aux volume's transform.

Anchor(WriteControlPointFile) WriteControlPointFile

Writes the control points to the control.dat file. This is done automatically when adding a new point, but not when removing a point.

Anchor(WriteHeadPointsFile) WriteHeadPointsFile

Writes the head points file. This overwrites the previous file.

Anchor(WriteHeadPointsTransform) WriteHeadPointsTransform

Writes the head points transform file. This overwrites the previous file.

Anchor(WriteSurfaceValues) WriteSurfaceValues surface valueFileName

Writes the a surface's vertex values to a value file valueFileName. surface should be 0 for the Main surface, or 1 for the Aux surface.

TkMeditGuide/TkMeditReference/TkMeditScripting (last edited 2010-07-01 18:08:08 by tanha)