{"id":22735436,"url":"https://github.com/ldbc/ldbc_snb_docs","last_synced_at":"2026-01-08T16:14:11.002Z","repository":{"id":17988138,"uuid":"20995329","full_name":"ldbc/ldbc_snb_docs","owner":"ldbc","description":"Specification of the LDBC Social Network Benchmark suite","archived":false,"fork":false,"pushed_at":"2025-03-03T12:47:43.000Z","size":66832,"stargazers_count":54,"open_issues_count":6,"forks_count":14,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-03-03T13:41:01.233Z","etag":null,"topics":["benchmarking","graphs","property-graph","semantic-web","snb"],"latest_commit_sha":null,"homepage":"https://ldbcouncil.org/ldbc_snb_docs/","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ldbc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":"auditing.tex","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-06-19T09:41:24.000Z","updated_at":"2025-03-03T12:40:51.000Z","dependencies_parsed_at":"2024-04-04T23:25:24.402Z","dependency_job_id":"d7cf7bd9-2900-4874-90c3-101610d66df2","html_url":"https://github.com/ldbc/ldbc_snb_docs","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldbc%2Fldbc_snb_docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldbc%2Fldbc_snb_docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldbc%2Fldbc_snb_docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ldbc%2Fldbc_snb_docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ldbc","download_url":"https://codeload.github.com/ldbc/ldbc_snb_docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246267640,"owners_count":20749985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["benchmarking","graphs","property-graph","semantic-web","snb"],"created_at":"2024-12-10T21:10:03.956Z","updated_at":"2026-01-08T16:14:10.944Z","avatar_url":"https://github.com/ldbc.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"![LDBC_LOGO](https://raw.githubusercontent.com/ldbc/ldbc_snb_docs/main/figures/ldbc-logo.png)\n# LDBC SNB Documentation\n\n[![Build Status](https://github.com/ldbc/ldbc_snb_docs/actions/workflows/compile-spec.yml/badge.svg)](https://github.com/ldbc/ldbc_snb_docs/actions)\n\n[[latest PDF (2.2.5-SNAPSHOT)]](https://ldbcouncil.org/ldbc_snb_docs/ldbc-snb-specification.pdf)\n[[stable PDF (2.2.4)]](https://arxiv.org/pdf/2001.02299.pdf)\n\n## Benchmark specification\n\nFor a quick overview of LDBC SNB, start with [The LDBC Benchmark Suite presentation](https://archive.fosdem.org/2023/schedule/event/ldcb_benchmark_suite/attachments/slides/5767/export/events/attachments/ldcb_benchmark_suite/slides/5767/the_ldbc_benchmark_suite_fosdem_hpc_devroom_2023_szarnyas.pdf) [🎥 recording](https://www.youtube.com/watch?v=q26DHnQFw54) by Gábor Szárnyas (FOSDEM 2024).\n\nFor a guide on how to develop SNB implementations, please check out the READMEs of the reference implementation repositories linked below.\n\n## Software components\n\nThe SNB workloads are stored in different repositories:\n\n* SNB Interactive v1:\n  * Data generator: https://github.com/ldbc/ldbc_snb_datagen_hadoop\n  * Driver: https://github.com/ldbc/ldbc_snb_interactive_v1_driver\n  * Reference implementations: https://github.com/ldbc/ldbc_snb_interactive_v1_impls\n* SNB Interactive v2 (work-in-progress):\n  * Data generator: https://github.com/ldbc/ldbc_snb_datagen_spark\n  * Driver: https://github.com/ldbc/ldbc_snb_interactive_v2_driver\n  * Reference implementations: https://github.com/ldbc/ldbc_snb_interactive_v2_impls\n* SNB Business Intelligence (BI):\n  * Data generator: https://github.com/ldbc/ldbc_snb_datagen_spark\n  * Driver and reference implementations: https://github.com/ldbc/ldbc_snb_bi\n\n## How to cite LDBC benchmarks\n\n* **Social Network Benchmark:**\n  * **Detailed specification:** [The LDBC Social Network Benchmark](https://arxiv.org/pdf/2001.02299.pdf) by the LDBC Social Network Benchmark task force and contributors, arXiv/CoRR abs/2001.02299, 2020. [[bib](bib/specification.bib)]\n  * **BI workload:** [An early look at the LDBC Social Network Benchmark's Business Intelligence workload](https://ldbcouncil.org/sites/default/files/ldbc-bi-grades.pdf), GRADES-NDA at SIGMOD 2018 by G. Szárnyas et al. [[bib](bib/snb-bi.bib)]\n  * **Interactive workload:** [The LDBC Social Network Benchmark: Interactive Workload](https://ir.cwi.nl/pub/23380), SIGMOD 2015 by O. Erling et al. [[bib](bib/snb-interactive.bib)]\n* **Related benchmarks:**\n  * **LDBC Graphalytics:** [LDBC Graphalytics: A Benchmark for Large-Scale Graph Analysis on Parallel and Distributed Platforms](https://www.vldb.org/pvldb/vol9/p1317-iosup.pdf), VLDB 2016 paper by A. Iosup et al. [[bib](bib/graphalytics.bib)], [The LDBC Graphalytics Benchmark](https://arxiv.org/pdf/2011.15028.pdf), technical report [[bib](bib/graphalytics-specification.bib)]\n  * **LDBC Semantic Publishing Benchmark:** [Benchmarking RDF Query Engines: The LDBC Semantic Publishing Benchmark](http://ceur-ws.org/Vol-1700/paper-01.pdf), BLINK at ISWC 2016 by V. Kotsev et al. [[bib](bib/spb.bib)]\n  * **LSQB (Labelled Subgraph Query Benchmark):** a [microbenchmark](https://github.com/ldbc/lsqb) focusing on subgraph queries (graph pattern matching) using labelled graphs produced by the LDBC data generator. [[bib](bib/lsqb.bib)]\n\n## How to build the this document\n\n**This repository contains the LaTeX source for the specification** of the LDBC Social Network Benchmark. This README discusses how to build the [specification PDF](https://ldbcouncil.org/ldbc_snb_docs/ldbc-snb-specification.pdf) from source.\n\n### Generating query cards\n\nTo get consistent formatting, query cards are generated from query specifications defined in [YAML](https://yaml.org/) format. This is a necessary step to compile to the document.\n\nInstall Pandoc, Python, and the required packages:\n\n```bash\nscripts/install-dependencies.sh\n```\n\n### Building the document\n\nTo build the document locally, run `make` or `make texfot`. The latter requires Perl but produces a cleaner output.\n\nWe also provide a [GitHub Action repository and a Docker container](https://github.com/ldbc/document-builder) and [images on Docker Hub](https://hub.docker.com/r/ldbc/document-builder). To use this locally, run:\n\n```bash\ndocker run --rm --volume=`pwd`:\"/github/workspace\" ldbc/document-builder:2021 texfot query_cards workloads \u0026\u0026 sudo chown -R ${USER}:${USER} .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fldbc%2Fldbc_snb_docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fldbc%2Fldbc_snb_docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fldbc%2Fldbc_snb_docs/lists"}