importGridstat: Import Gridstat data files.
In OpenRepGrid: Tools to analyse repertory grid data

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

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

1	importGridstat(file, dir, min, max)

`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.

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

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.

Mark Heckmann

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

importGridcor, importGridstat, importScivesco, importGridsuite, importTxt

## 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)