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/09/16 15:53]
ahughes [Python version]
drizzlib [2023/04/24 13:26] (current)
Déborah Paradis
Line 1: Line 1:
 ====== Drizzlib ====== ====== Drizzlib ======
-From this page you can download the drizzling software library, **drizzlib**,​ which reprojects data from HEALPix to local WCS FITS format. The library is available in IDL and Python languages.+ 
 +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.
  
 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. 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** ​CADE now 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/​+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/​ 
 + 
 +If you use drizzlib for your research, please include the following acknowledgement in your publications:​ 
 + 
 +"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)."
  
 ---- ----
-===== IDL version =====+===== Python ​version =====
  
 ==== Authors ====  ==== Authors ==== 
  
-  ​//​Jean-Philippe Bernard (IRAP)// +**Project Manager:**   Jean-Michel Glorian ​(IRAP)
-  ​//Nathalie Baby (IRAP)// +
-  ​//Caroline Bot (CDS)// +
-  ​//Laurent Cambrésy (CDS)// +
-  * //Déborah Paradis (IRAP)// +
-  * //Alexandre Sauvé ​(IRAP)//+
  
-==== Download ==== +**Scientist:​** ​  ​Déborah Paradis (IRAP)\\ 
 +**Previous scientist:​** Annie Hughes (IRAP)
  
-[[http://​cade.irap.omp.eu/​documents/​Ancillary/​Software/​drizzlib_v08_15_beta.zip|drizzlib_v08_15_beta.zip]]+**Developper:**   ​Mickaël Boiziot (IRAP)\\ 
 +**Previous developpers:​** ​ Antoine Goutenoir (IRAP), ​ Anaïs Amato (IRAP), Gabriel Foënard (IRAP), Nathanael Jourdane (IRAP)
  
----- 
-===== Python version ===== 
  
-==== Authors ====  
  
-  * //Antoine Goutenoir (IRAP)// +==== Where to download the drizzlib python code ==== 
-  ​* //Déborah Paradis (IRAP)// +   
-  * //Jean-Michel Glorian (IRAP)// + CADE supports several options for getting access to drizzlib-python: ''​git'',​ ''​pip''​ and direct download of the source tarball. 
-  ​* //Gabriel Foënard (IRAP)// +   
-  * //Nathanael Jourdane (IRAP)// + The python package can be downloaded and installed via ''​pip'' ​ (recommended):
-  ​* //Anaïs Amato (IRAP)//+
  
- +<​code>​ 
-==== Source and Download ====+pip install drizzlib 
 +</​code> ​
   ​   ​
 The source tree is available on [[https://​gitlab.irap.omp.eu/​cade/​drizzlib-python|gitlab]] . The source tree is available on [[https://​gitlab.irap.omp.eu/​cade/​drizzlib-python|gitlab]] .
Line 43: Line 42:
 https://​gitlab.irap.omp.eu/​OV-GSO-DC/​drizzlib-python|gitlab]]. https://​gitlab.irap.omp.eu/​OV-GSO-DC/​drizzlib-python|gitlab]].
  end comment */  end comment */
- 
-The python package itself can be downloaded an installed via ''​pip''​ : 
- 
-<​code>​ 
-pip install drizzlib 
-</​code>​ 
  
 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 80: Line 58:
 </​code>​ </​code>​
  
- +=== Using pip ===
-=== The easy way ===+
  
 <​code>​ <​code>​
Line 89: 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 105: 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 116: 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)
 +
 + 
 +
 +----