From f5e662f059e2348a486a26380132579037692f2d Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 29 Sep 2021 11:29:25 +0200 Subject: [PATCH 01/38] Start to compile a document out of the schema --- doc/.gitignore | 7 ++++ doc/Makefile | 79 ++++++++++++++++++++++++++++++++++++++ doc/schema.bib | 14 +++++++ doc/schema.tex | 101 +++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 201 insertions(+) create mode 100644 doc/.gitignore create mode 100644 doc/Makefile create mode 100644 doc/schema.bib create mode 100644 doc/schema.tex diff --git a/doc/.gitignore b/doc/.gitignore new file mode 100644 index 0000000..dba8159 --- /dev/null +++ b/doc/.gitignore @@ -0,0 +1,7 @@ +*.aux +*.bbl +*.blg +*.log +*.out +*.pdf +*.toc diff --git a/doc/Makefile b/doc/Makefile new file mode 100644 index 0000000..0f62849 --- /dev/null +++ b/doc/Makefile @@ -0,0 +1,79 @@ +#========================================================================= +# Builders and flags: + +BIBTEX = bibtex +PDFLATEX = pdflatex +EPSTOPDF = epstopdf +INKSCAPE = inkscape --without-gui + +RM = rm -f +MV = mv + + +#========================================================================= +# Files: + +SRCS = schema + +LOGFILES = $(addsuffix .log, $(SRCS)) $(addsuffix .blg, $(SRCS)) \ + $(addsuffix .out, $(SRCS)) $(addsuffix .snm, $(SRCS)) +AUXFILES = $(addsuffix .aux, $(SRCS)) $(addsuffix .bbl, $(SRCS)) \ + $(addsuffix .vrb, $(SRCS)) $(addsuffix .toc, $(SRCS)) \ + $(addsuffix .nav, $(SRCS)) +RESFILES = $(addsuffix .pdf, $(SRCS)) + +BIBFILES = schema.bib + +#========================================================================= +# Maintargets: + +# default target +all: $(RESFILES) + +# clean: Remove temporary files +clean: + $(RM) $(LOGFILES) + +# realclean: Remove all intermediate files +realclean: + $(RM) $(AUXFILES) $(LOGFILES) + +# distclean: Remove all automatically created files +distclean: + $(RM) $(RESFILES) $(AUXFILES) $(LOGFILES) $(PDFIMGS) + +# Tell make, that the main targets are not actually files, that should +# considered to be build: +.PHONY: all clean realclean distclean + + +#========================================================================= +# Implicit rules: + +.SUFFIXES: +.SUFFIXES: .tex .pdf .eps .svg .dot + +%.bbl: %.tex + $(PDFLATEX) $* + $(BIBTEX) $* + +%.pdf: %.tex + while true; do \ + $(PDFLATEX) $*; \ + grep -s 'Rerun to get .* right' $*.log || break; \ + done + +%.pdf: %.eps + $(EPSTOPDF) $< + +%.eps: %.svg + $(INKSCAPE) --export-eps=$@ $< + +%.svg: %.gv + dot -Tsvg -o $@ $< + + +#========================================================================= +# Dependencies: +schema.bbl: schema.tex $(BIBFILES) +schema.pdf: schema.bbl schema.tex diff --git a/doc/schema.bib b/doc/schema.bib new file mode 100644 index 0000000..58e7abb --- /dev/null +++ b/doc/schema.bib @@ -0,0 +1,14 @@ +@Article{pidinst2020, + author = {Stocker, Markus and Darroch, Louise and Krahl, Rolf + and Habermann, Ted and Devaraju, Anusuriya and + Schwardmann, Ulrich and D'Onofrio, Claudio and + Häggström, Ingemar}, + title = {Persistent Identification of Instruments}, + journal = {Data Science Journal}, + year = 2020, + volume = 19, + number = 1, + pages = 18, + doi = {10.5334/dsj-2020-018} +} + diff --git a/doc/schema.tex b/doc/schema.tex new file mode 100644 index 0000000..d999ece --- /dev/null +++ b/doc/schema.tex @@ -0,0 +1,101 @@ +\documentclass[titlepage=true,twoside=true,DIV=11]{scrartcl} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage[colorlinks=true,urlcolor=black,linkcolor=black]{hyperref} + +\title{A Metadata Schema for the \\ + Persistent Identification of Instruments} + +\author{RDA Persistent Identification of Instruments WG} + +\begin{document} + +\maketitle +\cleardoublepage +\pagenumbering{roman} + +\section*{Contributors} + +\begin{itemize}\emergencystretch 3em +\item \emph{Rolf Krahl} + ({\small + \href{mailto:rolf.krahl@helmholtz-berlin.de}{rolf.krahl@helmholtz-berlin.de}, + \url{https://orcid.org/0000-0002-1266-3819}}), + Helmholtz-Zentrum Berlin für Materialien und Energie, + Albert-Einstein-Str.\ 15, 12489 Berlin, Germany +\item \emph{Louise Darroch} + ({\small + \href{mailto:louise.darroch@bodc.ac.uk}{louise.darroch@bodc.ac.uk}, + \url{https://orcid.org/0000-0003-4163-9575}}), + British Oceanographic Data Centre, National Oceanography Centre, + Liverpool, L3 5DA, United Kingdom +\item \emph{Robert Huber} + ({\small + \href{mailto:rhuber@uni-bremen.de}{rhuber@uni-bremen.de}, + \url{https://orcid.org/0000-0003-3000-0020}}), + MARUM - Center for Marine Environmental Sciences, University of Bremen, + Leobener Str.\ 8, 28359 Bremen, Germany +\item \emph{Anusuriya Devaraju} + ({\small + \href{mailto:adevaraju@marum.de}{adevaraju@marum.de}, + \url{https://orcid.org/0000-0003-0870-3192}}), + MARUM - Center for Marine Environmental Sciences, University of Bremen, + Leobener Str.\ 8, 28359 Bremen, Germany +\item \emph{Ted Habermann} + ({\small + \href{mailto:ted@tedhabermann.com}{ted@tedhabermann.com}, + \url{http://orcid.org/0000-0003-3585-6733}}), + Metadata Game Changers, + 3980 Broadway, Suite 103-185, Boulder, Colorado, USA 80304 +\item \emph{Markus Stocker} + ({\small + \href{mailto:markus.stocker@tib.eu}{markus.stocker@tib.eu}, + \url{https://orcid.org/0000-0001-5492-3212}}), + TIB Leibniz Information Centre for Science and Technology, + Welfengarten 1 B, 30167 Hannover, Germany and + PANGAEA, Center for Marine Environmental Sciences (MARUM), + University of Bremen, Leobener Str.\ 8, 28359 Bremen, Germany +\item \emph{The Research Data Alliance Persistent Identification of Instruments + Working Group members} + ({\small \url{https://www.rd-alliance.org/node/57186/members}}) +\end{itemize} + +\tableofcontents +\cleardoublepage +\pagenumbering{arabic} + +\section{Introduction} + +The Persistent Identification of Instruments WG (PIDINST) seeks to +explore a community-driven solution for globally unique identification +of measuring instruments operated in the sciences. + +Measuring instruments, such as sensors used in environmental science, +DNA sequencers used in life sciences or laboratory engines used for +medical domains, are widespread in most fields of applied sciences. +The ability to link an active instrument (instance) with an instrument +type and with the broader context in which the instrument operates, +including generated data, other instruments and platforms, people and +manufacturers, etc., is critical, especially for automated processing +of such contextual information and for the interpretation of generated +data. + +PIDINST is a working group in the Research Data Alliance (RDA). It +aims to establish a cross-discipline, operational solution for the +unique and lasting identification of measuring instruments actively +operated in the sciences. See \cite{pidinst2020} for an overview of +the work of PIDINST. + +The present document defines the metadata schema that PIDINST +developed for the description of an instrument instance. These +metadata items are supposed to be registered along with the persistent +identifier and stored in the PID infrastructure. + +\section{Metadata Schema} + +\ldots + +\bibliographystyle{plain} +\bibliography{schema} + +\end{document} From 1b427806dd65d7cce3493f97780f14aeb550d076 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 29 Sep 2021 16:44:24 +0200 Subject: [PATCH 02/38] Add version and date derived from the git repository --- doc/.gitignore | 1 + doc/Makefile | 12 ++++++++---- doc/meta.py | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ doc/schema.tex | 15 ++++++++++++++- 4 files changed, 71 insertions(+), 5 deletions(-) create mode 100644 doc/meta.py diff --git a/doc/.gitignore b/doc/.gitignore index dba8159..400eec4 100644 --- a/doc/.gitignore +++ b/doc/.gitignore @@ -5,3 +5,4 @@ *.out *.pdf *.toc +/.meta.tex diff --git a/doc/Makefile b/doc/Makefile index 0f62849..a141fb4 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -36,15 +36,19 @@ clean: # realclean: Remove all intermediate files realclean: - $(RM) $(AUXFILES) $(LOGFILES) + $(RM) $(AUXFILES) .meta.tex $(LOGFILES) # distclean: Remove all automatically created files distclean: - $(RM) $(RESFILES) $(AUXFILES) $(LOGFILES) $(PDFIMGS) + $(RM) $(RESFILES) $(AUXFILES) .meta.tex $(LOGFILES) $(PDFIMGS) + +# metafile: Create a file containing some metadata such as version and date +metafile: + python3 meta.py > .meta.tex # Tell make, that the main targets are not actually files, that should # considered to be build: -.PHONY: all clean realclean distclean +.PHONY: all clean realclean distclean metafile #========================================================================= @@ -76,4 +80,4 @@ distclean: #========================================================================= # Dependencies: schema.bbl: schema.tex $(BIBFILES) -schema.pdf: schema.bbl schema.tex +schema.pdf: metafile schema.bbl schema.tex diff --git a/doc/meta.py b/doc/meta.py new file mode 100644 index 0000000..064346d --- /dev/null +++ b/doc/meta.py @@ -0,0 +1,48 @@ +#! /usr/bin/python3 + +import datetime +import os +from pathlib import Path +import subprocess + +class GitProps: + """Determine properties of the git repository. + """ + + def __init__(self, root="."): + self.root = Path(root).resolve() + + def _exec(self, cmd): + proc = subprocess.run(cmd.split(), + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + cwd=self.root, + check=True, + env=dict(os.environ, LC_ALL='C'), + universal_newlines=True) + return proc.stdout.strip() + + @property + def is_dirty(self): + return bool(self._exec("git status --porcelain --untracked-files=no")) + + @property + def date(self): + if self.is_dirty: + d = datetime.date.today() + else: + ts = int(self._exec("git log -1 --format=%cd --date=unix")) + d = datetime.date.fromtimestamp(ts) + return d.strftime("%e %B %Y").strip() + + @property + def version(self): + return self._exec("git describe --always --dirty").strip() + +def main(): + git = GitProps() + print("\\newcommand{\\schemaversion}{%s}" % git.version) + print("\\newcommand{\\schemadate}{%s}" % git.date) + +if __name__ == "__main__": + main() diff --git a/doc/schema.tex b/doc/schema.tex index d999ece..205e147 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -3,14 +3,27 @@ \usepackage[T1]{fontenc} \usepackage[colorlinks=true,urlcolor=black,linkcolor=black]{hyperref} +\input{.meta} + \title{A Metadata Schema for the \\ Persistent Identification of Instruments} - \author{RDA Persistent Identification of Instruments WG} +\date{\schemadate} \begin{document} \maketitle + +\begin{center} + \begin{tabular}[t]{|l|l|} + \hline + Version & \schemaversion \\ + \hline + Date & \schemadate \\ + \hline + \end{tabular} +\end{center} + \cleardoublepage \pagenumbering{roman} From c6eb885b2c481f4ff8345f0818fd9909e7524323 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 5 Oct 2021 16:42:55 +0200 Subject: [PATCH 03/38] Add table with the schema properties. This already anticipates #55 to be merged. --- doc/schema.tex | 201 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 199 insertions(+), 2 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 205e147..c2415f4 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -1,7 +1,9 @@ -\documentclass[titlepage=true,twoside=true,DIV=11]{scrartcl} +\documentclass[titlepage=true,twoside=false,DIV=13]{scrartcl} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage[colorlinks=true,urlcolor=black,linkcolor=black]{hyperref} +\usepackage{longtable} +\usepackage{enumitem} \input{.meta} @@ -106,7 +108,202 @@ \section{Introduction} \section{Metadata Schema} -\ldots +\newlength{\idcolw}\settowidth{\idcolw}{5.3.1} +\newlength{\propcolw}\settowidth{\propcolw}{instrumentTypeIdentifierType} +\newlength{\occcolw}\settowidth{\occcolw}{Occ} +\newlength{\valcolw}\settowidth{\valcolw}{Controlled list of values:} +\newlength{\defcolw} +\setlength{\defcolw}{\textwidth} +\addtolength{\defcolw}{-\idcolw} +\addtolength{\defcolw}{-\propcolw} +\addtolength{\defcolw}{-\occcolw} +\addtolength{\defcolw}{-\valcolw} +\addtolength{\defcolw}{-10\tabcolsep} + +\begin{longtable}{|l|l|l|p{\defcolw}|p{\valcolw}|} + \hline + ID & Property & Occ + & Definition & Allowed values, constraints, remarks \\ + \hline \endhead + 1 & Identifier & 1 + & Unique string that identifies the instrument instance & \\ + \hline + 1.1 & identifierType & 1 + & Type of the identifier & \\ + \hline + 2 & SchemaVersion & 1 + & Version number of the PIDINST schema used in this record + & Fixed value: \schemaversion \\ + \hline + 3 & LandingPage & 1 + & A landing page that the identifier resolves to & URL \\ + \hline + 4 & Name & 1 + & Name by which the instrument instance is known & Free text \\ + \hline + 5 & Owner & 1-n + & Institution(s) responsible for the management of the + instrument. This may include the legal owner, the operator, + or an institute providing access to the instrument. + & \\ + \hline + 5.1 & ownerName & 1 + & Full name of the owner & Free text \\ + \hline + 5.2 & ownerContact & 0-1 + & Contact address of the owner & Electronic mail address \\ + \hline + 5.3 & ownerIdentifier & 0-1 + & Identifier used to identify the owner + & Free text, should be a globally unique identifier \\ + \hline + 5.3.1 & ownerIdentifierType & 1 + & Type of the identifier & Free text \\ + \hline + 6 & Manufacturer & 1-n + & The instrument's manufacturer(s) or developer. This may + also be the owner for custom build instruments. + & \\ + \hline + 6.1 & manufacturerName & 1 + & Full name of the manufacturer & Free text \\ + \hline + 6.2 & manufacturerIdentifier & 0-1 + & Identifier used to identify the manufacturer + & Free text, should be a globally unique identifier \\ + \hline + 6.2.1 & manufacturerIdentifierType & 1 + & Type of the identifier & Free text \\ + \hline + 7 & Model & 0-1 + & Name of the model or type of device as attributed by the + manufacturer + & \\ + \hline + 7.1 & modelName & 1 + & Full name of the model & Free text \\ + \hline + 7.2 & modelIdentifier & 0-1 + & Identifier used to identify the model + & Free text, should be a globally unique identifier \\ + \hline + 7.2.1 & modelIdentifierType & 1 + & Type of the identifier & Free text \\ + \hline + 8 & Description & 0-1 + & Technical description of the device and its capabilities + & Free text \\ + \hline + 9 & InstrumentType & 0-n + & Classification of the type of the instrument & \\ + \hline + 9.1 & instrumentTypeName & 1 + & Full name of the instrument type & Free text \\ + \hline + 9.2 & instrumentTypeIdentifier & 0-1 + & Identifier used to identify the type of the instrument + & Free text, should be a globally unique identifier \\ + \hline + 9.2.1 & instrumentTypeIdentifierType & 1 + & Type of the identifier & Free text \\ + \hline + 10 & MeasuredVariable & 0-n + & The variable(s) that this instrument measures or observes + & Free text \\ + \hline + 11 & Date & 0-n + & Dates relevant to the instrument & ISO 8601 \\ + \hline + 11.1 & dateType & 1 + & The type of the date + & \begin{minipage}[t]{\valcolw} + Controlled list of values: + \begin{itemize}[nosep,leftmargin=3.5ex] + \item Commissioned + \item DeCommissioned + \end{itemize} + \vspace{1ex} + \end{minipage} \\ + \hline + 12 & RelatedIdentifier & 0-n + & Identifiers of related resources & Free text, must be globally unique identifiers \\ + \hline + 12.1 & relatedIdentifierType & 1 + & Type of the identifier + & \begin{minipage}[t]{\valcolw} + Controlled list of values: + \begin{itemize}[nosep,leftmargin=3.5ex] + \item ARK + \item arXiv + \item bibcode + \item DOI + \item EAN13 + \item EISSN + \item Handle + \item IGSN + \item ISBN + \item ISSN + \item ISTC + \item LISSN + \item PMID + \item PURL + \item RAiD + \item RRID + \item UPC + \item URL + \item URN + \item w3id + \end{itemize} + \vspace{1ex} + \end{minipage} \\ + \hline + 12.2 & relationType & 1 + & Description of the relationship + & \begin{minipage}[t]{\valcolw} + Controlled list of values: + \begin{itemize}[nosep,leftmargin=3.5ex] + \item IsDescribedBy + \item IsNewVersionOf + \item IsPreviousVersionOf + \item HasComponent + \item IsComponentOf + \item References + \item HasMetadata + \item WasUsedIn + \item IsIdenticalTo + \item IsAttachedTo + \end{itemize} + \vspace{1ex} + \end{minipage} \\ + \hline + 12.3 & relatedIdentifierName & 0-1 + & A name for the related resource, may be used to give a hint on the content of that resource & Free text \\ + \hline + 13 & AlternateIdentifier & 0-n + & Identifiers other than the PIDINST pertaining to the same + instrument instance. This should be used if the instrument + has a serial number. Other possible uses include an owner's + inventory number or an entry in some instrument data base. + & Free text, should be unique identifiers \\ + \hline + 13.1 & alternateIdentifierType & 1 + & Type of the identifier + & \begin{minipage}[t]{\valcolw} + Controlled list of values: + \begin{itemize}[nosep,leftmargin=3.5ex] + \item SerialNumber + \item InventoryNumber + \item Other + \end{itemize} + \vspace{1ex} + \end{minipage} \\ + \hline + 13.2 & alternateIdentifierName & 0-1 + & A supplementary name for the identifier type. This is + mostly useful if alternateIdentifierType is Other. + & Free text \\ + \hline +\end{longtable} \bibliographystyle{plain} \bibliography{schema} From 5fe7195aeea5d850bfafd9ce43cbaed27f054b9e Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 5 Oct 2021 16:48:36 +0200 Subject: [PATCH 04/38] Some more tweaks to the property table --- doc/schema.tex | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index c2415f4..5ebe9fd 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -110,7 +110,7 @@ \section{Metadata Schema} \newlength{\idcolw}\settowidth{\idcolw}{5.3.1} \newlength{\propcolw}\settowidth{\propcolw}{instrumentTypeIdentifierType} -\newlength{\occcolw}\settowidth{\occcolw}{Occ} +\newlength{\occcolw}\settowidth{\occcolw}{\emph{Occ}} \newlength{\valcolw}\settowidth{\valcolw}{Controlled list of values:} \newlength{\defcolw} \setlength{\defcolw}{\textwidth} @@ -122,18 +122,22 @@ \section{Metadata Schema} \begin{longtable}{|l|l|l|p{\defcolw}|p{\valcolw}|} \hline - ID & Property & Occ - & Definition & Allowed values, constraints, remarks \\ + \emph{ID} & \emph{Property} & \emph{Occ} + & \emph{Definition} + & \emph{Allowed values, constraints, remarks} \\ \hline \endhead 1 & Identifier & 1 & Unique string that identifies the instrument instance & \\ \hline 1.1 & identifierType & 1 - & Type of the identifier & \\ + & Type of the identifier + & The type of the identifier depends on the provider being + used to register it. In the case of ePIC, the value would + be ``Handle''. \\ \hline 2 & SchemaVersion & 1 & Version number of the PIDINST schema used in this record - & Fixed value: \schemaversion \\ + & Fixed value: ``\schemaversion'' \\ \hline 3 & LandingPage & 1 & A landing page that the identifier resolves to & URL \\ @@ -226,7 +230,8 @@ \section{Metadata Schema} \end{minipage} \\ \hline 12 & RelatedIdentifier & 0-n - & Identifiers of related resources & Free text, must be globally unique identifiers \\ + & Identifiers of related resources + & Free text, must be globally unique identifiers \\ \hline 12.1 & relatedIdentifierType & 1 & Type of the identifier @@ -277,7 +282,9 @@ \section{Metadata Schema} \end{minipage} \\ \hline 12.3 & relatedIdentifierName & 0-1 - & A name for the related resource, may be used to give a hint on the content of that resource & Free text \\ + & A name for the related resource, may be used to give a hint + on the content of that resource + & Free text \\ \hline 13 & AlternateIdentifier & 0-n & Identifiers other than the PIDINST pertaining to the same @@ -303,6 +310,8 @@ \section{Metadata Schema} mostly useful if alternateIdentifierType is Other. & Free text \\ \hline + \caption{Expanded PIDINST properties} + \label{schema:tab:expandprops} \end{longtable} \bibliographystyle{plain} From 0e8252c4ab8d0fe3bd064b38686a60042c420c21 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 5 Oct 2021 18:21:06 +0200 Subject: [PATCH 05/38] Add an Overview subsection to Metadata Schema --- doc/schema.tex | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/doc/schema.tex b/doc/schema.tex index 5ebe9fd..c993129 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -108,6 +108,61 @@ \section{Introduction} \section{Metadata Schema} +The PIDINST metadata provide a general description of the instrument. +It contains enough information to identify the individual instrument +instance and to link other sources of information and related +entities. + +The PIDINST metadata schema must to be applicable to various kinds of +instruments being used in all scientific domains. It thus needs to +keep somewhat generic. An in-depth technical description of the +instrument is not possible at that level. But more detailed, +community specific descriptions may be linked to the PIDINST record +using RelatedIdentifier with relationType IsDescribedBy or +HasMetadata. + +\subsection{Overview} + +Table \ref{schema:tab:propoverview} provides an overview of the +properties in the PIDINST schema. The last column indicates whether +the property is +\begin{itemize} +\item Mandatory (M); the property must be provided for the metadata + record to be valid, +\item Recommended (R); the property is optional, but it is recommended + to be added if applicable, or +\item Optional (O); the property may be added to provide a richer + description. +\end{itemize} +In the present version of the schema, all properties are either +mandatory or recommended. But future versions may also add optional +properties. + +\begin{longtable}{|l|l|l|} + \hline + \emph{ID} & \emph{Property} & \emph{Obligation} \\ + \hline \endhead + \hline \endfoot\endlastfoot + 1 & Identifier & M \\ + 2 & SchemaVersion & M \\ + 3 & LandingPage & M \\ + 4 & Name & M \\ + 5 & Owner & M \\ + 6 & Manufacturer & M \\ + 7 & Model & R \\ + 8 & Description & R \\ + 9 & InstrumentType & R \\ + 10 & MeasuredVariable & R \\ + 11 & Date & R \\ + 12 & RelatedIdentifier & R \\ + 13 & AlternateIdentifier & R \\ + \hline + \caption{Overview of PIDINST properties} + \label{schema:tab:propoverview} +\end{longtable} + +\subsection{Definition of the PIDINST properties} + \newlength{\idcolw}\settowidth{\idcolw}{5.3.1} \newlength{\propcolw}\settowidth{\propcolw}{instrumentTypeIdentifierType} \newlength{\occcolw}\settowidth{\occcolw}{\emph{Occ}} From 73399143e30e6e231c56b65fd40b82bc36867030 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 11:07:12 +0200 Subject: [PATCH 06/38] Minor fixes --- doc/schema.tex | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/schema.tex b/doc/schema.tex index c993129..03a3c0c 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -16,6 +16,7 @@ \maketitle +\thispagestyle{empty} \begin{center} \begin{tabular}[t]{|l|l|} \hline @@ -116,7 +117,7 @@ \section{Metadata Schema} The PIDINST metadata schema must to be applicable to various kinds of instruments being used in all scientific domains. It thus needs to keep somewhat generic. An in-depth technical description of the -instrument is not possible at that level. But more detailed, +instrument is not practicable at that level. But more detailed, community specific descriptions may be linked to the PIDINST record using RelatedIdentifier with relationType IsDescribedBy or HasMetadata. From 70d5478a3db65cca877f1ca1405d9e6344f3bbf5 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 11:08:35 +0200 Subject: [PATCH 07/38] Use the proper dash (en dash) in the occurence column --- doc/schema.tex | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 03a3c0c..fe7bde6 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -164,6 +164,7 @@ \subsection{Overview} \subsection{Definition of the PIDINST properties} + \newlength{\idcolw}\settowidth{\idcolw}{5.3.1} \newlength{\propcolw}\settowidth{\propcolw}{instrumentTypeIdentifierType} \newlength{\occcolw}\settowidth{\occcolw}{\emph{Occ}} @@ -201,7 +202,7 @@ \subsection{Definition of the PIDINST properties} 4 & Name & 1 & Name by which the instrument instance is known & Free text \\ \hline - 5 & Owner & 1-n + 5 & Owner & 1--n & Institution(s) responsible for the management of the instrument. This may include the legal owner, the operator, or an institute providing access to the instrument. @@ -210,17 +211,17 @@ \subsection{Definition of the PIDINST properties} 5.1 & ownerName & 1 & Full name of the owner & Free text \\ \hline - 5.2 & ownerContact & 0-1 + 5.2 & ownerContact & 0--1 & Contact address of the owner & Electronic mail address \\ \hline - 5.3 & ownerIdentifier & 0-1 + 5.3 & ownerIdentifier & 0--1 & Identifier used to identify the owner & Free text, should be a globally unique identifier \\ \hline 5.3.1 & ownerIdentifierType & 1 & Type of the identifier & Free text \\ \hline - 6 & Manufacturer & 1-n + 6 & Manufacturer & 1--n & The instrument's manufacturer(s) or developer. This may also be the owner for custom build instruments. & \\ @@ -228,14 +229,14 @@ \subsection{Definition of the PIDINST properties} 6.1 & manufacturerName & 1 & Full name of the manufacturer & Free text \\ \hline - 6.2 & manufacturerIdentifier & 0-1 + 6.2 & manufacturerIdentifier & 0--1 & Identifier used to identify the manufacturer & Free text, should be a globally unique identifier \\ \hline 6.2.1 & manufacturerIdentifierType & 1 & Type of the identifier & Free text \\ \hline - 7 & Model & 0-1 + 7 & Model & 0--1 & Name of the model or type of device as attributed by the manufacturer & \\ @@ -243,35 +244,35 @@ \subsection{Definition of the PIDINST properties} 7.1 & modelName & 1 & Full name of the model & Free text \\ \hline - 7.2 & modelIdentifier & 0-1 + 7.2 & modelIdentifier & 0--1 & Identifier used to identify the model & Free text, should be a globally unique identifier \\ \hline 7.2.1 & modelIdentifierType & 1 & Type of the identifier & Free text \\ \hline - 8 & Description & 0-1 + 8 & Description & 0--1 & Technical description of the device and its capabilities & Free text \\ \hline - 9 & InstrumentType & 0-n + 9 & InstrumentType & 0--n & Classification of the type of the instrument & \\ \hline 9.1 & instrumentTypeName & 1 & Full name of the instrument type & Free text \\ \hline - 9.2 & instrumentTypeIdentifier & 0-1 + 9.2 & instrumentTypeIdentifier & 0--1 & Identifier used to identify the type of the instrument & Free text, should be a globally unique identifier \\ \hline 9.2.1 & instrumentTypeIdentifierType & 1 & Type of the identifier & Free text \\ \hline - 10 & MeasuredVariable & 0-n + 10 & MeasuredVariable & 0--n & The variable(s) that this instrument measures or observes & Free text \\ \hline - 11 & Date & 0-n + 11 & Date & 0--n & Dates relevant to the instrument & ISO 8601 \\ \hline 11.1 & dateType & 1 @@ -285,7 +286,7 @@ \subsection{Definition of the PIDINST properties} \vspace{1ex} \end{minipage} \\ \hline - 12 & RelatedIdentifier & 0-n + 12 & RelatedIdentifier & 0--n & Identifiers of related resources & Free text, must be globally unique identifiers \\ \hline @@ -337,12 +338,12 @@ \subsection{Definition of the PIDINST properties} \vspace{1ex} \end{minipage} \\ \hline - 12.3 & relatedIdentifierName & 0-1 + 12.3 & relatedIdentifierName & 0--1 & A name for the related resource, may be used to give a hint on the content of that resource & Free text \\ \hline - 13 & AlternateIdentifier & 0-n + 13 & AlternateIdentifier & 0--n & Identifiers other than the PIDINST pertaining to the same instrument instance. This should be used if the instrument has a serial number. Other possible uses include an owner's @@ -361,7 +362,7 @@ \subsection{Definition of the PIDINST properties} \vspace{1ex} \end{minipage} \\ \hline - 13.2 & alternateIdentifierName & 0-1 + 13.2 & alternateIdentifierName & 0--1 & A supplementary name for the identifier type. This is mostly useful if alternateIdentifierType is Other. & Free text \\ From 663bcdd92a9f654c41f83c81183896f1be6c1d3d Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 11:25:23 +0200 Subject: [PATCH 08/38] Add some explanations to the expanded property table --- doc/schema.tex | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/schema.tex b/doc/schema.tex index fe7bde6..45d655c 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -164,6 +164,38 @@ \subsection{Overview} \subsection{Definition of the PIDINST properties} +Table \ref{schema:tab:expandprops} provides a detailed description for +the properties in the PIDINST metadata schema. + +There are simple properties that take just one value, such as Name and +Description. Other complex properties are composed of multiple +sub-properties. For instance Owner is composed of ownerName, +ownerContact, and ownerIdentifier, the latter in turn having another +sub-property ownerIdentifierType. The structure of properties and +sub-properties is indicated in the numbering in the ID column, +e.g.\ 5.3.1 (ownerIdentifierType) is a sub-property of 5.3 +(ownerIdentifier). + +The number of occurrences for any property in one PIDINST metadata +record is indicated in the column labeled ``Occ''. The meaning is: +\begin{itemize} +\item 1: a mandatory property that must appear once, +\item 0--1: an optional property that may appear at most once, +\item 1--n: a mandatory property with multiple values, e.g.\ the + property may appear one or more times in a single record, +\item 0--n: a multivalued optional property that may appear appear zero + or more times in a record. +\end{itemize} +In the case of a sub-property, the occurrence is to be understood +within each of the parent entries. E.g.\ a PIDINST record may have +zero or more RelatedIdentifier (occ.\ 0--n). Each of them must have +one relatedIdentifierType (occ.\ 1) and one relationType (occ.\ 1) and +may optionally have one relatedIdentifierName (occ.\ 0--1). Another +example: a PIDINST record must have one or more Manufacturer +(occ.\ 0--n). Each of them must have a manufacturerName (occ.\ 1) and +may have a manufacturerIdentifier (occ.\ 0--1). If a +manufacturerIdentifier is included for a Manufacturer, it must also +have a manufacturerIdentifierType (occ.\ 1). \newlength{\idcolw}\settowidth{\idcolw}{5.3.1} \newlength{\propcolw}\settowidth{\propcolw}{instrumentTypeIdentifierType} From e429f353bfce26297c13a57d06643a9c83194459 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 12:11:11 +0200 Subject: [PATCH 09/38] Add standard values for unknown information --- doc/schema.bib | 7 +++++++ doc/schema.tex | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 41 insertions(+) diff --git a/doc/schema.bib b/doc/schema.bib index 58e7abb..e3b7e9d 100644 --- a/doc/schema.bib +++ b/doc/schema.bib @@ -12,3 +12,10 @@ @Article{pidinst2020 doi = {10.5334/dsj-2020-018} } +@Misc{datacite:schema, + author = {DataCite}, + title = {DataCite Metadata Schema 4.4}, + month = mar, + year = 2021, + url = {https://schema.datacite.org/meta/kernel-4.4/} +} diff --git a/doc/schema.tex b/doc/schema.tex index 45d655c..6575529 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -162,6 +162,10 @@ \subsection{Overview} \label{schema:tab:propoverview} \end{longtable} +If a value for any of the mandatory properties is not available, one +of the standard values for unknown information may be used instead, +see Appendix \ref{appendix:unknown}. + \subsection{Definition of the PIDINST properties} Table \ref{schema:tab:expandprops} provides a detailed description for @@ -403,6 +407,36 @@ \subsection{Definition of the PIDINST properties} \label{schema:tab:expandprops} \end{longtable} +\appendix + +\section{Standard values for unknown information} + \label{appendix:unknown} + +For the case that the value for a mandatory property is unknown or not +available, we adopt the standard values for unknown information from +the DataCite Metadata Schema \cite{datacite:schema}. These values are +repeated here in Table \ref{appendix:tab:unknown}. + +\begin{longtable}{|l|l|} + \hline + \emph{Code} & \emph{Definition} \\ + \hline \endhead + \hline \endfoot\endlastfoot + :unac & temporarily inaccessible \\ + :unal & unallowed, suppressed intentionally \\ + :unap & not applicable, makes no sense \\ + :unas & value unassigned (e.g., Untitled) \\ + :unav & value unavailable, possibly unknown \\ + :unkn & known to be unknown (e.g., Anonymous, Inconnue) \\ + :none & never had a value, never will \\ + :null & explicitly and meaningfully empty \\ + :tba & to be assigned or announced later \\ + :etal & too numerous to list (et alia) \\ + \hline + \caption{Standard values for unknown information} + \label{appendix:tab:unknown} +\end{longtable} + \bibliographystyle{plain} \bibliography{schema} From 45348552d170451c9796e6a822089b507367aaf7 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 13:05:42 +0200 Subject: [PATCH 10/38] Remove the article from the title --- doc/schema.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/schema.tex b/doc/schema.tex index 6575529..34bf066 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -7,7 +7,7 @@ \input{.meta} -\title{A Metadata Schema for the \\ +\title{Metadata Schema for the \\ Persistent Identification of Instruments} \author{RDA Persistent Identification of Instruments WG} \date{\schemadate} From 09fe3307bb32ba48e2dd2fe9b1e9dd5f76eaddd9 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 13:08:27 +0200 Subject: [PATCH 11/38] Add a reference to the Schema GitHub repo --- doc/schema.bib | 8 ++++++++ doc/schema.tex | 3 +++ 2 files changed, 11 insertions(+) diff --git a/doc/schema.bib b/doc/schema.bib index e3b7e9d..aef22f3 100644 --- a/doc/schema.bib +++ b/doc/schema.bib @@ -1,3 +1,11 @@ +@Misc{pidinst:github, + author = {RDA Persistent Identification of Instruments WG}, + title = {Medadata Schema for the + Persistent Identification of Scientific Instruments}, + note = {Code repository}, + url = {https://github.com/rdawg-pidinst/schema} +} + @Article{pidinst2020, author = {Stocker, Markus and Darroch, Louise and Krahl, Rolf and Habermann, Ted and Devaraju, Anusuriya and diff --git a/doc/schema.tex b/doc/schema.tex index 34bf066..e8a3cca 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -107,6 +107,9 @@ \section{Introduction} metadata items are supposed to be registered along with the persistent identifier and stored in the PID infrastructure. +The schema is maintained in the code repository of the working group +\cite{pidinst:github}. + \section{Metadata Schema} The PIDINST metadata provide a general description of the instrument. From 1b6e7038c0f6e825b1c4f7350ecd06f8abfc93ca Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 6 Oct 2021 15:11:18 +0200 Subject: [PATCH 12/38] Minor fixes --- doc/schema.tex | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index e8a3cca..4cf7efc 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -117,9 +117,9 @@ \section{Metadata Schema} instance and to link other sources of information and related entities. -The PIDINST metadata schema must to be applicable to various kinds of -instruments being used in all scientific domains. It thus needs to -keep somewhat generic. An in-depth technical description of the +The PIDINST metadata schema must be applicable to various kinds of +instruments being used in all scientific domains. It thus needs to be +kept somewhat generic. An in-depth technical description of the instrument is not practicable at that level. But more detailed, community specific descriptions may be linked to the PIDINST record using RelatedIdentifier with relationType IsDescribedBy or From b25e4c7e4189f0c58f60c2b156a4f7ecaf8a8251 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Fri, 29 Oct 2021 16:01:20 +0200 Subject: [PATCH 13/38] Update affiliation of Anusuriya Devaraju as indicated in Google Doc --- doc/schema.tex | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 4cf7efc..e986975 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -55,8 +55,9 @@ \section*{Contributors} ({\small \href{mailto:adevaraju@marum.de}{adevaraju@marum.de}, \url{https://orcid.org/0000-0003-0870-3192}}), - MARUM - Center for Marine Environmental Sciences, University of Bremen, - Leobener Str.\ 8, 28359 Bremen, Germany + Terrestrial Ecosystem Research Network (TERN), The University of + Queensland, Long Pocket Precinct, Level 5 Foxtail Building \#1019, + 80 Meiers Road, Indooroopilly QLD 4068 Australia \item \emph{Ted Habermann} ({\small \href{mailto:ted@tedhabermann.com}{ted@tedhabermann.com}, From c21982c9713e0126f569557b5f9762d4a13de52c Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Fri, 29 Oct 2021 17:37:36 +0200 Subject: [PATCH 14/38] Adopt many suggestions for the introduction made by Anusuriya Devaraju and Louise Darroch in the Google doc --- doc/schema.tex | 49 ++++++++++++++++++++++++++----------------------- 1 file changed, 26 insertions(+), 23 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index e986975..4da2bf7 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -83,33 +83,36 @@ \section*{Contributors} \section{Introduction} -The Persistent Identification of Instruments WG (PIDINST) seeks to -explore a community-driven solution for globally unique identification -of measuring instruments operated in the sciences. +The Persistent Identification of Instruments Working Group (PIDINST) +seeks to explore a community-driven solution for globally unique and +persistent identification of instruments operated in the sciences. -Measuring instruments, such as sensors used in environmental science, -DNA sequencers used in life sciences or laboratory engines used for +Instruments, such as sensors used in environmental science, DNA +sequencers used in life sciences or laboratory engines used for medical domains, are widespread in most fields of applied sciences. -The ability to link an active instrument (instance) with an instrument -type and with the broader context in which the instrument operates, -including generated data, other instruments and platforms, people and -manufacturers, etc., is critical, especially for automated processing -of such contextual information and for the interpretation of generated -data. +The ability to link a physical instrument with its metadata including +its type and contexts in which the instrument operates, such as +generated data, other instruments and platforms, people and +manufacturers, is critical, especially for automated processing of +such contextual information and for the interpretation of data +generated. PIDINST is a working group in the Research Data Alliance (RDA). It -aims to establish a cross-discipline, operational solution for the -unique and lasting identification of measuring instruments actively -operated in the sciences. See \cite{pidinst2020} for an overview of -the work of PIDINST. - -The present document defines the metadata schema that PIDINST -developed for the description of an instrument instance. These -metadata items are supposed to be registered along with the persistent -identifier and stored in the PID infrastructure. - -The schema is maintained in the code repository of the working group -\cite{pidinst:github}. +aims to establish a cross-discipline, practical solution for the +globally unique and permanent identification of a physical instrument +that can act as an anchor for associated metadata. See +\cite{pidinst2020} for an overview of PIDINST. + +The solution uses a resolvable persistent identifier (PID) published +with a descriptive metadata schema that helps identify the instrument +as well as enable linkages to other external metadata. The present +document defines the metadata schema that PIDINST developed for the +description of an instrument instance. These metadata items are +supposed to be registered along with the persistent identifier and +stored in the PID infrastructure. + +The schema is publicly available for reuse and maintained in the code +repository of the working group \cite{pidinst:github}. \section{Metadata Schema} From 48328d7748fff15f932315a69c0bdccc5965c78b Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Fri, 29 Oct 2021 18:35:41 +0200 Subject: [PATCH 15/38] Adopt many suggestions for the text of the Metadata Schema section made by Anusuriya Devaraju and Louise Darroch in the Google doc --- doc/schema.tex | 42 +++++++++++++++++++++++------------------- 1 file changed, 23 insertions(+), 19 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 4da2bf7..bf8269c 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -116,24 +116,27 @@ \section{Introduction} \section{Metadata Schema} -The PIDINST metadata provide a general description of the instrument. -It contains enough information to identify the individual instrument -instance and to link other sources of information and related -entities. - -The PIDINST metadata schema must be applicable to various kinds of -instruments being used in all scientific domains. It thus needs to be -kept somewhat generic. An in-depth technical description of the -instrument is not practicable at that level. But more detailed, -community specific descriptions may be linked to the PIDINST record -using RelatedIdentifier with relationType IsDescribedBy or -HasMetadata. +The PIDINST metadata schema provides core properties to represent +instrument descriptions. It contains essential information to +identify the individual instrument instance and to link the instance +with other sources of information and related entities. + +The WG strives for a metadata schema that is applicable to various +kinds of instruments being used in all scientific domains. For this +reason, we kept the schema as generic as possible, with the +possibility to extend it to accommodate emerging requirements. An +in-depth technical description of the instrument is not practicable at +that level. The core metadata of an instrument may be extended with +more detailed, community-specific descriptions by linking the PIDINST +record with supplementary metadata using the properties +RelatedIdentifier with relationType IsDescribedBy or HasMetadata +provided in the schema. \subsection{Overview} Table \ref{schema:tab:propoverview} provides an overview of the properties in the PIDINST schema. The last column indicates whether -the property is +the property is: \begin{itemize} \item Mandatory (M); the property must be provided for the metadata record to be valid, @@ -143,8 +146,9 @@ \subsection{Overview} description. \end{itemize} In the present version of the schema, all properties are either -mandatory or recommended. But future versions may also add optional -properties. +mandatory or recommended. It is envisioned that additional optional +properties (in addition to mandatory and recommended properties) will +be added in the future. \begin{longtable}{|l|l|l|} \hline @@ -180,12 +184,12 @@ \subsection{Definition of the PIDINST properties} There are simple properties that take just one value, such as Name and Description. Other complex properties are composed of multiple -sub-properties. For instance Owner is composed of ownerName, +sub-properties. For instance, Owner is composed of ownerName, ownerContact, and ownerIdentifier, the latter in turn having another sub-property ownerIdentifierType. The structure of properties and sub-properties is indicated in the numbering in the ID column, -e.g.\ 5.3.1 (ownerIdentifierType) is a sub-property of 5.3 -(ownerIdentifier). +e.g.\ the property 5.3 (ownerIdentifier) has a sub-property 5.3.1 +(ownerIdentifierType). The number of occurrences for any property in one PIDINST metadata record is indicated in the column labeled ``Occ''. The meaning is: @@ -194,7 +198,7 @@ \subsection{Definition of the PIDINST properties} \item 0--1: an optional property that may appear at most once, \item 1--n: a mandatory property with multiple values, e.g.\ the property may appear one or more times in a single record, -\item 0--n: a multivalued optional property that may appear appear zero +\item 0--n: a multivalued optional property that may appear zero or more times in a record. \end{itemize} In the case of a sub-property, the occurrence is to be understood From e8cb49540c948511eb333c94d9c76430ebf67070 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 2 Nov 2021 14:38:00 +0100 Subject: [PATCH 16/38] Minor: add a hyphenation mark, white space --- doc/schema.tex | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index bf8269c..a57ce96 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -84,7 +84,7 @@ \section*{Contributors} \section{Introduction} The Persistent Identification of Instruments Working Group (PIDINST) -seeks to explore a community-driven solution for globally unique and +seeks to explore a commu\-nity-driven solution for globally unique and persistent identification of instruments operated in the sciences. Instruments, such as sensors used in environmental science, DNA @@ -351,7 +351,7 @@ \subsection{Definition of the PIDINST properties} \item Handle \item IGSN \item ISBN - \item ISSN + \item ISSN \item ISTC \item LISSN \item PMID From 2ea687dc6deb4d9780266cf9562edecbe3316724 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 2 Nov 2021 14:52:41 +0100 Subject: [PATCH 17/38] Review label names --- doc/schema.tex | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index a57ce96..bef0c00 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -82,6 +82,7 @@ \section*{Contributors} \pagenumbering{arabic} \section{Introduction} +\label{intro} The Persistent Identification of Instruments Working Group (PIDINST) seeks to explore a commu\-nity-driven solution for globally unique and @@ -115,6 +116,7 @@ \section{Introduction} repository of the working group \cite{pidinst:github}. \section{Metadata Schema} +\label{schema} The PIDINST metadata schema provides core properties to represent instrument descriptions. It contains essential information to @@ -134,7 +136,7 @@ \section{Metadata Schema} \subsection{Overview} -Table \ref{schema:tab:propoverview} provides an overview of the +Table \ref{tab:schema:propoverview} provides an overview of the properties in the PIDINST schema. The last column indicates whether the property is: \begin{itemize} @@ -170,7 +172,7 @@ \subsection{Overview} 13 & AlternateIdentifier & R \\ \hline \caption{Overview of PIDINST properties} - \label{schema:tab:propoverview} + \label{tab:schema:propoverview} \end{longtable} If a value for any of the mandatory properties is not available, one @@ -179,7 +181,7 @@ \subsection{Overview} \subsection{Definition of the PIDINST properties} -Table \ref{schema:tab:expandprops} provides a detailed description for +Table \ref{tab:schema:expandprops} provides a detailed description for the properties in the PIDINST metadata schema. There are simple properties that take just one value, such as Name and @@ -415,18 +417,18 @@ \subsection{Definition of the PIDINST properties} & Free text \\ \hline \caption{Expanded PIDINST properties} - \label{schema:tab:expandprops} + \label{tab:schema:expandprops} \end{longtable} \appendix \section{Standard values for unknown information} - \label{appendix:unknown} +\label{appendix:unknown} For the case that the value for a mandatory property is unknown or not available, we adopt the standard values for unknown information from the DataCite Metadata Schema \cite{datacite:schema}. These values are -repeated here in Table \ref{appendix:tab:unknown}. +repeated here in Table \ref{tab:appendix:unknown}. \begin{longtable}{|l|l|} \hline @@ -445,7 +447,7 @@ \section{Standard values for unknown information} :etal & too numerous to list (et alia) \\ \hline \caption{Standard values for unknown information} - \label{appendix:tab:unknown} + \label{tab:appendix:unknown} \end{longtable} \bibliographystyle{plain} From 1f3b078e73fd19460f74870013063fe988cfc08c Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 2 Nov 2021 17:34:14 +0100 Subject: [PATCH 18/38] Add some more vertical spacing to table cells --- doc/schema.tex | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/schema.tex b/doc/schema.tex index bef0c00..46ed58a 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -14,6 +14,8 @@ \begin{document} +\renewcommand{\arraystretch}{1.3} + \maketitle \thispagestyle{empty} From bfe7d89df36af1fec7bd39561195260f281fc834 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 2 Nov 2021 17:30:54 +0100 Subject: [PATCH 19/38] Add section on controlled list of values --- doc/schema.tex | 225 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 225 insertions(+) diff --git a/doc/schema.tex b/doc/schema.tex index 46ed58a..0ecd571 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -422,6 +422,231 @@ \subsection{Definition of the PIDINST properties} \label{tab:schema:expandprops} \end{longtable} +\subsection{Definition of terms in controlled lists of values} + +The allowed values for some properties are constraint to a controlled +list. In the following, we define the semantics of the terms and +provide guidance when to use them. + +\newlength{\valnamecolw}\settowidth{\valnamecolw}{IsPreviousVersionOf} +\newlength{\valdefcolw} +\setlength{\valdefcolw}{\textwidth} +\addtolength{\valdefcolw}{-\valnamecolw} +\addtolength{\valdefcolw}{-4\tabcolsep} + +\subsubsection{dateType} + +The Date property allows to refer to relevant events in the lifetime +of the instrument. The dateType sub-property indicates the nature of +that event. Table \ref{tab:schema:values:dateType} lists the allowed +values for dateType. + +\begin{longtable}{|l|l|} + \hline + \emph{Value} & \emph{Definition} \\ + \hline \endhead + \hline \endfoot\endlastfoot + Commissioned & the date that the instrument started to be in operation \\ + DeCommissioned & the date that the instrument ceased to be in operation \\ + \hline + \caption{Values for dateType} + \label{tab:schema:values:dateType} +\end{longtable} + +\subsubsection{relatedIdentifierType} + +The RelatedIdentifier property should be used to link other resources +of any kind related to the instrument, referring to a persistent +identifier of this resource. The relatedIdentifierType sub-property +indicates the type of persistent identifier being used in the link. +The allowed values for relatedIdentifierType are listed in Table +\ref{tab:schema:values:relatedIdentifierType}. Most of these values +have been adopted from the DataCite Metadata Schema +\cite{datacite:schema}. + +\begin{longtable}{|l|p{\valdefcolw}|} + \hline + \emph{Value} & \emph{Definition} \\ + \hline \endhead + \hline \endfoot\endlastfoot + ARK & + Archival Resource Key: a URI designed to support long-term access to + information objects. + \\ \hline + arXiv & + arXiv identifier: arXiv.org is a repository of preprints of + scientific papers in the fields of mathematics, physics, astronomy, + computer science, quantitative biology, statistics, and quantitative + finance. + \\ \hline + bibcode & + Astrophysics Data System bibliographic codes: a standardized + 19-character identifier. + \\ \hline + DOI & + Digital Object Identifier: a character string used to uniquely + identify an object. A DOI name is divided into two parts, a prefix + and a suffix, separated by a slash. + \\ \hline + EAN13 & + European Article Number, now renamed International Article Number, + but retaining the original acronym, is a 13-digit barcoding standard + that is a superset of the original 12-digit Universal Product Code + (UPC) system. + \\ \hline + EISSN & + Electronic International Standard Serial Number: ISSN used to + identify periodicals in electronic form (eISSN or e-ISSN). + \\ \hline + Handle & + This refers specifically to an ID in the Handle system operated by + the Corporation for National Research Initiatives (CNRI). + \\ \hline + IGSN & + A persistent unique identifier for physical samples and specimens + formerly known as International Geo Sample Number. See + \url{https://www.igsn.org/} + \\ \hline + ISBN & + International Standard Book Number: a unique numeric book identifier. + \\ \hline + ISSN & + International Standard Serial Number: a unique 8-digit number used + to identify a print or electronic periodical publication. + \\ \hline + ISTC & + International Standard Text Code: a unique ``number'' assigned to a + textual work. An ISTC consists of 16 numbers and/or letters. + \\ \hline + LISSN & + The linking ISSN or ISSN-L enables collocation or linking among + different media versions of a continuing resource. + \\ \hline + PMID & + PubMed identifier: a unique number assigned to each PubMed record. + \\ \hline + PURL & + Persistent Uniform Resource Locator. + \\ \hline + RAiD & + Research Activity Identifier, see \url{https://www.raid.org.au/} + \\ \hline + RRID & + Research Resource Identifiers, see \url{https://www.rrids.org/} + \\ \hline + UPC & + Universal Product Code is a barcode symbology used for tracking + trade items in stores. + \\ \hline + URL & + Uniform Resource Locator, also known as web address. + \\ \hline + URN & + Uniform Resource Name: a unique and persistent identifier of an + electronic document. + \\ \hline + w3id & + Permanent identifier for Web applications. Mostly used to publish + vocabularies and ontologies. + \\ \hline + \caption{Values for relatedIdentifierType} + \label{tab:schema:values:relatedIdentifierType} +\end{longtable} + +\subsubsection{relationType} + +The RelatedIdentifier property should be used to link other resources +of any kind related to the instrument, referring to a persistent +identifier of this resource. The relationType sub-property indicates +the nature of that relation. Table +\ref{tab:schema:values:relationType} lists the allowed values for +relationType. + +\begin{longtable}{|l|p{\valdefcolw}|} + \hline + \emph{Value} & \emph{Definition} \\ + \hline \endhead + \hline \endfoot\endlastfoot + IsDescribedBy & + The linked resource is a document describing the instrument. + \\ \hline + IsNewVersionOf & + If an instrument is substantially modified, a new PID may be + attributed to the new version. In that case the old and the new PID + should be linked to each other. IsNewVersionOf should be used in + the new PID record to link the old instrument before the + modification. + \\ \hline + IsPreviousVersionOf & + If an instrument is substantially modified, a new PID may be + attributed to the new version. In that case the old and the new PID + should be linked to each other. IsPreviousVersionOf should be used + in the old PID record to link the new instrument after the + modification. + \\ \hline + HasComponent & + In the case of a complex instrument, having multiple components that + may be considered as instruments in itself, having their own PIDs, + these PIDs should be linked to each other. HasComponent should be + used in the PID record of the compound instrument to link the + components. + \\ \hline + IsComponentOf & + In the case of a complex instrument, having multiple components that + may be considered as instruments in itself, having their own PIDs, + these PIDs should be linked to each other. IsComponentOf should be + used in the PID records of the components to link the compound + instrument. + \\ \hline + References & + This may be used in the generic case, if no other more specific + relation type applies. + \\ \hline + HasMetadata & + If there is additional metadata describing the instrument, possible + using a community specific metadata standard, that metadata record + may be linked using HasMetadata. + \\ \hline + WasUsedIn & + If the instrument has been deployed in some research activity, such + as a cruise of a research vessel, WasUsedIn may be used to link that + activity. + \\ \hline + IsIdenticalTo & + If more than one PIDs have been attributed to a single instrument + (which should preferably be avoided in the first place), these PID + records should be linked to each other using IsIdenticalTo. + \\ \hline + IsAttachedTo & + If the instrument is permanently attached to another instrument, the + PID records for both instrument should link to each other using + IsAttachedTo. + \\ \hline + \caption{Values for relationType} + \label{tab:schema:values:relationType} +\end{longtable} + +\subsubsection{alternateIdentifierType} + +If the instrument is also registered elsewhere using any other kind of +identifier, these identifiers may be stored in the AlternateIdentifier +property. The alternateIdentifierType sub-property indicates the +nature of that identifier. The allowed values are listed in Table +\ref{tab:schema:values:alternateIdentifierType}. + +\begin{longtable}{|l|l|} + \hline + \emph{Value} & \emph{Definition} \\ + \hline \endhead + \hline \endfoot\endlastfoot + SerialNumber & a serial number attributed by the manufacturer \\ + InventoryNumber & an inventory number used by the owner \\ + Other & any other kind of identifier \\ + \hline + \caption{Values for alternateIdentifierType} + \label{tab:schema:values:alternateIdentifierType} +\end{longtable} + \appendix \section{Standard values for unknown information} From c6b1eed51a17cf2522694a7c013610067d404b63 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 2 Nov 2021 17:45:01 +0100 Subject: [PATCH 20/38] Typos --- doc/schema.tex | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 0ecd571..d6c848f 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -424,7 +424,7 @@ \subsection{Definition of the PIDINST properties} \subsection{Definition of terms in controlled lists of values} -The allowed values for some properties are constraint to a controlled +The allowed values for some properties are constrained to a controlled list. In the following, we define the semantics of the terms and provide guidance when to use them. @@ -603,7 +603,7 @@ \subsubsection{relationType} relation type applies. \\ \hline HasMetadata & - If there is additional metadata describing the instrument, possible + If there is additional metadata describing the instrument, possibly using a community specific metadata standard, that metadata record may be linked using HasMetadata. \\ \hline @@ -619,7 +619,7 @@ \subsubsection{relationType} \\ \hline IsAttachedTo & If the instrument is permanently attached to another instrument, the - PID records for both instrument should link to each other using + PID records for both instruments should link to each other using IsAttachedTo. \\ \hline \caption{Values for relationType} From 03d41430593c5330ca010e28e1508012967d5905 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 8 Nov 2021 14:42:19 +0100 Subject: [PATCH 21/38] Adopt some suggestions made in the Googgle doc --- doc/schema.tex | 37 ++++++++++++++++++++----------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index d6c848f..2f50143 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -93,26 +93,29 @@ \section{Introduction} Instruments, such as sensors used in environmental science, DNA sequencers used in life sciences or laboratory engines used for medical domains, are widespread in most fields of applied sciences. -The ability to link a physical instrument with its metadata including -its type and contexts in which the instrument operates, such as -generated data, other instruments and platforms, people and -manufacturers, is critical, especially for automated processing of -such contextual information and for the interpretation of data -generated. +The ability to link a physical instrument to the data that it +generated and contextual metadata such as when, where and how it was +operated, is critical to interpret data accurately. Instrument PIDs +also provide more context information, such as linking other +instruments and platforms, descriptive information about the +instrument, and people and manufacturers. This information can then +be automatically aggregated following the so-called PID-Graph. PIDINST is a working group in the Research Data Alliance (RDA). It aims to establish a cross-discipline, practical solution for the globally unique and permanent identification of a physical instrument -that can act as an anchor for associated metadata. See +that can act as an anchor for associated metadata. The group +considered instrument instances, e.g.\ the individual physical +objects, as opposed to instrument types or models. See \cite{pidinst2020} for an overview of PIDINST. The solution uses a resolvable persistent identifier (PID) published with a descriptive metadata schema that helps identify the instrument -as well as enable linkages to other external metadata. The present -document defines the metadata schema that PIDINST developed for the -description of an instrument instance. These metadata items are -supposed to be registered along with the persistent identifier and -stored in the PID infrastructure. +as well as enable linkages to other external metadata. This document +defines the metadata schema that PIDINST developed for the description +of an instrument instance. These metadata items are supposed to be +registered along with the persistent identifier and stored in the PID +infrastructure. The schema is publicly available for reuse and maintained in the code repository of the working group \cite{pidinst:github}. @@ -127,11 +130,11 @@ \section{Metadata Schema} The WG strives for a metadata schema that is applicable to various kinds of instruments being used in all scientific domains. For this -reason, we kept the schema as generic as possible, with the -possibility to extend it to accommodate emerging requirements. An -in-depth technical description of the instrument is not practicable at -that level. The core metadata of an instrument may be extended with -more detailed, community-specific descriptions by linking the PIDINST +reason, we kept the schema as generic as needed, with the possibility +to extend it to accommodate emerging requirements. An in-depth +technical description of the instrument is not practicable at that +level. The core metadata of an instrument may be extended with more +detailed, community-specific descriptions by linking the PIDINST record with supplementary metadata using the properties RelatedIdentifier with relationType IsDescribedBy or HasMetadata provided in the schema. From 9116c16fad09cd52c6c2a0836cafbe7e018c2932 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 8 Nov 2021 14:51:30 +0100 Subject: [PATCH 22/38] Adopt some suggestions make by Jens Klump in the Googgle doc --- doc/schema.tex | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 2f50143..35cfa1e 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -429,7 +429,7 @@ \subsection{Definition of terms in controlled lists of values} The allowed values for some properties are constrained to a controlled list. In the following, we define the semantics of the terms and -provide guidance when to use them. +provide guidance on when to use them. \newlength{\valnamecolw}\settowidth{\valnamecolw}{IsPreviousVersionOf} \newlength{\valdefcolw} @@ -439,7 +439,7 @@ \subsection{Definition of terms in controlled lists of values} \subsubsection{dateType} -The Date property allows to refer to relevant events in the lifetime +The Date property allows referring to relevant events in the lifetime of the instrument. The dateType sub-property indicates the nature of that event. Table \ref{tab:schema:values:dateType} lists the allowed values for dateType. @@ -506,9 +506,8 @@ \subsubsection{relatedIdentifierType} the Corporation for National Research Initiatives (CNRI). \\ \hline IGSN & - A persistent unique identifier for physical samples and specimens - formerly known as International Geo Sample Number. See - \url{https://www.igsn.org/} + A persistent unique identifier for physical samples and specimens. + See \url{https://www.igsn.org/} \\ \hline ISBN & International Standard Book Number: a unique numeric book identifier. From 7025208b68d8c66d3126a6bdcc02ad6c27033d3c Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 9 Nov 2021 19:42:39 +0100 Subject: [PATCH 23/38] Add pidinsttitle.sty that defines a custom version of \maketitle, essentially a boiled down version of the one from scrartcl.cls to start with --- doc/pidinsttitle.sty | 43 +++++++++++++++++++++++++++++++++++++++++++ doc/schema.tex | 1 + 2 files changed, 44 insertions(+) create mode 100644 doc/pidinsttitle.sty diff --git a/doc/pidinsttitle.sty b/doc/pidinsttitle.sty new file mode 100644 index 0000000..97c0a92 --- /dev/null +++ b/doc/pidinsttitle.sty @@ -0,0 +1,43 @@ +\ProvidesPackage{pidinsttitle}[2021/11/09 customized title page] + +\newcommand*{\@titlefoot}{}% +\newcommand{\titlefoot}[1]{\gdef\@titlefoot{% + #1% +}}% + +\renewcommand\maketitle{% + \begin{titlepage} + \setcounter{page}{1}% + \ifx\@titlehead\@empty \else + \begin{minipage}[t]{\textwidth}% + \usekomafont{titlehead}{\@titlehead\par}% + \end{minipage}\par + \fi + \null\vfill + \begin{center} + {\usekomafont{title}{\huge \@title\par}}% + \vskip 1em + {\ifx\@subtitle\@empty\else\usekomafont{subtitle}{\@subtitle\par}\fi}% + \vskip 2em + {% + \usekomafont{author}{% + \lineskip 0.75em + \begin{tabular}[t]{c} + \@author + \end{tabular}\par + }% + }% + \vskip 1.5em + {\usekomafont{date}{\@date \par}}% + \vskip \z@ \@plus3fill + {\usekomafont{publishers}{\@publishers \par}}% + \vskip 3em + \end{center}\par + \vfill\null + \ifx\@titlefoot\@empty \else + \begin{minipage}[t]{\textwidth}% + \usekomafont{titlehead}{\@titlefoot\par}% + \end{minipage}\par + \fi + \end{titlepage} +}% diff --git a/doc/schema.tex b/doc/schema.tex index 35cfa1e..56ab79c 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -4,6 +4,7 @@ \usepackage[colorlinks=true,urlcolor=black,linkcolor=black]{hyperref} \usepackage{longtable} \usepackage{enumitem} +\usepackage{pidinsttitle} \input{.meta} From 4521dceb1c3d30f3692e5aed84c7a7ac7fa54361 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 9 Nov 2021 19:49:52 +0100 Subject: [PATCH 24/38] Add logos to title page --- doc/.gitignore | 14 +++++++------- doc/cc-by.pdf | Bin 0 -> 4973 bytes doc/pidinst-logo.pdf | Bin 0 -> 3092 bytes doc/pidinsttitle.sty | 14 ++++++++++++-- doc/rda-logo.pdf | Bin 0 -> 28684 bytes 5 files changed, 19 insertions(+), 9 deletions(-) create mode 100644 doc/cc-by.pdf create mode 100644 doc/pidinst-logo.pdf create mode 100644 doc/rda-logo.pdf diff --git a/doc/.gitignore b/doc/.gitignore index 400eec4..a5d838a 100644 --- a/doc/.gitignore +++ b/doc/.gitignore @@ -1,8 +1,8 @@ -*.aux -*.bbl -*.blg -*.log -*.out -*.pdf -*.toc /.meta.tex +/schema.aux +/schema.bbl +/schema.blg +/schema.log +/schema.out +/schema.pdf +/schema.toc diff --git a/doc/cc-by.pdf b/doc/cc-by.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7b61e08a6c98a90f9f6527f7a95645ce41e170ae GIT binary patch literal 4973 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 I@8gR3Kk}=YbN~PV literal 0 HcmV?d00001 diff --git a/doc/pidinst-logo.pdf b/doc/pidinst-logo.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1788c75e2b643618f15fd1ffdcb80b30b3ffaa62 GIT binary patch literal 3092 zcmc&$2~ZSQ8g9jK$*2SrB|$p74yVuua{vw?bAWP%V-!XL>oC*6$S@5(4G!P|L`9-5Qs=l%hhB85-Lw1v@i}nha*99O@f1x za1l!!VI+d4(iF6mB8YI3q+$NBM6jGnTC9mDffi;;C}AK)c!R+*B{a(69T;67Z8f|F zA|lf?G>jpEDy23Wc4O4Vz+=}j(1dk>A4Pz5BLu?@Oj2_iHJbRx{d-IzsMnj+-MEK^;{YH5>3ikbaT zz!~~i8oRBpu(9xvYod8vm`P*q^aF`9vqd|GzH<-hv@w((EzYy?DJTg3-uC6QXZ`J+ z4PHf$qBFDB`uh~*3D*ZYerhK?(fdB*eWqa5nLV~w8hQtsi%QpC{5C1=H2p!KRaO4^vYDFvn3uF*qgi^bRQHsZ zzMk{+z*eU~QAxc+b8r~!RqwtMV|=(K9`xodZ#6zz|)`zq?Uoai)7 zZLSaM7uU|(i4AmkRvymZy!{|$ZdN`oYF~bZu&1LDHIrR-iJw1pr-u`}0lhtF2gS(X z`EzP)LSF9k*tBh9f^_eT;)mau#0sa~ycTe{O>V8Tsa$4UI7_uTwq;%ZwltGhRBNGm zcS*mUSICRfSox9C)@U@f96xp8hQ(IpZWn9&1&Z6BI)8C7=W=B{+mRb;`j6higW>HL zn*4diRd)A0jq`J7cv$CH-lgq?WqVrTeNUIqMS~@-lCm0$t@htT;RhGZQ<;%JYh^(T zj7mRgntcAsRpQ#!_XY>w*<@En&ZuThIy|*U!sA2GT!rV+H$%?n2cLJGldUvJC~rJB zXJN9B?f%|(Ph9^tnA$g>iaFF_(M8B)A%T4s8-{Gk&lXtxQpk!oZ!+e-uO0}w^3UV5 zhRzIU^l0pjCO4C1qk%hIM}A8~L>P>OkW{iG1hU|gqrwe+=>V~83}F3v8<``S9rCpRcg zc1PXd+T*A*Jl-~WP2PgAz&P%_i+n>?Dt*#wW$h7f`4yxtalrqrAUNP+|AoC)&xelv zB#AlJ8u-M^Y1ix_r`93=Yxiwa(`|3nITlq6#9H33vEdo~-RSHxr{uTBkyBqD+1GH= ze9QWhK+B#jhhLbiNHuVZ3S;lq?DFoa>hLr2(CKQxBgI3{l}kJQAVGBw*YPiHwFZ(6DgOzlIw&)A7R*rdh*G z{(-4DTHx#J$K&{M_*{t_=F8`Z-T532*G~wh5_i5YhvWUn5_L*_IY?$^!+Jr%GvFe z^9Q$fu1$ioeb-G}wy33{3u5;hzR~Ly9Yw^mOi>u;fcxm+!#pn6jSDkhJ`4;TV3+}G ze#1b8n25Q9qrf;h4h9_fF@|AGYL3Tv6Xbw|`$R6N$3zT6^A^U9Fs>eq zrw7yLKRtF}dhEdU*n#V@1J`2*_&ekN8z|*t{t->dRceA7KE#fMJ?DQN>m%VTr|6M5 w!*O>UoT=H8Fa5xI>_h0GEYtr3GjPx)(qV=W!qfrK6=23&;|Y6U{11fx121|Gj{pDw literal 0 HcmV?d00001 diff --git a/doc/pidinsttitle.sty b/doc/pidinsttitle.sty index 97c0a92..accf2bb 100644 --- a/doc/pidinsttitle.sty +++ b/doc/pidinsttitle.sty @@ -1,6 +1,16 @@ \ProvidesPackage{pidinsttitle}[2021/11/09 customized title page] +\RequirePackage{graphicx} -\newcommand*{\@titlefoot}{}% +\renewcommand*{\@titlehead}{% + \includegraphics[height=15ex]{rda-logo}% + \hfill% + \includegraphics[height=15ex]{pidinst-logo}% +} + +\newcommand*{\@titlefoot}{% + \hfill% + \includegraphics[height=3ex]{cc-by}% +}% \newcommand{\titlefoot}[1]{\gdef\@titlefoot{% #1% }}% @@ -33,7 +43,7 @@ {\usekomafont{publishers}{\@publishers \par}}% \vskip 3em \end{center}\par - \vfill\null + \vfill \ifx\@titlefoot\@empty \else \begin{minipage}[t]{\textwidth}% \usekomafont{titlehead}{\@titlefoot\par}% diff --git a/doc/rda-logo.pdf b/doc/rda-logo.pdf new file mode 100644 index 0000000000000000000000000000000000000000..84e75f57100025fa401aaa206f6ca1205464f80d GIT binary patch literal 28684 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 Date: Tue, 9 Nov 2021 19:54:54 +0100 Subject: [PATCH 25/38] Move the table with document metadata to the title page --- doc/schema.tex | 20 +++++++++----------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 56ab79c..bc5f7c8 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -8,19 +8,13 @@ \input{.meta} +\begin{document} + \title{Metadata Schema for the \\ Persistent Identification of Instruments} \author{RDA Persistent Identification of Instruments WG} \date{\schemadate} - -\begin{document} - -\renewcommand{\arraystretch}{1.3} - -\maketitle - -\thispagestyle{empty} -\begin{center} +\publishers{ \begin{tabular}[t]{|l|l|} \hline Version & \schemaversion \\ @@ -28,10 +22,14 @@ Date & \schemadate \\ \hline \end{tabular} -\end{center} +} + +\renewcommand{\arraystretch}{1.3} + +\maketitle -\cleardoublepage \pagenumbering{roman} +\setcounter{page}{2} \section*{Contributors} From 7f10accabd4b93f2b047dde6f86d4279bc80d25b Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 17 Nov 2021 10:41:11 +0100 Subject: [PATCH 26/38] Review citation style in the references, include the bibliography statically rather than generating it using bibtex --- doc/Makefile | 3 +-- doc/schema.tex | 25 +++++++++++++++++++++++-- 2 files changed, 24 insertions(+), 4 deletions(-) diff --git a/doc/Makefile b/doc/Makefile index a141fb4..02c4d28 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -79,5 +79,4 @@ metafile: #========================================================================= # Dependencies: -schema.bbl: schema.tex $(BIBFILES) -schema.pdf: metafile schema.bbl schema.tex +schema.pdf: metafile schema.tex diff --git a/doc/schema.tex b/doc/schema.tex index bc5f7c8..817daeb 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -678,7 +678,28 @@ \section{Standard values for unknown information} \label{tab:appendix:unknown} \end{longtable} -\bibliographystyle{plain} -\bibliography{schema} +%\bibliographystyle{plain} +%\bibliography{schema} +\begin{thebibliography}{1} + +\bibitem{pidinst2020} +Markus Stocker et~al. +\newblock Persistent Identification of Instruments. +\newblock \emph{Data Science Journal}, 19(1), 18, 2020. +\newblock \href{https://doi.org/10.5334/dsj-2020-018}{doi:10.5334/dsj-2020-018}. + +\bibitem{pidinst:github} +RDA Persistent~Identification of~Instruments~WG. +\newblock Medadata Schema for the Persistent Identification of Scientific + Instruments. +\newblock \url{https://github.com/rdawg-pidinst/schema}. +\newblock Code repository. + +\bibitem{datacite:schema} +DataCite. +\newblock DataCite Metadata Schema 4.4, March 2021. +\newblock \url{https://schema.datacite.org/meta/kernel-4.4/}. + +\end{thebibliography} \end{document} From 238b76560e405211008e222ec9b64bf82767e58d Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 17 Nov 2021 11:13:04 +0100 Subject: [PATCH 27/38] Add Jens Klump to authors --- doc/schema.tex | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/schema.tex b/doc/schema.tex index 817daeb..f5c52e6 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -58,7 +58,13 @@ \section*{Contributors} \url{https://orcid.org/0000-0003-0870-3192}}), Terrestrial Ecosystem Research Network (TERN), The University of Queensland, Long Pocket Precinct, Level 5 Foxtail Building \#1019, - 80 Meiers Road, Indooroopilly QLD 4068 Australia + 80 Meiers Road, Indooroopilly QLD 4068, Australia +\item \emph{Jens Klump} + ({\small + \href{mailto:jens.klump@csiro.au}{jens.klump@csiro.au}, + \url{https://orcid.org/0000-0001-5911-6022}}), + CSIRO Mineral Resources, 26 Dick Perry Avenue, Kensington WA 6151, + Australia \item \emph{Ted Habermann} ({\small \href{mailto:ted@tedhabermann.com}{ted@tedhabermann.com}, From c6c23f2ca437a996e01260d2b86a7c86ddd2fab8 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 22 Nov 2021 09:52:22 +0100 Subject: [PATCH 28/38] Adopt some suggestions made in the Googgle doc --- doc/schema.tex | 42 ++++++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index f5c52e6..8426ff2 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -100,11 +100,12 @@ \section{Introduction} medical domains, are widespread in most fields of applied sciences. The ability to link a physical instrument to the data that it generated and contextual metadata such as when, where and how it was -operated, is critical to interpret data accurately. Instrument PIDs -also provide more context information, such as linking other -instruments and platforms, descriptive information about the -instrument, and people and manufacturers. This information can then -be automatically aggregated following the so-called PID-Graph. +operated, is critical for the accurate interpretation of that data. +Instrument PIDs also provide more context information, such as linking +other instruments and platforms, descriptive information about the +instrument, and manufacturer and owner of the instrument. This +information can then be automatically aggregated following the +so-called PID-Graph. PIDINST is a working group in the Research Data Alliance (RDA). It aims to establish a cross-discipline, practical solution for the @@ -115,12 +116,13 @@ \section{Introduction} \cite{pidinst2020} for an overview of PIDINST. The solution uses a resolvable persistent identifier (PID) published -with a descriptive metadata schema that helps identify the instrument -as well as enable linkages to other external metadata. This document -defines the metadata schema that PIDINST developed for the description -of an instrument instance. These metadata items are supposed to be -registered along with the persistent identifier and stored in the PID -infrastructure. +with descriptive metadata that provides enough information to identify +the instrument and may as well include links to other external +metadata. This document defines the metadata schema that PIDINST +developed for the description of an instrument instance. Institutions +or organizations operating scientific instruments may use the schema +when registering the metadata describing their instrument along with +the persistent identifier through a relevant PID infrastructure. The schema is publicly available for reuse and maintained in the code repository of the working group \cite{pidinst:github}. @@ -135,14 +137,14 @@ \section{Metadata Schema} The WG strives for a metadata schema that is applicable to various kinds of instruments being used in all scientific domains. For this -reason, we kept the schema as generic as needed, with the possibility -to extend it to accommodate emerging requirements. An in-depth -technical description of the instrument is not practicable at that -level. The core metadata of an instrument may be extended with more -detailed, community-specific descriptions by linking the PIDINST -record with supplementary metadata using the properties -RelatedIdentifier with relationType IsDescribedBy or HasMetadata -provided in the schema. +reason, we kept the schema generic. Technical details such as +specifications, data sheets, or detailed technique descriptions were +not included as these necessarily apply only to a subclass of +instruments relevant to a particular scientific subdomain. The core +metadata of an instrument may be extended with more detailed, +community-specific descriptions by linking the PIDINST record with +supplementary metadata using the properties RelatedIdentifier with +relationType IsDescribedBy or HasMetadata provided in the schema. \subsection{Overview} @@ -282,7 +284,7 @@ \subsection{Definition of the PIDINST properties} \hline 6 & Manufacturer & 1--n & The instrument's manufacturer(s) or developer. This may - also be the owner for custom build instruments. + also be the owner for custom-build instruments. & \\ \hline 6.1 & manufacturerName & 1 From 9f35783201eb016dce175d787b9149981639d1e7 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 22 Nov 2021 10:06:57 +0100 Subject: [PATCH 29/38] Add comment on the allowed values for the various identifier types --- doc/schema.tex | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 8426ff2..2179b81 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -280,7 +280,11 @@ \subsection{Definition of the PIDINST properties} & Free text, should be a globally unique identifier \\ \hline 5.3.1 & ownerIdentifierType & 1 - & Type of the identifier & Free text \\ + & Type of the identifier + & Free text, see related\-IdentifierType for a list of known + identifier types. We anticipate there might be other + identifier types for owners not in this list though, + hence we allow free text. \\ \hline 6 & Manufacturer & 1--n & The instrument's manufacturer(s) or developer. This may @@ -295,7 +299,11 @@ \subsection{Definition of the PIDINST properties} & Free text, should be a globally unique identifier \\ \hline 6.2.1 & manufacturerIdentifierType & 1 - & Type of the identifier & Free text \\ + & Type of the identifier + & Free text, see related\-IdentifierType for a list of known + identifier types. We anticipate there might be other + identifier types for manufacturers not in this list though, + hence we allow free text. \\ \hline 7 & Model & 0--1 & Name of the model or type of device as attributed by the @@ -310,7 +318,11 @@ \subsection{Definition of the PIDINST properties} & Free text, should be a globally unique identifier \\ \hline 7.2.1 & modelIdentifierType & 1 - & Type of the identifier & Free text \\ + & Type of the identifier + & Free text, see related\-IdentifierType for a list of known + identifier types. We anticipate there might be other + identifier types for instrument models not in this list + though, hence we allow free text. \\ \hline 8 & Description & 0--1 & Technical description of the device and its capabilities @@ -327,7 +339,11 @@ \subsection{Definition of the PIDINST properties} & Free text, should be a globally unique identifier \\ \hline 9.2.1 & instrumentTypeIdentifierType & 1 - & Type of the identifier & Free text \\ + & Type of the identifier + & Free text, see related\-IdentifierType for a list of known + identifier types. We anticipate there might be other + identifier types for instrument types not in this list + though, hence we allow free text. \\ \hline 10 & MeasuredVariable & 0--n & The variable(s) that this instrument measures or observes From ee6700b042807cfe91cc4fec36db5cdf60734212 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 22 Nov 2021 11:10:03 +0100 Subject: [PATCH 30/38] Link the creative commons page from the license logo --- doc/pidinsttitle.sty | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/pidinsttitle.sty b/doc/pidinsttitle.sty index accf2bb..f2264fa 100644 --- a/doc/pidinsttitle.sty +++ b/doc/pidinsttitle.sty @@ -1,5 +1,6 @@ \ProvidesPackage{pidinsttitle}[2021/11/09 customized title page] \RequirePackage{graphicx} +\RequirePackage{url} \renewcommand*{\@titlehead}{% \includegraphics[height=15ex]{rda-logo}% @@ -9,7 +10,7 @@ \newcommand*{\@titlefoot}{% \hfill% - \includegraphics[height=3ex]{cc-by}% + \href{https://creativecommons.org/licenses/by/4.0/}{\includegraphics[height=3ex]{cc-by}}% }% \newcommand{\titlefoot}[1]{\gdef\@titlefoot{% #1% From 4e7572e54dc76f1f2ad6c83130beac3809cd0481 Mon Sep 17 00:00:00 2001 From: Markus Stocker Date: Tue, 23 Nov 2021 23:35:30 +0100 Subject: [PATCH 31/38] Updated affiliation U Bremen is now invalid but I added my U Hannover affiliation instead. --- doc/schema.tex | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 2179b81..210eaa5 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -77,8 +77,7 @@ \section*{Contributors} \url{https://orcid.org/0000-0001-5492-3212}}), TIB Leibniz Information Centre for Science and Technology, Welfengarten 1 B, 30167 Hannover, Germany and - PANGAEA, Center for Marine Environmental Sciences (MARUM), - University of Bremen, Leobener Str.\ 8, 28359 Bremen, Germany + Leibniz University Hannover, Welfengarten 1, 30167 Hannover, Germany \item \emph{The Research Data Alliance Persistent Identification of Instruments Working Group members} ({\small \url{https://www.rd-alliance.org/node/57186/members}}) From 076fca9b91733355648276fdcfa4825fe5283b8f Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Wed, 24 Nov 2021 17:47:13 +0100 Subject: [PATCH 32/38] Update reference to DataCite Schema (obviously, it has a DOI) --- doc/schema.bib | 8 +++++--- doc/schema.tex | 7 ++++--- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/doc/schema.bib b/doc/schema.bib index aef22f3..d1d13f4 100644 --- a/doc/schema.bib +++ b/doc/schema.bib @@ -21,9 +21,11 @@ @Article{pidinst2020 } @Misc{datacite:schema, - author = {DataCite}, - title = {DataCite Metadata Schema 4.4}, + author = {DataCite Metadata Working Group}, + title = {DataCite Metadata Schema Documentation for the + Publication and Citation of Research Data and Other + Research Outputs v4.4}, month = mar, year = 2021, - url = {https://schema.datacite.org/meta/kernel-4.4/} + doi = {10.14454/3W3Z-SA82} } diff --git a/doc/schema.tex b/doc/schema.tex index 210eaa5..9bbb207 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -719,9 +719,10 @@ \section{Standard values for unknown information} \newblock Code repository. \bibitem{datacite:schema} -DataCite. -\newblock DataCite Metadata Schema 4.4, March 2021. -\newblock \url{https://schema.datacite.org/meta/kernel-4.4/}. +DataCite Metadata~Working Group. +\newblock DataCite Metadata Schema Documentation for the Publication and + Citation of Research Data and Other Research Outputs v4.4, March 2021. +\newblock \href{https://doi.org/10.14454/3W3Z-SA82}{doi:10.14454/3W3Z-SA82}. \end{thebibliography} From 83d358970a429cb08bf38dfc246ee1198a113bf2 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Thu, 25 Nov 2021 10:12:41 +0100 Subject: [PATCH 33/38] Adopt some suggestions made in the Googgle doc --- doc/schema.tex | 47 +++++++++++++++++++++++------------------------ 1 file changed, 23 insertions(+), 24 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 9bbb207..9980edc 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -75,7 +75,7 @@ \section*{Contributors} ({\small \href{mailto:markus.stocker@tib.eu}{markus.stocker@tib.eu}, \url{https://orcid.org/0000-0001-5492-3212}}), - TIB Leibniz Information Centre for Science and Technology, + TIB -- Leibniz Information Centre for Science and Technology, Welfengarten 1 B, 30167 Hannover, Germany and Leibniz University Hannover, Welfengarten 1, 30167 Hannover, Germany \item \emph{The Research Data Alliance Persistent Identification of Instruments @@ -104,15 +104,16 @@ \section{Introduction} other instruments and platforms, descriptive information about the instrument, and manufacturer and owner of the instrument. This information can then be automatically aggregated following the -so-called PID-Graph. +so-called PID Graph. -PIDINST is a working group in the Research Data Alliance (RDA). It +PIDINST is a working group of the Research Data Alliance (RDA). It aims to establish a cross-discipline, practical solution for the globally unique and permanent identification of a physical instrument that can act as an anchor for associated metadata. The group considered instrument instances, e.g.\ the individual physical objects, as opposed to instrument types or models. See -\cite{pidinst2020} for an overview of PIDINST. +\cite{pidinst2020} for an overview of the work developed by the RDA +PIDINST WG. The solution uses a resolvable persistent identifier (PID) published with descriptive metadata that provides enough information to identify @@ -193,16 +194,14 @@ \subsection{Overview} \subsection{Definition of the PIDINST properties} Table \ref{tab:schema:expandprops} provides a detailed description for -the properties in the PIDINST metadata schema. - -There are simple properties that take just one value, such as Name and -Description. Other complex properties are composed of multiple -sub-properties. For instance, Owner is composed of ownerName, -ownerContact, and ownerIdentifier, the latter in turn having another -sub-property ownerIdentifierType. The structure of properties and -sub-properties is indicated in the numbering in the ID column, -e.g.\ the property 5.3 (ownerIdentifier) has a sub-property 5.3.1 -(ownerIdentifierType). +the properties in the PIDINST metadata schema. Simple properties, +such as Name and Description, take just one value. Complex properties +are composed of multiple sub-properties. For instance, Owner is +composed of ownerName, ownerContact, and ownerIdentifier, the latter +in turn having another sub-property ownerIdentifierType. The +structure of properties and sub-properties is indicated in the +numbering in the ID column, e.g.\ the property 5.3 (ownerIdentifier) +has a sub-property 5.3.1 (ownerIdentifierType). The number of occurrences for any property in one PIDINST metadata record is indicated in the column labeled ``Occ''. The meaning is: @@ -215,13 +214,13 @@ \subsection{Definition of the PIDINST properties} or more times in a record. \end{itemize} In the case of a sub-property, the occurrence is to be understood -within each of the parent entries. E.g.\ a PIDINST record may have -zero or more RelatedIdentifier (occ.\ 0--n). Each of them must have -one relatedIdentifierType (occ.\ 1) and one relationType (occ.\ 1) and -may optionally have one relatedIdentifierName (occ.\ 0--1). Another -example: a PIDINST record must have one or more Manufacturer -(occ.\ 0--n). Each of them must have a manufacturerName (occ.\ 1) and -may have a manufacturerIdentifier (occ.\ 0--1). If a +within each of the parent entries. For example, a PIDINST record may +have zero or more RelatedIdentifier (occ.\ 0--n). Each of them must +have one relatedIdentifierType (occ.\ 1) and one relationType +(occ.\ 1) and may optionally have one relatedIdentifierName +(occ.\ 0--1). Another example: a PIDINST record must have one or more +Manufacturer (occ.\ 0--n). Each of them must have a manufacturerName +(occ.\ 1) and may have a manufacturerIdentifier (occ.\ 0--1). If a manufacturerIdentifier is included for a Manufacturer, it must also have a manufacturerIdentifierType (occ.\ 1). @@ -449,9 +448,9 @@ \subsection{Definition of the PIDINST properties} \subsection{Definition of terms in controlled lists of values} -The allowed values for some properties are constrained to a controlled -list. In the following, we define the semantics of the terms and -provide guidance on when to use them. +For some properties, the allowed values are constrained to a +controlled list. In the following, we define the semantics of the +terms and provide guidance on when to use them. \newlength{\valnamecolw}\settowidth{\valnamecolw}{IsPreviousVersionOf} \newlength{\valdefcolw} From f3ffd1b1dd3f0b17b58a35be4e9ccdcc271552a9 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 29 Nov 2021 12:46:54 +0100 Subject: [PATCH 34/38] Adopt some suggestions made in the Googgle doc --- doc/schema.tex | 60 ++++++++++++++++++++++++-------------------------- 1 file changed, 29 insertions(+), 31 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 9980edc..aaa36df 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -152,11 +152,11 @@ \subsection{Overview} properties in the PIDINST schema. The last column indicates whether the property is: \begin{itemize} -\item Mandatory (M); the property must be provided for the metadata +\item Mandatory (M): the property must be provided for the metadata record to be valid, -\item Recommended (R); the property is optional, but it is recommended +\item Recommended (R): the property is optional, but it is recommended to be added if applicable, or -\item Optional (O); the property may be added to provide a richer +\item Optional (O): the property may be added to provide a richer description. \end{itemize} In the present version of the schema, all properties are either @@ -470,8 +470,8 @@ \subsubsection{dateType} \emph{Value} & \emph{Definition} \\ \hline \endhead \hline \endfoot\endlastfoot - Commissioned & the date that the instrument started to be in operation \\ - DeCommissioned & the date that the instrument ceased to be in operation \\ + Commissioned & The date when the instrument started to be in operation \\ + DeCommissioned & The date when the instrument ceased to be in operation \\ \hline \caption{Values for dateType} \label{tab:schema:values:dateType} @@ -609,17 +609,15 @@ \subsubsection{relationType} \\ \hline HasComponent & In the case of a complex instrument, having multiple components that - may be considered as instruments in itself, having their own PIDs, - these PIDs should be linked to each other. HasComponent should be - used in the PID record of the compound instrument to link the - components. + may be considered as instruments in their own right, with their own + PIDs, these PIDs should be linked. HasComponent should be used in + the PID record of the compound instrument to link the components. \\ \hline IsComponentOf & In the case of a complex instrument, having multiple components that - may be considered as instruments in itself, having their own PIDs, - these PIDs should be linked to each other. IsComponentOf should be - used in the PID records of the components to link the compound - instrument. + may be considered as instruments in their own right, with their own + PIDs, these PIDs should be linked. IsComponentOf should be used in + the PID records of the components to link the compound instrument. \\ \hline References & This may be used in the generic case, if no other more specific @@ -636,9 +634,9 @@ \subsubsection{relationType} activity. \\ \hline IsIdenticalTo & - If more than one PIDs have been attributed to a single instrument - (which should preferably be avoided in the first place), these PID - records should be linked to each other using IsIdenticalTo. + If multiple PIDs have been attributed to a single instrument (which + should preferably be avoided in the first place), these PID records + should be linked to each other using IsIdenticalTo. \\ \hline IsAttachedTo & If the instrument is permanently attached to another instrument, the @@ -662,9 +660,9 @@ \subsubsection{alternateIdentifierType} \emph{Value} & \emph{Definition} \\ \hline \endhead \hline \endfoot\endlastfoot - SerialNumber & a serial number attributed by the manufacturer \\ - InventoryNumber & an inventory number used by the owner \\ - Other & any other kind of identifier \\ + SerialNumber & A serial number attributed by the manufacturer \\ + InventoryNumber & An inventory number used by the owner \\ + Other & Any other kind of identifier \\ \hline \caption{Values for alternateIdentifierType} \label{tab:schema:values:alternateIdentifierType} @@ -685,16 +683,16 @@ \section{Standard values for unknown information} \emph{Code} & \emph{Definition} \\ \hline \endhead \hline \endfoot\endlastfoot - :unac & temporarily inaccessible \\ - :unal & unallowed, suppressed intentionally \\ - :unap & not applicable, makes no sense \\ - :unas & value unassigned (e.g., Untitled) \\ - :unav & value unavailable, possibly unknown \\ - :unkn & known to be unknown (e.g., Anonymous, Inconnue) \\ - :none & never had a value, never will \\ - :null & explicitly and meaningfully empty \\ - :tba & to be assigned or announced later \\ - :etal & too numerous to list (et alia) \\ + :unac & Temporarily inaccessible \\ + :unal & Unallowed, suppressed intentionally \\ + :unap & Not applicable, makes no sense \\ + :unas & Value unassigned (e.g., Untitled) \\ + :unav & Value unavailable, possibly unknown \\ + :unkn & Known to be unknown (e.g., Anonymous, Inconnue) \\ + :none & Never had a value, never will \\ + :null & Explicitly and meaningfully empty \\ + :tba & To be assigned or announced later \\ + :etal & Too numerous to list (et alia) \\ \hline \caption{Standard values for unknown information} \label{tab:appendix:unknown} @@ -708,7 +706,7 @@ \section{Standard values for unknown information} Markus Stocker et~al. \newblock Persistent Identification of Instruments. \newblock \emph{Data Science Journal}, 19(1), 18, 2020. -\newblock \href{https://doi.org/10.5334/dsj-2020-018}{doi:10.5334/dsj-2020-018}. +\newblock \url{https://doi.org/10.5334/dsj-2020-018}. \bibitem{pidinst:github} RDA Persistent~Identification of~Instruments~WG. @@ -721,7 +719,7 @@ \section{Standard values for unknown information} DataCite Metadata~Working Group. \newblock DataCite Metadata Schema Documentation for the Publication and Citation of Research Data and Other Research Outputs v4.4, March 2021. -\newblock \href{https://doi.org/10.14454/3W3Z-SA82}{doi:10.14454/3W3Z-SA82}. +\newblock \url{https://doi.org/10.14454/3W3Z-SA82}. \end{thebibliography} From b2d457bf2181e27c89849001e2da1947a3a534fc Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Mon, 29 Nov 2021 18:48:53 +0100 Subject: [PATCH 35/38] Add a reference for the PID Graph --- doc/schema.tex | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/schema.tex b/doc/schema.tex index aaa36df..22095d0 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -104,7 +104,7 @@ \section{Introduction} other instruments and platforms, descriptive information about the instrument, and manufacturer and owner of the instrument. This information can then be automatically aggregated following the -so-called PID Graph. +so-called PID Graph \cite{pidgraph2021}. PIDINST is a working group of the Research Data Alliance (RDA). It aims to establish a cross-discipline, practical solution for the @@ -702,6 +702,12 @@ \section{Standard values for unknown information} %\bibliography{schema} \begin{thebibliography}{1} +\bibitem{pidgraph2021} +Helena Cousijn et~al. +\newblock Connected Research: The Potential of the PID Graph. +\newblock \emph{Patterns}, 2(1), 100180, 2021. +\newblock \url{https://doi.org/10.1016/j.patter.2020.100180}. + \bibitem{pidinst2020} Markus Stocker et~al. \newblock Persistent Identification of Instruments. From 9ca9cf3e5887b84353a6d69fad7528e419100512 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 30 Nov 2021 14:02:40 +0100 Subject: [PATCH 36/38] Review the Introduction based on feedback from Lou by mail --- doc/schema.tex | 58 +++++++++++++++++++++++--------------------------- 1 file changed, 27 insertions(+), 31 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 22095d0..16d72a3 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -90,41 +90,37 @@ \section*{Contributors} \section{Introduction} \label{intro} -The Persistent Identification of Instruments Working Group (PIDINST) -seeks to explore a commu\-nity-driven solution for globally unique and -persistent identification of instruments operated in the sciences. - Instruments, such as sensors used in environmental science, DNA sequencers used in life sciences or laboratory engines used for medical domains, are widespread in most fields of applied sciences. The ability to link a physical instrument to the data that it generated and contextual metadata such as when, where and how it was operated, is critical for the accurate interpretation of that data. -Instrument PIDs also provide more context information, such as linking -other instruments and platforms, descriptive information about the -instrument, and manufacturer and owner of the instrument. This -information can then be automatically aggregated following the -so-called PID Graph \cite{pidgraph2021}. -PIDINST is a working group of the Research Data Alliance (RDA). It -aims to establish a cross-discipline, practical solution for the -globally unique and permanent identification of a physical instrument -that can act as an anchor for associated metadata. The group -considered instrument instances, e.g.\ the individual physical -objects, as opposed to instrument types or models. See -\cite{pidinst2020} for an overview of the work developed by the RDA -PIDINST WG. +The Persistent Identification of Instruments Working Group (PIDINST) +is a working group of the Research Data Alliance (RDA). It aims to +establish a cross-discipline, practical solution for the globally +unique and persistent identification of instruments operated in the +sciences that can act as an anchor for associated metadata. The group +considers instrument instances, e.g.\ the individual physical objects, +as opposed to instrument types or models. See \cite{pidinst2020} for +an overview of the work developed by the RDA PIDINST WG. The solution uses a resolvable persistent identifier (PID) published with descriptive metadata that provides enough information to identify -the instrument and may as well include links to other external -metadata. This document defines the metadata schema that PIDINST -developed for the description of an instrument instance. Institutions -or organizations operating scientific instruments may use the schema -when registering the metadata describing their instrument along with -the persistent identifier through a relevant PID infrastructure. - -The schema is publicly available for reuse and maintained in the code +the instrument. Instrument PIDs also provide more context to the +instrument itself by linking other instruments and platforms, +descriptive information and other external metadata about the +instrument, and manufacturer and owner of the instrument. This +information can then be automatically aggregated following the +so-called PID Graph \cite{pidgraph2021}. + +This document defines the metadata schema that PIDINST developed for +the description of an instrument instance. Institutions or +organizations operating scientific instruments may use the schema when +registering the metadata describing their instrument along with the +persistent identifier through a relevant PID infrastructure. The +schema is publicly available for reuse and maintained in the code repository of the working group \cite{pidinst:github}. \section{Metadata Schema} @@ -702,18 +698,18 @@ \section{Standard values for unknown information} %\bibliography{schema} \begin{thebibliography}{1} -\bibitem{pidgraph2021} -Helena Cousijn et~al. -\newblock Connected Research: The Potential of the PID Graph. -\newblock \emph{Patterns}, 2(1), 100180, 2021. -\newblock \url{https://doi.org/10.1016/j.patter.2020.100180}. - \bibitem{pidinst2020} Markus Stocker et~al. \newblock Persistent Identification of Instruments. \newblock \emph{Data Science Journal}, 19(1), 18, 2020. \newblock \url{https://doi.org/10.5334/dsj-2020-018}. +\bibitem{pidgraph2021} +Helena Cousijn et~al. +\newblock Connected Research: The Potential of the PID Graph. +\newblock \emph{Patterns}, 2(1), 100180, 2021. +\newblock \url{https://doi.org/10.1016/j.patter.2020.100180}. + \bibitem{pidinst:github} RDA Persistent~Identification of~Instruments~WG. \newblock Medadata Schema for the Persistent Identification of Scientific From 2c1c761ae3b6462946316cc1ef4966047fda227a Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 30 Nov 2021 14:11:29 +0100 Subject: [PATCH 37/38] Adopt more suggestions from Lou sent in by mail --- doc/schema.tex | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 16d72a3..9619524 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -131,16 +131,16 @@ \section{Metadata Schema} identify the individual instrument instance and to link the instance with other sources of information and related entities. -The WG strives for a metadata schema that is applicable to various -kinds of instruments being used in all scientific domains. For this -reason, we kept the schema generic. Technical details such as -specifications, data sheets, or detailed technique descriptions were -not included as these necessarily apply only to a subclass of -instruments relevant to a particular scientific subdomain. The core -metadata of an instrument may be extended with more detailed, -community-specific descriptions by linking the PIDINST record with -supplementary metadata using the properties RelatedIdentifier with -relationType IsDescribedBy or HasMetadata provided in the schema. +The Working Group strives for a metadata schema that is applicable to +various kinds of instruments being used in all scientific domains. +For this reason, we kept the schema generic. Technical details such +as specifications, data sheets, or detailed technique descriptions +were not included as these may only apply to a subclass of instruments +relevant to a particular scientific subdomain. The core metadata of +an instrument may be extended with more detailed, community-specific +descriptions by linking the PIDINST record with supplementary metadata +using the properties RelatedIdentifier with relationType IsDescribedBy +or HasMetadata provided in the schema. \subsection{Overview} @@ -456,7 +456,7 @@ \subsection{Definition of terms in controlled lists of values} \subsubsection{dateType} -The Date property allows referring to relevant events in the lifetime +The Date property allows references to relevant events in the lifetime of the instrument. The dateType sub-property indicates the nature of that event. Table \ref{tab:schema:values:dateType} lists the allowed values for dateType. From 053b17a88509a39e9397062dd1263e4e8699d1a2 Mon Sep 17 00:00:00 2001 From: Rolf Krahl Date: Tue, 30 Nov 2021 21:10:47 +0100 Subject: [PATCH 38/38] Update address block for Ted --- doc/schema.tex | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/schema.tex b/doc/schema.tex index 9619524..b11547b 100644 --- a/doc/schema.tex +++ b/doc/schema.tex @@ -67,10 +67,9 @@ \section*{Contributors} Australia \item \emph{Ted Habermann} ({\small - \href{mailto:ted@tedhabermann.com}{ted@tedhabermann.com}, + \href{mailto:ted@metadatagamechangers.com}{ted@metadatagamechangers.com}, \url{http://orcid.org/0000-0003-3585-6733}}), - Metadata Game Changers, - 3980 Broadway, Suite 103-185, Boulder, Colorado, USA 80304 + Metadata Game Changers, Boulder, Colorado, USA 80304 \item \emph{Markus Stocker} ({\small \href{mailto:markus.stocker@tib.eu}{markus.stocker@tib.eu},