VOResource-1.2 Proposed Recommendation: Request for Comments
VOResource is an IVOA standard for describing astronomical resources (data collections, services, registries, tools...) within the Virtual Observatory. It provides an XML interchange format for use with registries, and lays the foundations upon which description schemes for concrete resources are built in various VOResource extensions.
Here is a brief summary of the changes from Recommendation 1.1:
- You can now use DOIs (or other identifier schemes like orcid) wherever we have a ResourceName so far, which includes relationship, authors, and the like.
- We now spell out what "using the UAT" for our subject keywords mean. If you publish resource records, this probably means that you will have to update them, as it is unlikely that they already have UAT keywords, let alone the with the right syntax.
- If you machine-readably declare your licenses, you should now use SPDX URIs.
- The bibliographic source can now be declared machine-readably with DOIs, too (before, there were only bibcodes).
Latest version of VOResource-1.2 can be found at:
Reference Interoperable Implementations
UAT keywords have been in use at GAVO and
VizieR for a long time now; see also
Sembarebro for a proof-of-concept-level interface using it.
To get an idea for why data providers should take up SPDX URIs, see a query that returns data distributed under CC0 (you should, really):
select ivoid from rr.resource
where rights_uri ILIKE 'https://spdx.org/licenses/CC0-1.0.html'
Relationships using altIdentifier are available from
VizieR (Gilles?).
All of the previous items do not need any special software support.
The ResourceName change requires software support, mainly in RegTAP. A
draft of what's needed is on the Heidelberg
RegTAP node.
(a) the altIdentifier on facility and instrument is translated into
res_detail. If you have an altIdentifier for a facility (ROR anyone?),
please register it. It will then show up next to the instrument
identifiers when you run
select *
from rr.res_detail
where detail_xpath like '%altIdentifier'
(b) the altIdentifier on contributor/name, publisher, and contributor
are in res_role. I've put in an orcid for demo. If you have orcid
fans among your data providers or want to add your own ROR in publisher,
please do that and you will show up in the result of
select *
from rr.res_role
where alt_identifier is not NULL
(c) the altIdentifier on relationship... this will show up in
select *
from rr.relationship
where related_alt_identifier is not NULL
But that's still waiting for actual records.
Implementations Validators
Basic validation is through any XML schema validator. If unsure, see the Makefile from
the source repository for how to use stilts to validate your instance documents.
The
RofR validator should be updated soon.
Comments from the IVOA Community during RFC/TCG review period: 2024-11-27 - 2025-01-07
The comments from the TCG members during the RFC/TCG review should be included in the next section.
In order to add a comment to the document, please edit this page and add your comment to the list below in the format used for the example (include your Wiki Name so that authors can contact you for further information). When the author(s) of the document have considered the comment, they will provide a response after the comment.
Additional discussion about any of the comments or responses can be conducted on the WG mailing list. However, please be sure to enter your initial comments here for full consideration in any future revisions of this document
Comments from TCG member during the RFC/TCG Review Period: 2024-11-27 - 2025-01-07
WG chairs or vice chairs must read the Document, provide comments if any (including on topics not directly linked to the Group matters) or indicate that they have no comment.
IG chairs or vice chairs are also encouraged to do the same, althought their inputs are not compulsory.
TCG Chair & Vice Chair
- BaptisteCecconi, 2024-11-27: The document uses "should" for specifying which vocabulary has to be used in the VOResource elements with controlled values: "The content of <subject> should be drawn from the Unified Astronomy Thesaurus". Same for content_level and content_type. Why don't we say "MUST"?
- BaptisteCecconi, 2024-11-27: In the Appendix A, one can read the quoted sentence "use fragments into http://www.ivoa.net/rdf/uat/#", but that quote is found nowhere in the text. It is probably harmless, but this makes all reference to Semantics vocabularies implict in the VOResource instances as well as in the VOResource schema. For the reuse of VOResource outside the IVOA (and for the ease of building application on top of VOResource content), I would be expecting that the reference to the URI scheme (e.g., http://www.ivoa.net/rdf/uat/#) is available formally, either in the VOResource.
- BaptisteCecconi, 2024-11-27: In section 3.2.2, the rightsURI can contain SPDX URIs. Is it really full URIs? as opposite from the previous comment case (IVOA-UAT, content_level, content_type), which are requiring NOT to use full URIs.
- BaptisteCecconi, 2024-11-27: In section 2.2.5, the DOI, ORCID and bibcodes identifiers are listed. I propose to also include ROR identifiers (Research Organization Registry: https://ror.org), to include identifiers for organizations.
TCG Vote : Vote_start_date - Vote_end_date
If you have minor comments (typos) on the last version of the document please indicate it in the Comments column of the table and post them in the TCG comments section above with the date.
Group |
Yes |
No |
Abstain |
Comments |
TCG |
|
|
|
|
Apps |
|
|
|
|
DAL |
|
|
|
|
DM |
|
|
|
|
GWS |
|
|
|
|
Registry |
|
|
|
|
Semantics |
|
|
|
|
DCP |
|
|
|
|
Edu |
|
|
|
|
KDIG |
|
|
|
|
Ops |
|
|
|
|
Radio |
|
|
|
|
SSIG |
|
|
|
|
Theory |
|
|
|
|
TD |
|
|
|
|
StdProc |
|
|
|
|