Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
drizzlib [2019/07/04 14:21]
cade 		drizzlib [2024/06/18 12:22] (current)
Déborah Paradis
Line 1: Line 1:
 ====== Drizzlib ====== ====== Drizzlib ======
-In this page you can download the drizzling software library, which reprojects data from HEALPix to local WCS, in IDL and Python languages. 
-The drizzling library uses a strategy where the surface of pixel intersection is computed as presented in Appendix A of Paradis et al., 2012, A&A, 543, 103. This method allows fast ingestion and guarantees the photometric accuracy of the transformation with minimal data loss during the transformation from HEALPix ​ to local WCS FITS. 
  
-**NEW** You can now access a web interface to reproject ​data from HEALPix to local WCS http://​drizzweb.irap.omp.eu/+From this page you can download the drizzling software library, ​**drizzlib**, which reprojects ​data from HEALPix to local WCS FITS format. The current library is available in Python3. Older versions in Python2 are available, but no longer actively maintained.
  
-===== IDL version ===== +The drizzling library uses a strategy where the surface of pixel intersection is computed as presented in Appendix A of Paradis et al., 2012, A&A, 543, 103. This method allows fast ingestion and guarantees the photometric accuracy of the transformation with minimal data loss during the transformation from HEALPix ​ to local WCS FITS.
----- +
-==== Authors ==== +
  
-  ​* //​Jean-Philippe Bernard (IRAP)// +CADE also offers a web interface to the drizzling software library called ​**drizzweb**. This allows the user to reproject data from HEALPix to local WCS FITS format using CADE's computing resources. The **drizzweb** page is here http://drizzweb.irap.omp.eu/
-  ​* //Nathalie Baby (IRAP)// +
-  ​* //Caroline Bot (CDS)// +
-  ​* //Laurent Cambrésy (CDS)// +
-  ​* //Déborah Paradis (IRAP)// +
-  ​* //Alexandre Sauvé (IRAP)//+
  
-==== Download ==== +If you use drizzlib for your research, please include the following acknowledgement in your publications:​
  
-[[http://​cade.irap.omp.eu/​documents/​Ancillary/​Software/​drizzlib_v08_15_beta.zip|drizzlib_v08_15_beta.zip]]+"We acknowledge the use of the drizzlib software provided by the Centre d'​Analyse de Données Etendues (CADE), a service of IRAP-UPS/​CNRS (http://​cade.irap.omp.eu, Paradis et al., 2012, A&A, 543, 103)."
  
 +----
 ===== Python version ===== ===== Python version =====
- 
----- 
  
 ==== Authors ====  ==== Authors ==== 
  
-  ​* //Antoine Goutenoir (IRAP)// +**Project Manager:**   Jean-Michel Glorian (IRAP)
-  ​* //Déborah Paradis (IRAP)// +
-  ​* //Jean-Michel Glorian (IRAP)// +
-  * //Gabriel Foënard (IRAP)// +
-  * //Nathanael Jourdane (IRAP)// +
-  * //Anaïs Amato (IRAP)//+
  
 +**Scientist:​** ​  ​Déborah Paradis (IRAP)\\
 +**Previous scientist:​** Annie Hughes (IRAP)
  
-==== Source and Download ==== +**Developper:​** ​  ​Mickaël Boiziot (IRAP)\\ 
-   +**Previous developpers:**  Antoine Goutenoir (IRAP), ​ Déborah Paradis (IRAP), Anaïs Amato (IRAP), Gabriel Foënard (IRAP), Nathanael Jourdane (IRAP)
-The source tree is available on [[https://​gitlab.irap.omp.eu/​OV-GSO-DC/​drizzlib-python|gitlab]].+
  
-The python package ​itself ​can be downloaded ​an installed via ''​pip''​ :+ 
 + 
 +==== Where to download the drizzlib python code ==== 
 +   
 + CADE supports several options for getting access to drizzlib-python:​ ''​git'',​ ''​pip''​ and direct download of the source tarball. 
 +   
 + The python package can be downloaded ​and installed via ''​pip'' ​ ​(recommended):
  
 <​code>​ <​code>​
 pip install drizzlib pip install drizzlib
-</​code>​+</​code> ​ 
 +   
 +The source tree is available on [[https://​gitlab.irap.omp.eu/​cade/​drizzlib-python|gitlab]] . 
 + 
 +/* start comment 
 +old link? removed by Annie 16 september 2019 
 +https://​gitlab.irap.omp.eu/​OV-GSO-DC/​drizzlib-python|gitlab]]. 
 + end comment */
  
 Or you can directly grab a tarball here : Or you can directly grab a tarball here :
-  *  ​**NEW** ​[[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-2.0.tar.gz|drizzlib-2.0.tar.gz]] (2019-07-04) **for Python >= 3.6**+  *  [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-2.1.2.tar.gz|drizzlib-2.1.2.tar.gz]] (2019-11-19) **for Python >= 3.6**
   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.6.3.tar.gz|drizzlib-1.2.6.3.tar.gz]] (2018-12-07) **for Python >= 2.7**   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.6.3.tar.gz|drizzlib-1.2.6.3.tar.gz]] (2018-12-07) **for Python >= 2.7**
 +  * tarballs for older versions of drizzlib (python 2.7 only) are linked at the bottom of this page.
  
 > :!: There are detailed instructions and troubleshooting tips in the ''​README'',​ which you should read. > :!: There are detailed instructions and troubleshooting tips in the ''​README'',​ which you should read.
- 
- 
-==== Usage ==== 
- 
-Here's a simple usage example, that reads ''​my_healpix.fits''​ and extracts a subset of its data as described by the header in ''​wcs_config.fits'',​ and writes the result into ''​my_wcs.fits''​ : 
- 
-<code python> 
-from drizzlib import healpix2wcs 
- 
-healpix2wcs( 
-    '​my_healpix.fits',​ 
-    header='​wcs_config.fits',​ 
-    output='​my_wcs.fits'​ 
-) 
-</​code>​ 
  
 ==== Installation Details ==== ==== Installation Details ====
Line 74: Line 58:
 </​code>​ </​code>​
  
- +=== Using pip ===
-=== The easy way ===+
  
 <​code>​ <​code>​
Line 83: Line 66:
 > :?: It may complain about ''​numpy''​. Install it, and try again. > :?: It may complain about ''​numpy''​. Install it, and try again.
  
-=== The other way ===+=== From source ​===
  
-Uncompress the tarball, move into it.+Uncompress the tarball, move into the newly created directory (e.g. ''​drizzlib-2.0''​)
  
-Then, install the python dependencies using pip :+Then, install drizzlib using ''​pip'':​ 
 + 
 +<​code>​ 
 +pip install --editable . 
 +</​code>​ 
 + 
 +/* start comment 
 +Then, install the python dependencies using ''​pip'' ​:
  
 <​code>​ <​code>​
Line 99: Line 89:
 python setup.py install python setup.py install
 </​code>​ </​code>​
 +end comment */
  
 +==== Using the drizzlib python code : simple example ====
  
-=== Old version ===+Here's a simple usage example that reads ''​my_healpix.fits'',​ extracts a subset of its data as described by the header in ''​wcs_config.fits'',​ and writes the result into ''​my_wcs.fits''​ :
  
-Only for python 2.7+<code python>​ 
 +from drizzlib.healpix2wcs import healpix2wcs 
 + 
 +healpix2wcs( 
 +    '​my_healpix.fits',​ 
 +    header='​wcs_config.fits',​ 
 +    output='​my_wcs.fits'​ 
 +) 
 +</​code>​ 
 + 
 + 
 +=== Older versions of the drizzlib library (python 2.7 only) ===
  
   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.6.2.tar.gz|drizzlib-1.2.6.2.tar.gz]] (2018-11-16)   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.6.2.tar.gz|drizzlib-1.2.6.2.tar.gz]] (2018-11-16)
Line 110: Line 113:
   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.2.tar.gz|drizzlib-1.2.2.tar.gz]] (2017-05-17)   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.2.2.tar.gz|drizzlib-1.2.2.tar.gz]] (2017-05-17)
   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.0.1.tar.gz|drizzlib-1.0.1.tar.gz]] (2015-12-18)   * [[http://​cade.irap.omp.eu/​downloads/​drizzlib/​python/​drizzlib-1.0.1.tar.gz|drizzlib-1.0.1.tar.gz]] (2015-12-18)
 +
 + 
 +
 +----