Differences between revisions 42 and 43
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:

=== Work-in-process and upcoming ===
 1. Label surface and ROI layers by color in the layer list
 1. Display only selected labels in 2D slice view and also as iso-surfaces in 3D view.
 1. New enhanced data format for point sets. Can record comments and stats and other extend-able information.
 1. Mask surface overlay by a surface label
 1. Unified volume and surface ROI. Can edit it on both layers. More extended options for editing ROI on surface.
 1. More extensive features for track visualization
(as of 09/19/2017)
Line 51: Line 60:
=== Work-in-process and upcoming ===
(as of 09/19/2017)
 1. Label surface and ROI layers by color in the layer list
 1. Display only selected labels in 2D slice view and also as iso-surfaces in 3D view.
 1. New enhanced data format for point sets. Can record comments and stats and other extend-able information.
 1. Mask surface overlay by a surface label
 1. Unified volume and surface ROI. Can edit it on both layers. More extended options for editing ROI on surface.
 1. More extensive features for track visualization
Line 80: Line 80:

Bugs

  1. When you enter in values for Mid point (an option that appears when a surface is selected), it doesn't always change the display (hitting enter doesn't seem to do anything). It seems to work the first time but not after that. You have to use the slider to get it to change.
  2. When you load only a surface and no volume, the cursor does not show up. Also, if you right click show 3d slices is checked but it probably should be grayed out because there are no slices if a volume is not loaded.
  3. Multiple items in the layer list get highlighted when that is not the intention. This happens often and randomly.The actual cause of this seems to be the user dragging the mouse without realizing it. If you hold down the left mouse button and drag across items in the layer list, it will automatically select them all. Also, if you click on the checkbox of an un-highlighted item but move the mouse slightly towards the right so that it hovers over the name (for even a split second), then it will highlight that item in addition to whatever else you already have highlighted.
  4. When moving the cursor in Point Set Edit mode, by clicking Shift + Ctrl + Left button, the cursor won't always move to the voxel you select. In the gray matter, it seems to jump to the nearest voxel on a surface. It also switches the slice sometimes. This makes it very hard to click on a point and go between the three views when editing to determine if a voxel is gm or wm.(This is the same error as the Editing Mode one- done #22- that Ruopeng previously fixed)


Work-in-process and upcoming

  1. Label surface and ROI layers by color in the layer list
  2. Display only selected labels in 2D slice view and also as iso-surfaces in 3D view.
  3. New enhanced data format for point sets. Can record comments and stats and other extend-able information.
  4. Mask surface overlay by a surface label
  5. Unified volume and surface ROI. Can edit it on both layers. More extended options for editing ROI on surface.
  6. More extensive features for track visualization

(as of 09/19/2017)

High priority

  1. Link the surfaces together (i.e. when you click on a vertex in the inflated surface, it should go to that vertex on the white and pial) & show identical vertex information in the Voxel Info panel. When clicking on a point on the 2D surface, automatically move the cursor in the 3D view to the closest point on the surface to that point in the volume.

    • we talked about loading a surface set which would have all the pertinent surfaces linked (but would also like ability to turn off surfaces that are within the set); having a separate cursor for this; overriding the info in the Voxel Info Panel to display info based on a specific vertex
  2. Multiple items in the layer list get highlighted when that is not the intention. This happens often and randomly. The actual cause of this seems to be the user dragging the mouse without realizing it. If you hold down the left mouse button and drag across items in the layer list, it will automatically select them all. Also, if you click on the checkbox of an un-highlighted item but move the mouse slightly towards the right so that it hovers over the name (for even a split second), then it will highlight that item in addition to whatever else you already have highlighted.
  3. Disable drawing restrictions imposed on the freehand tool when switching to the clone voxel tool, all within the recon edit mode.

Medium priority

  1. Create script to allow freeview to recognize the recon directory structure. For Allison, ideal command line would be:

    • freeview bert -v brainmask wm T1 -surfs -aseg -aparc -cp

    • which would load the volumes brainmask.mgz, wm.mgz, T1.mgz; load all the surfaces (?h.white, ?h.pial, ?h.inflated); load the aseg.mgz with the FreeSurferColorLUT chosen; load the ?h.aparc.annot; and load the control.dat file, if any, saved in the tmp dir. In addition, the ability to use -f (surf dir) and -l (label dir) without specifying the full path. It would also be cool if it could open in recon edit mode when using this convention.
  2. Ability to draw a label on the surface (including all the options tksurfer has, e.g. fill up to curvature, etc.)
  3. Be able to edit a label file in a volume and then map it to a surface with freeview (similar to tksurfer discarding vol. points and mapping to surface vertices).
  4. Display talairach and MNI305 coords in the Mouse/Cursor information panel
  5. Ability to window the diffusion color maps so they can be made brighter and easier to see the colors.

Low priority

  1. Integrate snapshots and movie frame options (or just standardize them). i.e. There is a button for screenshots but you have to go to the File menu to save movie frames; in save screenshots, you have the option of hiding the cursor and keeping the window open but these are not options in 'write movie frames'.
  2. By default, turn off the 3D frames and slices
  3. When right click on Volumes, Surfaces, ROI, etc. headings in layer list, can choose 'Hide all' and 'Show all'.
  4. Add the ability to use a long cursor in 3D
  5. When loading a ?h.curv overlay file, make the curvature default 'threshold' instead of 'binary'
  6. When choose 'Save As' for volumes, use current name of layer as name it should be saved as (user still has to hit 'ok' to agree to that name) instead of New Volume (in the cases where it was renamed from New Volume after it was loaded)
  7. Right click on ROI & Point set headings in layer list gives option to 'Save All'. This should save checked and unchecked volumes and work similar to TrackVis in that it will save with their current name (although it would be better if it could prompt you through each layer and ask if you want to save it with its current name)

  8. Ability to change opacity of the 3D frames so can see anatomy and tract or surface at same time
  9. When right clicking on file in Layer list, the menu that opens should have checkmarks indicating which option is chosen in the following categories: lock vs. unlock, show info vs. hide info, show vs hide
  10. When viewing a segmentation / label volume with the "outline" option, could we have an option to increase the edge width? This would be really useful for taking snapshots for figures.
  11. Replace any references to pixel(s) in the different editing mode windows to say voxel(s) instead, confusing.
  12. Ability to remove the cursor for snapshots from command line
  13. When load inflated surface, it shouldn't be viewable at the same time as pial & white surfaces in the 3D view

  14. Button next to window and level sliders that allows you to save current windowing so you can continue windowing an image but return to your previous windowing if better.
  15. Add ability to drag the name of volumes in the control panel to reorder them, in addition to the up and down arrows and double click shortcut. This is helpful when you have 2 runs of lots of flip angles and want to order them all run 1, run 2, run 1 etc.

Keyboard shortcuts to implement

  1. Navigate (n), Measure (m), Voxel edit (v), Recon edit (e), ROI (r), Point set (p)
  2. Lock & unlock a file (ctrl+l)

  3. Ctrl+y redo an action
  4. Alt+L to show/hide label outline only. Doesn't work for filled in contour, unless manually checking the show label outline box under the colormap list.


Priority to be determined

  1. Show and hide all ROIs with a keyboard shortcut (this feature would be helpful in both the volume and on the surface)
  2. Ability to delete ROIs from surface once you have loaded them
  3. Ability to switch layering order of ROIs on surface, like you can do in the volume
  4. Ability to load multiple ROIs to the surface simultaneously
  5. Manual thresholding of ROIs on the surface
  6. When multiple large size files are loaded and checked, scrolling slices is very slow. Is there a way to speed it up?
  7. Include a "Close Surface" option in the File tab, since it includes a "Close Volume" option

Should be discussed to see if we all agree

  1. When load a label, have it viewable in the surface and the volume (and only have to do -l on the command line for this).
  2. Allison wishes for a command line option and section on the GUI that allows users to load all the "basic" recon results. They wouldn't have to list out the path or browse for these files because they will always be in the same location: ?h.curv, ?.thickness, ?h.sulc, ?h.aparc.annot, ?h.aparc.a2009s.annot. The M, I, W, P, and O surface buttons could be repurposed for this.
  3. In the surfaces control panel, under Curvature, it should say "Load" instead of "Reload" because reload implies you will use the same file already loaded
  4. In the surfaces control panel, perhaps change "Show vertices" to "Highlight vertices" since the vertices are already visible in mesh mode (and this implies users weren't already looking at them)
  5. When have the inflated surface loaded and change the opacity, I'm not sure it's doing what a user would want
  6. In the surfaces control panel, when click on 'Overlay', the options are 'Load generic' or 'Load correlation'. Not sure what 'generic' or 'correlation' are describing. Are there better terms for this?
  7. It is unclear what midpoint and slope do when different files are loaded
  8. Load the scalar volume specified with the -dti flag as well as the dti data (usually fa.nii)
  9. In heatmap, additions to this binary volume (i.e. wm.mgz) show up as yellow. If possible, can this be a darker color (like green)? Yellow is hard to see when the opacity is low (which it usually is when using it during recon editing).
  10. When you save a screenshot, it automatically goes to the directory of the last time you saved a screenshot, even when that is from a different day/case. The first time you save a screenshot in a new instance of Freeview, could it start at the directory of the case you're in, instead? The path can be really difficult to change if you're in a totally different path location on the cluster. Once you've chosen the directory where you want to save images for the case you have loaded, then it would be nice for that directory path to be remembered (like it currently does).


Done!

  1. When in Recon edit mode, do not allow the drawing of voxels over already existing voxels that fall in the range of 5-250.
  2. Assign the ability to change slices to the up and down arrow keys and change the Page Up and Page Down keys to panning
  3. Bug: If the aparc.annot is loaded on the ?h.inflated, when you load a .label file, you cannot turn it off
  4. Bug: When load an overlay with a specified threshold from the commandline, clicking on the 3D surface changes the threshold back to the default - Possibly fixed because can't be replicated anymore however source of problem was not determined
  5. When loading ?h.inflated, specify default offsets 45 for rh and -45 for lh
  6. Ability to resize Layer list window to make it longer
  7. Color picker tool (under both voxel edit and recon edit modes) does not update the brush value within the pop-up window when the Color picker tool is selected. It does however, change the brush value on the control panel
  8. If you do Alt+v to turn off a volume, then hit the up arrow to change the slice, the File menu opens instead of the slice changing.
  9. In Recon Edit box, should value range a user can't draw on (5-250) be grayed out so they cannot change this? If they really wanted to do it, they can do it from the voxel edit mode.
  10. When you uncheck a layer, do not make it the active volume (do not highlight it)
  11. List the # of control points currently loaded/placed in one of the panels
  12. When loading a .label file, the browse window should go to the label directory by default if it exists (otherwise, stay in the current directory)
  13. When loading an overlay, go to the browse files window by default & have it look for 'All files' as default (I think this is done??)

  14. Ability to view only select 3D frames (i.e. just the coronal plane and not the axial or sagittal) - useful for paper figures
  15. Ctrl+f to turn on and off all surfaces currently loaded.
  16. When load inflated surface, don't show inflated surface lines in 2D view
  17. Ability to move the cursor to each control point in order of control point #
  18. Ability to Select several layers all at once and lock all of them at the same time
  19. Ability to load multiple labels from the command line
  20. When opening lots of recons, the brainmask.mgz always has to be windowed. It would be great if it remembered the windowing from before or did some kind of autowindowing.
  21. Along with the recon edit mode suggestions discussed, would like a keyboard shortcut for turning on and off the wm.mgz (it would be specific to that file and freeview would do it only if that file was loaded). Likewise for brainmask.mgz and aseg.mgz.
  22. When moving the cursor in Recon Edit mode, by clicking Shift + Ctrl + Left button, the cursor won't always move to the voxel you select. In the gray matter, it seems to jump to the nearest voxel on a surface. It also switches the slice sometimes. This makes it very hard to click on a point and go between the three views when editing to determine if a voxel is gm or wm.(was shortcut error that Ruopeng fixed)
  23. Add surface button that allows you to turn off and on all surfaces.

New features and improvements in v6: (added on 09/19/2017)

  • Unified layer list on control panel. Show all data layers in a single list view, instead of in multiple tabs.
  • Able to select multiple layers and adjust their settings at the same time
  • Much faster data loading on large data (using OpenMP)
  • Dedicated Recon Edit mode for recon editing
  • Added more volume filters
  • Show Talairach coordinate information
  • More ROI display options including thresholding and colorizing by stat.
  • Option to map volume ROI to surface and can edit on both volume and surface
  • Automatically move cursor to corresponding white surface vertex when clicking on inflated surface.
  • Can load multiple surface labels and display them at the same time
  • Option to colorize surface label by stat
  • Option to hide individual slice and/or surface in 3D view
  • Option to use percentile for setting thresholds for surface overlay
  • Option to adjust settings of multiple overlays at the same time
  • Option to go to the centroid of a label and also reorient 3D view based on the current vertex on surface.
  • Extensive command-line options
  • Many bug fixes

FreeviewDevelopment (last edited 2017-09-19 15:11:03 by EmmaBoyd)