drizzle 2.2.0__cp313-cp313-win_amd64.whl

drizzle-2.2.0.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: drizzle
+Version: 2.2.0
+Summary: A package for combining dithered images into a single image
+Author: STScI
+Project-URL: Homepage, https://github.com/spacetelescope/drizzle
+Project-URL: Bug Tracker, https://github.com/spacetelescope/drizzle/issues
+Project-URL: Documentation, http://spacetelescope.github.io/drizzle/
+Project-URL: Source Code, https://github.com/spacetelescope/drizzle
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE.rst
+Requires-Dist: numpy
+Provides-Extra: test
+Requires-Dist: astropy; extra == "test"
+Requires-Dist: gwcs; extra == "test"
+Requires-Dist: pytest>=9.0; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-doctestplus; extra == "test"
+Provides-Extra: docs
+Requires-Dist: tomli; python_version < "3.11" and extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-automodapi; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: matplotlib; extra == "docs"
+Requires-Dist: pytest-doctestplus; extra == "docs"
+Dynamic: license-file
+
+drizzle Documentation
+=====================
+
+.. image:: https://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
+    :target: https://www.astropy.org
+    :alt: Powered by Astropy Badge
+
+.. image:: https://codecov.io/github/spacetelescope/drizzle/branch/main/graphs/badge.svg
+    :target: https://codecov.io/gh/spacetelescope/drizzle
+    :alt: Drizzle's Coverage Status
+
+.. image:: https://github.com/spacetelescope/drizzle/workflows/CI/badge.svg
+    :target: https://github.com/spacetelescope/drizzle/actions
+    :alt: CI Status
+
+.. image:: https://readthedocs.org/projects/spacetelescope-drizzle/badge/?version=latest
+    :target: https://spacetelescope-drizzle.readthedocs.io/en/latest/?badge=latest
+    :alt: Documentation Status
+
+.. image:: https://img.shields.io/pypi/v/drizzle.svg
+    :target: https://pypi.org/project/drizzle
+    :alt: PyPI Status
+
+.. image:: https://zenodo.org/badge/28100377.svg
+    :target: https://doi.org/10.5281/zenodo.10672889
+    :alt: Zenodo DOI
+
+The ``drizzle`` library is a Python package for combining dithered images into a
+single image. This library is derived from code used in DrizzlePac. Like
+DrizzlePac, most of the code is implemented in the C language. The biggest
+change from DrizzlePac is that this code passes an array that maps the input to
+output image into the C code, while the DrizzlePac code computes the mapping by
+using a Python callback. Switching to using an array allowed the code to be
+greatly simplified.
+
+The DrizzlePac code is currently used in the Space Telescope processing
+pipelines. This library is forward looking in that it can be used with
+the new GWCS code.
+
+Requirements
+------------
+
+- Python 3.10 or later
+
+- Numpy
+
+- Astropy
+
+The Drizzle Algorithm
+---------------------
+
+This section has been extracted from Chapter 3 of
+`The DrizzlePac Handbook <https://hst-docs.stsci.edu/drizzpac>`_ [Driz2025]_
+
+There are a family of linear reconstruction techniques that, at two opposite
+extremes, are represented by the interlacing and shift-and-add techniques, with
+the Drizzle algorithm representing a continuum between these two extremes.
+
+If the dithers are particularly well-placed, one can simply interlace the pixels
+from the images onto a finer grid. In the interlacing method, pixels from the
+independent input images are placed in alternate pixels on the output image
+according to the alignment of the pixel centers in the original images. However,
+due to occasional small positioning errors by the telescope, and non-uniform
+shifts in pixel space across the detector caused by geometric distortion of the
+optics, true interlacing of images is generally not feasible.
+
+Another standard simple linear technique for combining shifted images,
+descriptively named “shift-and-add”, has been used for many years to combine
+dithered infrared data onto finer grids. Each input pixel is block-replicated
+onto a finer subsampled grid, shifted into place, and added to the output image.
+Shift-and-add has the advantage of being able to easily handle arbitrary dither
+positions. However, it convolves the image yet again with the original pixel,
+thus adding to the blurring of the image and to the correlation of noise in the
+image. Furthermore, it is difficult to use shift-and-add in the presence of
+missing data (e.g., from cosmic rays) and geometric distortion.
+
+In response to the limitations of the two techniques described above, an
+improved method known formally as variable-pixel linear reconstruction, and more
+commonly referred to as Drizzle, was developed by Andy Fruchter and Richard
+Hook, initially for the purposes of combining dithered images of the Hubble Deep
+Field North (HDF-N). This algorithm can be thought of as a continuous set of
+linear functions that vary smoothly between the optimum linear combination
+technique (interlacing) and shift-and-add. This often allows an improvement in
+resolution and a reduction in correlated noise, compared with images produced by
+only using shift-and-add.
+
+The degree to which the algorithm departs from interlacing and moves towards
+shift-and-add depends upon how well the PSF is subsampled by the shifts in the
+input images. In practice, the behavior of the Drizzle algorithm is controlled
+through the use of a parameter called pixfrac, which can be set to values
+ranging from 0 to 1, that represents the amount by which input pixels are shrunk
+before being mapped onto the output image plane.
+
+A key to understanding the use of pixfrac is to realize that a CCD image can be
+thought of as the true image convolved first by the optics, then by the pixel
+response function (ideally a square the size of a pixel), and then sampled by a
+delta-function at the center of each pixel. A CCD image is thus a set of point
+samples of a continuous two-dimensional function. Hence the natural value of
+pixfrac is 0, which corresponds to pure interlacing. Setting pixfrac to values
+greater than 0 causes additional broadening of the output PSF by convolving the
+original PSF with pixels of non-zero size. Thus, setting pixfrac to its maximum
+value of 1 is equivalent to shift-and-add, the other extreme of linear
+combination, in which the output image PSF has been smeared by a convolution
+with the full size of the original input pixels.
+
+The Drizzle algorithm is conceptually straightforward. Pixels in the original
+input images are mapped into pixels in the subsampled output image, taking into
+account shifts and rotations between images and the optical distortion of the
+camera. However, in order to avoid convolving the image with the large pixel
+“footprint” of the camera, Drizzle allows the user to shrink the pixel before it
+is averaged into the output image through the pixfrac parameter.
+
+The flux value of each input pixel is divided up into the output pixels with
+weights proportional to the area of overlap between the “drop” and each output
+pixel. If the drop size is too small, not all output pixels have data added to
+them from each of the input images. One should therefore choose a drop size that
+is small enough to avoid convolving the image with too large an input pixel
+footprint, yet sufficiently large to ensure that there is not too much variation
+in the number of input pixels contributing to each output pixel.
+
+When images are combined using Drizzle, a weight map can be specified for each
+input image. The weight image contains information about bad pixels in the image
+(in that bad pixels result in lower weight values). When the final output
+science image is generated, an output weight map which combines information from
+all the input weight images, is also saved.
+
+Drizzle has a number of advantages over standard linear reconstruction methods.
+Since the pixel area can be scaled by the Jacobian of the geometric distortion,
+it is preserved for surface and absolute photometry. Therefore, the flux in the
+drizzled image, that was corrected for geometric distortion, can be measured
+with an aperture size that's not dependent of its position on the image. Since
+the Drizzle code anticipates that a given output pixel might not receive any
+information from an input pixel, missing data does not cause a substantial
+problem as long as the observer has taken enough dither samples to fill in the
+missing information.
+
+The blot methods perform the inverse operation of drizzle. That is, blotting
+performs the inverse mapping to transform the dithered median image back into
+the coordinate system of the original input image. Blotting is primarily used
+for identifying cosmic rays in the original image. Blot requires the user
+to provide the world coordinate system (WCS)-based transformations in the
+form of a pixel map array as input.
+
+.. [Driz2025] Anand, G. S., Mack, J., et al., 2025, “The DrizzlePac Handbook”, Version 3.0, (Baltimore: STScI)

drizzle-2.2.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+drizzle/__init__.py,sha256=oxhs37KR3IX8elCMiPkMMkLDCcb6P67PJHvcDqo5JKg,327
+drizzle/cdrizzle.cp313-win_amd64.pyd,sha256=PUIZMvLmU9YdkEiZ9-14a5zvQnOiyE4cifmtbDSoBaA,129536
+drizzle/resample.py,sha256=ALjSftUgDe1p1RdbktqjssfxPVo-w0QhMcGsYrHRtJs,49090
+drizzle/util.py,sha256=4n7s6YAy1U61acZFybI_CQBp7M4ywyUCJLepoyZtk94,849
+drizzle/utils.py,sha256=Ck_5krIuO73UIv551mK9FuboQFKxOaBhttKNEunLYps,10722
+drizzle/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+drizzle/tests/helpers.py,sha256=mEnfugosXR9KhnZwSRxNf1BvpuVXDnHl0MWbUJvnLCI,6838
+drizzle/tests/test_cdrizzle.py,sha256=0uaThTLkLlzvZ_kDdMLRogSrurvoeMVZPLdWDxrv0O8,726
+drizzle/tests/test_overlap_calc.py,sha256=57RrAVFBVzGs2Ng30UWmneMAFig1Q-f5rF4lHmANOpk,7597
+drizzle/tests/test_resample.py,sha256=jlmb4BcITgooEDVVotELBILAWr5Bzkrc4P7oseCLbkI,66315
+drizzle/tests/test_utils.py,sha256=T019dU06dHg5j7ZRBv6m3oynQvdnD5vZQxn8id61fY8,8138
+drizzle-2.2.0.dist-info/licenses/LICENSE.rst,sha256=sUXj5W73D9TcOw5ZXaDdcthYdY2b2dTJPsxBuZTOYWQ,1505
+drizzle-2.2.0.dist-info/METADATA,sha256=eME9dBaMUkqtzLt_4Ss3gejHK5iKVc4w7HotvuCpTTA,9086
+drizzle-2.2.0.dist-info/WHEEL,sha256=qV0EIPljj1XC_vuSatRWjn02nZIz3N1t8jsZz7HBr2U,101
+drizzle-2.2.0.dist-info/top_level.txt,sha256=MA5uqwTj1sJBi-hCeQj9v3-sZ9nVUTe6bd_zGWTKy5A,8
+drizzle-2.2.0.dist-info/RECORD,,

drizzle-2.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64
+

drizzle-2.2.0.dist-info/licenses/LICENSE.rst

@@ -0,0 +1,31 @@
+Copyright (C) 2011,2014 Association of Universities for Research in
+Astronomy (AURA)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+    1. Redistributions of source code must retain the above
+      copyright notice, this list of conditions and the following
+      disclaimer.
+
+    2. Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials
+      provided with the distribution.
+
+    3. The name of AURA and its representatives may not be used to
+      endorse or promote products derived from this software without
+      specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY AURA ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL AURA BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+OF THE POSSIBILITY OF SUCH DAMAGE.

drizzle-2.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+drizzle