commit 39f9e447f3e2b343cf26c7f64fc394837e8b9124
parent 6c3c6eedc2823d7ec06597be6324debc1b6cb044
Author: elf Pavlik <elf-pavlik@hackers4peace.net>
Date: Sat, 26 Aug 2017 06:56:31 -0500
Merge pull request #236 from valueflows/classification
Classification
Diffstat:
5 files changed, 78 insertions(+), 55 deletions(-)
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
@@ -17,6 +17,8 @@
* [Process](introduction/processes.md)
* [Exchange](introduction/exchanges.md)
* [Intent and Commitment](introduction/intents.md)
+* [Scoping](introduction/scope.md)
+* [Classification](introduction/classification.md)
* [Conversation for Action](introduction/cfa.md)
* [Accounting](introduction/accounting.md)
diff --git a/docs/introduction/classification.md b/docs/introduction/classification.md
@@ -0,0 +1,28 @@
+# Classification
+
+Classification creates references to categories, models, and other classifications of the economic resources, processes, and exchanges. The classifications can be a part of a taxonomy, flat list, tag set, faceted classification scheme, and any other structure desired. ValueFlows will not include the structures that the classifications are part of, and assume that is handled outside the VF scope.
+
+Classifications can be created by user groups for themselves, or can be existing semantic structures, such as wikidata.
+
+#### Examples
+
+##### Resource Classification
+
+ Haralson apple - https://www.wikidata.org/wiki/Q3127261
+ Honda Fit - https://www.wikidata.org/wiki/Q1135125
+ Transistor - https://www.wikidata.org/wiki/Q5339
+
+##### Process Classification
+
+ Transport - https://www.wikidata.org/wiki/Q7590
+ Packaging - https://www.wikidata.org/wiki/Q29585952
+
+##### Exchange Classification
+
+ Trade - https://www.wikidata.org/wiki/Q601401
+ Barter - https://www.wikidata.org/wiki/Q484830
+ Gift - https://www.wikidata.org/wiki/Q184303
+
+#### Recipes
+
+Coming in future releases.+
\ No newline at end of file
diff --git a/docs/introduction/scope.md b/docs/introduction/scope.md
@@ -15,7 +15,6 @@ For functions that require traversing value flows, often the value flow will cro
* Standing agreements can govern what happens.
* A conversation for action might be required to determine what should occur for the specific instance.
-
#### Accounting
Accounting is usually done for an agent or other bounded scope. Where a computer system supports one enterprise, this is simple. When a computer system supports many organizations or there is a distributed network of economic activity, it is useful to be able to segregate the accounting using scope. It basically enables multi-party accounting in a networked scenario.
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/all_vf.TTL b/release-doc-in-process/all_vf.TTL
@@ -16,34 +16,30 @@
dcterms:status <http://purl.org/adms/status/UnderDevelopment>.
-# ABSTRACT CLASSES (KNOWLEDGE LAYER)
+# ABSTRACT / CLASSIFICATION CLASSES (KNOWLEDGE LAYER)
vf:Action a owl:Class ;
rdfs:label "vf:Action" ;
rdfs:subClassOf rdf:Property ;
rdfs:comment "An action verb defining the kind of event, commitment, or intent." .
-#vf:AgentRelationshipRole a owl:Class ;
-# rdfs:label "vf:AgentRelationshipRole" ;
-# rdfs:subClassOf rdf:Property ;
-# rdfs:comment "A relationship role defining the kind of association one agent can have with another." .
-
-#vf:TaxonomyItem a owl:Class ;
-# rdfs:label "vf:TaxonomyItem" .
-
-vf:ResourceTaxonomyItem a owl:Class ;
- rdfs:label "vf:ResourceTaxonomyItem" ;
- #rdfs:subClassOf vf:TaxonomyItem ;
- rdfs:comment "A resource category, part of a taxonomy." .
+vf:AgentRelationshipRole a owl:Class ;
+ rdfs:label "vf:AgentRelationshipRole" ;
+ rdfs:subClassOf rdf:Property ;
+ rdfs:comment "A relationship role defining the kind of association one agent can have with another." .
-#vf:ProcessTaxonomyItem a owl:Class ;
-# rdfs:label "vf:ProcessTaxonomyItem" ;
-# rdfs:subClassOf vf:TaxonomyItem .
+vf:ResourceClassification a owl:Class ;
+ rdfs:label "vf:ResourceClassification" ;
+ rdfs:comment "A resource category, model, taxonomy item, tag, facet value, or other kind of classification." .
-#vf:ExchangeTaxonomyItem a owl:Class ;
-# rdfs:label "vf:ExchangeTaxonomyItem" ;
-# rdfs:subClassOf vf:TaxonomyItem .
+vf:ProcessClassification a owl:Class ;
+ rdfs:label "vf:ProcessClassification" ;
+ rdfs:comment "A process category, model, taxonomy item, tag, facet value, or other kind of classification." .
+vf:ExchangeClassification a owl:Class ;
+ rdfs:label "vf:ExchangeClassification" ;
+ rdfs:comment "An exchange category, model, taxonomy item, tag, facet value, or other kind of classification." .
+
# PLAN CLASSES
#vf:Intent a owl:Class ;
@@ -74,16 +70,16 @@ vf:Process a owl:Class ;
rdfs:label "vf:Process" ;
rdfs:comment "An activity that changes inputs into outputs. It could transform or transport vf:EconomicResource(s), as well as simply issuing a resource so that it is available." .
-vf:Transportation a owl:Class ;
- rdfs:label "vf:Transportation" ;
- rdfs:subClassOf vf:Process ;
- rdfs:comment "A process that changes the location of a resource(s) without changing the resource(s) itself." .
+#vf:Transportation a owl:Class ;
+# rdfs:label "vf:Transportation" ;
+# rdfs:subClassOf vf:Process ;
+# rdfs:comment "A process that changes the location of a resource(s) without changing the resource(s) itself." .
+
+#vf:Transformation a owl:Class ;
+# rdfs:label "vf:Transformation" ;
+# rdfs:subClassOf vf:Process ;
+# rdfs:comment "A process that produces something new from other resources, or improves an existing resource." .
-vf:Transformation a owl:Class ;
- rdfs:label "vf:Transformation" ;
- rdfs:subClassOf vf:Process ;
- rdfs:comment "A process that produces something new from other resources, or improves an existing resource." .
-
vf:EconomicEvent a owl:Class ;
rdfs:label "vf:EconomicEvent" ;
rdfs:comment "An inflow or outflow of an economic resource in relation to a process and/or exchange. This could reflect a change in the quantity of a vf:EconomicResource. It is also defined by its behavior in relation to the vf:EconomicResource and a vf:Process (consume, use, produce, etc.)" .
@@ -198,40 +194,37 @@ vf:committedOutputOf
# rdfs:domain vf:Intent ;
# rdfs:range vf:Process .
-vf:resourceCategory
+vf:resourceClassifiedAs
a owl:ObjectProperty ;
- rdfs:label "category" ;
+ rdfs:label "resource classified by" ;
rdfs:domain vf:EconomicResource ;
- rdfs:range vf:ResourceTaxonomyItem ;
- rdfs:comment "A type or categorization that describes a resource, at any level of granularity." .
+ rdfs:range vf:ResourceClassification ;
+ rdfs:comment "Relates a resource to its primary classification, as part of describing that resource." .
-vf:committedCategory
+vf:committedResourceClassifiedAs
a owl:ObjectProperty ;
- rdfs:label "committed category" ;
+ rdfs:label "committed resource classified by" ;
rdfs:domain vf:Commitment ;
- rdfs:range vf:ResourceTaxonomyItem ;
- rdfs:comment "A type or categorization that describes a resource committed, at any level of granularity." .
+ rdfs:range vf:ResourceClassification ;
+ rdfs:comment "The primary classification that describes a resource committed, at any level of granularity." .
# will need one for Intent too
-# waiting to do the recipe model
-
-#vf:processCategory
-# a owl:ObjectProperty ;
-# rdfs:domain vf:Process ;
-# rdfs:range vf:ProcessTaxonomyItem .
+vf:processClassifiedAs
+ a owl:ObjectProperty ;
+ rdfs:label "process classified by" ;
+ rdfs:domain vf:Process ;
+ rdfs:range vf:ProcessClassification ;
+ rdfs:comment "The primary classification that describes a process, at any level of granularity." .
-#vf:exchangeCategory
-# a owl:ObjectProperty ;
-# rdfs:domain vf:ExchangeAgreement ;
-# rdfs:range vf:ExchangeTaxonomyItem .
+vf:exchangeClassifiedAs
+ a owl:ObjectProperty ;
+ rdfs:label "exchange classified by" ;
+ rdfs:domain vf:ExchangeAgreement ;
+ rdfs:range vf:ExchangeClassification ;
+ rdfs:comment "The primary classification that describes an exchange agreement, at any level of granularity." .
-#vf:parent
-# a owl:ObjectProperty ;
-# rdfs:label "parent" ;
-# rdfs:domain vf:ResourceTaxonomyItem ;
-# rdfs:range vf:ResourcetaxonomyItem ;
-# rdfs:comment "A more general or broader category of resource." .
+# waiting to do the recipe model
vf:involves
a owl:ObjectProperty ;
@@ -250,8 +243,8 @@ vf:underlyingResource
vf:relationship a owl:ObjectProperty ;
rdfs:label "relationship" ;
rdfs:domain vf:AgentRelationship ;
- rdfs:range rdf:Property ; # think about creating a subproperty for these
- rdfs:comment "A verb that describes a generic defined relationship that exists between 2 agents." .
+ rdfs:range vf:AgentRelationshipClassification ;
+ rdfs:comment "A kind of relationship that exists between 2 agents." .
#vf:commitsTo
# a owl:ObjectProperty ;
