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
Last revision Both sides next revision
drizzlib [2019/07/04 14:20]
cade [Python version]
drizzlib [2023/04/24 13:22]
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 formatThe current library is available in Python3Older 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), ​ 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-1.2.6.3.tar.gz|drizzlib-1.2.6.3.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)
 +
 +==== IDL version =====  ​
 +-  
 +==== Authors ====  
 +-  
 +  * //​​Jean-Philippe Bernard (IRAP)//​  ​
 +-   * //Nathalie Baby (IRAP)//​  ​
 +-   * //Caroline Bot (CDS)//​  ​
 +-   * //Laurent Cambrésy (CDS)//​  ​
 +-   * //Ludovic Montier (IRAP)//​  ​
 +-   * //Déborah Paradis (IRAP)//​  ​
 +-   * //Alexandre Sauvé (IRAP)//​  ​
 +-  
 +-  
 +-  
 +- ==== Download ====  
 +-  
 +- [[http://​​cade.irap.omp.eu/​​documents/​​Ancillary/​​Software/​​drizzlib_v08_15_beta.zip|drizzlib_v08_15_beta.zip]]  ​
 + 
 +
 +----