From 157e678d4cfa27113825a9187df65c0347ffc8e6 Mon Sep 17 00:00:00 2001 From: BONNAREL FRANCOIS Date: Tue, 3 Feb 2026 09:59:01 +0100 Subject: [PATCH 1/3] adding DataLink table example in UseCase --- UseCases.tex | 36 ++++++++++++++++++++++++++++++------ 1 file changed, 30 insertions(+), 6 deletions(-) diff --git a/UseCases.tex b/UseCases.tex index e68e72f..10733b9 100644 --- a/UseCases.tex +++ b/UseCases.tex @@ -86,7 +86,7 @@ \subsubsection{Use Case --- Search for event bundles via DataLink that include C \item Target name = ``Cas A'' or position inside 2.5 arcmin from (350.8584, $+58.8113$), \item dataproduct\_type = ``event-bundle'', \item obs\_collection = ``VERITAS-DR1'', - \item access\_format = ``datalink''. + \item access\_format = ``application/fits''. \end{enumerate} \begin{verbatim} @@ -97,10 +97,10 @@ \subsubsection{Use Case --- Search for event bundles via DataLink that include C CONTAINS(POINT(s_ra, s_dec), CIRCLE, 350.8584, +58.8113, 0.042) = 2) AND (dataproduct_type = 'event-bundle') AND (obs_collection = 'VERITAS-DR1') -AND (access_format = ’application/x-votable+xml;content=datalink’) +AND (access_format = ’application/fits’) \end{verbatim} -Then, for each row of the output, we get the ``access\_url'' of the DataLink to provide access to the data. +Then, for each row of the output, we get the ``access\_url'' of the Obscore table to provide access to the data. \subsubsection{Use Case --- Search for event bundles that include Cas A for X-ray spectrophotometric evolution studies} @@ -128,12 +128,12 @@ \subsubsection{Use Case --- Search for event bundles that include Cas A for X-ra \subsubsection{Use Case --- Search for event lists and their \glspl{IRF} of CTAO South observations at energies above 10 TeV for blind search of PeVatrons from a data release using DataLink} -{\em Identify all event bundles (event lists and their associated \glspl{IRF}) taken by CTAO South that contains events above 10 TeV. Data taken with the Small Size Telescopes or Medium Size Telescopes can be then selected. \/} +{\em Identify all event lists and their associated \glspl{IRF} taken by CTAO South that contains events above 10 TeV. Data taken with the Small Size Telescopes or Medium Size Telescopes can be then selected. \/} \medskip \noindent Find all CTAO datasets satisfying: \begin{enumerate}[(i)] - \item dataproduct\_type = ``event-bundle'', + \item dataproduct\_type = ``event-list'', \item obs\_collection = ``CTAO-DR1'', \item access\_format = ``datalink'', \item instrument\_name contains ``CTAO-S'', @@ -144,7 +144,7 @@ \subsubsection{Use Case --- Search for event lists and their \glspl{IRF} of CTAO \begin{verbatim} SELECT * FROM ivoa.obscore NATURAL JOIN ivoa.obscore_hea -WHERE (dataproduct_type = 'event-bundle') +WHERE (dataproduct_type = 'event-list') AND (obs_collection = 'CTAO-DR1') AND (access_format = 'application/x-votable+xml;content=datalink') AND (instrument_name LIKE 'CTAO-S') @@ -179,6 +179,30 @@ \subsubsection{Use Case --- Search for event lists and their \glspl{IRF} of CTAO EVENT_FILE['OBS_ID'] = GET RAW['accessURL'] \end{verbatim} +Table \ref{tab:datalink1} displays an example of the DataLink response table attached to such an event-list discovery. Mandatory FIELDS service\_def and error\_messsage are omitted because they are empty + +\begin{landscape} +\begin{longtable}{|p{2.4cm}|p{3.3cm}|p{2.0cm}|p{2.4cm}|p{2.3cm}|p{2.4cm}|p{2.7cm}|} +\sptablerule +\textbf{ID} &\textbf{\footnotesize access\_url} &\textbf{\footnotesize semantics}&\textbf{\footnotesize description} &\textbf{\footnotesize content\_type} &\textbf{\footnotesize content\_length} &\textbf{\footnotesize content\_qualifier}\cr +\sptablerule +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt1.ext1} & \#this & {\footnotesize event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/xml & 1000000 & event-list \cr +\sptablerule +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt2.ext2} & \#calibration & {\footnotesize Effective AREA of event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 10000 & aeff \cr +\sptablerule +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt3.ext3} & \#calibration & {\footnotesize Energy dispersion of event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 10000 & edisp \cr +\sptablerule +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt4.ext4} & \#calibration & {\footnotesize Point spread function of event-list } {\tiny ivo://xxx/yyy/zzz\#ttt} & image/fits & 50000 & psf \cr +\sptablerule +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt5.ext5} & \#calibration & {\footnotesize Background rate of event-list } {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 1000 & bkgrate \cr +\sptablerule + +\caption{DataLink response table attached to an event-list record in ObsCore.} + + +\label{tab:datalink1} +\end{longtable} +\end{landscape} \subsubsection{Use Case --- Search for spatially resolved spectropolarimetric observations of the Crab with spectral resolution R > 100} From 5ae81a33ff234ba1dac7bcd9b525573249160711 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fran=C3=A7ois=20Bonnarel?= <52417996+Bonnarel@users.noreply.github.com> Date: Tue, 3 Feb 2026 18:11:17 +0100 Subject: [PATCH 2/3] Update UseCases.tex --- UseCases.tex | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/UseCases.tex b/UseCases.tex index 10733b9..1f9453a 100644 --- a/UseCases.tex +++ b/UseCases.tex @@ -179,7 +179,9 @@ \subsubsection{Use Case --- Search for event lists and their \glspl{IRF} of CTAO EVENT_FILE['OBS_ID'] = GET RAW['accessURL'] \end{verbatim} -Table \ref{tab:datalink1} displays an example of the DataLink response table attached to such an event-list discovery. Mandatory FIELDS service\_def and error\_messsage are omitted because they are empty +Table \ref{tab:datalink1} displays an example of the DataLink response table attached to such an event-list discovery. +The obs\_publisher\_did of the single discovered event-list is repeated in the ID column of the DataLink table. +Mandatory FIELDS service\_def and error\_messsage are omitted because they are empty \begin{landscape} \begin{longtable}{|p{2.4cm}|p{3.3cm}|p{2.0cm}|p{2.4cm}|p{2.3cm}|p{2.4cm}|p{2.7cm}|} From a0dbf2a6d30b2ec3cc302051e13767e863e173a2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fran=C3=A7ois=20Bonnarel?= <52417996+Bonnarel@users.noreply.github.com> Date: Thu, 5 Feb 2026 16:55:07 +0100 Subject: [PATCH 3/3] Update UseCases.tex change in description of the effective area in the DataLink table --- UseCases.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/UseCases.tex b/UseCases.tex index 1f9453a..a71d767 100644 --- a/UseCases.tex +++ b/UseCases.tex @@ -190,7 +190,7 @@ \subsubsection{Use Case --- Search for event lists and their \glspl{IRF} of CTAO \sptablerule {\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt1.ext1} & \#this & {\footnotesize event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/xml & 1000000 & event-list \cr \sptablerule -{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt2.ext2} & \#calibration & {\footnotesize Effective AREA of event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 10000 & aeff \cr +{\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt2.ext2} & \#calibration & {\footnotesize Effective AREA of the telescope/instrument associated with the event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 10000 & aeff \cr \sptablerule {\tiny ivo://xxx/yyy/zzz\#ttt} & {\tiny https://xxx.yyy/zzz/ttt3.ext3} & \#calibration & {\footnotesize Energy dispersion of event-list} {\tiny ivo://xxx/yyy/zzz\#ttt} & text/csv & 10000 & edisp \cr \sptablerule