Ploonetide

==================

- Added the ``lightkurve.seismology`` sub-package which enables quick-look
asteroseismic quantities to be extracted from ``Periodogram`` objects. [496]

- Added the ``stitch()`` method to ``LightCurveCollection`` and ``LightCurveFileCollection``
to enable multi-sector/multi-quarter data to be combined more easily. [548]

- Improved the ``LightCurve.fill_gaps()`` method to fill gaps in a light curve
with Gaussian noise proportional to the light curve's CDPP. [548]

- Added the ``TargetPixelFile.cutout()`` method which enables smaller Target
Pixel Files to be extracted from larger ones. [537]

- Added a ``pld_aperture_mask`` argument to ``PLDCorrector.correct()`` to enable
users to select the pixels used for creating the PLD basis vectors. [523]

- Added a new unit test module (test_synthetic_data.py) which utilizes
synthetic Target Pixel Files to validate Lightkurve features. [534]

- Added extra ``log.debug`` messages to ``lightkurve.search`` to enable users
to track the status of search and download operations. [547]

- Added several new usage examples to the docstrings of functions. [516]

- Removed seven methods which had been deprecated prior to v1.0: [515]
* removed ``lc.cdpp()`` in favor of ``lc.estimate_cdpp()``;
* removed ``lc.correct()`` in favor of ``lc.to_corrector().correct()``;
* removed ``lcf.from_fits()`` in favor of ``lightkurve.open()``;
* removed ``tpf.from_fits()`` in favor of ``lightkurve.open()``;
* removed ``lcf.from_archive()`` in favor of ``search_lightcurvefile()``;
* removed ``tpf.from_archive()`` in favor of ``search_targetpixelfile()``;
* removed ``tpf.centroids()`` in favor of ``tpf.estimate_centroids()``.

- Moved the ``Corrector`` systematics removal classes into their own
sub-package, named ``lightkurve.correctors``. [519]

- Fixed a bug which prevented ``lightkurve.open()`` from raising a
``FileNotFoundError`` when a file does not exist. [540]

- Fixed a bug which caused ``BoxLeastSquaresPeriodogram`` to ignore the
``period`` parameter. [514]

- Fixed a bug which prevented the ``t0`` argument of ``lc.fold()`` from being
an AstroPy Quantity object. [521]

==================

This is a minor bugfix release containing the following improvements:

- Fixed minor bugs in ``PLDCorrector.correct()`` [498],
``TargetPixelFile.create_threshold_mask()`` [502],
and ``LightCurve.bin()`` [503].

- Ensure users are alerted if a large number of cadences are masked out by
``quality_bitmask`` when opening data products. [495]

- ``CBVCorrector`` now accepts a ``KeplerLightCurve`` as input. [504]

- The ``lightkurve.search`` functions now provide a more helpful error message
if the download cache contains a corrupt file. [512]

- Switched continuous integration from Travis/Appveyor to Azure. [497]

==================

This is the first stable release of Lightkurve. It was prepared with the help
of 45 contributors!

This release contains major changes to the ``LombScarglePeriodogram`` class:

- Changed the default behavior of ``LombScarglePeriodogram.from_lightcurve()``
to use ``normalization='amplitude'`` and ``oversample_factor=5`` (the previous
defaults were ``normalization='psd'`` and ``oversample_factor=1``).
The docstring has been expanded to help users understand these options. [491]

- Added a ``LightkurveWarning`` to alert users of the changes to the default
behavior. [493]

- Deprecated the ``min_frequency``/``max_frequency`` arguments in favor of
``minimum_frequency``/``maximum_frequency`` to be consistent with the other
Periodogram classes. [478]

- Likewise, deprecated the ``min_period``/``max_period`` arguments in favor of
``minimum_period``/``maximum_period`` to be consistent with the other
Periodogram classes. [478]

Other changes are:

- Improved ``PLDCorrector`` to be more robust against the presence of NaNs.
[479, 488]

- Improved ``search_tesscut`` to avoid crashing in the event of an empty search
result, and to ensure that the files it returns carry the search string as
the ``targetid`` attribute. [475, 477]

- Various minor bug fixes. [488, 490, 494]

===================

- Significantly improved the performance of the ``PLDCorrector`` feature for
systematics removal. [470]

- Improved the normalization of the result returned by
``Periodogram.smooth(method='logmedian')``. [453]

- Improved the visualization of NaN values in ``TargetPixelFile.plot()``. [455]

- Various minor bug fixes. [448, 450, 463, 471]

===================

- The ``search_tesscut(...).download()`` feature now supports downloading
rectangular TESS FFI cut-outs. It previously only supported squares. [441]

- Fixed a bug which prevented ``search_tesscut(...).download_all()`` from
downloading all sectors. [440]

- Minor bug fixes and performance improvements. [439, 446]

===================

Changes
-------

- Simplified the installation of Lightkurve by turning several packages into
optional rather than required dependencies (``celerite``, ``pybind``,
``scikit-learn``, and ``bokeh``). [436]

- Added ``search_tesscut()``: an easy interface to access data produced using
the `MAST TESSCut service <https://mast.stsci.edu/tesscut/>`_. This service
extracts Target Pixel Files (TPFs) from TESS Full Frame Images (FFIs). [418]

- Added ``TargetPixelFile.interact_sky()``: an interactive Bokeh widget to
overlay Gaia DR2 source positions on top of TPFs. [124]

- Changed ``LightCurve.fold()``: the ``transit_midpoint`` parameter has been
deprecated in favor of the ``t0`` parameter. [419]

Bugfixes
--------

- Made ``BoxLeastSquaresPeriodogram`` robust against light curves that contain
NaNs. [432]

- ``TargetPixelFile.wcs`` now works for Target Pixel Files produced using the
MAST TessCut service. [434]