Skip to content

Commit 52f3540

Browse files
committed
add new videos and figures
1 parent c00d31c commit 52f3540

9 files changed

Lines changed: 83 additions & 56 deletions

File tree

README.md

Lines changed: 0 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -10,51 +10,6 @@ Project website and resources for the POMDAR benchmark.
1010

1111
Repo: **https://github.com/srl-ethz/POMDAR**
1212

13-
### Why assets sometimes “don’t show” (Git LFS vs Pages)
14-
15-
GitHub’s **default** Pages mode (**deploy from a branch**) publishes files **exactly as stored in Git**. For **Git LFS**, what’s stored in Git is a **small pointer file**, not the real binary. **GitHub Pages does not resolve LFS** in that mode — the browser receives pointers, so meshes/videos break. This is the same limitation discussed in the community thread: [“Can’t see LFS files on github website”](https://github.com/orgs/community/discussions/149620).
16-
17-
You have two workable approaches:
18-
19-
| Approach | What to do |
20-
|----------|------------|
21-
| **A. GitHub Actions deploy (this repo)** | **Settings → Pages → Source: GitHub Actions** (not “Deploy from a branch”). The workflow [`.github/workflows/deploy-pages.yml`](.github/workflows/deploy-pages.yml) runs `actions/checkout` with **`lfs: true`**, then uploads the **`docs/`** folder **with real LFS files expanded** — so `.mov` / `.stl` / etc. still in LFS in the repo, but the **published site** gets the actual bytes. |
22-
| **B. Don’t use LFS for static web assets** | Keep small files (e.g. **`.obj` meshes**) as **normal Git blobs** so **any** Pages mode serves them. This repo stores **`.obj` in plain Git** for that reason. Very large media can be hosted on a **CDN / Releases** and linked by URL instead. |
23-
24-
**Do not** rely on branch-only deploy if the site must load LFS-tracked files, unless you use **A** or move those assets out of LFS (**B**).
25-
26-
---
27-
28-
## Publish / update the site
29-
30-
1. Push to **`main`**.
31-
2. **Settings → Pages → Build and deployment → Source:** **GitHub Actions**.
32-
3. Wait for the **Deploy GitHub Pages** workflow (green check on the **Actions** tab).
33-
4. Open **https://srl-ethz.github.io/POMDAR/**
34-
35-
If you still use **“Deploy from a branch”****`/docs`**, LFS-backed assets (e.g. **`.mov`**, **`.stl`**) will **not** work in the browser until you switch to **GitHub Actions** or stop using LFS for those paths.
36-
37-
---
38-
39-
## Git LFS (what stays in LFS)
40-
41-
See [`.gitattributes`](.gitattributes). Typical patterns:
42-
43-
- **In LFS:** `.mov`, `.stl`, `.ply`, `.dae`, `.mjb` (large binaries).
44-
- **Plain Git (not LFS):** **`.obj`** MuJoCo meshes — small enough for normal Git and **required** for static serving if you ever use branch deploy without resolving LFS.
45-
46-
Install locally before push/clone:
47-
48-
```bash
49-
brew install git-lfs # macOS
50-
git lfs install
51-
git lfs pull # after clone, fetch LFS objects
52-
```
53-
54-
**GitHub limits:** normal Git rejects files **> 100 MB** per file. Large clips may need LFS or re-encoding. See [About Git LFS](https://docs.github.com/en/repositories/working-with-files/managing-large-files/about-git-large-file-storage).
55-
56-
---
57-
5813
## Updating the site
5914

6015
Edit **`docs/`** (the deployed tree). Sync from your dev folder into `docs/` before committing.
775 KB
Binary file not shown.

docs/assets/pomdar.pdf

-20.6 MB
Binary file not shown.

docs/assets/pomdar_ral_clip.mp4

8.79 MB
Binary file not shown.

docs/assets/results_figure6.jpg

125 KB
Loading

docs/assets/taxonomy_spaced.pdf

568 KB
Binary file not shown.

docs/index.html

Lines changed: 58 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,13 @@ <h1>A Benchmark of Dexterity for Anthropomorphic Robotic Hands</h1>
4444

4545
<div class="actions" aria-label="Resources">
4646
<a class="btn btn-solid" href="assets/pomdar.pdf" target="_blank" rel="noreferrer">PDF</a>
47+
<a
48+
class="btn"
49+
href="https://arxiv.org/abs/2604.09294"
50+
target="_blank"
51+
rel="noopener noreferrer"
52+
>arXiv</a
53+
>
4754
<span class="btn btn-soon" title="Coming soon">CAD (soon)</span>
4855
<span class="btn btn-soon" title="Coming soon">Code (soon)</span>
4956
<a class="btn" href="#interactive-sim">Interactive sim</a>
@@ -120,14 +127,17 @@ <h3>Grasping (G1–G6)</h3>
120127
</div>
121128

122129
<figure class="figure" style="margin-top: 1.25rem">
123-
<div class="media">
124-
<img
125-
src="assets/benchmark_overview_p1.png"
126-
alt="POMDAR task configurations: vertical, horizontal, continuous rotation, and grasping panels"
127-
loading="lazy"
128-
/>
130+
<div class="media media--pdf">
131+
<iframe
132+
class="pdf-embed"
133+
title="POMDAR benchmark overview (PDF)"
134+
src="assets/benchmark_overview_colored.pdf#view=FitH"
135+
></iframe>
129136
</div>
130-
<p class="fig-caption">Benchmark apparatus and task configurations (overview figure).</p>
137+
<p class="fig-caption">
138+
Benchmark apparatus and task configurations (overview).
139+
<a href="assets/benchmark_overview_colored.pdf" target="_blank" rel="noreferrer">Open PDF</a>
140+
</p>
131141
</figure>
132142
</section>
133143

@@ -161,8 +171,8 @@ <h2>Teleoperation Results</h2>
161171
<div class="results-layout">
162172
<div class="results-figure-wrap">
163173
<img
164-
src="assets/results_legend_p1.png"
165-
alt="POMDAR results: ORCA embodiments and radar plots for manipulation and grasp tasks"
174+
src="assets/results_figure6.jpg"
175+
alt="POMDAR teleoperation results: ORCA embodiments (2–16 DoF) and radar plots for manipulation (C, V, H) and grasping (G) tasks"
166176
loading="lazy"
167177
/>
168178
</div>
@@ -187,14 +197,52 @@ <h2>Citation</h2>
187197
<pre id="bibtex">@article{liconti2026pomdar,
188198
title={A Benchmark of Dexterity for Anthropomorphic Robotic Hands},
189199
author={Liconti, Davide and Zhou, Yuning and Toshimitsu, Yasunori and Hinchet, Ronan and Katzschmann, Robert K.},
190-
journal={arXiv preprint},
200+
journal={arXiv preprint arXiv:2604.09294},
191201
year={2026}
192202
}</pre>
193203
<button id="copyBibtex" class="btn btn-solid" type="button">Copy BibTeX</button>
194204
<p class="subtle" style="margin-top: 1rem; text-align: center">
195205
Replace the BibTeX entry with the final venue information when available.
196206
</p>
197207
</section>
208+
209+
<section class="section reveal" id="taxonomy">
210+
<h2>Task taxonomy</h2>
211+
<p class="abstract" style="margin-top: 0; max-width: 85ch; margin-left: auto; margin-right: auto">
212+
POMDAR tasks map to the families shown in the paper figures: <b>C</b> (continuous rotation: thread, stick,
213+
wheel, fidget), <b>V</b> (vertical scaffold: wheel, stick, sphere), <b>H</b> (horizontal scaffold: scissors,
214+
chopsticks, squeeze, palmar, pinch), and <b>G</b> (free grasping: wheel, sphere, disk, and three cylinder
215+
sizes). The results figure above compares ORCA embodiments on these taxonomy cells.
216+
</p>
217+
<figure class="figure" style="margin-top: 1rem">
218+
<div class="media media--pdf">
219+
<iframe
220+
class="pdf-embed pdf-embed--tall"
221+
title="POMDAR task taxonomy (PDF)"
222+
src="assets/taxonomy_spaced.pdf#view=FitH"
223+
></iframe>
224+
</div>
225+
<p class="fig-caption">
226+
Taxonomy layout (paper Fig.&nbsp;6 style).
227+
<a href="assets/taxonomy_spaced.pdf" target="_blank" rel="noreferrer">Open PDF</a>
228+
</p>
229+
</figure>
230+
</section>
231+
232+
<section class="section reveal" id="video">
233+
<h2>Benchmark in motion</h2>
234+
<p class="abstract" style="margin-top: 0; text-align: center; max-width: 75ch; margin-left: auto; margin-right: auto">
235+
Clip from our supplementary video (1&nbsp;minute excerpt, 0:37–1:37).
236+
</p>
237+
<figure class="figure">
238+
<div class="media">
239+
<video controls playsinline preload="metadata" src="assets/pomdar_ral_clip.mp4"></video>
240+
</div>
241+
<p class="fig-caption">
242+
<a href="assets/pomdar_ral_clip.mp4" download>Download clip</a>
243+
</p>
244+
</figure>
245+
</section>
198246
</main>
199247

200248
<footer class="footer reveal">

docs/mujoco/assets/index-fiqanLmb.js

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

docs/styles.css

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -284,6 +284,30 @@ h3 {
284284
vertical-align: middle;
285285
}
286286

287+
.media video {
288+
width: 100%;
289+
height: auto;
290+
display: block;
291+
vertical-align: middle;
292+
}
293+
294+
.media--pdf {
295+
padding: 0;
296+
line-height: 0;
297+
}
298+
299+
.pdf-embed {
300+
width: 100%;
301+
min-height: 68vh;
302+
border: 0;
303+
display: block;
304+
background: var(--media-bg);
305+
}
306+
307+
.pdf-embed--tall {
308+
min-height: 85vh;
309+
}
310+
287311
#overview .media img {
288312
max-height: min(78vh, 820px);
289313
object-fit: contain;

0 commit comments

Comments
 (0)