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

				Software and Data Directory

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







BACKGROUND

***********



This disk is to provide the readers with sample software to supplement the 

discussions in the books LOCATION THEORY AND DECISION ANALYSIS and 

LOCATION, TRANSPORT AND LAND-USE. The platform is an IBM-compatible 

Personal Computer (PC), which at the time of writing is the most widely 

available computing machinery. By adopting this platform, it is expected that 

the accompanying software will find its use among the largest number of 

readers. For users running other platforms, please see the CAVEAT section at 

the end of this README file.



The files are dedicated to specialized software for processing and analyzing 

spatial-temporal information. To view the ASCII text and PDF files on this 

disk, we suggest using a display setting suitable for viewing a 10-point font 

format.



All of the software packages were developed or extended by the author and his 

colleagues. The origins of these codes are duly acknowledged in the 

documentation, using a bibliographic referencing system adopted in the book. 

For example, a program to analyze remote-sensing images is stored under the 

SPACE directory. It was developed by Dr. T S Kelso at the Air Force nstitute 

of Technology when he worked with the author on related teaching and 

research. We have officially obtained his permission to use the program here. 



PROGRAM PACKAGES

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



Software implementations of some of the location-allocation, routing, land-

use, and image processing models discussed in the aforementioned books are 

contained in the following software directories, each of which has its own 

README files containing operational instructions and acknowledgments:



STATEPRK - an activity location-allocation model 

SPANFRST - a location-routing program for package deliveries

RISE - a location-routing model for scheduled transportation

SPACEFIL - a heuristic multiple traveling-salesmen program 

LOWRY - the traditional Lowry land-use model

YICHAN - a disaggregate/constrained implementation of the Garin-Lowry model

PATTERN - This folder contains the IMGKMED MATLAB software and the 

Benabdallah-and-Wright (B&W) model. Both of these are classification models 

for pattern recognition of a grid of gray values (such an image).

SPACE - This folder contains the TS-IP program, which is an image-processing 

program that loads and manipulates digitized satellite images.



Now to view the program files from STATEPRK to SPACE, please refer to the 

BOOK subdirectory. A set of satellite images of the U.S. can be found in the 

IMAGEFILES subdirectory. They are intended for the image classification and 

processing software PATTERN and SPACE. 



AIM

****



While the aforementioned books introduces the various analysis techniques in 

a pedagogic fashion, we strive to provide the hands-on classroom experience 

and practical implementations here in these software files. The programs are 

therefore not only for the classroom. They have real potentials among every-

day, operational use.



These philosophies are followed in the preparation of this suite of software:



1. In order to provide the widest dissemination possible, all files are 

either ASCII-text files, PDF files, or MATLAB codes. Where possible, both 

source codes and executable codes are given--mainly for the ease of execution 

and modification by the users on different computer platforms.



2. All programs are self-contained and they have been developed or refined by 

the author and his associates. Except the MATLAB or a mixed-integer-

programming (MIP) code, we strive to provide standalone programs that do not 

require supporting software, including language compilers. For extended use 

of some of the programs, please consult Chan (2012) ? LOCATION THEORY AND 

DECISION ANALYSIS. References are made in chapters 7 and 8 to other 

supporting software, such as using the freeware OCTAVE to replace 

MATLAB, and the use of public-domain MIP software. 



3. Sample datasets are provided to allow demonstration of the software. While 

`toy' problems are often used for introduction, most of these data are drawn 

from real-world case studies that are discussed in the main body of this 

book.



4. It is assumed that the user of this disk has acquired basic knowledge of 

the DOS operating system on a PC. It is also assumed that s/he knows how to 

navigate between files and can discern the difference between a dataset file, 

an executable code and a source code. S/he also realizes that an executable 

code can be run by typing in the name of the file (without the extension) at 

a DOS prompt--with the necessary data. Accompanying this README file are two 

files providing information on how to compile a source code for execution. 



CAVEAT

******



Since these open-source software packages are developed over decades, 

computer hardware platforms has changed and will continue to change. While 

the basic operating system for a desktop IBM-compatible PC remains to be DOS, 

hardware configuration has rendered `legacy? programs inoperable on newer 

machines.



Fortunately, there is a software called DOSBox which will simulate an old 

DOS machine. You can download it from 



http://www.dosbox.com/ 



DOSBox is a DOS-emulator that uses the SDL-library which makes DOSBox very 

easy to port to different platforms. DOSBox has already been ported to many 

different platforms, such as Windows, BeOS, Linux, MacOS X etc. DOSBox also 

emulates CPU:286/386 realmode/protected mode, Directory FileSystem/XMS/EMS, 

Tandy/Hercules/CGA/EGA/VGA/VESA graphics etc.



Here are the instructions on how to use it.



1) Go to the above link and download the software (choose Windows).

2) Install it as you do for other software. It will create a shortcut in 

desktop.

3) Double click the shortcut.

4) First you have to mount the directory where the application is stored. 

Take the TS-IP image-processing program in the SPACE directory as an example; 

you might have stored it at 

C:\BOOK\SPACE\IMAGES 

To mount it type (without quotes) "mount c c:\book\space\images" Please check 

the accompanying PDF image DOSBOX to see how to do it.

5) Now type (without quotes) "C:", which will refer to the drive where TS-IP 

is located.

6) Finally, run the executable ts-ipx28.exe - The software should run now.



The programs on this CD are distributed after extensively testing by the 

author and his associates. But with any computer programs, there is no 

guarantee that they are fully debugged. It is impossible for the author, with 

his limited resources, to provide any programming support for these software. 

But the author is keenly interested in and would appreciate any feedback from 

the users regarding their experiences in using these programs. The objective 

is to allow distribution of an improved software package at a future date. To 

provide your comments, simply contact:



Yupo Chan, PhD PE

E-mail: ychan@alum.MIT.edu





Have fun!





ACKNOWLEDGMENT

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

The author likes to acknowledge the assistance of Brad A. Smith.  Mr. Smith 

was responsible for the compilation of the various software into a consistent 

format, organizing and test-running all the programs on this disk.

