Skip to content
Single-Flux-QuantumPublic

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Organization Profile & SFQ Paper Map (.github)

License: CC BY 4.0 GitHub Pages SFQ Learn Corpus: 1352+ Papers

Stars Forks Watchers Contributors Last Commit Open Issues Org Followers Learn Stars

Special GitHub organization repository for Single-Flux-Quantum: profile/README.md renders as the organization's public homepage, and docs/ deploys to GitHub Pages as an interactive, client-side searchable and sortable SFQ Paper Map covering 1352+ curated research papers on superconducting digital electronics.

TL;DR

  • Topic: Single Flux Quantum (SFQ) and superconducting digital electronics research
  • Total papers: 1352 curated catalog entries (export from sfq-lab/papers)
  • Modality: Structured bibliographic database (papers.json), static org homepage (profile/README.md), and client-side web application (docs/index.html)
  • Learning: Beginner curriculum in sfq-learn-public
  • Research domains: 9 core categories (Circuits & Logic, Cryo-EDA, Clocking & Power, Hybrid CMOS Interfaces, Cryo-Memory, Compute/Processors, Quantum & Detectors, Sensors & Metrology, Cell Libraries)
  • Deployment: Zero-dependency static site hosted on GitHub Pages via Actions or direct branch deployment
  • Synchronization: Automated regeneration from parent lab via python scripts/export_papers_catalog.py
  • Citation: See Citation below

Table of contents

Features

Path Role
profile/README.md Organization landing page (curated intro, taxonomy diagram, and full static paper catalog)
docs/index.html Interactive Paper Map web application (instant search, domain filter pills, multi-column sort, theme switcher)
docs/papers.json Structured JSON dataset containing complete metadata, DOIs, and innovation summaries
docs/.nojekyll Bypasses Jekyll processing on GitHub Pages for fast and reliable static asset delivery
.github/workflows/deploy-pages.yml GitHub Actions deployment pipeline for GitHub Pages
LICENSE Creative Commons Attribution 4.0 International license

Note

Do not manually edit profile/README.md or docs/papers.json. Refresh them from the parent lab using python scripts/export_papers_catalog.py.

Project Layout

.github/
├── .github/
│   └── workflows/
│       └── deploy-pages.yml      # GitHub Actions deployment to Pages
├── docs/
│   ├── .nojekyll                 # Disables Jekyll build engine on Pages
│   ├── index.html                # Interactive Paper Map single-page app
│   └── papers.json               # 1352+ paper catalog database
├── profile/
│   └── README.md                 # Public GitHub org homepage
├── LICENSE                       # CC BY 4.0 license deed notice
└── README.md                     # Repository documentation

Catalog Schema

Each item in docs/papers.json contains the following fields:

  • slug (string): Unique URL-safe identifier matching the directory in sfq-lab/papers/<slug>/.
  • title (string): Clean full paper title without LaTeX formatting artifacts.
  • authors (string): Semicolon-delimited list of author names.
  • year (string): Four-digit publication year (1989–2026).
  • venue (string): Normalized journal or conference venue name.
  • category (string): Primary and secondary human-readable category slugs.
  • categories (array of strings): Multi-label list of matching domain categories.
  • innovation (string): 1–2 sentence summary of core contribution or experimental demonstration.
  • url (string): Direct DOI resolver link (https://doi.org/...) or fallback analysis link.
  • doi (string): Digital Object Identifier string.

Minimal Real Example

{
  "slug": "single-source-sfq-multiclock-generator-using-resistor-jtl-branches",
  "title": "Single Source SFQ Multiclock Generator Using Resistor–JTL Branches",
  "authors": "Tejumadejesu Oluwadamilare, Shay Hacohen-Gourgy; Eby G. Friedman",
  "year": "2026",
  "venue": "IEEE Trans. Appl. Supercond.",
  "category": "clocking-and-power, hybrid-interfaces",
  "categories": [
    "clocking-and-power",
    "hybrid-interfaces",
    "compute-architectures",
    "quantum-and-detectors"
  ],
  "innovation": "A compact, scalable, and energy-efficient on-chip SFQ multiclock generation architecture capable of generating multiple, independent, stable clock frequencies simultaneously from a single constant DC voltage source.",
  "url": "https://doi.org/10.1109/TASC.2025.3630889",
  "doi": "10.1109/TASC.2025.3630889"
}

Stats and Distribution

The catalog currently holds 1352+ curated entries spanning foundational milestones through 2026 state-of-the-art. Use the Interactive SFQ Paper Map for live counts, year filters, venue breakdown, and multi-domain tagging — static README tables are not regenerated on every export.

Papers are classified using multi-label tagging across 9 core SFQ sub-disciplines:

Domain Slug Display Name
quantum-and-detectors Quantum Control & Detector Readout
clocking-and-power Clocking & Power Distribution Networks
cryo-memory Cryogenic Memory & Storage Systems
circuits-and-logic Logic Families (RSFQ, ERSFQ, AQFP, 4JL)
compute-architectures Microprocessors & Digital Compute
cell-library-and-fabrication Cell Libraries & Fabrication Processes
hybrid-interfaces Superconductor–Semiconductor Interfaces
cryo-eda Cryogenic Electronic Design Automation (EDA)
sensors-and-metrology Sensors, Metrology & Voltage Standards

Quick Start

1. Standalone clone

git clone git@github.com:single-flux-quantum/.github.git
cd .github

2. Activating GitHub Pages

GitHub Pages must be enabled in the repository settings:

  • Method A: Deploy from a branch (Fastest, zero workflow overhead):

    1. Open https://github.com/single-flux-quantum/.github/settings/pages.
    2. Under Build and deployment → Source, select Deploy from a branch.
    3. Under Branch, select main and folder /docs.
    4. Click Save. The map is live in ~30 seconds.
  • Method B: Deploy using GitHub Actions:

    1. Under Build and deployment → Source, select GitHub Actions.
    2. The workflow .github/workflows/deploy-pages.yml will trigger on push to main and publish docs/.

3. Running locally

Because docs/index.html has zero build steps and uses standard ES6 JavaScript:

# Python 3
python -m http.server 8000 --directory docs

# Open in browser:
# http://localhost:8000

4. Synchronizing from parent lab

From the parent monorepo sfq-lab:

# 1. Regenerate papers.json and profile/README.md from analyzed papers:
python scripts/export_papers_catalog.py

# 2. Review staged changes in share/github:
git status share/github

# 3. Commit and push from share/github:
cd share/github
git commit -am "chore: sync papers catalog"
git push origin main

Datasheet

Motivation

Superconducting electronics operates in an extreme domain of picosecond gate delays ($&gt;50\text{ GHz}$) and sub-microwatt power consumption, but literature is dispersed across physics, device fabrication, cryogenics, and VLSI EDA venues. This catalog provides a unified, structured taxonomy to make SFQ research discoverable for computer architects, quantum hardware engineers, and circuit designers.

Composition

The dataset includes:

  • Machine-readable records (docs/papers.json) containing DOIs, complete author rosters, verified venues, and TL;DR innovations.
  • An interactive client-side web application (docs/index.html) supporting full-text search, domain filtering, and multi-column sorting.
  • An accessible static snapshot table in profile/README.md for environments without JavaScript execution.

Collection and curation process

  • Sources: Peer-reviewed publications extracted from IEEE Xplore, Crossref, and publisher repositories.
  • Verification: Cross-referenced with the parent lab's BibTeX index (docs/tas.bib) and structured analyses (papers/*/analysis.md).
  • Classification: Tagged into 9 domain taxonomies based on circuit topology, clocking methodology, interface type, and application target.

Maintenance

The catalog is maintained as an export artifact of single-flux-quantum/sfq-lab. Any corrections or additions to papers under papers/ are propagated via scripts/export_papers_catalog.py.

Known Issues and Limitations

  • PDF hosting: In compliance with publisher copyrights, this repository does not host full-text PDFs. Every entry links directly to its publisher DOI resolver.
  • Single-page scope: The catalog is tuned for low-latency in-browser filtering of hundreds of papers; large corpora (>5,000 papers) would require server-side pagination or search indexing.

License

This documentation, dataset catalog, and organization profile are licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license. See LICENSE.

Third-Party Terms: Publisher metadata, paper titles, author attributions, and DOIs remain the property of their respective copyright holders (IEEE, IOP Publishing, etc.).

Citation

If you use this literature catalog or interactive paper map in your research or tooling, please cite:

@misc{sfqlab2026catalog,
  title        = {Single-Flux-Quantum (SFQ) Research Literature Map and Catalog},
  author       = {{Single-Flux-Quantum Lab Contributors}},
  year         = {2026},
  howpublished = {\url{https://single-flux-quantum.github.io/.github/}},
  note         = {GitHub Organization Profile and Curated Research Map}
}

References

Contact