Difference between revisions of "Documentation/Nightly/Modules/AstroVolume"

From Slicer Wiki
Jump to: navigation, search
Line 92: Line 92:
 
[[File:AstroContourEffect.png|1000 px]]
 
[[File:AstroContourEffect.png|1000 px]]
  
<b>Contour Levels info</b>:
+
<br>
 
+
<br>
The Levels can be specified using the following format:  
+
The Contour Levels can be specified using the following format:  
 +
<br>
 
<br>
 
<br>
 
'FISRT:LAST+SPACING' for linear spacing or 'FISRT:LAST*SPACING' for non linear spacing.  
 
'FISRT:LAST+SPACING' for linear spacing or 'FISRT:LAST*SPACING' for non linear spacing.  
 +
<br>
 
<br>
 
<br>
 
The levels can also be specified as a list (e.g., 'VALUE1;VALUE2;VALUE3'). In the case of a list, it is possible also to specify for each contour
 
The levels can also be specified as a list (e.g., 'VALUE1;VALUE2;VALUE3'). In the case of a list, it is possible also to specify for each contour
 
both the MIN and MAX intensity values of the level (e.g., 'CONTOUR1MIN,CONTOUR1MAX;CONTOUR2MIN,CONTOUR2MAX').  
 
both the MIN and MAX intensity values of the level (e.g., 'CONTOUR1MIN,CONTOUR1MAX;CONTOUR2MIN,CONTOUR2MAX').  
 +
<br>
 
<br>
 
<br>
 
If the string is preceded by '3DDisplayThreshold', the levels are evaluated in units of the value of 3DDisplayThreshold of the dataset.                                           
 
If the string is preceded by '3DDisplayThreshold', the levels are evaluated in units of the value of 3DDisplayThreshold of the dataset.                                           
 +
<br>
 
<br>
 
<br>
 
If the Histogram is active in the plot view and a selection is made, by typing the string 'Histogram' will create a segmentation around the selection.
 
If the Histogram is active in the plot view and a selection is made, by typing the string 'Histogram' will create a segmentation around the selection.
 +
<br>
 
<br>
 
<br>
 
The contours in SlicerAstro are a full 3D segmentation. Therefore it can be computationally heavy to segment  
 
The contours in SlicerAstro are a full 3D segmentation. Therefore it can be computationally heavy to segment  
 
(marching cubes algorithm) and visualize around the noise range [-2, 2] RMS for large datacubes.
 
(marching cubes algorithm) and visualize around the noise range [-2, 2] RMS for large datacubes.
 +
<br>
 +
<br>
  
<br>
 
 
<br>
 
<br>
 
<h4>AstroCloudLasso Effect</h4><br>
 
<h4>AstroCloudLasso Effect</h4><br>

Revision as of 14:18, 18 January 2018

Home < Documentation < Nightly < Modules < AstroVolume


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


European Research Council Kapteyn Astronomical Institute

Introduction and Acknowledgements

Authors:
Davide Punzo (Kapteyn Astronomical Institute, University of Groningen)
Thijs van der Hulst (Kapteyn Astronomical Institute, University of Groningen)
Jos Roerdink (Johann Bernoulli Institute for Mathematics and Computer Science, University of Groningen)

Contributors:
Jean-Christophe Fillion-Robin (Kitware)
Steve Pieper (Isomics)
Andras Lasso (PerkLab, Queen's)

Acknowledgements:
This work was supported by the European Research Council under the European Union's Seventh Framework Programme (FP/2007-2013)/ERC Grant Agreement nr. 291-531.

Contacts:

  • Davide Punzo, <email>punzodavide@hotmail.it</email>; <email>D.Punzo@astro.rug.nl</email>
  • Thijs van der Hulst, <email>J.M.van.der.Hulst@astro.rug.nl</email>
  • Jos Roerdink <email>j.b.t.m.roerdink@rug.nl</email>

Back to SlicerAstro home

Module Description

The AstroVolume can read/write FITS file (astronomical data format) and handle the color function and display of Astro Volumes.


Panels and their use


Handling the loading and writing of FITS files


AstroLoading.png


MRML nodes that store the data-cube and the FITS keywords in the 3DSlicer object-tree (Data module)


AstroData.png


The control of the display coordinates


AstroVolumeInformation.png


The display of Beam information in the XY view


AstroHistogram.png


The control of the 2D color transfer function


Astro2DColorFunction1.png Astro2DColorFunction2.png Astro2DColorFunction3.png


The display of the Astronomical World Coordinate (WCS) and Data Probing for 2D views


Astro2Daxes.png


The display of Beam information in the XY view


AstroBeam.png


The control of the 3D color transfer function


Astro3DColorFunction.png


Tools to convert mask from FITS files (e.g., generated by SoFiA) into segmentations objects and viceversa


AstroMask2.png AstroMask6.png


Astro segmentation editor effect


AstroContours Effect


This editor effect can create multiple segmentation (3D contours) of the input volume.

AstroContourEffect.png



The Contour Levels can be specified using the following format:

'FISRT:LAST+SPACING' for linear spacing or 'FISRT:LAST*SPACING' for non linear spacing.

The levels can also be specified as a list (e.g., 'VALUE1;VALUE2;VALUE3'). In the case of a list, it is possible also to specify for each contour both the MIN and MAX intensity values of the level (e.g., 'CONTOUR1MIN,CONTOUR1MAX;CONTOUR2MIN,CONTOUR2MAX').

If the string is preceded by '3DDisplayThreshold', the levels are evaluated in units of the value of 3DDisplayThreshold of the dataset.

If the Histogram is active in the plot view and a selection is made, by typing the string 'Histogram' will create a segmentation around the selection.

The contours in SlicerAstro are a full 3D segmentation. Therefore it can be computationally heavy to segment (marching cubes algorithm) and visualize around the noise range [-2, 2] RMS for large datacubes.


AstroCloudLasso Effect


The AstroCloudLasso segmentation editor effect is a tool to interactively perform a 3D selection. This 3D selection (the segmentation) can be used either for:

1. changing an imported mask generated by automated algorithms (e.g., source finders);
2. providing an input mask to a variety of tools in SlicerAstro (e.g., MomentMaps module and Modeling module).

AstroMask3.png AstroMask4.png

References

@ARTICLE{2017A&C....19...45P,
   author = {{Punzo}, D. and {van der Hulst}, J.~M. and {Roerdink}, J.~B.~T.~M. and 
	{Fillion-Robin}, J.~C. and {Yu}, L.},
    title = "{SlicerAstro: A 3-D interactive visual analytics tool for HI data}",
  journal = {Astronomy and Computing},
archivePrefix = "arXiv",
   eprint = {1703.06651},
 primaryClass = "astro-ph.IM",
 keywords = {Radio lines: galaxies, Scientific visualization, Visual analytics, Agile software development, Object oriented development, Empirical software validation},
     year = 2017,
    month = apr,
   volume = 19,
    pages = {45-59},
      doi = {10.1016/j.ascom.2017.03.004},
}