lightkurve.io.read#
- lightkurve.io.read(path_or_url, **kwargs)[source]#
Reads any valid Kepler or TESS data file and returns an instance of
LightCurve
or TargetPixelFileThis function will automatically detect the type of the data product, and return the appropriate object. File types currently supported include:
* `KeplerTargetPixelFile` (typical suffix "-targ.fits.gz"); * `KeplerLightCurve` (typical suffix "llc.fits"); * `TessTargetPixelFile` (typical suffix "_tp.fits"); * `TessLightCurve` (typical suffix "_lc.fits").
- Parameters
- path_or_urlstr
Path, URL, or S3 URI of a FITS file.
- quality_bitmaskstr or int, optional
Bitmask (integer) which identifies the quality flag bitmask that should be used to mask out bad cadences. If a string is passed, it has the following meaning:
“none”: no cadences will be ignored
“default”: cadences with severe quality issues will be ignored
“hard”: more conservative choice of flags to ignore This is known to remove good data.
“hardest”: removes all data that has been flagged This mask is not recommended.
See the
KeplerQualityFlags
orTessQualityFlags
class for details on the bitmasks.- flux_columnstr, optional
(Applicable to LightCurve products only) The column in the FITS file to be read as
flux
. Defaults to ‘pdcsap_flux’. Typically ‘pdcsap_flux’ or ‘sap_flux’.- **kwargsdict
Dictionary of arguments to be passed to underlying data product type specific reader.
- Returns
- dataa subclass of
LightCurve
or TargetPixelFile depending on the detected file type.
- dataa subclass of
- Raises
- ValueErrorraised if the data product is not recognized as a Kepler or TESS product.
Examples
To read a target pixel file using its path or URL, simply use:
>>> import lightkurve as lk >>> tpf = lk.read("mytpf.fits")