.TITLE GRAPH1 AND GRAPH2 USER GUIDE (PART 1)
.PAGE SIZE 66,70
.COMMENT GUIDE BY A.E.LAWRENCE, PUT ONTO SYSTEM AND EDITED BY R.J.H
^&GRAPH1 AND GRAPH2 USER GUIDE\&
.SKIP 1
^&PART 1 BRIEF GUIDE\&
.SKIP 3
.NO FILL
AUTHOR:         A.E.LAWRENCE
DATE:           OCTOBER 1976
ORIGIN:         LUTON COLLEGE OF HIGHER EDUCATION PHYSICS SECTION
SYSTEM:         PDP 11/40 RSTS/E OPERATING SYSTEM
.SKIP 3
.FILL
.PARAGRAPH 5
THE 'GRAPH' PROGRAMS WILL ACCEPT RAW EXPERIMENTAL DATA, CARRY OUT
AND REPORT ALL INTERMEDIATE CALCULATIONS, AND PLOT THE RESULTS.
IN THE CASE OF GRAPH1, A BEST FIT STRAIGHT LINE (LEAST SQUARES) IS
CALCULATED, REPORTED AND PLOTTED WITH THE DATA.
.PARAGRAPH 5
THIS IS A BRIEF GUIDE; IT DESCRIBES A SINGLE SIMPLE OPTION. THE
'GRAPH' PROGRAMS ARE FAIRLY SOPHISTICATED AND INCLUDE MANY OPTIONS
AND FACILITIES NOT DESCRIBED IN THIS GUIDE. THE COMPANION ADVANCED
GUIDE GIVES FURTHER DETAILS.
.SKIP 3
.CENTER
^&INDEX\&
.NO FILL

        1.1     RUNNING GRAPH1 AND GRAPH2               PAGE 2
        1.2     DOCUMENTATION                           PAGE 4 
.PAGE
^&1.1 RUNNING GRAPH1 AND GRAPH2\&

^&I)\&
TO RUN THE PROGRAMS TYPE:

        RUN $GRAPH1 )
OR
        RUN $GRAPH2 )

AS APPROPRIATE, WHERE ')' MEANS PRESS THE RETURN KEY.


^&II)\&
AFTER A SHORT DELAY, THE COMPUTER REPLIES WITH A TITLE LINE
FOLLOWED BY:
.NO FLAGS UNDERLINE

        PLOT OF Y AGAINST X. PLEASE GIVE X AS A FUNCTION OF U,V,W & H
.FLAGS UNDERLINE
        X=?


.FILL
^&III)\&
.BREAK
THE USER NOW REPLIES WITH AN EXPRESSION FOR THE QUANTITY TO BE
PLOTTED ALONG THE X-AXIS IN TERMS OF U,V,W AND H.
.PARAGRAPH 5
FOR EXAMPLE, IF AN EXPERIMENT YIELDS RESULTS OF TEMPERATURE AND
LENGTH, AND IT IS DESIRED TO PLOT THE SQUARE OF THE LENGTH AGAINST
THE SQUARE-ROOT OF THE TEMPERATURE, THEN:
.NO FILL

.NO FILL
A) SELECT THE LETTER TO REPRESENT LENGTH
        (WE CHOOSE 'H' HERE).

B) SELECT ANOTHER LETTER TO REPRESENT THE TEMPERATURE
        (LET'S HAVE 'U').

C) DECIDE WHICH QUANTITY IS TO APPEAR ON THE X-AXIS
        (SQUARE ROOT OF TEMPERATURE IN THIS CASE).

.NO FLAGS UPPERCASE
D) CHOOSE THE QUANTITY FOR THE Y-AXIS
        (LENGTH SQUARED, H^2 OR H*H HERE).
.FLAGS UPPERCASE

IN THIS CASE THEN THE USER REPLIES:

        SQR(U)


^&IV)\&
THE COMPUTER CONTINUES:

        X=? SQR(U)  )
.NO FLAGS UNDERLINE
        AND Y AS A FUNCTION OF U,V,W & H.
.FLAGS UNDERLINE
        Y=?
.PAGE
^&V)\&
THE USER NOW REPLIES WITH THE CORRESPONDING EXPRESSION FOR Y.
IN THE EXAMPLE ABOVE:

        Y=? H*H  )

.FILL
THE COMPUTER WILL NOW REWRITE THE PROGRAM TO INCORPORATE THE
PARTICULAR X AND Y EXPRESSIONS THAT YOU HAVE SELECTED. IT WILL NEXT
OFFER YOU THE OPTION OF SEEING THE CALCULATED RESULTS AS THEY ARE
ENTERED. (IF YOU WISH TO SEE THE VALUE OF LENGTH SQUARED (Y)
AND OF THE SQUARE ROOT OF TEMPERATURE (X) AS THE VALUES OF LENGTH AND
TEMPERATURE ARE ENTERED, REPLY 'Y'.)
.NO FILL

        DO YOU WISH TO SEE X AND Y AS THEY ARE 
                                        CALCULATED (Y OR N)? Y )

.FILL
^&VI)\&
.BREAK
GRAPH2 INCLUDES AN OPTION TO DENOTE THE PLOTTED POINTS BY AN
ARBITRARY SYMBOL. IF YOU CHOOSE THE STANDARD "*", REPLY 'Y' TO THE
QUESTION:
.NO FILL

        DO YOU WANT ALL POINTS INDICATED BY '*' (Y OR N)? Y )



.FILL
^&VII)\&
.BREAK
THE PROGRAM IS NOW READY TO ACCEPT YOUR READINGS (OF TEMPERATURE
AND LENGTH IN THIS EXAMPLE):
.NO FILL

        RIGHT, PLEASE GIVE YOUR READINGS NOW. AFTER THE LAST
        READING, TYPE 'END'.

.FILL
THE COMPUTER NEXT TYPES A PROMPT IN AN EXACT IMAGE OF THE WAY THAT
THE DATA SHOULD BE ENTERED.
.NO FILL
IN OUR EXAMPLE:

        U,H
        ?

THE USER REPLIES WITH A VALUE OF U (TEMPERATURE HERE), A COMMA,
AND A VALUE OF H (LENGTH), FOLLOWED BY <RETURN> OF COURSE. E.G.

        U,H
        ? 64.2,18.1 )

THE CALCULATED VALUES OF X AND Y ARE IMMEDIATELY REPORTED IF YOU
HAVE SELECTED THIS OPTION, AND THE COMPUTER REQUESTS THE NEXT SET
OF VALUES BY TYPING:

        *?

CONTINUE IN THIS WAY UNTIL ALL THE DATA IS ENTERED, AND THEN TYPE


        *? END )
.PAGE
.FILL
^&VIII)\&
.BREAK
 THE PROGRAM THEN OFFERS THE OPTION TO VIEW THE COMPLETE SET
OF CALCULATED VALUES, AND IS THEN READY TO PLOT THE GRAPH:
(GRAPH1 REPORTS THE BEST STRAIGHT LINE).
.NO FILL

.NO FLAGS UNDERLINE
        READY TO PLOT.
        TYPE P & SET ANY SWITCHES IF YOU WANT THE GRAPH NOW.
.FLAGS UNDERLINE
        TO CORRECT OR ADD EXTRA POINTS, TYPE
        MORE?

.FILL
IN THIS BRIEF GUIDE ,WE DESCRIBE ONLY THE STANDARD (DEFAULT) OPTION:
TYPE 'P' (OR THE WHOLE WORD 'PLOT').
.PARAGRAPH 5
THE COMPUTER RESPONDS BY OFFERING YOU THE OPTION OF LABELLING
THE AXES; IN THIS EXAMPLE, THE OPTION IS ACCEPTED (JUST REPLY
<RETURN> TO OMIT THE LABELS):

.NO FILL

        X-AXIS LABEL? SQUARE ROOT OF TEMPERATURE )
        AND Y-AXIS LABEL? LENGTH (METRES) SQUARED )



.FILL
^&IX)\&
.BREAK
THE COMPUTER NOW TYPES OUT A STANDARD (DEFAULT) SIZE AND FORMAT
GRAPH OF THE RESULTS. FINALLY:
.NO FILL

        TYPE 'MORE' IF YOU WANT ANOTHER PLOT WITH
.NO FLAGS UNDERLINE
                                THE SAME FUNCTIONS X & Y ?
.FLAGS UNDERLINE

IS PRINTED. TO TERMINATE THE PROGRAM, TYPE 'NO' (OR JUST <RETURN>).
.FILL
.SKIP 3
^&1.2 DOCUMENTATION\&
.PARAGRAPH 5
1) THIS BRIEF GUIDE - BARE DETAILS.
.PARAGRAPH 5
2) USER GUIDE - ADVANCED. THIS IS AIMED AT EXPERIENCED USERS AND
GIVES FULL DETAILS OF THE NUMEROUS SWITCHES, DUPLICATE OUTPUTS,
BRIEF OPTIONS AND FILE HANDLING (RECORD I/O AND ASCII)
FACILITIES PROVIDED BY THE PROGRAMS. IT ALSO DESCRIBES DATA
INTERCHANGE BETWEEN GRAPH1 AND GRAPH2 AND OTHER PROGRAMS, AND ALSO
THE ASSOCIATED PROGRAMS 'LSQUAD' AND 'LOOK'. IN ADDITION IT DESCRIBES FU
NCTION
PLOTTING WITH THE PROGRAMS.
.PARAGRAPH 5
3) STUDENT GUIDE - THIS IS A PHYSICS SECTION GUIDE EXPLAINING BOTH THE
SIMPLE AND ADVANCED FEATURES FOR THE LESS EXPERIENCED USER. IT
INCLUDES SEVERAL SAMPLE RUNS, AND INCLUDES COMPREHENSIVE INSTRUCTIONS.
#