read_kspace.Rd
Read a knowledge space from a file. The file formats are described in the kstIO-package information page.
read_kspace(filename, format = "auto", as.letters = TRUE, close = FALSE)
filename | A character string specifying the name of the space file. |
---|---|
format | Specification of the files format. Can be "SRBT", "KST", "matrix", or "auto" (default). |
as.letters | logical, should the elements of the sets be letters or numbers? |
close | logical, determines whether a closure under union is performed on the read structure. |
The format
values "SRBT"
, "KST"
, and
"matrix"
refer to the different generations of file formats
described in kstIO-package. The value "auto"
(default)
requests an automatic detection of the format by thje read_XXX
function.
If as.letters
is TRUE
the elements of the sets are letters,
otherwise numbers.
If close
is TRUE
, a closure under union is computed to ensure
that the returned knowledge space really is one.
A list with the following elements:
the read structure/data as binary matrix
the read structure as kspace
.
Hockemeyer, C. (2001). KST Tools User Manual (2nd ed.). https://kst.hockemeyer.at/techreports/KST-Tools_TechRep_FWF01.pdf.
Poetzi, S. \& Wesiak, G. (2001). SRbT Tools User Manual. https://kst.hockemeyer.at/techreports/SRBT-Tools_TechRep_FWF01.pdf
In automatic format detection, the distinction between "matrix"
and "KST"
formats work somewhat heuristic. In other words, in rare
cases the automatic detection might give the wrong result.
Cord Hockemeyer cord.hockemeyer@uni-graz.at
space_property
,
kstIO-package
# Produce a space file library(kst) d <- getwd() setwd(tempdir()) data(DoignonFalmagne7) ksp <- kspace(kstructure(as.pattern(DoignonFalmagne7$K, as.set=TRUE))) write_kspace(ksp, "DF7.spc") # Write in (default) SRBT format # Read file read_kspace("DF7.spc") # Automatic format detection (default)#> $matrix #> a b c d e #> [1,] 0 0 0 0 0 #> [2,] 1 0 0 0 0 #> [3,] 0 1 0 0 0 #> [4,] 1 1 0 0 0 #> [5,] 1 1 1 0 0 #> [6,] 1 1 0 1 0 #> [7,] 1 1 1 1 0 #> [8,] 1 1 1 0 1 #> [9,] 1 1 1 1 1 #> #> $sets #> {{}, {"a"}, {"b"}, {"a", "b"}, {"a", "b", "c"}, {"a", "b", "d"}, {"a", #> "b", "c", "d"}, {"a", "b", "c", "e"}, {"a", "b", "c", "d", "e"}} #>read_kspace("DF7.spc", "SRBT") # Explicit format specification#> $matrix #> a b c d e #> [1,] 0 0 0 0 0 #> [2,] 1 0 0 0 0 #> [3,] 0 1 0 0 0 #> [4,] 1 1 0 0 0 #> [5,] 1 1 1 0 0 #> [6,] 1 1 0 1 0 #> [7,] 1 1 1 1 0 #> [8,] 1 1 1 0 1 #> [9,] 1 1 1 1 1 #> #> $sets #> {{}, {"a"}, {"b"}, {"a", "b"}, {"a", "b", "c"}, {"a", "b", "d"}, {"a", #> "b", "c", "d"}, {"a", "b", "c", "e"}, {"a", "b", "c", "d", "e"}} #>