Skip to content

Commit 252ab1a

Browse files
committed
Update README and add Python requirements
1 parent b6d5057 commit 252ab1a

File tree

3 files changed

+26
-16
lines changed

3 files changed

+26
-16
lines changed

README.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,24 @@
44
</h1>
55

66
## How to cite this work
7-
Mastic will appear in [Proceedings on Privacy Enhancing Technologies (PoPETS), 2025](https://petsymposium.org/popets/2025).
7+
Mastic appears in [Proceedings on Privacy Enhancing Technologies (PoPETS), 2025](https://petsymposium.org/popets/2025/popets-2025-0017.php).
88
The preprint can be accessed [here](https://eprint.iacr.org/2024/221); you can
99
cite this work as follows:
1010
```bibtex
1111
@Article{PoPETS:MPDST25,
12-
author = "Dimitris Mouris and
13-
Christopher Patton and
14-
Hannah Davis and
15-
Pratik Sarkar and
16-
Nektarios Georgios Tsoutsos",
17-
title = "{Mastic: Private Weighted Heavy-Hitters and Attribute-Based Metrics}",
18-
year = 2025,
19-
volume = 2025,
20-
month = July,
21-
journal = "{Proceedings on Privacy Enhancing Technologies}",
22-
number = 1,
23-
pages = "1--30",
12+
author = "Dimitris Mouris and
13+
Christopher Patton and
14+
Hannah Davis and
15+
Pratik Sarkar and
16+
Nektarios Georgios Tsoutsos",
17+
title = "{Mastic: Private Weighted Heavy-Hitters and Attribute-Based Metrics}",
18+
year = 2025,
19+
volume = 2025,
20+
month = July,
21+
journal = "{Proceedings on Privacy Enhancing Technologies}",
22+
number = 1,
23+
pages = "290--319",
24+
doi = "10.56553/popets-2025-0017"
2425
}
2526
```
2627

@@ -38,12 +39,12 @@ Similarly, for the two other modes that Mastic supports:
3839

3940
## Building
4041

41-
First, make sure that you have a working Rust installation:
42+
First, make sure that you have a working [Rust installation](https://www.rust-lang.org/tools/install):
4243
```bash
4344
❯❯ rustc --version
44-
rustc 1.74.0
45+
rustc 1.82.0
4546
❯❯ cargo --version
46-
cargo 1.74.0
47+
cargo 1.82.0
4748
```
4849

4950
Next, build from sources using:

artifact/README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -309,6 +309,8 @@ experiments in the paper specify the parameters used.
309309
To reproduce our experiments, use the configs from the [configs](./configs/)
310310
directory and the scripts from the [plots](./plots/) directory.
311311
312+
Install the Python dependencies with `pip install -r requirements.txt`.
313+
312314
## Troubleshooting
313315
As mentioned in the **Troubleshooting** section of the [README file](../README.md) file,
314316
Mastic relies on the [tarpc](https://github.com/google/tarpc) library which has
@@ -332,3 +334,8 @@ not change the experiments but will make setting up the experiments faster. For
332334
this reason, most of the provided configs use the default batch sizes, which may
333335
cause crashes with more clients or bits, but this can be simply resolved by
334336
reducing the batch sizes.
337+
338+
## Plain Heavy Hitters (`m = 1`)
339+
For plain heavy hitters, a more efficient implementation exists in the `count`
340+
branch, which we used for Mastic experiments where `m = 1`. To reproduce our
341+
exact numbers for `m = 1` use the count branch.

artifact/plots/requirements.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
pandas>=2.2.3
2+
seaborn>=0.13.2

0 commit comments

Comments
 (0)