Extract Conditional Fractions for a Target Attribute

Computes and extracts conditional fractions from a contingency table for use during attribute assignment.

Usage

getGroupFractions(object, dt)

Arguments

object: A ReplicaAdder object.
dt: A contingency table containing the target attribute and a count column.

Value

A data frame or data.table containing:

The target attribute.
Any relevant margin variables.
A fraction column.

Details

The function converts contingency-table counts into conditional probabilities using calculate_fractions and returns the resulting fractions indexed by the target attribute and any relevant margin variables.

This function is used internally by enhance during conditional attribute assignment.

Fractions are calculated separately within each conditioning group.

The result is subsequently used by:

calculate_group_counts
enhance

If margin constraints have been supplied using renew, the returned table will also include the corresponding margin variables.

The function automatically removes duplicate index names when margins overlap with the target attribute.

Examples

if (FALSE) { # \dontrun{

fractions <- getGroupFractions(
  adder,
  contingency_group
)

fractions

} # }

if (FALSE) { # \dontrun{

# Typical output

# education fraction
# Degree      0.45
# Diploma     0.25
# School      0.30

} # }