История

cpovirk 04a5e26214 Migrate non-Android users off //third_party/java/android_libs/guava_jdk5. This CL migrates them to the equivalent [] library. More information: [] Tested: TAP train for global presubmit queue [] Some tests failed; test failures are believed to be unrelated to this CL ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=115665542		2016-03-07 16:48:53 -08:00
..
README.md	Fix the description of the map file	2016-01-05 21:13:09 -08:00
decode-assoc	Migrate non-Android users off //third_party/java/android_libs/guava_jdk5.	2016-03-07 16:48:53 -08:00
decode-dist	Migrate non-Android users off //third_party/java/android_libs/guava_jdk5.	2016-03-07 16:48:53 -08:00
decode_assoc.R	Changes to export code to google3.	2016-01-21 15:11:34 -08:00
decode_dist.R	Changes to export code to google3.	2016-01-21 15:11:34 -08:00
hash-candidates	Migrate non-Android users off //third_party/java/android_libs/guava_jdk5.	2016-03-07 16:48:53 -08:00
hash_candidates.py	Move tools to bin/, so all the public-facing tools are in one place.	2015-11-09 20:30:30 -08:00
hash_candidates_test.py	Move tools to bin/, so all the public-facing tools are in one place.	2015-11-09 20:30:30 -08:00
sum-bits	Migrate non-Android users off //third_party/java/android_libs/guava_jdk5.	2016-03-07 16:48:53 -08:00
sum_bits.py	Move tools to bin/, so all the public-facing tools are in one place.	2015-11-09 20:30:30 -08:00
sum_bits_test.py	Move tools to bin/, so all the public-facing tools are in one place.	2015-11-09 20:30:30 -08:00
test.sh	Whitespace	2016-02-25 11:05:45 -08:00

README.md

Command Line Tools

This directory contains command line tools for RAPPOR analysis.

Analysis Tools

decode-dist

Decode a distribution -- requires a "counts" file (summed bits from reports), map file, and a params file. See test.sh decode-dist in this dir for an example.

decode-assoc

Decode a joint distribution between 2 variables ("association analysis"). See test.sh decode-assoc-R or test.sh decode-assoc-cpp in this dir for an example.

Currently it only supports associating strings vs. booleans.

Setup

Both of these tools are written in R, and require several R libraries to be installed (see ../setup.sh r-packages).

decode-assoc also shells out to a native binary written in C++ if --em-executable is passed. This requires a C++ compiler (see analysis/cpp/run.sh). You can run test.sh decode-assoc-cpp to test it.

Helper Tools

These are simple Python implementations of tools needed for analysis. At Google, Chrome uses alternative C++/Go implementations of these tools.

sum-bits

Given a CSV file with RAPPOR reports (IRRs), produce a "counts" CSV file on stdout. This is the m x (k+1) matrix that is used in the R analysis (where m = #cohorts and k = report width in bits).

hash-candidates

Given a list of candidates on stdin, produce a CSV file of hashes (the "map file"). Each row has m x h cells (where m = #cohorts and h = #hashes)

See the regtest.sh script for examples of how these tools are invoked.