From e89a068a60eefe63374e397fc73c7ca471d03a16 Mon Sep 17 00:00:00 2001
From: Archit Tamarapu <archit.tamarapu@iis.fraunhofer.de>
Date: Mon, 8 Sep 2025 14:48:51 +0200
Subject: [PATCH] update README.md with instructions on item collection and
 hash generation

---
 README.md | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index fc4c0347..d66299ef 100755
--- a/README.md
+++ b/README.md
@@ -104,10 +104,42 @@ for %f in (experiments\characterization\P800-1\config\*.yml) do python -m ivas_p
 
 After the processing is finished, the outputs will be present in the respective `proc_output` directories.
 
+### Item collection
+
 - For P.800 tests, these outputs need to be collected according to the test plan to assemble the final outputs required for P.800 test software.
+
+  - This can be done using the scripts in [collection-scripts](collection-scripts/characterization/README.md) (click for README) by running:
+
+  ```batch
+  python collection-scripts\characterization\p800_categorized_samples.py
+  python collection-scripts\characterization\p800_preliminaries.py
+  ```
+
 - For MUSHRA tests, the outputs may be used directly, or in case of multi-input format experiments again need to be manually assembled.
 
-At this point of time there is no script to automatically perform this.
+### Hash generation
+
+The hashes for the `proc_final` (or `proc_output` for BS.1534 experiments) can be generated using the [get_md5.py](other/get_md5.py) script:
+
+```shell
+> python other/get_md5.py --help
+usage: get_md5.py [-h] output_dir out_file
+
+Cross-platform script for generating MD5 hashes of output files for the characterization testing experiments.
+
+positional arguments:
+  output_dir  Path to the output directory of the respective experiment that you want to generate Hashes for. Can be proc_output or proc_final.
+  out_file    Output text file with filenames and Hashes
+
+options:
+  -h, --help  show this help message and exit
+```
+
+For example:
+
+```shell
+python other/get_md5.py experiments/characterization/P800-1/proc_final p800-1_hashes.txt
+```
 
 ## Directory structure
 
@@ -127,6 +159,13 @@ At this point of time there is no script to automatically perform this.
     │   │   └── <item_name.wav.met> for MASA metadata
     │   ├── cat2...
     │   └── ...cat6
+    ├── proc_final
+    │   ├── c01
+    │   │    └── [l]p[ee]a[y]s[zz].c[nn].wav
+    │   ├── c02...
+    │   ├── ...c36
+    │   └── preliminaries
+    │       └── [l]p[ee]a[y]s[zz].c[nn].wav
     └── proc_output
         ├── cat1
         │   ├── out_-16LKFS
-- 
GitLab