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

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