add AGILE DR1 page

AGILE DR1

=========

The AGILE DR1 dataset is described here:

https://www.oa-roma.inaf.it/lsst-agn/2026/02/04/the-agile-first-data-release-dr1/

The AGILE DR1 dataset is available here:

https://drive.google.com/drive/u/0/folders/1xxaBrTamUZ5U3ncuG5VtkEIiF76UCghK

What is contained in the AGILE DR1 dataset

------------------------------------------

master.db: catalogs

^^^^^^^^^^^^^^^^^^^

We provide the whole DR1 (catalog) dataset as a single database which we refer

to as `master.db`. It is a sqlite3 file and contains the following tables:

    - CcdVisit      -- Information about CCDs of LSST visits

    - MatchesTruth  -- Matches between the `Object` and `Truth` tables

    - Source        -- Detections from single visits

    - Visit         -- Information about LSST visits

    - ForcedSource  -- Forced photometry on coadded image detections

    - Object        -- Coadded image detections

    - Truth         -- The AGILE truth catalog

The schema of each table follows closely that of DP0.2: (see here

https://dp0-2.lsst.io/data-products-dp0-2/index.html and here

https://dp0-2.lsst.io/data-products-dp0-2/index.html#id3).

To access the tables, you can use `sqlite3` (https://sqlite.org/cli.html) or

the python3 package `sqlite3` (https://docs.python.org/3/library/sqlite3.html)

together with `pandas` (https://pandas.pydata.org/). For example, to retrieve

the first 10 rows of the `Object` table, one could use:

::

    # sh

    sqlite3 master.db 'SELECT * FROM Object LIMIT 10'

Or alternatively in python

::

    # python

    import sqlite3

    import pandas as pd

    with sqlite3.connect("master.db") as con:

        df = pd.read_sql_query("SELECT * FROM Object LIMIT 10", con)

repo_public: images and catalogs

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

`repo_public` is a `butler` repository

(https://pipelines.lsst.io/modules/lsst.daf.butler/index.html) containing the

AGILE DR1 simulated images. To access the image via `butler`, the LSST Science

Pipelines (https://pipelines.lsst.io/) are required.

We demonstrate the usage of accessing the images and analyzing them in the

notebook `agile_image.ipynb`, which is available in the DR1 repository:

https://drive.google.com/drive/u/0/folders/1xxaBrTamUZ5U3ncuG5VtkEIiF76UCghK

   self

   installation

   userguide

   agile_dr1

   autoapi/index