========================================================================
	PROGRAM NOTES
========================================================================

   CrimeStat is a spatial statistics program that works in a Windows
environment.  It is designed to read 'dbf', 'shp', 'dat', ASCII files,
and ODBC data sources and to write selected graphical objects to ArcView, 
MapInfo, Atlas*GIS, Surfer for Windows, and ArcView Spatial Analyst.
It will also work with Maptitude, Vertical Mapper, and other
GIS packages.

   Version 3.3 adds a major regression module, both linear (OLS) and non-linear 
(Poisson-family) models.  The Poisson-family can be modeled using a Poisson dispersion,
a linear dispersion adjustment, or a Poisson-Gamma (negative binomial) function.
The non-linear models can be estimated with either maximum likelihood or Markov
Chain Monte Carlo (MCMC) simulation.  The MCMC function allows a variety of different
regression models including a spatial regression estimate and the ability to
model a risk or rate variable.  This version includes all the changes made
for version 3.1 and 3.2, including the Bayesian Journey-to-crime routine, the 
Getis-Ord global "G", the Getis-Ord Correlogram, the Geary Correlogram, the
Getis-Ord local "G", the Head Bang statistic, and the interpolated Head Bang
statistic with Monte Carlo simulations for the various global and local
spatial autocorrelation tests.  

   Known problems:

	1.	The use of tabs as delimiters in ASCII files. To the
		user, these appear identical to space delimiters.  The
		user should check that 'tab delimiters' is checked in the
		ASCII input screen; checking 'space delimiters' will lead
		to an error message.

	2.	For space-time calculations, time must be defined as an
		integer or real number (e.g., 3, 37199).  Date
		formats (e.g., 11/04/01 or July 30, 2002) are not permitted.
		The program will make calculations with date formats, but
		the results will not be correct.

	3.	The 'Network distance' calculations will work with most of
		the routines. However, it won't work with the 
		'Journey-to-crime' module or the nearest neighbor hierarchical
		clustering routine.  This capability should be added by
		version 4.0.

	4.	Many of the crime travel demand module routines have separate 
		inputs from the primary and secondary files.  For these, only
		'dbf' files can be read.

	5.	The Trip generation ‘Calibrate model’ routine may take
		some time to complete as the algorithm tries to find 
		a solution.

	6.	The 'Trip distribution' routine takes up a lot of memory. 
		Therefore, the number of zones will be limited.
		Theoretically, in Windows XP or Windows 2000, there could
		be 10,000 zones if there is 4 Gb of RAM.  However, since 
		few users have this amount, the actual number of zones 
		that can be calculated will be fewer than this.

	7.	Be careful when running routines with network distance.
		It can take a long time to complete.  The more pairs
		that have to be calculated, the longer it will take.
		Further, the more complicated the network, the longer
		it will take.  See chapters 3 and 16 for more details.

	8.	The 'Options Save Parameters' routine will not save the 
		parameters for second-level ('child') dialogues.  For example, 
		it won't save the network names and characteristics for the 
		'Mode split' and 'Network assignment' routines nor will
		it save the file characteristics for the 'Calibrate 
		Journey-to-crime function', the 'Calculate observed 
		origin-destination trips', nor 'Calibrate impedance 
		function' rountes.

	9.	Be careful with parameter files.  If you move them between
		different directories or copy them to another computer, they
		may not work and may cause the program to crash  It is generally 
		a good idea to reconstruct a parameter file from scratch if
		difficulties emerge. Another alternative is to re-save the 
		parameter file and then close down the program.  Re-open the 
		program and load in the parameter file.

	10.	Windows Vista and Windows 7 do not recognize the help menu. If a 
		user clicks on the help menu button in CrimeStat, there will be 
		no response.  However, Microsoft has developed a special file 
		that allows help menus to be viewed in these operating systems. 
		To view CrimeStat help in Vista or Windows 7, it will be necessary 
		to obtain a file and install it according to the instructions 
		provided by Microsoft.  The URL is found at:

			http://support.microsoft.com/kb/917607 

	11.	Some users have periodically experienced "irrecoverable error" messages. 
		Almost always, the "irrecoverable error" message indicates a data or 
		data definition problem.  Specifically, the following could cause 
		the error to appear:


			A.	Coordinate mismatch.  The data are in projected units, 
				but the user specifies spherical (lat/lon) units;

			B.	Trying to run a single kernel interpolation, dual kernel 
				interpolation, Nnh, or STAC hot spot run without 
				defining a reference file. The reference file is 
				essential for those routines (and several others).

			C.	Errors in defining the reference file.  For example, 
				mixing up the high and low values for the X or Y 
				coordinates.

			D.	Mismatches in distance units. For example, if the 
				data are in meters, but the user specifies 'feet' on 
				the Primary File page, the program could become 
				confused when trying to convert units and produce 
				that error.

			E.	Occasionally, the error appears in Windows Vista only 
				if the user tries to run multiple simulations simultaneously.
				The solution is to run one simulation at a time.
				This will not happen in Windows XP or Windows 7.  






