storynavigator 0.0.3

Narrative analysis add-on for the Orange 3 data mining software package.

Orange3 Story Navigator

Orange3-Story-Navigator is an add-on for the Orange data mining software package. It provides story textual analysis features based on principles in narrative psychology. The aim of the widgets in the Story Navigator Orange module are to support human analysis of stories represented in digital texts with a main focus on identifying and describing the following components of the narrative (see [1], [2] and [3] for definitions and theory):

1. Setting
2. Main agent
3. Means
4. Acts and events
5. Purpose
6. Breach

[1] Burke, K. (1969). The grammar of motives. Prentice Hall, New York. Originally published in 1945. [2] M. Murray and A. Sools, P. Rohleder, A.C. Lyons (Eds.), Qualitative research in clinical and health psychology, Palgrave MacMillan, Houndmills Basingstoke (2015), pp. 133-154 [3] Andrade, S. B., & Andersen, D. (2020). Digital story grammar: a quantitative methodology for narrative analysis. International Journal of Social Research Methodology, 23(4), 405-421.

Installation:

Requirements:

1. Orange3
2. Orange3-text
3. Orange3-network

This section is for those who just want to install and use the add-on in Orange3.

Install from Orange add-on installer through Options - Add-ons. Note: the add-on requires Orange3-text, so first install this library before installing orange-story-navigator.

To install the add-on with pip use

pip install orange-story-navigator

Development:

This section is for those who want to build the add-on from source and extend, customise, or fix bugs in it. Note: Mac M1 (Apple silicon) users may encounter problems with building orange-story-navigator using certain Python 3.8.x or 3.9.x versions and / or actually building or running these specific Python versions at all on your Mac. If you encounter such issues, it is recommended to install Rosetta 2 and always run the terminal using Rosetta 2 (see how to do the latter here) for development tasks.

Requirements:

1. A tool for checking out a Git repository
2. Python 3.9.16+

Steps to build and test from source:

1. Get a copy of the code

   git clone [e-mail]:navigating-stories/orange-story-navigator.git

2. Change into the orange-story-navigator/ directory

   cd orange-story-navigator

3. Create and activate a new Python virtual environment using virtualenv

4. Run the following command

   pip install -r requirements.txt

5. If Step 4. completed with no errors, run this command

   pip install -e .

This command installs the widget and registers it with your Orange3 installation. If you encountered an error during Step 4, file an issue with the details and skip the remaining steps.

6. Run

   orange-canvas

or

python -m Orange.canvas

The Orange3 application should start up after a few seconds and you can test the orange-story-navigator widgets.