Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
drizzlib [2019/09/16 15:51] ahughes |
drizzlib [2023/04/24 13:22] 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]] . |
| /* start comment | /* start comment | ||
| - | old link? | + | old link? removed by Annie 16 september 2019 |
| 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 79: | Line 58: | ||
| </code> | </code> | ||
| - | + | === Using pip === | |
| - | === The easy way === | + | |
| <code> | <code> | ||
| Line 88: | 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 104: | 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 115: | 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]] | ||
| + | |||
| + | |||
| + | ---- | ||