Wildcard Handling with Astroquery.mast

Wildcard Handling with Astroquery.mast#

Learning Goals#

By the end of this tutorial, you will:

Use the wildcards available for astroquery.mast.Observations criteria queries
Broaden and refine astroquery.mast.Observations criteria queries
Fully utilize the instrument_name criteria, especially for JWST queries
Query for moving targets using target ephemeris and time criteria such as t_min and t_max

Introduction#

This Notebook demonstrates the use of wildcards in astroquery.mast.Observations criteria queries. The use of wildcards is encouraged for certain criteria types (namely, string object types) to ensure your query returns all results.

We will demonstrate 3 use-cases for wildcards when doing criteria queries and emphasize certain criteria where wildcard usage is highly encouraged, particularly for JWST queries. We will also use the last example to demonstrate the use of value ranges when working with float object criteria types.

The workflow for this notebook consists of:

Wildcard overview with astroquery.mast.Observations
1. Wildcard Search with instrument_name
2. Wildcard Search with instrument_name and proposal_id
3. Wildcard Search a Time-sensitive Object with target_name and t_min
Resources

Imports#

import astropy.units as u
import matplotlib.pyplot as plt

from astropy.coordinates import SkyCoord
from astropy.table import Table, unique, vstack
from astropy.time import Time
from astroquery.mast import Observations

Wildcards with `astroquery.mast.Observations`#

The use of wildcards when making astroquery.mast.Observations queries can help ensure you retrieve all observations without leaving anything out. The available wildcards are % and *: % replaces a single character, while * replaces more than one character preceding, following, or in between the existing characters, depending on its placement. See the Observation Criteria Queries section in the astroquery.mast documentation for more information on the wildcards.

Wildcards are only available for certain criteria. string type objects accept wildcards, but float, integer, or any other objects do not accept wildcards.

Users may call the get_metadata method to see the list of query criteria and their data types. The criteria listed as string objects under the Data Type column are criteria that can be called with wildcards:

Observations.get_metadata("observations")

Table length=34

Column Name	Column Label	Data Type	Units	Description	Examples/Valid Values
str21	str25	str7	str10	str72	str116
intentType	Observation Type	string		Whether observation is for science or calibration.	Valid values: science, calibration
obs_collection	Mission	string		Collection	E.g. SWIFT, PS1, HST, IUE
provenance_name	Provenance Name	string		Provenance name, or source of data	E.g. TASOC, CALSTIS, PS1
instrument_name	Instrument	string		Instrument Name	E.g. WFPC2/WFC, UVOT, STIS/CCD
project	Project	string		Processing project	E.g. HST, HLA, EUVE, hlsp_legus
filters	Filters	string		Instrument filters	F469N, NUV, FUV, LOW DISP, MIRROR
wavelength_region	Waveband	string		Energy Band	EUV, XRAY, OPTICAL
target_name	Target Name	string		Target Name	Ex. COMET-67P-CHURYUMOV-GER-UPDATE
target_classification	Target Classification	string		Type of target	Ex. COMET;COMET BEING ORBITED BY THE ROSETTA SPACECRAFT;SOLAR SYSTEM
...	...	...	...	...	...
s_region	s_region	string	ICRS Shape	STC/S Footprint	Will be ICRS circle or polygon. E.g. CIRCLE ICRS 17.71740689 -58.40043015 0.625
jpegURL	jpegURL	string		Preview Image URL	https://archive.stsci.edu/hst/previews/N4QF/N4QF18090.jpg
distance	Distance (")	float	arcsec	Angular separation between searched coordinates and center of obsevation
obsid	Product Group ID	integer		Database identifier for obs_id	Long integer, e.g. 2007590987
dataRights	Data Rights	string		Data Rights	valid values: public,exclusive_access,restricted
mtFlag	Moving Target	boolean		Moving Target Flag	If True, observation contains a moving target, if False or absent observation may or may not contain a moving target
srcDen	Number of Catalog Objects	float		Number of cataloged objects found in observation
dataURL	Data URL	string		Data URL
proposal_type	Proposal Type	string		Type of telescope proposal	Eg. 3PI, GO, GO/DD, HLA, GII, AIS
sequence_number	Sequence Number	integer		Sequence number, e.g. Kepler quarter or TESS sector

Case 1: Wildcard Search with `instrument_name`#

For our first example we will search for all NIRISS observations taken by a certain proposal/program PI. Our two query criteria are proposal_pi and instrument_name, which are both string object criteria. As such, both can be wildcarded for ease of use.

In fact, it is sometimes necessary to use wildcards when searching on instrument_name. Both HST and JWST use instrument configurations in this field to allow for more precise advanced searches (e.g. NIRISS/IMAGE and STIS/FUV-MAMA). When performing a “generic” search, you must include a wildcard or these more detailed results will be excluded.

We will demonstrate this by looking at the results for the query below:

observations = Observations.query_criteria(proposal_pi="Espinoza, Nestor",
                                           instrument_name="NIRISS*")
observations

Table masked=True length=139

intentType	obs_collection	provenance_name	instrument_name	project	filters	wavelength_region	target_name	target_classification	obs_id	s_ra	s_dec	dataproduct_type	proposal_pi	calib_level	t_min	t_max	t_exptime	em_min	em_max	obs_title	t_obs_release	proposal_id	proposal_type	sequence_number	s_region	jpegURL	dataURL	dataRights	mtFlag	srcDen	obsid	objID
str7	str4	str7	str12	str4	str13	str8	str13	str54	str50	float64	float64	str8	str16	int64	float64	float64	float64	float64	float64	str70	float64	str4	str3	int64	str132	str63	str81	str16	bool	float64	str9	str9
science	JWST	APT	NIRISS/IMAGE	JWST	F480M	Infrared	ECLIPTIC-RA00	--	jw06658002001_xx101_00001_niriss	9.344387500000002	1.4307027777777779	image	Espinoza, Nestor	-1	nan	nan	42.947	4600.0	5000.0	SOSS background measurements	nan	6658	CAL	1	POLYGON 9.3627908779 1.41191833158 9.32563140264 1.41212306828 9.32600203261 1.44950520465 9.36315303494 1.44932680218	--	--	PUBLIC	False	nan	213026785	403862655
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA00	Calibration; External flat field	jw04479001002_03101_00001_nis	9.344387500000002	1.4307027777777779	image	Espinoza, Nestor	2	60265.59292714896	60265.596530925926	300.63	600.0	2800.0	SOSS background measurements	60265.66682863	4479	CAL	--	POLYGON 9.341983254 1.414141714 9.32592057 1.447640405 9.359713446 1.463651021 9.37579551 1.430171697	mast:JWST/product/jw04479001002_03101_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479001002_03101_00001_nis_rateints.fits	PUBLIC	False	nan	191961742	408856181
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA00	Calibration; External flat field	jw04479002009_03101_00001_nis	9.344387500000002	1.4307027777777779	image	Espinoza, Nestor	2	60265.743599591086	60265.74720336805	300.63	600.0	2800.0	SOSS background measurements	60265.78643517	4479	CAL	--	POLYGON 9.316621316 1.402125579 9.300558415 1.435624126 9.334350968 1.451635046 9.350433251 1.418155869	mast:JWST/product/jw04479002009_03101_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479002009_03101_00001_nis_rateints.fits	PUBLIC	False	nan	192102528	408856581
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA00	Calibration; External flat field	jw04479002002_03101_00001_nis	9.344387500000002	1.4307027777777779	image	Espinoza, Nestor	2	60265.68767150081	60265.69127527778	300.63	600.0	2800.0	SOSS background measurements	60265.73001146	4479	CAL	--	POLYGON 9.341983221 1.414141681 9.325920514 1.44764036 9.359713379 1.463650999 9.375795466 1.430171686	mast:JWST/product/jw04479002002_03101_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479002002_03101_00001_nis_rateints.fits	PUBLIC	False	nan	192013607	408935017
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA00	Calibration; External flat field	jw04479002008_03101_00001_nis	9.344387500000002	1.4307027777777779	image	Espinoza, Nestor	2	60265.73434404711	60265.73794782408	300.63	600.0	2800.0	SOSS background measurements	60265.78704855	4479	CAL	--	POLYGON 9.325075322 1.40613114 9.309012591 1.439629781 9.342805298 1.455640502 9.358887411 1.422161228	mast:JWST/product/jw04479002008_03101_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479002008_03101_00001_nis_rateints.fits	PUBLIC	False	nan	192102532	408935023
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA20	Calibration; External flat field	jw04479005004_02103_00001_nis	27.652133333333335	11.538361111111112	image	Espinoza, Nestor	2	60302.72402377928	60302.72539072917	107.368	600.0	2800.0	SOSS background measurements	60302.96983791	4479	CAL	--	POLYGON 27.630184308 11.515689331 27.617041473 11.550534444 27.652891551 11.563337498 27.666052471 11.528508455	mast:JWST/product/jw04479005004_02103_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479005004_02103_00001_nis_rateints.fits	PUBLIC	False	nan	199450721	408935037
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA20	Calibration; External flat field	jw04479003004_02101_00001_nis	27.652133333333335	11.538361111111112	image	Espinoza, Nestor	2	60302.642411267705	60302.64377821759	107.368	600.0	2800.0	SOSS background measurements	60302.96876147	4479	CAL	--	POLYGON 27.633429998 11.50696385 27.620287937 11.541809095 27.656137033 11.554611789 27.669297182 11.519782615	mast:JWST/product/jw04479003004_02101_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479003004_02101_00001_nis_rateints.fits	PUBLIC	False	nan	199450463	408935038
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA20	Calibration; External flat field	jw04479005001_02103_00001_nis	27.652133333333335	11.538361111111112	image	Espinoza, Nestor	2	60302.687733443636	60302.689100393516	107.368	600.0	2800.0	SOSS background measurements	60302.96982634	4479	CAL	--	POLYGON 27.660372577 11.516577392 27.647233355 11.551423829 27.68308489 11.564223272 27.696242197 11.529392904	mast:JWST/product/jw04479005001_02103_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479005001_02103_00001_nis_rateints.fits	PUBLIC	False	nan	199450725	408935044
science	JWST	CALJWST	NIRISS/IMAGE	JWST	CLEAR;GR700XD	Infrared	ECLIPTIC-RA20	Calibration; External flat field	jw04479003004_02103_00001_nis	27.652133333333335	11.538361111111112	image	Espinoza, Nestor	2	60302.647649786224	60302.64901673611	107.368	600.0	2800.0	SOSS background measurements	60302.96946754	4479	CAL	--	POLYGON 27.630184272 11.515689331 27.617041424 11.55053444 27.652891497 11.563337507 27.66605243 11.528508469	mast:JWST/product/jw04479003004_02103_00001_nis_trapsfilled.jpg	mast:JWST/product/jw04479003004_02103_00001_nis_rateints.fits	PUBLIC	False	nan	199450729	408935047
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
science	JWST	CALJWST	NIRISS/SOSS	JWST	F480M	Infrared	BD+60-1753	Star; A dwarfs	jw01512002001_02101_00002_nis	261.2178777048407	60.430788532908466	image	Espinoza, Nestor	2	59995.98186616898	59995.98187459491	0.683	4600.0	5000.0	SOSS Wavelength and Trace	59996.18305556	1512	CAL	--	POLYGON 261.21846424 60.429977233 261.216255709 60.430400627 261.21709951 60.431483308 261.219308303 60.431059879	mast:JWST/product/jw01512002001_02101_00002_nis_cal.jpg	mast:JWST/product/jw01512002001_02101_00002_nis_cal.fits	PUBLIC	False	nan	117933634	408972026
science	JWST	CALJWST	NIRISS/SOSS	JWST	F480M	Infrared	BD+60-1753	Star; A dwarfs	jw01512007001_02101_00002_nis	261.2178777045693	60.430788532805536	image	Espinoza, Nestor	2	59995.94586027778	59995.945868703704	0.683	4600.0	5000.0	SOSS Wavelength and Trace	59996.1583333	1512	CAL	--	POLYGON 261.218461801 60.429976691 261.216254156 60.430401208 261.217100217 60.43148346 261.219308125 60.431058908	mast:JWST/product/jw01512007001_02101_00002_nis_cal.jpg	mast:JWST/product/jw01512007001_02101_00002_nis_cal.fits	PUBLIC	False	nan	117933630	408972157
science	JWST	CALJWST	NIRISS/SOSS	JWST	F480M	Infrared	BD+60-1753	Star; A dwarfs	jw01512007001_02101_00001_nis	261.21787770456285	60.43078853280309	image	Espinoza, Nestor	2	59995.94500694444	59995.94501537037	0.683	4600.0	5000.0	SOSS Wavelength and Trace	59996.15900459	1512	CAL	--	POLYGON 261.218582929 60.430031016 261.216375283 60.430455538 261.217221354 60.431537787 261.219429263 60.431113231	mast:JWST/product/jw01512007001_02101_00001_nis_cal.jpg	mast:JWST/product/jw01512007001_02101_00001_nis_cal.fits	PUBLIC	False	nan	117933624	408972173
science	JWST	CALJWST	NIRISS/SOSS	JWST	F480M	Infrared	BD+60-1753	Star; A dwarfs	jw01512007001_02101_00004_nis	261.2178777046092	60.43078853282068	image	Espinoza, Nestor	2	59995.95115804398	59995.95116646991	0.683	4600.0	5000.0	SOSS Wavelength and Trace	59996.158912	1512	CAL	--	POLYGON 261.218558602 60.430041782 261.216350954 60.430466301 261.21719702 60.431548551 261.219404932 60.431123997	mast:JWST/product/jw01512007001_02101_00004_nis_cal.jpg	mast:JWST/product/jw01512007001_02101_00004_nis_cal.fits	PUBLIC	False	nan	117933620	408972189
science	JWST	CALJWST	NIRISS/SOSS	JWST	F480M	Infrared	BD+60-1753	Star; A dwarfs	jw01512007001_02101_00003_nis	261.2178777045758	60.43078853280801	image	Espinoza, Nestor	2	59995.94672620371	59995.94673462963	0.683	4600.0	5000.0	SOSS Wavelength and Trace	59996.1583333	1512	CAL	--	POLYGON 261.218423855 60.430081248 261.216216202 60.430505765 261.217062266 60.431588016 261.219270181 60.431163464	mast:JWST/product/jw01512007001_02101_00003_nis_cal.jpg	mast:JWST/product/jw01512007001_02101_00003_nis_cal.fits	PUBLIC	False	nan	117933626	408972208
science	JWST	CALJWST	NIRISS/SOSS	JWST	CLEAR;GR700XD	Infrared	HAT-P-14	Star; Exoplanet Systems; Exoplanets; F dwarfs; F stars	jw01541-o001_t002_niriss_clear-gr700xd-substrip256	260.11617716308444	38.242156511096134	spectrum	Espinoza, Nestor	3	59738.26121625	59738.552486493056	18855.408	600.0	2800.0	NIRISS Sensitivity and Stability for Transiting Exoplanet Observations	59774.8541666	1541	COM	--	POLYGON 260.16190084 38.23723653 260.11337623 38.23744814 260.11348554 38.24618148 260.16201952 38.24596704 260.16190084 38.23723653	--	mast:JWST/product/jw01541-o001_t002_niriss_clear-gr700xd-substrip256_x1dints.fits	PUBLIC	False	nan	213209384	410291660
science	JWST	CALJWST	NIRISS/SOSS	JWST	CLEAR;GR700XD	Infrared	HAT-P-14	Star; Exoplanet Systems; Exoplanets; F dwarfs; F stars	jw01541001001_04102_00001-seg001_nis	260.1161771633686	38.242156510427485	image	Espinoza, Nestor	2	59738.55390866898	59738.55835982639	329.64	600.0	2800.0	NIRISS Sensitivity and Stability for Transiting Exoplanet Observations	59774.8541666	1541	COM	--	POLYGON 260.071030426 38.2494554 260.119367245 38.246686364 260.11850644 38.23799955 260.070173177 38.240758867	mast:JWST/product/jw01541001001_04102_00001-seg001_nis_ramp.jpg	mast:JWST/product/jw01541001001_04102_00001-seg001_nis_rateints.fits	PUBLIC	False	nan	85700205	410291724
science	JWST	CALJWST	NIRISS/SOSS	JWST	CLEAR;GR700XD	Infrared	CD-38-2551	Star; G stars	jw02113-o005_t001_niriss_clear-gr700xd-substrip256	94.33630544540856	-38.32344481007381	spectrum	Espinoza, Nestor	3	60215.75685262732	60216.25049009259	32810.168	600.0	2800.0	Exploring the morning and evening limbs of a transiting exoplanet	60582.96342588	2113	GO	--	POLYGON 94.38208655 -38.32834702 94.33350101 -38.32815311 94.3336111 -38.31941978 94.38219433 -38.31961643 94.38208655 -38.32834702	--	mast:JWST/product/jw02113-o005_t001_niriss_clear-gr700xd-substrip256_x1dints.fits	EXCLUSIVE_ACCESS	False	nan	188165781	419720818
science	JWST	CALJWST	NIRISS/SOSS	JWST	CLEAR;GR700XD	Infrared	CD-38-2551	Star; G stars	jw02113005001_04103_00001-seg001_nis	94.33630544130956	-38.32344481509817	image	Espinoza, Nestor	2	60216.2528283912	60216.257597488424	329.64	600.0	2800.0	Exploring the morning and evening limbs of a transiting exoplanet	60582.57626142	2113	GO	--	POLYGON 94.343932683 -38.287734535 94.342195697 -38.325771711 94.331098247 -38.325419041 94.332829036 -38.287380655	mast:JWST/product/jw02113005001_04103_00001-seg001_nis_ramp.jpg	mast:JWST/product/jw02113005001_04103_00001-seg001_nis_rateints.fits	EXCLUSIVE_ACCESS	False	nan	178895888	419793917
science	JWST	CALJWST	NIRISS/SOSS	JWST	CLEAR;GR700XD	Infrared	CD-38-2551	Star; G stars	jw02113005001_04101_00001-seg001_nis	94.33630544945105	-38.3234448051187	spectrum	Espinoza, Nestor	2	60215.77435597222	60215.77448314815	5.494	600.0	2800.0	Exploring the morning and evening limbs of a transiting exoplanet	60582.58410871	2113	GO	--	POLYGON 94.38208655 -38.32834702 94.33350101 -38.32815311 94.33361111 -38.31941977 94.38219434 -38.31961642 94.38208655 -38.32834702	mast:JWST/product/jw02113005001_04101_00001-seg001_nis_ramp.jpg	mast:JWST/product/jw02113005001_04101_00001-seg001_nis_x1dints.fits	EXCLUSIVE_ACCESS	False	nan	178895938	419794011

Our query returned many NIRISS observations led by the PI Dr. Espinoza. Let’s get all the unique values under the instrument_name column to see what our * wildcard picked up.

set(observations['instrument_name'])

{'NIRISS/IMAGE', 'NIRISS/SOSS'}

Our observations have the advanced labeling; had we simply set instrument_name = "NIRISS", we would have missed several observations. For more details on this advanced labeling, see the JWST Instrument Names page.

A note of caution: There is such a thing as too many wildcards#

You can be too generous with the wildcards, so be sure to exercise caution in their use. Too much ambiguity can lead to unintended results. Let’s take a look at our example below.

observations = Observations.query_criteria(proposal_pi='Espinoza, Nestor',
                                           instrument_name='NIR*') # Surely only one instrument begins with 'NIR'
set(observations['instrument_name'])

{'NIRISS/IMAGE', 'NIRISS/SOSS', 'NIRSPEC/SLIT'}

This query returns NIRSPEC/SLIT observations in addition to the NIRISS ones, which is not what we intended.

Case 2: Wildcard Search with `instrument_name` and `proposal_id`#

Let’s add an additional string criterion and wildcard into the mix. We’ll do this with the proposal_id field which, despite its numeric content, is encoded as a string.

Let’s query for a four digit proposal/program IDs that begin with 15.

observations = Observations.query_criteria(proposal_pi='Espinoza, Nestor',
                                           instrument_name='NIRISS*',
                                           proposal_id=['15%%']) # Only a four digit result will match this

set(observations['proposal_id']), set(observations['instrument_name'])

({'1512', '1541'}, {'NIRISS/IMAGE', 'NIRISS/SOSS'})

Case 3: Create a Moving Target Ephemeris using MAST Observations with Wildcard Search#

We will be querying for image observations of Comet 67P Churyumov-Gerasimenko observed through the Hubble Space Telescope’s Advanced Camera for Surveys (ACS) Wide Field Camera (WFC). This comet’s name can be listed in different ways, so we will use * wildcards in our criteria query.

observations = Observations.query_criteria(target_name="*67P*",
                                           instrument_name="ACS/WFC")

print(f"{len(observations)} total observations" + "\n")
print("Listed target names:")
print(set(observations['target_name']))

140 total observations

Listed target names:
{'COMET-67P-CHURYUMOV-GERASIMENK', 'COMET-67P-CHURYUMOV-GER-UPDATE'}

Above there are two names we get for Comet-67P. You should exercise caution when searching on the target_name criteria, since this is often entered by the PI who proposed the observation and can vary from person to person.

In the remainder of this notebook, we will construct a bare-bones ephemeris using the filtered MAST observations of this object and their metadata. We will then do some reverse engineering to query for the target based on coordinates using the ephemeris table, and hope that we get the same results back! Let’s begin:

For simplicity, let’s work only with the 'COMET-67P-CHURYUMOV-GERASIMENK' observations to create our ephemeris.

mask = observations["target_name"] == "COMET-67P-CHURYUMOV-GERASIMENK"
filtered_observations = observations[mask]
filtered_observations

Table masked=True length=70

intentType	obs_collection	provenance_name	instrument_name	project	filters	wavelength_region	target_name	target_classification	obs_id	s_ra	s_dec	dataproduct_type	proposal_pi	calib_level	t_min	t_max	t_exptime	em_min	em_max	obs_title	t_obs_release	proposal_id	proposal_type	sequence_number	s_region	jpegURL	dataURL	dataRights	mtFlag	srcDen	obsid	objID
str7	str3	str6	str7	str3	str12	str7	str30	str89	str36	float64	float64	str5	str14	int64	float64	float64	float64	float64	float64	str119	float64	str5	str3	int64	str2243	str86	str35	str6	bool	float64	str8	str9
science	HST	CALACS	ACS/WFC	HST	F775W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis04010	290.2735685756	-28.02183037337	image	Hines, Dean C.	3	56977.44858376157	56977.454660219904	300.0	690.0	860.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57342.8724883	13863	GO	--	POLYGON -69.710339019999992 -28.03460849 -69.710342387468657 -28.034498772208945 -69.708739630000025 -28.03435188 -69.70961256999999 -28.00591362 -69.740906 -28.00877878 -69.740902662524562 -28.008888572547743 -69.742505129999984 -28.0090351 -69.74164077 -28.03747355 -69.710339019999992 -28.03460849 -69.710339019999992 -28.03460849	mast:HST/product/jcis04010_drz.jpg	mast:HST/product/jcis04010_drz.fits	PUBLIC	True	nan	24839231	369355903
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET BEING ORBITED BY THE ROSETTA SPACECRAFT	jcz303010	149.386341824	17.6965860963	image	Hines, Dean C.	3	57306.530825775466	57306.56028197917	1868.0	470.0	720.0	Post-Perihelion Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Continued Support of the Rosetta Mission	57672.72732635	14261	GO	--	POLYGON 149.42419008 17.69882864 149.419199178432 17.700727169054169 149.41933345 17.70098796 149.41339666747842 17.703246092045436 149.41340981 17.70327162 149.38611359 17.71365103 149.3854302694572 17.712323331878636 149.37931127 17.71464943 149.36605771 17.68889173 149.39335114 17.67851501 149.39388702876451 17.679556324023046 149.41093132 17.67307379 149.42419008 17.69882864 149.42419008 17.69882864	mast:HST/product/jcz303010_drz.jpg	mast:HST/product/jcz303010_drz.fits	PUBLIC	True	nan	25001892	373724032
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis02010	281.1070302812	-31.0066887554	image	Hines, Dean C.	3	56888.26101200232	56888.48685717593	9600.0	470.0	720.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57253.60605318	13863	GO	--	POLYGON -78.905924930000026 -31.02423579 -78.87427893 -31.0173634 -78.8800066 -30.98912327 -78.882365737150309 -30.989635932676503 -78.882504439999991 -30.98895186 -78.889317083503954 -30.990432181918216 -78.889530770000022 -30.98937778 -78.891752852813568 -30.989860489154527 -78.891883689999986 -30.98921489 -78.899628421871924 -30.990897116662392 -78.9001551 -30.98829685 -78.902371489060187 -30.988778129799261 -78.90250218 -30.98813288 -78.909141342406116 -30.989574421562239 -78.909719680000023 -30.98671762 -78.911930371781551 -30.987197501880228 -78.91206093 -30.98655257 -78.943699260000017 -30.99341636 -78.937989440000024 -31.02165911 -78.935778550730731 -31.021179788693974 -78.935648239999978 -31.02182416 -78.929005954826081 -31.020383985804244 -78.928427829999976 -31.02324132 -78.926211233460563 -31.02276060029919 -78.926080790000015 -31.02340529 -78.918332079103052 -31.0217246209393 -78.91780553000001 -31.02432554 -78.9155832393156 -31.023843392393292 -78.91545265000002 -31.02448843 -78.9086363989854 -31.023009444135333 -78.908422719999976 -31.02406438 -78.906063370071536 -31.023552312315246 -78.905924930000026 -31.02423579 -78.905924930000026 -31.02423579	mast:HST/product/jcis02010_drz.jpg	mast:HST/product/jcis02010_drz.fits	PUBLIC	True	nan	24839229	369611870
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET BEING ORBITED BY THE ROSETTA SPACECRAFT	jcz302010	149.0210592664	17.79521475611	image	Hines, Dean C.	3	57306.00024725695	57306.02970309028	1868.0	470.0	720.0	Post-Perihelion Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Continued Support of the Rosetta Mission	57672.2263889	14261	GO	--	POLYGON 149.05898205 17.79748171 149.05396387760246 17.799381902109118 149.05409679 17.79964078 149.04813166312613 17.801899341627337 149.04814366 17.80192271 149.02083733 17.81225854 149.02015424058055 17.810927544842077 149.01400423 17.81325475 149.00078955 17.78750012 149.02809307 17.77716698 149.02863132569428 17.778215844015303 149.04576215 17.77173013 149.05898205 17.79748171 149.05898205 17.79748171	mast:HST/product/jcz302010_drz.jpg	mast:HST/product/jcz302010_drz.fits	PUBLIC	True	nan	25001891	369115725
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET BEING ORBITED BY THE ROSETTA SPACECRAFT	jcz301010	148.6544847864	17.89356942054	image	Hines, Dean C.	3	57305.47050170139	57305.49995790509	1868.0	470.0	720.0	Post-Perihelion Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Continued Support of the Rosetta Mission	57671.63094901	14261	GO	--	POLYGON 148.69195443 17.89721012 148.68672841023698 17.898793036618102 148.68699035 17.89940911 148.68079264145175 17.901286131427462 148.68095142 17.9016596 148.65292317 17.91014527 148.65250560953473 17.909162730128802 148.64610927 17.91109857 148.63481426 17.88451419 148.65263308739057 17.879121057787451 148.65263008 17.87911398 148.68065353 17.87062838 148.69195443 17.89721012 148.69195443 17.89721012	mast:HST/product/jcz301010_drz.jpg	mast:HST/product/jcz301010_drz.fits	PUBLIC	True	nan	25001890	373785052
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis05020	290.5842080034	-27.96554445143	image	Hines, Dean C.	3	56978.454278206016	56978.60601420139	6280.0	470.0	720.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57343.75185176	13863	GO	--	POLYGON -69.38324793999999 -27.97644 -69.38325337699672 -27.976084633770142 -69.37975694 -27.975807 -69.379771610697432 -27.974848106719922 -69.376938269999982 -27.97462306 -69.376959271556942 -27.973252682572433 -69.363480320000008 -27.97218126 -69.363499179187144 -27.970960544973902 -69.35957473000002 -27.97064824 -69.35958024246527 -27.970293021520565 -69.35608091 -27.97001454 -69.356525560000023 -27.94135352 -69.388067579999984 -27.94386099 -69.388062164224209 -27.944216860866497 -69.391561589999981 -27.94449469 -69.391543021733554 -27.945714773910108 -69.39546565 -27.94602599 -69.395444888234721 -27.947396421736535 -69.408921220000025 -27.94846475 -69.408906811818213 -27.9494236609726 -69.41173950000001 -27.94964805 -69.411734159831681 -27.950004069145866 -69.415230679999979 -27.95028105 -69.415223505589069 -27.950759354159036 -69.427996080000014 -27.95177004 -69.427990357442667 -27.952155441892863 -69.431772200000012 -27.95245457 -69.431346519999977 -27.98111569 -69.399792699999978 -27.97861726 -69.399798527580231 -27.97823255633358 -69.396016780000025 -27.97793273 -69.39602403128157 -27.97745404126006 -69.38324793999999 -27.97644 -69.38324793999999 -27.97644	mast:HST/product/jcis05020_drz.jpg	mast:HST/product/jcis05020_drz.fits	PUBLIC	True	nan	24839234	374074014
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis06020	290.9147892768	-27.90546497065	image	Hines, Dean C.	3	56979.51550486111	56979.66734533565	6280.0	470.0	720.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57344.94447902	13863	GO	--	POLYGON -69.051552329999993 -27.91547868 -69.051566623053915 -27.915304522529482 -69.048023170000022 -27.91483611 -69.048086300262 -27.914066875478145 -69.045198070000026 -27.91368501 -69.045253211462011 -27.913013321787403 -69.031596869999987 -27.91120688 -69.031681552501226 -27.910176912272057 -69.027714189999983 -27.90965175 -69.02772849552359 -27.909477898544647 -69.024182240000016 -27.90900847 -69.02653583 -27.88039823 -69.057861839999987 -27.88454222 -69.057847539106191 -27.884716718646743 -69.06139399 -27.88518549 -69.06130963442007 -27.88621477953863 -69.065275460000009 -27.88673877 -69.0652204552501 -27.887410472053556 -69.078874509999991 -27.8892136 -69.078813220742 -27.889963190045712 -69.098235400000021 -27.89252561 -69.098220005459254 -27.892714303389873 -69.102038349999987 -27.89321784 -69.099703449999993 -27.92182943 -69.082889846828763 -27.919611642662879 -69.082889340000008 -27.91961784 -69.051552329999993 -27.91547868 -69.051552329999993 -27.91547868	mast:HST/product/jcis06020_drz.jpg	mast:HST/product/jcis06020_drz.fits	PUBLIC	True	nan	24839236	374073949
science	HST	CALACS	ACS/WFC	HST	F606W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis03010	280.9542165962	-30.99542663878	image	Hines, Dean C.	3	56889.322632372685	56889.548465706015	9600.0	470.0	720.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57254.78804398	13863	GO	--	POLYGON -79.05840738 -31.01316703 -79.026878020000026 -31.00584488 -79.033151780000026 -30.97766767 -79.035392031871083 -30.978188257438966 -79.035550100000023 -30.97747812 -79.042032257876684 -30.978984322746957 -79.04228344 -30.97785538 -79.044393200704519 -30.978345489210106 -79.044542289999981 -30.9776754 -79.0519318160874 -30.979391859188709 -79.052526699999987 -30.97671682 -79.054630711213818 -30.97720541840804 -79.054779619999977 -30.9765358 -79.0610665098948 -30.977995640936911 -79.061717779999981 -30.97506566 -79.0638160189322 -30.975552764251791 -79.063964759999976 -30.97488358 -79.09548675000002 -30.9821973 -79.089230410000027 -31.01037747 -79.087131972414525 -31.009890899345596 -79.086983480000015 -31.01055955 -79.080693324737766 -31.009100920228253 -79.08004225000002 -31.01203134 -79.077938041505035 -31.011543277238278 -79.077789380000013 -31.01221237 -79.070396015373021 -31.010497338548994 -79.06980123 -31.01317303 -79.067691267708852 -31.012683456849597 -79.06754243 -31.013353 -79.061056825969644 -31.011848027080774 -79.060805640000012 -31.0129775 -79.058565179306754 -31.012457479047875 -79.05840738 -31.01316703 -79.05840738 -31.01316703	mast:HST/product/jcis03010_drz.jpg	mast:HST/product/jcis03010_drz.fits	PUBLIC	True	nan	24839230	374074520
science	HST	CALACS	ACS/WFC	HST	F775W	Optical	COMET-67P-CHURYUMOV-GERASIMENK	COMET; COMET-67P-CHURYUMOV-GERASIMENKO WHICH IS THE PRIMARY TARGET FOR ROSETTA SPACECRAFT	jcis06010	290.9112348543	-27.90621726673	image	Hines, Dean C.	3	56979.505933368055	56979.51200949074	300.0	690.0	860.0	Imaging Polarimetry of the 67P/Churyumov-Gerasimenko with ACS: Supporting the Rosetta Mission	57344.94012718	13863	GO	--	POLYGON -69.07205442999998 -27.91834206 -69.072058317717648 -27.918294549551291 -69.070418239999981 -27.91807766 -69.072739870000021 -27.88970302 -69.103821919999973 -27.89381052 -69.103818044368452 -27.893858065783444 -69.105458039999974 -27.89407459 -69.103144859999986 -27.92244975 -69.07205442999998 -27.91834206 -69.07205442999998 -27.91834206	mast:HST/product/jcis06010_drz.jpg	mast:HST/product/jcis06010_drz.fits	PUBLIC	True	nan	24839235	374073891
...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...	...
science	HLA	HLA	ACS/WFC	HLA	F606WPOL60V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_02_acs_wfc_f606wpol60v_03	149.02105347495342	17.795211192797524	image	Hines	2	57306.00024	57306.00566	467.0	nan	nan	--	57672.2263889	14261	HLA	--	POLYGON J2000 149.00078990 17.78750200 149.02809590 17.77716680 149.04131880 17.80291830 149.01400960 17.81325530 149.00078990 17.78750200	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_02_acs_wfc_f606wpol60v_03	--	PUBLIC	--	nan	26004663	67971930
science	HLA	HLA	ACS/WFC	HLA	F606WPOL60V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_02_acs_wfc_f606wpol60v_01	149.0387234255141	17.789775192433133	image	Hines	2	57306.02429	57306.02971	467.0	nan	nan	--	57672.2263889	14261	HLA	--	POLYGON J2000 149.03168180 17.80781910 149.01846070 17.78206810 149.04576370 17.77173100 149.05898790 17.79748020 149.03168180 17.80781910	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_02_acs_wfc_f606wpol60v_01	--	PUBLIC	--	nan	26004661	67971928
science	HLA	HLA	ACS/WFC	HLA	F606WPOL60V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_02_acs_wfc_f606wpol60v_02	149.02788342509825	17.794214142733026	image	Hines	2	57306.00826	57306.01368	467.0	nan	nan	--	57672.2263889	14261	HLA	--	POLYGON J2000 149.04814860 17.80192050 149.02084030 17.81225830 149.00762000 17.78650570 149.03492520 17.77616980 149.04814860 17.80192050	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_02_acs_wfc_f606wpol60v_02	--	PUBLIC	--	nan	26004662	67971929
science	HLA	HLA	ACS/WFC	HLA	F606WPOL120V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_03_acs_wfc_f606wpol120v_04	149.40391343235848	17.69114218886538	image	Hines	2	57306.55487	57306.56029	467.0	nan	nan	--	57672.72732635	14261	HLA	--	POLYGON J2000 149.42419210 17.69882700 149.39689650 17.70920930 149.38363650 17.68345530 149.41092900 17.67307470 149.42419210 17.69882700	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_03_acs_wfc_f606wpol120v_04	--	PUBLIC	--	nan	26004668	67971935
science	HLA	HLA	ACS/WFC	HLA	F606WPOL60V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_13863_05_acs_wfc_f606wpol60v_03	290.6007621459412	-27.963361624819484	image	Hines	2	56978.50763	56978.51672	785.0	nan	nan	--	57343.75185176	13863	HLA	--	POLYGON J2000 290.61631780 -27.94778080 290.58477530 -27.95028270 290.58520200 -27.97894070 290.61675290 -27.97643870 290.61631780 -27.94778080	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_13863_05_acs_wfc_f606wpol60v_03	--	PUBLIC	--	nan	25981120	67948387
science	HLA	HLA	ACS/WFC	HLA	F775W	OPTICAL	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_13863_05_acs_wfc_f775w_01	290.58067756432786	-27.966253462770922	image	Hines	2	56978.44466	56978.44641	150.0	690000000000.0	860000000000.0	--	57343.70451382	13863	HLA	--	POLYGON J2000 290.56522550 -27.98171880 290.59655000 -27.97922890 290.59612520 -27.95078640 290.56480900 -27.95327620 290.56522550 -27.98171880	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_13863_05_acs_wfc_f775w_01	--	PUBLIC	--	nan	25981126	67948393
science	HLA	HLA	ACS/WFC	HLA	F775W	OPTICAL	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_13863_06_acs_wfc_f775w_01	290.9128770096229	-27.905945046863923	image	Hines	2	56979.51028	56979.51203	150.0	690000000000.0	860000000000.0	--	57344.94012718	13863	HLA	--	POLYGON J2000 290.89618110 -27.89381480 290.89848990 -27.92218630 290.92957680 -27.91807330 290.92725980 -27.88970230 290.89618110 -27.89381480	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_13863_06_acs_wfc_f775w_01	--	PUBLIC	--	nan	25981136	67948403
science	HLA	HLA	ACS/WFC	HLA	F606WPOL60V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_02_acs_wfc_f606wpol60v_04	149.03383347531883	17.791933192580494	image	Hines	2	57306.01628	57306.0217	467.0	nan	nan	--	57672.2263889	14261	HLA	--	POLYGON J2000 149.02679120 17.80997720 149.01357040 17.78422550 149.04087430 17.77388890 149.05409830 17.79963880 149.02679120 17.80997720	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_02_acs_wfc_f606wpol60v_04	--	PUBLIC	--	nan	26004664	67971931
science	HLA	HLA	ACS/WFC	HLA	F606WPOL120V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_03_acs_wfc_f606wpol120v_03	149.38633343179924	17.696582189227897	image	Hines	2	57306.53082	57306.53624	467.0	nan	nan	--	57672.72732635	14261	HLA	--	POLYGON J2000 149.37931420 17.71464960 149.36605570 17.68889320 149.39335130 17.67851450 149.40661290 17.70426910 149.37931420 17.71464960	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_03_acs_wfc_f606wpol120v_03	--	PUBLIC	--	nan	26004667	67971934
science	HLA	HLA	ACS/WFC	HLA	F606WPOL120V	--	COMET-67P-CHURYUMOV-GERASIMENK	--	hst_14261_03_acs_wfc_f606wpol120v_01	149.39313343193777	17.695584189165338	image	Hines	2	57306.53884	57306.54426	467.0	nan	nan	--	57672.72732635	14261	HLA	--	POLYGON J2000 149.41341280 17.70327040 149.38611500 17.71365150 149.37285580 17.68789590 149.40015050 17.67751650 149.41341280 17.70327040	https://hla.stsci.edu/cgi-bin/preview.cgi?dataset=hst_14261_03_acs_wfc_f606wpol120v_01	--	PUBLIC	--	nan	26004665	67971932

Now that we have our filtered observations, let’s sort the rows of this table based on the t_min criteria, which refers to the start time of the exposure in MJD.

filtered_observations.sort("t_min")

Now that we’ve sorted our table, let’s construct a basic ephemeris showing the path of our object over time (with t_min, or exposure start in MJD, as our time component):

ephemeris = Table([filtered_observations["s_ra"],
                   filtered_observations["s_dec"],
                   filtered_observations["t_min"]], names=("ra", "dec", "t_min"))

Let’s display the contents of our ephemeris, and use it to generate a plot of the comet’s path:

ephemeris.sort("t_min")
ephemeris

Table length=70

ra	dec	t_min
float64	float64	float64
281.2558788729	-31.01619293249	56887.26573422454
281.1070408364967	-31.006679797131913	56888.26101
281.1070302812	-31.0066887554	56888.26101200232
281.1045408863173	-31.00650879708346	56888.27707
281.0975108367455	-31.006933797314236	56888.32419
281.0951608865579	-31.006770747268593	56888.34025
281.0868808868347	-31.005851797486205	56888.39054
281.0845408866453	-31.005687797434355	56888.40661
281.0773208868312	-31.004271747618215	56888.4569
...	...	...
149.02105347495342	17.795211192797524	57306.00024
149.0210592664	17.79521475611	57306.00024725695
149.02788342509825	17.794214142733026	57306.00826
149.03383347531883	17.791933192580494	57306.01628
149.0387234255141	17.789775192433133	57306.02429
149.38633343179924	17.696582189227897	57306.53082
149.386341824	17.6965860963	57306.530825775466
149.39313343193777	17.695584189165338	57306.53884
149.39905343216378	17.69330118900645	57306.54686
149.40391343235848	17.69114218886538	57306.55487

plt.figure(figsize=(12,8))
plt.scatter(ephemeris[0:18]['ra'], ephemeris[0:18]['dec'], color='royalblue', s=200, lw=1., edgecolor='k')

plt.xlabel("Right Ascension (deg)", fontsize=20)
plt.ylabel("Declination (deg)", fontsize=20)

plt.title("Sky Coordinates", fontsize=20)

plt.xticks(fontsize=15)
plt.yticks(fontsize=15)
plt.grid()

../../../_images/275fc5f90527584d1c871a742e63728617e1a27cc048ba70550b7e3511109d8e.png

You can choose to save the ephemeris table in your current working directory by running the cell below:

# Overwriting is not necessary, but prevents this Notebook from failing STScI's automated testing
ephemeris.write('ephemeris-comet67p-cg.csv', format='ascii', overwrite=True)

Resources#

The following is a list of resources that were referenced throughout the tutorial, as well as some additional references that you may find useful:

Citations#

If you use any of astroquery’s tools for published research, please cite the authors. Follow this link for more information about citing astroquery:

Citing astroquery

About This Notebook#

If you have comments or questions on this notebook, please contact us through the Archive Help Desk e-mail at archive@stsci.edu.

Author: Jenny V. Medina
Keywords: astroquery, wildcards, moving target
Last Updated: Jun 2023