====== Drizzlib ======

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.

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)."

----
===== Python version =====

==== Authors ==== 

**Project Manager:**   Jean-Michel Glorian (IRAP)

**Scientist:**   Déborah Paradis (IRAP)\\
**Previous scientist:** Annie Hughes (IRAP)

**Developper:**   Mickaël Boiziot (IRAP)\\
**Previous developpers:**  Antoine Goutenoir (IRAP),  Anaïs Amato (IRAP), Gabriel Foënard (IRAP), Nathanael Jourdane (IRAP)



==== 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>
pip install drizzlib
</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 :
  *  [[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**
  * 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.

==== Installation Details ====

First, install the system dependencies :

<code | Debian / Ubuntu>
apt-get install python-dev pkg-config libfreetype* gfortran libopenblas-dev liblapack-dev
</code>

=== Using pip ===

<code>
pip install drizzlib
</code>

> :?: It may complain about ''numpy''. Install it, and try again.

=== From source ===

Uncompress the tarball, move into the newly created directory (e.g. ''drizzlib-2.0'')

Then, install drizzlib using ''pip'':

<code>
pip install --editable .
</code>

/* start comment
Then, install the python dependencies using ''pip'' :

<code>
pip install --upgrade setuptools
pip install -r requirements.txt
</code>

Finally, install ''drizzlib'' itself :

<code>
python setup.py install
</code>
end comment */

==== Using the drizzlib python code : simple example ====

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'' :

<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.1.tar.gz|drizzlib-1.2.6.1.tar.gz]] (2018-10-16)
  * [[http://cade.irap.omp.eu/downloads/drizzlib/python/drizzlib-1.2.5.tar.gz|drizzlib-1.2.5.tar.gz]] (2018-05-25)
  * [[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)

 	

----