![]() | Center for Imaging Science : About | Research | Publications | Education | Activities | Downloads | Visiting |
Software @ CIS : lddmm-volume : Birn Portalabout | tutorial | user validation | manual | birn portal | namespace | faq | credits | changelog | feedbackNew UsersIf this is the first time you have visited this web page, the Introduction section below would be a good place to start.Content
DATA
IntroductionThe lddmm BIRN Portal is being developed to enhance the lddmm processing and analysis of image data. This tutorial is aimed at persons wishing to analyze shape data using lddmm. LoginLogin into the LDDMM BIRN Portal.LDDMM BIRN PortalThe image below shows the users interface with LDDMM following logging in to the BIRN Portal.LDDMM processing using the sample hippocampus data will take approximately three hours. Select DimensionLDDMM processing allows the comparing of 2d or 3d analyze image data. Examples of image data used for testing lddmm is located in the Calibration section.Select BrowseIn the Atlas section click on the 'Browse' button. This will allow you to access the BIRN data files (Storage Resource Broker).Select AtlasSelect an Atlas image by either typing the full path or using the browser. LDDMM compares two images. These are referred to as the Atlas and the Target images. LDDMM will deform the Atlas image to match the Target image. Should a user wish to compare two images, the user designates one as the atlas and the other as the target. LDDMM then calculates the change from the Atlas to the Target. The Atlas data must be in Analyze format and the dimensions for volume data should be in multiples of 8. In the browser menu, select the .img file name. The hippocampus data sets used in the Semi-Automated Shape Analysis (SASHA) project were 80x96x80. An example data set in the Public area is:/home/Public/MorphSASHA__p0002/001446632245/Initial__92_001/shape_analysis__001/lddmm__0001/ Analysis/Snapshot__001/human/hippocampus/ registered_80_96_80/001446632245_lh.hippocampus_96.img Select targetSelect a Target image by either typing the full path or using the browser. The Target data must be in Analyze format and the dimensions for volume data should be in multiples of 8. The hippocampus data sets used in the Semi-Automated Shape Analysis (SASHA) project were 80x96x80. An example data set in the Public area is:/home/Public/MorphSASHA__p0002/001452043065/Initial__92_001/shape_analysis__001/lddmm__001/ Analysis/Snapshot__001/human/hippocampus/ registered_80_96_80/001452043065_lh.hippocampus_96.img Select 3D image radio button (as this example set is 3 dimensional). Select outputSelect an output directory.Launch JobLaunch - Begin processing. The page "BIRN Grid Job Status" window is displayed. This page displays a list of all jobs submitted to BIRN Portal. The type of job (LDDMM in this case) as well as the status and start date are displayed. More detailed information is available through this page.LDDMM processing using the sample hippocampus data will take approximately three hours. View StatusThe View status menu allows the user to view additional lddmm information used for processing. The commandline makes use of the common namespace for accessing data at a remote SRB location. Globus provides the authentication to this remote SRB site to allow for the transfer of data.
The input and output data for LDDMM on the BIRN Portal is accessed using the (Storage Resource Broker). Two interfaces exist to view the SRB data, InQ and SCommands. InQ is a Windows based program and is available from InQInQ is used to explore data located on the SRB. You will need to configure the InQ in order to download the resultant data in order to visualize the lddmm data.InQ DirectoryThe below screen shot diplays the metadata and directory structure of ldmm. The three resulant directories are vtk, txt, and analyze. The vtk directory contains the velocity data and the txt provides logging information and the metric distance between the two images.Get Data through ScommandsThe following is an example of retrieving data through the SRB Scommands. A local copy of the vtk data is needed for visualization. Note the metric distance in this comparison is 4.3686689.[anthony@jhu-gpop anthony]$ Sinit [anthony@jhu-gpop anthony]$ Scd /home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96 [anthony@jhu-gpop anthony]$ Sls /home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96: C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/analyze C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/txt C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk [anthony@jhu-gpop anthony]$ Scat txt/finalMetricDistance.txt 4.3686689 [anthony@jhu-gpop anthony]$ Scd vtk [anthony@jhu-gpop anthony]$ Sls /home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk: C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/deformation_maps C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/deformed_target C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/deformed_template C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/inverse_deformation_maps C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/other C-/home/akolasny.jhu-cis/renewal/XRG_lh.hippocampus_96/vtk/velocity_fields [anthony@jhu-gpop anthony]$ Scd /home/akolasny.jhu-cis/renewal [anthony@jhu-gpop anthony]$ Sget -b XRG_lh.hippocampus_96 . Visualize using MayaViMayaVi provides a helpful gui interface to visually explore the velocity vectors. Loading two hippocampus data sets and the velocity vectors, we see the areas of change between the structures.
Using MayaViWhen MayaVi is started the following window is displayed. Menu items in MayaVi can be selected using a mouse or keystrokes. In the following sections keystrokes are listed in parentheses.
To import the first data set select the File menu (Alt + F). The file menu bar is then displayed.
Select Open (O) on the file menu. A second menu listing file open options is displayed.
Select Vtk File (V) on the this menu. A file selection dialog is displayed.
Navigate to the appropriate directory (deformed_target) and select the desired *.vtk file (MoviedefPatient19.vtk). The data visualizer screen is displayed.
Select Visualize (Alt + V). The visualize menu is displayed.
Select Modules (M). The modules menu is displayed.
Select Isosurface (I). The image is displayed in the Visualization portion of the MayaVi window.
Perform the following actions on the Configure IsoSurface module dialog: 1) check the Compute PolyDataNormals checkbox. 2) Set Opacity to 0.55 using the Set Opacity scroll bar. 3) Close the Configure IsoSurface module dialog.
The first data set is now imported.
Import the second data set using the same procedure as the first data set: 1) File (Alt + F) 2) Open (O) 3) Vtk File (V) 4) Navigate to the appropriate directory (deformed_template) and select the desired *.vtk file (MoviedefAtlas0.vtk) The first image is still displayed.
Navigate to the Configure IsoSurface module dialog as before: 1) Visualize (Alt + V) 2) Modules (M) 3) Isosurface (I)
Perform the following actions on the Configure IsoSurface module dialog: 1) check the Compute PolyDataNormals checkbox. 2) Deselect the Scalar Coloring checkbox. 3) Select Change Object Color. The Change Object Color dialog is displayed. The Change Object Color dialog differs from Windows to Unix. The Windows dialog is discussed first, followed by unix dialog.
1) Select the desired color using mouse.
1) The desired color parameters are displayed in the edit boxes on the right hand side of the dialog. The color selection also can be input using these edit boxes. Select OK to close the Change objects color dialog.
1) Unix users can enter the desired color as follows. Place cursor in Selection box, and delete value #ffffff. Enter value #007ec0 (hit Return Key after entering this value, before selecting OK button). Select the OK button to apply the color change.
1) The two images can now be clearly distinguished. Set Opacity to 0.55 using the scroll bar and close the Configure IsoSurface Module dialog.
The second data set is now imported.
Import the third data set using the same procedure as the first data set: 1) File (Alt + F) 2) Open (O) 3) Vtk File (V) 4) Navigate to the appropriate directory (velocity_fields) and select the desired *.vtk file (MovieVelocity19.vtk)
Select Visualize (V). The visualize menu bar is displayed.
Select Filters (F). The filter menu is displayed. Select ExtractVectorNorm (V).
The Configure Vector dialog is displayed. Select OK to close the Configure Vector dialog.
Select Filters (F). The filter menu is displayed. Select Threshold (H).
The Configure Threshold dialog is displayed. Enter 2.0 in Minimum threshold edit box. Hit [Return] before selecting Close button. Select Close button on Configure Threshold dialog.
The first two data sets are displayed.
Select Visualize (V) Modules (M) VelocityVector (Y).
The two hippocampus data sets and velocity vectors are now displayed.
Visualize using ParaViewParaView provides a helpful gui interface to visually explore the velocity vectors. Loading two hippocampus data sets and the velocity vectors, we see the areas of change between the structures.
Using ParaViewWhen ParaView is started the following window is displayed. Menu items in ParaView can be selected using a mouse or keystrokes. In the following sections keystrokes are listed in parentheses.
To import the first data set select the File menu (Alt + F). The file menu bar is then displayed.
Select Open Data (O) on the file menu. A file selection dialog is displayed.
Navigate to the appropriate directory (deformed_target) and select the desired *.vtk file (MoviedefPatient9.vtk). The data visualizer screen is displayed.
Move cursor to the "Generate Isolines or Isosurfaces" icon. This is the ninth icon from the left on the toolbar.
Select the icon using the left mouse button. The modules menu is displayed.
Select the "Accept" button. The Isosurface is displayed in the 3D View window.
Locate the "Actor Color" dialog (in the Color group).
Select a color and press the "OK Button".
Set "Opacity" to 0.5 in the lowermost control.
Import the second data set using the same procedure as the first data set: 1) File (Alt + F) 2) Open Data (O) 3) Navigate to the appropriate directory (deformed_template) and select the desired *.vtk file (MoviedefAtlas0.vtk) The first image is still displayed.
As before, select the "Display" tab, change the color of the second isosurface, and set opacity to 0.5.
Import the third data set using the same procedure as the first data set: 1) File (Alt + F) 2) Open Data (O) 3) Navigate to the appropriate directory (velocity_fields) and select the desired *.vtk file (MovieVelocity9.vtk). For large data set, this may take some time (tens of seconds).
Select "Generate a Glyph" icon. This is the tenth icon from the left on the toolbar.
Select the "Accept" button. The template and target isosurfaces are displayed, as well as velocity vectors.
Acknowledgements: ParaView image data courtesy Alexandra Badea, Ph.D. Duke Center for In Vivo Microscopy
Last Modified: Friday, 17-Aug-2007 13:24:48 EDT |
|
|||||||||||