/[volute]/trunk/projects/dm/provenance/description/AppendixA-ML.tex
ViewVC logotype

Contents of /trunk/projects/dm/provenance/description/AppendixA-ML.tex

Parent Directory Parent Directory | Revision Log Revision Log


Revision 4410 - (show annotations)
Mon Sep 25 19:43:08 2017 UTC (4 years ago) by mir.louys
File MIME type: application/x-tex
File size: 10005 byte(s)
updated typos in the examples , table names, corrected PROV-VOTABLE in PROV-VOTable
1
2 Here is a a simple example of serialization of ProvenanceDM metadata for describing an activity of color composition and the entity used as input as well as the resulting RGB image.
3
4 The PROV-N format \cite{std:PROV-N} as proposed by the W3C is a text format which allows the description of instances of the 3 main classes, as well as the various relations between each instance involved.
5
6 \begin{lstlisting}[language=C, style=customc,caption= PROV-N serialisation example for a color composition activity]
7 document
8 prefix ivo <http://www.ivoa.net/documents/rer/ivo/>
9 prefix hips <http://cds.u-strasbg.fr/data/>
10 prefix voprov <http://www.ivoa.net/documents/dm/provdm/voprov/>
11
12 entity(ivo://CDS/P/DSS2color#RGB_NGC6946,
13 [voprov:annotation="PNG RGB image built from DSS2 with Aladin for galaxy NGC 6946",
14 voprov:doculink="http://cds.u-strasbg.fr/aladin.gml",
15 voprov:name="RGB DSS2 image for NGC 6946"])
16
17 entity(ivo://CDS/P/DSS2/POSSII#POSSII.J-DSS2.143,
18 [voprov:annotation="DSS2 digitization of the Blue POSSII Schmidt survey around NGC 6946",
19 voprov:doculink="http://cds.u-strasbg.fr/aladin.gm",
20 voprov:name="POSSII Blue Survey DSS2 NGC6946"])
21
22 entity(ivo://CDS/P/DSS2/POSSII#POSSII.F-DSS2.143,
23 [voprov:annotation="DSS2 digitization of the Red POSSII Schmidt survey around NGC 6946",
24 voprov:doculink="http://cds.u-strasbg.fr/aladin.gml",
25 voprov:name="POSSII Red Survey DSS2 NGC6946"])
26
27 entity(ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143,
28 [voprov:annotation="DSS2 digitization of the Infra red POSSII Schmidt survey around NGC 6946",
29 voprov:doculink="http://cds.u-strasbg.fr/aladin.gm",
30 voprov:name="POSSII Infra Red Survey DSS2 NGC6946"])
31
32 activity(hips:AlaRGB1, 2017-04-18T17:28:00, 2017-04-19T17:29:00, [
33 voprov:name="Aladin RGB 1",
34 voprov:annotation="Aladin RGB image generation for NGC 6946",
35 voprov:desc_id="AlaRGB",
36 voprov:desc_type="RGBencoding",
37 voprov:desc_name="Aladin RGB image generation algorithm",
38 voprov:desc_doculink="http://cds.u-strasbg.fr/aladin.gml"])
39
40 used(hips:AlaRGB1, 'ivo://CDS/P/DSS2/POSSII#POSSII.J-DSS2.143', -)
41 used(hips:AlaRGB1, 'ivo://CDS/P/DSS2/POSSII#POSSII.F-DSS2.143', -)
42 used(hips:AlaRGB1, 'ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143', -)
43
44 wasGeneratedBy('ivo://CDS/P/DSS2color#RGB_NGC6946', hips:AlaRGB1, 2017-05-05T00:00:00)
45 endDocument
46 \end{lstlisting}
47 %\newpage
48
49 Here is the transcription of the same metadata in the PROV-JSON format \citep{std:PROV-JSON}.
50 Each class and relation of the provenance model lists its corresponding database table tuples grouped by the name of the table.
51
52 \begin{lstlisting}[language=C, style=customc, caption=JSON serialization example for a color composition activity]
53 {
54 "prefix": {
55 "ivo": "http://www.ivoa.net/documents/rer/ivo/",
56 "voprov": "http://www.ivoa.net/documents/dm/provdm/voprov/",
57 "hips": "http://cds.u-strasbg.fr/data/"
58 },
59 "activity": {
60 "hips:AlaRGB1": {
61 "voprov:name": "Aladin RGB 1",
62 "voprov:startTime": "2017-04-18T17:28:00",
63 "voprov:endTime": "2017-04-19T17:29:00",
64 "voprov:annotation": "Aladin RGB image generation for NGC 6946",
65 "voprov:desc_type": "RGBencoding",
66 "voprov:desc_name": "Aladin RGB image generation algorithm",
67 "voprov:desc_doculink": "http://cds.u-strasbg.fr/aladin.gml",
68 "voprov:desc_id": "AlaRGB"
69 }
70 },
71 "wasGeneratedBy": {
72 "_:id4": {
73 "voprov:time": "2017-05-05T00:00:00",
74 "voprov:entity": "ivo://CDS/P/DSS2color#RGB_NGC6946",
75 "voprov:activity": "hips:AlaRGB1"
76 }
77 },
78 "used": {
79 "_:id1": {
80 "voprov:entity": "ivo://CDS/P/DSS2/POSSII#POSSII.J-DSS2.143",
81 "voprov:activity": "hips:AlaRGB1"
82 },
83 "_:id3": {
84 "voprov:entity": "ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143",
85 "voprov:activity": "hips:AlaRGB1"
86 },
87 "_:id2": {
88 "voprov:entity": "ivo://CDS/P/DSS2/POSSII#POSSII.F-DSS2.143",
89 "voprov:activity": "hips:AlaRGB1"
90 }
91 },
92 "entity": {
93 "ivo://CDS/P/DSS2/POSSII#POSSII.J-DSS2.143": {
94 "voprov:name": "POSSII Blue Survey DSS2 NGC6946",
95 "voprov:annotation": "DSS2 digitization of the Blue POSSII Schmidt survey around NGC 6946",
96 "voprov:doculink": "http://cds.u-strasbg.fr/aladin.gm"
97 },
98 "ivo://CDS/P/DSS2/POSSII#POSSII.F-DSS2.143": {
99 "voprov:name": "POSSII Red Survey DSS2 NGC6946",
100 "voprov:annotation": "DSS2 digitization of the Red POSSII Schmidt survey around NGC 6946",
101 "voprov:doculink": "http://cds.u-strasbg.fr/aladin.gml"
102 },
103 "ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143": {
104 "voprov:name": "POSSII Infra Red Survey DSS2 NGC6946",
105 "voprov:annotation": "DSS2 digitization of the Infra Red POSSII Schmidt survey around NGC 6946",
106 "voprov:doculink": "http://cds.u-strasbg.fr/aladin.gm"
107 },
108 "ivo://CDS/P/DSS2color#RGB_NGC6946": {
109 "voprov:name": "RGB DSS2 image for NGC 6946",
110 "voprov:annotation": "PNG RGB image built from DSS2 with Aladin for galaxy NGC 6946",
111 "voprov:doculink": "http://cds.u-strasbg.fr/aladin.gml"
112 }
113 }
114 }
115 \end{lstlisting}
116
117 Here is the mapping obtained for the same data description with the PROV-VOTable serialisation format.
118
119 \begin{lstlisting}[language=XML, caption= PROV-VOTable serialisation example for a color composition activity]
120 <?xml version="1.0" encoding="UTF-8"?>
121 <VOTABLE version="1.2" xmlns="http://www.ivoa.net/xml/VOTable/v1.2"
122 xmlns:hips="http://cds.u-strasbg.fr/data/"
123 xmlns:ivo="http://www.ivoa.net/documents/rer/ivo/"
124 xmlns:voprov="http://www.ivoa.net/documents/dm/provdm/voprov/"
125 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
126 xsi:schemaLocation="http://www.ivoa.net/xml/VOTable/v1.2 http://www.ivoa.net/xml/VOTable/VOTable-1.2.xsd">
127 <RESOURCE type="provenance">
128 <DESCRIPTION>Provenance VOTable</DESCRIPTION>
129 <TABLE name="Used" utype="voprov:Used">
130 <FIELD name="activity_id" utype="voprov:Used.activity"arraysize="*" ucd="meta.id" datatype="char" />
131 <FIELD name="entity_id" utype="voprov:Used.entity" arraysize="*" ucd="meta.id" datatype="char" />
132 <DATA>
133 <TABLEDATA>
134 <TR>
135 <TD>hips:AlaRGB1</TD>
136 <TD>ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143</TD>
137 </TR>
138 </TABLEDATA>
139 </DATA>
140 </TABLE>
141 <TABLE name="WasGeneratedBy" utype="voprov:WasGeneratedBy">
142 <FIELD name="entity" utype="voprov:wasGeneratedBy.entity" arraysize="*" datatype="char" ucd="meta.id"/>
143 <FIELD name="activity" utype="voprov:wasGeneratedBy.activity" arraysize="*" datatype="char" ucd="meta.id"/>
144 <DATA>
145 <TABLEDATA>
146 <TR>
147 <TD>ivo://CDS/P/DSS2color#RGB_NGC6946</TD>
148 <TD>hips:AlaRGB1</TD>
149 </TR>
150 </TABLEDATA>
151 </DATA>
152 </TABLE>
153 <TABLE name="Activity" utype="voprov:Activity">
154 <FIELD name="id" utype="voprov:Activity.id" ucd="meta.id" arraysize="*" datatype="char" />
155 <FIELD name="name" utype="voprov:Activity.name" ucd="meta.title" arraysize="*" datatype="char" />
156 <FIELD name="start" utype="voprov:Activity.startTime" ucd="time.start" arraysize="*" datatype="char" />
157 <FIELD name="end" utype="voprov:Activity.endTime" ucd=""time.end" arraysize="*" datatype="char" "/>
158 <FIELD name="annotation" utype="voprov:Activity.annotation" ucd="meta.description" arraysize="*" datatype="char" />
159 <FIELD name="desc_id" utype="voprov:ActivityDescription.id" ucd="meta.id" arraysize="*" datatype="char" />
160 <FIELD name="desc_name" utype="voprov:ActivityDescription.name" ucd="meta.title" arraysize="*" datatype="char" />
161 <FIELD name="desc_type" utype="voprov:ActivityDescription.type" ucd="meta.code.class" arraysize="*" datatype="char" />
162 <FIELD name="desc_doculink" utype="voprov:ActivityDescription.doculink" ucd="meta.ref.url" arraysize="*" datatype="char" />
163 <DATA>
164 <TABLEDATA>
165 <TR>
166 <TD>hips:AlaRGB1</TD>
167 <TD>Aladin RGB 1</TD>
168 <TD>2017-04-18 17:28:00</TD>
169 <TD>2017-04-19 17:29:00</TD>
170 <TD>Aladin RGB image generation for NGC 6946</TD>
171 <TD>AlaRGB</TD>
172 <TD>Aladin RGB image generation algorithm</TD>
173 <TD>RGB encoding</TD>
174 <TD>http://cds.u-strasbg.fr/aladin.gml</TD>
175 </TR>
176 </TABLEDATA>
177 </DATA>
178 </TABLE>
179 <TABLE name="Entity" utype="voprov:Entity">
180 <FIELD name="id" utype="voprov:Entity.id" ucd="meta.id" arraysize="*" datatype="char" />
181 <FIELD name="name" utype="voprov:Entity.name" ucd="meta.title" arraysize="*" datatype="char" />
182 <FIELD name="annotation" utype="voprov:Entity.annotation" ucd="meta.description" arraysize="*" datatype="char" />
183 <DATA>
184 <TABLEDATA>
185 <TR>
186 <TD>ivo://CDS/P/DSS2/POSSII#POSSII.J-DSS2.143</TD>
187 <TD>POSSII Blue Survey DSS2 NGC6946</TD>
188 <TD>DSS2 digitization of the Blue POSSII Schmidt survey around NGC 6946</TD>
189 </TR>
190 <TR>
191 <TD>ivo://CDS/P/DSS2/POSSII#POSSII.F-DSS2.143</TD>
192 <TD>POSSII Red Survey DSS2 NGC6946</TD>
193 <TD>DSS2 digitization of the Red POSSII Schmidt survey around NGC 6946</TD>
194 </TR>
195 <TR>
196 <TD>ivo://CDS/P/DSS2/POSSII#POSSII.N-DSS2.143</TD>
197 <TD>POSSII Infra Red Survey DSS2 NGC6946</TD>
198 <TD>DSS2 digitization of the Infra red POSSII Schmidt survey around NGC 6946</TD>
199 </TR>
200 <TR>
201 <TD>ivo://CDS/P/DSS2color#RGB_NGC6946</TD>
202 <TD>RGB DSS2 image for NGC 6946</TD>
203 <TD>PNG RGB image built from DSS2 with Aladin for galaxy NGC 6946</TD>
204 </TR>
205 </TABLEDATA>
206 </DATA>
207 </TABLE>
208 <INFO name="QUERY_STATUS" value="OK"/>
209 </RESOURCE>
210 </VOTABLE>
211 \end{lstlisting}

msdemlei@ari.uni-heidelberg.de
ViewVC Help
Powered by ViewVC 1.1.26