1#SUMA ENVIRONMENT
2# If you do not have a ~/.sumarc file, cannot find a SUMA
3# environment variable that's been mentioned in documentation,
4# or fervently desire to update your current ~/.sumarc with
5# all the latest variables that SUMA uses, you should run:
6#
7#    suma -update_env
8#
9# Unless you have setup SUMA environment variables outside of
10# your ~/.sumarc file, updating your ~/.sumarc file with
11# 'suma -update_env' WILL NOT ALTER changes you have already
12# made to the variables in your current ~/.sumarc.
13# For this reason consider running the update command after each
14# upgrade of your AFNI/SUMA binaries.
15***ENVIRONMENT
16// 000-SUMA_ArrowRotAngle:
17//     Incremental arrow rotation angle in degrees
18//     default:   SUMA_ArrowRotAngle = 5
19   SUMA_ArrowRotAngle = 5
20// 001-SUMA_ColorPattern:
21//     Color pattern (AFNI, EURO, DEFAULT)
22//     default:   SUMA_ColorPattern = EURO
23   SUMA_ColorPattern = EURO
24// 002-SUMA_SwapButtons_1_3:
25//     Swap mouse buttons 1 and 3
26//     default:   SUMA_SwapButtons_1_3 = NO
27   SUMA_SwapButtons_1_3 = NO
28// 003-SUMA_BackgroundColor:
29//     Background color r g b. No space between values
30//     default:   SUMA_BackgroundColor = 0.0,0.0,0.0
31   SUMA_BackgroundColor = 0.0,0.0,0.0
32// 004-SUMA_ROIColorMap:
33//     ROI color map (bgyr64, roi64, roi128, roi256)
34//     default:   SUMA_ROIColorMap = ROI_i256
35   SUMA_ROIColorMap = ROI_i256
36// 005-SUMA_NumConvSmooth:
37//     Number of smoothing operations to run on convexity data
38//     default:   SUMA_NumConvSmooth = 5
39   SUMA_NumConvSmooth = 5
40// 006-SUMA_ConvColorMap:
41//     Colormap for convexity (gray02, gray_i02, ngray20, bgyr64, etc.)
42//     default:   SUMA_ConvColorMap = gray02
43   SUMA_ConvColorMap = gray02
44// 007-SUMA_ConvBrightFactor:
45//     Brightness factor for convexity
46//     default:   SUMA_ConvBrightFactor = 0.5
47   SUMA_ConvBrightFactor = 0.5
48// 008-SUMA_NumForeSmoothing:
49//     Number of smoothing operations to run on mixed foregroung color plane
50//       before mixing with background
51//     default:   SUMA_NumForeSmoothing = 0
52   SUMA_NumForeSmoothing = 0
53// 009-SUMA_NumFinalSmoothing:
54//     Number of smoothing operations to run on final set of mixed colors.
55//       This would be the mixed foreground and background colors
56//     default:   SUMA_NumFinalSmoothing = 0
57   SUMA_NumFinalSmoothing = 0
58// 010-SUMA_ColorMixingMode:
59//     Setup the color mixing mode (ORIG, MOD1)
60//     default:   SUMA_ColorMixingMode = ORIG
61   SUMA_ColorMixingMode = ORIG
62// 011-SUMA_AFNI_TCP_PORT:
63//     ** OBSOLETE: Port for communicating with AFNI
64//                    Listening ports are derived from SUMA_AFNI_TCP_PORT
65//                    Listening port i
66//                    SUMA_AFNI_TCP_PORT + i (i > 0)
67//     default:   SUMA_AFNI_TCP_PORT = 0
68   SUMA_AFNI_TCP_PORT = 0
69// 012-SUMA_WarnBeforeClose:
70//     Warn before closing with the Escape key (YES/NO)
71//     default:   SUMA_WarnBeforeClose = YES
72   SUMA_WarnBeforeClose = YES
73// 013-SUMA_MaskZero:
74//     Mask node values
75//       0 ? YES/NO
76//     default:   SUMA_MaskZero = YES
77   SUMA_MaskZero = YES
78// 014-SUMA_AbsThreshold:
79//     Threshold if Val < thr (NO) or | Val | < | Thr | (YES)
80//     default:   SUMA_AbsThreshold = YES
81   SUMA_AbsThreshold = YES
82// 015-SUMA_ThresholdScalePower:
83//     Threshold scale precision. 2 is the minimum allowed.
84//       This value might be overriden in SUMA.
85//     default:   SUMA_ThresholdScalePower = 2
86   SUMA_ThresholdScalePower = 2
87// 016-SUMA_CenterOnPatch:
88//     Center of Rotation is based on nodes used in the mesh and not
89//       on all the nodes in NodeList
90//     default:   SUMA_CenterOnPatch = NO
91   SUMA_CenterOnPatch = NO
92// 017-SUMA_UseCrossTicks:
93//     Use cross ticks on axis ?
94//     default:   SUMA_UseCrossTicks = NO
95   SUMA_UseCrossTicks = NO
96// 018-SUMA_1D_Transpose_Warn:
97//     Warn if 1D file looks like it needs a transpose
98//     default:   SUMA_1D_Transpose_Warn = YES
99   SUMA_1D_Transpose_Warn = YES
100// 019-SUMA_AdjustMouseMotionWithZoom:
101//     Adjust roation and translation factor of mouse with changes
102//       in zoom levels
103//     default:   SUMA_AdjustMouseMotionWithZoom = YES
104   SUMA_AdjustMouseMotionWithZoom = YES
105// 020-SUMA_ViewOrthographicProjection:
106//     Use orthographic projection
107//     default:   SUMA_ViewOrthographicProjection = NO
108   SUMA_ViewOrthographicProjection = NO
109// 021-SUMA_KeyZoomGain:
110//     Percent gain for zooming in and out with the 'z' and 'Z' keys.
111//       Typical range from 0 to 50
112//     default:   SUMA_KeyZoomGain = 5
113   SUMA_KeyZoomGain = 5
114// 022-SUMA_FOV_Original:
115//     Original FOV. Set between 1.0 and 100.0
116//       Default is 30.0, -1 == auto
117//     default:   SUMA_FOV_Original = -1
118   SUMA_FOV_Original = -1
119// 023-SUMA_Position_Original:
120//     Original windows size and width in pixels
121//       Allowed values are: 'TopLeft'
122//                           'RightOffset'
123//                           'X Y' Sets only the position to top left corner
124//                           'X Y Xwidth Ywidth' Set also width of window
125//       Default is top left of the screen
126//     default:   SUMA_Position_Original = TopLeft
127   SUMA_Position_Original = TopLeft
128// 024-SUMA_Light0Color:
129//     light0 color
130//     default:   SUMA_Light0Color = 1.0,1.0,1.0
131   SUMA_Light0Color = 1.0,1.0,1.0
132// 025-SUMA_AmbientLight:
133//     Ambient light
134//     default:   SUMA_AmbientLight = 1.0,1.0,1.0
135   SUMA_AmbientLight = 1.0,1.0,1.0
136// 026-SUMA_AllowDsetReplacement:
137//     Allow for replacement of pre-loaded dsets
138//     default:   SUMA_AllowDsetReplacement = YES
139   SUMA_AllowDsetReplacement = YES
140// 027-SUMA_AlwaysAssignSurface:
141//     Allow a dataset to be assigned to a surface, even if
142//      domain of dset is specified and different for the surface.
143//      Default is yes
144//     default:   SUMA_AlwaysAssignSurface = YES
145   SUMA_AlwaysAssignSurface = YES
146// 028-SUMA_ShareGrandChildrenOverlays:
147//     Allow for surfaces with same DomainGrandParentID to share overlays
148//     default:   SUMA_ShareGrandChildrenOverlays = NO
149   SUMA_ShareGrandChildrenOverlays = NO
150// 029-SUMA_SnapshotOverSampling:
151//     Increase the resolution of images recorded with 'r' button.
152//       Increase is done by taking multiple shots that once stitched
153//       together form a high-resolution image.
154//       The maximum resolution is set by the GL_MAX_VIEWPORT_DIMS of your
155//       graphics card. I have 4096 pixels.
156//       If you exceed this number, SUMA will make adjustments automatically.
157//       Assemble images with program 2dcat.
158//     default:   SUMA_SnapshotOverSampling = 1
159   SUMA_SnapshotOverSampling = 1
160// 030-SUMA_NoDuplicatesInRecorder:
161//     Ignore consecutive duplicate images in recorder
162//     default:   SUMA_NoDuplicatesInRecorder = YES
163   SUMA_NoDuplicatesInRecorder = YES
164// 031-SUMA_START_NIML:
165//     start NIML (can't do this for more than one suma at a time!)
166//     default:   SUMA_START_NIML = YES
167   SUMA_START_NIML = YES
168// 032-SUMA_AllowFilenameDsetMatch:
169//     Allow (YES) datasets with the same filename but differing ID
170//       to be considered the same.
171//       This is only useful with SUMA_AllowDsetReplacement
172//     default:   SUMA_AllowFilenameDsetMatch = YES
173   SUMA_AllowFilenameDsetMatch = YES
174// 033-SUMA_FreezeFOVAcrossStates:
175//     Freeze zoom across states
176//     default:   SUMA_FreezeFOVAcrossStates = NO
177   SUMA_FreezeFOVAcrossStates = NO
178// 034-SUMA_DsetColorMap:
179//     Dset color map
180//     default:   SUMA_DsetColorMap = Spectrum:red_to_blue
181   SUMA_DsetColorMap = Spectrum:red_to_blue
182// 035-SUMA_ShowOneOnly:
183//     Show only selected dset in suma's surface controller.
184//     default:   SUMA_ShowOneOnly = YES
185   SUMA_ShowOneOnly = YES
186// 036-SUMA_GraphHidden:
187//     Update graphs, even SUMA_ShowOneOnly (or suma's '1 Only') is turned on.
188//     default:   SUMA_GraphHidden = YES
189   SUMA_GraphHidden = YES
190// 037-SUMA_ColorMapRotationFraction:
191//     Fraction of colormap to rotate with up/down arrow keys.
192//     default:   SUMA_ColorMapRotationFraction = 0.05
193   SUMA_ColorMapRotationFraction = 0.05
194// 038-SUMA_SurfContFontSize:
195//     Size of surface controller font.
196//       Values are SMALL, BIG (old style).
197//     default:   SUMA_SurfContFontSize = SMALL
198   SUMA_SurfContFontSize = SMALL
199// 039-SUMA_StartUpLocation:
200//     Where to position SUMA window when first opened.
201//       Values are POINTER (at the mouse pointer's location)
202//                  DEFAULT (let the window manager decide)
203//
204//     default:   SUMA_StartUpLocation = DEFAULT
205   SUMA_StartUpLocation = DEFAULT
206// 040-SUMA_KeyNodeJump:
207//     Numer of nodes to jump with the 'alt+arrow' keys.
208//       Valid range from 1 to 10
209//     default:   SUMA_KeyNodeJump = 1
210   SUMA_KeyNodeJump = 1
211// 041-SUMA_DriveSumaMaxWait:
212//     Numer of seconds to wait for SUMA to respond to DriveSuma.
213//       Valid range from 0 to 60000
214//     default:   SUMA_DriveSumaMaxWait = 300.0
215   SUMA_DriveSumaMaxWait = 300.0
216// 042-SUMA_LEFT_FILE_DSET_IDENTIFIER:
217//     String to use in creating left hemisphere dataset wildcards.
218//     default:   SUMA_LEFT_FILE_DSET_IDENTIFIER = *lh*.dset
219   SUMA_LEFT_FILE_DSET_IDENTIFIER = *lh*.dset
220// 043-SUMA_RIGHT_FILE_DSET_IDENTIFIER:
221//     String to use in creating left hemisphere dataset wildcards.
222//     default:   SUMA_RIGHT_FILE_DSET_IDENTIFIER = *rh*.dset
223   SUMA_RIGHT_FILE_DSET_IDENTIFIER = *rh*.dset
224// 044-SUMA_LEFT_FILE_ROI_IDENTIFIER:
225//     String to use in creating left hemisphere roi wildcards.
226//     default:   SUMA_LEFT_FILE_ROI_IDENTIFIER = *lh*.roi
227   SUMA_LEFT_FILE_ROI_IDENTIFIER = *lh*.roi
228// 045-SUMA_RIGHT_FILE_ROI_IDENTIFIER:
229//     String to use in creating right hemisphere roi wildcards.
230//     default:   SUMA_RIGHT_FILE_ROI_IDENTIFIER = *rh*.roi
231   SUMA_RIGHT_FILE_ROI_IDENTIFIER = *rh*.roi
232// 046-SUMA_LEFT_FILE_OTHER_IDENTIFIER:
233//     String to use in creating left hemisphere roi wildcards.
234//     default:   SUMA_LEFT_FILE_OTHER_IDENTIFIER = *lh*
235   SUMA_LEFT_FILE_OTHER_IDENTIFIER = *lh*
236// 047-SUMA_RIGHT_FILE_OTHER_IDENTIFIER:
237//     String to use in creating right hemisphere roi wildcards.
238//     default:   SUMA_RIGHT_FILE_OTHER_IDENTIFIER = *rh*
239   SUMA_RIGHT_FILE_OTHER_IDENTIFIER = *rh*
240// 048-SUMA_ConvexityDsetOpacity:
241//     Initial Convexity Datasest opacity.
242//     default:   SUMA_ConvexityDsetOpacity = 0.85
243   SUMA_ConvexityDsetOpacity = 0.85
244// 049-SUMA_ShowLabelDsetAtStartup:
245//     Display mode of  Label Datasest specified in spec file at startup.
246//        'YES' or 'Col': Shows it in color
247//        'Con': Shows only contours (see also env SUMA_ContourThickness).
248//        'C&C': Shows both colors and contours
249//        'XXX'or 'No': Does not show it.
250//
251//     default:   SUMA_ShowLabelDsetAtStartup = XXX
252   SUMA_ShowLabelDsetAtStartup = XXX
253// 050-SUMA_ShowLabelsAtCrossHair:
254//     Show label at cross hair in viewer
255//      You can toggle the display at such labels with F9
256//
257//     default:   SUMA_ShowLabelsAtCrossHair = YES
258   SUMA_ShowLabelsAtCrossHair = YES
259// 051-SUMA_LabelDsetOpacity:
260//     Initial Label Datasest opacity.
261//     default:   SUMA_LabelDsetOpacity = 0.2
262   SUMA_LabelDsetOpacity = 0.2
263// 052-SUMA_AttemptTalkRecover:
264//     Attempt to recover from AFNI <--> SUMA disconnection bug.
265//
266//     default:   SUMA_AttemptTalkRecover = Yes
267   SUMA_AttemptTalkRecover = Yes
268// 053-SUMA_CmapsDir:
269//     Name of directory containing user's own SUMA color maps (*.cmap)
270//
271//     default:   SUMA_CmapsDir = None
272   SUMA_CmapsDir = ~/suma_colormaps
273// 054-SUMA_RetinoAngle_DsetColorMap:
274//     Name of color map for datasets of retinotopy angles.
275//      These would be produced by 3dRetinoPhase
276//
277//     default:   SUMA_RetinoAngle_DsetColorMap = rgybr20
278   SUMA_RetinoAngle_DsetColorMap = rgybr20
279// 055-SUMA_VFR_DsetColorMap:
280//     Name of color map for VFR datasets produced by SurfRetinoMap
281//
282//     default:   SUMA_VFR_DsetColorMap = afni_n2
283   SUMA_VFR_DsetColorMap = afni_n2
284// 056-SUMA_NodeCoordsUnits:
285//     Coordinate units of surface nodes. Choose from 'mm' or 'cm'
286//      A bad choice can make the surfaces render with many artifacts.
287//
288//     default:   SUMA_NodeCoordsUnits = mm
289   SUMA_NodeCoordsUnits = mm
290// 057-SUMA_DoNotSendStates:
291//     Which anatomically correct surf. states should not NOT be sent to AFNI?
292//      This is mostly for deciding whether one of 'white' or 'smoothwm'
293//      FreeSurfer states should not be sent to AFNI.
294//      The default is to let them all go.
295//      You can specify multiple states with a , delimited list (no spaces!).
296//      By default nothing is excluded.
297//
298//     default:   SUMA_DoNotSendStates = N/A
299   SUMA_DoNotSendStates = N/A
300// 058-SUMA_AutoRecordPrefix:
301//     Prefix for autorecord (suma's Ctrl+R) files.
302//      FreeSurfer states should not be sent to AFNI.
303//      Add a path if you want the files to endup in a particular directory.
304//      You can also add an extension to prefix to specify the output type.
305//      Choose from .jpg, .ppm, or .1D . The fallback type is .jpg
306//
307//     default:   SUMA_AutoRecordPrefix = ./SUMA_Recordings/autorecord.jpg
308   SUMA_AutoRecordPrefix = ./SUMA_Recordings/autorecord.jpg
309// 059-SUMA_CrossHairLabelFont:
310//     Font for cross hair label in SUMA viewer
311//      Choose one of: f8 f9 tr10 tr24 he10 he12 he18
312//
313//     default:   SUMA_CrossHairLabelFont = f9
314   SUMA_CrossHairLabelFont = f9
315// 060-SUMA_IxT_LinkMode:
316//     Linking mode of I and T sub-brick selectors
317//      Choose one of: None, Same, Stat
318//
319//     default:   SUMA_IxT_LinkMode = Stat
320   SUMA_IxT_LinkMode = Stat
321// 061-SUMA_ArrowFieldSelectorTrigger:
322//     Minimum Number of sub-bricks to trigger use of arrow field for
323//      sub-brick selectors.
324//
325//     default:   SUMA_ArrowFieldSelectorTrigger = 200
326   SUMA_ArrowFieldSelectorTrigger = 50
327// 062-SUMA_Sym_I_Range:
328//     Use symmetric Intensity range by default (YES or NO)
329//
330//     default:   SUMA_Sym_I_Range = YES
331   SUMA_Sym_I_Range = YES
332// 063-SUMA_Auto_I_Range:
333//     Set auto Intensity range by default (YES or NO)
334//
335//     default:   SUMA_Auto_I_Range = NO
336   SUMA_Auto_I_Range = NO
337// 064-SUMA_Auto_B_Range:
338//     Set auto Brightness range by default (YES or NO)
339//
340//     default:   SUMA_Auto_B_Range = NO
341   SUMA_Auto_B_Range = NO
342// 065-SUMA_ContourThickness:
343//     Set thickness of dataset contours
344//
345//     default:   SUMA_ContourThickness = 1.0
346   SUMA_ContourThickness = 1.0
347// 066-SUMA_LHunify:
348//     Merge separated left/right states for inflated/spherical/etc. surfaces
349//      Choose from YES or NO
350//     default:   SUMA_LHunify = YES
351   SUMA_LHunify = YES
352
353