source: javadoc/genius/core/utility/AdditiveUtilitySpace.html@ 1

Last change on this file since 1 was 1, checked in by Wouter Pasman, 7 years ago

Initial import : Genius 9.0.0
File size: 37.2 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<!-- NewPage -->
3<html lang="en">
4<head>
5<!-- Generated by javadoc (1.8.0_112) on Thu Jun 21 12:05:58 CEST 2018 -->
6<title>AdditiveUtilitySpace (Genius Core Documentation)</title>
7<meta name="date" content="2018-06-21">
8<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
9<script type="text/javascript" src="../../../script.js"></script>
10</head>
11<body>
12<script type="text/javascript"><!--
13 try {
14 if (location.href.indexOf('is-external=true') == -1) {
15 parent.document.title="AdditiveUtilitySpace (Genius Core Documentation)";
16 }
17 }
18 catch(err) {
19 }
20//-->
21var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":42,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10};
22var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
23var altColor = "altColor";
24var rowColor = "rowColor";
25var tableTab = "tableTab";
26var activeTableTab = "activeTableTab";
27</script>
28<noscript>
29<div>JavaScript is disabled on your browser.</div>
30</noscript>
31<!-- ========= START OF TOP NAVBAR ======= -->
32<div class="topNav"><a name="navbar.top">
33<!-- -->
34</a>
35<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
36<a name="navbar.top.firstrow">
37<!-- -->
38</a>
39<ul class="navList" title="Navigation">
40<li><a href="../../../overview-summary.html">Overview</a></li>
41<li><a href="package-summary.html">Package</a></li>
42<li class="navBarCell1Rev">Class</li>
43<li><a href="class-use/AdditiveUtilitySpace.html">Use</a></li>
44<li><a href="package-tree.html">Tree</a></li>
45<li><a href="../../../deprecated-list.html">Deprecated</a></li>
46<li><a href="../../../index-all.html">Index</a></li>
47<li><a href="../../../help-doc.html">Help</a></li>
48</ul>
49</div>
50<div class="subNav">
51<ul class="navList">
52<li><a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
53<li><a href="../../../genius/core/utility/AdditiveUtilitySpaceWithPerturbation.html" title="class in genius.core.utility"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
54</ul>
55<ul class="navList">
56<li><a href="../../../index.html?genius/core/utility/AdditiveUtilitySpace.html" target="_top">Frames</a></li>
57<li><a href="AdditiveUtilitySpace.html" target="_top">No&nbsp;Frames</a></li>
58</ul>
59<ul class="navList" id="allclasses_navbar_top">
60<li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
61</ul>
62<div>
63<script type="text/javascript"><!--
64 allClassesLink = document.getElementById("allclasses_navbar_top");
65 if(window==top) {
66 allClassesLink.style.display = "block";
67 }
68 else {
69 allClassesLink.style.display = "none";
70 }
71 //-->
72</script>
73</div>
74<div>
75<ul class="subNavList">
76<li>Summary:&nbsp;</li>
77<li>Nested&nbsp;|&nbsp;</li>
78<li><a href="#fields.inherited.from.class.genius.core.utility.AbstractUtilitySpace">Field</a>&nbsp;|&nbsp;</li>
79<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
80<li><a href="#method.summary">Method</a></li>
81</ul>
82<ul class="subNavList">
83<li>Detail:&nbsp;</li>
84<li>Field&nbsp;|&nbsp;</li>
85<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
86<li><a href="#method.detail">Method</a></li>
87</ul>
88</div>
89<a name="skip.navbar.top">
90<!-- -->
91</a></div>
92<!-- ========= END OF TOP NAVBAR ========= -->
93<!-- ======== START OF CLASS DATA ======== -->
94<div class="header">
95<div class="subTitle">genius.core.utility</div>
96<h2 title="Class AdditiveUtilitySpace" class="title">Class AdditiveUtilitySpace</h2>
97</div>
98<div class="contentContainer">
99<ul class="inheritance">
100<li>java.lang.Object</li>
101<li>
102<ul class="inheritance">
103<li><a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">genius.core.utility.AbstractUtilitySpace</a></li>
104<li>
105<ul class="inheritance">
106<li>genius.core.utility.AdditiveUtilitySpace</li>
107</ul>
108</li>
109</ul>
110</li>
111</ul>
112<div class="description">
113<ul class="blockList">
114<li class="blockList">
115<dl>
116<dt>All Implemented Interfaces:</dt>
117<dd><a href="../../../genius/core/utility/UtilitySpace.html" title="interface in genius.core.utility">UtilitySpace</a>, java.io.Serializable</dd>
118</dl>
119<dl>
120<dt>Direct Known Subclasses:</dt>
121<dd><a href="../../../genius/core/utility/AdditiveUtilitySpaceWithPerturbation.html" title="class in genius.core.utility">AdditiveUtilitySpaceWithPerturbation</a></dd>
122</dl>
123<hr>
124<br>
125<pre>public class <span class="typeNameLabel">AdditiveUtilitySpace</span>
126extends <a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a></pre>
127<div class="block">The additive utility space couples all objectives to weights and evaluators.</div>
128<dl>
129<dt><span class="simpleTagLabel">Author:</span></dt>
130<dd>D. Tykhonov, K. Hindriks, W. Pasman</dd>
131<dt><span class="seeLabel">See Also:</span></dt>
132<dd><a href="../../../serialized-form.html#genius.core.utility.AdditiveUtilitySpace">Serialized Form</a></dd>
133</dl>
134</li>
135</ul>
136</div>
137<div class="summary">
138<ul class="blockList">
139<li class="blockList">
140<!-- =========== FIELD SUMMARY =========== -->
141<ul class="blockList">
142<li class="blockList"><a name="field.summary">
143<!-- -->
144</a>
145<h3>Field Summary</h3>
146<ul class="blockList">
147<li class="blockList"><a name="fields.inherited.from.class.genius.core.utility.AbstractUtilitySpace">
148<!-- -->
149</a>
150<h3>Fields inherited from class&nbsp;genius.core.utility.<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a></h3>
151<code><a href="../../../genius/core/utility/AbstractUtilitySpace.html#DISCOUNT_FACTOR">DISCOUNT_FACTOR</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#fileName">fileName</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#RESERVATION">RESERVATION</a></code></li>
152</ul>
153</li>
154</ul>
155<!-- ======== CONSTRUCTOR SUMMARY ======== -->
156<ul class="blockList">
157<li class="blockList"><a name="constructor.summary">
158<!-- -->
159</a>
160<h3>Constructor Summary</h3>
161<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
162<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
163<tr>
164<th class="colOne" scope="col">Constructor and Description</th>
165</tr>
166<tr class="altColor">
167<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#AdditiveUtilitySpace--">AdditiveUtilitySpace</a></span>()</code>
168<div class="block">Creates an empty utility space.</div>
169</td>
170</tr>
171<tr class="rowColor">
172<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#AdditiveUtilitySpace-genius.core.utility.AdditiveUtilitySpace-">AdditiveUtilitySpace</a></span>(<a href="../../../genius/core/utility/AdditiveUtilitySpace.html" title="class in genius.core.utility">AdditiveUtilitySpace</a>&nbsp;us)</code>
173<div class="block">Copies the data from another UtilitySpace.</div>
174</td>
175</tr>
176<tr class="altColor">
177<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#AdditiveUtilitySpace-genius.core.Domain-">AdditiveUtilitySpace</a></span>(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain)</code>
178<div class="block">Creates a new utilityspace of the given domain.</div>
179</td>
180</tr>
181<tr class="rowColor">
182<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#AdditiveUtilitySpace-genius.core.Domain-java.util.Map-">AdditiveUtilitySpace</a></span>(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain,
183 java.util.Map&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&nbsp;fEvaluators)</code>&nbsp;</td>
184</tr>
185<tr class="altColor">
186<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#AdditiveUtilitySpace-genius.core.Domain-java.lang.String-">AdditiveUtilitySpace</a></span>(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain,
187 java.lang.String&nbsp;fileName)</code>
188<div class="block">Create new default util space for a given domain.</div>
189</td>
190</tr>
191</table>
192</li>
193</ul>
194<!-- ========== METHOD SUMMARY =========== -->
195<ul class="blockList">
196<li class="blockList"><a name="method.summary">
197<!-- -->
198</a>
199<h3>Method Summary</h3>
200<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
201<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
202<tr>
203<th class="colFirst" scope="col">Modifier and Type</th>
204<th class="colLast" scope="col">Method and Description</th>
205</tr>
206<tr id="i0" class="altColor">
207<td class="colFirst"><code><a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a></code></td>
208<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#addEvaluator-genius.core.issue.Objective-genius.core.utility.Evaluator-">addEvaluator</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj,
209 <a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&nbsp;ev)</code>
210<div class="block">Sets an [Objective, evaluator] pair.</div>
211</td>
212</tr>
213<tr id="i1" class="rowColor">
214<td class="colFirst"><code><a href="../../../genius/core/utility/UtilitySpace.html" title="interface in genius.core.utility">UtilitySpace</a></code></td>
215<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#copy--">copy</a></span>()</code>&nbsp;</td>
216</tr>
217<tr id="i2" class="altColor">
218<td class="colFirst"><code>boolean</code></td>
219<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#equals-java.lang.Object-">equals</a></span>(java.lang.Object&nbsp;obj)</code>&nbsp;</td>
220</tr>
221<tr id="i3" class="rowColor">
222<td class="colFirst"><code>double</code></td>
223<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getEvaluation-int-genius.core.Bid-">getEvaluation</a></span>(int&nbsp;pIssueIndex,
224 <a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&nbsp;bid)</code>
225<div class="block">Returns the utility of one issue in the bid.</div>
226</td>
227</tr>
228<tr id="i4" class="altColor">
229<td class="colFirst"><code><a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a></code></td>
230<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getEvaluator-int-">getEvaluator</a></span>(int&nbsp;index)</code>
231<div class="block">Returns the evaluator of an issue for the given index.</div>
232</td>
233</tr>
234<tr id="i5" class="rowColor">
235<td class="colFirst"><code><a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a></code></td>
236<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getEvaluator-genius.core.issue.Objective-">getEvaluator</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</code>&nbsp;</td>
237</tr>
238<tr id="i6" class="altColor">
239<td class="colFirst"><code>java.util.Set&lt;java.util.Map.Entry&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&gt;</code></td>
240<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getEvaluators--">getEvaluators</a></span>()</code>&nbsp;</td>
241</tr>
242<tr id="i7" class="rowColor">
243<td class="colFirst"><code><a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a></code></td>
244<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getIssue-int-">getIssue</a></span>(int&nbsp;index)</code>
245<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
246<div class="block"><span class="deprecationComment">Use getObjective</span></div>
247</div>
248</td>
249</tr>
250<tr id="i8" class="altColor">
251<td class="colFirst"><code>int</code></td>
252<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getNrOfEvaluators--">getNrOfEvaluators</a></span>()</code>&nbsp;</td>
253</tr>
254<tr id="i9" class="rowColor">
255<td class="colFirst"><code>double</code></td>
256<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getUtility-genius.core.Bid-">getUtility</a></span>(<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&nbsp;bid)</code>
257<div class="block">implements UtilitySpace</div>
258</td>
259</tr>
260<tr id="i10" class="altColor">
261<td class="colFirst"><code>double</code></td>
262<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#getWeight-int-">getWeight</a></span>(int&nbsp;issueID)</code>&nbsp;</td>
263</tr>
264<tr id="i11" class="rowColor">
265<td class="colFirst"><code>java.lang.String</code></td>
266<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#isComplete--">isComplete</a></span>()</code>
267<div class="block">Check if this utility space is complete and ready for negotiation.</div>
268</td>
269</tr>
270<tr id="i12" class="altColor">
271<td class="colFirst"><code>boolean</code></td>
272<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#lock-genius.core.issue.Objective-">lock</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</code>
273<div class="block">Place a lock on the weight of an objective or issue.</div>
274</td>
275</tr>
276<tr id="i13" class="rowColor">
277<td class="colFirst"><code>java.util.Set&lt;java.util.Map.Entry&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&gt;</code></td>
278<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#normalizeChildren-genius.core.issue.Objective-">normalizeChildren</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</code>
279<div class="block">Normalizes the weights of objectives of the given objective so that they
280 sum up to one.</div>
281</td>
282</tr>
283<tr id="i14" class="altColor">
284<td class="colFirst"><code>double</code></td>
285<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#setWeight-genius.core.issue.Objective-double-">setWeight</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;objective,
286 double&nbsp;weight)</code>
287<div class="block">Method used to set the weight of the given objective.</div>
288</td>
289</tr>
290<tr id="i15" class="rowColor">
291<td class="colFirst"><code>java.lang.String</code></td>
292<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#toString--">toString</a></span>()</code>&nbsp;</td>
293</tr>
294<tr id="i16" class="altColor">
295<td class="colFirst"><code><a href="../../../genius/core/xml/SimpleElement.html" title="class in genius.core.xml">SimpleElement</a></code></td>
296<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#toXML--">toXML</a></span>()</code>
297<div class="block">Creates an xml representation (in the form of a SimpleElements) of the
298 utilityspace.</div>
299</td>
300</tr>
301<tr id="i17" class="rowColor">
302<td class="colFirst"><code>boolean</code></td>
303<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/utility/AdditiveUtilitySpace.html#unlock-genius.core.issue.Objective-">unlock</a></span>(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</code>
304<div class="block">Clear a lock on the weight of an objective or issue.</div>
305</td>
306</tr>
307</table>
308<ul class="blockList">
309<li class="blockList"><a name="methods.inherited.from.class.genius.core.utility.AbstractUtilitySpace">
310<!-- -->
311</a>
312<h3>Methods inherited from class&nbsp;genius.core.utility.<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a></h3>
313<code><a href="../../../genius/core/utility/AbstractUtilitySpace.html#checkReadyForNegotiation-genius.core.Domain-">checkReadyForNegotiation</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#discount-double-double-">discount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getDiscountFactor--">getDiscountFactor</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getDomain--">getDomain</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getFileName--">getFileName</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getMaxUtilityBid--">getMaxUtilityBid</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getMinUtilityBid--">getMinUtilityBid</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getName--">getName</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getReservationValue--">getReservationValue</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getReservationValueUndiscounted--">getReservationValueUndiscounted</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getReservationValueWithDiscount-double-">getReservationValueWithDiscount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getReservationValueWithDiscount-genius.core.timeline.TimeLineInfo-">getReservationValueWithDiscount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getUtilityWithDiscount-genius.core.Bid-double-">getUtilityWithDiscount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#getUtilityWithDiscount-genius.core.Bid-genius.core.timeline.TimeLineInfo-">getUtilityWithDiscount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#isDiscounted--">isDiscounted</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#setDiscount-double-">setDiscount</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#setReservationValue-double-">setReservationValue</a>, <a href="../../../genius/core/utility/AbstractUtilitySpace.html#validateDiscount-double-">validateDiscount</a></code></li>
314</ul>
315<ul class="blockList">
316<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
317<!-- -->
318</a>
319<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
320<code>clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait</code></li>
321</ul>
322</li>
323</ul>
324</li>
325</ul>
326</div>
327<div class="details">
328<ul class="blockList">
329<li class="blockList">
330<!-- ========= CONSTRUCTOR DETAIL ======== -->
331<ul class="blockList">
332<li class="blockList"><a name="constructor.detail">
333<!-- -->
334</a>
335<h3>Constructor Detail</h3>
336<a name="AdditiveUtilitySpace--">
337<!-- -->
338</a>
339<ul class="blockList">
340<li class="blockList">
341<h4>AdditiveUtilitySpace</h4>
342<pre>public&nbsp;AdditiveUtilitySpace()</pre>
343<div class="block">Creates an empty utility space.</div>
344</li>
345</ul>
346<a name="AdditiveUtilitySpace-genius.core.Domain-">
347<!-- -->
348</a>
349<ul class="blockList">
350<li class="blockList">
351<h4>AdditiveUtilitySpace</h4>
352<pre>public&nbsp;AdditiveUtilitySpace(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain)</pre>
353<div class="block">Creates a new utilityspace of the given domain.</div>
354<dl>
355<dt><span class="paramLabel">Parameters:</span></dt>
356<dd><code>domain</code> - for which the utilityspace should be specified.</dd>
357</dl>
358</li>
359</ul>
360<a name="AdditiveUtilitySpace-genius.core.Domain-java.util.Map-">
361<!-- -->
362</a>
363<ul class="blockList">
364<li class="blockList">
365<h4>AdditiveUtilitySpace</h4>
366<pre>public&nbsp;AdditiveUtilitySpace(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain,
367 java.util.Map&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&nbsp;fEvaluators)</pre>
368</li>
369</ul>
370<a name="AdditiveUtilitySpace-genius.core.Domain-java.lang.String-">
371<!-- -->
372</a>
373<ul class="blockList">
374<li class="blockList">
375<h4>AdditiveUtilitySpace</h4>
376<pre>public&nbsp;AdditiveUtilitySpace(<a href="../../../genius/core/Domain.html" title="interface in genius.core">Domain</a>&nbsp;domain,
377 java.lang.String&nbsp;fileName)
378 throws java.io.IOException</pre>
379<div class="block">Create new default util space for a given domain.</div>
380<dl>
381<dt><span class="paramLabel">Parameters:</span></dt>
382<dd><code>domain</code> - </dd>
383<dd><code>fileName</code> - to read domain from. Set fileName to "" if no file available,
384 in which case default evaluators are loaded..</dd>
385<dt><span class="throwsLabel">Throws:</span></dt>
386<dd><code>java.io.IOException</code> - if error occurs, e.g. if domain does not match the util
387 space, or file not found.</dd>
388</dl>
389</li>
390</ul>
391<a name="AdditiveUtilitySpace-genius.core.utility.AdditiveUtilitySpace-">
392<!-- -->
393</a>
394<ul class="blockListLast">
395<li class="blockList">
396<h4>AdditiveUtilitySpace</h4>
397<pre>public&nbsp;AdditiveUtilitySpace(<a href="../../../genius/core/utility/AdditiveUtilitySpace.html" title="class in genius.core.utility">AdditiveUtilitySpace</a>&nbsp;us)</pre>
398<div class="block">Copies the data from another UtilitySpace.</div>
399<dl>
400<dt><span class="paramLabel">Parameters:</span></dt>
401<dd><code>us</code> - utility space to be cloned.</dd>
402</dl>
403</li>
404</ul>
405</li>
406</ul>
407<!-- ============ METHOD DETAIL ========== -->
408<ul class="blockList">
409<li class="blockList"><a name="method.detail">
410<!-- -->
411</a>
412<h3>Method Detail</h3>
413<a name="getUtility-genius.core.Bid-">
414<!-- -->
415</a>
416<ul class="blockList">
417<li class="blockList">
418<h4>getUtility</h4>
419<pre>public&nbsp;double&nbsp;getUtility(<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&nbsp;bid)</pre>
420<div class="block">implements UtilitySpace</div>
421<dl>
422<dt><span class="paramLabel">Parameters:</span></dt>
423<dd><code>bid</code> - of which we are interested in its utility.</dd>
424<dt><span class="returnLabel">Returns:</span></dt>
425<dd>Utility of the given bid. This utility is undiscounted: there is
426 no time dependent devaluation of the utility. See also
427 <a href="../../../genius/core/utility/UtilitySpace.html#discount-double-double-"><code>UtilitySpace.discount(double, double)</code></a>.</dd>
428</dl>
429</li>
430</ul>
431<a name="toXML--">
432<!-- -->
433</a>
434<ul class="blockList">
435<li class="blockList">
436<h4>toXML</h4>
437<pre>public&nbsp;<a href="../../../genius/core/xml/SimpleElement.html" title="class in genius.core.xml">SimpleElement</a>&nbsp;toXML()
438 throws java.io.IOException</pre>
439<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../genius/core/utility/UtilitySpace.html#toXML--">UtilitySpace</a></code></span></div>
440<div class="block">Creates an xml representation (in the form of a SimpleElements) of the
441 utilityspace.</div>
442<dl>
443<dt><span class="returnLabel">Returns:</span></dt>
444<dd>A representation of this utilityspace or <code>null</code> when
445 there was an error.</dd>
446<dt><span class="throwsLabel">Throws:</span></dt>
447<dd><code>java.io.IOException</code></dd>
448</dl>
449</li>
450</ul>
451<a name="isComplete--">
452<!-- -->
453</a>
454<ul class="blockList">
455<li class="blockList">
456<h4>isComplete</h4>
457<pre>public&nbsp;java.lang.String&nbsp;isComplete()</pre>
458<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../genius/core/utility/UtilitySpace.html#isComplete--">UtilitySpace</a></code></span></div>
459<div class="block">Check if this utility space is complete and ready for negotiation.</div>
460<dl>
461<dt><span class="returnLabel">Returns:</span></dt>
462<dd>null if util space is complete, else returns String containing
463 explanation why not.</dd>
464</dl>
465</li>
466</ul>
467<a name="toString--">
468<!-- -->
469</a>
470<ul class="blockList">
471<li class="blockList">
472<h4>toString</h4>
473<pre>public&nbsp;java.lang.String&nbsp;toString()</pre>
474<dl>
475<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
476<dd><code>toString</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
477</dl>
478</li>
479</ul>
480<a name="equals-java.lang.Object-">
481<!-- -->
482</a>
483<ul class="blockList">
484<li class="blockList">
485<h4>equals</h4>
486<pre>public&nbsp;boolean&nbsp;equals(java.lang.Object&nbsp;obj)</pre>
487<dl>
488<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
489<dd><code>equals</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
490</dl>
491</li>
492</ul>
493<a name="copy--">
494<!-- -->
495</a>
496<ul class="blockList">
497<li class="blockList">
498<h4>copy</h4>
499<pre>public&nbsp;<a href="../../../genius/core/utility/UtilitySpace.html" title="interface in genius.core.utility">UtilitySpace</a>&nbsp;copy()</pre>
500<dl>
501<dt><span class="returnLabel">Returns:</span></dt>
502<dd>a deep copy of this utility space.</dd>
503</dl>
504</li>
505</ul>
506<a name="getNrOfEvaluators--">
507<!-- -->
508</a>
509<ul class="blockList">
510<li class="blockList">
511<h4>getNrOfEvaluators</h4>
512<pre>public final&nbsp;int&nbsp;getNrOfEvaluators()</pre>
513<dl>
514<dt><span class="returnLabel">Returns:</span></dt>
515<dd>number of issues. This can only be used for linear utility
516 functions.</dd>
517</dl>
518</li>
519</ul>
520<a name="getEvaluator-int-">
521<!-- -->
522</a>
523<ul class="blockList">
524<li class="blockList">
525<h4>getEvaluator</h4>
526<pre>public&nbsp;<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&nbsp;getEvaluator(int&nbsp;index)</pre>
527<div class="block">Returns the evaluator of an issue for the given index. This can only be
528 used for linear utility functions.</div>
529<dl>
530<dt><span class="paramLabel">Parameters:</span></dt>
531<dd><code>index</code> - The IDnumber of the Objective or Issue</dd>
532<dt><span class="returnLabel">Returns:</span></dt>
533<dd>An Evaluator for the Objective or Issue.</dd>
534</dl>
535</li>
536</ul>
537<a name="getEvaluator-genius.core.issue.Objective-">
538<!-- -->
539</a>
540<ul class="blockList">
541<li class="blockList">
542<h4>getEvaluator</h4>
543<pre>public&nbsp;<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&nbsp;getEvaluator(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</pre>
544<dl>
545<dt><span class="paramLabel">Parameters:</span></dt>
546<dd><code>obj</code> - the objective for which an evaluator is needed</dd>
547<dt><span class="returnLabel">Returns:</span></dt>
548<dd>evaluator for given objective, or null if no such objective.</dd>
549</dl>
550</li>
551</ul>
552<a name="getEvaluation-int-genius.core.Bid-">
553<!-- -->
554</a>
555<ul class="blockList">
556<li class="blockList">
557<h4>getEvaluation</h4>
558<pre>public final&nbsp;double&nbsp;getEvaluation(int&nbsp;pIssueIndex,
559 <a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&nbsp;bid)</pre>
560<div class="block">Returns the utility of one issue in the bid. Note that this value is in
561 the range [0,1] as it is not normalized by the issue weight. Only works
562 with linear utility spaces.</div>
563<dl>
564<dt><span class="paramLabel">Parameters:</span></dt>
565<dd><code>pIssueIndex</code> - of the issue.</dd>
566<dd><code>bid</code> - </dd>
567<dt><span class="returnLabel">Returns:</span></dt>
568<dd>evaluation of the value of the issue of the given bid.</dd>
569</dl>
570</li>
571</ul>
572<a name="getWeight-int-">
573<!-- -->
574</a>
575<ul class="blockList">
576<li class="blockList">
577<h4>getWeight</h4>
578<pre>public&nbsp;double&nbsp;getWeight(int&nbsp;issueID)</pre>
579<dl>
580<dt><span class="paramLabel">Parameters:</span></dt>
581<dd><code>issueID</code> - The Issue or Objective to get the weight from</dd>
582<dt><span class="returnLabel">Returns:</span></dt>
583<dd>The weight, or 0 if the objective doesn't exist. Only works with
584 linear utility spaces.</dd>
585</dl>
586</li>
587</ul>
588<a name="setWeight-genius.core.issue.Objective-double-">
589<!-- -->
590</a>
591<ul class="blockList">
592<li class="blockList">
593<h4>setWeight</h4>
594<pre>public&nbsp;double&nbsp;setWeight(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;objective,
595 double&nbsp;weight)</pre>
596<div class="block">Method used to set the weight of the given objective. Only works with
597 linear utility spaces.</div>
598<dl>
599<dt><span class="paramLabel">Parameters:</span></dt>
600<dd><code>objective</code> - of which the weights must be set.</dd>
601<dd><code>weight</code> - to which the weight of the objective must be set.</dd>
602<dt><span class="returnLabel">Returns:</span></dt>
603<dd>the new weight of the issue after normalization.</dd>
604</dl>
605</li>
606</ul>
607<a name="getIssue-int-">
608<!-- -->
609</a>
610<ul class="blockList">
611<li class="blockList">
612<h4>getIssue</h4>
613<pre>@Deprecated
614public final&nbsp;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;getIssue(int&nbsp;index)</pre>
615<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">Use getObjective</span></div>
616<dl>
617<dt><span class="paramLabel">Parameters:</span></dt>
618<dd><code>index</code> - The index of the issue to</dd>
619<dt><span class="returnLabel">Returns:</span></dt>
620<dd>the indexed objective or issue</dd>
621</dl>
622</li>
623</ul>
624<a name="addEvaluator-genius.core.issue.Objective-genius.core.utility.Evaluator-">
625<!-- -->
626</a>
627<ul class="blockList">
628<li class="blockList">
629<h4>addEvaluator</h4>
630<pre>public final&nbsp;<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&nbsp;addEvaluator(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj,
631 <a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&nbsp;ev)</pre>
632<div class="block">Sets an [Objective, evaluator] pair. Replaces old evaluator for
633 objective. Only works with linear utility spaces.</div>
634<dl>
635<dt><span class="paramLabel">Parameters:</span></dt>
636<dd><code>obj</code> - The Objective to attach an Evaluator to.</dd>
637<dd><code>ev</code> - The Evaluator to attach.</dd>
638<dt><span class="returnLabel">Returns:</span></dt>
639<dd>The given evaluator.</dd>
640</dl>
641</li>
642</ul>
643<a name="getEvaluators--">
644<!-- -->
645</a>
646<ul class="blockList">
647<li class="blockList">
648<h4>getEvaluators</h4>
649<pre>public final&nbsp;java.util.Set&lt;java.util.Map.Entry&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&gt;&nbsp;getEvaluators()</pre>
650<dl>
651<dt><span class="returnLabel">Returns:</span></dt>
652<dd>The set with all pairs of evaluators and objectives in this
653 utility space. Only works with linear utility spaces.</dd>
654</dl>
655</li>
656</ul>
657<a name="lock-genius.core.issue.Objective-">
658<!-- -->
659</a>
660<ul class="blockList">
661<li class="blockList">
662<h4>lock</h4>
663<pre>public final&nbsp;boolean&nbsp;lock(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</pre>
664<div class="block">Place a lock on the weight of an objective or issue. Only works with
665 linear utility spaces.</div>
666<dl>
667<dt><span class="paramLabel">Parameters:</span></dt>
668<dd><code>obj</code> - The objective or issue that is about to have it's weight
669 locked.</dd>
670<dt><span class="returnLabel">Returns:</span></dt>
671<dd><code>true</code> if successful, <code>false</code> If the
672 objective doesn't have an evaluator yet.</dd>
673</dl>
674</li>
675</ul>
676<a name="unlock-genius.core.issue.Objective-">
677<!-- -->
678</a>
679<ul class="blockList">
680<li class="blockList">
681<h4>unlock</h4>
682<pre>public final&nbsp;boolean&nbsp;unlock(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</pre>
683<div class="block">Clear a lock on the weight of an objective or issue. Only works with
684 linear utility spaces.</div>
685<dl>
686<dt><span class="paramLabel">Parameters:</span></dt>
687<dd><code>obj</code> - The objective or issue that is having it's lock cleared.</dd>
688<dt><span class="returnLabel">Returns:</span></dt>
689<dd><code>true</code> If the lock is cleared, <code>false</code> if
690 the objective or issue doesn't have an evaluator yet.</dd>
691</dl>
692</li>
693</ul>
694<a name="normalizeChildren-genius.core.issue.Objective-">
695<!-- -->
696</a>
697<ul class="blockListLast">
698<li class="blockList">
699<h4>normalizeChildren</h4>
700<pre>public final&nbsp;java.util.Set&lt;java.util.Map.Entry&lt;<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>,<a href="../../../genius/core/utility/Evaluator.html" title="interface in genius.core.utility">Evaluator</a>&gt;&gt;&nbsp;normalizeChildren(<a href="../../../genius/core/issue/Objective.html" title="class in genius.core.issue">Objective</a>&nbsp;obj)</pre>
701<div class="block">Normalizes the weights of objectives of the given objective so that they
702 sum up to one. Only works with linear utility spaces.</div>
703<dl>
704<dt><span class="paramLabel">Parameters:</span></dt>
705<dd><code>obj</code> - of which the weights must be normalized.</dd>
706<dt><span class="returnLabel">Returns:</span></dt>
707<dd>all evaluators using getEvaluators().</dd>
708</dl>
709</li>
710</ul>
711</li>
712</ul>
713</li>
714</ul>
715</div>
716</div>
717<!-- ========= END OF CLASS DATA ========= -->
718<!-- ======= START OF BOTTOM NAVBAR ====== -->
719<div class="bottomNav"><a name="navbar.bottom">
720<!-- -->
721</a>
722<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
723<a name="navbar.bottom.firstrow">
724<!-- -->
725</a>
726<ul class="navList" title="Navigation">
727<li><a href="../../../overview-summary.html">Overview</a></li>
728<li><a href="package-summary.html">Package</a></li>
729<li class="navBarCell1Rev">Class</li>
730<li><a href="class-use/AdditiveUtilitySpace.html">Use</a></li>
731<li><a href="package-tree.html">Tree</a></li>
732<li><a href="../../../deprecated-list.html">Deprecated</a></li>
733<li><a href="../../../index-all.html">Index</a></li>
734<li><a href="../../../help-doc.html">Help</a></li>
735</ul>
736</div>
737<div class="subNav">
738<ul class="navList">
739<li><a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
740<li><a href="../../../genius/core/utility/AdditiveUtilitySpaceWithPerturbation.html" title="class in genius.core.utility"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
741</ul>
742<ul class="navList">
743<li><a href="../../../index.html?genius/core/utility/AdditiveUtilitySpace.html" target="_top">Frames</a></li>
744<li><a href="AdditiveUtilitySpace.html" target="_top">No&nbsp;Frames</a></li>
745</ul>
746<ul class="navList" id="allclasses_navbar_bottom">
747<li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
748</ul>
749<div>
750<script type="text/javascript"><!--
751 allClassesLink = document.getElementById("allclasses_navbar_bottom");
752 if(window==top) {
753 allClassesLink.style.display = "block";
754 }
755 else {
756 allClassesLink.style.display = "none";
757 }
758 //-->
759</script>
760</div>
761<div>
762<ul class="subNavList">
763<li>Summary:&nbsp;</li>
764<li>Nested&nbsp;|&nbsp;</li>
765<li><a href="#fields.inherited.from.class.genius.core.utility.AbstractUtilitySpace">Field</a>&nbsp;|&nbsp;</li>
766<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
767<li><a href="#method.summary">Method</a></li>
768</ul>
769<ul class="subNavList">
770<li>Detail:&nbsp;</li>
771<li>Field&nbsp;|&nbsp;</li>
772<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
773<li><a href="#method.detail">Method</a></li>
774</ul>
775</div>
776<a name="skip.navbar.bottom">
777<!-- -->
778</a></div>
779<!-- ======== END OF BOTTOM NAVBAR ======= -->
780</body>
781</html>
Note: See TracBrowser for help on using the repository browser.