Differences
This shows you the differences between two versions of the page.
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) | ||
+ | |||
+ | |||
+ | |||
+ | ---- |