TREEcg / tree-metadata-extraction

Metadata extraction lib for TREE metadata from RDF files.
0 stars 1 forks source link

TREE metadata extraction

This library handles the extraction of TREE metadata from RDF data.

Installation

Node

const extractMetadata = require('@treecg/tree-metadata-extraction').extractMetadata

typescript

import { extractMetadata } from '@treecg/tree-metadata-extraction';

Usage

// quads is an array of RDF Quads (RDF.Quad[])
const metadata = extractMetadata(quads)

// Retrieve extracted collections metadata
for (const collectionId of metadata.collections.keys()) {
  const collection = metadata.collections.get(collectionId)
}

// Retrieve extracted nodes metadata
for (const nodeId of metadata.nodes.keys()) {
  const node = metadata.nodes.get(nodeId)
}

// Retrieve extracted relations metadata
for (const relationId of metadata.relations.keys()) {
  const relation = metadata.relations.get(relationId)
}

Extracted metadata

In this section, the extracted fields per class are listed. In the case an Object is returned, it can have arbitrary fields that are not listed below.

Object Metadata field type referenced object type
Collection @id string
@type [ string ]
view [ URI ] Node
subset [ URI ] Node
member [ URI ] Member
shape [ Shape ]
totalItems [ Literal ]
import [ URI ]
importStream [ URI ]
conditionalImport [ ConditionalImport ]
... [ any ]
Node @id string
@type [ string ]
relation [ URI ] Relation
search [ object ]
retentionPolicy [ RetentionPolicy ]
import [ object ]
importStream [ object ]
conditionalImport [ ConditionalImport ]
... [ any ]
Relation @id string
@type [ string ]
remainingItems [ Literal ]
path [ object ] shacl:propertyPath
value [ object ]
node [ URI ] Node
import [ URI ]
importStream [ URI ]
conditionalImport [ ConditionalImport ]
Member ... [ any ]
Shape ... [ any ] shacl:NodeShape / shex:Shape
IriTemplate ... [ any ] hydra:IriTemplate
ConditionalImport path [ object ] shacl:propertyPath
import [ URI ]
importStream [ URI ]
RetentionPolicy @type [ string ]
amount [ Literal ]
versionKey [ object ]
path [ object ] shacl:propertyPath
value [ object ]
Literal @value [ string ]
@type [ string ]
@language [ string ]
URI @id string
object @id string
... [ any ]
Note: Blank node URIs can be returned as a URI. 
We expect any additional data used in combination with the extracted metadata to be retrieved from the same rdfjs data factory.

Examples

Retrieve the ids of all members of all collections available in the quad array.

// Parse the input into a quad array
const quads = parse(input)

// Extract the tree metadata from the quad array
const metadata = extractMetadata(quads)

const memberIds = []

// Retrieve extracted collections metadata
for (const collectionId of metadata.collections.keys()) {
  // Get the collection object
  const collection = metadata.collections.get(collectionId)
  // Map the member URIs to extract the @id values
  const memberURIs = collection.member.map(uri => uri["@id"])
  // Store the @id values
  memberIds = memberIds.concat(memberURIs)
}

return memberIds