			------------------------------------------

			Disaggregate/Constrained Garin-Lowry Model

			------------------------------------------





This software represents a state-of-the-art implementation of the Garin-Lowry 

family of land-use models. Instead of the iterative procedure used in the 

original Lowry model, this code provides a much more satisfactory way to 

performed disaggregate/constrained forecasts. Complete documentation of these 

programs can be found in the "Chaos, Catastrophe, Bifurcation and 

Disaggregation" chapter in the Chan (2005) LOCATION, TRANSPORT & LAND-USE 

book.



THE SOFTWARE

************



This directory contains the following files:



-- AFTUCAL.FOR:  source code to calculate disaggregate multipliers a and f 

and basic accessibility functions t and u

-- AFTUCAL.EXE:  executable code for AFTUCAL.FOR

-- FIB.FOR:  source code to forecast target-year population using a 

Fibonacci-search technique and to calculate elasticity parameters b and c. 

The default is to run the "do-nothing" alternative; but if a flag is set in 

the data file, the "do-something" alternative may be run.

-- FIB.EXE:  executable code for FIB.FOR

-- 25MPH.FOR:  source code for a program with constraints for aggregate and 

disaggregate case with "do-something" alternative, a 25 mph	personal rapid 

transit (PRT) system

-- 25MPH.EXE:  executable code for 25MPH.FOR

-- DONOTHIN.FOR:  source code for a program with constraints for aggregate 

and disaggregate case for a "do-nothing" alternative

-- DONOTHIN.EXE:  executable code for DONOTHIN.FOR

-- LMBI42.DAT:  a 42-region case-study data-file for AFTUCAL.EXE, FIB.EXE, 

25MPH.EXE, and DONOTHIN.EXE

-- LMBI4.DAT:  a 4-region example data file for AFTUCAL.EXE, FIB.EXE, 

25MPH.EXE, and DONOTHIN.EXE

-- README.TXT:  this current explanation file



PROGRAM EXECUTION

*****************



To run a program simply type the name of the executable (the .exe file).  The 

program will prompt you to enter the name of a data file and the name of an 

output file.  If you enter the name of an output file that already exists, 

the old file will be overwritten.  The data file must be in the same format 

as the sample data file that comes with each program.  The format of each 

data file and the variables it contains are detailed at the end of the sample 

data file.  



For example, if you want to run AFTUCAL.EXE, type AFTUCAL at the 

DOS prompt.  The program will ask you to enter the name of the data file.  

If you want to run the 4-region example from the book, type LMBI4.DAT.  If 

you want to run the 42-region case study, type LMBI42.DAT.  The program will 

then ask you to enter the name of an output file.  Type in AFTU4.OUT, for 

example.  The program will notify you when it has stopped and return you to 

the DOS prompt.  



If the programs are run on the LMBI4.DAT file they should finish almost 

immediately, but the LMBI42.DAT file may take up to minutes to complete.



The Fibonacci program runs by default on the "do-nothing" travel-time matrix 

data.  If you want Fibonacci to run on the "25 mph PRT" travel-time matrix, 

simply edit the data file and set the "PRT" flag to one.

