Arxiv's ML papers network graph and browser
Branch: master
Clone or download
Pull request Compare This branch is 102 commits ahead of karpathy:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
static
templates
.gitignore
LICENSE.md
README.md
all_arxiv_categories.json
analyze.py
arxiv_graph.jpg
buildsvm.py
create_authors_db.py
create_index.py
download_pdfs.py
fetch_citations_and_references.py
fetch_papers.py
graph_generator.ipynb
logger.py
make_cache.py
parse_pdf_to_text.py
reddit_keys_template.json
reddit_post.txt
reddit_utils.py
relevant_arxiv_categories.json
requirements.txt
restart_server.sh
run_background_tasks.py
schema.sql
serve.py
thumb_pdf.py
twitter_daemon.py
twitter_users.json
ui.jpeg
utils.py
voting.py

README.md

MLG - Visual Machine Learning arxiv Graph and Textual explorer

MLG (Machine Learning Graph) is a visual representation of ML researchers and papers, and the connections between them. Each node in the graph (/citations_network) is an author or a paper, and an edge can represent a citation, a reference or a authorship.

Note: There is an old version of the graph (/network) in which edges represent co-authorship of papers, based solely on arXiv.org.

Live demo is available at Lyrn.ai.

MLG allows you to:

  1. Search for papers or authors.
  2. Navigate between related papers and authors.
  3. Click on a node to view its list of papers and double click to expand its connections.
  4. Re-organize the network after expanding.

The backend is based on arxiv-sanity but with a lot of modifications:

  • The papers data is collected from arxiv.org and semanticscholar.org. Everything is stored on MongoDB.
  • Rebuilt the Twitter daemon - it now collects tweets from a list of prominent ML accounts, in addition for searching arxiv.org links on Twitter.

The project includes three parts:

  1. / - arXiv text explorer.
  2. /citations_network - The new visual network graph explorer.
  3. /network - The old arXiv visual graph explorer.

NewVersion

Example of the old version:

user interface

Dependencies

$ virtualenv env                # optional: use virtualenv
$ source env/bin/activate       # optional: use virtualenv
$ pip install -r requirements.txt

There is still some legacy code from arxiv-sanity that require some of the packages in the requirement.

Processing pipeline

  1. Install and start MongoDB
  2. Optional - Run fetch_papers.py to collect all paper from arXiv. Run fetch_citations_and_references.py to collect data from semanticScholar.org.
  3. Create twitter.txt with your Twitter API credentials (values of consumer key and secret, in separate lines). You can also add accounts to the twitter_users.json file.
  4. Run run_background_tasks.py to start background tasks scheduler.
  5. Run the flask server with serve.py.

Old version - Generating the network graph

After fetching papers from arXiv you can build the network graph by running the notebook graph_generator.ipynb. It will overwrite the static/network_data.json.

Note: Calculating the physics of the network (nodes' position) is very slow. The current hack is to run it once (by changing the physics settings in network.js) and store the calculated positions. I tried using networkX to calculate the positions, however, the results weren't pleasing...

Running online

If you'd like to run the flask server online (e.g. AWS) run it as python serve.py --prod.

You also want to create a secret_key.txt file and fill it with random text (see top of serve.py).