Prev User's Tutorial: Connecting a Data Visualization Module Next

The Scopira distribution kits also contain modules to visualize data. Currently plot data and image data may be displayed. The fMRI dataset is image based, and we will use the Image Quad display module, located in the Display package of the IBD Analysis distribution kit. The User's Guide has a full description, and examples of usage, for all the modules included in Scopira's distribution kit.

Figure 11 shows the updated map that contains the Load Image Quad module and the selected Image Quad display module. Module writers can specify the type of icon picture to display for a map module, ideally reflecting the purpose of the module. The Image Quad module has one input data slot, the image_data (double-quad) (req:1) represents the volumetric quad image to display. It is a required slot and for this module to function properly and run (execute and produce optional output) data must be sent to this input slot. Refer to the User's Guide for further documentation on the Input Slot Connections sub-window. Notice that the Image Quad module does not generate any additional output, all the output slots are mirrors of the input slots.

Figure 11: Active map with two modules, a data loading module and a data display module.

To display the fMRI dataset loaded into Scopira, the quad-data output slot of the Load Image Quad must be connected to the quad-data input slot of the Image Quad display module. You can connect the required input slot of the Image Quad to the quad-data output slot of Load Image Quad, or vice versa. Figure 12 shows how to select the image_quad(double-quad) output slot for the module Load Image Quad. Right-click on the module and select the desired output slot from the pop-up menu, this slot will then be used for the next slot-to-slot connection. When the mouse button is released, the pop-up menu disappears and you can now right-click on any other module to select an appropriate input slot.

Figure 12: Select the image_quad output slot for the module Load Image Quad as a candidate for slot-to-slot connection.

Figure 13a shows how to finish the connection by right clicking on the Image Quad display module displays a pop-up menu as shown above. Selecting the image_data(double-quad)(req:1) slot will connect the two slots. See the User's Guide for explanations of the other optional connection slots: flush, reset, and run connections. Once the modules are successfully connected, the map windows are updated to illustrate the connection and the Image Quad module remains selected. When a module is selected, the input and output connection paths will be drawn with dark blue lines, as shown in Figure 13b.

Figure 13a: Finishing the connection. Figure 13b:Output of Load Image Quad connected to the selected module's input slot.

The slot information sub-window is also updated and displays the details of a slot's connections. Currently, the basic slot information includes the name of the module, and its associated slot, to which the slot is connected. As shown in Figure 13b, the image_data input slot for the Image Quad module is connected to the image_quad output slot of the Load Image Quad module.

If an existing slot connection is no longer needed it can be deleted by clicking on the check-box button next to the desired slot and clicking on the Delete Selected button at the bottom of the slot-information sub-window as illustrated in Figure 14.

Figure 14: To remove a connection, check the button next to the desired slot and click Delete Selected.

Selecting the Load Image Quad module will highlight the module connections in the map window. The Output Slots Connections sub-window will be updated to show the selected module's input and output slots as shown in Figure 15.

Figure 15: The output slot connections for the module Load Image Quad.

Right-click on the Load Image Quad module and select the Properties menu. Set the values as shown in Figure 9. Set the File Name: property to the distribution test dataset. Use the Browse button in the proponent window to locate the file fmri_128_256_1_42.dat in your local file system. It is a single slice fMRI dataset with 42 time acquisitions. Click Apply and Run on the properties menu. The module will attempt to load the file, and the output quad data array will be automatically passed on to the input slot of the Image Quad display module. [If you are running Scopira on a non-Intel system you do not need to swap the bytes when loading the binary data file.] Figure 16 shows the Load Image Quad module running.

Figure 16: Clicking on Apply and Run starts the Load Image Quad module.

While a module is running the icon will change to reflect it is busy and the map's background will change colour to indicate modules are being executed. Once the map finishes running, right-clicking on the Image Quad module and selecting Properties will display the fMRI data set in a proponent window. Figure17 displays the image data and allows the user some interactivity in choosing temporal volume.

Figure 17: Image viewer's proponent window displays the image data and allows user to choose which temporal volume to display.

Adjusting the Zoomer: slider in the Image Quad proponent window will enlarge the images in the display. All the slices in the dataset will be displayed (only 1 slice for this dataset) and the text entry Volume Num: may be changed to display a different volume, that is, a different temporal image acquisition image slices. To display a different temporal acquisition for this dataset, enter a value from 0 to 41 and press <Enter>. Click Close when you do not need to display the original dataset images. The proponents keep a copy of the last data values sent to them. If the proponent window is closed, and then displayed again via the Properties menu, the images from the last run will be displayed.


Prev Top Next
Data Loading Module  Scopira Home Saving and Loading a Map

Copyright © 2003 National Research Council