73-29-10
DOCUMENTATION OUTLAY 
A)GENERAL
OUTLAY IS USED TO CREATE DATA FILES FOR USE BY THE STATISTICAL
PACKAGE
C)INDATA AND FILES

OUTLAY ACCEPTS AS INDATA AN UNFORMATED STREAM OF NUMBERS AND CONVERTS 
THESE INTO A FORMATED FILE USABLE BY FORTRAN PROGRAMS
OUTLAY CAN ALSO ACCEPT AN FORMATED FILE AS INPUT AND ADD ON TO 
THIS FILE OR ALLOW YOU TO DO CORRECTIONS IN THE FILE
FILE FORMAT:
A) GENERAL
THE FILE CONSISTS OF 2 PARTS 1)A NUMBER OF HEADINGS FOR THE MATERIAL
AND 2) THE ACTUAL DATA
THE DATA CAN BE ORGANISED IN UP TO 3 COLUMNS(EG TIME AND MEASUREMENTS)
THE DATA CAN ALSO BE DIVIDED INTO A NUMBER OF GROUPS(UP TO 100)
AND THE PROGRAMS WILL USE THESE GROUP NUMBERS WHEN READING THE DATA FILE.
ASSOCIATED WITH EACH GROUP NUMBER IS A HEADING DESCRIBING THAT GROUP
AND THE PROGRAM ALSO PROVIDES FOR 1 MAIN HEADING FOR THE WHOLE MATERIAL
 THE FILE UNITS ARE:
NUMBER 5 <MUST ALWAYS BE DEFINED !!!> OUTPUT FILE FOR DATA
NUMBERS 6-9 CAN BE USED FOR ANY OF THE POSSIBLE TYPES OF INPUT:
	HEADINGS,FORMATED DATA<INCLUDING HEADINGS>,OR
	UNFORMATED DATA
D)THE DATA FILE FORMAT
FOR THOSE THAT CREATE A DATA FILE OUT OF OUTLAY THE FORMAT IS
CARD NO		CONTAINS
1		NR GROUPS NR COLUMNS (2I3)
2		MAIN HEADING(3A6)
3-NK+2		1 HEADING FOR EACH OF NK GROUPS
NK+3..		DATA IN FORMAT I3,7(E11.4)
LAST CARD	BLANK

E)RUNNING OUTLAY
OUTLAY IS RUN BY:
.R FRTS
*OUTLAY
*FILES  SEE FILES ABOVE
*$	ALTMODE TO START PROGRAM

GENERAL F4 DATA INPUT RULES APPLY
INPUT DATA IS IN THE FORMAT
G,X1,X2,X3	WITH G BEING THE GROUPNUMBER AND X1..XNT THE DATA
THE PROGRAM FIRST ASKS FOR THE POSSIBILITY OF TAKING THE HEADINGS AND
GROUP NUMBERS FROM AN EXISTING FILE
IF YOU HAVE MANY GROUPS YOU ARE ADVICED TO PUT THE HEADINGS IN A FILE BY
AN EDITOR BEFORE RUNNING OUTLAY.
	IF YOU DO NOT HAVE A FILE THE PROGRAM REQUESTS NUMBERS
OF GROUPS AND COL(2I3) DIRECTLY FOLLOWED BY NK+1 HEADINGS ON SEPERATE LINES

ON 'WAIT' THE PROGRAM DOES EITHER DIRECTORY OR FILE WORK WAIT UNTIL
IT REQUESTS MORE INPUT
THE PROGRAM ASKS FOR A POSSIBLE INPUT FILE. IF YOU HAVE NONE GO TO
NEXT PARAGRAPH.THE INPUT FILE MUST BE A PROPERLY FORMATED OUTLAY FILE
AFTER READING THE FILE(OR ON FULL BUFFER SEE ERRORS). THE PROGRAM ASKS
FOR ANY ERROR CORRECTIONS (SEE ERROR RUTINE BELOW).AFTER ERROR CORRECTIONS
THE PROGRAMS ASKS FOR A POSSIBLE LISTING,(SEE LISTING BELOW) AND THEN WRITES
THE DATA TO THE FILE.THE PROGRAM THEN REPEATS THE QUESTION 'INPUT FILE'
UNTIL IT IS ANSWERED BY NO

NO INPUT FILE<OR ALL INPUT FILES READ>
THE PROGRAM NOW ASKS FOR UNFORMATED INPUT
THIS CAN BE FROM THE CONSOL OR FROM A FILE<EG AN EDITOR PREPARED DATA FILE>
IN THE LATER CASE THE PROGRAM WILL ASK FOR FILE UNIT NUMBER AND NAME
THE INPUT DATA MUST AS ITS FIRST ELEMENT HAVE THE GROUP NUMBER AND THEN
NK DATA
THE END OF INPUT DATA<THIS BLOCK>IS SIGNALLED BY A ZERO GROUP NUMBER
BEST GENERATED BY A BLANK LINE
THE PROGRAM THEN GOES TO THE ERROR CORRECTION RUTINE:
ERROR CORRECTION
IF YOU HAVE ERRORS IN THE INPUT ANSWER THE ERROR QUESTION WITH 1
THEN INPUT LINE,GROUP NR,DATA 
FOR EACH LINE THAT THERE IS ERROR IN
END OF CORRECTION IS SIGNALLED AS FOR END OF INPUT DATA
LIST
AFTER END OF CORRECTIONS THE PROGRAM ASKS FOR LISTING
LISTING CAN BE REQUESTED IN 2 WAYS
1) BY SIMPLY ANSWERING 1
THE WHOLE BUFFER I LISTED IN G12.4 FORMAT TO THE LINE PRINTER
	IN THIS AND THE NEXT LIST LINE NUMBER
	AND GROUPNUMBER APPEAR BEFORE THE DATA
	THE LINE NUMBER IS USED FOR ERROR CORRECTIONS
2)BY STATING L,U
WHERE L IS LOWEST LINE NR TO LIST AND U IS UPERMOST
IF THE REQUEST IS FOR LESS THAN 4 LINES THEY ARE PUT TO THE TELETYPE
OTHERWAYS TO THE LINE PRINTER
THE PROGRAM ITERATES THE QUESTIONS:
LIST
ANY ERRORS
UNTIL THE LAST IS ANSWERED WITH NO. IT THEN WRITES THE DATA TO THE OUTPUT
FILE
THE QUESTION MORE INPUT IS ASKED UNTIL ANSWERED BY NO WHEN THE PROGRAM 
EXITS
F)CAPACITIES
KOLUMNS MAX 10
GROUPS MAX 100
ROWS IN CORE MAX 100 THE CURRENT BUFFER MUST BE EDITED AND LISTED
AND WRITTEN OUT BEFORE MORE CAN BE ENTERED
G)ERROR HANLING
1)TOO MUCH DATA 'BUFFER FULL' AND EDIT THIS DATA
2)INPUT GROUP NR>NG'WRONG'***
3)NON-INTEGER GROUP NUMBER(NORMALLY = MISSING GR NR)
	WRONG
IF READING FROM A FILE THE ERRONOUS LINE IS PRINTED
4)INPUT FILE CONTAINS MORE GROUPS OR COL THAN PRESENT
		EXCESSIVE IGNORED
H)LOADING
COMPILE STANDARD F4
REQUIRES 12 K