start the repo with the readme

Author: Arunendra21

.github/workflows/reveal.yml

@@ -0,0 +1,43 @@
+name: reveal
+on:
+  schedule:
+    - cron: "45 16 * * *"
+  workflow_dispatch:
+permissions:
+  contents: write
+jobs:
+  reveal:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: release the next piece from the vault branch
+        run: |
+          set -e
+          START="2026-08-07"
+          TODAY=$(date -u +%Y-%m-%d)
+          if [[ "$TODAY" < "$START" ]]; then echo "not started until $START"; exit 0; fi
+          git config user.name "Arunendra21"
+          git config user.email "156455722+Arunendra21@users.noreply.github.com"
+          git fetch --depth=1 origin vault:refs/remotes/origin/vault
+          order=(figures source_code ieee_report.docx ieee_report.pdf presentation.pptx outputs processing_notes.md)
+          next=""
+          for it in "${order[@]}"; do
+            if git cat-file -e refs/remotes/origin/vault:"$it" 2>/dev/null && [ ! -e "$it" ]; then next="$it"; break; fi
+          done
+          if [ -z "$next" ]; then echo "everything already released"; exit 0; fi
+          git checkout refs/remotes/origin/vault -- "$next"
+          case "$next" in
+            figures) MSG="add the generated figures";;
+            source_code) MSG="add the reproduction source code";;
+            ieee_report.docx) MSG="add the write-up";;
+            ieee_report.pdf) MSG="add the write-up as pdf";;
+            presentation.pptx) MSG="add the summary slides";;
+            outputs) MSG="add the metrics and outputs";;
+            processing_notes.md) MSG="add the processing notes";;
+            *) MSG="add $next";;
+          esac
+          git add "$next"
+          git commit -m "$MSG"
+          git push origin HEAD:main

.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+*.pyo
+.DS_Store
+.ipynb_checkpoints/
+original_paper.pdf

README.md

@@ -0,0 +1,35 @@
+# Sorting-and-Prediction Integrated High-Capacity RDH (Li 2026)
+
+This repo is my reproduction of Sorting-and-Prediction Integrated High-Capacity RDH, from Jian Li, Lingxiao Bo, Miaomiao Yang, Bin Ma, Shijun Xiang, Xiaolong Li, Zhenxing Qian, published in IEEE Trans. Consumer Electronics (early access), 2026.
+
+It predicts each pixel from its neighbours and expands the small prediction errors to carry data with very little distortion.
+
+I reimplemented the method from the paper and ran it from start to finish. Every number and every figure in the report is produced by the code in this repo, and reversibility is checked to be bit exact wherever the method claims it.
+
+## Running it
+
+Everything runs with plain Python and a handful of common libraries. From this folder:
+
+```bash
+cd source_code
+python3 run_experiment.py       # runs the method, writes metrics and figures
+python3 build_deliverables.py   # rebuilds the IEEE report and the slides
+```
+
+You need numpy, scipy, matplotlib, pillow, python-docx and python-pptx. Install them with `pip install numpy scipy matplotlib pillow python-docx python-pptx`. The report is exported to PDF with headless LibreOffice, so that has to be on the machine if you want the PDF rebuilt.
+
+## What sits in this folder
+
+```
+(the original paper stays on my machine and is not republished here, to respect its copyright)
+ieee_report.docx/.pdf  my IEEE format reproduction report
+presentation.pptx      a short summary deck
+source_code/           the scripts that do the actual work
+outputs/               metrics.json and the raw numbers behind the report
+figures/               the plots and images the code produces
+processing_notes.md    what was reproduced, what was not, and the caveats
+```
+
+## A note on honesty
+
+Nothing in the tables or plots was copied from the paper. Anything marked as reported, and only that, is quoted from the original for comparison. Everything else is computed here. Where the exact image set or an unstated hyperparameter differs from the paper, the absolute figures can move a little, but the behaviour and the reversibility hold. The specifics for this paper are in `processing_notes.md`.