@@ -7,32 +7,23 @@ TESSCut
7
7
=======
8
8
9
9
TESSCut is MAST's tool to provide full-frame image (FFI) cutouts from the Transiting
10
- Exoplanet Survey Satellite (TESS). The cutouts can be made from either the Science
11
- Processing Operation's Center (`SPOC <https://archive.stsci.edu/missions-and-data/tess >`__) FFI products,
12
- or the TESS Image CAlibrator (`TICA <https://archive.stsci.edu/hlsp/tica >`__) high-level science products.
13
- Cutouts from the TICA products are not available for sectors 1-26,
14
- but are available for sector 27 onwards. These products are available up to 3 weeks sooner than
15
- their SPOC counterparts for the latest sector, so it is recommended to request TICA cutouts
16
- for users working with time-sensitive observations. The cutouts from either SPOC or TICA products
17
- are returned in the form of target pixel files that follow the same format as TESS pipeline target
10
+ Exoplanet Survey Satellite (TESS). Cutouts can be made from the Science
11
+ Processing Operation's Center (`SPOC <https://archive.stsci.edu/missions-and-data/tess >`__) FFI products.
12
+ The cutouts are returned in the form of target pixel files that follow the same format as TESS pipeline target
18
13
pixel files. This tool can be accessed in Astroquery by using the Tesscut class.
19
14
20
15
**Note: ** TESScut limits each user to no more than 10 simultaneous calls to the service.
21
16
After the user has reached this limit TESScut will return a
22
17
``503 Service Temporarily Unavailable Error ``.
23
18
24
- **Note: ** The moving targets functionality does not currently support making cutouts from
25
- TICA products, so the product argument will always default to SPOC.
26
-
27
19
If you use TESSCut for your work, please cite Brasseur et al. 2019
28
20
https://ui.adsabs.harvard.edu/abs/2019ascl.soft05007B/abstract
29
21
30
22
31
23
Cutouts
32
24
-------
33
25
34
- The `~astroquery.mast.TesscutClass.get_cutouts ` function takes a product type
35
- ("TICA" or "SPOC", but defaults to "SPOC"), coordinate, object name (e.g. "M104" or "TIC 32449963"),
26
+ The `~astroquery.mast.TesscutClass.get_cutouts ` function takes a coordinate, object name (e.g. "M104" or "TIC 32449963"),
36
27
or moving target (e.g. "Eleonora") and cutout size (in pixels or an angular quantity, default is 5 pixels)
37
28
and returns the cutout target pixel file(s) as a list of `~astropy.io.fits.HDUList ` objects.
38
29
@@ -44,8 +35,6 @@ Requesting a cutout by coordinate or objectname accesses the
44
35
`MAST TESScut API <https://mast.stsci.edu/tesscut/docs/getting_started.html#requesting-a-cutout >`__
45
36
and returns a target pixel file, with format described
46
37
`here <https://astrocut.readthedocs.io/en/latest/astrocut/file_formats.html#target-pixel-files >`__.
47
- Note that the product argument will default to request for SPOC cutouts when
48
- not explicitly called for TICA.
49
38
50
39
.. doctest-remote-data ::
51
40
@@ -62,22 +51,6 @@ not explicitly called for TICA.
62
51
2 APERTURE 1 ImageHDU 82 (5, 5) int32
63
52
64
53
65
- For users with time-sensitive targets who would like cutouts from the latest observations,
66
- we recommend requesting for the TICA product. Using the same target from the example above,
67
- this example shows a request for TICA cutouts:
68
-
69
- .. doctest-remote-data ::
70
-
71
- >>> from astroquery.mast import Tesscut
72
- >>> from astropy.coordinates import SkyCoord
73
- ...
74
- >>> cutout_coord = SkyCoord(107.18696 , - 70.50919 , unit = " deg" )
75
- >>> hdulist = Tesscut.get_cutouts(coordinates = cutout_coord,
76
- ... product= ' tica' ,
77
- ... sector= 28 )
78
- >>> hdulist[0 ][0 ].header[' FFI_TYPE' ] # doctest: +IGNORE_OUTPUT
79
- 'TICA'
80
-
81
54
The following example will request SPOC cutouts using the objectname argument, rather
82
55
than a set of coordinates.
83
56
@@ -118,23 +91,9 @@ simply with either the objectname or coordinates.
118
91
1 PIXELS 1 BinTableHDU 150 355R x 16C [D, E, J, 25J, 25E, 25E, 25E, 25E, J, E, E, 38A, D, D, D, D]
119
92
2 APERTURE 1 ImageHDU 97 (2136, 2078) int32
120
93
121
- Note that the moving targets functionality does not currently support TICA, so the product
122
- parameter will result in an error when set to 'TICA'.
123
-
124
- .. doctest-remote-data ::
125
94
126
- >>> from astroquery.mast import Tesscut
127
- ...
128
- >>> hdulist = Tesscut.get_cutouts(objectname = " Eleonora" ,
129
- ... product= ' tica' ,
130
- ... moving_target= True ,
131
- ... sector= 6 )
132
- Traceback (most recent call last):
133
- ...
134
- astroquery.exceptions.InvalidQueryError: Only SPOC is available for moving targets queries.
135
-
136
- The `~astroquery.mast.TesscutClass.download_cutouts ` function takes a product type ("TICA" or "SPOC", but defaults to "SPOC"),
137
- coordinate, cutout size (in pixels or an angular quantity), or object name (e.g. "M104" or "TIC 32449963") and moving target
95
+ The `~astroquery.mast.TesscutClass.download_cutouts ` function takes a coordinate, cutout size
96
+ (in pixels or an angular quantity), or object name (e.g. "M104" or "TIC 32449963") and moving target
138
97
(True or False). It uses these parameters to download the cutout target pixel file(s).
139
98
140
99
If a given coordinate/object/moving target appears in more than one TESS sector, a target pixel file
@@ -157,26 +116,6 @@ pixel file will be produced for each one.
157
116
----------------------------------------------------------
158
117
./tess-s0009-4-1_107.186960_-70.509190_15x15_astrocut.fits
159
118
160
- The query from the example above defaults to downloading cutouts from SPOC. The following example is a query for
161
- the same target from above, but with the product argument passed as TICA to explicitly request for TICA cutouts,
162
- and because the TICA products are not available for sectors 1-26, we request cutouts from sector 27 rather than sector 9.
163
-
164
- .. doctest-remote-data ::
165
-
166
- >>> from astroquery.mast import Tesscut
167
- >>> from astropy.coordinates import SkyCoord
168
- >>> import astropy.units as u
169
- ...
170
- >>> cutout_coord = SkyCoord(107.18696 , - 70.50919 , unit = " deg" )
171
- >>> manifest = Tesscut.download_cutouts(coordinates = cutout_coord,
172
- ... product= ' tica' ,
173
- ... size= [5 , 7 ]* u.arcmin,
174
- ... sector= 27 ) # doctest: +IGNORE_OUTPUT
175
- Downloading URL https://mast.stsci.edu/tesscut/api/v0.1/astrocut?ra=107.18696&dec=-70.50919&y=0.08333333333333333&x=0.11666666666666667&units=d&product=TICA§or=27 to ./tesscut_20230214150644.zip ... [Done]
176
- >>> print (manifest) # doctest: +IGNORE_OUTPUT
177
- Local Path
178
- ----------------------------------------------------------
179
- ./tica-s0027-4-2_107.186960_-70.509190_21x14_astrocut.fits
180
119
181
120
Sector information
182
121
------------------
@@ -197,25 +136,6 @@ To access sector information for a particular coordinate, object, or moving targ
197
136
tess-s0008-1-1 8 1 1
198
137
tess-s0034-1-2 34 1 2
199
138
200
- Note that because of the delivery cadence of the
201
- TICA high level science products, later sectors will be available sooner with TICA than with
202
- SPOC. Also note that TICA is not available for sectors 1-26. The following example is the same
203
- query as above, but for TICA. Notice that products for sector 8 are no longer available,
204
- but are now available for sector 61.
205
-
206
- .. doctest-remote-data ::
207
-
208
- >>> from astroquery.mast import Tesscut
209
- >>> from astropy.coordinates import SkyCoord
210
- ...
211
- >>> coord = SkyCoord(135.1408 , - 5.1915 , unit = " deg" )
212
- >>> sector_table = Tesscut.get_sectors(coordinates = coord, product = ' tica' )
213
- >>> print (sector_table) # doctest: +IGNORE_OUTPUT
214
- sectorName sector camera ccd
215
- -------------- ------ ------ ---
216
- tica-s0034-1-2 34 1 2
217
- tica-s0061-1-2 61 1 2
218
-
219
139
The following example will request SPOC cutouts using the objectname argument, rather
220
140
than a set of coordinates.
221
141
@@ -243,9 +163,6 @@ The following example requests SPOC cutouts for a moving target.
243
163
tess-s0043-3-3 43 3 3
244
164
tess-s0044-2-4 44 2 4
245
165
246
- Note that the moving targets functionality is not currently available for TICA,
247
- so the query will always default to SPOC.
248
-
249
166
250
167
Zcut
251
168
====
0 commit comments