Data handling

Data handling#

The spectroscopic light curves are given to ExoIris as a TSData (Transmission Spectroscopy Data) or TSDataGroup object. TSData is a utility class that provides methods for data cleanup, binning, and cropping, and uncertainty estimation, while TSDataGroup is a container class that can hold multiple TSData objects and provides aggregate properties and methods.

Main classes#

`TSData`(time, wavelength, fluxes, errors, name)	`TSData` is a utility class representing transmission spectroscopy time series data with associated wavelength, fluxes, and errors.
`TSDataGroup`(data)	`TSDataGroup` is a high-level data storage class that can contain multiple `TSData` objects.

Data wrangling#

`TSData.bin`([wave_binning, time_binning, ...])	Bin the data along the wavelength and/or time axes.
`TSData.bin_wavelength`([binning, nb, bw, r, ...])	Bin the data along the wavelength axis.
`TSData.bin_time`([binning, nb, bw, ...])	Bin the data along the time axis.
`TSData.crop_wavelength`(lmin, lmax[, inplace])	Crop the data to include only the wavelength range between lmin and lmax.
`TSData.crop_time`(tmin, tmax[, inplace])	Crop the data to include only the time range between lmin and lmax.
`TSData.mask_outliers`([sigma])	Mask outliers along the wavelength axis.
`TSData.normalize_to_median`(s)	Normalize the light curves to the median flux of the given slice along the time axis.
`TSData.normalize_to_poly`([deg])	Normalize the baseline flux for each spectroscopic light curve.
`TSData.partition_time`(tlims)	Partition the data into n segments defined by tlims.

Uncertainty estimation#

TSData.estimate_average_uncertainties()

Estimate the per-wavelength average flux uncertainties.

Masking#

`TSData.mask_transit`([t0, p, t14, ephemeris, ...])	Create a transit mask based on a given ephemeris or exposure index limits.
`TSDataGroup.mask_transit`(tc, p, t14)

I/O#

`TSData.export_fits`()	Generate a `HDUList` containing HDUs storing the data and metadata.
`TSData.import_fits`(name, hdul)	Import a data set from a `HDUList`.
`TSDataGroup.export_fits`()	Export the dataset along with its metadata to a FITS HDU list.
`TSDataGroup.import_fits`(hdul)	Import all the data from a FITS HDU list.

Plotting#

`TSData.plot`([ax, vmin, vmax, cmap, figsize, ...])	Plot the spectroscopic light curves as a 2D image.
`TSData.plot_white`([ax, figsize])	Plot a white light curve.
`TSDataGroup.plot`([axs, vmin, vmax, ncols, ...])	Plot all the data sets.