Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion tutorials/euclid/1_Euclid_intro_MER_images.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,8 @@ MER (the Merge processing function of the Euclid ground segment) combines the VI
The mosaics are created from images taken with the Euclid instruments (VIS and NISP), as well as a variety of ground-based surveys (DES, CFIS, Pan-STARRS, and HSC-based surveys) that provide the u, g, r, i, and z bands.
All of the mosaics have been created according to a uniform tiling on the sky, and mapped to a common pixel scale of 0.1 arcsec.
The MER processing for DR1 is described in detail in Euclid Collaboration: Kümmel et al. (2026), see the [References](#references) section below.
The release as a whole is described in Euclid Collaboration: Aussel et al. (2026) and the surveys it covers in Euclid Collaboration: Tereno et al. (2026).
The VIS, NISP, and ground-based images that go into the mosaics are described in Euclid Collaboration: McCracken et al. (2026), Polenta et al. (2026), and Corcho-Caballero et al. (2026), respectively.
This notebook provides a quick introduction to accessing MER mosaics from IRSA.
If you have questions about it, please contact the [IRSA helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html).

Expand Down Expand Up @@ -529,7 +531,12 @@ for i in range(len(sources_thr)):

<!-- TODO: update the Kümmel et al. reference (journal, volume, arXiv ID) and verify the DR1 DOI once the paper and DR1 are public. -->

- Euclid Collaboration: Kümmel, M., et al. 2026, *Euclid Data Release (DR1): The MERge processing*, A&A, in prep.
- Euclid Collaboration: Kümmel, M., et al. 2026, *Euclid Data Release 1 (DR1): The MERge processing*, A&A, in prep.
- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)
- Euclid Collaboration: Tereno et al. 2026, *Euclid Data Release 1 (DR1): The Euclid surveys at DR1*, [arXiv:2611.17040](https://arxiv.org/abs/2611.17040)
- Euclid Collaboration: McCracken et al. 2026, *Euclid Data Release 1 (DR1): VIS processing and data products*, [arXiv:2611.15890](https://arxiv.org/abs/2611.15890)
- Euclid Collaboration: Polenta et al. 2026, *Euclid Data Release 1 (DR1): Near-infrared processing and data products*, [arXiv:2611.16119](https://arxiv.org/abs/2611.16119)
- Euclid Collaboration: Corcho-Caballero et al. 2026, *Euclid Data Release 1 (DR1): Colouring Euclid with external ground-based imaging data*, [arXiv:2611.16533](https://arxiv.org/abs/2611.16533)
- Euclid Collaboration: Romelli, E., Kümmel, M., Dole, H., et al. 2026, A&A, 711, A4 (the Q1 MER processing)
- Euclid Data Release 1, 2026, [doi:10.57780/esa-d079c51](https://doi.org/10.57780/esa-d079c51)

Expand Down
14 changes: 11 additions & 3 deletions tutorials/euclid/2_Euclid_intro_MER_catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ The MER processing detects sources on the VIS and NISP mosaics (see the [MER mos
This notebook provides an introduction to the MER final catalog, in which each entry is a single source.
In this notebook we follow a typical path through the MER catalog: we search for the sources around a position on the sky, clean the sample with the quality columns, select the stars, look at the spectral energy distributions and VIS images of a few of them, and finally make a color-color diagram of many stars.
The MER processing for DR1 is described in detail in Euclid Collaboration: Kümmel et al. (2026), see the [References](#references) section below.
The release as a whole is described in Euclid Collaboration: Aussel et al. (2026) and the surveys it covers in Euclid Collaboration: Tereno et al. (2026).
If you have questions about this notebook, please contact the [IRSA helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html).

+++
Expand Down Expand Up @@ -273,7 +274,7 @@ print(len(stars))
### Total fluxes in the Euclid and ground-based bands

Besides the Euclid VIS, Y, J, and H bands, the MER catalog contains photometry measured on ground-based images in the u, g, r, i, and z bands.
Which ground-based surveys are available depends on the position on the sky, for example DECam in the south, or a combination of MegaCam, HSC, and Pan-STARRS in the north.
Which ground-based surveys are available depends on the position on the sky, for example DECam in the south, or a combination of MegaCam, HSC, and Pan-STARRS in the north (Euclid Collaboration: Corcho-Caballero et al. 2026).
The catalog therefore has columns for all of the possible survey and band combinations, named `flux_<band>_ext_<survey>_...`, and only some of them are filled at a given position.
Let's check which ground-based bands have measurements for our stars.

Expand Down Expand Up @@ -461,7 +462,8 @@ The ground-based g - r color, which also traces temperature, changes smoothly al

## Notes on the DR1 MER photometry

Kümmel et al. (2026) describe the DR1 MER photometry and its known limitations in detail.
Kümmel et al. (2026) describe the DR1 MER photometry and its known limitations in detail, and Euclid Collaboration: Gasparetto et al. (2026) validate the multi-band photometry on extragalactic sources in the COSMOS field.
The processing and calibration of the NISP images are described in Euclid Collaboration: Polenta et al. (2026), and the photometric masks of DR1 in Euclid Collaboration: Odier et al. (2026).
The most important points for using the catalog are:

* **NIR calibration offsets**: the Euclid Y, J, and H fluxes have offsets of a few to about 13 percent with respect to Gaia, depending on the photometric method. The offsets are similar in the three bands, so NIR colors are more reliable than absolute NIR magnitudes.
Expand All @@ -480,7 +482,13 @@ Colors measured with aperture (A-PHOT) or template-fitting (T-PHOT) photometry a

<!-- TODO: update the Kümmel et al. reference (journal, volume, arXiv ID) and verify the DR1 DOI once the paper and DR1 are public. -->

- Euclid Collaboration: Kümmel, M., et al. 2026, *Euclid Data Release (DR1): The MERge processing*, A&A, in prep.
- Euclid Collaboration: Kümmel, M., et al. 2026, *Euclid Data Release 1 (DR1): The MERge processing*, A&A, in prep.
- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)
- Euclid Collaboration: Tereno et al. 2026, *Euclid Data Release 1 (DR1): The Euclid surveys at DR1*, [arXiv:2611.17040](https://arxiv.org/abs/2611.17040)
- Euclid Collaboration: Polenta et al. 2026, *Euclid Data Release 1 (DR1): Near-infrared processing and data products*, [arXiv:2611.16119](https://arxiv.org/abs/2611.16119)
- Euclid Collaboration: Corcho-Caballero et al. 2026, *Euclid Data Release 1 (DR1): Colouring Euclid with external ground-based imaging data*, [arXiv:2611.16533](https://arxiv.org/abs/2611.16533)
- Euclid Collaboration: Gasparetto et al. 2026, *Euclid Data Release 1 (DR1): Multi-band photometry validation on COSMOS extragalactic sources*, [arXiv:2611.16825](https://arxiv.org/abs/2611.16825)
- Euclid Collaboration: Odier et al. 2026, *Euclid Data Release 1 (DR1): Euclid photometric masks*, [arXiv:2611.16602](https://arxiv.org/abs/2611.16602)
- Euclid Collaboration: Romelli, E., Kümmel, M., Dole, H., et al. 2026, A&A, 711, A4 (the Q1 MER processing)
- Euclid Data Release 1, 2026, [doi:10.57780/esa-d079c51](https://doi.org/10.57780/esa-d079c51)

Expand Down
8 changes: 5 additions & 3 deletions tutorials/euclid/3_Euclid_intro_1D_spectra.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,10 +53,10 @@ These data are archived by multiple global repositories, including IRSA, where t

Euclid Data Release 1 (DR1) comprises about 1900 sq deg of imaging, spectroscopy, and catalogs from the Euclid Wide Survey (EWS), which will eventually cover about 14,000 sq deg, and from the Euclid Deep Survey (EDS), which covers about 53 sq deg in the three Euclid Deep Fields (North, South, and Fornax).
It follows Quick Release 1 (Q1), which covered about 63 sq deg with a single pass over each of the three Euclid Deep Fields and the dark cloud LDN 1641; all of the DR1 data, including the areas observed in Q1, have been reprocessed with updated pipelines and calibrations.
Further information about Euclid DR1 can be found at https://euclid.caltech.edu/page/euclid-dr1.
Further information about Euclid DR1 can be found at https://euclid.caltech.edu/page/euclid-dr1 and in the release overview paper, Euclid Collaboration: Aussel et al. (2026).

Among the data products included in DR1 are the one-dimensional (1D) spectra extracted from the NISP slitless spectroscopic observations by the SIR (Spectroscopic Imaging Reduction) processing function.
The SIR processing for DR1 is described in detail in Euclid Collaboration: Scodeggio et al. (2026), see the [References](#references) section below.
The SIR processing for DR1 is described in detail in Euclid Collaboration: Scodeggio et al. (2026), and the spectroscopic calibration in Euclid Collaboration: Fumana et al. (2026); see the [References](#references) section below.
This notebook provides an introduction to the Euclid DR1 SIR 1D spectra.
If you have questions about it, please contact the [IRSA helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html).

Expand Down Expand Up @@ -432,7 +432,7 @@ plot_spectra(best, f'Euclid SIR 1D spectra of object {object_id}', redshift)

```{note}
The blue and red grism spectra of a galaxy can have different continuum levels where they overlap (about 1.2 to 1.37 micron), sometimes by a factor of two or more, and the blue grism spectra can have spikes and other artifacts that are not flagged in the MASK column.
This is a limitation of the DR1 spectra, not a problem with how they are read in here: see Scodeggio et al. (2026) and the [Euclid DR1 documentation](https://euclid.caltech.edu/page/euclid-dr1) for the details.
This is a limitation of the DR1 spectra, not a problem with how they are read in here: see Scodeggio et al. (2026), Fumana et al. (2026), and the [Euclid DR1 documentation](https://euclid.caltech.edu/page/euclid-dr1) for the details.
```

## 6. Select galaxies and explore their spectra
Expand Down Expand Up @@ -521,6 +521,8 @@ for random_galaxy in galaxies[rng.choice(len(galaxies), size=min(n_galaxies, len
<!-- TODO: update the Scodeggio et al. reference (journal, volume, arXiv ID) once the paper is public. -->

- Euclid Collaboration: Scodeggio, M., Copin, Y., et al. 2026, *Euclid Data Release 1 (DR1): From spectrograms to spectra: The SIR spectroscopic processing function*, A&A, in prep.
- Euclid Collaboration: Fumana et al. 2026, *Euclid Data Release 1 (DR1): SIR spectroscopic calibration*, [arXiv:2611.17305](https://arxiv.org/abs/2611.17305)
- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)

+++

Expand Down
8 changes: 4 additions & 4 deletions tutorials/euclid/4_Euclid_intro_PHZ_catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,7 @@ In DR1, the photometric redshifts are measured with a nearest-neighbour method (
This notebook provides an introduction to the main PHZ catalog, which contains the photometric redshift probability distribution, the unified fluxes, and the classification for each source.
We follow a typical path through the catalog: we select galaxies with good photometric redshifts in a redshift range, look at them on a MER mosaic, and compare the photometric redshift of one of them with its spectrum and spectroscopic redshift.
The PHZ processing for DR1 is described in detail in Euclid Collaboration: Hartley et al. (2026), and the galaxy physical properties it also provides in Euclid Collaboration: Enia et al. (2026); see the [References](#references) section below.
The release as a whole is described in Euclid Collaboration: Aussel et al. (2026).
If you have questions about this notebook, please contact the [IRSA helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html).

+++
Expand Down Expand Up @@ -585,10 +586,9 @@ fc.show_table(tbl_stream)

## References

<!-- TODO: update the Hartley et al. and Enia et al. references (journal, volume, arXiv ID) once the papers are public. -->

- Euclid Collaboration: Hartley, W., Paltani, S., Dubath, F., et al. 2026, *Euclid Data Release 1 (DR1): Photometric-redshift pipeline overview and validation*, A&A, in prep.
- Euclid Collaboration: Enia, A., Hartley, W. G., Bolzonella, M., et al. 2026, *Euclid Data Release 1 (DR1): The PHZ processing function for the physical properties of galaxies*, A&A, in prep.
- Euclid Collaboration: Hartley, W., Paltani, S., Dubath, F., et al. 2026, *Euclid Data Release 1 (DR1): Photometric-redshift pipeline overview and validation*, [arXiv:2611.15987](https://arxiv.org/abs/2611.15987)
- Euclid Collaboration: Enia, A., Hartley, W. G., Bolzonella, M., et al. 2026, *Euclid Data Release 1 (DR1): The PHZ processing function for the physical properties of galaxies*, [arXiv:2611.16444](https://arxiv.org/abs/2611.16444)
- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)
- Euclid Collaboration: Tucci, M., Paltani, S., Hartley, W. G., et al. 2026, A&A, 711, A5, which describes the PHZ processing of Q1.

+++
Expand Down
12 changes: 9 additions & 3 deletions tutorials/euclid/5_Euclid_intro_SPE_catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,10 +51,13 @@ The primary science goals of Euclid are to better understand the composition and
The Euclid mission provides space-based imaging and spectroscopy, complemented by ground-based imaging, to achieve these goals.
These data will be archived by multiple global repositories, including IRSA, where they will support a wide range of astrophysical research.

Euclid Data Release 1 (DR1) will include imaging, spectroscopy, and catalogs covering approximately 1,900 square degrees of the Euclid Wide Survey, along with observations of the Euclid Deep Fields. Further information about Euclid DR1 can be found at: https://euclid.caltech.edu/page/euclid-dr1
Euclid Data Release 1 (DR1) will include imaging, spectroscopy, and catalogs covering approximately 1,900 square degrees of the Euclid Wide Survey, along with observations of the Euclid Deep Fields. Further information about Euclid DR1 can be found at https://euclid.caltech.edu/page/euclid-dr1 and in the release overview paper, Euclid Collaboration: Aussel et al. (2026).

Among the DR1 data products are multiple spectroscopic catalogs produced by the Spectroscopic Analysis (SPE) Processing Function, including spectroscopic redshifts, emission-line measurements, and other derived spectral properties.

The SPE measurements for DR1 are described in Euclid Collaboration: Le Brun et al. (2026), see the [References](#references) section below.
For an example of what can be done with the emission lines in the NISP spectra beyond these catalogs, see the emission-line maps of Gabarra et al. (2026).

This notebook provides an introduction to the Euclid DR1 SPE catalogs.
If you have questions about this notebook, please contact the [IRSA helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html).

Expand Down Expand Up @@ -757,7 +760,7 @@ Where the Hα line falls in both grisms (1.21 to 1.37 micron), it is seen at the

```{note}
The blue and red grism spectra of a galaxy can have different continuum levels where they overlap (1.21 to 1.37 micron), sometimes by a factor of two or more, and the blue grism spectra can have spikes and other artifacts that are not flagged in the MASK column.
This is a limitation of the DR1 spectra, not a problem with how they are read in here: see Scodeggio et al. (2026) and the [Euclid DR1 documentation](https://euclid.caltech.edu/page/euclid-dr1) for the details.
This is a limitation of the DR1 spectra, not a problem with how they are read in here: see Scodeggio et al. (2026), Fumana et al. (2026), and the [Euclid DR1 documentation](https://euclid.caltech.edu/page/euclid-dr1) for the details.
```

### 5.2 Galaxies failing one of the criteria
Expand Down Expand Up @@ -834,10 +837,13 @@ Which grism a line falls in depends on the redshift. In the Euclid Deep Fields,

## References

- Euclid Collaboration: Le Brun, V., Moresco, M., Bethermin, M., et al. 2026, *Euclid Data Release 1 (DR1): Performances of the redshift measurement and spectroscopic analysis*
- Euclid Collaboration: Le Brun, V., Moresco, M., Bethermin, M., et al. 2026, *Euclid Data Release 1 (DR1): Performance of the redshift measurement and spectroscopic analysis*, A&A, in prep.
<!-- TODO: add the link to the DR1 SPE paper once it is public. -->
<!-- TODO: update the Scodeggio et al. reference (journal, volume, arXiv ID) once the paper is public. -->
- Euclid Collaboration: Scodeggio, M., Copin, Y., et al. 2026, *Euclid Data Release 1 (DR1): From spectrograms to spectra: The SIR spectroscopic processing function*, A&A, in prep.
- Euclid Collaboration: Fumana et al. 2026, *Euclid Data Release 1 (DR1): SIR spectroscopic calibration*, [arXiv:2611.17305](https://arxiv.org/abs/2611.17305)
- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)
- Gabarra et al. 2026, *Euclid: Data Release 1 (DR1) -- First NISP emission-line maps: Methodology, validation, and applications to galaxy evolution*, [arXiv:2611.16504](https://arxiv.org/abs/2611.16504)
- Euclid Collaboration: Le Brun, V., Bethermin, M., Moresco, M., et al. 2026, A&A, 711, A7, *Euclid Quick Data Release (Q1): Characteristics and limitations of the spectroscopic measurements*, [arXiv:2503.15308](https://arxiv.org/abs/2503.15308)
- [Euclid DR1 SPE output catalog data product description](http://st-dm.pages.euclid-sgs.uk/data-product-doc/dmdr1/spedpd/dpcards/spe_spepfoutputcatalog.html), which describes the columns of the SPE catalogs and the line quality flags

Expand Down
6 changes: 6 additions & 0 deletions tutorials/euclid/euclid-cloud-access.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ These data will be archived by multiple global repositories, including IRSA, whe

Euclid Data Release 1 (DR1) comprises about 1900 sq deg of imaging, spectroscopy, and catalogs from the Euclid Wide Survey (EWS) and from the Euclid Deep Survey (EDS), which covers about 53 sq deg in the three Euclid Deep Fields (North, South, and Fornax).
It follows Quick Release 1 (Q1); all of the DR1 data, including the areas observed in Q1, have been reprocessed with updated pipelines and calibrations.
The release is described in Euclid Collaboration: Aussel et al. (2026) and the surveys it covers in Euclid Collaboration: Tereno et al. (2026); see the [References](#references) section below.

IRSA maintains copies of the Euclid DR1 data products on the cloud via Amazon Web Services (AWS).
This notebook provides an introduction to accessing Euclid DR1 data from the cloud.
Expand Down Expand Up @@ -339,6 +340,11 @@ plt.ylabel(spec_tbl['SIGNAL'].unit.to_string('latex_inline'))
plt.title(f'Spectrum of Target: {target_name}\n(Euclid Object ID: {object_id})');
```

## References

- Euclid Collaboration: Aussel et al. 2026, *Euclid Data Release 1 (DR1): Data release overview*, [arXiv:2611.16510](https://arxiv.org/abs/2611.16510)
- Euclid Collaboration: Tereno et al. 2026, *Euclid Data Release 1 (DR1): The Euclid surveys at DR1*, [arXiv:2611.17040](https://arxiv.org/abs/2611.17040)

## About this Notebook

**Updated:** 2026-11-12
Expand Down
1 change: 1 addition & 0 deletions tutorials/euclid/euclid.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ It carries two instruments: the VISible instrument (VIS) and the Near-Infrared S
Data products include MERged mosaics of calibrated and stacked frames; combined infrared spectra (SIR); and catalogs of MER objects, photometric redshifts and classifications (PHZ), and spectroscopic redshifts and line measurements (SPE).

Data Release 1 (DR1) comprises about 1900 square degrees of imaging, spectroscopy, and catalogs from the Euclid Wide Survey and the Euclid Deep Survey, reprocessed with updated pipelines and calibrations, including the Q1 areas.
The release is described in [Euclid Collaboration: Aussel et al. (2026)](https://arxiv.org/abs/2611.16510).
The notebooks below are being updated from Q1 to DR1; the title of each notebook says which release it uses.

Data products include:
Expand Down
Loading
Loading