Skip to content

Commit e3bddff

Browse files
committed
Remove TICA mentions from docs
1 parent b761b0d commit e3bddff

File tree

1 file changed

+6
-89
lines changed

1 file changed

+6
-89
lines changed

docs/mast/mast_cut.rst

Lines changed: 6 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -7,32 +7,23 @@ TESSCut
77
=======
88

99
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
1813
pixel files. This tool can be accessed in Astroquery by using the Tesscut class.
1914

2015
**Note:** TESScut limits each user to no more than 10 simultaneous calls to the service.
2116
After the user has reached this limit TESScut will return a
2217
``503 Service Temporarily Unavailable Error``.
2318

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-
2719
If you use TESSCut for your work, please cite Brasseur et al. 2019
2820
https://ui.adsabs.harvard.edu/abs/2019ascl.soft05007B/abstract
2921

3022

3123
Cutouts
3224
-------
3325

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"),
3627
or moving target (e.g. "Eleonora") and cutout size (in pixels or an angular quantity, default is 5 pixels)
3728
and returns the cutout target pixel file(s) as a list of `~astropy.io.fits.HDUList` objects.
3829

@@ -44,8 +35,6 @@ Requesting a cutout by coordinate or objectname accesses the
4435
`MAST TESScut API <https://mast.stsci.edu/tesscut/docs/getting_started.html#requesting-a-cutout>`__
4536
and returns a target pixel file, with format described
4637
`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.
4938

5039
.. doctest-remote-data::
5140

@@ -62,22 +51,6 @@ not explicitly called for TICA.
6251
2 APERTURE 1 ImageHDU 82 (5, 5) int32
6352

6453

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-
8154
The following example will request SPOC cutouts using the objectname argument, rather
8255
than a set of coordinates.
8356

@@ -118,23 +91,9 @@ simply with either the objectname or coordinates.
11891
1 PIXELS 1 BinTableHDU 150 355R x 16C [D, E, J, 25J, 25E, 25E, 25E, 25E, J, E, E, 38A, D, D, D, D]
11992
2 APERTURE 1 ImageHDU 97 (2136, 2078) int32
12093

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::
12594

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
13897
(True or False). It uses these parameters to download the cutout target pixel file(s).
13998

14099
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.
157116
----------------------------------------------------------
158117
./tess-s0009-4-1_107.186960_-70.509190_15x15_astrocut.fits
159118

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&sector=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
180119

181120
Sector information
182121
------------------
@@ -197,25 +136,6 @@ To access sector information for a particular coordinate, object, or moving targ
197136
tess-s0008-1-1 8 1 1
198137
tess-s0034-1-2 34 1 2
199138

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-
219139
The following example will request SPOC cutouts using the objectname argument, rather
220140
than a set of coordinates.
221141

@@ -243,9 +163,6 @@ The following example requests SPOC cutouts for a moving target.
243163
tess-s0043-3-3 43 3 3
244164
tess-s0044-2-4 44 2 4
245165

246-
Note that the moving targets functionality is not currently available for TICA,
247-
so the query will always default to SPOC.
248-
249166

250167
Zcut
251168
====

0 commit comments

Comments
 (0)