Loading Data into Iris

A SED data file stored on your local disk or at a URL address may be uploaded into the Iris main display simply by starting the application and selecting the Load File icon on the Iris desktop.

After browsing for and selecting your SED data file on disk, or entering the URL address where the file is located, simply select the appropriate file format from the drop-down menu, and then either "Load Spectrum/SED" or "Load Photometry Catalog." The former option is appropriate for a data file consisting of one or more segments of data, and the latter, for a file consisting of a photometric point(s). If a segment is loaded and it is already in one of the formats natively supported by Iris, it will automatically be displayed in the Iris Visualizer; otherwise, you will have to complete an extra step of entering configuration information in order to convert it for upload into the display. Likewise, if a photometry catalog is loaded, you will have to enter several pieces of information in order to 'tell' Iris how to display the points. The "Building a SED in Iris" section of the Iris How-to Guide demonstrates the use of these two loading options.

IVOA-compliant SED files are available from SED services such as the NASA/IPAC Extragalactic Database (NED), which you can upload into the application (recall the option to directly import SEDs into Iris from NED, in particular). The Iris package includes sample SED files in the "examples" subdirectory of the installation directory, which were downloaded from NED by searching its photometry data archives for SEDs of the following objects: 3C 273, 3C 295, 3C 66A, M31, M87, NGC 1068, and NGC 4151.

The sample files in the "examples" directory are shown below:

$ ls <basedir>/miniconda/envs/iris/opt/iris/examples/
3c273.xml
3c295.xml
3c66a.xml
m31.xml
m87.xml
ngc1068.xml
ngc4151.xml

As an alternative to loading data from file, SED data from NED may be directly imported into Iris via the "Get an SED from the NED Service" option in the Load File window.

The entered target name will be resolved by NED, and any associated SED data found in the NED photometry archive will be returned by the web service and loaded into the tool. (The "Change Endpoint" input can be used to change the NED service URL which is queried; however, this not usually needed.)

After entering the name of the desired target and selecting "Import NED SED", if the search was successful the SED data for the source will appear automatically in the Iris Visualizer, and an entry for the imported SED will be added to the SED Builder window.

This example query returns a collection of photometric data points obtained by various astronomical observatories, all contributed to the NED photometry data archive in association with blazar 3C66A. The metadata associated with one or multiple selected data points may be viewed with the "Metadata" button in the Iris main display, as demonstrated in the "Visualizing SED Data" section of the Iris How-to Guide.

In the lower-left corner of the Iris desktop there is an icon that shows the status of the Simple Application Messaging Protocol (SAMP) connection, which the tool uses to communicate with other interoperable applications.

SAMP is a Virtual Observatory protocol that allows desktop applications to communicate with each other. If you use other SAMP-enabled Virtual Observatory applications that manipulate tables of astronomical data, such as Topcat or Aladin, you can transmit tables of data from these external applications to Iris.

To transmit data to Iris from another SAMP-enabled desktop application, simply broadcast the table from the external application. If in the SED Builder window of Iris there are no open SEDs, a new SED will be created.

Note that the "Broadcast SED" button in the SED Builder window can be used to transmit a SED from Iris to another SAMP-enabled application.

The ASDC IRIS Plugin is a software interface developed at the ASI Science Data Center (ASDC) as part of an on-going collaboration between the ASDC and the IRIS developers at CfA. It works as an interface to retrieve spectral data from the ASDC SED server and use it within the IRIS tool.

Installation Instructions

If an icon named "ASDC Data" is already present in the IRIS main window, this means that the plugin is already pre-installed and properly configured on your IRIS version. If this is the case, you may skip the following instructions and go directly to the "Usage" section.

If the icon marked with the red arrow in fig. 1 is not present, the corresponding plugin can be found in the IRIS directory:

<basedir>/miniconda/envs/iris/opt/iris/lib/AsdcIrisPlugin-1.1.3.jar

To install it, just go to "Plugin Manager" under the "Tools" menu bar, copy the above path to the "Plugin Directory" and "Load" the plugin. A new icon named "ASDC Data" will appear in the IRIS main window.

Usage

To launch the plugin, click on the "ASDC Data" icon in the IRIS main window. A new window, named "ASDC Catalog query" will appear. This is the main interface to query the ASDC catalogs server, load ASDC multi-frequency data on IRIS and display it as spectral energy distributions (SEDs).

The name of the cosmic source for which SED data is required can be entered in the "Target Name" box. The system will automatically retrieve the corresponding equatorial coordinates using the NED or the Simbad name server. Alternatively, if the source's coordinates are known, these can be directly inserted in the "Ra" and "Dec" boxes, in decimal degrees.

Data can be queried according to observation time, by selecting the start and end date of observation (Tstart Date/Time and TStop Date/Time boxes). Time intervals can be specified in the common year-month-day-hour-minute-second format (yyyy-MM-dd hh:mm:ss), or as Modified Julian Day (MJD), using the "Date Format" box.

Many different catalogs can be queried. They are grouped in the "Catalogs Available" box according to their wavelength domain. Each domain (Radio, Infrared, Optical UV, Soft X Ray, Hard X Ray and Gamma Ray) includes several catalogs, which can be viewed by clicking on the arrow to the left of each entry. The full catalog list is reported in Appendix A1. To select or deselect a catalog, just check or uncheck the corresponding box.

Each catalog has a default search radius, which depends on the precision of the coordinates listed in the chosen catalog. Be aware that search radii can vary substantially depending on catalog type. For example, optical catalogs typically have radii of a few arc-seconds, while gamma-ray catalogs can have search radii that can be as large as one degree.

The "Search Radius" box allows users to vary the circular region within which data belonging to each catalog are searched. To do this, just select a catalog from the "Catalogs Available" box. The name of the selected catalog will appear in the "Catalog Name" box, and the default error radius in the "Search Radius" one (see fig. 3 for an example). A new search radius in arc-minutes for the selected catalog can now be defined editing the "Search Radius" box. The search radius is centered on the input coordinates.

ASDC Catalog List

The complete list of the catalogs accessible via the ASDC IRIS Plugin as of June 2013, is reported below in the table. This list may of course change in time as more catalogs are published in the ASDC webpages. The first column indicates the catalog name, the second one the group to which the catalog belongs, and the last one the frequency domain of the catalog entries. Infrared, Optical and UV fluxes have been corrected for the Galactic AV, following the extinction recipes in Cardelli et al. (1989, ApJ, 345, 245) and Fitzpatrick (1999, PASP, 111, 63). The Soft X-ray fluxes have been corrected for the Galactic NH, modeling the corresponding X-ray spectrum with an absorbed power law. More information about the ASDC catalogs can be found on the ASDC webpages at http://tools.asdc.asi.it/SED/docs/SED_catalogs_reference.html