Go to: CoHort Software | CoStat

Download the Free Trial Version of CoStat 6.3

Thank you for choosing to try CoStat. (This is version 6.311, dated 2005-09-25.)

Installation Notes:

Install CoStat:

  1. Windows users: if an older version of CoStat 6.x is already installed on your computer, uninstall it.
    1. Use Start : Settings (on older computers) : Control Panel : Add/Remove Programs.
    2. Uninstall CoHort, CoStat, and/or CoPlot if they are listed.
    3. Uninstall Java 2 Runtime Environment if the version number is less than 1.4.2 and if you don't need the older version of Java for any other programs (you probably don't). If you need to leave this version of Java on your computer, that is fine; it won't affect the new version of Java or the new version of CoStat.
  2. If you don't have Java 1.4.2 or higher (or if you don't know if you do),
    download and install the latest version of Java.
  3. Download and install the latest version of CoStat.

 


Common Download Problems

 


Common Problems Running CoStat

When you exit CoStat, you get a warning like "Warning: Default charset MS932 not supported; using ISO-8859-1 instead."
This problem can occur on some computers where the default language is not English. The solution is:
  1. Right-click (Apple users: use shift-click) on charsets.jar
  2. Choose Save Target As (or "Save link as" on some browsers).
  3. In the file dialog that pops up:
    • Set Save As Type to be All Files.
    • Make sure the file gets saved with the name charsets.jar. If your browser changed the file name (for example, to charsets.zip), change the name back to charsets.jar.
    • Choose to save the file in your cohort6 directory in the sub-directory called "jre/lib/"
      (on Windows, this is often c:\Program Files\cohort6\jre\lib;
      on Mac OS X, this is often (Macintosh HD)/Applications/CoHort/cohort6/jre/lib;
      on Linux and UNIX, this is often /usr/local/bin/cohort6/jre/lib).
  4. If the file gets upzipped, something went wrong. Try to follow the steps above again, but with slight changes so that the file gets saved as one file.
The next time you run CoStat, the file will be detected by Java and the problem should go away.

 


Common Problems with Installing and Running CoStat from the Command Line

OS/2, Linux, or Unix says something like: "Bad command or file name" immediately after you type costat.
The script file isn't being found. Check the directory listing to make sure the CoHort files are there. Did you remember to change to the cohort directory (in Linux and Unix, cd /usr/local/bin/cohort6) before running the program?
 
OS/2, Linux, or Unix says something like: "Bad command or file name: java" right after the script file tries to run java.
The Java program isn't being found. Edit the script file so that the reference to 'java' includes the name of the directory where the java program file is located.
 
Java says: "Can't find class com.cohort.CoStat"
Did you remember to change to the cohort directory (in Linux and Unix, cd /usr/local/bin/cohort6) before running the program?
 
There are text buttons, not graphics icon buttons, on the toolbar just below the menu titles.
Make sure that the icon's .gif files are indeed in the cohort6 directory: for example, check to see that OpenButton.gif is present. If it isn't, try to find out where it is (in Linux and Unix, use "find / -name 'OpenButton.gif'") as that may help you determine what went wrong with your installation.
 
Problems running CoStat from a shortcut file or a desktop icon?
Make sure the shortcut points to the correct script file (for Linux and Unix: costat) in the cohort6 directory. Also, make sure that the shortcut file makes the cohort6 directory the current directory before it runs the costat script.

 


 

What Is in the 'costat' Script/Batch Files?

Few people will need to know these details. But here they are:

If you use the command line installation method, the CoHort programs are actually run by OS/2 command files (for example, costat.cmd), Unix/Linux shell scripts (for example, costat, no extension), or Windows batch files (for example, costat.bat, if you aren't using the costat.exe file). In unusual cases (for example, non-Sun versions of Java), you may need to modify these files to get the programs to run on your computer.

Usually, the files have just one command in them. Using the Windows batch file for CoStat as an example:
java -Xmx512m -Xincgc -cp .;cohort.jar com.cohort.CoStat %1 %2 %3 %4
The syntax is slightly different in the OS/2 command files and Unix/Linux shell scripts. The components are:

java
runs the program via the java program. If Java isn't found when you run the script file, add the full directory name before "java".
-Xmx512m
specifies 512 MB as the maximum amount of memory to be allocated to the program. You can increase this: -Xmx1400m or -Xmx1500m is often the highest amount allowed on computers with 32 bit operating systems. But if you get an "out of memory" error message, it is more likely that something other than memory is the problem. See Memory in the CoStat manual.
-Xincgc
turns on incremental garbage collection. Garbage collection is the system by which Java reclaims memory that was allocated but is now no longer used. Incremental garbage collection (as opposed to non-incremental) is required for CoHort programs. Also, our experience is that Java sometimes generates erroneous "out of memory" error messages when non-incremental garbage collection is used.
-cp .;cohort.jar
sets the Java classpath, which tells Java where to look for the Java class files. The cohort.jar file is a compressed file which contains all of the class files from CoHort Software. All of the other files which are distributed with CoStat (for example, .aov files) should be in the same directory as cohort.jar. In the Unix and Linux script files, the path separator is ":", not ";".
com.cohort.CoStat
the name of the Java class to be run. This is "com.cohort.CoText" or something else in the other script files. This is case sensitive in all operating systems. Starting with CoStat 6.100, "com.cohort" is needed because all of the files in the cohort.jar file are now in a Java package called "com.cohort". So the full name of the CoStat class is "com.cohort.CoStat".
%1
passes the first parameter (the document name) to the program.
%2
passes the second parameter (for example, the name of a macro) to the program.
%3
passes the third parameter (currently unused) to the program.
%4
passes the fourth parameter (currently unused) to the program.

 


Optional Document Name on the Command Line

For CoStat, the extension of the datafile name on the command line tells CoStat what type of data file it is, so that CoStat can import the data. If the datafile name doesn't have an extension, .dt will be added. Supported file types (and the necessary extensions) are: ASCII (.asc), Comma separated value ASCII (.csv), columnar ASCII (.col), CoStat (DOS .dt and Java .dt), dBASE (.dbf), Epi-Info (.rec), Excel (.xls), Gauss (.fmt), Genstat (.gsh), HTM (.htm), HTML (.html), Instat (.wor), Lotus 1-2-3 (.wk3), MatLab (.mat), Microstat II (.mii), Minitab (.mtw), MSTAT (.dat), Paradox (.db), Quattro (.wq1), Quattro Pro for Windows (.qpw), Rich Text Format (Word, .rtf), S+ (.sdd), SAS PC (.tpt), Space separated ASCII text (.txt), SPSS/Win (.sav), Stata (.dta), Statistica (.sta), Systat (.syd), Tab separated ASCII text (.tab).

For example, "costat longley.dbf" will run CoStat and import data from the Longley dBASE file. See File : Open in the CoStat manual for details.

 


 

Installing and Running CoStat with a Network File Server

We no longer recommend that you use a network file server to store the CoHort programs. It leads to excessive network traffic and makes the program's start up time much longer.

 


Problems, Comments, Questions, or Suggestions?

We want your experience with CoStat to be a good one. If you have problems, comments, questions, or suggestions, don't hesitate to contact technical support.

 


All material Copyright © 1996-2006 CoHort Software. All rights reserved.