pbshm-framework 0.5

PBSHM Framework

PBSHM Framework

The PBSHM Framework is a preconfigured version of the PBSHM Core and module ecosystem. The goal of the PBSHM Core, was to build a base application which facilitated the curation of PBSHM Modules which intern consume PBSHM Schema data. The purpose of the PBSHM Framework is to provide a single packaged product of the PBSHM Schema, PBSHM Core, and any relevant PBSHM Modules: to showcase the available technology in an easy to use manner and enable anyone, regardless of their coding knowledge, to interact with the aforementioned technology.

For more information on the PBSHM Core, please see the GitHub repository. Each module included within the PBSHM Framework is linked below, with details of the module authors and any further information on how to use the module. For more information on how to create a module for PBSHM Core, please see the module template repository.

The minimum version of Python required to run the PBSHM Core is version 3.9.18.

Included modules

Below is a list of modules included within the framework and links to the corresponding repositories and guides.

Module	Description	Author	Repo	Documentation
pbshm-channel-toolbox	A collection of tools to help processing channel data	dsbrennan	dsbrennan/channel-tools	README
pbshm-ie-toolbox	A collection of tools to help processing IE models	dsbrennan	dsbrennan/ie-tools	README
pbshm-network-mcs	An implementation of the Jaccard Index and Maximum Common Subgraph to generate network similarity scores for a a given set of IE models	jgosliga	dynamics-research-group/ag-mcs	README
pbshm-ie-visualiser	A 3D model builder for creating, editing, and viewing IE models	josiemcculloch	dynamics-research-group/pbshm-ie-model-builder	README

Installation

Install the package via pip:

pip install pbshm-framework

Setup

Set the Flask application path and environment.

For Linux/Mac:

export FLASK_APP=pbshm
export FLASK_DEBUG=1

For Windows:

set FLASK_APP=pbshm
set FLASK_DEBUG=1

Configure settings and initialise the database with a new root user:

flask init config
flask init db new-root-user

The above steps will prompt you for all the required fields to set up the system.

Running

The application is run via the standard Flask command:

flask run

Bug reporting

If you encounter any issues/bugs with the system or the instructions above, please raise an issue through the issues system on GitHub.