Module mast

Search and retrieve information from a MAST catalog.

Two ways to search for data within a catalog name:

1. You're looking for info on one target, then give the target's ID or coordinates (ra and dec), and a search radius.
2. You're looking for information of a whole field, then give the field's coordinates (ra and dec), and radius.

If you have a list of targets, you need to loop this function.

If you supply a filename, the results will be saved to that path, and you will get the filename back as received from urllib.URLopener (should be the same as the input name, unless something went wrong).

If you don't supply a filename, you should leave filetype to the default tsv, and the results will be saved to a temporary file and deleted after the function is finished. The content of the file will be read into a dictionary, as well as the units (two separate dictionaries with the same keys, depending on the colum names in the catalog). The entries in the dictionary are of type ndarray, and will be converted to a float-array if possible. If not, the array will consist of strings. The comments are also returned as a list of strings.

Parameters:

• catalog (str) - name of a MAST mission catalog
• filename (str) - name of the file to write the results to (no extension)

Returns: str/ record array, dict, list of str

filename / catalog data columns, units, comments

Convert/combine MAST record arrays to measurement record arrays.

Every line in the combined array represents a measurement in a certain band.

This is probably only useful if results contains only information on one target (or you have to give 'ID' as an extra field, maybe).

The standard columns are:

1. meas: containing the photometric measurement
2. e_meas: the error on the photometric measurement
3. flag: an optional quality flag
4. unit: the unit of the measurement
5. photband: the photometric passband (FILTER.BAND)
6. source: name of the source catalog

You can add extra information from the Mast catalog via the list of keys extra_fields.

If you give a master, the information will be added to a previous record array. If not, a new master will be created.

The result is a record array with each row a measurement.

Parameters:

• source (str) - name of the Mast source
• results (record array) - results from Mast search
• units (dict) - header of Mast catalog with key name the column name and key value the units of that column
• master (record array) - master record array to add information to
• extra_fields (list of str) - any extra columns you want to add information from

Returns: record array

array with each row a measurement

Read a MAST csv (comma-sep) file into a record array.

Parameters:

• filename (str) - name of the TCSV file

Returns: record array, dict, list of str

catalog data columns, units, comments

Download all available photometry from a star to a record array.

For extra kwargs, see _get_URI and mast2phot

Retrieve an image from DSS

plot with

>>> data,coords,size = mast.get_image('HD21389')
>>> pl.imshow(data[::-1],extent=[coords[0]-size[0]/2,coords[0]+size[0]/2,
                                coords[1]-size[1]/2,coords[1]+size[1]/2])

Get Fuse spectrum.

select can be ['ano','all']

# what about MDRS aperture?