Merge pull request #46 from lmichel/xray-usecase

Xray usecase

doc/MANGO.tex

@@ -537,51 +537,6 @@ \subsection{Requirements}
 \end{itemize}
 
 
-%\subsubsection{Properties and Associated Data}
-% From the use-cases description, several categories of features must provided or foreseen by the projects:
-% 
-% \begin{itemize}
-%     \item The source \emph{properties} astronomers will investigate for their science.
-%           They are measures provided as numerical values or classification tags exposed as
-%           numbers or simple strings. 
-%           Usually one measure corresponds to one individual column or one group of columns.
-%         
-%     \item MANGO objects can be linked to external data referenced by WEB endpoints.
-%          % Such links are considered as object properties for which the model provides 
-%           an accurate way to specify the nature of these links. 
-%           Usually object links are provided by DataLinks services,
-%           then this MANGO feature is proposed to annotate datasets issued by services
-%           that do not implement such services but provide URLs in their query responses.
-%           
-%     \item MANGO objects can be linked to other collections of MANGO objects,
-%           associating sources with their detections, for example.
-%  \end{itemize}
-
-
-%\subsubsection{Supported Quantities}
-%\begin{itemize}[noitemsep,topsep=0pt,parsep=0pt,partopsep=0pt]
-  %  \item MANGO must provide unique source identifiers.
-  %  \item MANGO must provide information about the source origin.
-  %  \item The number of parameters attached to a MANGO instance must be free.
-%\end{itemize}
-
-%\subsubsection{Properties}
-%
-%\begin{itemize}[noitemsep,topsep=0pt,parsep=0pt,partopsep=0pt]
-%    \item MANGO must support explicit classes, native or imported from IVOA data-models, for the most used properties.
-%    \item MANGO must provide a generic way to support properties that do not enter the above category.
-%    \item MANGO object must support multiple instances of the same property class.
-%    \item The presence of any property in MANGO instances must be optional.
-%    \item MANGO must provide a way to identify the role of each property.
-%    \item MANGO must provide a way to identify the purpose of linked properties.
-%    \item  MANGO must provide a way to describe the meaning of flags or qualifiers.
-%    \item The role of each parameter should be machine-readable.
-%    \item It must be possible to group parameters in a free way.
-%          This allows for instance to tag properties with timestamps or flags.
-%    \item MANGO objects must support references to other MANGO objects.
-% \end{itemize}
-
-
 
 \section{Model Overview}
 
@@ -638,7 +593,8 @@ \subsubsection{Property Identification}
 
 \subsubsection{MANGO and MIVOT: Structuring Tabular Data}
 
-MANGO is primarily used to organise tabular data provided by TAP services \citep{2019ivoa.spec.0927D}.
+MANGO is primarily used to organise tabular data provided by TAP services \citep{2019ivoa.spec.0927D} 
+other DAL nodes (one of the reference implementation is based on a Vizier SCS).
 To achieve this, table rows must be linked to the model using MIVOT annotations.
 We propose two strategies for establishing this mapping:
 \begin{itemize}[noitemsep,topsep=0pt,parsep=0pt,partopsep=0pt]

doc/Makefile

@@ -7,7 +7,7 @@ DOCNAME = MANGO
 DOCVERSION = 0.1
 
 # Publication date, ISO format; update manually for "releases"
-DOCDATE = 2024-09-26
+DOCDATE = 2024-10-03
 
 # What is it you're writing: NOTE, WD, PR, REC, PEN, or EN
 DOCTYPE = WD

doc/ivoatexmeta.tex

@@ -1,7 +1,7 @@
 % GENERATED FILE -- edit this in the Makefile
 \newcommand{\ivoaDocversion}{0.1}
-\newcommand{\ivoaDocdate}{2024-09-26}
-\newcommand{\ivoaDocdatecode}{20240926}
+\newcommand{\ivoaDocdate}{2024-10-03}
+\newcommand{\ivoaDocdatecode}{20241003}
 \newcommand{\ivoaDoctype}{WD}
 \newcommand{\ivoaDocname}{MANGO}
 \renewcommand{\ivoaBaseURL}{https://www.ivoa.net/documents/MANGO}

doc/model.tex

@@ -34,7 +34,7 @@ \section{Model: mango }
   %\end{center}
   %\end{figure}
 
-  MO-del for AN-notating G-eneric O-bject
+  The purpose of MANGO, which stands for MO-del for AN-notating G-eneric O-objects, is to add an upper level of description to the tabular data of query responses. It allows metadata to be extended, complex quantities to be reconstructed from column values, and properties to be linked. It also allows to specify the origin af the data.
 
   \subsection{AssociatedMangoObject}
   \label{sect:AssociatedMangoObject}
@@ -500,7 +500,7 @@ \section{Model: mango }
     \item[\textbf{STC\_S}]: \textbf{vodml-id:} ShapeFrame.STC\_S \newline
           \textbf{description:} MOC serialization
     \item[\textbf{MOC}]: \textbf{vodml-id:} ShapeFrame.MOC \newline
-          \textbf{description:} STCs serialization
+          \textbf{description:} MOC serialization
   \end{itemize}
   \normalsize
 
@@ -518,7 +518,7 @@ \section{Model: mango }
     \item[\textbf{MOC}]: \textbf{vodml-id:} ShapeSerialization.MOC \newline
           \textbf{description:} Label indicating that the shape has been serialized as a S-MOC
     \item[\textbf{STCS}]: \textbf{vodml-id:} ShapeSerialization.STCS \newline
-          \textbf{description:} Label indicating that the shape has been serialized as a STCS string
+          \textbf{description:} Label indicating that the shape has been serialized as a STC-S \citep{2007ivoa.spec.1030R} string
     \item[\textbf{POLYGON}]: \textbf{vodml-id:} ShapeSerialization.POLYGON \newline
           \textbf{description:} Label indicating that the shape has been serialized as a polygon (cf xtypes)
   \end{itemize}
@@ -703,8 +703,8 @@ \section{Package: dataorigin }
       \textbf{multiplicity: 1} \newline
       Name of the article editor
 
-    \subsubsection{Article.article}
-      \textbf{vodml-id: dataorigin.Article.article} \newline
+    \subsubsection{Article.code}
+      \textbf{vodml-id: dataorigin.Article.code} \newline
       \textbf{type: \hyperref[sect:ivoa]{ivoa:string}} \newline
       \textbf{multiplicity: 1} \newline
       Bibcode or DOI of the reference article