diff --git a/toc.yml b/toc.yml index 4d272219..a04b0f73 100644 --- a/toc.yml +++ b/toc.yml @@ -4,10 +4,14 @@ project: - title: IRSA Tutorials file: index.md - title: SPHEREx + file: tutorials/spherex/spherex.md children: - - file: tutorials/spherex/spherex_intro.md - - file: tutorials/spherex/spherex_cutouts.md - - file: tutorials/spherex/spherex_psf.md + - title: Data Overview + file: tutorials/spherex/spherex_intro.md + - title: Spectral Image Cutouts + file: tutorials/spherex/spherex_cutouts.md + - title: PSF Models + file: tutorials/spherex/spherex_psf.md - title: Euclid file: tutorials/euclid_access/euclid.md children: @@ -32,16 +36,18 @@ project: - title: ERO Star Clusters file: tutorials/euclid_access/Euclid_ERO.md - title: WISE + file: tutorials/wise.md children: - - title: AllWISE - children: - - file: tutorials/irsa-sia-examples/sia_allwise_atlas.md - - file: tutorials/parquet-catalog-demos/wise-allwise-catalog-demo.md - - title: NEOWISE - children: - - file: tutorials/firefly/NEOWISE_light_curve_demo.md - - file: tutorials/parquet-catalog-demos/neowise-source-table-strategies.md - - file: tutorials/parquet-catalog-demos/neowise-source-table-lightcurves.md + - title: ALLWISE Images + file: tutorials/irsa-sia-examples/sia_allwise_atlas.md + - title: ALLWISE Catalog + file: tutorials/parquet-catalog-demos/wise-allwise-catalog-demo.md + - title: NEOWISE visualization + file: tutorials/firefly/NEOWISE_light_curve_demo.md + - title: NEOWISE source table + file: tutorials/parquet-catalog-demos/neowise-source-table-strategies.md + - title: NEOWISE source table light curves + file: tutorials/parquet-catalog-demos/neowise-source-table-lightcurves.md - title: Spitzer children: - file: tutorials/irsa-sia-examples/siav2_seip.md @@ -52,21 +58,26 @@ project: children: - file: tutorials/irsa-sia-examples/sia_cosmos.md - title: Simulated Data + file: tutorials/simulated.md children: - - title: Roman HLSS Galaxy Mock Catalog - children: - - file: tutorials/roman_simulations/roman_hlss_number_density.md - - title: OpenUniverse 2024 - children: - - file: tutorials/openuniversesims/openuniverse2024_roman_simulated_wideareasurvey.md - - file: tutorials/firefly/OpenUniverse2024Preview_Firefly.md - - file: tutorials/openuniversesims/openuniverse2024_roman_simulated_timedomainsurvey.md - - title: CosmoDC2 - children: - - file: tutorials/cosmodc2/cosmoDC2_TAP_access.md - - title: Special Topics + - title: Roman HLSS Number Density + file: tutorials/roman_simulations/roman_hlss_number_density.md + - title: OpenUniverse2024 Roman coadds + file: tutorials/openuniversesims/openuniverse2024_roman_simulated_wideareasurvey.md + - title: OpenUniverse2024 Visualization + file: tutorials/firefly/OpenUniverse2024Preview_Firefly.md + - title: OpenUniverse2024 Time Domain + file: tutorials/openuniversesims/openuniverse2024_roman_simulated_timedomainsurvey.md + - title: CosmoDC2 Data Access + file: tutorials/cosmodc2/cosmoDC2_TAP_access.md + - title: Techniques & Tools + file: tutorials/techniques.md children: - - file: tutorials/cloud_access/cloud-access-intro.md - - file: tutorials/parquet-catalog-demos/irsa-hats-with-lsdb.md - - file: tutorials/firefly/SEDs_in_Firefly.md - - file: tutorials/parallelize/Parallelize_Convolution.md + - title: Cloud Access + file: tutorials/cloud_access/cloud-access-intro.md + - title: LSDB HATS + file: tutorials/parquet-catalog-demos/irsa-hats-with-lsdb.md + - title: SED visualization + file: tutorials/firefly/SEDs_in_Firefly.md + - title: Parallelization + file: tutorials/parallelize/Parallelize_Convolution.md diff --git a/tox.ini b/tox.ini index 867a9232..6462ab3c 100644 --- a/tox.ini +++ b/tox.ini @@ -87,7 +87,7 @@ commands = buildhtml: bash -c "echo 'Notebooks ignored (not tested/executed) in this job:\n'; cat ignore_execute" # Using srtict so we fail with trackbacks and debug mode to have a richer log - buildhtml: bash -c "jupyter-book build --execute --html --strict -d" + buildhtml: bash -c "jupyter-book build --html --strict -d" pip_pre = predeps: true diff --git a/tutorials/simulated.md b/tutorials/simulated.md new file mode 100644 index 00000000..cae88965 --- /dev/null +++ b/tutorials/simulated.md @@ -0,0 +1,15 @@ +# Simulated Data Tutorial Notebooks + +IRSA hosts a diverse collection of simulated astronomical datasets spanning multiple missions and science domains; designed to support survey planning, algorithm development, and scientific exploration. +Because this collection is heterogeneous in coverage, structure, and intended use, simulated products are released with detailed documentation and tailored access methods. +These tutorials are designed to help users get started with accessing, visualizing, and analyzing simulated datasets hosted at IRSA. + +- [Roman HLSS Number Density](roman_simulations/roman_hlss_number_density.md) - Illustrates how to query the catalog and derive galaxy number density. + +- [OpenUniverse2024 Roman coadds](openuniversesims/openuniverse2024_roman_simulated_wideareasurvey.md) - Accesses OpenUniverse2024 wide-area simulated survey data. + +- [OpenUniverse2024 Visualization](firefly/OpenUniverse2024Preview_Firefly.md) - Uses Firefly to get an overview of survey structure and visualize content. + +- [OpenUniverse2024 Time Domain](openuniversesims/openuniverse2024_roman_simulated_timedomainsurvey.md) - Demonstrates how to access and analyze time-domain survey. + +- [CosmoDC2 Data Access](cosmodc2/cosmoDC2_TAP_access.md) - Demonstrates how to access, query, and visualize the catalog. \ No newline at end of file diff --git a/tutorials/spherex/spherex.md b/tutorials/spherex/spherex.md new file mode 100644 index 00000000..1fee456a --- /dev/null +++ b/tutorials/spherex/spherex.md @@ -0,0 +1,13 @@ +# Spherex Tutorial Notebooks +SPHEREx (Spectro-Photometer for the History of the Universe, Epoch of Reionization, and Ices Explorer) is a NASA space mission designed to perform the first all-sky spectral survey in the near-infrared. +SPHEREx observes the sky from roughly 0.75–5.0 µm using a single instrument that provides low-resolution spectroscopy (R ≈ 40–150) in hundreds of spectral channels for every point on the sky. +Its science goals span cosmology, galaxy evolution, and the interstellar medium, enabling measurements of large-scale structure, the cosmic history of star formation, and the distribution of key molecules and ices in the Milky Way and nearby galaxies. + +SPHEREx IRSA data releases include weekly [Quick Release spectral image products](https://caltech-ipac.github.io/spherex-archive-documentation/spherex-data-products/) (multi-extension FITS files containing calibrated near-infrared surface brightness, variance, flags, modeled backgrounds, PSFs, and wavelength WCS) along with ancillary calibration and metadata files such as gain matrices, dark current maps, solid angle pixel maps, and detailed spectral WCS products for each detector. + +- [Data Overview](spherex_intro.md) - Introduces available data including how to identify which files and formats are appropriate for different use cases. + +- [Spectral Image Cutouts](spherex_cutouts.md) - Demonstrates how to generate and work with spatial and spectral cutouts. + +- [PSF Models](spherex_psf.md) - Explains how SPHEREx point spread function (PSF) information is organized and accessed. + diff --git a/tutorials/techniques.md b/tutorials/techniques.md new file mode 100644 index 00000000..c3074309 --- /dev/null +++ b/tutorials/techniques.md @@ -0,0 +1,12 @@ +# Techniques & Tools Tutorial Notebooks + +This section gathers tutorials that go beyond mission specific data access and analysis to explore broader methods, workflows, and utilities applicable across missions and datasets. +This collection includes guidance on cloud-based data access, use of powerful big data tools such as lsdb, interactive visualization tools, and computational techniques like parallel image convolution. + +- [Cloud Access](cloud_access/cloud-access-intro.md) — Introduces how to access and work with data served by IRSA from AWS S3 cloud storage. + +- [LSDB HATS](parquet-catalog-demos/irsa-hats-with-lsdb.md) - Uses LSDB and HATs framework for advanced cross-matching and query strategies + +- [SED visualization](firefly/SEDs_in_Firefly.md) - Demonstrates how to explore and interactively visualize SEDs using Firefly on multi-wavelength datasets. + +- [Parallelization](parallelize/Parallelize_Convolution.md) - Demonstrates parallelization techniques to speed up operations on large astronomical images. \ No newline at end of file diff --git a/tutorials/wise.md b/tutorials/wise.md new file mode 100644 index 00000000..da828c80 --- /dev/null +++ b/tutorials/wise.md @@ -0,0 +1,18 @@ +# WISE Tutorial Notebooks + +The Wide-field Infrared Survey Explorer ([WISE](https://irsa.ipac.caltech.edu/Missions/wise.html)) is a NASA infrared space telescope launched in December 2009 that performed a sensitive all-sky survey at 3.4, 4.6, 12, and 22 µm, cataloging hundreds of millions of stars, galaxies, and Solar System objects and enabling discoveries of cool brown dwarfs and luminous infrared galaxies. +After exhausting its cryogen, the mission was repurposed as NEOWISE in 2013 to detect and characterize near-Earth asteroids and comets using the remaining infrared channels. + + +WISE and NEOWISE data are released publicly through the NASA/IPAC Infrared Science Archive (IRSA), including calibrated images, source catalogs, and single-exposure source tables that together enable multi-epoch photometry, light curves, and motion studies for a wide range of astrophysical and Solar System applications. +Successive NEOWISE data releases (with annual updates) provide users with increasingly deep coverage and time-domain information across the infrared sky. + +- [ALLWISE Images](irsa-sia-examples/sia_allwise_atlas.md) - Retrieves coadded images and makes coordinate-based cutouts. + +- [ALLWISE Catalog](parquet-catalog-demos/wise-allwise-catalog-demo.md) - Explores mid-infrared source properties by querying, filtering, and working with the catalog. + +- [NEOWISE visualization](firefly/NEOWISE_light_curve_demo.md) - Visualizes and analyzes light curves of Solar System objects using Firefly. + +- [NEOWISE source table](parquet-catalog-demos/neowise-source-table-strategies.md) - Outlines efficient strategies for accessing and handling large tables + +- [NEOWISE source table light curves](parquet-catalog-demos/neowise-source-table-lightcurves.md) - Builds multi-epoch photometric light curves for given coordinates. \ No newline at end of file