Skip to content

Home

Jump to bottom
Davide Punzo edited this page Jun 14, 2016 · 239 revisions

Welcome to the SlicerAstro wiki!

Intro: SlicerAstro, an Astronomy (HI) extension for 3-D Slicer

Upcoming HI (neutral Hydrogen) surveys will deliver large datasets, and automated processing using the full 3-D information (two positional dimensions and one spectral dimension) to find and characterize HI objects is imperative. In this context, visualization is an essential tool for enabling qualitative and quantitative human control on an automated source finding and analysis pipeline. Visual Analytics, the combination of automated data processing and human reasoning, creativity and intuition, supported by interactive visualization, enables flexible and fast interaction with the 3-D data, helping the astronomer to deal with the analysis of complex sources. 3-D visualization, coupled to modeling, provides additional capabilities helping the discovery and analysis of subtle structures in the 3-D domain.

Check also: https://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerAstro

Objective: general description

* [x] 1) proper visualization of astronomical data cubes: using data astronomical data formats, such as FITS, and astronomical world coordinates system (WCS); * [ ] 2) Quantification: generation of Histogram, flux density profiles, moment maps and position-velocity diagrams, statistics linked with the 3-D view; * [x] 3) enabling interactive smoothing in all three dimensions; * [ ] 4) interactive HI data modeling coupled to visualization; * [ ] 5) introduction of the SAMP protocol to enable interoperability with Topcat, and other VO tools and catalogs.

Progress (1):

* [x] FITS reader and AstroVolume done; * [x] WCS included in AstroVolume; * [x] Added AstroLabelMapVolume (WCS compatible); * [x] Generalization of qSlicerUnits; * [x] Slicer dataProbe moduile overrided with AstroDataProbe one; * [x] First desing of the AstroVolume interface done; * [x] Added WCS axis in the 2-D views; * [x] Customization of 2-D and 3-D Views; * [x] Welcoming to SlicerAstro and AstroSampleData modules implemented; * [x] Done!

Progress (2):

* [ ] Histogram; * [ ] flux density profiles; * [ ] moment maps; * [ ] position-velocity diagrams; * [ ] statistics;

Progress (3):

* [x] module created; * [x] interface designed; * [x] Logic methods implemented on CPU (OpenMP); * [x] Logic methods implemented on GPU (OpenGL); * [x] Done!

Progress (4):

* [ ] implementing CloudLasso (3-D Lasso) effect in the segmentation editor; * [ ] enabling AstroWCSDisplay for SegmentationNodes (AstroSegmentationNode); * [ ] adding tilted-ring model routines (3DBarolo, Tirific); * [ ] visualziation: use segmentation for models, implement 3-D Views link;

Progress (5):

* [ ] implementing SAMP protocol in SlicerAstro;

General NOTE

* at the moment the SlicerAstro is not aware of the CELLSCAL keyword. * at the moment datacubes NAXIS>3 not supported (NAXIS=4 and NAXIS4=1 -> NAXIS=3). * In Slicer is possible to overley two datacube in the 2-D Views. However, at the moment, SlicerAstro does not perform any regridding and/or reprojection operations. This means that, at the moment, the user should take care to load datacubes with same gridding and and same WCS if she/he desires to overlay them on the 2-D Views. * 3-DSlicer, at the moment, uses Qt4.8.5. Using last versions of Ubuntu, it may happen to spot odd behaviour for the popup menus. This will be solved by the upgrade of 3-DSlicer to Qt5 (see https://www.slicer.org/slicerWiki/index.php/Documentation/Labs/Qt5). * 3-DSlicer will update soon VTK to version 7 which will provide even better rendering performance on GPU.

Get SlicerAstro

SlicerAstro is an official 3-DSlicer extension. Please, download 3-DSlicer:

http://download.slicer.org/

donwload SlicerAstro using the 3-DSlicer extension manager tool (available for Linux and MAC): http://wiki.slicer.org/slicerWiki/index.php/Documentation/Nightly/SlicerApplication/ExtensionsManager

SlcierAstro not available in the ExtesionManager at the moment (01/June/2016). Please recheck in one week.

After the installation, please configure the settings (to open the popup interface press ctrl+2) with the following instruction:

  • Volume Rendering: setup if the default rendering pipeline runs on CPU or GPU.
  • Modules: Remove all the medical modules by unclicking all the modules which are not included in the following list: Annotations, AstroDataProbe, AstroDataSample, AstroVolume, Crop Volume, Cameras, Charting, Colors, Compare Volumes, Data, DataProbe, DataStore, DoubleArrays, Event Broker, Markups, Reformat, ResampleScalarVectorDWIVolume, Scene Views, Smooth Volume, Subject Hierarchy, Tables, Transforms, Volume Rendering, Volumes, Welcome to Slicer, Welcome to SlicerAstro.
  • Set the default startup module: Welcome to SlicerAstro.

This procedure will be soon implemented as an automatic routine during the instalaltion (see http://na-mic.org/Mantis/view.php?id=2920#c13958);

For general information about 3-DSlicer and tutorials we refer to

The interface

For information about the GUI and the navigation, we refer to the Slicer documentation:

Markups and crosshair are also very useful tools. Please, check the following links:

Welcome module

The SlicerAstro's Modules

Check https://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Extensions/SlicerAstro

Python interactor

It is a very useful util to access run-time the Slicer classes (e.g. the data of the fits file are stored in the AstroVolume class). Python script can also be runned typing on termianl Slicer --python ...

See:

Quick Links: Home • Download • SlicerAstro Roadmap • Tutorial • 3DSlicer User Manual • SlicerAstro User Manual • Python Interactor • Developer Manual

Contents

User Documentation

Utility

Developer Documentation

Clone this wiki locally