Changes between Version 217 and Version 218 of WikiStart

Timestamp:

08/13/19 17:05:33 (5 years ago)

Author:

wouter

Comment:

--

WikiStart

@@ -95 +95 @@
  * [source:profile/src/main/java/geniusweb/profile/PartialOrdering.java PartialOrdering]: as {{{FullyOrderedSpace}}}, but may not know the answer for part of the bids
  * [source:profile/src/main/java/geniusweb/profile/utilityspace/UtilitySpace.java UtilitySpace]: as {{{FullOrdering}}}, but additionally this provides a function {{{getUtility(bid)}}} that maps the bid into a {{{BigDecimal}}} in [0,1]. The higher the value, the more preferred is that bid. The [source:profile/src/main/java/geniusweb/profile/utilityspace/LinearAdditiveUtilitySpace.java Linear Additive Space] is the most commonly used UtilitySpace. If the accuracy of {{{BigDecimal}}} is not needed, you can just call {{{BigDecimal#doubleValue()}}} to get a standard double. 
+
+The most common is the LinearAdditiveUtilitySpace. It contains
+ * the domain description containing the possible issueValues. 
+ * the name of the space
+ * the issueUtilities containing a set of ValueSetUtilities.
+ * The issueWeightsL a dictionary assigning a number to each of the issues. These numbers must add up to 1 and determine how much each ValueSetUtility adds to the total utility.
+ * a reservationBid that contains the bid that is the least preferred. Only bids equal or better than this bid should be accepted.
+
+ To give a full profile example:
+{{{
+{"LinearAdditiveUtilitySpace":
+ {"domain":{"name":"test",
+  "issuesValues":{
+   "issue2":{"values":["issue2value1","issue2value2"]},
+   "issue1":{"values": ["issue1value1","issue1value2"]}}},
+  "name":"testprofile",
+  "issueUtilities":{
+   "issue2":{"numberutils":{"lowValue":12,"lowUtility":0.3,"highValue":18,"highUtility":0.6}},
+   "issue1":{"discreteutils":{"valueUtilities":{"issue1value1":0.2,"issue1value2":0.3}}}},
+  "issueWeights":{"issue2":0.4,"issue1":0.6},
+  "reservationBid":{"issuevalues":{"issue2":"issue2value1","issue1":"issue1value2"}}
+}}
+}}}
+
+
+A party receives a reference to a profile but has to fetch the actual profile. You can defer this task to the ProfileConnectionFactory and in that case you receive a ready-to-use parsed java object. Most likely you get a Linear Additive Utilityspace, please check [source:profile/src/main/java/geniusweb/profile/utilityspace] for conversion details.
+
+ 
 
 == Party