A thorough structure for precise photometry and deconvolution of time series of wide field images.
Project description
LightCurver
Welcome to lightcurver
!
This is a photometry library leveraging STARRED,
best used with time series of wide-field images. You can read more about it in the documentation.
lightcurver
essentially prepares a Point Spread Function (PSF) model for each wide-field image, before using it
to precisely calibrate the relative zero point between each image.
Finally, STARRED
models the pixels of the region of interest,
yielding of course high quality light curves of the point sources in the region of interest,
but also recovering the subpixel information to provide a high signal-to-noise ratio deconvolution of the region of interest itself.
The example below shows a cutout of a wide-field image (one in a set of a hundred),
the model/deconvolution, and the Hubble Space Telescope image of the same region.
Features
- Uses plate solving (https://astrometry.net/) to keep track of the footprint of each frame, allowing for an independent selection of reference stars in each frame.
- Leverages Gaia information to select the right reference stars in the field of view.
- Never interpolates: essential to preserve the sub-pixel information that can be reocovered by
STARRED
in a multi-epoch deconvolution. - Provides an extremely precise relative flux calibration between epochs and a PSF model for each epoch.
- Uses
sqlite3
queries to dynamically determine which process needs be executed on which frame. (adding a new frame does not require the reprocessing of everything). - Attempts to keep the number of created files to a minimum, this is crucial when working on servers with high lattency storage.
Getting Started
-
Installation: the short version, install via
pip
:pip install lightcurver
The slightly longer version, in case you plan on using a GPU or the plate solving.
- Tutorial follow the tutorial of the documentation, which provides a dataset you can experiment with.
The implemented processing steps
Contributing
Whether you're fixing a bug, implementing a new feature, or improving documentation, your efforts are highly appreciated. If you are using this code and are encountering issues, feel free to contact me or to directly open an issue or pull request.
License
LightCurver is licensed under the GPL v3.0 License. See the LICENSE file for more details.
Contact
Have questions or suggestions? Feel free to open an issue, a pull request, or reach out!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lightcurver-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fa05d7e2d33b35ac0a077e71b6901eb7e71af25bab75aed10fb05f7272e7f5ee |
|
MD5 | 550c3208f63ffba98da79dd887b493ab |
|
BLAKE2b-256 | c8235517fff648a769151ad0c1cc20e222745f871054140f7c1ab99c1778ec1f |