Versions Compared

Old Version 4

changes.mady.by.user Scott Fleming

Saved on

compared with

New Version Current

changes.mady.by.user Thomas Dutkiewicz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Thought Is To Do One GUI-Based Tutorial and Include One API/Astroquery Example For The Same Thing.
Search Areas We Want To Touch Upon
  1. Portal cone search
  2. Portal search by target ID (SANTA resolver, either or both a TIC ID itself and/or some other name)
  3. Spatial cross-match in the Portal starting with a user uploaded list and cross-matching with TIC
  4. Spatial cross-match starting with a TIC result table in Portal and then cross-matching with CAOM footprints or some other catalog in Portal
  5. One example of using CasJobs to do a large query on the TIC
  6. TCE- and DV-specific search in Interface X
  7. One example of getting a huge bundle of a certain type of product (e.g., all LC files for some collection of data, does that equal pre-bundled download scripts, does that equal API example, etc...TBD)
  8. FFI cutout tool example(s)
  9. At least one example of searching for a TESS HLSP alongside TESS mission data (e.g., this could be Portal cone search if there's at least one TESS HLSP in CAOM by then)
  10. Bulk downloads using pre-made DOIs by MAST
    1. brainstorm what to bundle (LCs and TPFs per sector, but separately, is an obvious choice)
  11. Exhaustive set of examples showing how to generate a URL for a given TESS data product type to then make a cURL/wget etc. from
Science Areas We Want To Touch Upon

...


Panel
borderColor#00617E
borderWidth2px
borderStylesolid

Tutorials by level of difficulty and topic:



Divbox
stylebackground:white;border:0px;height:30px;background:#0079A0;margin-bottom:10px;margin-top:10px;

Anchor
tic-ctl
tic-ctl

Span
stylefont-size:large;color:white;

Beginner: Ways To Query the TESS Input Catalog (TIC) and Candidate Target List (CTL)




Divbox
stylebackground:white;border:0px;height:275px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Search the TIC centered on HD 209458.

Walkthroughs: Browser-Based | Using API


Divbox
stylebackground:white;border:0px;

Search the TIC centered on HD 209458 to find all dwarfs in the catalogs.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Portal: Catalog Cone Search
  • MAST Name Resolver
  • Portal: Post-search Filtering
  • Portal: Export Search Results Grid



Divbox
stylebackground:white;border:0px;height:250px;


Divbox
styleborder:0px;background:#a1cce0;

Beginner - Find high proper motion M dwarfs in the southern hemisphere from the TIC.

Walkthroughs: Browser-Based


Divbox
stylebackground:white;border:0px;

Search for high proper motion M dwarfs in the southern hemisphere from the TIC.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Portal: Advanced Search




Divbox
stylebackground:white;border:0px;height:250px;


Divbox
styleborder:0px;background:#a1cce0

Beginner - Find southern hemisphere K dwarfs.

Walkthroughs Browser-Based


Divbox
stylebackground:white;border:0px;

Find all southern hemisphere K dwarf stars based on TIC temperature.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • CasJobs SQL Query Interface





Divbox
stylebackground:white;border:0px;height:275px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Search the exoCTL centered on K2 Campaign 2.

Walkthroughs: Browser-Based


Divbox
stylebackground:white;border:0px;

Search the exoCTL centered on the K2 Campaign 2 field.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Portal: Catalog Cone Search
  • Portal: Export Search Results Grid




Divbox
stylebackground:white;border:0px;height:250px;


Divbox
styleborder:0px;background:#a1cce0

Beginner - Export a Portal table in the Goddard Mission Office format.

Walkthroughs: Browser-Based


Divbox
stylebackground:white;border:0px;

Select a subset of output columns to export from a Portal search results table.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Portal: Edit Columns
  • Portal: Export Search Results Grid









Divbox
stylebackground:white;border:0px;height:30px;background:#0079A0;margin-bottom:10px;

Anchor
product-intros
product-intros

Span
stylefont-size:large;color:white;

Beginner: Reading and Using TESS Data Products




Divbox
stylebackground:white;border:0px;height:175px


Divbox
styleborder:0px;background:#a1cce0;

Beginner: Read And Display A Calibrated Full Frame Image (FFI)

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Load and display a TESS full frame image, using the world coordinate system information to convert pixel to celestial coordinates in the plot.



Divbox
stylebackground:white;border:0px;height:150px;


Divbox
styleborder:0px;background:#a1cce0;

Beginner: Read and Plot A Light Curve File

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Load and plot the contents of a TESS light curve file. Plot the flux timeseries contained with the file, and display the pixels used in the photometric aperture.



Divbox
stylebackground:white;border:0px;height:150px;


Divbox
styleborder:0px;background:#a1cce0;

Beginner: Tour Light Curve and Target Pixel File Contents

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Walk through the basic contents of the TESS 2-minute cadence, time-series files (light curve files and target pixel files.)




Divbox
stylebackground:white;border:0px;height:175px;


Divbox
styleborder:0px;background:#a1cce0;

Beginner: Read And Display A Target Pixel (TP) File and Aperture

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Load and plot the contents of a TESS target pixel file. Display the flux values of the collected pixels from a single cadence. Identify the pixels used in the photometric aperture.



Divbox
stylebackground:white;border:0px;height:150px;


Divbox
styleborder:0px;background:#a1cce0

Beginner: Read and Plot A Data Validation Time Series File

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Load and plot the contents of a TESS data validation timeseries file. Plot the detrended flux timeseries contained within the file.



Divbox
stylebackground:white;border:0px;height:30px;background:#0079A0;margin-bottom:10px;

Anchor
interfaces
interfaces

Span
stylefont-size:large;color:white;

Beginner: Using MAST TESS Search Interfaces




Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Searching For And Retrieving TESS Mission Products

Walkthroughs: Browser-Based


Divbox
stylebackground:white;border:0px;

Shows how to use the MAST Portal and/or astroquery.mast to search for TESS mission products, including pre- and post-search filtering, how to use the download basket, and how to specify for certain types of products when requesting a download.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • astroquery
  • Portal: Pre-search Filtering
  • Portal: Post-search Filtering
  • Portal: Download Basket




Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Get Data Products For A Guest Investigator Proposal.

Walkthroughs: Browser-Based | Using API


Divbox
stylebackground:white;border:0px;

Use advanced search in the Portal to find and download all data products for a given Guest Investigator Proposal ID.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Pre-constructed bulk download scripts (browser-based)
  • Portal: Advanced Search (astroquery)




Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - TESSCut (API: with URL Requests).

Walkthroughs: Browser-Based | Using API


Divbox
stylebackground:white;border:0px;

A review of how to use TESSCut through the URL using the requests library in Python.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • TESSCut GUI (browser-based)
  • TESSCut (through URL requests)



Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Introduction To exo.MAST.

Walkthroughs: Browser-Based | Using API


Divbox
stylebackground:white;border:0px;

An introduction to exploring known planets and planet candidates (including TESS Threshold Crossing Events, TCEs) using the exo.MAST portal.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • exo.mast








Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Downloading Data Validation Products Through Astroquery

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

Shows how to download Data Validation (DV) products through astroquery.mast for a given object, and then shows how to display some of the contents.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • astroquery



Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - Download All Full Frame Images By Sector.

Walkthroughs: Browser-Based


Divbox
stylebackground:white;border:0px;

Use the pre-constructed bulk download scritps to retrieve large numbers of full frame images from MAST using cURL commands.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • Pre-constructed bulk download scripts.



Divbox
stylebackground:white;border:0px;height:325px;


Divbox
stylebackground:#a1cce0;border:0px

Beginner - TESSCut (API: with Astroquery).

Walkthroughs: Browser-Based | Using API


Divbox
stylebackground:white;border:0px;

A review of how to use TESSCut in Astroquery to make a cutout of Full Frame Images.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • TESSCut GUI (browser-based)
  • TESSCut (Astroquery version)




Divbox
stylebackground:white;border:0px;height:325px;



Divbox
stylebackground:#a1cce0;border:0px

Beginner - TAP Service.

Walkthroughs: Using API


Divbox
stylebackground:white;border:0px;

How to use TAP services to get a footprint from a specific Sector+camera+chip TESS FFI and then do a search for TESS mission data products that fall within exactly that footprint on the sky.


Divbox
stylebackground:white;height:120px;border:0px;

Tools Used:

  • TAP







Divbox
stylebackground:white;border:0px;height:30px;background:#0079A0;margin-bottom:10px;

Anchor
science-cases
science-cases

Span
stylefont-size:large;color:white;

Intermediate: Science-Case-Driven Searches of TESS Data Products






Divbox
stylebackground:white;border:0px;height:375px;


Divbox
stylebackground:#a1cce0;border:0px

Intermediate - Explore the TESS Pixel Response Function

Walkthroughs:  Using API


Divbox
stylebackground:white;border:0px;

Work with the FITS formatted TESS PRFs to extract an image that represents a single star located at a specified location on the detector. TESS PRF models provide the inter-pixel response and the across-detector shape of a single star as it travels through the optics and falls on the detector.