read.srs: Read student records

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/read.srs.R

Description

Read student records

Usage

1
read.srs(file="fake.dat", debug=FALSE, silent=FALSE, year.start=0)

Arguments

file

A connection or a character string giving the name of the file to load.

debug

Set true to print debugging information.

silent

Set TRUE for this to print nothing.

year.start

Lets you skip some of the record.

Details

A sample input file appears below. Students are separated by lines containing 4 dashes. Where you see leading white-space below, use a single tab character. The srs library is very picky about the headings, and they must appear exactly as shown; for example, if you write Papers Published (with the use of an upper-case character to start the second word), then read.srs will fail.

Items in the “Grades” section are comma-separated, and course names (the fourth item) are optional. Actually, all that really matters is the third column, which is a grade in letter form (assumed out of A+); in a rush, just put x for the course number and the year, e.g. a minimal grade entry is x,x,A.

Make sure to put each paper or presentation on a line by itself, or the count will be wrong. (Don't let your editor wrap the lines!)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Student
	Rex, Elizabeth
Program
	MSc
Months
	20
Scholarships
	Regal 2000
	Regal 2001
Presentations
	How we shall be addressed
Papers published
	Call me princess
Papers submitted
	One nice paper
	And another one
Papers in press
	Call me queen
Papers in preparation
	But just call me
Grades
	OCEA0001,2000,B,Life is grand
	OCEA0002,2000,B,and so are some pianos
	OCEA0003,2000,B+
	OCEA0004,2001,B+
----

The line of (4 or more) minus signs ends the student record. If there there are other students, just add them after this line.

It makes sense to use a consistent scheme for the various fields, e.g. perhaps scholarships should only include national scholarships, or awards over 2000 dollars.

For an example of a two-student file, do the following

1
2

Value

An srs object containing information about students.

Author(s)

Dan Kelley [email protected]

See Also

summary.srs, plot.srs, write.srs

Examples

1
2
3

dankelley/srs documentation built on May 12, 2017, 4:46 p.m.