Generates easily readable citation graphs. This uses the contents of a bibtex file to determine what you're interested in.
This uses the semanticscholar API to fetch references for articles. Since the API is rate-limited and requests are very slow, request results are cached locally, and the exploration algorithm is engineered to make every request count. This is done by computing a degree of interest (DOI) for each known paper, and fetching only the papers we think will improve the graph the most. See here for an explanation of the DOI calculation.
- Make sure you have Python 3.6+
- Also make sure you have Graphviz on your path
- Download or clone this repo
$ git clone https://github.com/oowekyala/citegraph.git && cd citegraph- Make sure you have all the required Python packages:
$ python3 -m pip install -r DEPENDENCIES- Add the
bindirectory to you PATH, or just usebin/citegraph
Find out the ID of an interesting paper on semanticscholar.org, see for example the highlighted section of this picture:
Remove spaces, and you can pass that ID directly to citegraph:
$ bin/citegraph CorpusID:125964925
[1 / 80 / 145] (DOI 0.0) Fractal calculus and its geometrical explanation
[2 / 80 / 145] (DOI 1.25) Fractal approach to heat transfer in silkworm cocoon hierarchy
...
[80 / 80 / 5602] (DOI 1.428) Bubble Electrospinning for Mass Production of Nanofibers
Hit max size threshold
Rendering...
Rendered to graph.pdfHere's what the graph would look like (using a max --size of 20 for readability):
Use citegraph --help to find out about all the options.
By default the exploration algorithm is biased towards exploring
downward links. To also explore the papers that cite your root
papers, you can use the option --also-up.
Compare for example the two following graphs (root paper in pink):
- Default:
- With
--also-up:
Export formats are selected using the --format (-f) option.
The following formats are suitable for importing the graph into an external graph visualisation tool:
Citegraph can also call Graphviz directly to perform graph
layout and rendering to another format, for example PDF, PNG,
or SVG. The default export format is PDF, see the available ones
with --help.
You can specify how individual nodes are styled with a yaml file. For example:
tags:
read: # an identifier for the tag
attrs: # DOT attributes: https://graphviz.gitlab.io/doc/info/attrs.html
style: bold
members: # enumerate explicit members using keys of the bibtex file
- someBibKey
- another
knuth_articles: # another tag
attrs:
style: filled
fillcolor: lightyellow
# Select using an arbitrary python expression
# The bibtex entry is in scope as 'paper'
selector: 'any("Knuth" in author.last_names for author in paper.authors)'
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent