all_sources_cutout

tessilator.tessilator.all_sources_cutout(t_targets, period_file, 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, choose_sec=None, save_phot=False, cbv_flag=False, store_lc=False, tot_attempts=3, cap_sectors=None, res_ext='results', lc_ext='lc', pg_ext='pg', fits_ext='fits', clean_fail_modes=False, keep_data=False, fix_noise=False, shuf_per=False, shuf_ext='shuf_plots', calc_cont=True, lc_cont=False, make_plot=False, make_shuf_plot=False)[source]

Run the tessilator for all targets.

Parameters:
t_targetsastropy.table.Table

Table of input data for the tessilator, with the following columns:

  • name: name of the target (str)

  • source_id: Gaia DR3 source identifier (str)

  • ra: right ascension

  • dec: declination

  • parallax: parallax

  • Gmag: Gaia DR3 apparent G-band magnitude

  • BPmag: Gaia DR3 apparent BP-band magnitude

  • RPmag: Gaia DR3 apparent RP-band magnitude

  • log_tot_bg: log-10 value of the flux ratio between contaminants and target (optional)

  • log_max_bg: log-10 value of the flux ratio between the largest contaminant and target (optional)

  • num_tot_bg: number of contaminant sources (optional)

period_filestr

Name of the file to store periodogram results.

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.

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.

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.

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.

store_lcbool, optional, default=False

Choose to save the cleaned lightcurve to file.

tot_attemptsint, optional, default=3

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

cap_sectorsint, optional, default=None

The maximum number of sectors for each target.

res_extstr, optional, default=’results’

The directory to store the final results file.

lc_extstr, optional, default=’lc’

The directory used to store the lightcurve files if lc_dir==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

fits_extstr, optional, default=’fits’

The name of the directory to store the fits files.

keep_databool

Choose to save the input data to file.

fix_noisebool, optional, default=False

Choose to apply the noise correction to the cleaned lightcurve.

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. The final table is saved to file and the program
terminates.