diff options
| author | Arun Isaac | 2025-07-17 17:59:17 +0100 |
|---|---|---|
| committer | Arun Isaac | 2025-07-17 20:51:54 +0100 |
| commit | d270d35cbfe9bc94d1bef16a63e3ca89e87e739e (patch) | |
| tree | 75f0e67a8895c1b12fe8dacce7569d270f53123c /README.md | |
| parent | d785cb61a6f19003d76986a36cd4f4b7a6e21f5d (diff) | |
| download | pyhegp-d270d35cbfe9bc94d1bef16a63e3ca89e87e739e.tar.gz pyhegp-d270d35cbfe9bc94d1bef16a63e3ca89e87e739e.tar.lz pyhegp-d270d35cbfe9bc94d1bef16a63e3ca89e87e739e.zip | |
Document usage instructions and workflow.
* doc/workflow.uml, doc/workflow.png, doc/generate-images.sh: New
files.
* README.md (How to use): New section.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 22 |
1 files changed, 22 insertions, 0 deletions
@@ -14,6 +14,28 @@ Install the development version of pyhegp into the virtual environment. pip install git+https://github.com/encryption4genetics/pyhegp ``` +# How to use + + + +Data owners generate summary statistics for their data. +``` +pyhegp summary genotype.csv -o summary.txt +``` +They share this with the data broker who pools it to compute the summary statistics of the complete dataset. +``` +pyhegp pool -o complete-summary.txt summary1.txt summary2.txt ... +``` +The data broker shares these summary statistics with the data owners. The data owners standardize their data using these summary statistics, and encrypt their data using a random key. +``` +pyhegp encrypt -s complete-summary.txt -o encrypted-genotype.csv genotype.csv +``` +Finally, the data owners share the encrypted data with the broker who concatenates it and shares it with all parties. +``` +pyhegp cat -o complete-encrypted-genotype.csv encrypted-genotype1.csv encrypted-genotype2.csv ... +``` +Note that all data sharing is carried out-of-band and is outside the scope of `pyhegp`. + # Run tests Run the test suite using |