/Marvel

Build networks from Marvel's API

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

MARVEL graphs

An app that displays network maps of Marvel characters or creators where each one is positionned close to those he/she is most linked with as registered within Marvel's API.

Visit it here: https://marvel-graphs.net/

screenshot appshot

Installation

  • Build the data

    pip install -r requirements.txt
    cp config.yml{.example,}
    # set API key from http://developer.marvel.com/signup
    python bin/download_data.py
  • Prespatialize and run Louvain on graphs

    npm install
    npm run preparegraphs
    npm run aligngraphs
  • Run web interface

    npm install
    # To start locally on http://localhost:3000
    npm start
    # Or to build prod
    npm run build

Credits

Data, comic book images and photographs provided by Marvel's API. © 2022 Marvel

Here are links to the API's detailed documentation & Terms of use.

Entirely built with Free Libre Open Source Software and released as such under the AGPL v3.0 license.

Icons used or adapted from SVG creations under CC Zero Public Domain by agomjo, CC Attribution License by boxicons and MIT license from artcoholic & Bootstrap.

Data collection and preparation in Python 3 using requests and NetworkX.

Web interface and network visualization in Node.js using graphology, Sigma.js, pako and PapaParse, built in TypeScript with kotatsu.

Thanks to @Yomguithereal, @paulgirard, @jacomyal and @jacomyMa for their precious help and ideas!

And lots of thanks to the 2014 Amsterdam Contropedia datasprint where this whole idea germinated before it got buried in my mind and GitHub repositories for 8 long years. :)

@boogheta