Narrative analysis add-on for the Orange 3 data mining software package.
Project description
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):
- Setting
- Main agent
- Means
- Acts and events
- Purpose
- 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:
- Orange3
- Orange3-text
- 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 storynavigator
.
To install the add-on with pip use
pip install storynavigator
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 storynavigator
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:
- A tool for checking out a Git repository
- Python 3.9.12+
Steps to build and test from source:
-
Get a copy of the code
git clone git@github.com:navigating-stories/orange-story-navigator.git
-
Change into the
orange-story-navigator/
directorycd orange-story-navigator
-
Create and activate a new Python virtual environment using virtualenv
-
Run the following command
pip install -r requirements.txt
-
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.
-
Run
orange-canvas
or
python -m Orange.canvas
The Orange3 application should start up after a few seconds and you can test the storynavigator
widgets.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for storynavigator-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 55cc1594974ca4f906f3996471edf0a60a3bd8079a5d53d11b2d37186e2b41f7 |
|
MD5 | 5a59b2b3617a43dc1715a2681c426adc |
|
BLAKE2b-256 | 449993f60c74c528561edaa6de8e1b7335a31cbe65bd156b3db8ee2825ecb56f |