tag | fde9c4917b82e14492fbbb621cc865eddd414f00 | |
---|---|---|
tagger | The Android Open Source Project <initial-contribution@android.com> | Wed Feb 14 11:37:22 2024 -0800 |
object | 37992fc0e18bb704233ecd8702914ec8d7ef6f1f |
aml_ase_341310010 (11179056,com.google.android.appsearch)
commit | 37992fc0e18bb704233ecd8702914ec8d7ef6f1f | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Fri Jul 07 04:42:43 2023 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Fri Jul 07 04:42:43 2023 +0000 |
tree | 5d2b98a63d4f942bd3babd266cb81763bb59e1dc | |
parent | 912f8cc3fe4b53ebe8931f8f593e18a4f07c96b6 [diff] | |
parent | 0a1cff34c489372d3f515bf81efef2f9f5c02561 [diff] |
Snap for 10453563 from 0a1cff34c489372d3f515bf81efef2f9f5c02561 to mainline-appsearch-release Change-Id: I223a9679dcf3373ef40a7c747d0f4da8658d3239
RAPPOR is a novel privacy technology that allows inferring statistics about populations while preserving the privacy of individual users.
This repository contains simulation and analysis code in Python and R.
For a detailed description of the algorithms, see the paper and links below.
Feel free to send feedback to rappor-discuss@googlegroups.com.
Although the Python and R libraries should be portable to any platform, our end-to-end demo has only been tested on Linux.
If you don't have a Linux box handy, you can view the generated output.
To setup your enviroment there are some packages and R dependencies. There is a setup script to install them: $ ./setup.sh Then to build the native components run: $ ./build.sh This compiles and tests the fastrand
C extension module for Python, which speeds up the simulation.
Finally to run the demo run: $ ./demo.sh
The demo strings together the Python and R code. It:
The output is written to _tmp/regtest/results.html
, and can be opened with a browser.
R analysis (analysis/R
):
Demo dependencies (demo.sh
):
These are necessary if you want to test changes to the code.
Python client (client/python
):
rappor.py
file.Platform:
To run tests:
$ ./test.sh
This currently runs Python unit tests, lints Python source files, and runs R unit tests.
rappor.py
is a tiny standalone Python file, and you can easily copy it into a Python program.
NOTE: Its interface is subject to change. We are in the demo stage now, but if there's demand, we will document and publish the interface.
The R interface is also subject to change.
The fastrand
C module is optional. It‘s likely only useful for simulation of thousands of clients. It doesn’t use cryptographically strong randomness, and thus should not be used in production.
analysis/ R/ # R code for analysis cpp/ # Fast reimplementations of certain analysis # algorithms apps/ # Web apps to help you use RAPPOR (using Shiny) bin/ # Command line tools for analysis. client/ # Client libraries python/ # Python client library rappor.py ... cpp/ # C++ client library encoder.cc ... doc/ # Documentation tests/ # Tools for regression tests compare_dist.R # Test helper for single variable analysis gen_true_values.R # Generate test input make_summary.py # Generate an HTML report for the regtest rappor_sim.py # RAPPOR client simulation regtest_spec.py # Specification of test cases ... build.sh # Build scripts (docs, C extension, etc.) demo.sh # Quick demonstration docs.sh # Generate docs form the markdown in doc/ gh-pages/ # Where generated docs go. (A subtree of the branch gh-pages) pipeline/ # Analysis pipeline code. regtest.sh # End-to-end regression tests, including client # libraries and analysis setup.sh # Install dependencies (for Linux) test.sh # Test runner