File OUTLAY.CO

Directory of image this file is from
This file as a plain text file

	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



Feel free to contact me, David Gesswein djg@pdp8online.com with any questions, comments on the web site, or if you have related equipment, documentation, software etc. you are willing to part with.  I am interested in anything PDP-8 related, computers, peripherals used with them, DEC or third party, or documentation. 

PDP-8 Home Page   PDP-8 Site Map   PDP-8 Site Search