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

					VALID SUB-DIRECTORY 

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





Under the VALID sub-directory, all files in the sub-subdirectories LP, TREE, 

and CW are named by alphanumeric codes.  The alphabetical part of the 

filename refers to the type of program or data contained; the ensuing numbers 

refer to a particular run.  Below is further explanation of the nomenclature 

for the LP sub-subdirectory:



LP sub-subdirectory

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



Within the LP sub-subdirectory, REG indicates an MIP83 (XA Professional 

Linear Programming) file, which computes the validation solution by the 

modified Laporte method. Extensions labeled .LP denote the program file, a 

.DAT 

extension denotes an output file. For example:



	Program file    - reg12.lp

	Output file     - reg12.dat



Notice these are in an ASCII format similar to many other mixed-integer-

programming software that accept algebraic input (to be differentiated from

a tableau input).  The ASCII program file can therefore be input to other 

mathematical-programming packages other than MIP83, such as LINDO and CPLEX, 

including public-domain solvers.  Minor editing may be required depending on 

the input format of the particular package.



TREE sub-subdirectory

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



Within the TREE sub-subdirectory, the label TREE also indicates a FORTRAN 

file which computes a minimum-spanning forest. A .FOR file contains the 

source code; a .EXE file contains the DOS executable code; a .DAT file 

contains the input dataset; and a .OUT file contains the solution data.  For 

example:



	Program file    - tree2.for

	Executable code - tree2.exe

	Input file      - tree12.dat

	Output file     - tree12.out



The compiled source-code or the executable code must be run to produce the 

output file.  At the prompt, type in "tree2" (for instance) to run the 

executable, then type in the name of the data file, "tree12.dat," then the 

name of the output file, "tree12.out."  Tree1.exe should be run on datasets 

tree11.dat, tree21.dat, and tree31.dat.  Tree2.exe should be run on datasets 

tree12.dat, tree22.dat, and tree32.dat.



CW sub-subdirectory 

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



Within the CW sub-subdirectory, the label CW also indicates a Clarke-Wright 

FORTRAN file which computes the routes for a given depot in the geographic 

region as delineated by the minimum-spanning-forest output.  As before, a 

.FOR extension contains the code itself; a .EXE contains the executable code; 

a .DAT file denotes input; and a .OUT file contains output.  For example:



	Program file    - cw.for

	Executable code - cw.exe

	Input file      - cw12.dat

	Output file     - cw12.out



As mentioned, the compiled source-code or the executable code must be run to 

produce the output file.  At the prompt, type in "cw" to run the executable, 

then enter the name of the data file, "cw12.dat," and then the name of the 

output file, "cw12.out."



Note:  The number immediately following the alphabetical prefix denotes which 

geographic region of the continental United States the file refers to. All 

files within a subdirectory share this number. The second number refers to 

the number of depots considered in the run. Hence the file 'CW12.FOR' refers 

to a Clarke-Wright FORTRAN file for a two-depot model in region 1.

