ObservationsClass

class astroquery.gemini.ObservationsClass(*args)[source]

Bases: astroquery.query.BaseQuery

Query class for observations in the Gemini archive.

This class provides query capabilities against the gemini archive. Queries can be done by cone search, by name, or by a set of criteria.

Attributes Summary

server
url_helper

Methods Summary

query_criteria([coordinates, radius, …]) search a variety of known parameters against the Gemini observations.
query_object(objectname[, radius]) search for Gemini observations by target on the sky.
query_raw(*args, **kwargs) perform flexible query against Gemini observations
query_region(coordinates[, radius]) search for Gemini observations by target on the sky.

Attributes Documentation

server = 'https://archive.gemini.edu'
url_helper = <astroquery.gemini.urlhelper.URLHelper object>

Methods Documentation

query_criteria(coordinates=None, radius=<Quantity 0.3 deg>, pi_name=None, program_id=None, utc_date=None, instrument=None, observation_class=None, observation_type=None, mode=None, adaptive_optics=None, program_text=None, objectname=None, raw_reduced=None)[source]

search a variety of known parameters against the Gemini observations.

Given various criteria, search the Gemini archive for matching observations.

Parameters:

coordinates : str or coordinates object

The target around which to search. It may be specified as a string or as the appropriate coordinates object.

radius : str or Quantity object, optional

Default 0.3 degrees. The string must be parsable by Angle. The appropriate Quantity object from units may also be used. Defaults to 0.3 deg.

pi_name : str, optional

Default None. Can be used to search for data by the PI’s name.

program_id : str, optional

Default None. Can be used to match on program ID

utc_date : date or (date,date) tuple, optional

Default None. Can be used to search for observations on a particular day or range of days (inclusive).

instrument : str, optional

Can be used to search for a particular instrument. Valid values are:

‘GMOS’, ‘GMOS-N’, ‘GMOS-S’, ‘GNIRS’, ‘GRACES’, ‘NIRI’, ‘NIFS’, ‘GSAOI’, ‘F2’, ‘GPI’, ‘NICI’, ‘MICHELLE’, ‘TRECS’, ‘BHROS’, ‘HRWFS’, ‘OSCIR’, ‘FLAMINGOS’, ‘HOKUPAA+QUIRC’, ‘PHOENIX’, ‘TEXES’, ‘ABU’, ‘CIRPASS’

observation_class : str, optional

Specifies the class of observations to search for. Valid values are:

‘science’, ‘acq’, ‘progCal’, ‘dayCal’, ‘partnerCal’, ‘acqCal’

observation_type : str, optional

Search for a particular type of observation. Valid values are:

‘OBJECT’, ‘BIAS’, ‘DARK’, ‘FLAT’, ‘ARC’, ‘PINHOLE’, ‘RONCHI’, ‘CAL’, ‘FRINGE’, ‘MASK’

mode : str, optional

The mode of the observation. Valid values are:

‘imaging’, ‘spectroscopy’, ‘LS’, ‘MOS’, ‘IFS’

adaptive_optics : str, optional

Specify the presence of adaptive optics. Valid values are:

‘NOTAO’, ‘AO’, ‘NGS’, ‘LGS’

program_text : str, optional

Specify text in the information about the program. This is free form text.

objectname : str, optional

Give the name of the target.

raw_reduced : str, optional

Indicate the raw or reduced status of the observations to search for. Valid values are:

‘RAW’, ‘PREPARED’, ‘PROCESSED_BIAS’, ‘PROCESSED_FLAT’, ‘PROCESSED_FRINGE’, ‘PROCESSED_ARC’

Returns:

response : Table

query_object(objectname, radius=<Quantity 0.3 deg>)[source]

search for Gemini observations by target on the sky.

Given an object name and optional radius, returns a Table of Gemini observations.

Parameters:

objectname : str

The name of an object to search for. This attempts to resolve the object by name and do a search on that area of the sky. This does not handle moving targets.

radius : str or Quantity object, optional

Default 0.3 degrees. The string must be parsable by Angle. The appropriate Quantity object from units may also be used. Defaults to 0.3 deg.

Returns:

response : Table

query_raw(*args, **kwargs)[source]

perform flexible query against Gemini observations

This is a more flexible query method. This method will do special handling for coordinates and radius if present in kwargs. However, for the remaining arguments it assumes all of args are useable as query path elements. For kwargs, it assumes all of the elements can be passed as name=value within the query path to Gemini.

This method does not do any validation checking or attempt to interperet the values being passed, aside from coordinates and radius.

This method is most useful when the query_criteria and query_region do not meet your needs and you can build the appropriate search in the website. When you see the URL that is generated by the archive, you can translate that into an equivalent python call with this method. For example, if the URL in the website is:

https://archive.gemini.edu/searchform/RAW/cols=CTOWEQ/notengineering/GMOS-N/PIname=Hirst/NotFail

You can disregard NotFail, cols=x and notengineering. You would run this query as

query_raw(‘GMOS-N’, PIname=’Hirst’)

Parameters:

args :

The list of parameters to be passed via the query path to the webserver

kwargs :

The dictionary of parameters to be passed by name=value within the query path to the webserver

Returns:

response : Table

query_region(coordinates, radius=<Quantity 0.3 deg>)[source]

search for Gemini observations by target on the sky.

Given a sky position and radius, returns a Table of Gemini observations.

Parameters:

coordinates : str or coordinates object

The target around which to search. It may be specified as a string or as the appropriate coordinates object.

radius : str or Quantity object, optional

Default 0.3 degrees. The string must be parsable by Angle. The appropriate Quantity object from units may also be used. Defaults to 0.3 deg.

Returns:

response : Table