MuonControl™ v0.91beta, October 7, 2002

		Download Now
Style = Java	Style = Windows

MuonControl is a simple Java GUI program that acts as a front-end to Muon1 v4.21b (and probably later) Windows command-line version.

MuonControl monitors progress of a simulation and logs the output of Muon1 to a log file. It also displays the Trial Type.

To install, unzip the contents into the directory where muon1_cmdline.exe is located.

NOTE: If MuonControl is started for the first time in the middle of a simulation, Trial Type will be "Unknown", until the next simulation.

Also, if muon1_cmdline.exe is already running prior to starting MuonControl, stop muon1_cmdline.exe. Once MuonControl is running, start muon1_cmdline.exe by clicking MuonControl's Start button. Having MuonControl start muon1_cmdline.exe lets MuonControl capture the output from muon1_cmdline.exe and then save it to the log file.

Included files:

logfile.txt	created file that logs output of Muon1
MuonControl.cfg	config file for Muon Control (see below)
mcreadme.html	this file
MuonControl.jar	the "executable". Run using "java -jar MuonControl.jar" (from the directory in which MuonControl.jar is located) after installing Java Runtime Environment (JRE) v1.4.0 or later (about 8 MB) available from java.sun.com. To determine the version of Java installed, run "java -fullversion" from a commandline (DOS) window. You can usually run MuonControl.jar by double-clicking a shortcut or icon for the .jar file. Doing so will do the equivalent of "javaw -jar MuonControl.jar". Note that the specific upper and lower case of "MuonControl.jar" is required (java is case sensitive). javaw.exe acts the same as java.exe except that javaw.exe does not open a command-line window. javaw.exe is Windows-only. The following switches are optional: -version (displays the version of MuonControl on the command line) -javastyle (forces the Java UI, otherwise detects and uses the native OS UI) The switch is added after the .jar file name, e.g., java -jar MuonControl.jar -version java -jar MuonControl.jar -javastyle
MuonControl.cfg	This file has several entries:
	autostart = false (or true) Only valid if "true", all else is false. Setting to true will execute Muon1 commandline when MuonControl is started. Otherwise user must click Start on the MuonControl GUI. Default is false.
	real time log interval (in sec) = n (where n is in seconds) How often (in real time, e.g., clock time) output from Muon1 will be written to the log file. The file can get quite large without this. THIS ONLY APPLIES TO Muon1 "t=1.03ns" STYLE LINES. ALL INFORMATIONAL LINES WILL BE WRITTEN TO THE LOG FILE REGARDLESS. In the current incarnation, the time seems an approximation. Currently trying to remedy this. The default value is 30 seconds.
	simulation time log interval (in ns) = n.nn (where n.nn is in nanoseconds) How often (in simulation time) output from Muon1 will be written to the log file. The file can get quite large without this. THIS ONLY APPLIES TO Muon1 "t=1.03ns" STYLE LINES. ALL INFORMATIONAL LINES WILL BE WRITTEN TO THE LOG FILE REGARDLESS. The valid range is 0.01 to 300.00 nanoseconds. The default value is 1.00 nanosecond.
	use real time log interval = false (or true) This entry defines whether real time log interval (clock time) or simulation time log interval is used to determine how often output from Muon1 will be written to the log file. ALL INFORMATIONAL LINES WILL BE WRITTEN TO THE LOG FILE REGARDLESS OF THE LOG INTERVAL. Default is false.
	logfile cutoff (in bytes) = n (where n is in bytes) When MuonControl is started, it will check to see if logfile.txt is larger than n bytes. If so, the current Trial Type is saved and logfile.txt is overwritten. The default value is 200000 bytes (200 KB).
	start minimized = false (or true) Only valid if "true", all else is false. Setting true will start MuonControl minimized. Default is false.

The MuonControl software is copyrighted software of RPF Software. The name MuonControl is a trademark of RPF Software. This version of MuonControl may be used without license fee payment.

MuonControl is provided AS IS. Use at your own risk. RPF Software disclaims all liability related to the use of MuonControl. While care has been taken in the creation of MuonControl and there is no known harm from its use, it is the user's responsibility to ensure sufficient backups have been made prior to the use of MuonControl.

Support is available only on an informal basis, via email, and when time permits. Direct support requests to muoncontrol@rpfsoftware.com.

MuonControl may be downloaded from http://www.rpfsoftware.com/muoncontrol.shtml (see "Download Now" at top of page).

There is no connection between RPF Software and the authors of Muon1. Information on Muon1 may be available at http://www.stephenbrooks.org/muon1/.