-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.html
203 lines (162 loc) · 5.18 KB
/
README.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
<HTML>
<HEAD>
<TITLE>README for JASA</TITLE>
</HEAD>
<BODY>
<h2>
README for JASA
</h2>
<p>
Last modified: $Author: sphelps $<br>
$Date: 2013/06/10 10:24:09 $<br>
$Revision: 1.12 $<br>
</p>
<a name="About"></a>
<h3>
About
</h3>
<p>
JASA is a high-performance auction simulator written in JAVA.
It is designed for performing experiments in agent-based computational economics.
</p>
<A name="status"></A>
<H3>
Development Status
</H3>
<p>
This package is currently at alpha. This code is not stable or fully tested.
Please report any bugs, issues or suggestions to <A
href="mailto:[email protected]">Steve Phelps</A>.
</p>
<A name="license"></A>
<H3>
License
</H3>
</A>
<P>
This software is licensed under the <a href="LICENSE.TXT">GNU General Public
License</a>. Although it is not an official term of the licensing conditions,
you are also expected to cite use of this software if you use it in your
research.
</p>
<A name="downloading"></A>
<h3>
Obtaining the latest release
</h3>
</A>
<p>
The latest release of JASA can be downloaded from
<a href="http://sourceforge.net/project/showfiles.php?group_id=47257&package_id=40190">SourceForge</a>.
</p>
<A name="documentation"></A>
<h3>
Documentation
</h3>
<p>
<a href="doc/api/index.html">API Documentation</a>.
</p>
<A name="prerequisites"></A>
<h3>
Prerequisites
</h3>
<ul>
<LI>
<a href="http://java.sun.com">Java</a> JVM 1.6.0 or later
</LI>
<li>
JASA is built on top of the <a href="http://jabm.sourceforge.net"/>JABM framework</a>
which must be installed before using JASA.
</li>
</ul>
<H2>
Running the examples
</H2>
<h3>Using Apache Ant</h3>
<P>
The examples can be run using <A href="ant.apache.org">Apache Ant</A>. Launch a
command window or shell and set your working directory to the <code>jasa/</code> subdirectory.
Next <a href="http://ant.apache.org/manual/running.html">run ant</a>
<code>
ant chiarellaAndIori
</code>
<h3>From the command line</h3>
<P>
Alternatively, configure the
<a href="http://download.oracle.com/javase/tutorial/essential/environment/paths.html">CLASSPATH</a>
environment variable to include all the <code>jar</code> files in the <code>lib/</code> directory and the <code>dist/</code>
directory and use a command similar to the following:
</P>
<code>
java -Djabm.config=examples/chiarellaAndIori/main.xml
net.sourceforge.jabm.DesktopSimulationManager
</code>
<h3>From the Eclipse IDE</h3>
<P>
The distribution archive can be imported directly into the <a href="http://www.eclipse.org/">Eclipse IDE</a> by
using the <a href="http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/tasks-importproject.htm">File/Import</a> menu item.
Create a <a href="http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.jdt.doc.user/tasks/tasks-java-local-configuration.htm">launch configuration</a> with the main class <code>net.sourceforge.jabm.DesktopSimulationManager</code>
and specify which configuration file you want to use by setting the system property <code>jabm.config</code> using
the JVM argument <code>-D</code>, for example
</P>
<code>-Djabm.config=examples/chiarellaAndIori/main.xml</code>
<H3>
Documentation
</H3>
<ul>
<li>
<a href="doc/api/index.html">Javadoc and UML</a>
</li>
</ul>
<A name="acknowledgements"></A>
<h3>
Acknowledgements
</h3>
<p>
Additional contributors: Jinzhong Niu and Marek Marcinkiewicz.
</p>
<p>
This work has been supported by EPSRC grant GR/T10671/01 - "Market Based
Control of Complex Computational Systems." and NSF grant number IIS-9820657 -
"Tools and Techniques for Automated Mechanism Design". It was originally
supported by the EU IST Programme through the SLIE project.
</p>
<p>
The system is based on the 4-heap algorithm, described in the paper
</p>
<p>
Wurman, P. R., Walsh, W. E., & Wellman, M. P. (1998). Flexible double auctions
for electronic commerce: theory and implementation. International Journal of
Decision Support Systems, 24, 17–27.
</p>
<p>
JASA makes use of the <a href="http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html">Mersenne Twister PRNG</a>. Full details of the Mersenne Twister algorithm can be found in:
</p>
<p>
Makato Matsumoto and Takuji Nishimura, "Mersenne Twister: A 623-Dimensionally
Equidistributed Uniform Pseudo-Random Number Generator", in <i>ACM Transactions
on modeling and Computer Simulation</i>, Vol. 8, No. 1, January 1998, pp 3--30.
</p>
<p>
JASA includes implementations based on existing agent-based models described in the literature, including:
</p>
<p>
<ul>
<li>
Iori, G., & Chiarella, C. (2002). A Simulation Analysis of the Microstructure of Double Auction Markets. Quantitative Finance, 2, 346–353.
</li>
<li>
Cliff, D., & Bruten, J. (1997). Minimal-Intelligence Agents for Bargaining Behaviors in Market-Based Environments.
</li>
<li>
Nicolaisen, J., Petrov, V., & Tesfatsion, L. (2001). Market power and efficiency in a computational electricity market with discriminatory double-auction pricing. IEEE Transactions on Evolutionary Computation, 5(5), 504–523.
</li>
</ul>
</p>
<P>
This product includes software developed by the Apache Software Foundation <a href="http://www.apache.org">(http://www.apache.org)</A>.
</P>
<hr>
<p>
(C) 2013 <a href="http://sphelps.net/">Steve Phelps</a>
</p>
</body>