Let s Learn Market Mechanism by Artificial Market Attached CD-ROM README file U-Mart project 1. Introduction The U-Mart system is a system that builds a virtual artificial futures market on a computer network to conduct trading between humans and computer-programmed machines. The U-Mart system has a good track record and has been utilized in interdisciplinary study and education, and open experiments. The attached CD-ROM contains the U-Mart system that can run on Windows, Linux and Mackintosh. See the book for instructions on how to install and use the system. This document contains information and reminders which the book does not contain. We wish the U-Mart system to be utilized by as many people as possible. Regarding the U-Mart project, see the book and the pamphlet of U-Mart project included in the Doc folder. 2. License See LICENSE.pdf regarding the license of the program and document contained in this CD-ROM. 3. CD-ROM structure README.pdf: This document file LICENSE.pdf: License Doc folder: Contains various documents * Jp folder * explanation OfStrategies folder: The description of 10 types of agents embedded in the U-Mart system by default (Japanese) * Tutorial.pdf: U-Mart system tutorial (Japanese) * UMartPamphlet.pdf: U-Mart system pamphlet (Japanese) * Eng folder * explanation OfStrategies folder: The description of 10 types of agents embedded in the U-Mart system by default (English) * Tutorial.pdf: U-Mart system tutorial (English) * UMartPamphlet.pdf: U-Mart system pamphlet (English) 1
* UMartSystem-Windows folder: The U-Mart system for Windows2000/XP. Copy this folder to use the system. * LICENSE.pdf: License * Icon folder: Icons * jre folder: JAVA2 Runtime Environment for Windows * resource folder: U-Mart system configuration files * csv folder: Configuration files * images folder: Image files * tutorial folder: Help and tutorial files * strategy folder: Program source files (***.java) and class files (***.class) of the machine agent embedded in the U-Mart system by default * MarketSimulator_ja.exe: Executable file of stand-alone market simulator for Windows (Japanese) * MarketSimulator_en.exe: Executable file of stand-alone market simulator for Windows (English) * MarketServer_ja.exe: Executable file of network market server for Windows (Japanese) * MarketServer_en.exe: Executable file of network market server for Windows (English) * TradingTerminal_ja.exe: Executable file of network trading terminal for Windows (Japanese) * TradingTerminal_en.exe: Executable file of network trading terminal for Windows (English) * LogAnalyzer.exe: Executable file of log analyzer program fro Windows * UMartSystem.jar: JAR file of U-Mart system * LogAnalyzer.1.3.1.jar: JAR file of LogAnalyzer UMartSystem-Linux.zip: The U-Mart system for Linux. Unzip the file after copying it to use the system. * The file structure is as follows where UMartSystem-Mac.zip is unzipped. * UMartSystem-Linux folder: The U-Mart system for Linux. Confirm weather you have the user s authority on this folder. Logs cannot be created without the user s authority. LICENSE.pdf * Icon folder 2
* jre folder: JAVA2 Runtime Environment for Linux * resources folder * csv folder * images folder * tutorial folder * MarketSimulator_ja.sh: Executable shell script of stand-alone market simulator for Linux (Japanese) * MarketSimulator_en.sh: Executable shell script of stand-alone market simulator for Linux (English) * MarketServer_ja.sh: Executable shell script of network market server for Linux (Japanese) * MarketServer_en.sh: Executable shell script of network market server for Linux (English) * TradingTerminal_ja.sh: Executable shell script of network trading terminal for Linux (Japanese) * TradingTerminal_en.sh: Executable shell script of network trading terminal for Linux (English) * LogAnalyzer.sh: Executable shell script of Log Analyzer for Linux * UmartSystem.jar * LogAnalyzer.1.3.1.jar * UMartSystem-Mac.zip: The U-Mart system for Mac OS X (PowerPC). Unzip the file after copying it to start using. Mac OS X includes Java environment by default; jre file is not contained. * The file structure is as follows where UMartSystem-Mac.zip is uncompressed. * UMartSystem-Mac folder: The U-Mart system for Mac OS X. On Mac OS X, the log folder is created in the root directory (Usually, Macintosh HD:), where double clicking on the system to run on GUI. Notice an error might occur depending on the user s authority. When the system is run on command prompt, the log folder is created in the same class. * LICENSE.pdf * Icon folder * resources folder * scv folder 3
* images folder * tutorial folder * strategy folder * MarketSimulator_ja.app: Executable AppleScript of stand-alone market simulator (Japanese) for Mac OS X. * MarketSimulator_en.app Executable AppleScript of stand-alone market simulator (English) for Mac OS X. * MarketServer_ja.app Executable AppleScript of network market server (Japanese) for Mac OS X. * MarketServer_en.app Executable AppleScript of network market server (English) for Mac OS X. * TradingTerminal_ja.app Executable AppleScript of trading terminal (Japanese) for Mac OS X. * TradingTerminal_en.app Executable AppleScript of trading terminal (English) for Mac OS X. * LogAnlyzer.app Executable AppleScript of Log Analyzer for Mac OS X. * UmartSystem.jar * LogAnalyzer.1.3.1.jar 4. Starting from Command Line The U-Mart system can also be started using the command line. Command Prompt (Windows), each terminal (Linux, e.g., gnome-terminal), or Terminal (Mac OS X) should be started first. And then, the following commands can run the U-Mart system after selecting respective folders containing the system: Stand-alone Market Simulator (Japanese): MarketSimulator_ja java -cp. : UMartSystem. jar gui. UStandAloneGUI Network Market Server (Japanese): MarketServer_ja java -cp. : UMartSystem. jar gui. UServerManager Network Trading Terminal (Japanese): TradingTerminal_ja java -cp. : UMartSystem. jar gui. UNetGUI Stand-alone Market Simulator (English): MarketSimulator_en java -Duser. Language=en -cp. : UMartSystem. jar gui. UStandAloneGUI 4
Network Market Server (English): MarketServer_en java -Duser. Language=en -cp. : UMartSystem. jar gui. UServerManager Network Trading Terminal (English): TradingTerminal_en java -Duser. Language=en -cp. : UMartSystem. jar gui. UNetGUI About JAVA for the U-Mart system When using JAVA of the JRE included in Windows and Linux versions without installing any Java environment (JRE or JSE) in your computer, replace java with the following paths:. jre bin java (Windows),./jre/bin/java (Linux). Additionally, if you want to use a different version of Java environment than that which is contained, the path should be set by the individual. When it comes to the case of Mac OS X, you do not need to replace java with the above mentioned paths since the OS contains the Java environment by default. 5. Support and Related Information The U-Mart project website offers beneficial information regarding the U-Mart project and U-Mart system. http://www.u-mart.org/ The above cited website conducts bug fixing for the U-Mart system included in this CD-ROM, and offers the latest version of the system, other information, and all support. 6. Acknowledgement The original U-Mart server was created by Dr. Hiroshi Sato of National Defense Academy, JAPAN, and Mr. Rikiya Fukumoto, Tokyo Institute of Technology, JAPAN. Subsequently, the development was passed to the U-Mart project. The U-Mart system adopts J30 as stock index data provided and calculated by Mainichi Newspapers Co., JAPAN. Java(TM)2 Standard Edition Runtime Environment, JLauncher (http://www.cromoteca.com/jlauncher/), and Sazanami Font (http://wiki.fdiary.net/font/?sazanami) have been utilized for the U-Mart system development. We are thankful to all the people who participated in the activity of U-Mart project, as well as open experiments. Copyright (c) 2006 by U-Mart Project The distribution of this document is subject to the terms and restriction specified by the open publication consent agreement (v1.0, or later). The latest agreement is available on the website http://www.opencontents.org/openpub/. 5