one_source_cutout

tessilator.tessilator.one_source_cutout(target, res_table, ref_name, gaia_sys=True, xy_pos=(10.0, 10.0), ap_rad=1.0, sky_ann=(6.0, 8.0), fix_rad=False, n_cont=10, cont_rad=10.0, mag_lim=3.0, keep_data=False, save_phot=False, cbv_flag=False, choose_sec=None, store_lc=False, cutout_size=20, tot_attempts=3, cap_sectors=None, fits_dir='fits', lc_dir='lc', pg_dir='pg', plot_ext='plots', clean_fail_modes=False, fix_noise=False, shuf_per=False, make_plot=False, calc_cont=True, lc_cont=False, make_shuf_plot=False, shuf_dir='shuf_plots')

Download cutouts and run lightcurve/periodogram analysis for one target.

Called by the function “all_sources_cutout”.

Parameters:

targetastropy.table.row.Row

A row of data from the astropy table.

lc_conbool

Decides if a lightcurve analysis is to be performed for the 5 strongest contaminants. Here, the data required for further analysis are stored in a table.

flux_conbool

Decides if the flux contribution from contaminants is to be calculated.

res_tableastropy.table.Table

The table to store the final tessilator results.

ref_namestr

The reference name for each subdirectory which will connect all output files.

gaia_sysbool, optional, default=True

Choose to format the data based on Gaia DR3. Note that no contamination can be calculated if this is False.

xy_postuple, size=2x2, optional, default=(10.,10.)

The centroid of the target in pixels.

ap_radfloat, optional, default=1.

The size of the aperture radius in pixels.

sky_anntuple, optional, default=(6.,8.)

A 2-element tuple defining the inner and outer annulus to calculate the background flux.

fix_radbool, optional, default=False

If True, then set the aperture radius equal to ap_rad, otherwise run the calc_rad algorithm.

n_contint, optional, default=10

The maximum number of neighbouring contaminants to store to table.

cont_radfloat, optional, default=10.

The maximum pixel radius to search for contaminants

mag_limfloat, optional, default=3.

The faintest magnitude to search for contaminants.

keep_databool

Choose to save the input data to file.

save_photbool, optional, default=False

Decide whether to save the full results from the aperture photometry.

cbv_flagbool, optional, default=False

Decide whether to run the lightcurve analysis with a CBV-correction applied.

choose_secNone, int or Iterable, optional, default=None

The sector, or sectors required for download.

• If None, TESScut will download all sectors available for the target.

• If int, TESScut will attempt to download this sector number.

• If Iterable, TESScut will attempt to download a list of sectors.

store_lcbool, optional, default=False

Choose to save the cleaned lightcurve to file.

cutout_sizefloat, optional, default=20.

The pixel length of the downloaded cutout.

tot_attemptsint, optional, default=3

The number of sql queries in case of request or server errors.

cap_sectorsNone, int, optional, default=None

The maximum number of sectors for each target.

fits_dirstr, optional, default=’fits’

The name of the directory to store the fits files.

lc_dirstr, optional, default=’lc’

The directory used to store the lightcurve files if store_lc==True.

pg_dirstr, optional, default=’pg’

The directory used to store the periodogram data.

clean_fail_modesbool, optional, default=False

Choose to remove parts of the lightcurve that are reported as problematic in the TESS Data Release Notes

fix_noisebool, optional, default=False

Choose to apply corrections accounting for systematic noise.

shuf_perbool, optional, default=False

Choose to run the shuffled period analysis (True=yes, False=no)

make_shuf_plotbool, optional, default=False

Choose to make a plot for the shuffled period analysis

shuf_dirstr, optional, default=’plot_shuf’

The name of the directory to save the plots of the shuffled period analysis.

Returns:

Nothing returned. Results are saved to table and plots are generated (if

specified).