bibgraph builds a citation graph from an annotated bibtex file.

Bibgraph expects to find the following optional fields:

1. cites on every entry to be added to the graph; this contains a list of (keys of) entries cited by that entry
2. tags (optional) marking the status of that document; the following tags are supported:
   1. i - in progress
   2. t - to read
   3. r - read
   4. m - append this tag to each entry you have fully mapped (i.e. checked all interesting references and works that refer to it and added them to the bibliography graph)

This means you have to add these two fields (By hand) if you want to see a graph.

An example entry for a paper citing zhang2009fpga which is in progress and mapped:

@inproceedings{kestur2012towards,
   title = {{Towards a universal FPGA matrix-vector multiplication architecture}},
   author = {Kestur, Srinidhi and Davis, John D and Chung, Eric S},
   booktitle = FCCM,
   pages = {9--16},
   year = {2012},
   cites = {zhang2009fpga},
   tags = {im}
}

1. Pick a paper
2. Set it as t
3. Add it to the bibliography graph
4. Add all interesting references (based on title and context)
5. Add all work citing the paper (e.g. using Google Scholar's Cited By feature)
6. Set is as m
7. Play some Mass Effect...

1. Installed version of Python 3. This script is tested with version 3.8
2. Clone reposiitory

# git clone [email protected]:paul-g/bibgraph.git;
git clone [email protected]:lissonc/bibgraph3.git;

1. Install graphviz on linux

sudo apt-get update;
sudo apt-get install graphviz;

1. Install graphvix on Mac

brew install graphviz;

1. Install Python helper files: Pydot, Bibtexparser, networkx

python3 -m pip install --upgrade pip;
python3 -m pip install pydot bibtexparser networkx;
python3 -m pip freeze| grep pydot; 
python3 -m pip freeze| grep bibtexparser;
python3 -m pip freeze| grep networkx;

Bibgraph3 relies on bibtexparser which only supports BibTeX entry types; not the full set available in BibLaTeX.

For example: @techreport is supported while @report is not. This can be a pain to figure out because it fails silently.

The script can read bibtex entries without cites, and correctly not put this in a graph.

The script can read bibtex entries without tags.

python3 bibgraph.py /path/to/your/bibliography.bib

This produces a bib.png and a bib.pdf file a the bibliography graph like the one below.

• Orginal script - https://github.com/paul-g/bibgraph/
• Fork into python3 script - https://github.com/lissonc/bibgraph3
• Fork into minor adjustments - https://github.com/edzob/bibgraph3