Provenance DM: WD stage ended
Laurent Michel
laurent.michel at astro.unistra.fr
Wed Jul 17 16:24:14 CEST 2019
(sorry if you got this message twice)
Dear DMers ,
The WD period is over and it is time to move on.
The development process of this standard is a long trip and I would like to thank all of the contributors, the whole WG as well
as the TCG for this achievement.
There were lots of change requests which have all been taken into account by M. Servillat, the document editor.
All of these requests are listed below with the editor answers.
We need now a couple of days to arrange the PR2 page and to publish all that material on ivoadoc.
You will be notified when the PR stage will start.
Best
LM
Editor Answers
=============
1. Prov-WD: Prov-WD: small authors list problem
* ok, Boisson before Bonnarel (editors, including former editors, then alphabetical list)
2. Prov-WD: "package" unexplained in modeling_conventions.tex
* http://mail.ivoa.net/pipermail/dm/2019-June/005855.html
* We are not redefining every UML feature in the modeling conventions, this addition brings nothing and is thus not necessary
3. Prov-WD: Remove "not-null" hint from EntityDescription table
* http://mail.ivoa.net/pipermail/dm/2019-June/005853.html
* ok
4. Prov-WD: Cleanup from unused text
* http://mail.ivoa.net/pipermail/dm/2019-June/005857.html
* This has no impact on the generated PDF, and it is at the editor's discretion
5. Prov-WD: Remove unused color definitions
* http://mail.ivoa.net/pipermail/dm/2019-June/005856.html
* This has no impact on the generated PDF, and it is at the editor's discretion
6. Prov-WD: ProvTAP vs. Provenance data model review
* http://mail.ivoa.net/pipermail/dm/2019-June/005852.html
* out of topic, ProvTAP is a different standard than the data model, still in development. The scope of ProvTAP will be
defined later, and it may or may not bring some restrictions with respect to the data model.
7. Prov-WD: Attribute missing in Figure 7
* http://mail.ivoa.net/pipermail/dm/2019-June/005854.html
* Modelio models were updated (the issue here was the size of the box)
8. Prov-WD: Wrong multiplicity of Activity --> WasConfiguredBy
* http://mail.ivoa.net/pipermail/dm/2019-June/005858.html
* The relation multiplicities in Fig 1, 7 and 8 are: "Activity 1 --> * WasConfiguredBy" as they should indeed be. This was
checked in the latest figures.
9. Prov-WD: W3C compatibility review
* http://mail.ivoa.net/pipermail/dm/2019-June/005859.html
* W3C compatibility is not a requirement. The requirement is "Provenance information should be serializable into the W3C
provenance standard formats (PROV-N, PROV-XML, PROV-JSON) with minimum information loss."
* This will be investigated for the serialization specification, not in the data model document, which already ensures that
the core model is fully based on W3C concepts (so the requirement at this level is met).
10. Prov-WD: Usage/GenerationDescription -> EntityDescription relation
* http://mail.ivoa.net/pipermail/dm/2019-June/005860.html
* There is no restriction as descriptions are optional (multiplicity 0..1), but to avoid confusion, "must" is now replaced
by "if ... is expected to" in the examples (as this is in another context than the definition of the standard)
* An additional clarification is needed to indicate that the relation Activity-ActivityDescription is dominant: "If an
instance of Used/WGB/ED is linked to its corresponding description, then there must exist a link between the corresponding
activity and activity description."
* MAY is properly given (2.5.3) : "Instances of Used (respectively WasGeneratedBy) may thus point to an instance of
UsageDescription (respectively GenerationDescription)."
* In 2.7.1, it is properly explained that "The corresponding description classes, ParameterDescription and
ConfigFileDescription, are both defined in the context of the description of an activity"
11. Prov-WD: Figure 7: relations are mentioned in the wrong direction
* http://mail.ivoa.net/pipermail/dm/2019-June/005861.html
* changed to "bound with", no direction is involved.
12. Prov-WD: Several Agents may have the same role
* http://mail.ivoa.net/pipermail/dm/2019-June/005862.html
* this is just an illustration, but "with a different role" is removed to avoid confusion
13. Prov-WD: Multiplicity of Entity->WasGeneratedBy is wrong
* http://mail.ivoa.net/pipermail/dm/2019-June/005863.html
* In all figures, the relation is "Entity 1 --> 0..1 WasGeneratedBy" as it should indeed be. This was checked in the latest
figures.
14. Prov-WD: wasConfiguredBy.artefactType has the wrong type
* http://mail.ivoa.net/pipermail/dm/2019-June/005864.html
* ok, the text will indicates: "artefactType, TypeOfConfigArtefact, string that takes the value "Parameter" or "ConfigFile"
to indicate the type of class pointed by the WasConfiguredBy instance."
15. Prov-WD: Wrong description of ParameterDescription.default
* http://mail.ivoa.net/pipermail/dm/2019-June/005865.html
* indeed, "entity" has to be replaced by "parameter" here.
16. Prov-WD: Agent type list differs from the one in the table
* http://mail.ivoa.net/pipermail/dm/2019-June/005866.html
* The table indicates the precise "Enumeration of Agent types", while the text illustrates this ("can").
* + "for instance"
17. Prov-WD: Type mismatch for "unit" between text and figures
* http://mail.ivoa.net/pipermail/dm/2019-June/005867.html
* unit is a string that follows a recommended form.
* changed to Unit in the table with a reference to C.1.1.
18. Prov-WD: Harmonize name of descriptive column and lowercase first char in table
* http://mail.ivoa.net/pipermail/dm/2019-June/005868.html
* the comments in Table 9 were changed to lower case only.
19. Prov-WD: ValueEntityDescription: "default" attribute has unclear description
* http://mail.ivoa.net/pipermail/dm/2019-June/005869.html
* It seems clear that ValueEntityDescription.default is the default value in the context of the activity description (i.e.
the expected default value). It may then be compared to ValueEntity.value to check if the default was used or not.
20. Prov-WD: capitalize "main" use/generation type in text
* http://mail.ivoa.net/pipermail/dm/2019-June/005870.html
* ok
21. Prov-WD: "multiplicity" attributes in Usage/GenerationDescription unclear
* http://mail.ivoa.net/pipermail/dm/2019-June/005871.html
* the data type is string, and it contains a number or a word to indicate that the value is unbounded.
* "*" is replaced by "unbounded" which is commonly used (minOccur, maxOccur in XSD)
22. Prov-WD: Document should be accessible
* http://mail.ivoa.net/pipermail/dm/2019-July/005872.html
* The descriptions of relations was discussed within the group.
23. Prov-WD: Misleading reproducibility phrasing
* http://mail.ivoa.net/pipermail/dm/2019-July/005873.html
* the replacement proposed does not bring more information, so we should keep the text agreed at the Paris interop meeting.
24. Prov-WD: open publishing policy for science data not referenced
* http://mail.ivoa.net/pipermail/dm/2019-July/005874.html
* this sentence references the FAIR principles that are explicitly about "simple guideposts to inform those who publish",
and there is no question that "open publishing" (https://en.wikipedia.org/wiki/Open_publishing) is relevant to science data, and
largely adopted in astronomy.
25. Prov-WD: Secondary, unneeded/irritating definition of provenance
* http://mail.ivoa.net/pipermail/dm/2019-July/005875.html
* this overview was requested in the first RFC, it provides an accessible description (not a definition) of the concepts
manipulated.
* + "In the VO context, ... is thus..."
26. Prov-WD: Fix typo in Makefile
* http://mail.ivoa.net/pipermail/dm/2019-July/005879.html
* ok
27. Prov-WD: Activity, Entity, ActivityConfiguration not formatted
* http://mail.ivoa.net/pipermail/dm/2019-July/005880.html
* ok
28. Prov-WD: Wrong object in agent role descriptions
* http://mail.ivoa.net/pipermail/dm/2019-July/005886.html
* maybe "Author" is more relevant for an entity, and "Operator" more relevant for an activity, but there is no strict rule
(see W3C PROV examples). The list simply reflects what is found in astronomy projects in general.
29. Prov-WD: Use Plates as example for Entity
* http://mail.ivoa.net/pipermail/dm/2019-July/005885.html
* ok
30. Prov-WD: Make clear that ConfigFiles are not entities
* http://mail.ivoa.net/pipermail/dm/2019-July/005886.html
* ConfigFile is not linked to Entity in the model, this is clear.
31. Prov-WD: Use versionized URLs for W3C standards
* http://mail.ivoa.net/pipermail/dm/2019-July/005889.html
* ok
32. Provenance DM WD review - invalidatedAtTime description
* http://mail.ivoa.net/pipermail/dm/2019-July/005890.html
* Removed misleading sentence: "This does not relate to the validity of the entity."
33. Prov-WD: AgentType descriptions confusing
* http://mail.ivoa.net/pipermail/dm/2019-July/005899.html
* ok to take the W3C definition, plus our examples
* + Person: Person agents are people, e.g. described by their name or their position
* + Organization: an organization is a social or legal institution, e.g. an institute, a consortium, a project
34. Prov-WD: Separation of possible values in ParameterDescription.options and ValueDescription.options
* http://mail.ivoa.net/pipermail/dm/2019-July/005900.html
* as values are represented by a string, it is straightforward to have options as a comma separated values, as agreed at
the Paris meeting
35. Prov-WD: Restrictions for specific Entities not formulated
* http://mail.ivoa.net/pipermail/dm/2019-July/005903.html
* "The entity description classes for both ValueEntity and DatasetEntity are subsetted respectively as ValueDescription or
DatasetDescription."
36. Prov-WD: DatasetEntity not clearly defined
* http://mail.ivoa.net/pipermail/dm/2019-July/005904.html
* the defined structure of a dataset is given by the contentType, this gives freedom to manpulate any dataset a project
wants to define
37. Prov-WD: Conflicting description of DatasetDescription.contentType
* http://mail.ivoa.net/pipermail/dm/2019-July/005905.html
* indeed, "file" is better replaced by "dataset"
* it is better to remove "may", as the objective is to illustrate
--
jesuischarlie/Tunis/Paris/Bruxelles/Berlin
Laurent Michel
SSC XMM-Newton
Tél : +33 (0)3 68 85 24 37
Fax : +33 (0)3 )3 68 85 24 32
Université de Strasbourg <http://www.unistra.fr>
Observatoire Astronomique
11 Rue de l'Université
F - 67200 Strasbourg
More information about the dm
mailing list