Return to news CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / apl / lib

Annotation of 43BSD/contrib/apl/lib/news, revision 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

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