SLAP-1_0-Err-1 < IVOA

IVOA Web>IvoaDAL>SLAP-1_0-Errata>SLAP-1_0-Err-1 (2022-09-26, MireilleLouys) (raw view)

---+ SLAP v1.0 Erratum 1: No longer require an invalid UCD

Author: Markus Demleitner

Date last changed: 2022-03-16

Date accepted: 2022-04-20

---++ Rationale

SLAP version 1.0 requires the UCD em.line on the column with the utype ssldm:Line.title. The current UCD list, however, marks the em.line atom as S, meaning it cannot stand in the first position of a full UCD. While its current definition (&ldquo;Designation of major atomic lines&rdquo;) does perhaps not fully justify that constraint, after some deliberation it seems preferable to resolve the contradiction between UCD 1.4 and SLAP 1.0 by updating the UCD in SLAP.

SLAP version 1.0 contains another invalid UCDs in appendix B (em.line;meta.cross.id). Since to our knowledge nobody intends to implement appendix B-type services and the material has additional problems (e.g., utypes without obvious counterparts in SSLDM), we opt to not try to repair these deficiencies and rather deprecate the appendix.

---++ Erratum Content

(1) In section 6.1 (Standard output fields), PDF page 16, replace

<blockquote>Exactly one field MUST have utype=&rdquo;ssldm:Line.title&rdquo;, with datatype="char" arraysize="*" and ucd=&rdquo;em.line&rdquo;, containing a small description identifying the line.</blockquote>

with

<blockquote>Exactly one field MUST have utype=&rdquo;ssldm:Line.title&rdquo;, with datatype="char" arraysize="*" and ucd=&rdquo;meta.id;em.line&rdquo;, containing a small description identifying the line.</blockquote>

(2) In appendix B (SLAP services for uncorrected and unidentified lines), on PDF page 21 add before the section content

<blockquote>The material in this section is deprecated and has several issues (invalid UCDs, undefined utypes). Implementors considering implementing SLAP for uncorrected and unidentified lines should contact the IVOA DAL Working Group at dal@ivoa.net.</blockquote>

(3) In appendix C (SLAP valid response example), PDF page 24, replace

<blockquote>&lt;FIELD ucd="em.line" name="IDENTIFICATION" utype="ldm:Line.title" datatype="char" arraysize="*"/&gt;</blockquote>

with

<blockquote>&lt;FIELD ucd="meta.id;em.line" name="IDENTIFICATION" utype="ldm:Line.title" datatype="char" arraysize="*"/&gt;</blockquote>

(4) In appendx D (SLAP data model summary), PDF page 25, replace "em.line" in the UCD column of the row for the utype ssldm:Line.title with "meta.id;em.line".

---++ Impact Assessment

Adding 'meta.id' before 'em.line' highlights the identifier role of the designated field and follows a good practice for UCD assignation.

SSAP clients do not identify fields by UCDs and hence are unaffected by this change. Clients relying on UCDs to determine how to treat individual columns may profit from the somewhat improved annotation.

Most importantly, valid SLAP services will no longer raise errors in UCD validation.

<br /> <!--
      * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup
-->

Topic revision: r3 - 2022-09-26 - MireilleLouys

IVOA

Log in or Register

IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics

Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki

TWiki intro
TWiki tutorial
User registration
Notify me

Working Groups

Interest Groups

Committees

Stds&Procs

www.ivoa.net
Documents
Events
Members
XML Schema