Brain Montage

Plot the left and right hemispheres of brain colourized by two colour maps with a colour bar in the middle

obj_montage(left_obj, right_obj, left_map, right_map, output = NULL,
  colour_map, colour_range = NULL, colour_default = "grey",
  colour_bar = TRUE, labels = FALSE, palette = heat.colors(255),
  symmetric = FALSE, ..., plot_corners = c(100, 100, 900, 900), zoom = 1,
  add_normals = TRUE, colour_title = "", close_on_output = TRUE)

Arguments

left_obj	A bic_obj probably created by read_obj with the left hemisphere of a subject's brain
right_obj	A bic_obj probably created by read_obj with the right hemisphere of a subject's brain
left_map	a colour map to apply to the left hemisphere see colour_mesh for details
right_map	a colour map to apply to the right hemisphere see colour_mesh for details
output	Either NULL or a file path to write the snapshot.
colour_map	either a vector with a label/measure/statistic for every vertex or a character file path pointing to a file with such a vector in a rowwise format.
colour_range	a two element numeric vector indicating the min and max values of allowable labels/measures/statistics to be includedon the surface
colour_default	The colour given to vertices excluded by colour_range
colour_bar	Whether or not to draw a colour bar in the figure
labels	Whether or not the colour_map is a set of discrete labels
palette	A palette, AKA look-up-table, providing a linear colour scale for the colours in colour_map
symmetric	Whether to have a positive and negative colour scale (not yet implemented)
...	additonal parameters to be passed to create_mesh
plot_corners	The coordinates in pixels for the top left and bottom right corners of the the rgl device. c(lx, ly, rx, ry)
zoom	A zoom factor to apply to each subplot. This is the inverse of what you might expect for consistency with rgl. zoom > 1 zooms out, zoom < zooms in.
add_normals	Whether or not to add normals to the surface objects, see create_mesh for details
colour_title	legend title for the colour bar if requested
close_on_output	Whether or not to close the output after taking a snapshot, defaults to TRUE

Value

The subscenes invisibly.

Details

This function is designed to do a simple 6 angle plot for statistic maps of the left and right hemispheres of subject's brain. It defaults to leaving the rgl device open so that you can take a snapshot after tweaking the angles, or changing the colour bar with add_colour_bar. Its other mode is to take a snapshot after it has finished adding the 3d objects to the scene, in this mode, whether or not to keep the window open can be configured with close_on_output.