API

class webb_scraping.target.Target(input_name)

Bases: object

Performance of web reconnaisanse on an interesting target.

Attributes:

aliases:(list of strings) names by which the target is known in other catalogs. input_name:(str) name of target you’re interested in. webb_approved:(bool) whether or not the target has been included in approved webb program. hst_approved:(bool) whether or not the target has been included in a public HST program. webb_proposal_link:  (list of strings) if there are associated JWST proposals, these are the associated URLs. webb_proposal_names:  (list of strings) if there are associated JWST proposals, these are the associated proposal names. hst_data:(dict) keys are HST proposals, vals are links to associated data producs. exoplanet_archive_data:  (dict) arxiv_links:(list) list to PDFs of arxiv papers that have self.input_name or self.aliases in their abstracts

__init__:initializes. scrape_all:master run method. find_aliases:finds aliases. search_webb_site:  manual scraping, not preferred.

find_aliases()

Uses astroquery and Simbad to find any aliases of input_name; these are then put into the self.aliases list.

run_all_calculations(verbose=False)

Calculates the TSM and ESM (Kempton+ 18) for this target, using known planet properties.

scrape_HST()

Checks MAST for the target’s relevant HST proposals/data. Modifies hst_approved: if there are observations, sets it to True; otherwise False. Appends links to relevant HST data to hst_data.

scrape_all()

The preferred scraping method. This calls all other main scraping methods.

scrape_arxiv(progress=False)

Searches through arXiv abstracts for the target. Appends links of relevant arXiv pdfs to arxiv_links. If progress=True, outputs a tqdm progress bar.

scrape_exoFOP_aliases(ticid)

This manually scrapes exoFOP for aliases, given a TICID.

scrape_exoplanet_archive()

scrape_planet_properties()

Uses exo_MAST to get planet properties for this target.

scrape_webb_MAST()

Checks MAST for the target’s relevant JWST proposals/data. Modifies webb_approved: if there are relevant proposals, sets it to True; otherwise False. Appends the names of these proposals to webb_proposal_names.

search_ERS()

Manually scrapes the JWST ERS page.

search_GTO()

Manually scrapes the JWST GTO page.

search_webb()

Manually scrapes both the JWST ERS and GTO pages.

search_webb_site(URL)

Checks whether self has been approved via GTO or ERS. Needs debugging as missing above targets still. Adds any links to webb_proposal_links. changed webb_approved. not validated to ERS.

webb_scraping.calculations.ESM(planet_properties, verbose=False)

Takes in planet properties, computes ESM (Kempton+ 18) for it. Need to double-check units?

Inputs:

planet_properties:  (dict) contains planet orbital_distance (in AU), stellar radius (solar radii), stellar effective temperature (K), planet mass (Jupiter masses), orbital period (days), stellar K band magnitude (mag), and planet-star radius ratio. verbose:(bool) False. Dtermines whettehr properties are printed after computaiton.

Outputs:

ESM:(float) SNR proxy for emission spectroscopy introduced by Kempton+ 18.

webb_scraping.calculations.TSM(planet_properties, verbose=False)

Takes in row of dataframe, computes TSM (Kempton+18) for it.

Inputs:

planet_properties:  (dict) contains planet orbital_distance (in AU), stellar radius (solar radii), stellar effective temperature (K), planet mass (Jupiter masses), stellar mass (solar masses), orbital period (days), stellar J band magnitude (mag), and planet-star radius ratio. verbose:(bool) False. Dtermines whettehr properties are printed after computaiton.

Outputs:

ESM:(float) SNR proxy for emission spectroscopy introduced by Kempton+ 18.

webb_scraping.calculations.blackbody(wav, T)

Computes the blackbody curve at a given wavelength.

Inputs:

wav:(float) wavelength of interest (m) T:(float) temperature of body in question

Outputs:

intensity:(float) value of blackbody curve.

webb_scraping.calculations.kepler_a(m1, m2, P)

Computes semimajor axis with Kepler’s Third Law.. Inputs:

m1:(float) mass of first body (kg) m2:(float) mass of second body (kg) P:(float) orbital period (s)

Outputs:

a:(float) semimajor axis of the orbit (m)