importGridstat: Import Gridstat data files.

Description Usage Arguments Value Note Author(s) References See Also Examples

View source: R/import.r

Description

Reads the file format that is used by the latest version of the grid program gridstat (Bell, 1998).

Usage

1

Arguments

file

Filename including path if file is not in current working directory. File can also be a complete URL. The fileformat is .dat. If no file is supplied a selection pop up menu is opened to select the files.

dir

Alternative way to supply the directory where the file is located (default NULL).

min

Optional argument (numeric, default NULL) for minimum rating value in grid.

max

Optional argument (numeric, default NULL) for maximum rating value in grid.

Value

A single repgrid object in case one file and a list of repgrid objects in case multiple files are imported.

Note

Note that the gridstat data format does not contain explicit information about the range of the rating scale used (minimum and maximum). By default the range is inferred by scanning the ratings and picking the minimal and maximal values as rating range. You can set the minimal and maximal value by hand using the min and max arguments or by using the setScale() function. Note that if the rating range is not set, it may cause several functions to not work properly. A warning will be issued if the range is not set explicitly when using the importing function.

The function only reads data from the latest GridStat version. The latest version allows the seperation of the left and right pole by using on of the following symbols /:- (hyphene, colon and dash). Older versions may not seperate the left and right pole. This will cause all labels to be assigned to the left pole only when importing. You may fix this by simply entering one of the construct seperator symbols into the GridStat file between each left and right construct pole.

The third line of a GridStat file may contain a no labels statement (i.e. a line containing any string of 'NOLA', 'NO L', 'NoLa', 'No L', 'Nola', 'No l', 'nola' or 'no l'). In this case only ratings are supplied, hence, default names are assigned to elements and constructs.

Author(s)

Mark Heckmann

References

Bell, R. C. (1998) GRIDSTAT: A program for analysing the data of a repertory grid. Melbourne: Author.

See Also

importGridcor, importGridstat, importScivesco, importGridsuite, importTxt, importExcel

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
## Not run: 

# using the pop-up selection menu
rg <- importGridstat()

# supposing that the data file gridstat.dat is in the current working directory
file <- "gridstat.dat"
rg <- importGridstat(file)

# specifying a directory (example)
dir <- "/Users/markheckmann/data"
rg <- importGridstat(file, dir)

# using a full path (example)
rg <- importGridstat("/Users/markheckmann/data/gridstat.dat")

# load gridstat data from URL
rg <- importGridstat("http://www.openrepgrid.uni-bremen.de/data/gridstat.dat")

# setting rating scale range
rg <- importGridstat(file, dir, min=1, max=6)

## End(Not run)

markheckmann/OpenRepGrid documentation built on April 30, 2021, 2:33 a.m.