Skip to content
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.

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

ask for merge of last corrections for loumir/pen1_6 into ivoa-std/WD-1.6 #99

Merged
merged 7 commits into from
Oct 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ jobs:
test -f ${{ env.doc_name }}.bbl

- name: Keep the PDF artefact
uses: actions/upload-artifact@v1
uses: actions/upload-artifact@v4
with:
name: PDF Preview
path: ${{ env.doc_name }}.pdf
Expand Down
6 changes: 3 additions & 3 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
DOCNAME = UCDlist

# count up; you probably do not want to bother with versions <1.0
DOCVERSION = 1.5
DOCVERSION = 1.6

# Publication date, ISO format; update manually for "releases"
DOCDATE = 2023-01-25
DOCDATE = 2024-09-19

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

# An e-mail address of the person doing the submission to the document
# repository (can be empty until a make upload is being made)
Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
![UCDList version](https://img.shields.io/badge/UCDList-EN--1.5-green.svg)
![UCDList version](https://img.shields.io/badge/UCDList-WD--1.6-yellow.svg)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm a CI skeptic and am not sure what this does, but if this is "WD" rather "PEN", there's something wrong with the underlying CI code, and that would need to be fixed.

[![Creative Commons License](https://i.creativecommons.org/l/by/4.0/80x15.png)](http://creativecommons.org/licenses/by/4.0/)

# UCDList
Expand All @@ -14,8 +14,9 @@ table columns distributed in the astronomical community.

This version contains new UCD words discussed and accepted by the Semantics
Working Group during the [UCD list v1.3 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-3_RFM)
(Request For Modifications), [v1.4 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-4_RFM)
and [v1.5 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-5_RFM).
(Request For Modifications), [v1.4 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-4_RFM),
[v1.5 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-5_RFM),
and [v1.6 RFM](https://wiki.ivoa.net/twiki/bin/view/IVOA/UCDList_1-6_RFM).

The list of UCD1+ words is maintained by the UCD Scientific Board, following the
procedure defined in the [UCDList
Expand Down
51 changes: 48 additions & 3 deletions UCDlist.tex
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@
\author{Markus Demleitner}

\editor[mailto:[email protected]]{Baptiste Cecconi, Mireille Louys}

\previousversion[https://www.ivoa.net/documents/UCD1+/20210616]{UCD1+ EN
1.5, 2023-01-25}
\previousversion[https://www.ivoa.net/documents/UCD1+/20210616]{UCD1+ EN
1.4, 2021-06-16}
\previousversion[https://ivoa.net/documents/UCD1+/20180527/index.html]{UCD1+
Expand Down Expand Up @@ -243,6 +244,7 @@ \section{List of valid words}
P & \ucd{meta.code.multip}& Multiplicity or binarity flag\\
P & \ucd{meta.code.qual}& Quality, precision, reliability flag or code\\
P & \ucd{meta.code.status}& Status code (e.g.: status of a proposal/observation)\\
Q & \ucd{meta.coverage}& A coverage (spatial, temporal, spectral, etc) with any combination of physical axes (such as moc, tmoc, stmoc)\\
P & \ucd{meta.cryptic}& Unknown or impossible to understand quantity\\
Q & \ucd{meta.curation}& Parameter informing about the curation of the data\\
Q & \ucd{meta.dataset}& Dataset\\
Expand Down Expand Up @@ -282,7 +284,13 @@ \section{List of valid words}
Q & \ucd{obs.airMass}& Airmass\\
S & \ucd{obs.atmos}& Atmosphere, atmospheric phenomena affecting an observation\\
Q & \ucd{obs.atmos.extinction}& Atmospheric extinction\\
Q & \ucd{obs.atmos.humidity}& Amount of air humidity at observing site during an observation\\
Q & \ucd{obs.atmos.rain}& Amount of rain at the telescope site during an observation\\
Q & \ucd{obs.atmos.refractAngle}& Atmospheric refraction angle\\
S & \ucd{obs.atmos.turbulence}& Related to atmospheric turbulence at the telescope site\\
P & \ucd{obs.atmos.turbulence.isoplanatic}& Isoplanatic angle characterising the atmospheric turbulence at telescope site\\
Q & \ucd{obs.atmos.water}& Amount of atmospheric water at observing site\\
S & \ucd{obs.atmos.wind}& Related to atmospheric wind at observing site\\
S & \ucd{obs.calib}& Calibration observation\\
S & \ucd{obs.calib.flat}& Related to flat-field calibration observation (dome, sky, ..)\\
S & \ucd{obs.calib.dark}& Related to dark current calibration\\
Expand Down Expand Up @@ -398,6 +406,7 @@ \section{List of valid words}
Q & \ucd{phys.flux.energy}& Energy flux, heat flux\\
Q & \ucd{phys.gauntFactor}& Gaunt factor/correction\\
Q & \ucd{phys.gravity}& Gravity\\
Q & \ucd{phys.inspiralSpin}& Effective inspiral spin in binary mergers (used in GW detections)\\
Q & \ucd{phys.ionizParam}& Ionization parameter\\
Q & \ucd{phys.ionizParam.coll}& Collisional ionization\\
Q & \ucd{phys.ionizParam.rad}& Radiative ionization\\
Expand Down Expand Up @@ -451,6 +460,7 @@ \section{List of valid words}
Q & \ucd{phys.size.sminAxis}& Linear semi minor axis\\
Q & \ucd{phys.size.smedAxis}& Linear semi median axis for 3D ellipsoids\\
Q & \ucd{phys.temperature}& Temperature\\
Q & \ucd{phys.temperature.dew}& Dew temperature measured at the telescope site during an observation\\
Q & \ucd{phys.temperature.effective}& Effective temperature\\
Q & \ucd{phys.temperature.electron}& Electron temperature\\
Q & \ucd{phys.transmission}& Transmission (of filter, instrument, ...)\\
Expand All @@ -466,6 +476,7 @@ \section{List of valid words}
Q & \ucd{phys.veloc.transverse}& Transverse / tangential velocity\\
S & \ucd{phys.virial}& Related to virial quantities (mass, radius, ...)\\
Q & \ucd{phys.volume}& Volume (in cubic units)\\
Q & \ucd{phys.voltage}& Electric potential difference over a distance or measured by an instrument\\
Q & \ucd{pos}& Position and coordinates\\
Q & \ucd{pos.angDistance}& Angular distance, elongation\\
Q & \ucd{pos.angResolution}& Angular resolution\\
Expand Down Expand Up @@ -519,7 +530,6 @@ \section{List of valid words}
S & \ucd{pos.heliocentric}& Heliocentric position coordinate (solar system bodies)\\
Q & \ucd{pos.HTM}& Hierarchical Triangular Mesh\\
Q & \ucd{pos.incidenceAng}& Incidence angle of optical ray on an interface\\
S & \ucd{pos.lambert}& Lambert projection\\
S & \ucd{pos.lg}& Local Group reference frame\\
S & \ucd{pos.lsr}& Local Standard of Rest reference frame\\
Q & \ucd{pos.lunar}& Lunar coordinates\\
Expand All @@ -535,6 +545,7 @@ \section{List of valid words}
V & \ucd{pos.pm}& Proper motion\\
Q & \ucd{pos.posAng}& Position angle of a given vector\\
V & \ucd{pos.precess}& Precession (in equatorial coordinates)\\
Q & \ucd{pos.projection}& 2D spatial projection\\
Q & \ucd{pos.resolution}& Spatial linear resolution (not angular)\\
S & \ucd{pos.spherical}& Related to spherical coordinates\\
Q & \ucd{pos.spherical.azi}& Azimuthal angle (spherical coordinates)\\
Expand Down Expand Up @@ -607,10 +618,13 @@ \section{List of valid words}
Q & \ucd{src.var.pulse}& Pulse\\
Q & \ucd{stat}& Statistical parameters\\
Q & \ucd{stat.asymmetry}& Measure of asymmetry\\
P & \ucd{stat.confidenceLevel}& Level of confidence for a detection or classification process\\
P & \ucd{stat.correlation}& Correlation between two parameters\\
P & \ucd{stat.covariance}& Covariance between two parameters\\
P & \ucd{stat.error}& Statistical error\\
P & \ucd{stat.error.sys}& Systematic error\\
Q & \ucd{stat.falsePositive}& Rate of false alarm in detection problems\\
Q & \ucd{stat.falseNegative}& Rate of missed or false negative detection\\
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a rationale for making them Q? Where would these be in a secondary position?

Q & \ucd{stat.filling}& Filling factor (volume, time, ...)\\
Q & \ucd{stat.fit}& Fit\\
P & \ucd{stat.fit.chi2}& Chi2\\
Expand All @@ -637,7 +651,7 @@ \section{List of valid words}
P & \ucd{stat.rms}& Root mean square as square root of sum of squared values or quadratic mean\\
P & \ucd{stat.skewness}& Skewness of a probability distribution (third moment)\\
P & \ucd{stat.snr}& Signal to noise ratio\\
P & \ucd{stat.stdev}& Standard deviation as the square root of the variance\\
Q & \ucd{stat.stdev}& Standard deviation as the square root of the variance\\
S & \ucd{stat.uncalib}& Qualifier of a generic uncalibrated quantity\\
Q & \ucd{stat.value}& Miscellaneous value\\
P & \ucd{stat.variance}& Variance\\
Expand All @@ -653,6 +667,7 @@ \section{List of valid words}
Q & \ucd{time.interval}& Time interval, time-bin, time elapsed between two events, not the duration of an event\\
Q & \ucd{time.lifetime}& Lifetime\\
Q & \ucd{time.period}& Period, interval of time between the recurrence of phases in a periodic phenomenon\\
Q & \ucd{time.period.pulsation}& Period of pulsation or oscillation of a body or a phenomenon\\
Q & \ucd{time.period.revolution}& Period of revolution of a body around a primary one (similar to year)\\
Q & \ucd{time.period.rotation}& Period of rotation of a body around its axis (similar to day)\\
Q & \ucd{time.phase}& Phase, position within a period\\
Expand Down Expand Up @@ -852,6 +867,36 @@ \subsection{Version tags in companion lists of terms: ucd-list.txt and ucd-list-
external software products.

\section{Changes from previous versions}
\subsection{Changes from UCDList EN v1.5 following RFM}
\subsubsection*{Additions}
\begin{itemize}
\item meta.coverage
\item time.period.pulsation
\item stat.confidenceLevel
\item stat.falseNegative
\item stat.falsePositive
\item phys.inspiralSpin
\item phys.voltage
\end{itemize}
Atmospheric measures at the telescope site :
\begin{itemize}
\item obs.atmos.humidity
\item obs.atmos.rain
\item obs.atmos.turbulence
\item obs.atmos.turbulence.isoplanatic
\item obs.atmos.water
\item obs.atmos.wind
\item phys.temperature.dew
\end{itemize}

\subsubsection*{Amendment}
Change position tag of stat.stdev to Q in order to combine it to stat.confidenceLevel, for instance

\subsubsection*{Deletion}
Deprecate term \emph{pos.lambert} (appearing in one table only) and propose \emph{pos.projection} instead.
In the future setting up a VO vocabulary to record projection names and identifiers together with the associated
parameters if needed, as defined in the Calabreta and Greisen FITS Paper \citep{2002A&A...395.1077C} on table 13.

\subsection{Changes from UCDList EN v1.4 following RFM}
\subsubsection*{Additions}
\ucd{stat.skewness}, \ucd{stat.kurtosis},\ucd{stat.mad} \\
Expand Down
16 changes: 16 additions & 0 deletions localrefs.bib
Original file line number Diff line number Diff line change
Expand Up @@ -43,5 +43,21 @@ @misc{std:UCDMAINT-PR
Url = {http://www.ivoa.net/documents/UCDlistMaintenance/},
Year = {2019},
}
@ARTICLE{2002A&A...395.1077C,
author = {{Calabretta}, M.~R. and {Greisen}, E.~W.},
title = "{Representations of celestial coordinates in FITS}",
journal = {\aap},
keywords = {methods: data analysis, techniques: image processing, astronomical data bases: miscellaneous, astrometry, Astrophysics},
year = 2002,
month = dec,
volume = {395},
pages = {1077-1122},
doi = {10.1051/0004-6361:20021327},
archivePrefix = {arXiv},
eprint = {astro-ph/0207413},
primaryClass = {astro-ph},
adsurl = {https://ui.adsabs.harvard.edu/abs/2002A&A...395.1077C},
adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}


5 changes: 4 additions & 1 deletion ucd-list-deprecated.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#EN-UCDlist-v1.5-2023-01-25
#PEN-UCDlist-v1.6-2024-09-11
# This file contains lists suggested replacements for UCD1+ which are deprecated
# deprecated_term replacement_term
em.IR.K.Brgamma em.line.Brgamma
Expand Down Expand Up @@ -100,6 +100,7 @@ pos.eq.dec.arcsec pos.eq.dec
pos.eq.ra.minutes pos.eq.ra
pos.eq.ra.seconds pos.eq.ra
pos.gal.compon pos.cartesian;pos.galactic

pos.sg.compon pos.cartesian;pos.supergalactic
src.class.star-galaxy src.class.starGalaxy
src.orbital.energy phys.energy;src.orbital
Expand Down Expand Up @@ -214,4 +215,6 @@ em.UV.FUV em.UV.100-200nm
meta.ref.ivorn meta.ref.ivoid
pos.bodyrc.long pos.bodyrc.lon
pos.eop.nutation pos.nutation
#Changes from 1.5 to 1.6
pos.lambert pos.projection
# This file distributed under CC-0 by the IVOA.
20 changes: 17 additions & 3 deletions ucd-list.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#EN-UCDlist-v1.5-2023-01-25
#PEN-UCDlist-v1.6-2024-09-11
Q | arith | Arithmetic quantities
S | arith.diff | Difference between two quantities described by the same UCD
P | arith.factor | Numerical factor
Expand Down Expand Up @@ -133,6 +133,7 @@ P | meta.code.mime | MIME type
P | meta.code.multip | Multiplicity or binarity flag
P | meta.code.qual | Quality, precision, reliability flag or code
P | meta.code.status | Status code (e.g.: status of a proposal/observation)
Q | meta.coverage | A coverage (spatial, temporal, spectral, etc) with any combination of physical axes (such as moc, tmoc, stmoc)
P | meta.cryptic | Unknown or impossible to understand quantity
Q | meta.curation | Parameter informing about the curation of the data
Q | meta.dataset | Dataset
Expand Down Expand Up @@ -172,7 +173,13 @@ S | obs | Observation
Q | obs.airMass | Airmass
S | obs.atmos | Atmosphere, atmospheric phenomena affecting an observation
Q | obs.atmos.extinction | Atmospheric extinction
Q | obs.atmos.humidity | Amount of air humidity at observing site during an observation
Q | obs.atmos.rain | Amount of rain at the telescope site during an observation
Q | obs.atmos.refractAngle | Atmospheric refraction angle
S | obs.atmos.turbulence | Related to atmospheric turbulence at the telescope site
P | obs.atmos.turbulence.isoplanatic | Isoplanatic angle characterising the atmospheric turbulence at telescope site
Q | obs.atmos.water | Amount of atmospheric water at observing site
S | obs.atmos.wind | Related to atmospheric wind at observing site
S | obs.calib | Calibration observation
S | obs.calib.flat | Related to flat-field calibration observation (dome, sky, ..)
S | obs.calib.dark | Related to dark current calibration
Expand Down Expand Up @@ -288,6 +295,7 @@ Q | phys.flux | Flux or flow of particle, energy, etc.
Q | phys.flux.energy | Energy flux, heat flux
Q | phys.gauntFactor | Gaunt factor/correction
Q | phys.gravity | Gravity
Q | phys.inspiralSpin | Effective inspiral spin in binary mergers (used in GW detections)
Q | phys.ionizParam | Ionization parameter
Q | phys.ionizParam.coll | Collisional ionization
Q | phys.ionizParam.rad | Radiative ionization
Expand Down Expand Up @@ -341,6 +349,7 @@ Q | phys.size.smajAxis | Linear semi major axis
Q | phys.size.sminAxis | Linear semi minor axis
Q | phys.size.smedAxis | Linear semi median axis for 3D ellipsoids
Q | phys.temperature | Temperature
Q | phys.temperature.dew | Dew temperature measured at the telescope site during an observation
Q | phys.temperature.effective | Effective temperature
Q | phys.temperature.electron | Electron temperature
Q | phys.transmission | Transmission (of filter, instrument, ...)
Expand All @@ -356,6 +365,7 @@ Q | phys.veloc.rotat | Rotational velocity
Q | phys.veloc.transverse | Transverse / tangential velocity
S | phys.virial | Related to virial quantities (mass, radius, ...)
Q | phys.volume | Volume (in cubic units)
Q | phys.voltage | Electric potential difference over a distance or measured by an instrument
Q | pos | Position and coordinates
Q | pos.angDistance | Angular distance, elongation
Q | pos.angResolution | Angular resolution
Expand Down Expand Up @@ -409,7 +419,6 @@ Q | pos.healpix | Hierarchical Equal Area IsoLatitude Pix
S | pos.heliocentric | Heliocentric position coordinate (solar system bodies)
Q | pos.HTM | Hierarchical Triangular Mesh
Q | pos.incidenceAng | Incidence angle of optical ray on an interface
S | pos.lambert | Lambert projection
S | pos.lg | Local Group reference frame
S | pos.lsr | Local Standard of Rest reference frame
Q | pos.lunar | Lunar coordinates
Expand All @@ -425,6 +434,7 @@ Q | pos.phaseAng | Phase angle, e.g. elongation of earth f
V | pos.pm | Proper motion
Q | pos.posAng | Position angle of a given vector
V | pos.precess | Precession (in equatorial coordinates)
Q | pos.projection | 2D spatial projection
Q | pos.resolution | Spatial linear resolution (not angular)
S | pos.spherical | Related to spherical coordinates
Q | pos.spherical.azi | Azimuthal angle (spherical coordinates)
Expand Down Expand Up @@ -497,10 +507,13 @@ Q | src.var.index | Variability index
Q | src.var.pulse | Pulse
Q | stat | Statistical parameters
Q | stat.asymmetry | Measure of asymmetry
P | stat.confidenceLevel | Level of confidence for a detection or classification process
P | stat.correlation | Correlation between two parameters
P | stat.covariance | Covariance between two parameters
P | stat.error | Statistical error
P | stat.error.sys | Systematic error
Q | stat.falsePositive | Rate of false alarm in detection problems
Q | stat.falseNegative | Rate of missed or false negative detection
Q | stat.filling | Filling factor (volume, time, ...)
Q | stat.fit | Fit
P | stat.fit.chi2 | Chi2
Expand All @@ -527,7 +540,7 @@ P | stat.rank | Rank or order in list of sorted values
P | stat.rms | Root mean square as square root of sum of squared values or quadratic mean
P | stat.skewness | Skewness of a probability distribution (third moment)
P | stat.snr | Signal to noise ratio
P | stat.stdev | Standard deviation as the square root of the variance
Q | stat.stdev | Standard deviation as the square root of the variance
S | stat.uncalib | Qualifier of a generic uncalibrated quantity
Q | stat.value | Miscellaneous value
P | stat.variance | Variance
Expand All @@ -543,6 +556,7 @@ Q | time.equinox | Equinox
Q | time.interval | Time interval, time-bin, time elapsed between two events, not the duration of an event
Q | time.lifetime | Lifetime
Q | time.period | Period, interval of time between the recurrence of phases in a periodic phenomenon
Q | time.period.pulsation | Period of pulsation or oscillation of a body or a phenomenon
Q | time.period.revolution | Period of revolution of a body around a primary one (similar to year)
Q | time.period.rotation | Period of rotation of a body around its axis (similar to day)
Q | time.phase | Phase, position within a period
Expand Down