Orange3 Story Navigator
Orange3-Story-Navigator is an add-on for the Orange data mining software package. It provides quantitative textual story analysis features based on principles in narrative psychology. The aim of the Story Navigator is to support human analysis of stories represented in digital texts, with a 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
This section is for those who want to install the Story Navigator purely for analysing stories with no plan to develop or extend the add-on.
Method 1
Requirements:
Steps:
- First install Orange. Instructions are here
- Fire up Orange, navigate to the Orange add-on installer which is available in the Options -> Add-ons menu. Note: the add-on requires Orange3-text and Orange3-network so first install these libraries before installing
storynavigator.- Click on the
Add more...button on the top right of the window- Type in
storynavigatorin the textbox and click on theAddbutton- Click on the
OKbutton- The
storynavigatoradd-on should install and Orange may ask you to restart it to view the new add-ons. Click on theOKbutton to do so.
Method 2
Requirements: Python 3.9.12+
Step:
pip install storynavigator
User documentation
Available here
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-canvasorpython -m Orange.canvas
The Orange3 application should shortly start up with a splash screen
Testing
Run tests with pytest.
For coverage:
coverage run -m pytest
coverage report
# or
coverage html
Collaborators
The Story Navigator is maintained by the Netherlands eScience Center in collaboration with the Faculty of Behavioural, Management and Social Sciences (BMS) at the University of Twente.
2 maintainers
Metadata
2 maintainers
Release files for storynavigator 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| storynavigator-0.2.3.tar.gz | 4.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| storynavigator-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.8 MB
Release files / storynavigator-0.2.3.tar.gz
| Download URL | storynavigator-0.2.3.tar.gz |
|---|---|
| Size | 4.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ebd458bc9e9b6c0dca345533827bb614d1b162c13ab084b22c65e5a0cc4ae2ef
|
|
BLAKE2b-256 checksum How to use checksums |
a3dc78d27192b8057d432e72989a4d1cbef81f0f559cd16e396feabed90ed355
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency logRelease files / storynavigator-0.2.3-py3-none-any.whl
| Download URL | storynavigator-0.2.3-py3-none-any.whl |
|---|---|
| Size | 575.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e0e5a1b41e5e1558b1543261d0109c63b0370471a51113aad9093cf3a174371
|
|
BLAKE2b-256 checksum How to use checksums |
86d55ff4db5607725abd79436b9b72230c20208766fa3d389b0df3855366970a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 23, 2026.
Transparency log
