ResearchSpace for Desktop

Available for Windows, Mac OS X and Linux.
ResearchSpace is free to download with open source initiative licence.

ResearchSpace for Desktop

Available for Windows, Mac OS X and Linux.
ResearchSpace is free to download with open source initiative licence.

ResearchSpace for Desktop

Available for Windows, Mac OS X and Linux.
ResearchSpace is free to download with open source initiative licence.

Start ResearchSpace

  • start the platform running the command from terminal
    chmod +x
  • Open http://localhost:10214/ in your browser
  • Login with username:admin and password:admin
  • You must be running at least Java 11 JDK and node 12


This download provides an installation with some example data and profiles. The zip file just needs to be expanded and then started using ./ for Linux and Mac or start.bat for Windows. When you start the system and login there is a Dashboard which uses the page name “Start”. Start is configured to be the first page opened when you login, but can contain any template and content.


Finding your way around ResearchSpace 1 – Clipboard

The main screen displays a template but on either side their ate two collapsible bars. On the left side there is a vertical bar with the words ‘clipboard’. Clicking this opens a clipboard where resources can be referenced. Resources can be dragged and visualized in personal folders. It can be resized across the screen.

Finding your way around ResearchSpace 2 – Entity Cards

On the right hand side there is another vertical bar with the words, “Details”. This is used to show the details of resources. If you click this it will initially be empty. Hover over Leonardo di Vinci and you will see various icons. Click the Details icon.

Finding your way around ResearchSpace 3 – Details Pane

The details bar will open and show any data attached to that resource.

Both the details bar and the clipboard bar can be customized to perform different tasks and display different data.

Finding your way around ResearchSpace 4 – Thinking Frames

On the top bar there is a menu item called “Thinking Frames”. Click this and see a variety of options for working with data.

The base ResearchSpace system works with maps, data graphs, semantic narratives (data embedded into text), entity observation through images, and may other tools.

Finding your way around ResearchSpace 5 – Thinking Frames

From the clipboard drag the Object card – Vitruvian man – from the clipboard to the Thinking Frame option box – Entity Editor.


The Dashboard is just a template containing HTML and HTML components. As an admin user you can edit the template. If you click “Edit Page” option in the top right corner you will open the Start template for editing but see [[> rsp:ProjectDashBoard]]. This is just an embedded template. You can see what is in this template by clicking the link ate the top of the page. All embedded templates are listed. You can nest templates as much as you want. If I replace this template with another, when you start ResearchSpace you will get the new page.

A template is a resource. If you want to create your own landing page with menu items this can be achieved with normal html and using the semantic link control (see later).

To create a new blank page just define a new page in the address bar. If you append to the base URL (localhost:10214/resource/) with rsp://mynewpage, then a blank page is created. You can then add some content. Embedding templates provides flexibility, and templates can talk to each other and pass parameters.

Click on the Clipboard bar

The clipboard is adjustable. It can be dragged across the screen. The clipboard bar is collapse on the left side of the screen.

The clipboard holds folders and opens at the root of those folders. The download install has two entities. One is a person and one is an object.

Above these entities is a folder. This folder has a little network symbol to show that it was created from a knowledge map (see later). A normal container folder can be created using the new folder button.

Most resources within ResearchSpace can be dragged to and from a clipboard folder.


Clipboard Example

For example, Click Thinking Frames and then Entity Editor.

Choose Object. With the clipboard open, add a new folder and use the return key to save your folder name.

Open the new folder.

From the object list (there is only one object) drag it to the folder and release. It is now referenced in your clipboard.

choose entity editor

Different Entities Cards

Although the two cards look the same – one is an object and one is an image entity, but both use the same digital image as a representation of the entity.

Understanding Entity Cards

An entity card is a visualisation of a URI resource. The object Vitruvian man has a URI which is of type Human-Made Object. It also has a representation (an image) associated with it – which is automatically rendered in the card. It may also be part of a much wider network of contextual information.

Since the card simply represent a URI is can be passed to different tools and templates to allow further authoring.

The overlay for entities simply provides a link to different tools and template passing the URL as a parameter.

For example, if i click the resource icon, then the resource template is loaded and immediate relations for that entity displayed.

Entity Resource Template

A visualization component takes all the patterns relevant to the entity and display them on screen. As new relations are added they added to the resource display automatically.

In a different example, the Observation tool initiated through the observation icon is about adding new information about an entity, but using an image representation as the reference. The entity URI is used not the image.

Authority and Entity Management

ResearchSpace is about knowledge enrichment but it also provides tools for general management of entities and authorities.

Authority Management is accessed from the setting menu item – the cog at the top of the header bar.


Authority Manager supports profiles for defining consistent conventions for organising and presenting input forms. These profiles define further filtering (types of the same entity) and definitions for labels, order, restrictions and heirarchy. If a profile does not specify an authority membership then it is a general entity template and will appear in Entity Editor. If it does, then it becomes and authority template and can be used to set up a new authority in Authority Manager (used for specifying standard instances and vocabulary concepts).

A form is also specified which is used as the template for an Entity or Authority.

Entity Semantic Form

At the top of an entity form the initial parameters are set for storage and URI definitions along with some default settings. If you are using Authority Manager then variables are used which are based on the profile setup. In this example, a named graph is specified for persistence.

The new subject template is the URI used for new instances of this entity as they are created. In this case the variable {{scheme}} is taken to create the URI from the profile – with an added {{UUID}} for uniqueness for each instance.

If not using Authority Manager, then you would simple use your own conventions

E..g. new-subject-template=’{{UUID}}’

The fields are simply references to knowledge patterns which contain specific Sparql database routines (INSERT, SELECT etc)

Input Fields

These variables are then visualised in form components for form input authoring. E.g.Forms can also be nested in fields – for example authority lookup and creation.

Authority Manager Authority manager uses the same forms to create new authorities

Create Authority

Adding an authority involves choosing from the available profiles which form the new authority. Vocabularies draw upon the term profile (which can use skos or E55_Type) while real instance authorities use other entities.

Search System

The each system can search everything or can have different configurations for different entities and groups of entities. It can also use categories assigned to different knowledge patterns.

Search Template

Search is an embedded template and can be isolated using the URI http://localhost:10214/resource/rsp:SearchContent

Different searches can be out between different <bs-tab> tags

In the default search all entities are by default displayed

Sparql queries determine exactly what entities are part of a search and semantic facets are also defined by a query.

When you use the search from an entity editor page – it defaults to that entity.

Search Template Semantic Filter

The first part of the configuration is a query that selects relations for filtering the search results. The query does this;

It selects patterns (fields) which have the category “summary”

Label Search

Along with the semantic facet search, text fields can be indexed to for a combined text search.

Default Query

This determines which results are displayed when the search is initially opened. The reason that there is a reference to authority_manager – is that a search can be initiated from an entity template which only uses the type of that template.

Knowledge Map Config

Knowledge Map’s allow free form graph creation partiuclar useful for qualitative connection and enriching existing information. Knowledge Maps have access to literally 100’s of knowledge patterns, some of which sre overlapping and can create duplicate relations. However, it can be configured to exclude patterns not wanted or needed. The configuration that selects the knowledge patterns available are in the template – <your domain>KnowledgeMapOntodiaConfig?action=edit. Which can also be reached through the Template manager in Admin



rsp:KnowledgeMapOntodiaConfig?action=edit fields-query=’PREFIX field: <>

SELECT DISTINCT ?field WHERE { ?field a <> . ?field <> ?category .

FILTER (?category in (<>))}’>


Knowledge Map Patterns

Categories can be set up and applied to knowledge Patterns which are then filtered in the Knowledge Map system.

Start ResearchSpace

  • start the platform running the command from terminal
    chmod +x
  • Open http://localhost:10214/ in your browser
  • Login with username:admin and password:admin