From 2b725106287406c135d5966b19ea86577be82fe8 Mon Sep 17 00:00:00 2001 From: Ian Nigel Evans Date: Mon, 18 May 2026 12:14:57 -0400 Subject: [PATCH] Minor updates Updated Makefile date; updated text to ensure pdgid always has +/-; fixed erroneous ADQL CIRCLE syntax pervasive through Use cases. --- HighEnergyObsCoreExt.tex | 12 ++++++------ Makefile | 2 +- UseCases.tex | 22 +++++++++++----------- 3 files changed, 18 insertions(+), 18 deletions(-) diff --git a/HighEnergyObsCoreExt.tex b/HighEnergyObsCoreExt.tex index d669539..f249de0 100644 --- a/HighEnergyObsCoreExt.tex +++ b/HighEnergyObsCoreExt.tex @@ -365,9 +365,9 @@ \subsection{{\em messenger}} \item \texttt{neutrino}: the messenger is a neutrino (any type); \item \texttt{photon}: the messenger is a photon; \item \texttt{proton}: the messenger is a proton or anti-proton; - \item \texttt{pdgid-{\em nn\/}}: the messenger is a particle whose PDG ID\footnote{Particle Data Group Identifier, see \url{https://www.phy.bnl.gov/twister/bee/particles/}} is {\em nn\/}. + \item \texttt{pdgid{\em $\pm$nn\/}}: the messenger is a particle whose PDG ID\footnote{Particle Data Group Identifier, see \url{https://www.phy.bnl.gov/twister/bee/particles/}} is {\em $\pm$nn\/}. \end{itemize} -The value ``pdgid-{\em nn\/}'' allows a messenger particle not listed in the table to be specified by reporting the particle's Particle Data Group Identifier as {\em nn\/}. For example, a muon $\mu^{-}$ may be specified as ``pdgid-13''. We note that permissible {\em messenger\/} values will vary from facility to facility and from instrument to instrument. +The value ``pdgid{\em $\pm$nn\/}'' (where the sign is mandatory) allows a messenger particle not listed in the table to be specified by reporting the particle's Particle Data Group Identifier as {\em $\pm$nn\/}. For example, a muon, $\mu^{-}$, may be specified as ``pdgid+13''. We note that permissible {\em messenger\/} values will vary from facility to facility and from instrument to instrument. \subsection{Additional Columns} @@ -535,7 +535,7 @@ \subsubsection{Physical Quantities} The messengers for \gls{HEA} observations may include particles other than the ones currently described in the UCD list. Because some instruments can now distinguish electrons from positrons\footnote{For example, the Fermi-LAT instrument.}, as well antiprotons from protons\footnote{For example, the AMS-2 experiment.}, we also propose to add {\em phys.particle.positron\/} and {\em phys.particle.antiproton\/}, as well as {\em phys.particle.cosmicray\/} and unify them all under the {\em phys.particle\/} UCD hierarchy. -For particle detectors, a wide range of different particles might have to be described. As is customary in particle physics, we propose to facilitate the use of the Particle Data Group Identifier\footnote{see \url{https://www.phy.bnl.gov/twister/bee/particles/}} as reference for any particle, describing {\em e.g.\/}, $\nu_{\tau}$ and $\bar{\nu}_{\tau}$ as {\em phys.particle.pdgid+16\/} and {\em phys.particle.pdgid-16\/} respectively. +For particle detectors, a wide range of different particles might have to be described. As is customary in particle physics, we propose to facilitate the use of the Particle Data Group Identifier\footnote{see \url{https://www.phy.bnl.gov/twister/bee/particles/}} as reference for any particle, describing {\em e.g.\/}, $\nu_{\tau}$ and $\bar{\nu}_{\tau}$ as {\em phys.particle.pdgid+16\/} and {\em phys.particle.\hbox{pdgid-16}\/} respectively. One should note that electrons are denoted by the UCD {\em phys.electron\/} in the current version of the UCD list \citep{2024ivoa.spec.1218C} and are inappropriately not grouped under the {\em phys.particle\/} hierarchy. This causes some inconsistencies that could be solved by marking {\em phys.electron\/} (and {\em phys.electron.degen\/}) as obsolete or not recommended, and adding the term {\em phys.particle.electron\/} to the UCD list. @@ -581,7 +581,7 @@ \subsubsection{Evolution of UCD list} S & {\em phys.particle.photon\/} & Related to photon \cr S & {\em phys.particle.positron\/} & Related to positron \cr S & {\em phys.particle.pdgid\/} & Particle Data Group Identifier \cr -S & {\em phys.particle.pdgidXX\/} & Related to a particle with PDG ID XX \cr +S & {\em phys.particle.pdgid$\pm$XX\/} & Related to a particle with PDG ID $\pm$XX \cr P & {\em stat.distribution\/} & Type or shape of statistical distribution \cr P & {\em stat.error.negative\/} & Negative statistical error \cr P & {\em stat.error.positive\/} & Positive statistical error \cr @@ -643,7 +643,7 @@ \section{Proposed ivoa.obscore\_hea Table Attributes}\label{sec:ibscoreext} \hline em\_ref\_oaa & \ucd{pos.posAng;instr.offset;em} & deg & float & {Off-axis angle ({\em i.e.\/}, the angular separation of the target or source from the telescope optical axis) at which the ObsCore spectral characterization attributes em\_res\_power, em\_resolution are defined} & NO \\ \hline - t\_intervals & \ucd{?? }& unitless & TMOC & {List of observation intervals or stable/good time intervals describing the exact observation time coverage} & NO \\ + t\_intervals & \ucd{TBD}& unitless & TMOC & {List of observation intervals or stable/good time intervals describing the exact observation time coverage} & NO \\ \hline energy\_min & \ucd{em.energy;stat.min} & float & eV & {Energy associated to the ObCcore attribute em\_max, describing the minimal energy of the dataset} & NO \\ \hline @@ -657,7 +657,7 @@ \section{Proposed ivoa.obscore\_hea Table Attributes}\label{sec:ibscoreext} \hline event\_type & \ucd{meta.code.qual;obs.event} & unitless & string &{Data quality flag of the events ({\em e.g.\/}, ``good psf'', ``good rejection'', ``Nhit (100,200)''} & NO \\ \hline - messenger & \ucd{??} & unitless & string &{Messenger particle type ({\em e.g.\/}, ``photon'', ``cosmic-ray'', ``neutrino'', ``pdgid-13'')} & NO \\ + messenger & \ucd{TBD} & unitless & string &{Messenger particle type ({\em e.g.\/}, ``photon'', ``cosmic-ray'', ``neutrino'', ``pdgid-13'')} & NO \\ \hline \end{longtable} %\end{center} diff --git a/Makefile b/Makefile index 62d173e..46e665c 100644 --- a/Makefile +++ b/Makefile @@ -8,7 +8,7 @@ DOCNAME = HighEnergyObsCoreExt DOCVERSION = 1.0 # Publication date, ISO format; update manually for "releases" -DOCDATE = 2026-05-15 +DOCDATE = 2026-05-18 # What is it you're writing: NOTE, WD, PR, REC, PEN, or EN DOCTYPE = PEN diff --git a/UseCases.tex b/UseCases.tex index dce2c9b..c6837bd 100644 --- a/UseCases.tex +++ b/UseCases.tex @@ -17,7 +17,7 @@ \subsubsection{Use Case --- Search for event lists surrounding Sgr A*, for examp NATURAL JOIN ivoa.obscore_hea WHERE (target_name = 'Sgr A*' OR -CONTAINS(POINT(s_ra, s_dec), CIRCLE, 266.4168, -29.0078, 0.5) = 1) +CONTAINS(POINT(s_ra, s_dec), CIRCLE(266.4168, -29.0078, 0.5)) = 1) AND (dataproduct_type = 'event-list') \end{verbatim} @@ -41,7 +41,7 @@ \subsubsection{Use Case --- Search for event lists that include a fully calibrat NATURAL JOIN ivoa.obscore_hea WHERE (target_name = 'BL Lac' OR -CONTAINS(POINT(s_ra, s_dec), CIRCLE, 330.680338, +42.27777, 0.083333) = 1) +CONTAINS(POINT(s_ra, s_dec), CIRCLE(330.680338, +42.27777, 0.083333)) = 1) AND (dataproduct_type = 'event-list') AND (calib_level >= 2) AND (em_calib_status = 'calibrated') @@ -66,7 +66,7 @@ \subsubsection{Use Case --- Search for SWGO event lists and their \glspl{IRF} f \begin{verbatim} SELECT * FROM ivoa.obscore NATURAL JOIN ivoa.obscore_hea -WHERE (INTERSECTS(s_region, CIRCLE(312.775, 30.683, 1.5)) = 6) +WHERE (INTERSECTS(s_region, CIRCLE(312.775, 30.683, 1.5)) = 1) AND (dataproduct_type = 'event-list' OR dataproduct_type = 'aeff' OR dataproduct_type = 'edisp' OR dataproduct_type = 'psf' OR dataproduct_type = 'bkgrate') @@ -94,7 +94,7 @@ \subsubsection{Use Case --- Search for event bundles via DataLink that include C NATURAL JOIN ivoa.obscore_hea WHERE (target_name = 'Cas A' OR -CONTAINS(POINT(s_ra, s_dec), CIRCLE, 350.8584, +58.8113, 0.042) = 2) +CONTAINS(POINT(s_ra, s_dec), CIRCLE(350.8584, +58.8113, 0.042)) = 1) AND (dataproduct_type = 'event-list') AND (obs_collection = 'VERITAS-DR1') AND (access_format = ’application/x-votable+xml;content=datalink’) @@ -120,7 +120,7 @@ \subsubsection{Use Case --- Search for event bundles that include Cas A for X-ra NATURAL JOIN ivoa.obscore_hea WHERE (target_name = 'Cas A' OR -CONTAINS(POINT(s_ra, s_dec), CIRCLE, 350.8584, +58.8113, 0.16667) = 1) +CONTAINS(POINT(s_ra, s_dec), CIRCLE(350.8584, +58.8113, 0.16667)) = 1) AND (dataproduct_type = 'event-bundle') AND (ev_xel >= 1000000) \end{verbatim} @@ -230,7 +230,7 @@ \subsubsection{Use Case --- Search for spatially resolved spectropolarimetric ob NATURAL JOIN ivoa.obscore_hea WHERE (target_name = 'Crab' OR target_name = 'M1' OR -CONTAINS(POINT(s_ra, s_dec), CIRCLE, 83.6324, +22.0174, 0.083333) = 1) +CONTAINS(POINT(s_ra, s_dec), CIRCLE(83.6324, +22.0174, 0.083333)) = 1) AND (dataproduct_type = 'event-bundle') AND (calib_level >= 2) AND (s_resolution > 100) @@ -258,7 +258,7 @@ \subsubsection{Use Case --- Identify PSF response-functions for further analysis SELECT * FROM ivoa.obscore NATURAL JOIN ivoa.obscore_hea WHERE -(CONTAINS(POINT(s_ra, s_dec), CIRCLE, 83.84358, -5.43639, 0.033333) = 1) +(CONTAINS(POINT(s_ra, s_dec), CIRCLE(83.84358, -5.43639, 0.033333)) = 1) AND (dataproduct_type = 'response-function') AND (dataproduct_subtype = 'psf') AND (obs_id = '4374') @@ -338,7 +338,7 @@ \subsubsection{Use Case --- Retrieve the instrument response functions for a com \subsubsection{Use Case --- Study the combined neutrino flux for the Galactic plane} -{\em Identify all neutrino data sets in the region of the Galactic plane to perform a combined neutrino flux study extending a study like the IceCube \textbf{Observation of high-energy neutrinos from the Galactic plane. DOI: 10.1126/science.adc9818}.}, using event lists and IRFs of datasets optimized for the analysis of diffuse neutrino emission. +{\em Identify all neutrino data sets in the region of the Galactic plane to perform a combined neutrino flux study extending a study like the IceCube \textbf{Observation of high-energy neutrinos from the Galactic plane. DOI: 10.1126/science.adc9818}, using event lists and IRFs of datasets optimized for the analysis of diffuse neutrino emission.} \medskip \noindent Find all neutrino datasets satisfying: @@ -400,7 +400,7 @@ \subsubsection{Use Case --- Search for Chandra Source Catalog position error MCM SELECT * FROM ivoa.obscore NATURAL JOIN ivoa.obscore_hea WHERE -(CONTAINS(POINT(s_ra, s_dec), CIRCLE, 54.036061, +61.907633, 0.0013888) = 1) +(CONTAINS(POINT(s_ra, s_dec), CIRCLE(54.036061, +61.907633, 0.0013888)) = 1) AND (dataproduct_type = 'draws') AND (dataproduct_subtype = 'poserr') AND (obs_collection = 'CSC2') @@ -446,7 +446,7 @@ \subsubsection{Use Case --- Search for M31 source light curves and aperture phot \item dataproduct\_type = ``timeseries'' {\em or\/} ``pdf'', \item calib\_level = 4, \item energy\_min $\leq 0.3$ {\em and\/} energy\_max $\geq 7.0$, - \item t\_intervals TMOC intersects\footnote{We note that this functiondoes not yet exist in ADQL} MJD 56320--56325 TT. + \item t\_intervals TMOC intersects\footnote{We note that this function does not yet exist in ADQL} MJD 56320--56325 TT. \end{enumerate} @@ -454,7 +454,7 @@ \subsubsection{Use Case --- Search for M31 source light curves and aperture phot SELECT * FROM ivoa.obscore NATURAL JOIN ivoa.obscore_hea WHERE -(CONTAINS(POINT(s_ra, s_dec), CIRCLE, 10.6847, +41.2688, 1.5) = 1) +(CONTAINS(POINT(s_ra, s_dec), CIRCLE(10.6847, +41.2688, 1.5)) = 1) AND ((dataproduct_type = 'timeseries') OR (dataproduct_type = 'pdf')) AND (calib_level = 4) AND (energy_min <= 300.0) AND (energy_max >= 7000.0)