Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/neo4j-examples/game-of-thrones
Neo4j Database of A Song of Ice and Fire - Game of Thrones
https://github.com/neo4j-examples/game-of-thrones
Last synced: 3 months ago
JSON representation
Neo4j Database of A Song of Ice and Fire - Game of Thrones
- Host: GitHub
- URL: https://github.com/neo4j-examples/game-of-thrones
- Owner: neo4j-examples
- Created: 2017-07-30T18:02:41.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-10-22T21:27:09.000Z (over 3 years ago)
- Last Synced: 2024-01-16T10:12:55.464Z (5 months ago)
- Size: 639 KB
- Stars: 45
- Watchers: 6
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Lists
- awesome - game-of-thrones - Neo4j Database of A Song of Ice and Fire - Game of Thrones (Others)
README
# Game of Graphs
Creating a Neo4j Graph Database (and more) based on Game of Thrones (A Song of Ice and Fire) data.
## Data Source
Westeros data can be retrieved from [An API of Ice And Fire](https://anapioficeandfire.com/Documentation) by Joakim Skoog.
The [repository](https://github.com/joakimskoog/AnApiOfIceAndFire) contains the original JSON files, so we can use them directly.
* https://raw.githubusercontent.com/joakimskoog/AnApiOfIceAndFire/master/data/houses.json
* https://raw.githubusercontent.com/joakimskoog/AnApiOfIceAndFire/master/data/characters.json
## GraphQL Setup
### Schema
See [got-schema.graphql](./got-schema.graphql)
* Person (name, titles, houses, ...)
* House (name, allies, follows, followers, founder, words, ...)
* Seat (name)
* Region (name)
Spin up a Neo4j Sandbox with the data and push our schema file.
```
npm install -g neo4j-graphql-cli
neo4j-graphql got-schema.graphql
```
## Data Import
Either run the content of the import scripts `got-import.cypher` in Neo4j Browser or via cypher-shell
```
# one of these
apt-get install cypher-shell
brew install cypher-shell
# and then
cypher-shell -a bolt://: -u neo4j -p < got-import.cypher
# or using Docker
docker run -ti -p `pwd`:/import neo4j /bin/sh -c '/var/lib/neo4j/bin/cypher-shell -a bolt://: -u neo4j -p < /import/got-import.cypher'
```
## Queries
Via GraphiQL, instructions below copied from Neo4j Sandbox:
1. Your GraphQL endpoint is available at `https://<10-0-1-...-.....>.neo4jsandbox.com/graphql/`. We use HTTP Basic Auth, so be sure to set an auth header: `Authorization: Basic xYXcXCCXCXCXCXCXCXCXCXCX=`
2. Explore your GraphQL API with our hosted `GraphiQL IDE`.
Example GraphQL Query
```
{
House(name: "House Stark of Winterfell") {
name
words
founder {
name
}
seats {
name
}
region {
name
}
follows {
name
}
followers(first:10) {
name
seats { name }
}
}
}
```
3. Visit the `Neo4j Browser`. You'll automatically be authenticated.
Example Cypher queries:
```
MATCH path = (p:Person {name:"Steffon Baratheon"})-[:PARENT_OF*]->()
RETURN path
```
## Other Datasources
* [Network of Thrones](https://networkofthrones.wordpress.com/) by Andrew Beveridge, Character interactions
* William Lyon [Import and Analytics of the above into Neo4j](http://www.lyonwj.com/2016/06/26/graph-of-thrones-neo4j-social-network-analysis/) `:play https://guides.neo4j.com/got`
* Wikia Data via Mark Needham [Repository](https://github.com/mneedham/neo4j-got): `:play https://guides.neo4j.com/got_wwc`
* Tomaz Bratanic [Battles from Kaggle data](https://tbgraph.wordpress.com/?s=Game+of+Thrones)
* Chris Willemsen, [NLP Analytics on GoT Books](https://graphaware.com/neo4j/2017/07/24/reverse-engineering-book-stories-nlp.html)