This function is intended to plot symmetric data around zero (like positive and negative activation data, signed p-values, etc.) on a subject's surface. It is a thin wrapper around vis.data.on.subject.
vis.symmetric.data.on.subject(
subjects_dir,
vis_subject_id,
morph_data_lh,
morph_data_rh,
surface = "white",
colormap = NULL,
views = c("t4"),
rgloptions = list(),
rglactions = list(),
draw_colorbar = FALSE,
makecmap_options = list(colFn = squash::jet, symm = TRUE, col.na = "#FFFFFF00"),
map_to_NA = c(0),
bg = NULL
)string. The FreeSurfer SUBJECTS_DIR, i.e., a directory containing the data for all your subjects, each in a subdir named after the subject identifier.
string. The subject identifier from which to obtain the surface for data visualization. Example: 'fsaverage'.
numeric vector or character string or NULL, the data to visualize on the left hemisphere surface. If a string, it is treated as a filename and data is loaded from it first. When it is a numerical vector, this is assumed to be the data already. The data must have the same length as the surface of the vis_subject_id has vertices. If NULL, this surface will not be rendered. Only one of morph_data_lh or morph_data_rh is allowed to be NULL.
numeric vector or character string or NULL, the data to visualize on the right hemisphere surface. If a string, it is treated as a filename and data is loaded from it first. When it is a numerical vector, this is assumed to be the data already. The data must have the same length as the surface of the vis_subject_id has vertices. If NULL, this surface will not be rendered. Only one of morph_data_lh or morph_data_rh is allowed to be NULL.
string. The display surface. E.g., "white", "pial", or "inflated". Defaults to "white".
a colormap function. **DEPRECATED**: use parameter 'makecmap_options' instead.
list of strings. Valid entries include: 'si': single interactive view. 't4': tiled view showing the brain from 4 angles. 't9': tiled view showing the brain from 9 angles.
option list passed to par3d. Example: rgloptions = list("windowRect"=c(50,50,1000,1000)).
named list. A list in which the names are from a set of pre-defined actions. The values can be used to specify parameters for the action.
logical, whether to draw a colorbar. WARNING: The colorbar is drawn to a subplot, and this only works if there is enough space for it. You will have to increase the plot size using the 'rlgoptions' parameter for the colorbar to show up. Defaults to FALSE. See coloredmesh.plot.colorbar.separate for an alternative.
named list of parameters to pass to makecmap. Must not include the unnamed first parameter, which is derived from 'measure'. Should include at least a colormap function as name 'colFn'.
the value or value range that should **not** be considered a cluster, and should thus be plotted as background color. If a single value, only exactly this value is used (typically 0). If two values, they are interpreted as a range, and a values between them are mapped to NA. If you prefer to map the data to NA yourself before using this function, pass `NULL`.
a background definition. Can be a surface color layer or a character string, see collayer.bg for valid strings.
list of coloredmeshes. The coloredmeshes used for the visualization.
Other visualization functions:
vis.color.on.subject(),
vis.data.on.fsaverage(),
vis.data.on.subject(),
vis.labeldata.on.subject(),
vis.mask.on.subject(),
vis.region.values.on.subject(),
vis.subject.annot(),
vis.subject.label(),
vis.subject.morph.native(),
vis.subject.morph.standard(),
vislayout.from.coloredmeshes()
Other morphometry visualization functions:
vis.data.on.fsaverage(),
vis.data.on.subject(),
vis.subject.morph.native(),
vis.subject.morph.standard()
# NOT RUN {
fsbrain::download_optional_data();
subjects_dir = fsbrain::get_optional_data_filepath("subjects_dir");
morph_data_lh = subject.morph.native(subjects_dir, 'subject1', 'thickness', 'lh');
morph_data_rh = NULL;
vis.symmetric.data.on.subject(subjects_dir, 'subject1', morph_data_lh, morph_data_rh);
# }
# NOT RUN {
# }
Run the code above in your browser using DataLab