1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
.. doctest-skip-all
.. _astroquery.gemini:
************************************
Gemini Queries (`astroquery.gemini`)
************************************
Getting Started
===============
This module can be used to query the Gemini Archive. Below are examples of querying the data with various
parameters.
Positional Queries
------------------
Positional queries can be based on a sky position. Radius is an optional parameter and the default is 0.3 degrees.
.. code-block:: python
>>> from astroquery.gemini import Observations
>>> from astropy import coordinates, units
>>> coord = coordinates.SkyCoord(210.80242917, 54.34875, unit="deg")
>>> data = Observations.query_region(coordinates=coord, radius=0.3*units.deg)
>>> print(data[0:5])
exposure_time detector_roi_setting detector_welldepth_setting telescope ...
------------- -------------------- -------------------------- ------------ ...
119.9986 Full Frame -- Gemini-North ...
119.9983 Full Frame -- Gemini-North ...
119.9986 Full Frame -- Gemini-North ...
119.9983 Full Frame -- Gemini-North ...
99.9983 Full Frame -- Gemini-North ...
Observation Name Queries
------------------------
You may also do a query by the name of the object you are interested in.
.. code-block:: python
>>> from astroquery.gemini import Observations
>>> data = Observations.query_object(objectname='m101')
>>> print(data[0:5])
exposure_time detector_roi_setting detector_welldepth_setting telescope ...
------------- -------------------- -------------------------- ------------ ...
119.9986 Full Frame -- Gemini-North ...
119.9983 Full Frame -- Gemini-North ...
119.9986 Full Frame -- Gemini-North ...
119.9983 Full Frame -- Gemini-North ...
99.9983 Full Frame -- Gemini-North ...
Observation Criteria Queries
----------------------------
Additional search terms are available as optional arguments to the `~astroquery.gemini.ObservationsClass.query_criteria`
call. These all have default values of None, in which case they will not be considered during the search.
Some examples of available search fields are the instrument used, such as GMOS-N, the observation_type, such as BIAS,
and the program ID. For a complete list of available search fields, see
`~astroquery.gemini.ObservationsClass.query_criteria`
.. code-block:: python
>>> from astroquery.gemini import Observations
>>> data = Observations.query_criteria(instrument='GMOS-N',
... program_id='GN-CAL20191122',
... observation_type='BIAS')
>>> print(data[0:5])
exposure_time detector_roi_setting detector_welldepth_setting telescope mdready ...
------------- -------------------- -------------------------- ------------ ------- ...
0.0 Central Stamp -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
In addition, the criteria query can accept additional parameters via the ``*rawqueryargs`` and ``**rawquerykwargs``
optional parameters.
The ``orderby`` parameter can be used to pass the desired sort order.
.. code-block:: python
>>> from astroquery.gemini import Observations
>>> data = Observations.query_criteria('centralspectrum',
... instrument='GMOS-N',
... program_id='GN-CAL20191122',
... observation_type='BIAS',
... filter='r',
... orderby='data_label_desc')
Observation Raw Queries
-----------------------
Finally, for ultimate flexibility, a method is provided for driving the "raw" query that is sent to the
webserver. For this option, no validation is done on the inputs. That also means this method may allow
for values or even new fields that were not present at the time this module was last updated.
Regular *args* search terms are sent down as part of the URL path. Any *kwargs* are then sent down with
key=value also in the URL path. You can infer what to pass the function by inspecting the URL after a search in the
Gemini website. This call also supports the ``orderby`` kwarg for requesting the sort order.
This example is equivalent to doing a web search with
`this example search <https://archive.gemini.edu/searchform/RAW/cols=CTOWEQ/notengineering/GMOS-N/PIname=Hirst/NotFail>`_ .
Note that *NotFail*, *notengineering*, *RAW*, and *cols* are all sent automatically. Only the additional
terms need be passed into the method.
.. code-block:: python
>>> from astroquery.gemini import Observations
>>> data = Observations.query_raw('GMOS-N', 'BIAS', progid='GN-CAL20191122')
>>> print(data[0:5])
exposure_time detector_roi_setting detector_welldepth_setting telescope mdready ...
------------- -------------------- -------------------------- ------------ ------- ...
0.0 Central Stamp -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
0.0 Full Frame -- Gemini-North True ...
Reference/API
=============
.. automodapi:: astroquery.gemini
:no-inheritance-diagram:
|
