Site Map

Finding Files Tutorial

Back to Tutorials

How do I...

Find images and spectra for all objects in a given RA/Dec/Magnitude/Absolute Magnitude range?


You can use the Catalog Archive Server (CAS)'s search tools to find all objects that meet certain criteria, such as position, magnitude, color, or absolute magnitude. The guide How do I find data for all objects in a given RA/Dec/Magnitude/Absolute Magnitude range? shows how to use search tools to find such catalog data.

But in addition to searching for catalog data, you can also search for images and spectra using any constraints you want, including position, magnitude, and absolute magnitude. To search for images and spectra, you will use the Image List tool along with SQL.

This is an extremely powerful way to access SDSS data, because it allows you to search based on any criteria, and then to quickly view all objects that meet your criteria.

Jump to:

Using the Image List tool

  1. Go to the Image List tool. From the astronomers' main page, look under Advanced Tools. From the public main page, look under SkyServer Tools.

  2. You can use the textbox in the upper left of the form, just above Cut and Paste ra/dec list, to get thumbnail images of a list of objects. Paste the list into the textbox in the upper left corner, in this format: name ra dec (with spaces between). name can be anything you want; ra and dec must be in decimal degrees.

  3. However, you can also fill in the Image List with results from an SQL search (also called a query), allowing you to see thumbnail images of objects that meet your search criteria. To send query results to the Image List tool, click the small Use query to fill form link above the textbox.

Submit a Query to Image List

  1. Replace the default query in the textbox with your own query. IMPORTANT: the SELECT block of the query must take the form:

    SELECT name, ra, dec

    The name can be any piece of data you want, but the RA and Dec must be the ra and dec fields from the database (note: SQL is not case-sensitive). For example, this query returns object IDs and positions of 40 galaxies:

      SELECT TOP 40 objid, ra, dec
      FROM photoObj
      WHERE type = 3

    The Image List tool is limited to returning 1,000 objects from search results. If you request more than 1,000 objects, the list will only display the first 1,000.

  2. Click Submit to send the query to the database. A list of results will come up in a new frame in the same window.

  3. Click Send to List to send the results to the Image List tool. You will now see a frame of thumbnail images of your search results.

View Your Search Results

  1. Click on the thumbnail image to go to the Navigate tool entry for that object. The Navigate tool will give you an image of the object and the area around it, which you can zoom in or out of.

  2. Click on the object's name (above the thumbnail image) to go to the Explore tool entry for that object. The Explore tool shows complete data for the object, including a spectrum if one was observed by the SDSS.

  3. To download FITS images of the object, click on the FITS link below the PhotoObj heading in the left-hand menu of the Explore tool. Corrected Frames are the final step of processing for SDSS images. There is one image for each filter. Right-click on the label for the filter you want to download the image.

  4. From the Summary page, click on the spectrum to show a larger view. Spectral lines are marked in pink and green. The redshift and redshift error are also marked on the spectrum.

  5. To see the spectrum as a FITS file, click on the FITS link below the SpecObj heading in the left-hand menu. Right-click on the Download link to download the spectrum. It will be a fits file with 4 rows and about 4,000 columns.

  6. You can view and analyze the spectrum using the SpecView applet, developed by the Space Telescope Science Institute.