source: javadoc/genius/core/analysis/BidSpace.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: 25.7 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:56 CEST 2018 -->
6<title>BidSpace (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="BidSpace (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":10};
22var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete 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/BidSpace.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/analysis/BidPointTime.html" title="class in genius.core.analysis"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
53<li><a href="../../../genius/core/analysis/BidSpaceCache.html" title="class in genius.core.analysis"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
54</ul>
55<ul class="navList">
56<li><a href="../../../index.html?genius/core/analysis/BidSpace.html" target="_top">Frames</a></li>
57<li><a href="BidSpace.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="#field.summary">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><a href="#field.detail">Field</a>&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.analysis</div>
96<h2 title="Class BidSpace" class="title">Class BidSpace</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>genius.core.analysis.BidSpace</li>
104</ul>
105</li>
106</ul>
107<div class="description">
108<ul class="blockList">
109<li class="blockList">
110<hr>
111<br>
112<pre>public class <span class="typeNameLabel">BidSpace</span>
113extends java.lang.Object</pre>
114<div class="block">A collection of utilityspaces can be viewed as a space in which a bid is
115 assigned multiple point corresponding to the utility of the bid for different
116 agents. We refer to this space as a BidSpace. This class allows to calculate
117 the properties of this space.</div>
118<dl>
119<dt><span class="simpleTagLabel">Author:</span></dt>
120<dd>Dmytro Tykhonov, Tim Baarslag, Wouter Pasman</dd>
121</dl>
122</li>
123</ul>
124</div>
125<div class="summary">
126<ul class="blockList">
127<li class="blockList">
128<!-- =========== FIELD SUMMARY =========== -->
129<ul class="blockList">
130<li class="blockList"><a name="field.summary">
131<!-- -->
132</a>
133<h3>Field Summary</h3>
134<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
135<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
136<tr>
137<th class="colFirst" scope="col">Modifier and Type</th>
138<th class="colLast" scope="col">Field and Description</th>
139</tr>
140<tr class="altColor">
141<td class="colFirst"><code>java.util.ArrayList&lt;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&gt;</code></td>
142<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#bidPoints">bidPoints</a></span></code>
143<div class="block">List of all bidpoints in the domain.</div>
144</td>
145</tr>
146</table>
147</li>
148</ul>
149<!-- ======== CONSTRUCTOR SUMMARY ======== -->
150<ul class="blockList">
151<li class="blockList"><a name="constructor.summary">
152<!-- -->
153</a>
154<h3>Constructor Summary</h3>
155<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
156<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
157<tr>
158<th class="colOne" scope="col">Constructor and Description</th>
159</tr>
160<tr class="altColor">
161<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#BidSpace-genius.core.utility.AbstractUtilitySpace...-">BidSpace</a></span>(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>...&nbsp;utilityspaces)</code>
162<div class="block">Default constructor used to construct a multidimensional bidding space.</div>
163</td>
164</tr>
165<tr class="rowColor">
166<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#BidSpace-genius.core.utility.AbstractUtilitySpace-genius.core.utility.AbstractUtilitySpace-boolean-">BidSpace</a></span>(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceA,
167 <a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceB,
168 boolean&nbsp;excludeBids)</code>
169<div class="block">Constructor to createFrom a BidSpace given exactly two utility spaces.</div>
170</td>
171</tr>
172<tr class="altColor">
173<td class="colOne"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#BidSpace-genius.core.utility.AbstractUtilitySpace-genius.core.utility.AbstractUtilitySpace-boolean-boolean-">BidSpace</a></span>(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceA,
174 <a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceB,
175 boolean&nbsp;excludeBids,
176 boolean&nbsp;skipCheckSpaceB)</code>
177<div class="block">Constructor which is identical to its three parameter version, except for
178 the argument skipCheckSpaceB.</div>
179</td>
180</tr>
181</table>
182</li>
183</ul>
184<!-- ========== METHOD SUMMARY =========== -->
185<ul class="blockList">
186<li class="blockList"><a name="method.summary">
187<!-- -->
188</a>
189<h3>Method Summary</h3>
190<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
191<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></caption>
192<tr>
193<th class="colFirst" scope="col">Modifier and Type</th>
194<th class="colLast" scope="col">Method and Description</th>
195</tr>
196<tr id="i0" class="altColor">
197<td class="colFirst"><code>double</code></td>
198<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#distanceToNearestParetoBid-genius.core.analysis.BidPoint-">distanceToNearestParetoBid</a></span>(<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&nbsp;bid)</code>
199<div class="block">Method which given a bid point determines the distance to the nearest
200 Pareto-optimal bid.</div>
201</td>
202</tr>
203<tr id="i1" class="rowColor">
204<td class="colFirst"><code><a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a></code></td>
205<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#getKalaiSmorodinsky--">getKalaiSmorodinsky</a></span>()</code>
206<div class="block">Calculates Kalai-Smorodinsky optimal outcome.</div>
207</td>
208</tr>
209<tr id="i2" class="altColor">
210<td class="colFirst"><code><a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a></code></td>
211<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#getNash--">getNash</a></span>()</code>
212<div class="block">Calculates the undiscounted Nash optimal outcome.</div>
213</td>
214</tr>
215<tr id="i3" class="rowColor">
216<td class="colFirst"><code><a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a></code></td>
217<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#getNearestBidPoint-double-double-double-double-java.util.ArrayList-">getNearestBidPoint</a></span>(double&nbsp;utilA,
218 double&nbsp;utilB,
219 double&nbsp;weightA,
220 double&nbsp;weightB,
221 java.util.ArrayList&lt;<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&gt;&nbsp;excludeList)</code>
222<div class="block">Finds the bid with the minimal distance
223 weightA*DeltaUtilA^2+weightB*DeltaUtilB^2 where DeltaUtilA is the
224 difference between given utilA and the actual utility of the bid.</div>
225</td>
226</tr>
227<tr id="i4" class="altColor">
228<td class="colFirst"><code>java.util.List&lt;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&gt;</code></td>
229<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#getParetoFrontier--">getParetoFrontier</a></span>()</code>
230<div class="block">Returns the Pareto fronier.</div>
231</td>
232</tr>
233<tr id="i5" class="rowColor">
234<td class="colFirst"><code>java.util.List&lt;<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&gt;</code></td>
235<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#getParetoFrontierBids--">getParetoFrontierBids</a></span>()</code>
236<div class="block">Method which returns a list of the Pareto efficient bids.</div>
237</td>
238</tr>
239<tr id="i6" class="altColor">
240<td class="colFirst"><code>double</code></td>
241<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#ourUtilityOnPareto-double-">ourUtilityOnPareto</a></span>(double&nbsp;opponentUtility)</code>
242<div class="block">Returns the nearest Pareto-optimal bid given the opponent's utility
243 (agent B).</div>
244</td>
245</tr>
246<tr id="i7" class="rowColor">
247<td class="colFirst"><code>java.lang.String</code></td>
248<td class="colLast"><code><span class="memberNameLink"><a href="../../../genius/core/analysis/BidSpace.html#toString--">toString</a></span>()</code>&nbsp;</td>
249</tr>
250</table>
251<ul class="blockList">
252<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
253<!-- -->
254</a>
255<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
256<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait</code></li>
257</ul>
258</li>
259</ul>
260</li>
261</ul>
262</div>
263<div class="details">
264<ul class="blockList">
265<li class="blockList">
266<!-- ============ FIELD DETAIL =========== -->
267<ul class="blockList">
268<li class="blockList"><a name="field.detail">
269<!-- -->
270</a>
271<h3>Field Detail</h3>
272<a name="bidPoints">
273<!-- -->
274</a>
275<ul class="blockListLast">
276<li class="blockList">
277<h4>bidPoints</h4>
278<pre>public&nbsp;java.util.ArrayList&lt;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&gt; bidPoints</pre>
279<div class="block">List of all bidpoints in the domain.</div>
280</li>
281</ul>
282</li>
283</ul>
284<!-- ========= CONSTRUCTOR DETAIL ======== -->
285<ul class="blockList">
286<li class="blockList"><a name="constructor.detail">
287<!-- -->
288</a>
289<h3>Constructor Detail</h3>
290<a name="BidSpace-genius.core.utility.AbstractUtilitySpace...-">
291<!-- -->
292</a>
293<ul class="blockList">
294<li class="blockList">
295<h4>BidSpace</h4>
296<pre>public&nbsp;BidSpace(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>...&nbsp;utilityspaces)
297 throws java.lang.Exception</pre>
298<div class="block">Default constructor used to construct a multidimensional bidding space.
299 Warning: this call iterates over ALL possible bids.</div>
300<dl>
301<dt><span class="paramLabel">Parameters:</span></dt>
302<dd><code>utilityspaces</code> - of which the bidding space consists.</dd>
303<dt><span class="throwsLabel">Throws:</span></dt>
304<dd><code>java.lang.Exception</code> - is thrown when one of the utility spaces is corrupt.</dd>
305</dl>
306</li>
307</ul>
308<a name="BidSpace-genius.core.utility.AbstractUtilitySpace-genius.core.utility.AbstractUtilitySpace-boolean-">
309<!-- -->
310</a>
311<ul class="blockList">
312<li class="blockList">
313<h4>BidSpace</h4>
314<pre>public&nbsp;BidSpace(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceA,
315 <a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceB,
316 boolean&nbsp;excludeBids)
317 throws java.lang.Exception</pre>
318<div class="block">Constructor to createFrom a BidSpace given exactly two utility spaces.
319 The main difference is that if excludeBids is true, then only the bid
320 points are saved. This has is a good way to save memory. Warning: this
321 call iterates over ALL possible bids.</div>
322<dl>
323<dt><span class="paramLabel">Parameters:</span></dt>
324<dd><code>utilityspaceA</code> - utilityspace of agent A.</dd>
325<dd><code>utilityspaceB</code> - utilityspace of agent B.</dd>
326<dd><code>excludeBids</code> - if the real bids should be saved or not.</dd>
327<dt><span class="throwsLabel">Throws:</span></dt>
328<dd><code>java.lang.Exception</code> - is thrown when one of the utility spaces is corrupt.</dd>
329</dl>
330</li>
331</ul>
332<a name="BidSpace-genius.core.utility.AbstractUtilitySpace-genius.core.utility.AbstractUtilitySpace-boolean-boolean-">
333<!-- -->
334</a>
335<ul class="blockListLast">
336<li class="blockList">
337<h4>BidSpace</h4>
338<pre>public&nbsp;BidSpace(<a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceA,
339 <a href="../../../genius/core/utility/AbstractUtilitySpace.html" title="class in genius.core.utility">AbstractUtilitySpace</a>&nbsp;utilityspaceB,
340 boolean&nbsp;excludeBids,
341 boolean&nbsp;skipCheckSpaceB)
342 throws java.lang.Exception</pre>
343<div class="block">Constructor which is identical to its three parameter version, except for
344 the argument skipCheckSpaceB. Independent of the value of this parameter,
345 this constructor skips the security checks for the second utilityspace.
346 This is interesting if you use the utility of an opponent model in which
347 some variables of the utilityspace may not be set. Warning: this call
348 iterates over ALL possible bids.</div>
349<dl>
350<dt><span class="paramLabel">Parameters:</span></dt>
351<dd><code>utilityspaceA</code> - utilityspace of agent A.</dd>
352<dd><code>utilityspaceB</code> - utilityspace of agent B.</dd>
353<dd><code>excludeBids</code> - if the real bids should be saved or not.</dd>
354<dd><code>skipCheckSpaceB</code> - skip security checks for the utilityspace of agent B.</dd>
355<dt><span class="throwsLabel">Throws:</span></dt>
356<dd><code>java.lang.Exception</code> - if something goes wrong when calculating the utility of a
357 bid.</dd>
358</dl>
359</li>
360</ul>
361</li>
362</ul>
363<!-- ============ METHOD DETAIL ========== -->
364<ul class="blockList">
365<li class="blockList"><a name="method.detail">
366<!-- -->
367</a>
368<h3>Method Detail</h3>
369<a name="getParetoFrontier--">
370<!-- -->
371</a>
372<ul class="blockList">
373<li class="blockList">
374<h4>getParetoFrontier</h4>
375<pre>public&nbsp;java.util.List&lt;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&gt;&nbsp;getParetoFrontier()
376 throws java.lang.Exception</pre>
377<div class="block">Returns the Pareto fronier. If the Pareto frontier is unknown, then it is
378 computed using an efficient algorithm. If the utilityspace contains more
379 than 500000 bids, then a suboptimal algorithm is used.</div>
380<dl>
381<dt><span class="returnLabel">Returns:</span></dt>
382<dd>The Pareto frontier. The order is ascending utilityA.</dd>
383<dt><span class="throwsLabel">Throws:</span></dt>
384<dd><code>java.lang.Exception</code> - if the utility of a bid can not be calculated.</dd>
385</dl>
386</li>
387</ul>
388<a name="getParetoFrontierBids--">
389<!-- -->
390</a>
391<ul class="blockList">
392<li class="blockList">
393<h4>getParetoFrontierBids</h4>
394<pre>public&nbsp;java.util.List&lt;<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&gt;&nbsp;getParetoFrontierBids()
395 throws java.lang.Exception</pre>
396<div class="block">Method which returns a list of the Pareto efficient bids.</div>
397<dl>
398<dt><span class="returnLabel">Returns:</span></dt>
399<dd>Pareto-efficient bids.</dd>
400<dt><span class="throwsLabel">Throws:</span></dt>
401<dd><code>java.lang.Exception</code> - if the utility of a bid cannot be calculated</dd>
402</dl>
403</li>
404</ul>
405<a name="getKalaiSmorodinsky--">
406<!-- -->
407</a>
408<ul class="blockList">
409<li class="blockList">
410<h4>getKalaiSmorodinsky</h4>
411<pre>public&nbsp;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&nbsp;getKalaiSmorodinsky()
412 throws java.lang.Exception</pre>
413<div class="block">Calculates Kalai-Smorodinsky optimal outcome. Assumes that Pareto
414 frontier is already built. Kalai-Smorodinsky is the point on
415 paretofrontier that has least difference in utilities for A and B.</div>
416<dl>
417<dt><span class="returnLabel">Returns:</span></dt>
418<dd>the Kalai-Smorodinsky BidPoint.</dd>
419<dt><span class="throwsLabel">Throws:</span></dt>
420<dd><code>java.lang.Exception</code> - when the Pareto frontier is invalid.</dd>
421</dl>
422</li>
423</ul>
424<a name="getNash--">
425<!-- -->
426</a>
427<ul class="blockList">
428<li class="blockList">
429<h4>getNash</h4>
430<pre>public&nbsp;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&nbsp;getNash()
431 throws java.lang.Exception</pre>
432<div class="block">Calculates the undiscounted Nash optimal outcome. Assumes that Pareto
433 frontier is already built. Nash is the point on paretofrontier that has
434 max product of utilities for A and B.</div>
435<dl>
436<dt><span class="returnLabel">Returns:</span></dt>
437<dd>the Nash BidPoint.</dd>
438<dt><span class="throwsLabel">Throws:</span></dt>
439<dd><code>java.lang.Exception</code> - when the Pareto frontier is invalid.</dd>
440</dl>
441</li>
442</ul>
443<a name="ourUtilityOnPareto-double-">
444<!-- -->
445</a>
446<ul class="blockList">
447<li class="blockList">
448<h4>ourUtilityOnPareto</h4>
449<pre>public&nbsp;double&nbsp;ourUtilityOnPareto(double&nbsp;opponentUtility)
450 throws java.lang.Exception</pre>
451<div class="block">Returns the nearest Pareto-optimal bid given the opponent's utility
452 (agent B).</div>
453<dl>
454<dt><span class="paramLabel">Parameters:</span></dt>
455<dd><code>opponentUtility</code> - the utility for the opponent.</dd>
456<dt><span class="returnLabel">Returns:</span></dt>
457<dd>the utility of us on the pareto curve.</dd>
458<dt><span class="throwsLabel">Throws:</span></dt>
459<dd><code>java.lang.Exception</code> - if getPareto fails or other cases, e.g. paretoFrontier
460 contains utilityB = NaN, which may occur if the opponent
461 model creating the utility space is corrupt.</dd>
462</dl>
463</li>
464</ul>
465<a name="toString--">
466<!-- -->
467</a>
468<ul class="blockList">
469<li class="blockList">
470<h4>toString</h4>
471<pre>public&nbsp;java.lang.String&nbsp;toString()</pre>
472<dl>
473<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
474<dd><code>toString</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
475<dt><span class="returnLabel">Returns:</span></dt>
476<dd>string representation of the BidSpace, which is basically a long
477 list of all bid its bid points.</dd>
478</dl>
479</li>
480</ul>
481<a name="getNearestBidPoint-double-double-double-double-java.util.ArrayList-">
482<!-- -->
483</a>
484<ul class="blockList">
485<li class="blockList">
486<h4>getNearestBidPoint</h4>
487<pre>public&nbsp;<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&nbsp;getNearestBidPoint(double&nbsp;utilA,
488 double&nbsp;utilB,
489 double&nbsp;weightA,
490 double&nbsp;weightB,
491 java.util.ArrayList&lt;<a href="../../../genius/core/Bid.html" title="class in genius.core">Bid</a>&gt;&nbsp;excludeList)</pre>
492<div class="block">Finds the bid with the minimal distance
493 weightA*DeltaUtilA^2+weightB*DeltaUtilB^2 where DeltaUtilA is the
494 difference between given utilA and the actual utility of the bid.</div>
495<dl>
496<dt><span class="paramLabel">Parameters:</span></dt>
497<dd><code>utilA</code> - the agent-A utility of the point to be found.</dd>
498<dd><code>utilB</code> - the agent-B utility of the point to be found.</dd>
499<dd><code>weightA</code> - weight in A direction.</dd>
500<dd><code>weightB</code> - weight in B direction.</dd>
501<dd><code>excludeList</code> - Bids to be excluded from the search.</dd>
502<dt><span class="returnLabel">Returns:</span></dt>
503<dd>best point, or null if none remaining.</dd>
504</dl>
505</li>
506</ul>
507<a name="distanceToNearestParetoBid-genius.core.analysis.BidPoint-">
508<!-- -->
509</a>
510<ul class="blockListLast">
511<li class="blockList">
512<h4>distanceToNearestParetoBid</h4>
513<pre>public&nbsp;double&nbsp;distanceToNearestParetoBid(<a href="../../../genius/core/analysis/BidPoint.html" title="class in genius.core.analysis">BidPoint</a>&nbsp;bid)</pre>
514<div class="block">Method which given a bid point determines the distance to the nearest
515 Pareto-optimal bid. If the distance is small, than the bid is near
516 Pareto-optimal.</div>
517<dl>
518<dt><span class="paramLabel">Parameters:</span></dt>
519<dd><code>bid</code> - for which the smallest distance to the Pareto frontier is
520 found.</dd>
521<dt><span class="returnLabel">Returns:</span></dt>
522<dd>distance to the nearest Pareto-optimal bid.</dd>
523</dl>
524</li>
525</ul>
526</li>
527</ul>
528</li>
529</ul>
530</div>
531</div>
532<!-- ========= END OF CLASS DATA ========= -->
533<!-- ======= START OF BOTTOM NAVBAR ====== -->
534<div class="bottomNav"><a name="navbar.bottom">
535<!-- -->
536</a>
537<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
538<a name="navbar.bottom.firstrow">
539<!-- -->
540</a>
541<ul class="navList" title="Navigation">
542<li><a href="../../../overview-summary.html">Overview</a></li>
543<li><a href="package-summary.html">Package</a></li>
544<li class="navBarCell1Rev">Class</li>
545<li><a href="class-use/BidSpace.html">Use</a></li>
546<li><a href="package-tree.html">Tree</a></li>
547<li><a href="../../../deprecated-list.html">Deprecated</a></li>
548<li><a href="../../../index-all.html">Index</a></li>
549<li><a href="../../../help-doc.html">Help</a></li>
550</ul>
551</div>
552<div class="subNav">
553<ul class="navList">
554<li><a href="../../../genius/core/analysis/BidPointTime.html" title="class in genius.core.analysis"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
555<li><a href="../../../genius/core/analysis/BidSpaceCache.html" title="class in genius.core.analysis"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
556</ul>
557<ul class="navList">
558<li><a href="../../../index.html?genius/core/analysis/BidSpace.html" target="_top">Frames</a></li>
559<li><a href="BidSpace.html" target="_top">No&nbsp;Frames</a></li>
560</ul>
561<ul class="navList" id="allclasses_navbar_bottom">
562<li><a href="../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
563</ul>
564<div>
565<script type="text/javascript"><!--
566 allClassesLink = document.getElementById("allclasses_navbar_bottom");
567 if(window==top) {
568 allClassesLink.style.display = "block";
569 }
570 else {
571 allClassesLink.style.display = "none";
572 }
573 //-->
574</script>
575</div>
576<div>
577<ul class="subNavList">
578<li>Summary:&nbsp;</li>
579<li>Nested&nbsp;|&nbsp;</li>
580<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
581<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
582<li><a href="#method.summary">Method</a></li>
583</ul>
584<ul class="subNavList">
585<li>Detail:&nbsp;</li>
586<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
587<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
588<li><a href="#method.detail">Method</a></li>
589</ul>
590</div>
591<a name="skip.navbar.bottom">
592<!-- -->
593</a></div>
594<!-- ======== END OF BOTTOM NAVBAR ======= -->
595</body>
596</html>
Note: See TracBrowser for help on using the repository browser.