Krebs Ecological Methodology for Windows

                    (version 0.93 - 21 February 1998)

See the file CHANGES for changes since the previous version.

New installation procedure:  download SETUP.BAT and KREBSZIP.EXE
to the same directory.  Run SETUP.BAT from Windows File Manager 
to install to C:\KREBS, or see below for more detailed instructions.
(Make sure to download KREBSZIP.EXE as a binary file.)

The most recent version of this package is available for download
via:

http://www.biology.ualberta.ca/jbrzusto/krebswin.html

The software is free; source code is available.


PROGRAMS INCLUDED:
==================

Test for Difference in Mean by Randomization (RANDCOMP - not from Krebs book)
      REQUIRES A '386 and Windows to be running in enhanced mode!
      Tests whether the mean value of a measured value differs significantly
      in between two populations.  Random samples are taken by reassigning
      measurements to the two populations, then comparing the resulting
      difference in means to the observed difference in means.  If the
      samples are blocked (ie. placed in sets within which independence
      is not guaranteed, but between which it is), then random samples
      are generated by taking one datapoint per block, and the observed
      mean is actually a distribution of bootstrapped mean estimates.
      The distributions of bootstrapped and randomized differences
      in means are compared, to see how often the latter is larger than
      or equal to the former.


Calculate distances between samples/species (CALCDIST - like SIMILAR)
      compute various continuous or binary measures of similarity/distance
      between samples or species

Cluster (CLUSTER - not from Krebs book)
      build a cluster tree from a similarity or distance matrix using
      various clustering methods such as UPGMA, WPGMA, etc.

Fit a Distribution (NEGBINOM, POISSON, BINOM)
      fit a negative binomial, poisson, or binomial distribution to
      quadrat count data; program can choose "best" fitting distribution
      Unfortunately, these programs use a brain-dead way of storing
      distributions, with storage proportional to the largest count,
      so they only work for small counts (no more than 180 or so).

Accumulation and Similarity (NORTON - not from the Krebs book)
      calculate species accumulation and turnover with increased sample
     pooling

Mark Recapture (JOLLY)
      Jolly Seber mark-recapture analysis

Diversity Estimates (DIVERS)
      various estimates of community diversity indices

Point Quarter (QUARTER)
      population estimation by point-quarter sampling

Line Transect (HAYNE)
      estimate a population from line transects

Aerial Census (AERIAL)
      estimate a population from aerial transects.


New Installation Procedure
=============================================================================
Because of many problems people have had trying to install this
program, I've eliminated the Microsoft installation "middleman".

To get rid of an old version:
=============================

  Delete all files in your C:\KREBS directory, or wherever the
  program was installed.

  Delete C:\WINDOWS\SYSTEM\FORKREBS.DLL
  Delete C:\WINDOWS\SYSTEM\KREBSPRO.DLL
  
The command file SETUP.BAT does this for you.

To install the new version:
===========================

Get the file KREBSZIP.EXE, available via anonymous ftp at

ftp://gause.biology.ualberta.ca/pub/jbrzusto/krebs

In DOS, or from an MSDOS Prompt window within Windows, type:

	mkdir c:\krebs

to create the c:\krebs directory.  You can choose any name for
this directory.  If it already exists from a previous KREBS/win
installation, you should delete everything in it, using 

	del c:\krebs\*.*

Now change to the krebs directory, and run KREBSZIP:

	cd c:\krebs
	c:\tmp\krebszip

The second command assumes KREBSZIP.EXE is in the C:\TMP
directory.  If not, substitute this with whatever directory
it is on; e.g. if you obtained the program on a floppy, you
would type a:\krebszip

This will extract all the files you need into the C:\KREBS
directory.  You can now delete KREBSZIP.EXE, if you wish.

The last step is to add an icon to your Windows desktop
to run the program.  The procedure depends on whether
you are using Win 3.1, or Win 95:

Creating the Krebs Icon for Windows 3.1
========================================

Run Windows, and use the Program Manager to open a folder
or group where you want to put the icon.  From the File menu,
choose New... and then select Program Item.

This will pop up a window like (buttons not shown):

	=========================================
	|Program Item Properties                |
	|=======================================|
	|Description:        __________________ |
	|                                       |
	|Command Line:       __________________ |
	|                                       |
	|Working Directory:  __________________ |
	|                                       |
	|Shortcut Key:       __________________ |
	|                                       |
	|                    __ Run Minimized   |
	|                                       |
	=========================================

Fill in the items as follows:

	=========================================
	|Program Item Properties                |
	|====================================== |
	|Description:        KREBS              |
	|                                       |
	|Command Line:       C:\KREBS\KREBS.EXE |
	|                                       |
	|Working Directory:  C:\KREBS           |
	|                                       |
	|Shortcut Key:       __________________ |
	|                                       |
	|                    __ Run Minimized   |
	|                                       |
	=========================================

making appropriate changes if you have used a directory 
other than C:\KREBS.  You can fill in whatever
you like for the description.	Make sure the Run Minimized
box stays unchecked.

Click on the OK button to save this item.
A new Krebs icon should be displayed in the Group you
had opened.

Creating the Krebs Icon for Windows 95
======================================

From the desktop, click the right mouse button to bring up 
the system menu, and choose New -> Shortcut.

This pops up the Create Shortcut dialog box, which 
asks for a command line. Enter C:\KREBS\KREBS.EXE in this
field then click on Next.

Enter a name for the shortcut, such as KREBS/win, and click on
Finish.

You should now have a new Krebs icon on your desktop.  You can
move it to any folder.

============================================



Quick Instructions
===================

Run Krebs/Win:  just click on the icon you've created,
or use Run... under the File menu in Program Manager to run KREBS.EXE (it will be
in the directory to which you installed the programs.)

Enter program parameters:  choose a program from the Program menu, and a
parameter/option form will appear.   You can copy values from one field to
another on this form by dragging with the right mouse button.  

Enter tabular data:   press the Data button on this form, and a table form
will appear, with rows and columns labelled according to what data is required
for the program you chose.  You can flip back to the parameter form by
pressing the Show Parameter Form button on the table.  

  or

Import data from an existing ASCII data file:  choose Import... from the File
menu.  A table will appear with the data from the file arranged in rows and
columns.  Generally, data in the file are assumed to be separated into columns
by spaces, tabs, and/or commas.  Each line in the file
becomes a row in the table.  Data must be copied from this table to the table
associated with the
parameter form.

Cut and paste data from other Windows programs like Quattro Pro, Excel or
Notepad.

Closing a parameter form closes the associated table form, discarding all data
and parameter values.  To get a form out of the way without discarding data,
use its minimize button.

Edit tabular data:  blocks of cells can be selected by dragging with the left
mouse button, either within the table or along the heading row or column. 
Blocks can be Cut, Pasted, Reshaped, Left or Right Justified, or Erased by
commands under the Edit menu.  Dragging with the right mouse button on this
form will only copy the value from the current cell to a field on a parameter
form.
(Justifying is useful for data sets like JOLLY.DAT which contain the upper
 right triangle of a matrix but which are imported as upper left triangles.)

Run the program:   to run the program, press the Go! button.  Output will
appear in a scrollable window, whose contents eventually scroll off the top.
If you want to save such output, select "Choose Logfile for Output" from the
File menu.  All existing and subsequently-generated text in the Output window
will be sent to this file.  You can also stop logging output, by choosing
"Stop Logging Output" from the File menu.

Use sessions:   you can open several parameter and table forms at once - each
parameter table keeps track of which table form belongs to it.  A session is a
collection of parameter forms and table forms with parameters and data filled
in.  You can Save, Open, and Merge sessions from/to files on disk.  AERIAL.KS
and HAYNE.KS are files containing sessions corresponding to the files
AERIAL.DAT and HAYNE.DAT supplied with the original DOS Methodology programs.
You can Open and run them - the output should be the same as that obtained
from the DOS versions, excepting possibly for the number of digits output for
each calculation.


Please see the following files for more details:

ZIPNOTE.TXT
     - how this program is packaged, and where to get the free
     archiving software used.

COPYING.TXT
     - various copyrights and an explanation of your right to give away
     copies of this program.

DEVELOP.TXT
     - how to add new subprograms to this program.

CHANGES.TXT
     - notices of changes and bug fixes



=================================================
John Brzustowski

Please feel free to send comments and criticisms on bugs, design, 
user interface, and so on, or modified .PI files to:

     jbrzusto[drop this part, of course]@ualberta.ca