Professional sky surveys, pixel-matched to our images
Survey Overlay fetches a professional sky survey for the exact field of a plate solved image and delivers it as a new image: either pixel-matched to ours, the same star on the same pixel, or as a wide context image that shows our field in its surroundings. We use it to tell real faint nebulosity from gradients, to see where the background is truly empty, and to look at our object in light our cameras do not record.
The sky has been mapped many times over, in light our cameras do not record and to depths a single night does not reach. The Planck and IRAS dust maps show galactic cirrus however faint it is in visible light; the H-alpha surveys trace ionized hydrogen across the whole sky; GALEX shows the ultraviolet, WISE and 2MASS the infrared, and the DSS, Pan-STARRS and the DESI Legacy Surveys give a deep optical view of almost any field. With one of them registered to our image, questions that usually take guesswork become a matter of looking: is that faint smudge real, or a gradient? Where is the background empty? What does this object look like in the infrared?
Survey Overlay needs two things: an image with an astrometric solution, and a connection to the Internet. It works out which piece of the sky the image covers, asks the hips2fits service of the CDS (the Strasbourg astronomical Data Center) for that piece of the survey we chose, and reprojects it through our image's own solution, distortion model included, so the survey follows our image into the corners. Our image is never changed: the survey always arrives as a new image.
Thirty four surveys are in its list, fifteen of them in color, and any other image survey published in the HiPS network can be fetched by typing its identifier.
RGB_Solved_DSS2_color for
RGB_Solved. Its screen stretch shows it at once; the Log says where the data came from.
The panel has three sections: Survey, which survey to fetch; Output, what to make of it; and Context image, the settings of the wide view, enabled only when Output asks for one. Then come the Preview box, the image the panel applies to and the buttons.
HiPS identifier: The survey, by the name it has in the HiPS network, the system professional
observatories use to publish their surveys: CDS/P/DSS2/red, say. List beside it offers the 34
surveys of Survey Overlay's own list (below); any other image survey can be typed, and the full catalog of several
hundred is at aladin.cds.unistra.fr/hips/list. A survey published only as color JPEG or PNG images gives
an RGB image. The default is CDS/P/DSS2/color.
Output: What Survey Overlay makes:
Rescale the survey values to [0,1]: A survey comes in its own units: megajanskys per steradian,
Rayleighs, counts, magnitudes of reddening, negative values included. On (the default), the lowest value in our field
becomes 0 and the highest 1, and the two are written to the new image's keywords, SVOLOW and
SVOHIGH, so the original units can always be recovered. Off, the values are stored exactly as the survey
gives them: the choice when we want to measure the survey, or work on its real values with Pixel Math. A context image
is always mapped to 0 to 1.
Automatic screen stretch: On (the default), the new image is shown with an automatic screen stretch, so the survey is visible at once; its pixels are not changed. A color survey is already stretched for the screen and gets none. For a context image of a single band survey, the stretch goes into the pixels instead: a screen stretch of the whole context would stretch our image a second time.
These settings apply only when Output is Context image.
Layers: How the context is delivered:
..._context), and our image alone, placed where it belongs, black around it
(..._context_image). They are meant to be combined later, in the Layers panel or with Pixel Math.
Opacity and Blend do not apply to them.Width: How much sky the context covers: 2 x the image (the default), 4 x, 8 x or 16 x the image, that many times the larger side of our image. The context stays 5000 pixels across, so a wider one shows the surroundings in less detail and our image smaller in it. A context can be up to 180 degrees across; a wider one is refused with a message to choose a narrower width.
Opacity: How much of our image shows over the survey, from 1 (the default), our image alone where it is, to 0, the survey alone.
Blend: How our image combines with the survey under it. Normal (the default) puts it on top as it is; the others are the usual blend modes of image editors, with the survey as the lower layer and our image as the upper one: Multiply, Screen, Overlay, Darken, Lighten, Subtract, Color Burn, Linear Burn, Color Dodge, Linear Dodge, Soft Light, Hard Light, Vivid Light, Linear Light, Pin Light, Difference, Exclusion and Divide.
Soft edge (px): A width, in pixels of the context image, over which our image fades in from its border, from 0 (the default, a hard edge) to 500. A soft edge makes the blends look natural, and gives the mask a gentle border.
Create a mask of the image: Also creates a mask the size of the context image
(..._context_mask): white where our image is, with the same soft edge, black on the survey. It separates the
two, to work on the survey or on our image alone.
Outline (px): A line just inside the border of our image, 1 to 10 pixels of the context image wide, to show exactly what our image covers; 0 (the default) draws none. The outline is amber. A saved process or a PixInsight icon may carry another color, which is kept and used; the panel has no control for it yet. With separate images, the outline goes on our image.
Preview: Shows what Apply would make in place of the image, without changing anything, on The visible area, on A region we draw with Draw Region, or on The whole image, which Apply then reuses. A preview never starts by itself, since the survey comes from the network: it runs when we click Preview, with Stop beside it. On a part of the image, the survey is fetched for that part's field alone, which is the quick way to look closely at one part of a large image.
Applies to: The image the panel works on: the image in front, or another open image picked in the list. A picked image stays the panel's while other images come to the front, and Follow Active beside the list goes back to following the image in front.
Apply: Fetches the survey and makes the new image or images. Our image is only read: no history step is made on it, and we can apply one survey after another to the same image, each giving its own new image. While it runs, the panel shows its progress and Cancel. The system bar along the bottom of the panel has Apply too, and drag to apply, the icon at its left: dragged onto any image window, it applies the panel's settings to that image.
Instance: Opens a window with the process as the panel has it now, as text, in DSPX's
format (.dsproc) or as a PixInsight process icon (.xpsm) that SurveyOverlay's PixInsight module
opens. Copy puts the text on the clipboard; Save... saves it as a file and puts it on the Process
Shelf.
Reset: Puts every setting back to its default.
The color surveys are pictures made for the screen: already stretched, with 8 bits per channel. They come back as an RGB image that is good to look at and to compare with ours, not data to measure.
| In the list | HiPS identifier | What it shows |
|---|---|---|
| Color: DSS2 | CDS/P/DSS2/color | Optical color from the red and blue plates of the Digitized Sky Survey. All sky. |
| Color: Mellinger optical | CDS/P/Mellinger/color | A true color panorama of the whole sky, at 36"/px: the one for very wide fields. |
| Color: Pan-STARRS DR1 (i, r, g) | CDS/P/PanSTARRS/DR1/color-i-r-g | Optical CCD color. North of declination −30°. |
| Color: DESI Legacy Surveys DR10 | CDS/P/DESI-Legacy-Surveys/DR10/color | Deep optical CCD color. About two thirds of the sky, away from the Milky Way. |
| Color: SDSS9 | CDS/P/SDSS9/color | Optical CCD color. About a third of the sky. |
| Color: Gaia DR3 flux map (Rp, G, Bp) | CDS/P/DM/flux-color-Rp-G-Bp/I/355/gaiadr3 |
The light of the Gaia stars shown as color, made from the catalog. All sky. |
| Color: GALEX ultraviolet | CDS/P/GALEXGR6_7/color | Far and near ultraviolet. Most of the sky away from the Milky Way. |
| Color: 2MASS (J, H, K) | CDS/P/2MASS/color | Near infrared. All sky. |
| Color: AllWISE (W4, W2, W1) | CDS/P/allWISE/color | Mid infrared. All sky. |
| Color: SPHEREx QR2 | CDS/P/SPHEREx/QR2/color | Near infrared from the SPHEREx all-sky survey. |
| Color: IRAS-IRIS (dust) | CDS/P/IRIS/color | Far infrared dust emission. All sky, 4' resolution. |
| Color: AKARI FIS (140, 90, 65 um) (dust) | CDS/P/AKARI/FIS/Color | Far infrared dust emission. All sky, about 1' resolution. |
| Color: Planck 353-545-857 GHz (dust) | CDS/P/PLANCK/R2/HFI/color | Cold dust. All sky, 5' resolution. |
| Color: LAB HI, Doppler colors (gas) | CAMRAS/P/LABHI/RGB | Neutral hydrogen, colored by its velocity along the line of sight. About 0.6° resolution. |
| Color: SkyMapper DR4 (i, r, g) | CDS/P/Skymapper/DR4/color | Optical CCD color. The southern sky. |
The single band surveys come back as a gray image that holds the survey's own values: the ones to use for anything beyond looking.
| In the list | HiPS identifier | What it shows |
|---|---|---|
| DSS2 Red, Blue, Near infrared | CDS/P/DSS2/red, blue, NIR |
The plates of the Digitized Sky Survey. All sky, about 1"/px. Photographic: not linear. |
| Pan-STARRS DR1 r | CDS/P/PanSTARRS/DR1/r | CCD, r band. North of declination −30°, 0.25"/px. |
| Planck 857 GHz, 545 GHz (dust) | CDS/P/PLANCK/R2/HFI857, HFI545 |
Thermal emission of cold dust: the reference for galactic cirrus. All sky, 5' resolution. |
| IRAS-IRIS 100 um (dust) | ov-gso/P/IRIS/4 | Far infrared dust emission. All sky, 4' resolution. |
| AKARI 90 um (dust) | CDS/P/AKARI/FIS/WideS | Far infrared dust emission. About 1' resolution. |
| WISE 12 um diffuse dust (WSSA) | CDS/P/WISE/WSSA/12um | Diffuse dust with the stars removed. 15" resolution. |
| AllWISE W3 (12 um) | CDS/P/allWISE/W3 | Mid infrared, stars included. 6.5" resolution. |
| E(B-V) reddening (SFD98) | ov-gso/P/EBV/SFD98 | The dust reddening map of Schlegel, Finkbeiner and Davis. 6' resolution. |
| HI4PI neutral hydrogen | CDS/P/HI4PI/NHI | Column density of atomic hydrogen. 16' resolution. |
| H-alpha composite (Finkbeiner) | CDS/P/Finkbeiner | The WHAM, VTSS and SHASSA surveys combined. All sky, 6' resolution. |
| SHASSA H-alpha; continuum subtracted | CDS/P/SHASSA/H, SM |
H-alpha of the southern sky, with the stars (about 1') or without them (4'). |
| WHAM H-alpha | ov-gso/P/WHAM | The faintest H-alpha emission. 1° resolution. |
| GALEX Near and Far ultraviolet | CDS/P/GALEXGR6_7/NUV, FUV | Away from the Milky Way, 4" to 5" resolution. |
| 2MASS K (2.16 um) | CDS/P/2MASS/K | Near infrared. All sky, 2" resolution. |
Coverage and resolution are each survey's own, given as a guide. Where a survey does not reach our field the new image is black, and the Log says how much of the image has no data.
A context image shows where our image sits on the sky, and what surrounds it. It is always 5000 by 5000 pixels, north up, centered on our image, and 2 to 16 times as wide as its larger side. Our image goes on top of the survey at its true place, size and rotation, placed there through its own astrometric solution, and as it is displayed: with its screen stretch, so a linear image looks in the context as it does on our screen. When the context has room for fewer pixels than our image has, our image is first reduced by averaging.
The context is a stereographic projection, which keeps the shapes of the sky and stretches it little toward the edges, so even a very wide context looks right. It carries an astrometric solution of its own, so the astrometric processes work on it as on any solved image, and keywords that say how it was made.
SVOSURV (the survey),
SVOLOW and SVOHIGH (the values stored as 0 and 1).The survey images it downloads are kept for a while in a folder of DSPX's own data, and a request that is the same as an earlier one (the same survey for the same field and size) uses the kept image instead of asking again. That makes trying the options of a context image quick: after the first download, a new blend, opacity, soft edge, outline or mask starts at once.
Is it real? A faint cloud in our background that also shows in a dust map is galactic cirrus, and deserves to be kept. One that the survey does not have is a gradient, a flat field residue or a reflection.
Before removing gradients. A dust or H-alpha map shows which parts of the field hold real signal and which are empty sky: what we need to know before we place background samples.
The overlay is as good as the solution. A solution with a distortion model matches from center to corners; one without it can be off by several pixels at the edges of a wide field.
Mind the survey's resolution. The dust and H-alpha maps have a resolution of arcminutes: on a wide field they show a wealth of structure, on a long focal length image only a smooth glow. The optical surveys, GALEX, 2MASS and WISE hold their detail on narrow fields.
Not every survey covers the whole sky. Pan-STARRS stops at declination −30°, SHASSA and SkyMapper are southern, GALEX and the DESI Legacy Surveys avoid the Milky Way. When a survey has nothing at all for our field, no image is made and the Log says so.
Large images, coarser surveys. A request is limited to 6000 pixels on a side, so a larger image gets the survey at a slightly coarser scale than its own. A preview of a region gets one part at full detail.
The values are the survey's. With the rescale on, a single bright star in the field sets the top of the range, so a single band survey can look almost black until it is stretched, which is what the automatic screen stretch is for. The DSS is photographic and not linear.
A survey is a reference, not a second exposure. Its resolution, depth and date differ from ours, and it has artifacts of its own: plate edges, satellite trails, ghosts around bright stars. What matters is the structure the two images share.
When the service is slow. hips2fits is shared by astronomers everywhere; it is sometimes slow and now and then down for a while. Survey Overlay tries a mirror before it gives up, and asking again a little later is usually all it takes.
Plate Solve: gives the image the astrometric solution Survey Overlay needs, from its stars alone.
Background Extraction: corrects gradients; a dust or H-alpha survey of the field shows where its samples belong.
Pixel Math: combines the survey with our image pixel by pixel, which the pixel-matched image makes direct. The Layers panel blends them as layers.
Photometric Glow Subtraction and Catalog Star Color: the other processes that work through the image's astrometric solution.