Euclid Data Explorer at IRSA: Visualization

In your search results, if you performed a search that resulted in cutout images, those images meeting your search criteria are shown on the right. Clicking on different rows on the left changes what is shown on the right. The colored circle-with-crosshairs (a reticle) that is overlaid by default on your images is the center position for the cutout, which could be the position you searched on, or it could be the object's position that you've selected on the left. The coverage image puts all of your search results in context with each other. You can add and overlay catalogs and add other layers to your image. (See the catalogs section for more on catalogs.) The Euclid images as shown are FITS (Flexible image transport system) and the images used for the coverage image HiPS (hierarchical progressive surveys) format.

All of the interactive image visualization tools work the same basic way, and here we describe these basic options, in roughly the order in which you might encounter them in the window.

Contents of page/chapter:
+FITS/HiPS Viewer
+Image Information
+Breaking Out of the Pane (and Going Back)
+FITS Image Navigation in the Cutouts Tab
+Image Toolbar
+Color Stretches
+Image Layers: Viewing/Changing the Layers on the Image
+World Coordinate System (WCS) Alignment
+Extraction Tools
+Region Selection
+Footprints
+HiPS Images: General Information
+Coverage Image
+Upper Left HiPS menus

 


FITS/HiPS Image Viewer

You can interactively explore both FITS and HiPS images with the mouse. Move your mouse over any image that is loaded into the viewer. Details about the image, specifically, the pixel beneath your mouse cursor, appear along the bottom left of the image window. Some information is updated in real time (coordinates); some information (pixel value) is updated when you stop moving your mouse for a second or two. The image can be interactively investigated in this fashion.

You can change the units of what is being read out, in terms of coordinates or pixel values.

If you click on the label of the coordinates, "EQ-J2000" in the screenshot example above, you get this pop-up, from which you can choose the coordinates from among:
  • Equatorial (RA/Dec) J2000 in hh:mm:ss ddd:mm:ss format
  • Equatorial (RA/Dec) J2000 in decimal degrees
  • Galactic in decimal degrees
  • Equatorial B1950
  • Ecliptic J2000
  • Ecliptic B1950
  • FITS Image Pixel
  • Zero-based Image Pixel
If you click on the "click lock" toggle, the coordinates stop dynamically updating when you move your mouse, and they update only when you click on the image. When you do that, little clip boards appear next to each coordinate readout; clicking on those copy the position to your clipboard. From this pop-up window here as shown, you can control the format of the coordinates that are copied to your clipboard -- they can be as shown in the readout, or in the format that Python is expecting (for easy pasting into code).
If you have a FITS image loaded, you have an additional readout. Click on the label of the readout, "Flux" in the tiny snippet of a screenshot example above, and you get this pop-up, from which you can choose the pixel readout from among:
  • Integer data readout in decimal
  • Integer data readout in hexadecimal
  • Floating point data readout in decimal
  • Floating point data readout in hexadecimal
If you choose the hexadecimal options, it will suppress all rescaling corrections found in the header, like BZERO or BSCALE. It will just show you the raw binary number in the file. (For example, if the value in decimals is 5.13795757, the binary value in the file is 0x40a46a26; here is a conversion tool between decimal and hex.)

In the lower left of the images, if you click on this: , you get this pop-up. If you have a FITS image loaded, at the top of this pop-up, it shows the whole image; the orientation of the image is given with a compass rose. There is also a zoom-in of the image at the location under your cursor. Underneath that in the pop-up, whether you have a FITS or HiPS image loaded, you can get a readout of the pixel size, a readout of location on the image in two different coordinate systems, and a readout of the pixel value. You can change the units of those values by clicking on the name of the field: "Pixel Size", "EQ-J2000", "Image Pixel", and "Value". Each results in a pop-up, as above.

You can make the cursor 'stick' on a particular place on the image -- flip the "Click Lock: off" switch to "on" (either in the pop-up or in the lower right of the image window), and then click on the image at your desired location. When this is clicked, small "clipboards" appear near the position readout. Click on that icon to copy that position to your clipboard.

 


Image Information

The upper left corner of the loaded image has a label that tells you basic things about the image you are viewing. The telescope and/or instrument and/or channel and/or data release is first, in black. The field of view follows, in a paler font; this corresponds to the (horizontal) width of the image window. The currently selected image is outlined in brown; other images are outlined in grey.

Here are two examples of image labels. The former is a NISP/Y image, and the field of view shown in the tool at the time this screenshot was taken is 5.9 arcmin. The latter is a VIS image, and the field of view is 59 arcsec.

For HiPS images, the FOV is the angular size of the width of the HiPS viewer. Even if the image as displayed is smaller than the window, the FOV readout is the width of the window, not the image. If you shrink your browser screen, the FOV can get smaller because the viewer gets smaller. If you load more than one image, the FOV can get smaller because two viewers must fit in the same pane. As a result, the HiPS FOV requested in the search panel is approximate.

For FITS images, the FOV label on FITS images works analogously to the FOV label on HiPS images. If you zoom out, the FOV will increase even when the FITS image is entirely within the viewer. That's because the FOV is what the viewer can show you based on the pixel size. If you drag the image so that it is only partially seen through the viewer, the FOV will not change. For FITS images, the cutout size is not the same as the FOV.

The target on which you searched is overlaid on the main image with a cross-hair marker, sometimes called a "reticle." You can remove this (or change its color) from the layers pop-up, described below.

 


Breaking Out of the Pane (and Going Back)

Panes: The search results screen is broken up into panes - the left is a list of items (images or sources for loaded catalogs), and the right is images. If you have more than one image loaded in, the image pane is further subdivided.

Make it big! For some purposes, it is useful to individually view just the table, or the images, or the plots, as large as possible. In any pane, this icon appears in the upper right of the pane. Clicking on it will expand the pane into a larger window, as big as possible given your browser size.

Go back the way it was: The large "Close" arrow at the upper left is always available in the expanded views, and enables you to return back to the pane view.

Also see the next section on image navigation. You have different image navigation options when you are in expanded view (as compared with the default view in a pane).

 


FITS Image Navigation in the Cutouts Tab

There are several icons for navigating the FITS images that appear in the Cutouts tab on the right.

Euclid has data for up to 8 bands for each observed tile. If all 8 bands are available, the Euclid Data Explorer will show all 8, but if fewer bands are available, it will only show the available bands.

Cutouts

These cutout icons tell you that you are viewing cutouts, centered on the search target center, that are 60 arcseconds across. If you click on the scissors, you get a pop-up window like this:

From here, you can control the size of the cutouts, and where the cutouts are centered. If you pick different cutout centers, then the icons in the upper left of the cutouts window change to remind you how the cutouts are centered.

Tips and Troubleshooting:

Single or Tiled Images

In the upper left of the images window pane, you have these icons:
The first icon means "show images one at a time in this pane." You can change which band you are seeing by using the "more" pulldown menu to the upper right of the image:
The second icon means "show all the images I have loaded for the currently selected band in groups of up to 8 at a time" (see below -- "Paging through single image views" -- for more on this, because it is powerful but complicated).
The third icon, selected in this screenshot, means "show me just the up to 8 images related to the selected image's tiles." This is the default view.

Tips and Troubleshooting: When doing an "Images" search, you can have just one line on the left but up to 8 images on the right. That's because you are searching for tiles in an Images search, and it's giving you all possible images for that tile on the right.

Paging through single image views

This is a powerful feature, but may be initially disconcerting. Do an "Inspect Objects" search that yields many targets on the left. On the right, from the view generated by the third icon (), select one of the bandpasses -- say, NISP/J. Now click the second icon (). Now, all of the NISP/J images for all of the targets on the left are shown in order on the right. You can page through them given the navigation aids at the top: In this example, the tool is on page 21 of 23, where images 161-168 out of 180 images are shown. Use the arrows to navigate through the 23 'pages' of 8 images each.

You can change which band you are seeing by using the "more" pulldown menu to the upper right of the image:

3-color images
When in the 'image set' view, this icon also appears in this part of the window. This is a toggle to create a 3-color image. Clicking on this icon generates a pop-up window:
From this, you can select which band is used for which color plane, and then a three color image is generated from your selection. The planes as shown here are the default values.
If you click on the same icon after you have already generated a three-color image, you get different options. This way, you can change what is used for each color plane, or hide the three-color image you have already generated.

Tips and Troubleshooting:

  • Note that you can choose to assign the same band to more than one color plane (e.g., reuse a band), or disable a color plane.
  • You can change the color stretch for each plane separately.

Expanded views
As noted above, if you click on this icon , it makes the images pane take up the entire browser window. When you do that, you have different image navigation options: The first icon (the big square) denotes "show one image at a time." The second icon (the cluster of four squares) denotes "show smaller images of all the images I have loaded at once," e.g., tiled images. The third icon brings up a pop-up window with a list of the images you have loaded.

If you have more than one image loaded and you switch to viewing one image at a time, you get additional choices for navigating through the list of images:
the arrows take you forward and backward; the dots tell you where in the list you are. The "Auto play" tickbox scrolls through the list automatically.

When viewing many images at once, you get a "scroll images" switch. If you toggle this on, then each image tile becomes bigger, and you can use your mouse to scroll up and down through the collection of images. If you are on a Mac, your scrollbar may be hidden until you try to scroll.

When viewing the list of images that are loaded in, the table behaves like any other table in this tool -- that is, it is searchable, sortable, etc. However, as of this writing, the wavelength column is not correctly populated.

Tips and Troubleshooting

 


Image Toolbar (FITS and HiPS)

The image toolbox is always present as a row of tools associated with the images you have loaded, or that are loaded on your behalf. They're generally located above the images you have loaded, with most of them on the upper right. Letting your mouse hover over any of these icons will result in a "tool tip" that appears in order to remind you what the icon does. Most items apply equally to FITS and HiPS images, but some only apply to FITS images.

This is the image toolbox when you have clicked on a FITS image you have loaded:

And, this is the image toolbox when you have clicked on a HiPS image used for searching or coverage images:

The two toolbars are different, but if the same icon appears, it has the same effect on the image. Many of the icons have a downward pointing black triangle, which means that there are additional options in a drop-down menu that appear when you click on the icon.

We now discuss each icon in the order in which they appear.

Tools drop down
The choices here look like this:
 

 

jump to save

jump to rotate

jump to layers

jump to extract

Saving the image
The diskette icon will allow you to save the current image. You can save files to your local disk or to the IRSA Workspace . Note that you control where the file is saved on your disk through your browser; your browser may be configured to store all downloads in a particular location on your disk.

If the current image is a FITS file, you can save it as a FITS or PNG or regions file to your local disk. If it is a HiPS file, your only choices are PNG or regions file. Saved FITS images will not save the color stretches or overlays; it will just save the underlying FITS image. Saved PNG files WILL include any overlays or annotations you have placed on the image, but will not include the underlying FITS image. Saved regions files will not save the underlying image, but will just save the overlays as a DS9 Regions file. See the DS9 website for more information on the syntax of these DS9 region files.

Note that you can save the original or a cropped version of a FITS file; see the "select region" icon below to crop, then click on the save icon. Be sure to save the cropped FITS image (see annotated figure). This feature is not available for HiPS images.

Note that if you overlay a large catalog on an image, then turn around and save a regions file from the catalog overlay, the full catalog may not be saved to the regions file. If you have >5,000 sources, it's entirely likely that not every source will be overlaid on the image (because of hierarchical catalogs display), and thus will not be in the regions file. If you want to save your entire catalog as a regions file, save the catalog from the table pane.

The saved PNG is the same size as it is on your screen. If you want a big version, make the desired image big on your screen (view one-at-a-time; see here) before saving the PNG.

You can't save HiPS images from within this tool. To download your own copy, you will have to track down the original source of the image.

Restoring everything to the defaults
If you've played around a lot with the image, you may want to undo everything you've done. Click this button to restore everything to their original default values. Some layers may persist; remove them via the layers icon.

Viewing the image header
This icon displays a pop-up window with information about the image. If a FITS image is selected, it will show the FITS header of the image; if a HiPS image is selected, it will show the HiPS properties of the image. These are Firefly tables like all the other tables in this tool, so they are sortable and filterable, etc. If you click on the columns in the pop-up, it will sort the keywords alphabetically by that column. This is useful for finding individual keywords in particularly densely populated FITS headers. Click the header again to sort in reverse-alphabetical order, and a third time to return to the default order. Below are examples of an original and sorted FITS header. To make this window go away, click on the 'x' in the upper right of the pop-up, or click "close" on the bottom left.

For comparison, an example of a HiPS properties window is here:

Rotating the image so that North is up
Images retrieved in the Euclid Data Explorer are frequently already very close to North-up. However, you could find yourself in a situation where North is not necessarily up. Clicking this icon will orient the selected image so that North is up.

Flipping the image on the y-axis
Clicking on this icon flips the image on the y-axis. (This option is only available for FITS, not HiPS, images.)

Add a compass rose
When you click this icon, arrows appear on the image showing which direction is North and which is East. Clicking on this icon a second time removes this compass rose. (You can also remove this layer via the layers icon, described below.)

Add a coordinate grid
Click on this icon to overlay a coordinate grid on the image. Click it again to remove it. Customize the units of the grid (to, e.g., Galactic coordinates) via the "layers" icon (described below).(Also see information on HiPS grid in the WCS section.)

Measuring a distance
When you click this icon, at first, nothing seems to happen. However, you can now click and drag to draw a line on the image, and the length of the line is displayed (in the middle of the line). The units for the measured distance (and the color of the overlay) can be changed from the "layers" icon (described below). You can calculate the difference in RA and Dec separately via the layers icon as well; find the layer associated with the distance measurement and tick the "offset calculation" box. When it displays the offset calculation, it will give you the angle in degrees in one corner, and the length of the line segment in the RA and Dec directions, in the units you have specified. When you are done with the distance tool, you can click on the that appears next to the image toolbar, or click on this icon a second time to remove the distance tool. (You can also remove this layer via the layers icon.)

Read in a DS9 Regions file
When you click this icon, you get a pop-up window from which you can read in a DS9 regions file from your local disk. See the DS9 website for more information on the syntax of these DS9 region files. The supported regions are text, circle, box, polygon, line, and annulus. To make this window go away without doing anything, click on the 'x' in the upper right of the pop-up.

Tips and Troubleshooting: If you overlay a list of sources you created in ds9 regions format from your disk, it will only be overlaid on the current image, not all of the images you have loaded. If you want to have it overlaid on all the images you have loaded, create a catalog from your source list and overlay it as a catalog. Then it will appear on all of the images you have loaded, provided that the positions overlap on the sky.

Put a marker on the image
When you click this icon, a drop-down menu appears with several possible options:

The first overlay choice (simply called 'marker') is a red circle. Initially, it appears in the center of the images, and is meant to be moved to wherever you first click in the image. It looks like this:
. The dash-dot line around it means that it is 'active', so you can move (click and drag the marker) or resize it (click and drag the dash-dot boundary). You can change the color of the marker (and change the label) via the "layers" icon (described below). You can also remove this layer via the layers icon. There are several additional options in the drop-down, enough that they have their own section below.

Drill down through the image
If your FITS image has multiple planes or HDUs, especially if each plane or HDU represents a different wavelength, it can be useful to "drill" down through the image cube at a given position on the sky. (You are unlikely to find this kind of file in the WISE archive.) This tool allows you to do just that. When activated, this tool extracts the data at the place your mouse clicks down through the cube. For more information on saving the information, see the extraction section below.

Draw a line in the image
When this tool is activated, you can draw a line in your FITS image with your mouse, and it will extract for you the pixel values along that line. If you have more than one image loaded and visible, you can shift-click in another image to see the same line in another image. For more information on saving the information, see the extraction section below.

Make points in the image
When this tool is activated, you can click in your FITS image with your mouse, and it will extract for you the pixel values at the location of your click, creating a catalog for you as you click. If you have more than one image loaded and visible, you can shift-click in another image to extract points from another image. For more information on saving the information, see the extraction section below.

Zoom
When your mouse is in an image, these options appear in the upper left of the image.
Zooming in or out
Clicking on these magnifying glass icons zooms in or out of the image. The readout of the net effect of your zooming on the displayed field of view (FOV) appears at the top left of each image.

If you click zoom in or out rapidly, a pop-up window appears to allow you to more rapidly select the zoom level (field of view) you want. Select the desired level, or click on the 'x' in the upper right to make the window go away. Here is an example:

You can alternatively zoom using the mouse wheel (or drag forward and backward on a touchpad or magic mouse).

Note that there is a maximum (or minimum) allowed zoom level, and they are different for FITS and HiPS images. A notification will appear when you have reached the maximum (or minimum) allowed zoom level for a given image. To enlarge images more (or less) than that, please repeat your search to obtain new images with smaller (or larger) spatial extent. HiPS images are specifically designed for large areas, so if you need a big area, use HiPS. If you want to zoom in close enough to see individual original pixels, your best choice is FITS.

See also the section below on changing coverage images, specifically that on automatic transitions while zooming.

Fit image to screen or fill screen
These two icons are designed to maximize the available space in your browser window. The first one automatically picks a zoom level such that the image entirely fits within the available space (which could be your whole browser window, or just the portion of it where that image is loaded). The second one automatically picks a zoom level such that the image fills as much of the available space as possible (e.g., it is zoomed such that short axis of the window is filled with the image, whether that short axis is left-right or up-down).

By default, the images that are returned are frequently but not always centered on your search target. Clicking on these icons let you see the whole image that is returned, whether or not it is centered on your target.

This is available for both FITS and HiPS images, though note that FITS images retrieved from IRSA using this tool are typically square, and HiPS images cover the sky, so fitting the image to the screen might not be what you want to do.

Zooming to a 1-to-1 size
Clicking this icon will zoom the image such that one pixel in the image is one pixel on your screen. This option is only available with FITS images; HiPS images by their nature have pixels of varying sizes, so this button would have no meaning in this case.

Color table drop down
This icon enables you to change the color table of the displayed image. (This option is available for FITS and HiPS images.) When you click the button, a drop-down menu appears.
  • The top of the menu either says "Color and overlays locked" or "Color and overlays unlocked" -- by default, all of the (FITS) images that you have loaded are locked together for color and overlays. What that means is if you change the color table (via this menu), then the color table for all the (FITS) images are changed. (Or, if you add a layer to one image, then the layer is added to all the images; see below.) If you don't want this to happen, select "Color and overlays locked" to unlock it. Select the text again to lock it again.

  • The arrow in the upper right creates a pop-up window out of this drop-down menu so that you can leave the choices up while settling on the best option.

  • The next portion of the menu has a wide variety of color table choices. Select your new color table from the options shown.

  • Alternatively, you can use the "color bar" slider to move among the color tables by number. These numbers correspond to the color bar number used in the Python implementation of the Firefly tools.

  • Below the color bar slider, there are sliders controlling the bias and contrast. Click or drag the slider to change the image display.

Color stretch drop down
This icon enables you to change the color stretch of the displayed image. (This option is only available for FITS, not HiPS, images.) Because this is complicated, for much more information, please see below.

Re-center the image drop down
Clicking this icon produces a drop-down menu:

By default, "Pan by table row" is turned on (checked), but, depending on how you have loaded your images, or whether you have catalogs loaded, it may not seem to do very much. However, if you have a catalog loaded and are zoomed in on your images, as you scroll through your catalog, the FITS image underneath will move as needed when you have selected an observation in a different part of the sky than was originally shown.

Other choices are to center on the target of the observation, center the image in the window, or center on a target of your choice. For the last of those, you can simply center on that target, or center and leave a marker on the image at that location.

Selecting a region drop down
When you click this icon, you can select a region of the image for further actions. Because this is complicated, for much more information, please see below.

Image Layers: Viewing/Changing the Layers on the Image
Every time you add something new to the image, you add a 'layer' to the image. This is complex, so please see below for much more information.

Lock/unlock images
You may have this "lock images" icon appear in your toolbar; it will appear as the first icon if they are locked and the second icon if they are unlocked. The main purpose of this icon is to lock all the images you have loaded for zooming, scrolling, etc. You need to specify how it locks and for how long. Clicking it produces this drop-down menu:

The first set of options aligns the images only once, temporarily; the second set of options makes the alignment persist ("lock") when you move the images (that is, when you move one, they all move). You can align by the images' WCS (e.g., RA and Dec), by the target, by the pixels according to the origin of the coordinate system in the image header, or by the pixel at the image center. The most common choice is likely the WCS align and lock. This is discussed in more detail in the WCS section.

Getting help
Clicking on this icon takes you to this help page.

 


Color Stretches

This icon enables you to change the color stretch of the displayed image. (This option is only available for FITS, not HiPS, images.) When you click the button, a drop-down menu appears with a variety of choices.

The top of the menu either says "Color and overlays locked" or "Color and overlays unlocked" -- by default, all of the (FITS) images that you have loaded are locked together for color and overlays. What that means is if you change the color stretch (via this menu), then the color stretch for all the (FITS) images are changed. (Or, if you add a layer to one image, or change the color table of one image, then the change is made to all the images; see other sections of this chapter.) If you don't want this to happen, select "Color and overlays locked" to unlock it. Select the text again to lock it again.
Below that, you can choose from a set of pre-selected options. If you pick the first one, "color stretch", you can customize the stretch. A pop-up window appears with a histogram of the values in the image, and you can change the stretch type and range.

If you pick a color stretch from the pre-defined options, the pop-up window reflects this change. If you change the color stretch in the pop-up window, the drop-down menu changes correspondingly.

Example: Display the pop-up for color stretch. From the main drop-down, pick 'Linear stretch to 99%'. Go back to the color stretch pop-up. Note that it has filled out the stretch type and ranges to reflect the current choice. Then -- either with the pop-up window still up or not -- go back and pick a different pre-defined stretch from the standard options. Note that the values in the pop-up change to reflect this current choice. From the pop-up, pick a different stretch type -- try "histogram equalization." Select "refresh" to update the images. Go back to the drop-down menu. The last 7 items have changed to be based on histogram equalization, as opposed to the "linear" default.

If you have a 3-color image, you can change the stretch in each color plane separately; select the tab at the top accordingly for red, green, or blue. By default, it stretches each band independently, and you can set the parameters in the stretch pop-up accordingly.

As described in Lupton et al. (2004) , a different algorithm may be useful for creating 3-band color images. Select "Hue preserving stretch" to invoke this option. This stretch should be a brightness-independent color-preserving asinh stretch, though in practical terms, it seems to work best for optical images.

It may be useful to scale individual channels; sliders allow you to do so. The Q parameter has another slider. For a linear stretch, Q=0; increase Q to change what features are emphasized. Pedestal values can also be set to allow the level assigned to "black" to change.

 


Viewing/changing the layers on the image

Every time you add something new to the image, you add a 'layer' to the image. You can have an image with a lot of annotations on it.

The number that appears circled in blue over the layers icon tells you at any given time how many layers you have on the currently selected image (the image outlined in brown).

If you click this layers icon, you will get a pop-up window with a list of all the layers you have on top of the image. Here (on the right) is an example of a well-populated layers pop-up; in real life, this is scrollable to see several more layers). From this pop-up, you can:
  • turn layers off and on (click on the switch on the left of the corresponding row);
  • remove layers entirely (click on the 'x' on the right of the corresponding row);
  • change colors of overlays (see below);
  • change symbol shapes and sizes (for overlaid catalogs), including hierarchical catalog settings;
  • change annnotations (for markers);
  • or change units (for the coordinate grid or the distance tool).
To add entirely new layers, though, you need to go to other options within the toolbar.

You can "show all" or "hide all" with the buttons on the lower left of the pop-up window. To make this pop-up window go away, click on the 'x' in the upper right of the pop-up.

Note the target description: This reminds you of the target on which you searched -- here, it was 61.345123, -46.931068 in J2000. The two icons next in that row indicate, respectively, "copy this location to the clipboard" and "center image on this position."

Where it's possible to change colors of a layer, click on the 'colors' link to be taken to a new pop-up from which you can select a new color.

From here, you can click on your desired color in the top colorful box. Immediately below that box, you can change the color and saturation of the top box so that you can select from a different range of colors. Below that, you can enter numerical hex codes or RGBA values (where the value for RGB is between 0 and 255, and A is in units of percent, e.g., 50 = 50%). Finally, you can also select from a pre-defined set of 15 colors by clicking on any of the small boxes. Note that the numerical codes update as you select different colors. Your choices are implemented as soon as you select them. Click 'Close' to close the window, or click 'x' in the upper right.

If you have a catalog loaded into the tool, you can also obtain this pop-up by clicking on the color swatch in the heading of the catalog tab.

For catalogs or the search target, you can also select the symbol shape and size. To adjust the size, type in the symbol size in pixels or use the up/down arrow keys to change the size by one pixel at a time. Your choices are implemented as soon as you select them. Click 'Close' to close the window, or click 'x' in the upper right.

For a HiPS image, you also have a layers icon (), from which you have new, HiPS-specific choices in the layers:

HEALPix (HiPS) Grid

To turn on these choices, toggle the switch to the left of "HEALPix (HiPS) Grid". (See below for more information on HiPS images in general.)

Auto: This option overlays a position grid, with the tile numbers marked in the center of each box. As you continue to zoom in, when smaller tiles are needed, they are drawn, with the new tile numbers marked. You may not zoom beyond HiPS Norder level 14 tiles. The numbers after the "/" is in the "NESTED" (as opposed to RING or NUNIQ) numbering system; see the IVOA standards document for more information.

Grid Match Image Depth: If you select this option, the grid will adjust to a new level when you zoom in and a new level of HiPS image both exists and is used for the display.

Grid Level Lock: Selecting this option yields an additional numerical drop-down menu. The higher number you pick, the smaller the grid boxes are that are drawn. When this option is selected, the boxes stay the same size regardless of how zoomed-in on the image you are.

HiPS MOC

To turn on these choices, toggle the switch to the left of "MOC".

A MOC tells you via a simple boolean yes/no, is there sky coverage from this data set in this region. The choices here are:

Because the planned Euclid coverage extends over such a large fraction of the sky, it is sometimes hard to distinguish, given the default MOC display, what is "on" and what is "off" for planned coverage. You may which to explicitly change the MOC display to "fill" in order to make this more clear. Here is an example of the default display (left), and the display with the planned MOC shown with "fill" rather than "outline" (right):

Tips and Troubleshooting:

 


World Coordinate System (WCS) Alignment

As described above, there is a way to lock/unlock images to each other for position matching. This section describes the image locking in more detail.

When aligning images, you can specify how the images align and for how long. Clicking the lock images icon produces this drop-down menu:

The first set of options aligns the images only once; the second set of options makes the alignment persist ("lock") when you move (zoom, etc.) the images.

You can align by the images' WCS (world coordinate system, e.g., RA and Dec), by the target (align by target on the screen, regardless of position in the sky), by the pixels according to the origin of the coordinate system in the image header, or by the pixel at the image center. The most common choice is likely the WCS align and lock.

Note that aligning by WCS puts North up, and aligned so that each image has the same angular scale.

Tips and Troubleshooting

 


Extraction Tools

Several tools allow you to extract information from images or image planes, but only for FITS (not HiPS) files.Within the Euclid tool, you are very unlikely to encounter data for which the drill can be used. All three of these follow the same basic structure --
  1. Intitiate extraction mode
  2. Set aperture
  3. Try extraction; repeat if desired
  4. Pin (retain) extraction if desired
  5. Download (as table or chart) if desired
  6. Repeat if desired
  7. Click on "end extraction" to finish the process.
The drill pokes down through multiple planes (which you are unlikely to encounter in the Euclid Data Explorer), the line moves across pixels in a plane, and the points extracts points from a plane.

Here, we cover the basic approach, with specifics of each tool integrated as we go along.

Intitiate extraction mode. When you click on one of these icons, you enter into the extraction mode. Text appears next to the image toolbar to remind you that you are in this mode: When you are done, to end this mode, click on this "end extraction."

When starting out, the pop-up window that you get depends on the tool you pick.

For the drill:for the line:and for the points:
Set aperture. In all three cases, the top center of the extract pop-up window has a drop-down from which you can select the aperture value. For the drill and points, you can choose, in pixels, 1x1, 3x3, 5x5, or 7x7. Values can be summed or averaged. For the line, it's a little different. The apertures are 1x1, 1x3, 1x5, or 1x7, and you control whether the points are summed or averaged. You can have it extract along a line that you draw with your mouse on the image (useful for examining brightness profiles, e.g., across spiral arms of a galaxy), or you can have it extract an entire line or column of the image that you specify (useful in the cases where the 'image' is a file where the first row is an extracted spectrum, the second row is the error, the third row is a mask, etc.).

Try extraction. From this point, you can click on your image, or click and drag for the line tool. The pop-up then contains a plot of your extraction.

For the drill:for the line:and for the points:
In each of these cases, it does the best that it can to label the axes accordingly. The cube that is used for the drill example here follows the spectral data model so that it is recognized as a spectrum, and it plots against wavelength. The line extraction is a 1x3 average and plots the offset in arcseconds from the initial mouse click, given the WCS information in the header of the image. The point extraction is a 3x3 sum, and plotted in image x coordinates, but can be changed to show image y coordinates.

Note that for the line, if you have more than one image loaded and visible, you can shift-click on a new image to see the same line on a new image. Similarly, for the points, you can shift-click to change images without extracting points.

For the line extraction, if you want to change at this point to extract along a line or column, use the drop-down menu at the bottom of the pop-up. It's shown here as "free hand selection", but the other choices are line or column selection; you click on the image to select a line or a column, which is particularly useful for quick looks at semi-extracted spectral images.

Pin extraction. Once you have an extraction that you like, you can retain the extraction for further analysis. "Pin chart/table" extracts the information as a table, just like any of the other tables in this tool, with an accompanying plot. You can then manipulate the table/plot just like any other table or plot in this tool. If the tool recognizes the extraction as a spectrum, you may have additional capabilities.

Once you pin or save your extraction, the tool leaves a "footprint" of your extraction on the image so that you can remember what the extraction was. NOTE THAT it is not interpolating across fractional pixels here. It is averaging if you have asked it to average, but particularly if your pixels are large, if you draw a line that is diagonally across pixels, it will be immediately obvious that it's not interpolating. This line gets rendered as these pixels:

The point appears on the image at the lower left corner of the relevant pixel.

You can pin as many different extractions as you want.

From the line extraction pop-up, when you click on "Pin Chart/Table", you get another pop-up:

From this pop-up, you can choose to do a line extraction from just the currently selected image (most likely where you drew your line); all the images and putting all of the extracted lines into one big table (and tab); or all the images and putting all of the extracted lines into individual tables (and tabs). When you do this, the question naturally arises as to how the tool should specify which column (or tab) goes with which image. Some of the images have long, sometimes cryptic titles. You can choose to have the tool use the full image titles in the column headers or tab titles, or abbreviations.

If you choose to have the tool generate one table for each image you have loaded, you may suddenly have a lot of new tabs at the bottom of the screen. There are navigation aids within the tables section that may help.

Download extraction. You can download the extraction as a table or plot without pinning it. Download as Table saves the table to your local disk -- first, you have the same options as immediately above, where you can choose to do a line extraction from just the currently selected image; all the images and putting all of the extracted lines into one big table; or all the images and putting all of the extracted lines into individual tables. Then you have all the same save options as a regular table. Download Chart saves the plot as shown, as a png file.

After pinning an extraction, you also have the extraction appearing as a table in the tables section of your window and as a plot in the plots section of your window. As with any table in this tool, you can save the table by clicking on the diskette icon in the table. You can choose from a variety of formats; see the tables chapter for more information. Similarly, as with any plot in this tool, you can save the plot by clicking on the diskette icon in the plot. See the plots chapter for more information.

Repeat extraction. As long as the extraction pop-up is still open, you can continue to click points or draw lines to make additional extractions.

End extraction mode. When you are done, to end the extraction, click on "end extraction" to end the extraction. Alternatively, just click on the 'x' in the upper right corner of the extraction pop-up.

 


Region Selection

When you click this icon, you can select a region of the image, from which then you can do a whole host of things to the image and to the catalog you may have overlaid upon it.

First, from the drop-down, you are given a choice of a rectangular selection or an elliptical selection:
After you make that choice, you can click and drag in the image, selecting a box or a circle on the image. For the circle, your click is the center of the circle and the drag is the radius of the circle; for the box, your first click is one corner of the rectangle, and the drag is the opposite corner of the rectangle. This region can be resized by grabbing and dragging the corners of the box or the pixels delineating the corners of a box around your code. If you need to move the image underneath, you can hold the shift key and click and drag.

When you have selected a region of the image, additional icons appear above the image, and exactly which icons you see is a function of whether you are working on a FITS or HiPS image, and whether or not you have a catalog overlaid: These icons allow you to do several things:

Crop the image
(FITS only) Crop the image to the selected region. Then you can save the cropped FITS image via the save icon described above.

Note that, if you have a rotated FITS image such that a crop would have to bisect pixels, it will show you the region that encompasses your selection. If you crop at that point, then, it will crop in image space (such that pixels are not bisected). See the figure below -- in the original image, north is up. This has been rotated 45 degrees. The selected region is in white. The yellow dash-dot line is the crop in pixel space that encompasses the selected region.

Select sources (and cancel selection)
(Only if a catalog is overlaid) Select the catalog sources overlaid on the image within the region. Selecting highlights the sources in the list and plot with a different color row or symbol. Once there are selections made, the second icon appears to give you an option to cancel the selection.

Filter sources
(Only if a catalog is overlaid) Filter the overlaid catalog down to the sources within the enclosed area. When you choose to impose a filter via this selection mechanism; the filters icon changes above the catalog to indicate that there is a filter applied (). To clear the filters, click on the cancel filters icon (which also appears after you impose filters): . There is much more on filters in the Tables section.

Zoom the image
Zoom the image to fit the selected area into your field of view.

Recenter the image
Recenter the image on the selected area.

Obtain statistics
(FITS only) Obtain statistics from the image on the region. The statistics option results in a pop-up that looks something like this:

Note that it calculates the location of the minimum and maximum fluxes, and the aperture and flux-weighted centroids; the flux values given are in the same units as the FITS file. If you put your mouse over the row of the table in the pop-up, that location appears as an 'x' on the image.

Search
This tool implements a new search, an "action", on the region you have selected. It results in this drop-down (right). where this example is based on a 4-cornered polygon. (You can also use the region tool to define a cone; this example happends to be a rectangle.) From this drop-down, you can launch:
  • A NED cone search at this position with a radius attempting to correspond to this polygon (more information about NED searches); results loaded into this tool.
  • A Simbad cone search at this position with a radius attempting to correspond to this polygon; results loaded into this tool.
  • A Simbad cone search at this position with a radius attempting to correspond to this polygon, but launch another browser window or tab at Simbad with the results.
  • Refine the search region.
The last option brings up another pop-up window (similar to this) that allows you to refine the search region iteratively by choosing a cone or polygon, setting the center, and setting the cone size or polygon vertices.

From here, you can change the kind of search, refine the positions, launch searches from your refined position (blue button on lower left), and select from the image again (drop-down on the lower right).
When you are working with the selection tool, this: appears next to the image toolbar to remind you that you are in that mode. If you are refinifng positions for a search, it will be . Either way, when you are done with the selection tool, if your other actions don't turn off the selection tool, click on that text to turn it off.

Tips and Troubleshooting

 


Footprints

The marker icon () has a drop-down menu with several possible options:

Any of the options with an arrow on the right can expand to additional subsidiary choices, e.g.,:

We now describe these various footprints here.

For each of these choices, the markers appear initially in the center of the loaded images. The first mouse click you make in any of the images will move the marker to that location.

Each of these marker choices, when overlaid and/or selected as 'active', has a dot-dash square around it. If it is asymmetrical (most of them are), it has an additional "appendage" and a red plus at the center of the footprint:

These so-called "handles" allow you to resize and/or rotate the marker, depending on the nature of the marker. These handles only appear when the marker is selected as active; if you wait a few seconds, they vanish.

Tips and Troubleshooting

The first overlay choice (simply called 'marker') is a red circle.

The remaining markers are all footprints from various telescopes: Spitzer, SOFIA, HST, JWST, and Roman. HST, JWST and Roman are derived from information provided via MAST (see http://gsss.stsci.edu/webservices/footprints/help.html .) For Roman in particular, they are pre-launch values.

Spitzer/IRAC 3.6 and 4.5 micron footprints. These two footprints are placed separately from each other. The footprint can be moved or rotated. Click and drag the center of the footprint. A circle appears with four small circles ("handles") around it. Grab and drag the small circles to rotate it, or drag the big circle to move it. Change the color, delete, or add more copies of the IRAC footprints from the layers pop-up.

SOFIA footprints. Several different SOFIA footprints are available; the graphic here shows a selection of them. The available footprints (all of which are placed separately) are:

Change the color, delete, or add more copies of the SOFIA footprints from the layers pop-up.

HST footprints. You can overlay the whole focal plane footprint, shown here, or individual instrument footprints (NICMOS, WFPC2, ACS/WFC, ACS/HRC, ACS/SBC, WFC3/UVIS, and WFC3/IR). Consult the HST documentation for specifics on which apertures are which. The footprint can be moved or rotated. Click and drag the center of the footprint. A circle appears with four small circles ("handles") around it. Grab and drag the small circles to rotate it, or drag the big circle to move it. Note that if you overlay the footprint on a very small image, nothing will appear to have happened. You need at least a 45 arcmin image to comfortably see the footprint. Change the color, delete, or add more copies of the HST footprints from the layers pop-up.

JWST footprints. You can overlay the whole focal plane footprint, shown here, or individual instrument footprints (FGS, MIRI, NIRCAM, NIS, and NIRSPEC). Note that if you overlay the footprint on a very small image, nothing will appear to have happened. You need at least a 30 arcmin image to comfortably see the entire JWST focal plane. Please consult the JWST documentation for details about the footprints. In all cases, if the footprint is 'active', a circle near the middle of the footprint will appear with four small circles ("handles") around it. Grab and drag the small circles to rotate it, or drag the big circle to move it. Change the color, delete, or add more copies of the footprints from the layers pop-up.

Nancy Grace Roman Space Telescope focal plane footprint. As above, the footprint can be moved or rotated. Click and drag the boresight (the cross hairs), which appears by default to the upper right of the array of squares. A circle appears, centered on the boresight, with four small circles ("handles") around it. Grab and drag the small circles to rotate it, or drag the big circle to move it. Note that if you overlay the footprint on a very small image, nothing will appear to have happened. You need at least a 60 arcmin image to comfortably see the footprint, and even then you will probably have to click and drag to see the entire footprint. Consult the Roman documentation for specifics on the apertures. Change the color, delete, or add more copies of the Roman footprint from the layers pop-up.

 


HiPS Images: General Information & Definitions

HiPS stands for hierarchical progressive surveys, and these kinds of images are multi-resolution HEALPix images (where HEALPix stands for Hierarchical Equal Area isoLatitude Pixelation). (Also see IVOA docs on HiPS .) In practice, what this means is that you can interact with images of a very large chunk of sky, and as you zoom, the pixel size changes dynamically. HiPS images are fundamentally different than FITS images, and as such, what you can do with the HiPS images are different than what you can do with the FITS images.

The whole point of HiPS images is to provide on-demand resolution changes. Zoom out, and it loads large pixels. Zoom in, and it loads smaller pixels. HiPS images are designed to cover large areas of sky efficiently. If you need to visualize many degrees, this is the image type to use. This is why HiPS images are used in this tool for coverage images.

HiPS images typically have the color and stretch set by the person who originally made them. The color table can be remapped within this tool. But, you cannot, in general, change the stretch of HiPS images with as much flexibility as you can with FITS images. This is why there may be multiple versions of some data sets available.

HiPS maps typically come with a Multi-Order Coverage map (MOC). A MOC is a format developed by the International Virtual Observatory Alliance to specify sky regions. In this context, a MOC tells you via a simple boolean yes/no, is there sky coverage from this data set in this region. You can overlay a MOC from one data set onto a completely different data set's HiPS image. The Euclid Data Explorer uses MOCs to show you the planned coverage and the released data on the two main search screens. You can also use MOCs to, say, overlay the MOC from an entirely different survey onto the Euclid MOC to see if there are data from it that overlap with Euclid.


Coverage Image

When the Euclid Data Explorer returns search results, one of the tabs it returns on the right hand side is a "coverage image", which is basically a way for it (and you) to keep track of where you are working on the sky, and to show you an overview of the results.

You may have a coverage image like this -- this is a 2MASS HiPS image showing search results that include 9 Euclid tiles (the large green squares) and 160 sources from the MER catalog (the small pink squares). The red square in the center of each tile is the reference position for each tile. The currently selected row in each of the image and object tabs on the left (not shown) are rendered orange in this coverage image; the top center image is orange, and it is hard to see the orange soruce inamongst the rest of pink square cluster. The target of the search is the small (difficult-to-see) reticle in the middle.

Here is a zoom in on the same coverage image with two new layers -- the green/orange tile boundaries are still shown, but now there are two catalogs overlaid. One catalog is pink and one is blue; both have a lot of sources, so many that the hierarchical catalog display is triggered. The pink diamonds on the left with the enclosed numbers represent sources -- that is, the rightmost pink diamond has 214 sources within it, and the diamond to its lower left has 2950 sources within it, etc. The blue catalog originally had 3 diamond-shaped cells, but two of them have been clicked such that the individual sources are shown to the lower right and left of the one remaining blue diamond which encloses 1066 sources.

You can interact with the coverage image in the same way as you would any other image loaded into this tool.

The thing that makes a coverage image a little bit different, however, is that it can automatically adapt, even beyond what a HiPS image can intrinsically do. The next subsection includes more details about how it can automatically change to accomodate your needs and zoom level.

 


Upper Left HiPS menus

In the upper left of the coverage image, there are two drop-down menus.

The first drop-down menu looks like this.

There are two sections here.

Under "Data Options", you can change what data are shown.
Change HiPS: Changing HiPS images
The choices made by any given creator of a HiPS image may result in any particular region being saturated or too faint to see. Color stretches are set by the creator of the HiPS map and cannot be changed; color tables can be somewhat changed by this tool, but that may be insufficient for your needs. If the HiPS map as shown does not suit your needs and you wish to change the HiPS image, click on the "HiPS/MOC" menu, and then click "Change HiPS". It brings up this pop-up:

Things to note:

  • To select a new image, click on the row corresponding to the new HiPS image you want, and click "Change HiPS" on the bottom left.
  • To cancel without selecting a new image, click "Cancel."
  • This is an interactive table, so all the filtering and column manipulation tools apply here too. You can filter down the columns to find the image you want to use.
  • To learn more about each HiPS map, click on the i with the circle in the second column. It will spawn another window with standardized information about the HiPS map.
  • By default, it shows HiPS maps corresponding to IRSA data collections. To see a more comprehensive list, unclick the box marked "IRSA Featured."

Add MOC Layer: Adding a MOC Overlay
It is often useful to see what other data are available. Click on the "HiPS/MOC" menu, and then click "Add MOC Layer." It brings up this pop-up:

Things to note:

  • Coverage (the first column) is the fraction of the sky covered by that MOC.
  • To select a new MOC, click on the row corresponding to the new MOC you want, and click "Add MOC" on the bottom left.
  • To cancel without selecting a new image, click "Cancel."
  • This is an interactive table, so all the filtering and column manipulation tools apply here too. You can filter down the columns to find the image you want to use.
  • By default, it shows MOCs likely to be most interesting for IRSA users. To see a more comprehensive list, unclick the box at the top left.
  • If you have your own MOC FITS file, you may upload it via the "Use my MOC" tab on the top center.

Under "HiPS to FITS Conversion", you can control whether the viewer will automatically toggle between image types as needed.
By default, the coverage image is most likely a HiPS image. FITS images are best for small regions of the sky, and HiPS images are best for large regions of sky.
Auto Zoom-in to 2MASS K_s FITS:
If you select this, then when you zoom in very close to a target, it will automatically convert to a FITS image when you get close enough.
Switch to 2MASS K_s FITS image:
If you select this, then it will jump directly to a FITS image centered on the currently selected target.
Note that if you swap between HiPS and FITS and back again, it will include a region on the HiPS image that is the footprint of the FITS images you had just loaded. A label appears at the center of that footprint, which may be disconcerting if you are not zoomed out enough to see the region itself. Here is an example, zoomed out so it is more clear what is going on:

The second drop-down menu looks like this.

There are three sections in this menu.

Orientation
Under "Orientation", you can control whether the coordinates are in Galactic or Equatorial J2000 (RA/Dec). This can be used in conjunction with the image readout and/or the coordinate layer button.
Center Galactic
If you select "Center Galactic", the HiPS image slews to put Galactic North up, the Galactic Center in the center of the field of view, and the Galactic Plane horizontally across your field of view. This is useful if you have been zooming or scrolling around to look at individual sources and need to bring it back to a familiar orientation quickly.
Projection
Under "Projection", you can control whether the display is in Spherical or Aitoff coordinates. Aitoff projection works better for all-sky displays.