importTxtInternal | R Documentation |
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.
importTxtInternal(file, dir = NULL, min = NULL, max = NULL)
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 ( |
---------------- .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.
List of relevant data.
## 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)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.