Difference between revisions of "Documentation/Nightly/Extensions/SlicerAstro"

From Slicer Wiki
Jump to: navigation, search
 
(59 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
{{documentation/{{documentation/version}}/module-header}}
 
{{documentation/{{documentation/version}}/module-header}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
[[File:Kapteyn logo1.png|Kapteyn Astronomical Institute]]
+
[[File:ERCIcon.png|300px|European Research Council]]
 +
[[File:Kapteyn logo1.png|500px|Kapteyn Astronomical Institute]]
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
  
 
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
 
{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
Authors: <b>Davide Punzo</b> (Kapteyn Astronomical Institute, University of Groningen), <b>Thijs van der Hulst</b> (Kapteyn Astronomical Institute, University of Groningen), <b>Jos Roerdink</b> (Johann Bernoulli Institute for Mathematics and Computer Science, University of Groningen)<br>
+
Authors:<br>
Acknowledgements: Special thanks to Steve Pieper (Isomics), Jean-Christophe Fillion-Robin (Kitware) and Andras Lasso (PerkLab, Queen's).
+
<b>Davide Punzo</b> (Kapteyn Astronomical Institute, University of Groningen) <br>
 +
<b>Thijs van der Hulst</b> (Kapteyn Astronomical Institute, University of Groningen) <br>
 +
<b>Jos Roerdink</b> (Johann Bernoulli Institute for Mathematics and Computer Science, University of Groningen) <br> <br>
 +
 
 +
Contributors: <br>
 +
<b>Jean-Christophe Fillion-Robin</b> (Kitware) <br>
 +
<b>Steve Pieper</b> (Isomics) <br>
 +
<b>Andras Lasso</b> (PerkLab, Queen's) <br> <br>
 +
 
 +
Acknowledgements: <br>
 +
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.<br> <br>
 +
 
 +
Note: <br>
 +
As of August 2018 financial support for SlicerAstro development has ended. The software will be maintained at the Kapteyn Astronomical Institute of the University of Groningen, but further development is currently on hold. If you have any query, pull request and/or ideas you can still contact [https://github.com/Punzo/SlicerAstro/wiki#contacts us] or submit a [https://github.com/Punzo/SlicerAstro/issues ticket]. <br> <br>
  
 
Contacts:
 
Contacts:
Line 17: Line 31:
 
Source: [https://github.com/Punzo/SlicerAstro]<br>
 
Source: [https://github.com/Punzo/SlicerAstro]<br>
 
License: [http://www.slicer.org/pages/LicenseText Slicer license]<br>
 
License: [http://www.slicer.org/pages/LicenseText Slicer license]<br>
'''Download/install:''' install 3D Slicer, start 3D Slicer, open the Extension Manager, install the SlicerAstro extension
+
'''Download/install:''' install 3D Slicer, start 3D Slicer, open the Extension Manager, install the SlicerAstro extension[https://github.com/Punzo/SlicerAstro/wiki].
  
 
<!--
 
<!--
Line 30: Line 44:
  
 
|
 
|
[[Image:SlicerAstroIcon1.png]]
+
[[Image:SlicerAstroIcon1.png|350px]]
 
|
 
|
 
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.
 
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.
Line 37: Line 51:
 
* 1) proper visualization of astronomical data cubes: using data astronomical data formats, such as FITS, and astronomical world coordinates system (WCS);
 
* 1) proper visualization of astronomical data cubes: using data astronomical data formats, such as FITS, and astronomical world coordinates system (WCS);
 
* 2) generation of Histogram, flux density profiles, moment maps and position-velocity diagrams linked with the 3-D view;
 
* 2) generation of Histogram, flux density profiles, moment maps and position-velocity diagrams linked with the 3-D view;
* 3) enabling interactive smoothing in all three dimensions and multiscale analysis, such as wavelet lifting;
+
* 3) enabling interactive smoothing in all three dimensions;
 
* 4) interactive HI data modeling coupled to visualization;
 
* 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.
 
* 5) introduction of the SAMP protocol to enable interoperability with Topcat, and other VO tools and catalogs.
  
<h3> Progress (1): </h3>
+
for more info see [https://github.com/Punzo/SlicerAstro/wiki] and [http://arxiv.org/pdf/1505.06976v2.pdf], [https://arxiv.org/pdf/1703.06651].
* FITS reader and AstroVolume done;
 
* WCS included in AstroVolume.
 
* Added AstroLabelMapVolume (WCS compatible).
 
* Generalization of qSlicerUnits.
 
* Slicer dataProbe moduile overrided with AstroDataProbe one.
 
* First desing of the AstroVolume interface done.
 
* Added WCS axis in the 2-D views.  
 
* Customization of 2-D and 3-D Views.
 
* Done!
 
 
 
<h3> Progress (3):  </h3>
 
* module created;
 
* interface designed;
 
* Logic methods implemented on CPU (OpenMP);
 
* Logic methods implemented on GPU (OpenGL);
 
* Done!
 
  
 
|
 
|
Line 64: Line 62:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-section|Modules}}
 
{{documentation/{{documentation/version}}/extension-section|Modules}}
{|
+
{||
|
+
 
 +
SlicerAstro development focuses on HI datasets. The [[Documentation/{{documentation/version}}/Modules/AstroVolume|Astro Volume]] component is the core module and handles the loading/saving, color functions and WCS corrdinates.
 +
 
 +
Tutorials and information can be found in the [[Documentation/{{documentation/version}}/Modules/AstroWelcome|Astro Welcome]] module and sample data are available at the [[Documentation/{{documentation/version}}/Modules/AstroSampleData|Astro Sample Data]] module.
  
*[[Documentation/{{documentation/version}}/Modules/]]
+
We currently provide additional modules with their own interface widgets for user interaction, which are mainly aimed for the analysis of HI data-cubes:
  
 +
*[[Documentation/{{documentation/version}}/Modules/SlicerAstroDataProbe|SlicerAstro Data Probe]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroReproject|Astro Reproject]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroStatistics|Astro Statistics]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroMasking|Astro Masking]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroSmoothing|Astro Smoothing]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroProfiles|Astro Profiles]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroMomentMaps|Astro Moment Maps]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroPVSlice|Astro PV Slice]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroPVDiagram|Astro PV Diagram]]
 +
*[[Documentation/{{documentation/version}}/Modules/AstroModeling|Astro Modeling]]
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
  
  
{{documentation/{{documentation/version}}/extension-section|Use Cases}}
+
{{documentation/{{documentation/version}}/extension-section|Use Case: Visualization of HI dataset}}
  
 +
3D visualization for the inspection and analysis of complex HI source:
 +
A 3D view gives an immediate overview of the coherence along the spatial and velocity dimensions such as tidal tail, gas stripping and filaments.
 +
 +
NOTE: SlicerAstro can potentially enhance also the inspection of other datasets such as mm/submm molecular line data and optical integral field spectroscopic data. The user is welcome to share any idea and feedback in the issue tracker[https://github.com/Punzo/SlicerAstro/issues].
 +
<br> <br>
 +
[[File:SlicerAstroScreenshot.png| Slicer Astro Screenshot|1000px]]
 +
<br> <br>
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
Line 79: Line 97:
 
==How to cite==
 
==How to cite==
 
Please cite the following paper when referring to SlicerAstro in your publication:<br>
 
Please cite the following paper when referring to SlicerAstro in your publication:<br>
 +
 +
<pre>
 +
@MISC{SlicerAstro,
 +
  author = {{Punzo}, D. and {van der Hulst}, T. and {Roerdink}, J. and {Fillion-Robin}, J.-C.
 +
},
 +
    title = "{SlicerAstro: Astronomy (HI) extension for 3D Slicer}",
 +
keywords = {Software },
 +
howpublished = {Astrophysics Source Code Library},
 +
    year = 2016,
 +
    month = nov,
 +
archivePrefix = "ascl",
 +
  eprint = {1611.021},
 +
}
 +
</pre>
 +
 +
<pre>
 +
@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},
 +
}
 +
</pre>
  
 
<pre>
 
<pre>
Line 94: Line 144:
 
     pages = {86-99},
 
     pages = {86-99},
 
       doi = {10.1016/j.ascom.2015.05.004},
 
       doi = {10.1016/j.ascom.2015.05.004},
  adsurl = {http://adsabs.harvard.edu/abs/2015A%26C....12...86P},
 
  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
 
 
}
 
}
 
</pre>
 
</pre>
 +
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/extension-footer}}
 
{{documentation/{{documentation/version}}/extension-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 13:59, 10 August 2018

Home < Documentation < Nightly < Extensions < SlicerAstro


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.

Note:
As of August 2018 financial support for SlicerAstro development has ended. The software will be maintained at the Kapteyn Astronomical Institute of the University of Groningen, but further development is currently on hold. If you have any query, pull request and/or ideas you can still contact us or submit a ticket.

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>

Source: [1]
License: Slicer license
Download/install: install 3D Slicer, start 3D Slicer, open the Extension Manager, install the SlicerAstro extension[2].

Extension Description

SlicerAstroIcon1.png

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.

Objective: general description

  • 1) proper visualization of astronomical data cubes: using data astronomical data formats, such as FITS, and astronomical world coordinates system (WCS);
  • 2) generation of Histogram, flux density profiles, moment maps and position-velocity diagrams linked with the 3-D view;
  • 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.

for more info see [3] and [4], [5].

Modules

SlicerAstro development focuses on HI datasets. The Astro Volume component is the core module and handles the loading/saving, color functions and WCS corrdinates. Tutorials and information can be found in the Astro Welcome module and sample data are available at the Astro Sample Data module. We currently provide additional modules with their own interface widgets for user interaction, which are mainly aimed for the analysis of HI data-cubes:

Use Case: Visualization of HI dataset

3D visualization for the inspection and analysis of complex HI source: A 3D view gives an immediate overview of the coherence along the spatial and velocity dimensions such as tidal tail, gas stripping and filaments.

NOTE: SlicerAstro can potentially enhance also the inspection of other datasets such as mm/submm molecular line data and optical integral field spectroscopic data. The user is welcome to share any idea and feedback in the issue tracker[6].

Slicer Astro Screenshot

References

How to cite

Please cite the following paper when referring to SlicerAstro in your publication:

@MISC{SlicerAstro,
   author = {{Punzo}, D. and {van der Hulst}, T. and {Roerdink}, J. and {Fillion-Robin}, J.-C.
	},
    title = "{SlicerAstro: Astronomy (HI) extension for 3D Slicer}",
 keywords = {Software },
howpublished = {Astrophysics Source Code Library},
     year = 2016,
    month = nov,
archivePrefix = "ascl",
   eprint = {1611.021},
}
@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},
}
@ARTICLE{2015A&C....12...86P,
   author = {{Punzo}, D. and {van der Hulst}, J.~M. and {Roerdink}, J.~B.~T.~M. and {Oosterloo}, T.~A. and {Ramatsoku}, M. and {Verheijen}, M.~A.~W.},
    title = "{The role of 3-D interactive visualization in blind surveys of H I in galaxies}",
  journal = {Astronomy and Computing},
archivePrefix = "arXiv",
   eprint = {1505.06976},
 primaryClass = "astro-ph.IM",
 keywords = {Radio lines: galaxies, Galaxies: kinematics and dynamics, Surveys, Scientific visualization, Visual analytics},
     year = 2015,
    month = sep,
   volume = 12,
    pages = {86-99},
      doi = {10.1016/j.ascom.2015.05.004},
}