ResearchSpace (Review) Documentation

To ResearchSpace (Review)

Overview

LINCS maintains ResearchSpace (Review) as a distinct ResearchSpace environment for researchers with data in LINCS.

ResearchSpace (Review) gives you the same features as the ResearchSpace environment with some additional functionality:

• View and edit your own pre-published data
• Edit the information on the dataset landing page

Consult the documentation for ResearchSpace to learn how to:

• Create an account
• Browse LINCS data
• Search LINCS data
• SPARQL Search
• Create a Knowledge Map
• Create a Semantic Narrative
• Access all Knowledge Maps and Semantic Narratives

note

Knowledge Maps and Semantic Narratives should be created in ResearchSpace, not in ResearchSpace (Review). In the Review environment, you won't be able to share your work. If your Knowledge Map contains unpublished data, the data may change, affecting the work.

Edit an Entity

1. Use Search to find entity you wish to edit.
2. On the Entity Summary Page, click Edit this Entity. You can also access a link to edit an entity by clicking on Edit (pencil icon) on an Entity Card.
3. Edit the entity as needed.
4. Click Save at the bottom of the form. Changes will be saved to the triplestore.

tip

Use the Same As field in the entity editing form to reconcile an entity. You can enter a LINCS URI or a URI from an external authority like Wikidata or Getty.

Delete an Entity

1. Use Search to find entity you wish to edit.
2. On the Entity Summary Page, click Edit this Entity. You can also access a link to edit an entity by clicking on Edit (pencil icon) on an Entity Card.
3. Click Delete at the bottom of the form. This removes the entity from the triplestore

Create a New Entity

In rare cases you may wish to create a new entity from scratch. This requires sufficient understanding of CIDOC CRM.

1. On the homepage, find Create/Edit Entities in the Manage Data box.
2. Find the entity type you wish to create.
3. Click Create a New Entity and fill in the Entity Editor Form.
4. Click Save.

Edit Metadata about Your Dataset Landing Page

1. Click View Metadata on the homepage.
2. Click Edit (pencil icon) on your dataset card.
3. Next to Metadata (Project/Dataset) Form click Use.
4. Edit the Metadata form as needed. (See details about the form below).
5. Click Save.

How to Understand the Dataset Landing Page Metadata Form

These are the fields on the metadata form. The ? icons on the form provide explanations for each field in addition to what is given here. Fields marked with an asterisk (*) are required.

• Named Graph : Please consult with your contact at LINCS or email LINCS before editing this field.

• Title: Please consult with your contact at LINCS or email LINCS before editing this field.

• Short Title: Please consult with your contact at LINCS or email LINCS before editing this field. The Short Title is used to label tabs in ResearchSpace.

• Description: Use this field to briefly describe your dataset. Example: "The Orlando Project's collaborative experiment in feminist literary history started in 1995, published its flagship resource, Orlando: Women’s Writing in the British Isles, in 2006 with Cambridge University Press, and has produced an accompanying linked dataset for LINCS based on the semantic tagging in its 8+ million words of original scholarship about women writers’ lives, works, and cultures."

• Short Description: Use this field to describe your dataset in 1-2 sentences. Example: "The Orlando Project explores and harnesses the power of semantic tools and methods to advance feminist literary scholarship. View Orlando as LOD!"

• Creator: Add as many project creators as desired. Your can add, remove, or edit the list of creators. Use the Edit button to add details about each contributor. These details include:

  • Type: Person or Group/Organization
  • Full Name: Name Lastname
  • Same As: Use this field for personal identifiers like ORCID or VIAF.
  • Role Type: Options include: Researcher, Literary Director, Director, Associate Director, Research Director, Founding Director, Technical Director, Contributor, Registrar
  • Email Address: Enter a valid email address.
  • Contributor: Add as many additional contributors as desired. You can add, remove, or edit the list of contributors. Contributors and creators are not distinguishable on the dataset landing page, so you can simply the use the Creator field for all project creators and contributors.

• Status: The status of your data may be draft, pre-published, or published. Please consult with your contact at LINCS or email LINCS before editing this field.

• Language: Use this field to add as many languages as are reflected in your dataset.

• Source Dataset: This field must be a URL.

• Image: Please consult with your contact at LINCS or email LINCS before editing this field.

• Logo (Or Cover Image): Please consult with your contact at LINCS or email LINCS before editing this field.

• Dataset Landing Page Carousel Images: Your carousel includes three entities from your dataset. If you leave this field blank, ResearchSpace will randomly select three entities from your dataset. To choose the entities which will appear in the carousel:

  • Click +Add dataset landing page carousel images. If you know the IRI for the image enter it in the field.
  • You can find the IRI on the entity's Entity Summary Page. Use the search bar in ResearchSpace and enter the name of an entity which has an associated image. This will take you to the Entity Summary Page. Example: Search Margaret Oliphant.

  

  • Under the Outgoing Statements, locate the has representation property and click the associated value link.

  

  • Click the copy icon next to the Resource Identifier. A confirmation message will appear: "The IRI has been copied to clipboard!"

• Paste the IRI into the field on the metadata form.

• Identifier: Use this field to add an affiliated website, project search page, dataset source URL, archived dataset URL, or Converted LOD Source URL.
• Subject/ Topic: Use this field to add IRIs representing the subject(s) of your dataset:
  • Click +Add subject/topic to search for an existing subject or topic.
  • Scroll through the list of IRIs provided. In this example, the topic of the dataset is "feminism." This is how you decode the IRIs:
    • In the highlighted example, feminism is the label, (http://id.lincproject.ca/cwrc/feminism) is the IRI, (a http://cido-crm.org/cidoc-crm/E89_Propositional_Object) is the type or class, and from http://id.lincsproject.ca/cwrc indicates the dataset this IRI derives from.
• Temporal Coverage: Use this field to indicate the date range covered in the dataset.
• Disclaimer: Use this field if you wish to add a disclaimer to the dataset landng page and/or on the entity pages.