easySdcTable (version 0.3.1)

ProtectTable1: Easy input interface to sdcTable

Description

protectTable or protectLinkedTables is run with a data set at the only required input.

Usage

ProtectTable1(data, dimVarInd = 1:NCOL(data), freqVarInd = NULL,
  protectZeros = TRUE, maxN = 3, method = "SIMPLEHEURISTIC",
  findLinked = TRUE, total = "Total", addName = FALSE, sep = ".",
  removeZeros = FALSE, groupVarInd = NULL, ind1 = NULL, ind2 = NULL,
  dimDataReturn = FALSE, IncProgress = IncDefault, ...)

Arguments

data

Matrix or data frame

dimVarInd

Column-indices of the main dimensional variables and additional aggregating variables.

freqVarInd

Column-indices of a variable holding counts or NULL in the case of micro data.

protectZeros

When TRUE empty cells (count=0) is considered sensitive (i.e. same as allowZeros in primarySuppression).

maxN

All cells having counts <= maxN are set as primary suppressed.

method

Parameter "method" in protectTable or protectLinkedTables. Alternatively a list defining parameters for running tau-argus (see ProtectTable).

findLinked

When TRUE, the function may find two linked tables and run protectLinkedTables.

total

String used to name totals.

addName

When TRUE the variable name is added to the level names, except for variables with most levels.

sep

A character string to separate when addName apply.

removeZeros

When TRUE, rows with zero count will be removed from the data.

groupVarInd

Possible manual specification if list defining the hierarchical variable groups

ind1

Coding of table 1 as indices referring to elements of groupVarInd

ind2

Coding of table 2 as indices referring to elements of groupVarInd

dimDataReturn

When TRUE a data frame containing the dimVarInd variables is retuned

IncProgress

A function to report progress (incProgress in Shiny).

...

Further parameters sent to protectTable, protectLinkedTables or createArgusInput.

Value

Output is a list of three elements.

table1 consists of the following elements:

secondary

Output from protectTable or first element of output from protectLinkedTables or output from runArgusBatchFile.

primary

Output from primarySuppression.

problem

Output from makeProblem.

dimList

Generated input to makeProblem.

ind

Indices referring to elements of groupVarInd in the output element common.

table2 consists of elements of the same type as table1 in cases of two linked tables. Otherwise table2 is NULL.

common consists of the following elements:

commonCells

Input to protectLinkedTables.

groupVarInd

List defining the hierarchical variable groups

info

A table summarizing the tables using variable names

nLevels

The number of levels of each variable (only when groupVarInd input is NULL)

dimData

Data frame containing the dimVarInd variables when dimDataReturn=TRUE. Otherwise NULL.

Details

One or two tables are identified automatically and subjected to cell suppression methods in package sdcTable. The tables can alternatively be specified manually by groupVarInd, ind1 and ind2 (see FindTableGroup).

See Also

ProtectTable, HierarchicalGroups, FactorLevCorr, FindDimLists, FindCommonCells

Examples

# NOT RUN {
z  <- EasyData("sosialFiktiv")

z8 <- z[z$fylke<=10 & z$kostragr==300,] # 8 regions
a  <- ProtectTable1(z8,c(1,2,4,5),7)
as.data.frame(getInfo(a[[1]][[1]],type="finalData")) # The table (not two linked)

z36 <- z[z$fylke>=11 & z$fylke<=14 & z$kostragr<=500,] # 36 regions
b <- ProtectTable1(z36,1:6,7)
as.data.frame(getInfo(b[[1]][[1]],type="finalData")) # First table
as.data.frame(getInfo(b[[2]][[1]],type="finalData")) # Second table
# }