/*
* ARX: Powerful Data Anonymization
* Copyright 2012 - 2017 Fabian Prasser, Florian Kohlmayer and contributors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.deidentifier.arx.criteria;
import org.deidentifier.arx.ARXConfiguration;
import org.deidentifier.arx.certificate.elements.ElementData;
import org.deidentifier.arx.framework.check.groupify.HashGroupifyEntry;
import org.deidentifier.arx.framework.data.DataManager;
import org.deidentifier.arx.framework.lattice.Transformation;
/**
* Delta-disclosure privacy as proposed in:<br>
* <br>
* Justin Brickell and Vitaly Shmatikov:<br>
* The Cost of Privacy: Destruction of Data-mining Utility in Anonymized Data Publishing<br>
* Proceedings of the 14th ACM SIGKDD International Conference on Knowledge Discovery and Data Mining<br>
* 2008
*
* @author Fabian Prasser
*/
public class DDisclosurePrivacy extends ExplicitPrivacyCriterion {
/** SVUID */
private static final long serialVersionUID = 1543994581019659183L;
/** Log 2. */
private static final double LOG2 = Math.log(2);
/**
* Computes log 2.
*
* @param num
* @return
*/
static final double log2(final double num) {
return Math.log(num) / LOG2;
}
/** Parameter */
private final double d;
/** The original distribution. */
private double[] distribution;
/**
* Creates a new instance
*
* @param attribute
* @param delta
*/
public DDisclosurePrivacy(String attribute, double delta) {
super(attribute, false, false);
this.d = delta;
}
@Override
public DDisclosurePrivacy clone() {
return new DDisclosurePrivacy(this.getAttribute(), this.getD());
}
/**
* Returns the parameter delta.
*
* @return
*/
public double getD(){
return d;
}
@Override
public int getRequirements(){
// Requires a distribution
return ARXConfiguration.REQUIREMENT_DISTRIBUTION;
}
@Override
public void initialize(DataManager manager, ARXConfiguration config) {
super.initialize(manager, config);
distribution = manager.getDistribution(attribute);
}
@Override
public boolean isAnonymous(Transformation node, HashGroupifyEntry entry) {
// For table t
// Foreach class c
// Foreach sensitive value s
// abs(log(freq(s, c)/freq(s, t)) < delta
// Init
int[] buckets = entry.distributions[index].getBuckets();
double count = entry.count;
// For each value in c
for (int i = 0; i < buckets.length; i += 2) {
if (buckets[i] != -1) { // bucket not empty
double frequencyInT = distribution[buckets[i]];
double frequencyInC = (double) buckets[i + 1] / count;
double value = Math.abs(log2(frequencyInC / frequencyInT));
if (value >= d) {
return false;
}
}
}
// check
return true;
}
@Override
public boolean isLocalRecodingSupported() {
return true;
}
@Override
public ElementData render() {
ElementData result = new ElementData("Disclosure privacy");
result.addProperty("Attribute", attribute);
result.addProperty("Threshold (delta)", d);
return result;
}
@Override
public String toString() {
return d+"-disclosure privacy for attribute '"+attribute+"'";
}
}