Annotation of 43BSD/contrib/apl/lib/news, revision 1.1.1.1

1.1       root        1: n��*.KB�&       H&newU&& cA&A&this workspace contains information concerning
                      2: recent changes to apl and the contents of the apl
                      3: library.
                      4: 
                      5: for available workspaces type ws, for available
                      6: functions type fn.
                      7: 
                      8: for differences between unix apl and ibm apl type aplx
                      9: 
                     10: if you wish to add programs or workspaces to the 
                     11: library 'mail reeves' with the details.
                     12: &Llx&new&ws�&s.}}the following workspaces are currently available
                     13: 
                     14: fftws:  the fft algorithm in apl
                     15: graphws:  a graph plotting system (results are displayed
                     16:        on the terminal). see 'reeves' for documentation.
                     17: plotws: a graph plotting system which uses a different
                     18:         format to graphws.
                     19: anovaws: anova statistical analysis, accepts missing data
                     20: gradesys: a system for  maintaining and analysing the grades
                     21:        given in a course.   type 'dgradesys' for details
                     22: ngradesys: a newer more convenient version of gradesys
                     23: aw:    an alpha-omega notation form compiler.
                     24: AW:    alternate name for the 'aw' workspace
                     25: iows:   some io functions for dealing with interprocess
                     26:         communication.
                     27: editws: a unix type editor for apl
                     28: shapews: fnctions for changing a list of names into
                     29:         a 2 dimensional array
                     30: 
                     31:  to load a workspace type ')load workspace-name'
                     32:  further details for each workspace are contained
                     33:  within them
                     34: 
                     35: &fnK&di77the following general purpose functions are available
                     36: in raw function form.
                     37: 
                     38: time:  finds the cpu time needed to execute a function
                     39: ttime: prints the total amount of cpu time used
                     40: vread: reads a unix file into a 1 dimensional apl character
                     41:        variable (use Lfloat as well to read numeric data)
                     42: vwrite: write a variable into a unix file
                     43: vrd:   reads a unix file into a two dimensional apl 
                     44:        character matrix
                     45: vap:   writes a two dimensional apl character matrix into
                     46:        a unix file.(padding spaces are also output)
                     47: vrnum: reads a character file of numbers generated by a
                     48:        fortran/c/pascal program .  a numeric
                     49:        vector containing all the numbers in the file
                     50:        is returned.
                     51: dstat: computes some simple statistics on a vector of
                     52:        numbers.
                     53: dft:   a full dyadic format function
                     54: eft:   a format function for exponential output
                     55: det:   compute the determinant of a matrix
                     56: edtxt: edit a variable using xed.(data format is with embeded
                     57:        newline characters like this variable.)
                     58: 
                     59: to load any of these functions into the current workspace
                     60: type')read fn/functionname'
                     61: &
                     62: dgradesys�&Re��    apl score system
                     63: 
                     64:                A. P. Reeves            fall 1978
                     65: 
                     66:   An apl workspace is available which is designed to maintain
                     67: an perform anaysis on a set of class grades.   The system is
                     68: interactive in nature alowing each user to select the set of
                     69: functions suitable for his or her needs.
                     70: 
                     71:     To obtain a fresh copy of this system, type ')load gradesys'
                     72: after entering apl.
                     73: 
                     74: Setting up for a new set of grades:  two functions are used to
                     75: initialize the system for a new class, these are
                     76: 
                     77: setup  Type 'setup' then you will be prompted for  a set of grade
                     78:        types, e.g. test ,quiz... .Enter each type on a new line and
                     79:        terminate with a null line.  Then you will be promted for each
                     80:        weight to be assigned to each grade type,(these may be changed
                     81:        at a later date).
                     82: 
                     83: readnames 'file'       The names of the students must be input.  Use
                     84:        the UNIX editor to create a list of names using a new line for
                     85:        each name (the system will only use the first 8 characters of
                     86:        each name). Then use 'readnames' to read this file in. Note,
                     87:        the name of the file should be enclosed in quotes.
                     88: 
                     89: The system is now setup.   save a copy of this setup workspace by typing
                     90: ')save xxx' The workspace will be saved in the file xxx and may be 
                     91: loaded in the future with the load command.  It is advisable to keep
                     92: several backup copies of an active grade workspace.
                     93: 
                     94: 
                     95: Entering a new set of grades:
                     96: 
                     97: newscore       Type 'newscore' and you will be prompted for the grade
                     98:        type and the maximum possible score.  You will then be prompted
                     99:        for a grade for each student.
                    100: 
                    101: Adding and dropping students:
                    102: 
                    103: newname                To add a new students to an existing system type 'newname'
                    104:        You will then be prompted for a list of names.   Enter each on
                    105:        a new line and then terminate the list with a null line.   Note,
                    106:        any old scores for these new students must be inserted with the
                    107:        'update'  function.
                    108: 
                    109: drop           To drop students from an existing system type 'drop'.
                    110:        You will the be prompted for a set of student id's .The scores
                    111:        to date for these students will be printed and confirmation
                    112:        will be requested before the deletion occurs.
                    113: 
                    114: Summary and analysis:
                    115: 
                    116: scoresummary   This function prints out all the raw scores for all
                    117:        grades.
                    118: 
                    119: statsummary    the function 'statsummary' computes simple statistics
                    120:        on each set of scores and prints out the results.
                    121: 
                    122: analysis       The function 'analysis' prints two outputs.   First
                    123:        the average percent grade for each grade type for each student
                    124:        is computed and also a total percentage grade based on  the
                    125:        weights for the course is calculated and printed.   Then
                    126:        a ranking printout is generated.   Students are listed in order
                    127:        of their rank of the total and their ranking for each grade type
                    128:        is also listed.
                    129: 
                    130: analstats      This function prints simple statistics on the data
                    131:        generated by the first part of 'analysis'.   The function
                    132:        'analysis' must be run before this function can be used.
                    133: 
                    134: 
                    135: printstat 'grades'     Printstat will print simple statistics for
                    136:        a selected set of grades.   The parameter 'grades' should
                    137:        be one of the grade names listed in the score summary
                    138:        headings, or if analysis has been run then one of the grade
                    139:        types may be selected.
                    140: 
                    141: printhist 'grades'     This function prints a histogram of the
                    142:        selected data.  Its parameter is similar in range to the 
                    143:        parameter for 'printstat'.
                    144: 
                    145: printstat0             This function is similar to printstat
                    146:        except that all 0 scores are first discarded.
                    147: 
                    148: printhist0             This function is similar to printhist
                    149:        except that all 0 scores are discarded.
                    150: 
                    151: changing grades:
                    152: 
                    153: 'name' change 'scoretype'      The function change enables individual
                    154:        scores to be changed.  Type the students name (within quotes)
                    155:        then change and then the score type (within quotes).   You will
                    156:        then be prompted for a new grade.   If no new grade is required
                    157:        give a negative grade and the change command will be ignored.
                    158: 
                    159: limitations:
                    160: 
                    161: 1)   names are usually limited to 8 characters or less.
                    162: 2)   the histogram assumes a scale of up to 100 points.
                    163: 3)   Three digit scores and fractional scores upset the
                    164:      printing format of 'scoresummary'.
                    165: edtxt edtxt;fd;name;vr;r
                    166: L'{'variable name? '
                    167: name { L'
                    168: fd { 390 Lcreat 'apltxt.tmp'
                    169: }(fd < 0)/error
                    170: r  { fd Lwrite BJ name
                    171: fd { Lclose fd
                    172: Lrun 'xed apltxt.tmp'
                    173: fd { 260 Lopen 'apltxt.tmp'
                    174: }(fd<0)/error
                    175: vr { ''
                    176: more: vr { vr,r { fd Lread 256
                    177: } (0#Rr)/more
                    178: fd { Lclose fd
                    179: r { BJ name,' { vr'
                    180: Lrun 'rm apltxt.tmp'
                    181: }0
                    182: error: 'Can''t open file: apltxt.tmp'
                    183: &aplx�&esvv  
                    184: laminate is not supported
                    185: inner product and outer product does not work with
                    186:   character data (convert args to numeric )
                    187: a local variable may not have the same name as a function
                    188: Lio is not supported (but see dyadic i-beam 29)
                    189: dyadic format does not accept a single element right arg
                    190: dyadic format does not generate exponetial format output
                    191:   (but see fn/eft)
                    192: dyadic format left arg rank must not exceed 2
                    193: many quad functions are implemented as i-beams
                    194: 
                    195: ***extensions***
                    196: index origin may be set to any value
                    197: catenation of mixed data types converts the type of 
                    198:   the right argument.
                    199: execute will accept a matrix right argument

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.