Head-Bang - Version 3.0 08/14/2003 ------------------------------------------------------------------------------------------ Table of Contents ------------------------------------------------------------------------------------------ 1.0 Revision History 2.0 Overview 3.0 Options and Arguments 4.0 Installation, Uninstall 5.0 Getting Help ------------------------------------------------------------------------------------------ 1.0 Revision History ------------------------------------------------------------------------------------------ 2003 (08/14/2003) - Version 3.0 - Defaults set to nn = 10, ntrip = 7, niter = 10, thetastar = 135. - Defaults are optional parameters in the console version. ------------------------------------------------------------------------------------------ 2.0 Overview ------------------------------------------------------------------------------------------ The Head-Bang console application can be called from other software such as S-PlusŪ as well as from the command prompt. A series of parameters are passed in as arguments, and it will run as a console application, streaming out the results. The options and arguments are listed below. ------------------------------------------------------------------------------------------ 3.0 Options and Arguments ------------------------------------------------------------------------------------------ [-r] [-c] [-n max-neighbors] [-t max-triples] [-i iterations] [-a thetastar-degrees] [-f filename] [-m missing] Description of Flags: -r First row contains field names. -c First column contains row labels. -n Maximum number of nearest neighbors to use for smoothing (default = 10). -t Maximum number of triples per data point (default = 7). -i Number of iterations to perform (default = 10). -a Threshold angle in degrees, ThetaStar (default = 135). -f Input filename (the default is redirection, that is, streamed input. -m Ignore records containing missing value (default = blank space or null character) Sample S-Plus code for calling Head-Bang is provided on the Web at: https://surveillance.cancer.gov/headbang/download.html User Notes: - Input data can not be stored in scientific notation. Standard fixed format must be used (0.0003 not 3.00E-03). - Please note that path names for the console application can not contain spaces. This is a limitation of the DOS shell. Since the default location for the HeadBang console version is C:\Program Files\Headbang\console, the argument needs to be written with the equivalent DOS short name, "C:\Progra~1\Headbang\console". Alternatively, the headbang console version can be installed to a directory with no spaces in the path name. ------------------------------------------------------------------------------------------ 4.0 Installation, Uninstall ------------------------------------------------------------------------------------------ To download and install either the console or windows version of Head-Bang please refer to the web page: https://surveillance.cancer.gov/headbang/download.html Use Windows' Add/Remove Programs feature to uninstall. Be sure to restart your system after uninstalling. ------------------------------------------------------------------------------------------ 5.0 Getting Help ------------------------------------------------------------------------------------------ If you have problems downloading Head-Bang, please send an email to headbang@imsweb.com. For help using the Head-Bang software, please refer to the Web page: https://surveillance.cancer.gov/headbang/help.html