ProvFocusAsterics < IVOA

IVOA Web>IvoaDataModel>ObservationProvenanceDataModel>ProvFocusAsterics (2019-02-22, MireilleLouys) (raw view)

---+ PROV DM- PR preparation -second iteration
---+++ Activity Description Package

In order to push forward the Activity Configuration discussion, I have attached a last version of the class diagram below.

Documentation of the class diagram:
<div id="_mcePaste">

   * %BLUE%Parameter%ENDCOLOR%
</div> <div id="_mcePaste">Using the Parameter class allows to list the values read by an activity to parametrize its execution.</div> <div id="_mcePaste">Each Parameter instance is identified by its name and can be queried.</div>

A Parameter is a specific class. In contrary to !ValueEntity it does not hold all the relations an Entity may have :
<div style="padding-left: 30px;" id="_mcePaste">&bull; no wasAttributedTo --&gt; Agent link</div> <div style="padding-left: 30px;" id="_mcePaste">&bull; no hadMember--&gt; Activity link</div> <div style="padding-left: 30px;" id="_mcePaste">&bull; no Used --&gt; Activity link</div> <div style="padding-left: 30px;" id="_mcePaste">&bull; no wasGeneratedBy --&gt; Activity link</div> <div id="_mcePaste">If a Parameter value is chosen with respect to a Result Entity R, computed on purpose to generate this configuration value, or just reused from a previous excecution, then the Parameter Instance may have a wasInfluencedBy relation to this Result Entity R. This Entity R is then described in the system with the usual Entity links wasGeneratedBy and the Activity generating this value may also be described. The !WasInfluencedBy relation is part of the relations defined in the vo-dml list of relations (College Park version).</div>

This allows Parameter instances to be totally focused on the Configuration part of the Provenance DM, but still be able to trace the origin of their value.
<div id="_mcePaste">The description of this parameter is stored in the !ParameterDescription instance, which is connected via a Parameter --&gt; !ParameterDescription link, a Subset of Entity --&gt; !EntityDescription link.</div> <div id="_mcePaste">Identified and dedicated access to the configuration information allows to trace and interpret the quality of the activities/result entities more efficiently than sorting between Entity types and Used relations types.</div>

It suits to the life cycle of a Parameter instance which is the same as its related Activity.
<div id="_mcePaste">Would an Activity instance A be deleted from the database, all Parameters instances bound to it would also be deleted, while the Entities instances consumed by A still pervades into the database as it may be used by another task/activity.</div>

   * %BLUE%ParameterDescription%ENDCOLOR%
<div id="_mcePaste">To represent the semantics and encoding of the configuration values entered to run an activity distinguished from the datasets consumed and produced. A Parameter can be queried, on its value and on its description.</div>

   * %BLUE%ConfigFile%ENDCOLOR%
<div id="_mcePaste">The values used to control the activity are either contained into a Configuration file , which contains a key=value list .</div> <div id="_mcePaste">This resource is stored as an Entity of type = Document.</div> <div id="_mcePaste">The mechanism to search a value into this Document is managed by the project providing the Provenance information, usually using contextual text search.</div> <div id="_mcePaste">This method needed to explore the !ConfigFile content is outside the scope of this model.</div>

<br /> <!--
      * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup
-->

   * Activity Configuration package and its relation to the IVOA Prov DM:

   * class diagrams with independent parameter class/ no more derivation: https://wiki.ivoa.net/internal/IVOA/ProvFocusAsterics/PR2-ActivityAndConfigurationDescriptionFeb22v2.png
   * class diagram with the description links from Execution part ( left classes ) to Description part (right part) https://wiki.ivoa.net/internal/IVOA/ProvFocusAsterics/PR2-LinkingExecutionClassestoDescriptionClassesFeb22v2.png

Attachments

Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
png	ActivityAndConfigurationDescriptionForPR2_1502.png	r1	manage	103.1 K	2019-02-18 - 17:36	MireilleLouys	class diagram option 2: Independent parameter class/ no more derivation
png	Activity_and_Configuration_Description_for_PR2_2019_02_11.png	r1	manage	101.6 K	2019-02-11 - 14:08	MireilleLouys	Activity Configuration option one : Parameter inherits from ValueEntity
png	PR2-ActivityAndConfigurationDescriptionFeb22v2.png	r1	manage	115.4 K	2019-02-22 - 18:28	MireilleLouys	execution, description and configuration classes as independent packages
png	PR2-LinkingExecutionClassestoDescriptionClassesFeb22v2.png	r1	manage	89.3 K	2019-02-22 - 18:17	MireilleLouys	Linking Execution side with Description side/ class diagram
png	PR2-LinkingExecutionclassestoDescription_classes.png	r1	manage	86.2 K	2019-02-21 - 20:09	MireilleLouys	Linking Execution side with Description side/ class diagram
zip	PR2ModelioDocumentationFeb22.zip	r1	manage	738.0 K	2019-02-22 - 18:09	MireilleLouys	Modelio documentation of a normalised view on the model / all symetry applied /PR2 draft

Topic revision: r7 - 2019-02-22 - MireilleLouys

IVOA

Log in or Register

IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics

Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki

TWiki intro
TWiki tutorial
User registration
Notify me

Working Groups

Interest Groups

Time Domain

Committees

Stds&Procs

www.ivoa.net
Documents
Events
Members
XML Schema