Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
drizzlib [2019/09/16 15:48] ahughes |
drizzlib [2023/04/24 13:21] Déborah Paradis [Python version] |
||
---|---|---|---|
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/ |
- | + | ||
- | ---- | + | |
- | ===== IDL version ===== | + | |
- | + | ||
- | ==== Authors ==== | + | |
- | + | ||
- | * //Jean-Philippe Bernard (IRAP)// | + | |
- | * //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)." |
---- | ---- | ||
Line 27: | Line 16: | ||
==== 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-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 75: | Line 58: | ||
</code> | </code> | ||
- | + | === Using pip === | |
- | === The easy way === | + | |
<code> | <code> | ||
Line 84: | 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 100: | 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 111: | 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]] | ||
+ | |||
+ | |||
+ | ---- |