Drag & Drop Objects to 3D Viewer

This post contains interactive components (experimental) that allows you to execute RAVE code from the web browsers. If you would like to try this feature and customize/play with the code, please be patient. It might take a while for the browser to finish setting up (depending on your network speed). Once the script is ready, you will see “WEBR STATUS: 🟢 Ready!” in the above banner.

How to use this demo

The 3D viewer supports dragging & dropping files for quick adhoc visualizations. Click on the links below to see different use-cases. If you would like to open the viewer locally and try it out, please download an offline version once the viewer is ready.

• 

  ---

  Example file for this demo

  • Drop GIfTI (*.gii), STL (*.stl), or FreeSurfer mesh files (*h.pial, *h.white, *h.smoothwm, *h.inflated, …)
  • To clear the object, open Configure ROI Surfaces > Clear Uploaded Surfaces
• 

  ---

  Example files: left hemisphere and right hemisphere

  • Drop FreeSurfer annotation (*.annot) or curvature files (*.curv or *.sulc)
  • To clear the object, open Configure ROI Surfaces > Clear Uploaded Surfaces
• 

  ---

  Example file for this demo

  • Drop in a NIfTI (*.nii, *.nii.gz) or a MGZ (*.mgz) file
  • Clamp volume via threshold using Clipping Min/Max
  • Set color map to “continuous” or “single color”
• 

  ---

  Example file for this demo

  • Drop in a NIfTI (*.nii, *.nii.gz) or a MGZ (*.mgz) file
  • Set color map to “discrete”
  • Subset and enter the atlas labels in Volume Settings > Voxel Label
  • Generate quick surface from the labels by clicking Update ISO Surface
• 

  ---

  Example file for this demo

  • Prepare an electrode coordinate file (see an example from the link above). The bare minimum columns are Electrode (channel number), Label (contact label), and anatomical coordinates (see below)
    • For visualizing on template brain, please specify either column set MNI152_x, MNI152_y, MNI152_z (known as the MNI coordinate) or MNI305_x, MNI305_y, MNI305_z (known as fsaverage coordinate)
    • For visualizing on native brain, specify T1R, T1A, T1S (scanner RAS coordinate) or Coord_x, Coord_y, Coord_z (surface, or FreeSurfer tk-registered coordinate)
• 

  ---

  Example coordinate file & value table

  • First, drop in an electrode coordinate file (see the example coordinate file above)
  • Then, drop in an electrode value table with Electrode, Time, and one or more variable columns (see the example value table above)
  • Finally, turn on Data Visualization > Play/Pause to start animation
  • (Optional) to hide inactive electrodes, go to Electrode Settings > Visibility, and set to “hide inactives”
• 

  ---

  Example file for this demo

  • Go to Default > Copy Controller State, the viewer state will be copied to the clipboard (download the example data to see what is inside)
  • You can directly copy the state string to the text box (Default > Paste to set State) or save the string to a json file and drag & drop in
• ---

  Download this example file and try out! The file is essentially a json file with one flag, some global parameters and settings for each transition.

  • The flag is "isThreeBrainTransition": true, allowing RAVE to know how to handle the file
  • Global parameters include
    • resetCanvas: whether to reset canvas to its default state before applying transition animation
    • loops: number of additional loops
    • trasitionDuration: duration of a transition, can be set at stage-level
    • transitionTimeout: total timeout for each transition before switching to the next state, can be set at stage-level
  • The transition data is an array of states:
    • background: the canvas background
    • cameraMain: contains camera position, up direction, and zoom level
    • Each controllers list sets the controller values at beginning of the transition (immediate), interpolated animation (animated), and at the end of the transition (delayed)