Documentation/Nightly/Extensions/lapdMouseBrowser

From Slicer Wiki
Jump to: navigation, search
Home < Documentation < Nightly < Extensions < lapdMouseBrowser


For the latest Slicer documentation, visit the read-the-docs.


Introduction and Acknowledgements

Acknowledgments: The lapdMouse Browser was funded in part by NIH grant R01 ES023863
Authors: Christian Bauer (University of Iowa)
Contributors: Reinhard Beichel (University of Iowa), Melissa Krueger (University of Washington), Robb Glenny (University of Washington)
Contact: <email>lapdmouse@iibi.uiowa.edu</email>

The University of Iowa (UIowa)  

Extension Description

The Lung Anatomy + Particle Deposition Mouse Archive (lapdMouse) contains anatomically derived lung models and aerosol deposition measurements of mice for modeling and computational toxicology. For more details about available datasets, data representation, other software, and support, please visit the project web site at https://doi.org/10.25820/9arg-9w56.

lapdMouseBrowser is an extension for 3D Slicer to access and visualize files from the lapdMouse data archive. It allows the user to browse through the datasets in the lapdMouse archive, download them to the local drive, and load them in 3D Slicer. Advantages include:

  • Visualize lapdMouse files not natively supported by 3D Slicer:
    • airway tree structure with branch labeling
    • aerosol deposition measurements
  • Download and visualize a set of commonly used files ("standard file selection") with a single click.
  • Pre-configured with suitable visualization parameters and color lookup tables for:
    • Volumetric images (aerosol and autofluorescent image data)
    • Labelmaps (lungs, lobes, near acini, airway segments)
    • Mesh models (airway segments, airway wall deposition)

lapdMouseBrowser main window Loaded standard file selection Visualized airway tree structure and near acini compartment deposition


Specify a local storage folder

lapdMouseDBBrowser Module

lapdMouseBrowser stores downloaded files in folder ./lapdMouse by default. If you want to change the default storage directory, close the lapdMouse Data Archive Browser window, change the Storage Folder using the lapdMouseBrowser 's 3D Slicer module panel (panel on left side of 3D Slicer main window) and reopen the lapdMouse Data Archive Browse window by clicking Show browser.


Download and visualize a standard set of files

In the lapdMouse Data Archive Browser window select on the left side the dataset you want to load. Then on the right side click load standard file selection in Slicer.

The "standard" file selection includes files commonly used:

  • AerosolSub4.mha (aerosol deposition image volume)
  • AutofluorescentSub4.mha (autofluorescent image volume showing anatomical structures)
  • Lobes.nrrd (Labelmap for lung lobes)
  • AirwayOutlets.vtk (Airway mesh with label assigned to outlets)
  • AirwayWallDeposition.vtk (aerosol deposition measurements near the airway wall)

If the files have not yet been downloaded, lapdMouseBrowser will display the total size of the files and ask the user to confirm the download. Note: Some files in the data archive such as full resolution volumetric images are several GB in size. Depending on your internet speed, the download might take several minutes. Files that are available on the local hard drive have a different status icon and will not have to be downloaded again.

Once the files are locally available, they will be loaded into 3D Slicer with suitable color lookup tables and default visualization parameters (e.g. gray-value window). After loading the standard files, 3D Slicer displays the aerosol deposition image and the airway wall deposition measurements mesh, and an outline of the lung lobes. The visualization parameters and displayed models can then be modified using 3D Slicer's standard functionality.

lapdMouseBrowser main window Loaded standard file selection

Download and visualize a custom set of files

Visualized airway tree structure and near acini compartment deposition

If you want to download additional (or other) files for a dataset, select the file names from the list (use Ctrl-key to select multiple at once), and click download selected files. lapdMouseBrowser will display the total size of the files and ask the user to confirm the download. After download, they get can get loaded in 3D Slicer using load selected files.


Modules

  • lapdMouseDBBrowser: Main interface to download and load lapdMouse files
  • lapdMouseVisualizer: Create visualizations (models) for lapdMouse files that are not natively supported by Slicer (tree structures, deposition measurement tables etc.)

Information for Developers