Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,21 @@

This repository contains the sources for [de3ug.github.io](https://de3ug.github.io/). All public files live in the `site/` directory and are deployed automatically to GitHub Pages.

The homepage includes sections for publications, projects, work experience and a Personal/Hobbies area with links to travel, astrophotography and racing content.
The homepage includes publications, service and patents in one section, projects, work experience, and a Personal/Hobbies area that also lists writing.

## How the site is structured

The deployed site is intentionally simple: `site/` is the public web root. GitHub Actions copies `site/` into a temporary `dist/` directory and publishes that to the `gh-pages` branch. The `docs/` directory is not the live GitHub Pages root for this setup.

The main page is split into a static shell and data-driven content:

- `site/index.html` defines the layout, navigation, theme styling and empty section containers.
- `site/index.html` defines the homepage shell and empty section containers.
- `site/css/site.css` and `site/js/navigation.js` provide the shared sidebar, layout, and theme styling for the homepage, writing pages, and dataset page.
- `site/js/render.js` fetches `site/resume.json` in the browser and fills the homepage sections.
- `site/js/theme-toggle.js` handles the light/dark theme toggle.
- `site/writing/` contains the writing archive and standalone long-form articles.
- `site/css/writing.css` adds reading and dataset layouts to the common site styles.
- `site/datasets/viper/` contains the dataset landing page, original ZIP, and citation file.
- `site/resume.pdf` is the printable one-page resume artifact.
- `site/llms.txt` is a short LLM-readable summary artifact that points agents to `resume.json`.
- `site/gcmap/` is a standalone static demo app for mapping great-circle flight routes.
Expand All @@ -24,7 +28,7 @@ The main page is split into a static shell and data-driven content:

The JSON has a hierarchy of information:

- It contains the full content inventory, including public profile text, publications, patents, media mentions, experience, hobbies, contact links and background notes.
- It contains the full content inventory, including public profile text, writing metadata, publications, patents, media mentions, experience, hobbies, contact links and background notes.
- Most current, public-facing items are rendered into the webpage.
- Some older school, internship and early-career details are kept in the JSON for context but hidden from the webpage because they are no longer central to the public portfolio.
- Only the most important highlights are included in the one-page resume PDF.
Expand All @@ -33,6 +37,14 @@ Visibility is controlled with fields such as `hide_from` and `for`. These fields

`build.py` reads the same JSON and generates `site/resume.pdf`, keeping the resume concise while preserving a richer content hierarchy for the website and future edits.

Long-form prose does not live in `resume.json`. The `writing` collection stores discoverability metadata such as title, summary, publication date, canonical URL and site-relative path. Each article owns its full content and assets under `site/writing/<slug>/`; this keeps the résumé data useful as a directory without turning it into a document format.

Writing appears under Personal/Hobbies on the homepage. The separate `/writing/` archive and article pages use the same sidebar and light/dark controls as the portfolio. The VIPeR article lives at `/writing/twenty-years-of-person-re-identification/`; the previous preview slug redirects there.

The VIPeR download page is `/datasets/viper/`. Its ZIP is the exact historical v1.0 archive, with checksums and the original citation. The homepage dataset entry is web-only. The essay's citation chart uses manually observed Google Scholar article histograms, stored with source URLs and observation date in `assets/scholar-citations.json`. Run `python3 build_citation_chart.py` with Matplotlib installed to regenerate it.

The essay's performance scatter plot uses `assets/rank-one-scatter.json`, which records reported results, evaluation settings, dates, and paper sources. Run `python3 build_rank_one_chart.py` with Matplotlib installed to regenerate `assets/rank-one-scatter.png`. The plot distinguishes training settings and is not a controlled leaderboard.

The `last_updated` field in `site/resume.json` is also the source of truth for the "Last updated" text shown on the website, the PDF resume and the generated `llms.txt` summary. When changing profile content or rebuilding artifacts, update this date in the JSON.

## LLM-readable summary
Expand Down
8 changes: 8 additions & 0 deletions build.py
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,12 @@ def render_llms(r):
for s in r['social']
if visible(s, 'web')
)
writing = '\n'.join(
f'- [{entry["title"]}]({entry["url"]}): {entry["summary"]}'
for entry in r.get('writing', [])
if visible(entry, 'web')
)
writing_section = f'\n## Writing\n\n{writing}' if writing else ''

return f"""# {r['name']}

Expand All @@ -115,6 +121,7 @@ def render_llms(r):
{r['about']}

Last updated: {r['last_updated']}
{writing_section}

Contact:
- Email: {r['email']}
Expand Down Expand Up @@ -214,6 +221,7 @@ def render_html(r, target='resume'):
<h2>Selected Publications &amp; Service</h2>
<p>{parts_to_html(r['publications_intro']['parts'], target)}</p>
{ul(r['publications'], target)}
<p>{r['reviewer_service']}</p>

<h2>Selected Patents</h2>
<p>{r['patents_intro']}</p>
Expand Down
56 changes: 56 additions & 0 deletions build_citation_chart.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
#!/usr/bin/env python3
"""Render the observed Google Scholar histories used in the VIPeR essay."""

import json
from pathlib import Path

import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt

ASSETS = Path(__file__).resolve().parent / 'site/writing/twenty-years-of-person-re-identification/assets'


def main():
data = json.loads((ASSETS / 'scholar-citations.json').read_text())
rows = data['annual']
years = [row['year'] for row in rows]
plt.rcParams.update({'font.family': 'sans-serif', 'font.size': 12})
fig, ax = plt.subplots(figsize=(10, 5.6), dpi=180)
fig.patch.set_facecolor('white')
ax.set_facecolor('white')
for key, label, color, style in [
('eccv2008', 'ECCV 2008', '#11637b', '-'),
('pets2007', 'PETS 2007', '#b64b24', '--'),
]:
counts = [row[key] for row in rows]
ax.plot(years[:-1], counts[:-1], color=color, linewidth=2.5,
linestyle=style, label=label)
ax.plot(years[-2:], counts[-2:], color=color, linewidth=2,
linestyle=':', marker='o', markersize=4)
ax.set_title('Citations to the foundational VIPeR papers', loc='left',
fontsize=17, fontweight='bold', pad=22)
ax.set_ylabel('Citations per year')
ax.set_xticks(range(2010, 2027, 2))
ax.set_xlim(2009.7, 2026.3)
ax.set_ylim(0, 240)
ax.grid(axis='y', color='#dedede')
ax.set_axisbelow(True)
ax.spines[['top', 'right']].set_visible(False)
ax.legend(frameon=False, loc='upper left')
ax.annotate('213 (2018)', xy=(2018, 213), xytext=(2019, 225),
color='#11637b', fontsize=11,
arrowprops={'arrowstyle': '-', 'color': '#11637b'})
ax.annotate('179 (2017)', xy=(2017, 179), xytext=(2013, 204),
color='#b64b24', fontsize=11,
arrowprops={'arrowstyle': '-', 'color': '#b64b24'})
fig.text(0.12, 0.025,
'Google Scholar · observed October 12, 2026 · 2026 is year-to-date',
fontsize=10, color='#555555')
fig.subplots_adjust(left=0.12, right=0.97, bottom=0.13, top=0.84)
fig.savefig(ASSETS / 'citations-over-time.png')
plt.close(fig)


if __name__ == '__main__':
main()
74 changes: 74 additions & 0 deletions build_rank_one_chart.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
#!/usr/bin/env python3
"""Render the sourced VIPeR performance scatter plot used in the essay."""

import json
from datetime import date
from pathlib import Path

import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt

ASSETS = Path(__file__).resolve().parent / 'site/writing/twenty-years-of-person-re-identification/assets'
STYLES = {
'historical': ('#11637b', 'o', 'Within-dataset methods'),
'generalization': ('#19724c', 'o', 'External-data training'),
'reranked': ('#8a446a', 'D', 'Re-ranking'),
'audit': ('#727272', 'x', 'Protocol unclear')
}
OFFSETS = {
'PETS baseline': (0, 28), 'ELF': (-22, 23), 'SDALF': (-25, 28), 'KISSME': (-35, -32),
'eSDC': (-26, -45), 'SalMatch': (-20, 38), 'SCNCD': (-60, 48), 'LOMO + XQDA': (-18, -80),
'Metric ensembles': (-80, 40), 'KCCA + DCIA': (-85, 44), 'GOG + XQDA': (0, 40),
'NFST fusion': (0, 72), 'SNR': (12, -48), 'RaMoE': (4, -35), 'ACL': (-20, 42),
'ReNorm': (-35, 35), 'CLIP-FGDI': (-85, 38), 'NK3ML': (20, -12), 'RND': (-85, -42),
'DIMN': (-28, -40), 'DualNorm': (-78, 20), 'OSNet + target fine-tuning': (-6, 42)
}


def year_position(row):
if row['date_basis'] == 'year_only':
return row['year']
posted = date.fromisoformat(row['date'])
start, end = date(posted.year, 1, 1), date(posted.year + 1, 1, 1)
return posted.year + (posted - start).days / (end - start).days


def main():
rows = json.loads((ASSETS / 'rank-one-scatter.json').read_text())['papers']
assert len({r['method'] for r in rows}) == len(rows)
assert all(0 <= r['rank_one_percent'] <= 100 for r in rows)
plt.rcParams.update({'font.family': 'sans-serif', 'font.size': 12})
fig, ax = plt.subplots(figsize=(12, 7.2), dpi=180)
fig.patch.set_facecolor('white')
ax.set_facecolor('white')
for setting, (color, marker, label) in STYLES.items():
for row in (r for r in rows if r['setting'] == setting):
x, rate = year_position(row), row['rank_one_percent']
shape = '^' if row['method'] == 'NK3ML' else marker
ax.scatter(x, rate, c=color, s=62 if row['highlighted'] else 30,
marker=shape, linewidths=1.2, zorder=3, clip_on=False)
if row['highlighted'] or row['method'] in ('NK3ML', 'RND'):
ax.annotate(row.get('annotation', row['method']), (x, rate), xytext=OFFSETS[row['method']],
textcoords='offset points', fontsize=10, va='center',
ha='right' if row['method'] == 'OSNet + target fine-tuning' else 'left',
arrowprops={'arrowstyle': '-', 'color': color, 'alpha': 0.7, 'linewidth': 0.7},
bbox={'facecolor': 'white', 'edgecolor': 'none', 'pad': 1, 'alpha': 0.95}, zorder=4)
ax.scatter([], [], c=color, marker=marker, s=40, label=label)
ax.set_xlim(2006.75, 2026.75)
ax.set_xticks(list(range(2007, 2027, 2)) + [2026])
ax.set_xlabel('Year', labelpad=10)
ax.set_ylim(0, 100)
ax.set_yticks(range(0, 101, 20))
ax.set_ylabel('Rank-one accuracy (%)', labelpad=10)
ax.grid(color='#ededed', linewidth=0.8)
ax.set_axisbelow(True)
ax.spines[['top', 'right']].set_visible(False)
ax.legend(loc='lower right', fontsize=10, frameon=False)
fig.subplots_adjust(left=0.08, right=0.98, top=0.98, bottom=0.14)
fig.savefig(ASSETS / 'rank-one-scatter.png')
plt.close(fig)


if __name__ == '__main__':
main()
Loading
Loading