{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# An introduction into the tools and tutorials available for the analysis of TESS data\n", "\n", "Welcome everyone to our *TESS* Lightkurve splinter session!" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Authors\n", "\n", "[Rebekah Hounsell](https://heasarc.gsfc.nasa.gov/docs/tess/helpdesk.html) - Support scientist for *TESS* in the NASA GSFC GI Office. \n", "\n", "" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Learning Goals\n", "\n", "In this tutorial, we will teach the user how to access, analyze, and manipulate data from the NASA Exoplanet mission *TESS* (this can also be applied to *Kepler* & *K2*). All tools presented will teach the user how to work with time series data for the purpose of scientific research. \n", "\n", "The workshop assumes a basic knowledge of python and astronomy, and will walk the user through several of the concepts outlined below:\n", "\n", "1. How to obtain *TESS* data products from the MAST archive\n", "2. How to use *Lightkurve* to access the various data products and create time series\n", "3. How to analyze and assess various data anomalies and how you might visualize them" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Imports\n", "\n", "This tutorial requires the use of specific packages:\n", "- [**Lightkurve**](https://docs.lightkurve.org/index.html) to work with *TESS* data (v2.0.1)\n", "- [**Matplotlib**](https://matplotlib.org/) for plotting.\n", "- [**Numpy**](https://numpy.org) for manipulating the data." ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "import lightkurve as lk\n", "import numpy as np\n", "import matplotlib.pyplot as plt\n", "%matplotlib inline" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### First time users\n", "\n", "If you are not that experienced with *Python*, or cannot download *Lightkurve*, you can run this notebook as a [Colab notebook](https://colab.research.google.com/notebooks/intro.ipynb?utm_source=scs-index). Colaboratory allows users to write and execute *Python* in your browser with zero configuration required. \n", "\n", "All you need is a Google account and to copy and paste in the following command at the top of your colab notebook:\n", "\n", "`!pip install lightkurve`\n", "\n", "This downloads the *Lightkurve* package." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Introduction to *TESS*: \n", "\n", "The *Transiting Exoplanet Survey Satellite (TESS)* is a NASA-sponsored Astrophysics Explorer-class mission that is performing a near all-sky survey to search for planets transiting nearby stars. *TESS* completed its primary mission in July of 2020, and has now entered its extended mission. The current extended mission will last until September 2022, and will continue to scan the sky for exoplanets and transient events. The *TESS* mission is now more community focused with a larger guest investigator (GI) program.\n", "\n", "Over the last three years *TESS* has observed both the northern and southern hemispheres, with each hemisphere being split into ~13 sectors. Each sector is observed for ~27 days by *TESS's* four cameras.\n", "\n", "\n", "\n", "\n", "The main data products collected by the *TESS* mission are described below. \n", "\n", "- [Full Frame Images (FFIs)](https://heasarc.gsfc.nasa.gov/docs/tess/data-products.html#full-frame-images): The full sector images, with a cadence of 30-min (years 1 & 2) or 10-min (years 3 & 4).\n", "- [Target Pixel Files (TPFs)](https://heasarc.gsfc.nasa.gov/docs/tess/data-products.html#target-pixel-files-tpfs): Postage stamp cut outs from the FFIs, focused on a selected target of interest. Each stamp has a cadence of 2-min or 20-sec. \n", "- [Light Curve Files (LCFs)](https://heasarc.gsfc.nasa.gov/docs/tess/data-products.html#light-curve-files): The time series data produced for each 2-min or 20-sec TPF object. \n", "\n", "To learn more about the *TESS* mission and its data products, please visit the [*TESS* GI pages](https://heasarc.gsfc.nasa.gov/docs/tess/data-products.html)." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## 1. How to obtain *TESS* data products from the MAST archive\n", "\n", "You can access *TESS*, *Kepler*, and *K2* data via the [ Mikulksi Archive for Space Telescopes (MAST)](https://mast.stsci.edu/portal/Mashup/Clients/Mast/Portal.html) archive or via the *Lightkurve* package (see Section 2).\n", "\n", "Here, we are focusing on obtaining your data via the MAST portal. Using the portal, you can enter the name of your object, its TIC number, or position (i.e., R.A and Dec). If listed in the archive, the table containing each observation will be returned.\n", "\n", "