commit eefbb6d487e3ef4d1fc552f337dfe303e931f89a
parent ac6376282a9a6f05a434679ba8e283eaafcb2623
Author: Bob Haugen <bob.haugen@gmail.com>
Date: Sun, 18 Aug 2019 06:24:53 -0500
Merge pull request #562 from valueflows/fixes5
more fixes
Diffstat:
5 files changed, 32 insertions(+), 30 deletions(-)
diff --git a/docs/appendix/track.md b/docs/appendix/track.md
@@ -14,21 +14,23 @@
One of the most-often used traces is to find the origins of health problems like mad cow disease and tainted drugs and food. In Value Flows terms, that would start with the product (economic resource) that caused a health problem, and trace back along the chain of resource flows to the source or sources of the product. Then it might be necessary to also track forwards from the source(s) to find everything else that might include that source(s).
-Here is the logic for tracking and tracing.
+Here is the logic finding the flow element that comes after a particular element (tracking) and before a particular element (tracing):
* For an EconomicResource:
- * after: EconomicEvents affecting it that are inputs to Processes or Transfers
- * before: EconomicEvents affecting it that are outputs from Processes or Transfers
-* For a Process or Transfer:
+ * after: EconomicEvents affecting it that are inputs to Processes or transfer/move EconomicEvents with the resource defined as the `resourceInventoriedAs`
+ * before: EconomicEvents affecting it that are outputs from Processes or transfer/move EconomicEvents with the resource defined as the `toResourceInventoriedAs`
+* For a Process:
* after: EconomicEvents that are outputs
* before: EconomicEvents that are inputs
* For an EconomicEvent:
* after:
- * a Process or Transfer to which it is an input, or
- * an EconomicResource which it affected as the output of a Process or Transfer
+ * a Process to which it is an input, or
+ * an EconomicResource which it affected as the output of a Process, or
+ * if it is a transfer or move event, the EconomicResource labelled `toResourceInventoriedAs`
* before:
- * a Process or Transfer from which is is an output, or
- * if it is an input to a Process or Transfer, the EconomicResource which it affects.
+ * a Process from which it is an output, or
+ * if it is an input to a Process, the EconomicResource which it affects, or
+ * if it is a transfer or move event and the current EconomicResource is the toResourceInventoriedAs, then the previous EconomicResource is the resourceInventoriedAs
When more than one resource of the same specification goes from input to output of the same process, use the tracking identifier if you need to track or trace the same resource. And example of this would be less-than-truckload shipments, where many separate resources with different destinations are included in the same shipment process.
diff --git a/docs/introduction/resources.md b/docs/introduction/resources.md
@@ -21,7 +21,7 @@ is a specification. Your library may have two copies that you can check out. Tho
#### The difference between a resource specification and a resource classification
-An economic resource or a flow can have only one *resource specification* in ValueFlows. This defines the lowest level useful type or kind of the resource that is needed. The ValueFlows vocabulary defines this as the ResourceSpecification. Note that often taxonomies and other references on the web can define very specific resource specifications at their leaf levels, and these can be used if the necessary properties can be found.
+An economic resource or a flow can have only one *resource specification* in ValueFlows. This defines the lowest level useful type or kind of the resource that is needed. The ValueFlows vocabulary defines this as the ResourceSpecification. Note that often taxonomies and other references on the web can define very specific resource specifications at their leaf levels, and these can be used if the necessary properties can be found. Note also that for specific global identifiers such as GTIN, we recommend using properties of the [GoodRelations ProductOrServiceModel](http://www.heppnetz.de/ontologies/goodrelations/v1.html#ProductOrServiceModel).
An economic resource or a flow can have any number of *resource classifications*. They are used to filter, match, or group economic resources. Resource classifications can be part of a taxonomy. That means they can be defined very broadly and generally and maybe vaguely, or they can be defined very narrowly, but fit into broader classifications.
diff --git a/release-doc-in-process/ValueFlowsUML.png b/release-doc-in-process/ValueFlowsUML.png
Binary files differ.
diff --git a/release-doc-in-process/ValueFlowsUML.xml b/release-doc-in-process/ValueFlowsUML.xml
@@ -1,27 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
-<mxfile modified="2019-08-15T19:08:28.070Z" host="www.draw.io" agent="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:68.0) Gecko/20100101 Firefox/68.0" etag="hLIIdUZrRERKvEsEyqY2" version="11.1.2" type="google" compressed="false">
+<mxfile modified="2019-08-18T10:42:45.160Z" host="www.draw.io" agent="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:68.0) Gecko/20100101 Firefox/68.0" etag="pgDGrBelGmKdjk6gC8v9" version="11.1.2" type="google" compressed="false">
<diagram id="fbe6a5e9-5b10-23b0-562a-0cf294ecc85a" name="Page-1">
- <mxGraphModel dx="2657" dy="3037" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="2000" math="0" shadow="0">
+ <mxGraphModel dx="2205" dy="2778" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="2000" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="2028f4c0cddd94fa-15" value="Observation" style="whiteSpace=wrap;html=1;fillColor=#d5e8d4;dashed=1;strokeColor=#82b366;fontSize=14;verticalAlign=top;align=left;" parent="1" vertex="1">
- <mxGeometry x="-140" y="614" width="2750" height="520" as="geometry"/>
+ <mxGeometry x="-140" y="614" width="2670" height="520" as="geometry"/>
</mxCell>
<mxCell id="2028f4c0cddd94fa-14" value="Plan" style="whiteSpace=wrap;html=1;fillColor=#f8cecc;dashed=1;strokeColor=#b85450;verticalAlign=top;align=left;fontSize=14;" parent="1" vertex="1">
- <mxGeometry x="-140" y="44" width="2751" height="570" as="geometry"/>
+ <mxGeometry x="-140" y="44" width="2670" height="570" as="geometry"/>
</mxCell>
<mxCell id="2028f4c0cddd94fa-13" value="<font style="font-size: 14px">Knowledge</font>" style="whiteSpace=wrap;html=1;fillColor=#fff2cc;dashed=1;strokeColor=#d6b656;align=left;verticalAlign=top;" parent="1" vertex="1">
- <mxGeometry x="-140" y="-321" width="2750" height="365" as="geometry"/>
+ <mxGeometry x="-140" y="-321" width="2670" height="365" as="geometry"/>
</mxCell>
<mxCell id="2b1bba910c18a604-3" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>foaf:Agent</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:name</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:image</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:primaryLocation</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">skos:note<br></font></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="2151.5" y="638" width="120" height="130" as="geometry"/>
+ <mxGeometry x="2131.5" y="638" width="120" height="130" as="geometry"/>
</mxCell>
<mxCell id="2b1bba910c18a604-5" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>foaf:Person</b><br></font></p><hr>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="2085.5" y="873" width="110" height="60" as="geometry"/>
+ <mxGeometry x="2065.5" y="873" width="110" height="60" as="geometry"/>
</mxCell>
<mxCell id="2b1bba910c18a604-6" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>org:Organization</b><br></font></p><hr>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="2222.5" y="873" width="135" height="60" as="geometry"/>
+ <mxGeometry x="2202.5" y="873" width="135" height="60" as="geometry"/>
</mxCell>
<mxCell id="2b1bba910c18a604-8" value="" style="endArrow=block;endSize=16;endFill=0;html=1;strokeColor=#000000;entryX=0.75;entryY=1;exitX=0.5;exitY=0;" parent="1" source="2b1bba910c18a604-6" target="2b1bba910c18a604-3" edge="1">
<mxGeometry x="2118.5" y="659" width="160" as="geometry">
@@ -30,7 +30,7 @@
</mxGeometry>
</mxCell>
<mxCell id="2b1bba910c18a604-9" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:AgentRelationship</b><br></font></p><hr><font style="font-size: 11px">&nbsp; vf:inScopeOf<br></font><div>&nbsp; skos:note<br></div>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="2409.5" y="668" width="168" height="90" as="geometry"/>
+ <mxGeometry x="2325.5" y="738" width="168" height="90" as="geometry"/>
</mxCell>
<mxCell id="2b1bba910c18a604-10" value="vf:subject" style="endArrow=block;endFill=1;endSize=6;html=1;strokeColor=#000000;exitX=0;exitY=0.25;entryX=1;entryY=0.25;" parent="1" source="2b1bba910c18a604-9" target="2b1bba910c18a604-3" edge="1">
<mxGeometry width="100" relative="1" as="geometry">
@@ -38,7 +38,7 @@
<mxPoint x="1928.5" y="903" as="targetPoint"/>
</mxGeometry>
</mxCell>
- <mxCell id="2b1bba910c18a604-11" value="vf:object" style="endArrow=block;endFill=1;endSize=6;html=1;strokeColor=#000000;exitX=0;exitY=0.5;entryX=1;entryY=0.5;" parent="1" source="2b1bba910c18a604-9" target="2b1bba910c18a604-3" edge="1">
+ <mxCell id="2b1bba910c18a604-11" value="vf:object" style="endArrow=block;endFill=1;endSize=6;html=1;strokeColor=#000000;exitX=0;exitY=0.75;entryX=1;entryY=0.75;entryDx=0;entryDy=0;exitDx=0;exitDy=0;" parent="1" source="2b1bba910c18a604-9" target="2b1bba910c18a604-3" edge="1">
<mxGeometry x="2058.5" y="696" width="100" as="geometry">
<mxPoint x="2136.5" y="696" as="sourcePoint"/>
<mxPoint x="2058.5" y="706" as="targetPoint"/>
@@ -47,8 +47,8 @@
<mxCell id="2b1bba910c18a604-13" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:EconomicResource</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:name</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:trackingIentifier</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:accountingQuantity</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:onhandQuantity<br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:currentLocation</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">skos:note<br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:classifiedAs</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:image</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:unitOfEffort</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:stage</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:state</font><br></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
<mxGeometry x="5" y="672" width="170" height="198" as="geometry"/>
</mxCell>
- <mxCell id="2028f4c0cddd94fa-1" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:ResourceSpecification</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px">vf:name</p><p style="margin: 0px ; margin-left: 8px">vf:image</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfResource</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfEffect<br></p><p style="margin: 0px ; margin-left: 8px">vf:substitutable</p><p style="margin: 0px ; margin-left: 8px">vf:uri<br></p><p style="margin: 0px ; margin-left: 8px">skos:note<br></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="-108" y="-230" width="190" height="139" as="geometry"/>
+ <mxCell id="2028f4c0cddd94fa-1" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:ResourceSpecification</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px">vf:name</p><p style="margin: 0px ; margin-left: 8px">vf:image</p><p style="margin: 0px ; margin-left: 8px">vf:uri<br></p><p style="margin: 0px ; margin-left: 8px">skos:note<br></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
+ <mxGeometry x="-108" y="-221" width="190" height="130" as="geometry"/>
</mxCell>
<mxCell id="2028f4c0cddd94fa-4" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:Commitment</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:name</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:resourceQuantity</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:effortQuantity<br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:hasBeginning</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:hasEnd</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">:hasPointInTime</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">time:before</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">time:after<br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:finished</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:inScopeOf<br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px"><font>vf:resourceClassifiedAs</font></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px"><font>vf:stage</font></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px"><font>vf:state</font><br></font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">skos:note</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">dcterms:created</font></p><p style="margin: 0px ; margin-left: 8px"><font style="font-size: 11px">vf:agreedIn<br></font></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
<mxGeometry x="1234" y="272" width="151" height="273" as="geometry"/>
@@ -188,7 +188,7 @@
</mxGeometry>
</mxCell>
<mxCell id="1abf9e2170aed3bf-1" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:AgentRelationshipRole</b><br></font></p><hr><font style="font-size: 11px">&nbsp; rdfs:label<br></font><div><font style="font-size: 11px">&nbsp; vf:inverseLabel</font></div><div><font style="font-size: 11px">&nbsp; skos:note<br></font></div><font style="font-size: 11px"><br></font>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="2393.5" y="-96" width="200" height="90" as="geometry"/>
+ <mxGeometry x="2309.5" y="-91" width="200" height="90" as="geometry"/>
</mxCell>
<mxCell id="1abf9e2170aed3bf-2" value="vf:relationship" style="endArrow=block;endFill=1;endSize=6;html=1;strokeColor=#000000;exitX=0.5;exitY=0;entryX=0.5;entryY=1;" parent="1" source="2b1bba910c18a604-9" target="1abf9e2170aed3bf-1" edge="1">
<mxGeometry width="100" relative="1" as="geometry">
@@ -394,7 +394,7 @@
</mxGeometry>
</mxCell>
<mxCell id="Tauemc8Aw21Hce5KtOuX-38" value="vf:provider" style="endArrow=classic;html=1;entryX=0.25;entryY=0;entryDx=0;entryDy=0;exitX=1;exitY=0.75;exitDx=0;exitDy=0;" parent="1" source="Tauemc8Aw21Hce5KtOuX-33" target="2b1bba910c18a604-3" edge="1">
- <mxGeometry x="0.4866" y="-16" width="50" height="50" relative="1" as="geometry">
+ <mxGeometry x="0.5341" y="-12" width="50" height="50" relative="1" as="geometry">
<mxPoint x="2120" y="540" as="sourcePoint"/>
<mxPoint x="2170" y="490" as="targetPoint"/>
<mxPoint as="offset"/>
@@ -471,8 +471,8 @@
<mxPoint as="offset"/>
</mxGeometry>
</mxCell>
- <mxCell id="WgYd2YjfuSUQQR85dr-W-23" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:RecipeResource</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px">vf:name</p><p style="margin: 0px ; margin-left: 8px">vf:image</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfResource</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfEffect<br></p><p style="margin: 0px ; margin-left: 8px">vf:resourceClassifiedAs<br></p><p style="margin: 0px ; margin-left: 8px">skos:note<br></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
- <mxGeometry x="390" y="-269" width="190" height="129" as="geometry"/>
+ <mxCell id="WgYd2YjfuSUQQR85dr-W-23" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:RecipeResource</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px">vf:name</p><p style="margin: 0px ; margin-left: 8px">vf:image</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfResource</p><p style="margin: 0px ; margin-left: 8px">vf:unitOfEffect<br></p><p style="margin: 0px ; margin-left: 8px">vf:resourceClassifiedAs</p><p style="margin: 0px ; margin-left: 8px">vf:substitutable<br></p><p style="margin: 0px ; margin-left: 8px">skos:note<br></p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
+ <mxGeometry x="390" y="-280" width="190" height="140" as="geometry"/>
</mxCell>
<mxCell id="WgYd2YjfuSUQQR85dr-W-24" value="<p style="margin: 0px ; margin-top: 4px ; text-align: center ; text-decoration: underline"><font style="font-size: 13px"><b>vf:RecipeProcess</b><br></font></p><hr><p style="margin: 0px ; margin-left: 8px">vf:name</p><p style="margin: 0px ; margin-left: 8px">skos:note</p><p style="margin: 0px ; margin-left: 8px">time:hasDuration</p><p style="margin: 0px ; margin-left: 8px">vf:durationMultiplier</p><p style="margin: 0px ; margin-left: 8px">vf:processClassifiedAs</p>" style="verticalAlign=top;align=left;overflow=fill;fontSize=12;fontFamily=Helvetica;html=1;fillColor=#ffffff;strokeColor=#000000;" parent="1" vertex="1">
<mxGeometry x="1060" y="-138.5" width="171" height="125" as="geometry"/>
@@ -511,7 +511,7 @@
<mxPoint x="1850" y="130" as="sourcePoint"/>
<mxPoint x="1900" y="80" as="targetPoint"/>
<Array as="points">
- <mxPoint x="2242" y="119"/>
+ <mxPoint x="2222" y="119"/>
</Array>
</mxGeometry>
</mxCell>
diff --git a/release-doc-in-process/all_vf.TTL b/release-doc-in-process/all_vf.TTL
@@ -514,24 +514,24 @@ vf:finished a owl:DatatypeProperty ;
vf:substitutable a owl:DatatypeProperty ;
rdfs:label "substitutable" ;
- rdfs:domain vf:ResourceSpecification ;
+ rdfs:domain vf:RecipeResource ;
rdfs:range xsd:boolean ;
vs:term_status "unstable" ;
rdfs:comment "Defines if any resource of that type can be freely substituted for any other resource of that type when used, consumed, traded, etc." .
vf:unitOfResource a owl:ObjectProperty ;
rdfs:label "unit of resource" ;
- rdfs:domain [ owl:unionOf (vf:RecipeResource vf:ResourceSpecification) ] ;
+ rdfs:domain vf:RecipeResource ;
rdfs:range qudt:unit ;
vs:term_status "unstable" ;
rdfs:comment "The unit used for this resource in the recipe." .
vf:unitOfEffort a owl:ObjectProperty ;
rdfs:label "unit of effort" ;
- rdfs:domain [ owl:unionOf (vf:RecipeResource vf:EconomicResource vf:ResourceSpecification) ] ;
+ rdfs:domain [ owl:unionOf (vf:RecipeResource vf:EconomicResource) ] ;
rdfs:range qudt:unit ;
vs:term_status "unstable" ;
- rdfs:comment "The unit used for use or work actions." .
+ rdfs:comment "The unit used for use or work or sometimes cite actions." .
# TODO: need to define this, something like currency, inventory, skill, service; may be other aspects too.
#vf:resourceCategory a owl:ObjectProperty ;
