Skip to content

Commit

Permalink
Merge pull request #62 from Bonnarel/main
Browse files Browse the repository at this point in the history 
Update of the Science Case Appendix
  • Loading branch information
@Bonnarel
Bonnarel authored Jun 17, 2024
2 parents 65116a5 + aef93e2 commit 157bb64
Show file tree
Hide file tree
Showing 4 changed files with 182 additions and 144 deletions.
188 changes: 95 additions & 93 deletions Appendix.tex
View file
Original file line number Diff line number Diff line change
@@ -1,11 +1,22 @@
\section{Science use cases and translation to ADQL queries based on ObsCore Radio extension }
\label{ADQLusecases}

\subsection{Science case }

\textit{ The queries in subsections \ref{sec:s_resolution_max} and \ref{sec:s_fov_min}
can be run with s\_resolution\_min and s\_fov\_max instead of s\_resolution\_max and
s\_fov\_min respectively, to obtain results in which at least part of the dataset satisfy the condition.\\
For instance, consider datasets with a large observed bandwidth, like those taken with wide/ultrawide band receivers.
The condition s\_resolution\_max<d\_typical may not be satisfied. At the same time, the user may want to select those
dataset where the desired condition on spatial resolution is matched at least partially within the observed band.}

%\subsection{Science case }
\subsection{Use case - s\_resolution\_min}
\textit{Comparative study of low surface brightness extended emission surrounding compact sources, like for instance Virgo A. Select any dataset map (raster or on-the-fly) with s\_resolution\_min larger than the desired spatial resolution of 1 arcmin.}
\label{sec:s_resolution_min}
\textit{Comparative study of low surface brightness extended emission surrounding compact sources, like for instance Virgo A.
In order to avoid washing out of diffuse emission the spatial resolution should not be too high.
Select any dataset map (raster or on-the-fly) with s\_resolution\_min larger than the desired spatial resolution of 1 arcmin.}
Show me all datasets satisfying: \\
I. Minimum spatial resolution < 0.017 deg \\
I. Minimum spatial resolution > 0.017 deg \\
II Target Virgo A or position inside 15 arcmin from 187.7059308,+12.3911232 \\
III Scan mode is raster map or on-the-fly map

Expand All @@ -17,7 +28,8 @@ \subsection{Use case - s\_resolution\_min}
\end{verbatim}

\subsection{Use case - s\_resolution\_max}
\textit{Morphological study of SNR IC443. Select any dataset of type map (raster or on-the-fly) with s\_resolution\_max less than the desired spatial resolution of 1 arcmin.}
\label{sec:s_resolution_max}
\textit{Morphological study of SNR IC443. Select any dataset obtained in map scanning mode (raster or on-the-fly) with s\_resolution\_max less than the desired spatial resolution of 1 arcmin.}

Show me all datasets satisfying: \\
I. Maximum spatial resolution < 0.017 deg \\
Expand All @@ -30,8 +42,9 @@ \subsection{Use case - s\_resolution\_max}
(scan_mode = 'raster map' OR scan_mode = 'on-the-fly map')
\end{verbatim}

\subsection{Use case - s\_fov\_min A}
\textit{Select any dataset with minimum field of view larger than 0.8 degree. For instance, investigate the region surrounding cluster Abell 194.}
\subsection{Use case - s\_fov\_min - large field of views}
\label{sec:s_fov_min}
\textit{Select any dataset obtained in map scanning mode (raster or on-the-fly) with minimum field of view larger than 0.8 degree. For instance, investigate the region surrounding cluster Abell 194.}

Show me all datasets satisfying:\\
I. Minimum FOV > 0.8 deg \\
Expand All @@ -44,8 +57,9 @@ \subsection{Use case - s\_fov\_min A}
(scan_mode = 'raster map' OR scan_mode = 'on-the-fly map')
\end{verbatim}

\subsection{Use case - s\_fov\_min B}
\textit{Pictor A has a typical angular extension arcminutes , select any image/cube completely containing the target}
\subsection{Use case - s\_fov\_min - extended target completly included}
\label{sec:s_fov_max}
\textit{Pictor A has a typical angular extension of 8 arcminutes , select any image/cube completely containing the target}
Show me all datasets satisfying: \\
I. Target name = Pictor A \\
II. The circle defined by the minimum FOV of the dataset fully contains the circle delimiting Pictor A. \\
Expand All @@ -55,17 +69,13 @@ \subsection{Use case - s\_fov\_min B}
CIRCLE(s_ra, s_dec, s_fov_min/2)) = 1)
\end{verbatim}

Nb: The above queries can be run with s\_resolution\_min and s\_fov\_max instead of s\_resolution\_max and s\_fov\_min respectively, to obtain results in which at least part of the dataset satisfy the condition.
For instance, consider datasets with a large observed bandwidth, like those taken with wide/ultrawide band receivers.
The condition s\_resolution\_max<d\_typical may not be satisfied. At the same time, the user may want to select those dataset where the desired condition on spatial resolution is matched at least partially within the observed band.

\subsection{Use case - dataproduct\_type}
\textit{Select all observations of calibrator source 3C48 with the Medicina Grueff radio telescope at frequencies in the range 20-21 GHz, to investigate its flux variability (light curve) in the years 2000-2023}
Show me all datasets satisfying: \\
I. Target name = 3C 48 \\
II. obs\_collection = ?INAF-Medicina, single dish?\\
III. Observed frequency in the range 20-21 GHz \\
IV. dataproduct\_type = spatial\_profile or dataproduct\_type = map\\
IV. dataproduct\_type = spatial\_profile or scan\_mode contains map\\
V. 51544 < observation time (MJD) < 60309 \\
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
Expand All @@ -76,21 +86,35 @@ \subsection{Use case - dataproduct\_type}
(t_min >= 51544 AND t_max <= 60309)
\end{verbatim}

\subsection{Use case - f\_resolution, f\_min, f\_max}
\textit{Select any cube with spectral resolution better than 1 MHz and spectral range inside the 1 to 1.5 GHz band.}
\subsection{Use case - f\_resolution, frequency ranges}
\label{sec:FreqRanges}

\textit{Select any cube with spectral resolution better than 1 MHz and spectral range inside the 1 to 1.5 GHz band (around HI 21 cm line).}

Show me all datasets satisfying:\\
I. Product type is cube \\
II. spectral resolution better than 1 MHz \\
f\_min and f\_max are computed by means of a user defined function. \\
III. em\_min and em\_max such than frequency bounds are included in the 1GHz to 1.5GHz range \\
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
SELECT *, 299792458 / em_max as f_min, 299792458 / em_min as f_max
FROM ivoa.ObscoreRadioExtended
WHERE dataproduct_type = 'cube' AND
f_resolution < 1000000 AND
f_min > 1.0 e+9 AND
f_max < 1.5e+9
299792458 / em_max > 1.0 e+9 AND
299792458 / em_min < 1.5e+9
\end{verbatim}

\subsection{Use case - frequency selection for images }
\textit{Any image or cube observed at frequencies below 1 GHz.}\\ \\
Show me all datasets satisfying:\\
I. Product type is image or cube \\
II. higher spectral limit < 1Ghz
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE (dataproduct_type = 'image' OR
dataproduct_type = 'cube') AND
f_max < 1e9
\end{verbatim}
% Mireille Louys: shall we also look for spectra with these frequency constrains ?


Expand Down Expand Up @@ -126,7 +150,7 @@ \subsection{Use case - f\_resolution, f\_min, f\_max}

% end of Mark's (VLBI) science cases

\subsection{FB : Use case 1.1 data product and targer object selection }
\subsection{ use case - visibility data product and targer object selection }
\textit{Any raw interferometry observation containing target Fornax cluster.}\\
\\
Show me all observation identifiers satisfying:\\
Expand All @@ -137,55 +161,60 @@ \subsection{FB : Use case 1.1 data product and targer object selection }
WHERE dataproduct_type = 'visibility'
target_name = 'Fornax cluster'
\end{verbatim}
\subsection{Use case 1.2}
\textit{Any dataset with minimum field of view larger than 0.5 degree.}\\
\\





\subsection{Use case - maximum angular scale selection}
\textit{Any visibility dataset Within an arcec around FRB 121102 where maximum angular scale is larger than 1 minute .}\\ \\
Show me all datasets satisfying:\\
I. Minimum FOV > 0.5 deg \\
I. Product type is visibility \\
II. Maximum angular scale > 0.018 deg \\
III. Position within 1 arcsec of 82.99458 + 33.14794
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE fov_min > 0.5
WHERE dataproduct_type = 'visibility' AND
max_angular_scale > 0.018 AND
max_angular_scale > 0.018 AND
CONTAINS(POINT(s_ra,s_dec),CIRCLE(82.99458, 33.14794,0.0003)) = 1))
\end{verbatim}

\subsection{Use case 1.3/ time selection }
\textit{Any cube with absolute spectral resolution better than 1 Mhz and spectral range inside the 1 to 1.5 Ghz band.}\\ \\
Show me all datasets satisfying:\\
I. Product type is cube \\
II. spectral resolution better than 1Mhz \\
III. lower spectral limit > 1Ghz \\
IV. higher spectral limit < 1.5Ghz
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE dataproduct_type = 'cube' AND
f_resolution < 1000 AND
f_min > 1000 AND
f_max < 1500
\end{verbatim}

\subsection{Use case 1.4 / freq selection }
\textit{Any low frequency image or cube defined as smaller than 1 Ghz.}\\ \\
\subsection{Use case - maximum angular scale selection with reasonable fidelity}
\textit{Any visibility data within an arcsec around FRB 121102 where maximum angular scale is larger than 1 minute and
of good quality from the uv distribution point of view.}\\ \\
Show me all datasets satisfying:\\
I. Product type is image or cube \\
II. higher spectral limit < 1Ghz
I. Product type = visibility \\
II. Maximum angular scale > 0.018 deg \\
III. uv distribution filling factor > 0.7 \\
IV. uv distribtion factor eccentricity < 0.1 \\
V. Position within 1 arcsec of 82.99458 + 33.14794
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE (dataproduct_type = 'image' OR
dataproduct_type = 'cube') AND
f_max < 1000
WHERE dataproduct_type = 'visibilty' AND
max_angular_scale > 0.018 AND
uv_distribution_fill > 0.7 AND
uv_distribution_ecc < 0.1 AND
CONTAINS(POINT(s_ra,s_dec),CIRCLE(82.99458, 33.14794,0.0003)) =1))
\end{verbatim}

\subsection{Use case 1.5 / scale selection}
\textit{Any visibility dataset where maximum angular scale is larger than 0.5degrees.}\\ \\
\subsection{Use case - time selection }
\textit{Any timeseries obtained in beam forming mode with time resolution better than 0.1 second and time sample maximal duration smaller than 0.05 second. }\\ \\
Show me all datasets satisfying:\\
I. Product type is visibility \\
II. Maximum angular scale > 0.5 deg
I. Instrument type = beam forming\\
II. Product type = time series \\
III. time resolution < 0.1 s\\
IIV. maximal duration per sample < 0.05 s \\

\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE dataproduct_type = 'visibility' AND
max_angular_scale > 0.5
WHERE instr_type = 'beamForming' AND
dataproduct_type = 'timeseries' AND
t_resolution < 0.1 AND
t_exp_max < 0.05
\end{verbatim}

\subsection{Use case 1.6 / instrument type and mode selection }
\todo{Below : instrument and observing modes parameters. To be completed by science cases}
\subsection{Use case - instrument type and mode selection }
\textit{Any single dish dataset in raster mode around 3C 273.}\\ \\
Show me all datasets satisfying:\\
I. Instrument type is Single dish \\
Expand All @@ -194,14 +223,14 @@ \subsection{Use case 1.6 / instrument type and mode selection }
IV. position inside 3 arcmin around 187.2779159404900 +02.0523882305500
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE instrument_type = 'SD' AND
WHERE instr_type = 'SD' AND
scan_mode = 'raster' AND
(target_name = '3C 273' OR
CONTAINS(POINT(s_ra,s_dec), CIRCLE(187.2779159404900, +02.0523882305500,0.05)) = 1)
\end{verbatim}

% use case FB
\subsection{Use case 1.7 instrument type selection}
\subsection{Use case - instrument type selection}
\textit{Any single dish or beam forming dataset with spectral range inside the 500 Mhz - 1Ghz band and in the Coma Cluster.}\\ \\
Show me all datasets satisfying:\\
I. Instrument type is Single dish or beam forming \\
Expand All @@ -210,13 +239,13 @@ \subsection{Use case 1.7 instrument type selection}
IV. position inside 18 arcmin around 194.93502 +27.91246
\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE (instrument_type = 'SD' OR
instrument_type = 'beamForming') AND
WHERE (instr_type = 'SD' OR
instr_type = 'beamForming') AND
CONTAINS(POINT(s_ra,s_dec),CIRCLE(194.93502, +27.91246, 0.3) = 1
\end{verbatim}


\subsection{Use case 1.8 instrument type and freq selection }
\subsection{Use case - instrument type and frequency selection }
\textit{Any single dish or beam forming dataset with spectral range inside the 500 Mhz - 1Ghz band and in the Coma Cluster.}\\ \\
Show me all datasets satisfying:\\
I. Instrument type is Single dish or beam forming \\
Expand All @@ -226,30 +255,17 @@ \subsection{Use case 1.8 instrument type and freq selection }

\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE (instrument_type = 'SD' OR
instrument_type = 'beamForming') AND
WHERE (instr_type = 'SD' OR
instr_type = 'beamForming') AND
f_min > 500 AND
f_max < 1000 AND
CONTAINS(POINT(s_ra,s_dec),CIRCLE(194.93502, +27.91246, 0.3) = 1
\end{verbatim}


\subsection{Use case 1.9 uv distribution selection}
\textit{Any visibility data of good quality from th uv distribution point of view.}\\ \\
Show me all datasets satisfying:\\
I. Product type = visibility \\
II. uv distribution filling factor > 0.7 \\
III. uv distribtion factor eccentricity < 0.1 \\

\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE dataproduct_type = 'visibilty' AND
uv_distribution_fill > 0.7 AND
uv_distribution_ecc < 0.1
\end{verbatim}


\subsection{Use case 1.10 -instrument parameters selection }
\subsection{Use case - instrument parameters selection }
\textit{Any interferometry data of good quality and significant spatial resolution from the instrumental point of view. }\\ \\
Show me all datasets satisfying:\\
I. Instrument type = visibility \\
Expand All @@ -258,24 +274,10 @@ \subsection{Use case 1.10 -instrument parameters selection }

\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE instrument_type = 'interferometry' AND
instrument_ant_number > 40 AND
instrument_ant_max_dist > 5000
WHERE instr_type = 'interferometry' AND
instr_ant_number > 40 AND
instr_ant_max_dist > 5000
\end{verbatim}


\subsection{Use case 1.11 - time selection }
\textit{Any timeseries obtained in beam forming mode with time resolution better than 0.1 second and time sample maximal duration smaller than 0.05 second. }\\ \\
Show me all datasets satisfying:\\
I. Instrument type = beam forming\\
II. Product type = time series \\
III. time resolution < 0.1 s\\
IIV. maximal duration per sample < 0.05 s \\

\begin{verbatim}
SELECT * FROM ivoa.ObscoreRadioExtended
WHERE instrument_type = 'beamForming' AND
dataproduct_type = 'timeseries' AND
t_resolution < 0.1 AND
t_exp_max < 0.05
\end{verbatim}
4 changes: 2 additions & 2 deletions Makefile
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@ DOCNAME = ObsCoreExtensionForRadioData
DOCVERSION = 1.0

# Publication date, ISO format; update manually for "releases"
DOCDATE = 2024-06-11
DOCDATE = 2024-06-14

# What is it you're writing: NOTE, WD, PR, or REC
DOCTYPE = WD
DOCTYPE = PR

AUTHOR_EMAIL[email protected]

Expand Down
Loading

0 comments on commit 157bb64

Please sign in to comment.