Merge pull request #56 from iannevans/May18Updates

Minor updates: updated Makefile date; updated text to ensure pdgid always has +/-; fixed erroneous ADQL CIRCLE syntax pervasive through Use cases.

Author: iannevans

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}

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

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,15 +446,15 @@ \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}
 
 
 \begin{verbatim}
 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)