diff --git a/README.rst b/README.rst index 47f268f..f723a79 100644 --- a/README.rst +++ b/README.rst @@ -11,7 +11,7 @@ Your one-stop-shop for quick computations with wavelets (aka little waves, aka j .. image:: https://codecov.io/gh/avivajpeyi/JazzHands/branch/testing/graph/badge.svg :target: https://codecov.io/gh/avivajpeyi/JazzHands - + .. image:: https://readthedocs.org/projects/jazzhands/badge/?version=latest :target: https://jazzhands.readthedocs.io/en/latest/?badge=latest @@ -32,7 +32,8 @@ Your one-stop-shop for quick computations with wavelets (aka little waves, aka j Authors ------- -This project is made by Trevor Dorn-Wallenstein, Amogh Desai(@theand9), Greg Gilbert (@gjgilbert), Athul R T (@athulvis), & Teresa Monsue (@astroluv). +This project is made by Trevor Dorn-Wallenstein, Amogh Desai(@theand9), Greg Gilbert (@gjgilbert), Athul R T (@athulvis), Teresa Monsue (@astroluv), Aditya Sengupta (@aditya-sengupta), James Kuszlewicz (@jsk389), Avi Vajpeyi (@avivajpeyi) + Installation ------------ diff --git a/paper/paper.bib b/paper/paper.bib new file mode 100644 index 0000000..89b1b44 --- /dev/null +++ b/paper/paper.bib @@ -0,0 +1,48 @@ +@ARTICLE{foster96, + author = {{Foster}, Grant}, + title = "{Wavelets for period analysis of unevenly sampled time series}", + journal = {\aj}, + keywords = {STARS: OSCILLATIONS, METHODS: NUMERICAL}, + year = "1996", + month = "Oct", + volume = {112}, + pages = {1709}, + doi = {10.1086/118137}, + adsurl = {https://ui.adsabs.harvard.edu/abs/1996AJ....112.1709F}, + adsnote = {Provided by the SAO/NASA Astrophysics Data System} +} + +@ARTICLE{torrence98, + author = {{Torrence}, Christopher and {Compo}, Gilbert P.}, + title = "{A Practical Guide to Wavelet Analysis.}", + journal = {Bulletin of the American Meteorological Society}, + year = 1998, + month = jan, + volume = {79}, + number = {1}, + pages = {61-78}, + doi = {10.1175/1520-0477(1998)079<0061:APGTWA>2.0.CO;2}, + adsurl = {https://ui.adsabs.harvard.edu/abs/1998BAMS...79...61T}, + adsnote = {Provided by the SAO/NASA Astrophysics Data System} +} + +@ARTICLE{dornwallenstein20b, + author = {{Dorn-Wallenstein}, Trevor Z. and {Levesque}, Emily M. and + {Neugent}, Kathryn F. and {Davenport}, James R.~A. and + {Morris}, Brett M. and {Gootkin}, Keyan}, + title = "{Short-term Variability of Evolved Massive Stars with TESS. II. A New Class of Cool, Pulsating Supergiants}", + journal = {\apj}, + keywords = {Massive stars, Evolved stars, Supergiant stars, Light curves, Stellar pulsations, Red supergiant stars, Multi-periodic pulsation, Wavelet analysis, Lomb-Scargle periodogram, Asteroseismology, Stellar astronomy, Yellow hypergiant stars, 732, 481, 1661, 918, 1625, 1375, 1078, 1918, 1959, 73, 1583, 1828, Astrophysics - Solar and Stellar Astrophysics}, + year = 2020, + month = oct, + volume = {902}, + number = {1}, + eid = {24}, + pages = {24}, + doi = {10.3847/1538-4357/abb318}, +archivePrefix = {arXiv}, + eprint = {2008.11723}, + primaryClass = {astro-ph.SR}, + adsurl = {https://ui.adsabs.harvard.edu/abs/2020ApJ...902...24D}, + adsnote = {Provided by the SAO/NASA Astrophysics Data System} +} diff --git a/paper/paper.md b/paper/paper.md new file mode 100644 index 0000000..34ea7a0 --- /dev/null +++ b/paper/paper.md @@ -0,0 +1,90 @@ +--- +title: 'JazzHands: A Python package for fast and accurate wavelet transformations on unevenly sampled data' + +tags: + - Python + - astronomy + - time series + - wavelets + - light curves + +authors: + - name: Trevor Z. Dorn-Wallenstein^[corresponding author.] + orcid: 0000-0003-3601-3180 + affiliation: "1" + - name: Aditya R. Sengupta + orcid: 0000-0002-5669-035X + affiliation: "2" + - name: James S. Kuszlewicz + orcid: 0000-0002-3322-5279 + affiliation: "3" + - name: Athul R. T. + orcid: 0000-0001-5565-7470 + affiliation: "4" + - name: Avi Vajpeyi + orcid: 0000-0002-4146-1132 + affiliation: "5, 6" + - name: Amogh Desai + orcid: 0000-0002-6015-9553 + affiliation: "7" + +affiliations: + - name: University of Washington + index: 1 + - name: University of California, Berkeley + index: 2 + - name: Independent Researcher + index: 3 + - name: Cochin University of Science and Technology + index: 4 + - name: School of Physics and Astronomy, Monash University, Vic 3800, Australia + index: 5 + - name: "OzGrav: The ARC Centre of Excellence for Gravitational Wave Discovery, Clayton VIC 3800, Australia" + index: 6 + - name: "Dwarkadas J. Sanghvi College of Engineering" + index: 7 + + +date: XX March 2021 +bibliography: paper.bib + +--- + +# Summary + +Time series photometry of astronomical objects encodes information about +these objects' physical state, and how they change on human timescales. Recent rapid cadence observations from missions like TESS and *Kepler* have been used to discover exoplanets around nearby stars, measure stellar pulsations, characterize variability in active galactic nuclei, and more. Wavelet analysis is an extension of Fourier analysis that allows astronomers to examine the frequency content of a light curve as a function of time. As such, it is an +ideal tool for studying real data, which often contain information that is +otherwise impossible to extract from the Fourier transform alone. + +# Statement of need + +`JazzHands` is a Python package for wavelet transformations. Typical wavelet +methods [@torrence98] assume that the data are regularly sampled and have +no gaps. This fact has hindered astronomical applications of wavelets. Data +taken from the ground are often irregularly sampled and have daily and seasonal +gaps due to the rotation and orbit of the Earth. While less problematic, space- +based data still have gaps due to downlink times, and time-stamp adjustments to +account for time-of-arrival differences along the spacecraft orbit induce +sampling irregularities. Interpolative methods may be used to offset these +effects, but introduce their own systematics into the wavelet transform. + +[@foster96] introduced a mathematical formulation of the wavelet transform +using the Morlet wavelet that accounts for the effects of irregular sampling +and gaps, and avoids the need for interpolation. +`JazzHands` is the first open-source Python 3 implementation of the @foster96 method, +and has already been used in scientific applications [@dornwallenstein20b]. The +combination of speed, customizability, and helpful features for users who are new to +wavelet analysis will enable exciting new science on the wealth of high precision light +curves that are currently being released. + +# Acknowledgements + +This project was developed in part at the online.tess.science meeting, which +took place globally in 2020 September. + +# References + +1. [@foster96] +2. [@torrence98] +3. [@dornwallenstein20b]