storystructure

Tools for analysing the structure of branching stories


License
MIT
Install
pip install storystructure==1.0.2

Documentation

storystructure

A Python package to explore the structure of branching stories. Documentation <https://sellisd.github.io/storystructure/>

Requirements

The module has been developed with python 3.6.6 and the following modules. Other versions might work also but have not been tested:

  • pathlib2 v.2.2.0
  • pandas v.0.19.2
  • numpy v.1.11.3

Installation

pip install storystructure

Example usage

To use the package two input data files are necessary:

  • An edgelist file with columns source and target
  • A node attributes file with columns node and attribute. The attribute column must be on of the following values good, bad, pause.
from storystructure.storystructure import storystructure
# create a new object
s = storystructure.storystructure()
# load an edgelist and node attributes
s.loadStory(edges='edgelist.csv',
            nodes='nodeAttributes.csv')
s.saveFig('graph'.png')     # Make figure
s.simplify() # Removing self loops and double edges
s.makeGraph()
s.savePathStats('allPaths.dat')

An more detailed example is included in the jupyter notebook scripts/Tutorial.ipybn