Skip to content
paco xander nathan edited this page Nov 3, 2025 · 27 revisions

Metadata Application Profile

Introduction

The following provides a concise SKOS-based taxonomy used for representing the Senzing entity resolution (ER) results in the computable semantics of RDF, based on the data mappings defined in the Senzing Entity Specification.

One intention is to align with popular controlled vocabularies used by Senzing partners, such as NIEM by OASIS Open, FollowTheMoney by OpenSanctions, and the Beneficial Ownership Data Standard by Open Ownership.

Effectively, this creates as a domain-specific thesaurus, which may be used:

Namespace: https://github.com/senzing-garage/sz-semantics/wiki/ns#
Suggested prefix: sz:
Source: https://github.com/senzing-garage/sz-semantics/blob/main/domain.ttl
Updated: 2015-11-02
Authors: Paco Nathan, Jessica Talisman, Jeff Butcher

Purpose of this document

A metadata application profile (MAP) is a specification which describes how metadata standards should be used within a specific application, project, or community context. This provides a bridge between general-purpose metadata standards and the real-world practices for a given domain. Instead of inventing an entirely new metadata schema, a MAP serves to:

  • select elements from existing metadata standards -- e.g., SKOS, Dublin Core, BODS, etc.
  • refine the meaning of the elements used -- e.g., require that dcterms:creator must be a person, not an organization.
  • constrain usage -- e.g., requiring particular fields, limiting values to controlled vocabularies, etc.
  • extend with local elements as needed.

Classes

sz:Entity
URI: https://github.com/senzing-garage/sz-semantics/wiki/ns#Entity
Definition: Entity is anything that can be considered, discussed, or observed; in this context, this is generally a Person or Organization
Label: Entity
Same as: skos:Concept, bods:Entity, ftm:LegalEntity, wco:Agent, wd:Q35120
Usage: Top-level concept in the scheme, not intended to be used directly for instances
sz:Organization
URI: https://github.com/senzing-garage/sz-semantics/wiki/ns#Organization
Definition: Organization is a social entity established to meet needs or pursue goals
Label: Organization
Same as: skos:Concept, ftm:Organization, wco:Organization, wd:Q43229
Super-class: sz:Entity
Usage: In entity linking workflows, this can be used as a label for zero-shot NER

Example:

sz:96 a sz:Organization ;
   skos:prefLabel "Univrsl Export Inc"@en ;
   sz:lemma_phrase "NOUN.univrsl NOUN.export NOUN.inc";
   prov:wasDerivedFrom sz:ds_customers_2072, sz:ds_reference_2071 .

[] rdf:object sz:96 ;
   rdf:predicate skos:related ;
   rdf:subject sz:97 ;
   sz:match_key "+REL_POINTER(:GLOBAL PARENT)" ;
   sz:match_level 11 .
sz:Person
URI: https://github.com/senzing-garage/sz-semantics/wiki/ns#Person
Definition: Person is any single member of Homo sapiens, unique extant species of the genus Homo
Label: Person
Same as: skos:Concept, bods:Person, ftm:Person, wco:Person, wd:Q5
Super-class: sz:Entity
Usage: In entity linking workflows, this can be used as a label for zero-shot NER

Example:

sz:22 a sz:Person ;
   skos:prefLabel "Daniella Shaw"@en ;
   sz:lemma_phrase "NOUN.daniella NOUN.shaw" ;
   prov:wasDerivedFrom sz:ds_customers_1032, sz:ds_customers_1033 .

[] rdf:object sz:ds_customers_1032 ;
   rdf:predicate skos:exactMatch ;
   rdf:subject sz:22 ;
   sz:match_key "INITIAL" ;
   sz:match_level 0 .

[] rdf:object sz:ds_customers_1033 ;
   rdf:predicate skos:exactMatch ;
   rdf:subject sz:22 ;
   sz:match_key "+NAME+DOB+PHONE" ;
   sz:match_level 1 .
sz:DataRecord
URI: https://github.com/senzing-garage/sz-semantics/wiki/ns#DataRecord
Definition: Data Record is a composite data type; an information block containing specific, identified fields
Label: Data Record
Same as: skos:Concept, prov:Entity, wco:TransactionalEvent, wd:Q2470517
Usage: In typical usage, an instance will have properties pointing to a named dataset with a unique foreign key

Example:

sz:ds_customers_1032 a sz:DataRecord ;
   dc:identifier "1032" ;
   skos:prefLabel "Daniella Shaw"@en ;
   prov:wasQuotedFrom sz:ds_customers .

sz:ds_customers_1033 a sz:DataRecord ;
   dc:identifier "1033" ;
   skos:prefLabel "Shaw Daniella"@en ;
   prov:wasQuotedFrom sz:ds_customers .

sz:ds_customers a dcat:Dataset ;
   dc:identifier "customers" .

Predicates

predicate domain range definition
sz:match_key sz:Entity xsd:string which features matched when a record last was processed individually; see MATCH-KEY vs. Why
sz:match_level sz:Entity xsd:integer signifies how the source record contributes to this entity; see Understanding Match Levels
sz:lemma_phrase skos:Concept rdf:langString a parsed, lemmatized noun phrase, used as a unique key for entities during entity linking
sz:ner_label skos:Concept xsd:boolean indicates whether the skos:prefLabel value can be used as an NER label
sz:member_of sz:Person sz:Organization indicates when a person is known to be a member of an organization; same as wco:memberOf

Clone this wiki locally