importTxtInternal: ImportTxtInternal is the parser for importTxt.
In markheckmann/OpenRepGrid: Tools to Analyze Repertory Grid Data
importTxtInternal R Documentation
ImportTxtInternal is the parser for importTxt.
Description
ImportTxtInternal is the parser for importTxt that constructs an import object. The .txt file has to be in a fixed
format. There are three mandatory blocks each starting and ending with a predefined tag in uppercase letters. The
first block starts with ELEMENTS and ends with END ELEMENTS and contains one element in each line. The other
mandatory blocks contain the constructs and ratings (see below). In the block containing the constructs the left and
right pole are separated by a colon (:). To define missing values use NA like in the example below. One optional
block contains the range of the rating scale used defined by two numbers. The order of the blocks is arbitrary. All
text not contained within the blocks is discarded and can thus be used for comments.
Usage
importTxtInternal(file, dir = NULL, min = NULL, max = NULL)
Arguments
file
Filename including path if file is not in current working
directory. File can also be a complete URL. The fileformat
is .txt.
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.
Details
---------------- .txt file -----------------
anything not contained within the tags will be discarded
ELEMENTS
element 1
element 2
element 3
END ELEMENTS
CONSTRUCTS
left pole 1 : right pole 1
left pole 2 : right pole 2
left pole 3 : right pole 3
left pole 4 : right pole 4
END CONSTRUCTS
RATINGS
1 3 2
4 1 1
1 4 4
3 1 1
END RATINGS
RANGE
1 4
END RANGE
---------------- end of file ----------------
Note that the maximum and minimum value has to be defined using the min and
max arguments if no RANGE block is contained in the data file.
Otherwise the scaling range is inferred from the available data and a warning
is issued as the range may be erroneous. This may effect other functions that
depend on knowing the correct range and it is thus strongly recommended to
set the scale range correctly.
Question marks (?) in the ratings are treated as missing data.
Value
List of relevant data.
Examples
## Not run:
# supposing that the data file sample.txt is in the current directory
file <- "sample.txt"
imp <- importTxtInternal(file)
# specifying a directory (arbitrary example directory)
dir <- "/Users/markheckmann/data"
imp <- importTxtInternal(file, dir)
# using a full path
imp <- importTxtInternal("/Users/markheckmann/data/sample.txt")
## End(Not run)
markheckmann/OpenRepGrid documentation built on April 14, 2024, 8:15 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| importTxtInternal | R Documentation |
ImportTxtInternal is the parser for importTxt.
Description
ImportTxtInternal is the parser for importTxt that constructs an import object. The .txt file has to be in a fixed
format. There are three mandatory blocks each starting and ending with a predefined tag in uppercase letters. The
first block starts with ELEMENTS and ends with END ELEMENTS and contains one element in each line. The other
mandatory blocks contain the constructs and ratings (see below). In the block containing the constructs the left and
right pole are separated by a colon (:). To define missing values use NA like in the example below. One optional
block contains the range of the rating scale used defined by two numbers. The order of the blocks is arbitrary. All
text not contained within the blocks is discarded and can thus be used for comments.
Usage
importTxtInternal(file, dir = NULL, min = NULL, max = NULL)
Arguments
file |
Filename including path if file is not in current working
directory. File can also be a complete URL. The fileformat
is |
dir |
Alternative way to supply the directory where the file is located
(default |
min |
Optional argument ( |
max |
Optional argument ( |
Details
---------------- .txt file ----------------- |
anything not contained within the tags will be discarded |
ELEMENTS |
element 1 |
element 2 |
element 3 |
END ELEMENTS |
CONSTRUCTS |
left pole 1 : right pole 1 |
left pole 2 : right pole 2 |
left pole 3 : right pole 3 |
left pole 4 : right pole 4 |
END CONSTRUCTS |
RATINGS |
1 3 2 |
4 1 1 |
1 4 4 |
3 1 1 |
END RATINGS |
RANGE |
1 4 |
END RANGE |
---------------- end of file ---------------- |
Note that the maximum and minimum value has to be defined using the min and
max arguments if no RANGE block is contained in the data file.
Otherwise the scaling range is inferred from the available data and a warning
is issued as the range may be erroneous. This may effect other functions that
depend on knowing the correct range and it is thus strongly recommended to
set the scale range correctly.
Question marks (?) in the ratings are treated as missing data.
Value
List of relevant data.
Examples
## Not run:
# supposing that the data file sample.txt is in the current directory
file <- "sample.txt"
imp <- importTxtInternal(file)
# specifying a directory (arbitrary example directory)
dir <- "/Users/markheckmann/data"
imp <- importTxtInternal(file, dir)
# using a full path
imp <- importTxtInternal("/Users/markheckmann/data/sample.txt")
## End(Not run)
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.