Skip to content

3.4.6. Manage Semantic Data Dictionaries

Paulo Pinheiro edited this page Sep 11, 2019 · 9 revisions

How semantic data dictionaries (SDDs) are created

There is one way of creating an SDD:

  • by writing an SDD file as described in Section 5.4 and manually submitting the SDD file for ingestion as described in Section 3.2.1.

Hint: An SDD file, which is an spreadsheet file, can be entirely created outside of HADatAc using an ordinary spreadsheet editing tool like MS Excel, or entirely created inside of HADatAc using the SDD Editor of Working Files (See Section 3.3.2). For small SDD files (with 10 or less attributes), our recommendation is to develop SDDs inside of HADatAc because of the SDD Editor mechanisms to select terms and verify the SDDs. For larger SDD files, we understand that it may be more flexible to edit SDDs outside of HADatAc. In this case, our suggestion is the partially edit SDDs outside of HADatAc but still use the internal editor to select terms, and more importantly, to verify SDDs. In this hybrid scenario, the upload and download operations of Working Files should be used to switch editing environment.

Semantic data dictionary management operations

The figure below shows the data dictionary management page with two SDDs. The name and version of each SDD is shown along with the total number of attributes and objects specified inside the SDD.

For each existing SDD, the SDD management page supports the following operations:

  • View SDD
  • Delete SDD

View SDD

This view of the ingested SDD, i.e., as encoded inside of the knowledge graph. This is the exact view of the knowledge used to ingest data files that is inside of HADatAc's knowledge graph.

When compared against original SDD files, this view has the benefit of separating attributes from objects, and of replacing every available URI in the original SDD with its corresponding label.

Hint : Whenever possible, when showing SDDs, term URIs are replaced by labels. If no label is found for a given URI, the view will show the URI itself. Thus, the presence of URIs in the SDD view is a strong indication that one of the following two problems:

  • the URI is not a valid term - it is not from a valid namespace, or it is a term that does not exist in the given namespace, or
  • the knowledge required for loading the ontology is not available in the knowledge graph.

Delete SDD

The confirmation dialog below is shown before an SDD knowledge in the triple store is deleted. This option is not going to delete the corresponding SDD file from HADatAc processed folder. To deleted the SDD file, follow the procedure described in Section 3.2.3.

Data Owner Guide

  1. Installation
    1.1. Installing for Linux (Production)
    1.2. Installing for Linux (Development)
    1.3. Installing for MacOS (Development)
    1.4. Deploying with Docker (Production)
    1.5. Deploying with Docker (Development)
    1.6. Installing for Vagrant under Windows
    1.7. Upgrading
    1.8. Starting HADatAc
    1.9. Stopping HADatAc
  2. Setting Up
    2.1. Software Configuration
    2.2. Knowledge Graph Bootstrap
    2.2.1. Knowledge Graph
    2.2.2. Bootstrap without Labkey
    2.2.3. Bootstrap with Labkey
    2.3. Config Verification
  3. Using HADatAc
    3.1. Initial Page
    3.1.1. Home Button
    3.1.2. Sandbox Mode Button
    3.2. File Ingestion
    3.2.1. Ingesting Study Content
    3.2.2. Manual Submission of Files
    3.2.3. Automatic Submission of Files
    3.2.4. Data File Operations
    3.3. Manage Working Files 3.3.1. [Create Empty Semantic File from Template]
    3.3.2. SDD Editor
    3.3.3. DD Editor
    3.4. Manage Metadata
    3.4.1. Manage Instrument Infrastructure
    3.4.2. Manage Deployments 3.4.3. Manage Studies
    3.4.4. [Manage Object Collections]
    3.4.5. Manage Streams
    3.4.6. Manage Semantic Data Dictionaries
    3.4.7. Manage Indicators
    3.5. Data Search
    3.5.1. Data Faceted Search
    3.5.2. Data Spatial Search
    3.6. Metadata Browser and Search
    3.7. Knowledge Graph Browser
    3.8. API
    3.9. Data Download
  4. Software Architecture
    4.1. Software Components
    4.2. The Human-Aware Science Ontology (HAScO)
  5. Metadata Files
    5.1. Deployment Specification (DPL)
    5.2. Study Specification (STD)
    5.3. Semantic Study Design (SSD)
    5.4. Semantic Data Dictionary (SDD)
    5.5. Stream Specification (STR)
  6. Content Evolution
    6.1. Namespace List Update
    6.2. Ontology Update
    6.3. [DPL Update]
    6.4. [SSD Update]
    6.5. SDD Update
  7. Data Governance
    7.1. Access Network
    7.2. User Status, Categories and Access Permissions
    7.3. Data and Metadata Privacy
  8. HADatAc-Supported Projects
  9. Derived Products and Technologies
  10. Glossary
Clone this wiki locally