Spitzer Heritage Archive (SHA) Quick Start Guide: Getting Up and Running FAST

Jump down to section for expert Leopard users.

(Note that there are also SHA video tutorials, including a quick start and a longer AAS-demo-style overview, available at the IRSA YouTube channel. Look for the playlist that combines all the SHA videos together.)

Searching: Many search methods are available. Most people will probably want to search by position, which is the default option. Target names can be automatically resolved into coordinates using NED or Simbad, or you can specify coordinates (which are echoed back to you, under the entry box, to be sure it understands you correctly). Cone searching is the only option at this time. You can also search by strings through all of the abstracts (e.g., obtaining all programs that explicitly studied planetary nebulae with Spitzer), which is a powerful way to get started in the archive. See the section on searching for more information.

Hints, Tips, and Term Definitions:

Search Results: The search results appear in up to seven tabs: AORs, Level 1, Level 2, IRS Enhanced, Super Mosaics, Source List, and Contributed Products. Each tab provides a different look at the data retrieved by your search. See the section on understanding your search results for more information.

Filtering: Filters, either imposed on your initial search or via your results page, can provide a powerful tool for weeding down search results to the observations you want.

Visualizing: Visualization is a powerful tool for understanding exactly what each observation did and deciding what data to download.

Downloading Data: Click on the checkboxes and then click "Prepare Download" to begin packaging your data for download in the background. See the section on the downloading for more information.

Program Interface: You can also access the SHA from the command line.

For more help, definitions, etc., see the more detailed online help on the left, please see the IRSA Spitzer website, or the site for the ongoing (warm) mission. A set of frequently asked questions (FAQs) is here.

Think you've found a bug? See the section on bugs.

Quick Start for Expert Leopard Users

The SHA does in fact do everything Leopard did, just differently. Some things it does much better, and there are lots more features as well. Here is a quick-start guide for Leopard experts.

The SHA returns your search results in up to seven tabs -- one for AORs (the most compact view of the observations, and the one most like Leopard), one for Level 2=post-BCDs, one for Level 1=BCDs, one for IRS Enhanced Products (meaning developed here at the SSC), one for Super Mosaics (developed here at the SSC), one for Source list (also from here at the SSC) and one for Contributed Enhanced Products (currently meaning [mostly] Legacy Enhanced Products) results. Not all of these are returned by default -- or even exist -- for every search; you will need to enable some of these tabs based on the search parameters. (More information on searching.) To the right of the search results window pane is a details pane, which is also where you can investigate coverage, individual data frames (real data, not jpegs like Leopard), and play with visualization (like Leopard's visualization features). You can also download catalogs into this window. (More information on visualization.)

If you have proprietary data you're trying to retrieve...
...log in first. Click on "sign in" in the upper right of the window. If you don't yet have an account, set one up and email the Spitzer Help Desk (help-at-spitzer.caltech.edu) your account name and program number, and ask for that account to be tied to that program. (More information on user accounts.)

Finding all data by program number
Search by program and enter the program number. (More information on searching.) Continue with "Downloading data" below.

Finding data by PI
Search by Observer and enter the name you want. You need to enter your whole name, and when you start typing characters in the box, a dropdown will appear with the viable choices. Have many programs? Add a filter -- Click on "Filters" in the upper right of the "Campaign Search Results" pane. Locate the "Program ID" column. If you have a text box, enter "=" and the program ID you want. If you have a filter icon, click on the filter icon, and select from the list the program ID(s) you want, and apply the filter. Just the AORs from that program will appear. (More information on searching.) Once you find the data you want, continue with "Downloading data" below.

Finding data by campaign
Many programs in the Warm Era are time series observations, and some investigators may want all the data from a given program that have just been released. To do this: Search by campaign for the most recent campaign. Many AORs will be returned. Once the results appear, apply a filter to the results. Click on "Filters" in the upper right of the "Campaign Search Results" pane. Locate the "Program ID" column. If you have a text box at the top of the column, enter "=" and the program ID you want. If you have a filter icon, click on the filter icon, and select the program ID(s) you want. Apply the filter. Just the AORs from that campaign and that program will appear. (More information on searching.) Continue with "Downloading data" below.

Downloading all data shown
Once the search results are returned (and filtered if applicable), click on the checkbox at the upper left of the Search Results window pane, and the individual checkboxes in each row will automatically all be checked. Then click on "Prepare Download" (immediately above the column of checkboxes). Choose which types of data you wish to download. All the data will be zipped up within the Background Monitor. If you have many zipfiles to download, a download (wget) script is also provided, which can enable automatic downloads of all the zipfiles. (More information on downloading data.)

Downloading just some of the data shown
Click on the checkbox on the far left of the data you want downloaded. You can do this in any of the tabs that are returned. Then click on "Prepare Download" (immediately above the column of checkboxes). Choose which types of data you wish to download. All the data will be zipped up within the Background Monitor. If you have many zipfiles to download, a wget script is also provided, which can enable automatic downloads of all the zipfiles. (More information on downloading data.)

Where is this particular file I've come to know and love?
Be sure that you have clicked "include ancillary data" when you package up the data. Almost certainly the file(s) you seek are tagged as secondary (ancillary) files; just packaging up the plain Level 1/2 files will just get you the primary products. Beginning users are more likely to just want the primary products, whereas you, an expert user, may indeed want the secondary products too.

Where is Leopard's Popular Products search?
This is now folded into the "enhanced products" searches, available from the position search, or (for the IRS enhanced products) in a search exclusive to that product. You can choose to have those results returned from the main position search pane. The "Contributed enhanced product" results include a summary tab of all of the contributed enhanced products that IRSA has ingested that meet your search criteria. The IRS enhanced products search offers several options specific to that data. (More information on searching enhanced products generally, and more information on an IRS Enhanced Product search in particular.)