Skip to content

Minor updates #56

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
iannevans merged 1 commit into from
May 18, 2026
+18 −18
Merged

Minor updates #56

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions HighEnergyObsCoreExt.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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}

Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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}
Expand Down
2 changes: 1 addition & 1 deletion Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
22 changes: 11 additions & 11 deletions UseCases.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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}

Expand All @@ -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')
Expand All @@ -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')
Expand Down Expand Up @@ -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’)
Expand All @@ -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}
Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -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')
Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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')
Expand Down Expand Up @@ -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)
Expand Down
Loading