Adds demo notebooks

%% Cell type:markdown id:a737c50d-9836-409d-94a9-79fc98641a02 tags:

# AGILE DR1 (Viitanen et al., in prep.)

AGILE: AGN in the LSST era (Viitanen et al., in prep.) is an end-to-end

simulation pipeline and part of the official LSST INAF in-kind contribution.

AGILE is designed to allow for the characterization of the AGN population as

seen by Rubin-LSST. The pipeline starts with the creation of an empirical truth

catalog of AGN, galaxies, and stars. Using variability recipes for AGN and

stars, the truth catalog is then fed to the image simulator (imSim), capable of

generating raw images from the LSSTCam. Finally, the resulting raw images are

analyzed using the official science pipelines.

The first data release of AGILE corresponds to $1\,{\rm deg}^2$ (21 LSSTCam

detectors) and 3 years of LSST survey in the COSMOS (150.117, +2.205)

deep-drilling field. The underlying truth catalog has an area of 24 deg2, and

extends to $0.2 < z < 5.5$ and host galaxy mass $\log(M/M_\odot) > 8.5$.

The survey baseline is based on baseline v4.0. However, to optimize lightcurve

cadence over depth, we prune the observation sequence by selecting only the

first exposure of each sequence. The total number of visits is $1\,441$.

The LSST Science Pipelines (version 8.0.0) are run on the simulated raw images

in order to produce single-visit calibrated exposures and source catalogs.

Then, the single-visit images are combined to produce the coadded image and

object catalogs. Finally, forced photometry is performed on the single-visit

images based on the object catalog.

With respect to the LSST data product, the AGILE data model follow closely that

of DP0.2 (https://dp0-2.lsst.io/data-products-dp0-2/index.html). LSST Butler

may be used to access both images and catalog. For the access of catalogs we

also provide a sqlite3 database which mimics the functionality and schema of

the TAP service in DP0.2 / DP1.

%% Cell type:markdown id:85b8bc23-e64e-4d0f-bcd8-5e27d4def1a7 tags:

## Demonstration notebooks

We provide the following notebooks demonstrating the usage of AGILE DR1:

- [agile_truth.ipynb](agile_truth.ipynb): explore the underlying truth catalog

- [agile_sed.ipynb](agile_sed.ipynb): explore the measured and truth SEDs

- [agile_lightcurve.ipynb](agile_lightcurve.ipynb): explore the measured forced photometry and truth lightcurves

- [agile_images.ipynb](agile_images.ipynb): explore simulated single-visit and deep coadded images

- [agile_compare_dp1.ipynb](agile_compare_dp1.ipynb): compare AGILE DR1 to DP1 ECDFS

The full AGILE DR1 (incl. catalogs, images, SEDs, lightcurves) is hosted in the

Naples ADHOC cluster. Here, a small subset of the available data is provided

for demonstration purposes.

%% Cell type:markdown id:342ae9fd-3da9-4578-abbf-c44af0573133 tags:

## Requirements for running the notebooks

0. download the demo repository

1. download the AGILE master database file 'master.db' (large file, ~128G)

2. install the python requirements from 'requirements.txt'

3. (required only for using LSST butler) install the LSST Science Pipelines (https://pipelines.lsst.io/#installation)

%% Cell type:markdown id:a2b3ce63-c6d4-4b9b-995b-d73a1feccb37 tags:

## Contact:

- Angela Bongiorno (angela.bongiorno@inaf.it, INAF-OAR)

- Akke Viitanen (akke.viitanen@inaf.it, INAF-OAR, Univ. Geneva)

- Ivano Saccheo (ivano.saccheo@inaf.it, INAF-OAR, Univ. Bristol)

Created by AV on 2025/07/09

%% Cell type:code id:24014b1e-6d87-4234-8b95-0d49a9a7b9f0 tags:

``` python

```