LinkML Schema Explorer

The Semantic Data Type (SDT) specification is defined using LinkML. Browse the schema's classes, attributes, and enums, and download target environment models.

Semantic Data Type Schema

Schema URI https://w3id.org/dartfx/semanticdt

Version 0.1.0-dev

License Creative Commons CC0 1.0

A schema defining Semantic Data Types (SDT) situated above physical database or programming types. Encompasses metadata, mappings, validation, generation, and agentic instructions.

SemanticDataType

A high-level data type associated with a distinct concept, validation/generation rules, and metadata.

ConceptReference

Reference to a concept in an external ontology or vocabulary.

StorageType

Physical or logical storage data type binding.

ClassificationSystem

Controlled vocabulary or coding scheme (making this a categorical variable).

ValidationRule

A rule defining syntactical or logical validation of values.

CodeSnippet

A concrete piece of code or expression implementing logic (e.g., validation, generation) in a specific environment.

GenerationRule

Directive for synthetic data generation.

AgentInstruction

Machine and agentic parsing, transformation, or reasoning guidelines.

AgentSkill

Executable tools, functions, or workflows related to the semantic type.

ScopeContext

Contextual boundaries of the data type.

GeospatialCoverage

Geospatial coverage boundaries represented by description and/or formal codes or URIs.

TemporalCoverage

Temporal coverage boundaries represented by description, start/end dates, or ISO 8601 periods/durations.

DisplayFormat

Guidelines for displaying and masking data.

Example

Concrete instance of values.

Resource

An external resource, citation, or reference related to the Semantic Data Type (using simple Dublin Core elements).

class SemanticDataType

A high-level data type associated with a distinct concept, validation/generation rules, and metadata.

Attributes & Slots

Attribute	Range (Type)	Required	Description
id	string	Yes	Unique identifier/URI for the Semantic Data Type.
name	string	Yes	Human-readable name of the Semantic Data Type.
description	string	Yes	A human-readable description of the Semantic Data Type.
version	string	Yes	The version of the Semantic Data Type instance definition (e.g., 1.0.0).
concepts	list of ConceptReference	No	A list of conceptual ontology alignments or mapping references representing this data type in external systems (e.g., SKOS concepts, Wikidata items, or vocabularies like DDI-CDI and schema.org). This should list multiple representations of the same underlying semantic concept, not distinct concepts.
storage_types	list of StorageType	No	Mappings to physical storage types across different environments. A mapping for the 'generic' environment is required to define the platform-independent base type.
classification	ClassificationSystem	No	Code lists or classification schemes that categorize this variable.
validation_rules	list of ValidationRule	No	Rules to validate physical representations of the data type.
generation_rules	list of GenerationRule	No	Templates or directives for generating synthetic valid data.
agent_instructions	AgentInstruction	No	Specific guidelines and instructions for AI agents handling this data type.
agent_skills	list of AgentSkill	No	Tools, functions, or prompts associated with this data type.
scope	ScopeContext	No	Contextual scope of the data type (temporal, geographic, etc.).
display_format	DisplayFormat	No	Formatting rules for displaying values of this type.
examples	list of Example	No	Curated valid and invalid examples for documentation and testing.
resources	list of Resource	No	External resources and references related to the Semantic Data Type.

Attribute	Range (Type)	Required	Description
uri	string	Yes	URI of the concept (e.g., SKOS URI).
vocabulary	string	No	Name of the vocabulary or ontology (e.g., SKOS, DDI-CDI, Wikidata, LCSH).
pref_label	string	No	Preferred label of the concept in the ontology.
match_type	string	No	Relationship to the concept (e.g., exactMatch, closeMatch, broadMatch, narrowMatch).

Attribute	Range (Type)	Required	Description
target_environment	string	Yes	Target platform, framework, database, or language. Prefer using values from the TargetEnvironmentEnum controlled vocabulary where applicable. Custom values not in the enum are permitted since this slot is of type string.
data_type	string	Yes	Data type identifier in the target environment (e.g., string, varchar, integer, str).
format_modifier	string	No	Optional modifiers (e.g., length, precision).

Attribute	Range (Type)	Required	Description
name	string	Yes	Name of the classification (e.g., ISO-3166-1, ICD-10).
uri	string	No	URI to the standard classification.
version	string	No	Version of the classification scheme.

Attribute	Range (Type)	Required	Description
rule_type	string	Yes	Type of validation (e.g., regex, checksum, range).
pattern	string	No	Regular expression pattern for validation.
algorithm	string	No	Algorithmic checker name (e.g., luhn, modulo-11, isbn13).
message	string	No	Error message when validation fails.
code_snippets	list of CodeSnippet	No	Environment-specific code snippets or expressions implementing the validation logic.

Attribute	Range (Type)	Required	Description
target_environment	string	Yes	Target platform, framework, database, or language. Prefer using values from the TargetEnvironmentEnum controlled vocabulary where applicable. Custom values not in the enum are permitted since this slot is of type string.
code	string	Yes	The actual code snippet or expression (e.g., Python function/lambda, SQL expression).

Attribute	Range (Type)	Required	Description
generator_type	string	Yes	Type of generator (e.g., regex_fuzzer, template, faker_provider, custom).
template	string	No	Seed template or expression.
code_snippets	list of CodeSnippet	No	Environment-specific code snippets or expressions implementing the generator logic.

Attribute	Range (Type)	Required	Description
guidelines	string	Yes	Text instructions for agents.
system_prompt_snippet	string	No	System prompt instructions for configuring agents with this data type.

Attribute	Range (Type)	Required	Description
tool_name	string	Yes	Name of the tool or function.
description	string	No	What this skill does.
api_definition	string	No	API endpoint or function signature.

Attribute	Range (Type)	Required	Description
geospatial_coverage	GeospatialCoverage	No	Geospatial region or country coverage details.
temporal_coverage	TemporalCoverage	No	Temporal coverage details.
domain	string	No	Specific field or subject domain (e.g., Healthcare, Finance).
governing_institution	string	No	Governing body (e.g., ISO, W3C, IRS).

Attribute	Range (Type)	Required	Description
description	string	No	Human-readable description of the geospatial coverage (e.g., United States, Canada, Global).
codes	list of string	No	A list of formal codes or URIs (e.g., ISO country/subdivision codes, GeoNames URIs, Wikidata URIs).

Attribute	Range (Type)	Required	Description
description	string	No	Human-readable description of the temporal coverage (e.g., '21st Century', '2020 Census').
start_date	string	No	Start date of the coverage formatted strictly according to ISO 8601 (YYYY-MM-DD). Pattern: `^\d{4}-\d{2}-\d{2}$`
end_date	string	No	End date of the coverage formatted strictly according to ISO 8601 (YYYY-MM-DD). Pattern: `^\d{4}-\d{2}-\d{2}$`
iso_period	string	No	ISO 8601 time interval or period representation (e.g., '2020-01-01/2020-12-31', 'P1Y').

Attribute	Range (Type)	Required	Description
input_mask	string	No	Mask for input forms (e.g., 999-99-9999).
display_template	string	No	Output representation template.
formatting_regex	string	No	Regex used to transform raw data to formatted data.

Attribute	Range (Type)	Required	Description
value	string	Yes	Example value representation.
is_valid	boolean	Yes	Indication of whether the example value is valid under the SDT.
description	string	No	Description of the specific test case this example represents.

Attribute	Range (Type)	Required	Description
url	string	Yes	The URL/URI of the resource.
title	string	No	Human-readable name of the resource.
description	string	No	A brief summary or account of the resource.
citation	string	No	A formal bibliographic citation for the resource.
publisher	string	No	The entity or publisher responsible for making the resource available.

TargetEnvironmentEnum

Recommended vocabulary of target systems and development environments.

enum TargetEnvironmentEnum

Recommended vocabulary of target systems and development environments.

Permissible Values

Value	Description
csharp	C# programming environment.
generic	Platform-independent representation.
go	Go programming environment.
java	Java programming environment.
javascript	JavaScript programming environment.
python	Python programming environment.
r	R statistical computing environment.
rust	Rust programming environment.
sas	SAS statistical computing environment.
spss	SPSS statistical computing environment.
sql	Standard Structured Query Language (ANSI).
sql-bigquery	Google BigQuery database environment.
sql-clickhouse	ClickHouse database environment.
sql-mssql	Microsoft SQL Server database environment.
sql-mysql	MySQL database environment.
sql-oracle	Oracle database environment.
sql-postgresql	PostgreSQL database environment.
sql-redshift	Amazon Redshift database environment.
sql-snowflake	Snowflake database environment.
sql-sqlite	SQLite database environment.
stata	Stata statistical software environment.
typescript	TypeScript programming environment.
xsd	XML Schema Definition.

Pre-compiled Source Schemas Browse Directory →

To allow developers and agents to consume Semantic Data Types natively, we auto-compile models from the LinkML schema into major programming ecosystems during CI builds. Click here to browse the generated schemas directly in the repository.

Python

Pydantic Models

Robust Pydantic v2 schemas generated from the LinkML specification, providing type hints and data validation natively in Python.

linkml/dev/python/sdt.py View →

TypeScript

TS Interfaces

Strict TypeScript typings and interfaces ready for use in web frontends, Node backends, or agent integrations.

linkml/dev/typescript/sdt.ts View →

Rust

Rust Structs

Cargo module bindings and structs containing the validated modeling layouts of SDTs for low-latency Rust environments.

linkml/dev/rust/ View →

UML Diagram

PlantUML Spec

PlantUML files illustrating the structural relationships, attributes, and inheritance patterns of the LinkML definitions.

linkml/dev/plantuml/sdt.puml View →

JSON Schema

Standard JSON Schema draft-07 definitions of the SDT modeling layouts, enabling native schema validation across languages.

linkml/dev/jsonschema/sdt.schema.json View →

Java

Java POJOs

Plain Old Java Objects generated under the org.dataartifex.sdt package name, complete with Jackson annotations.

linkml/dev/java/ View →

RDF

RDF Turtle Graph

W3C standard Resource Description Framework graph Turtle serialization, enabling direct load into triplestores and graph databases.

linkml/dev/rdf/sdt.ttl View →

SHACL

SHACL Shapes

Shapes Constraint Language shapes (Turtle format) designed to validate RDF graph structures against Semantic Data Type boundaries.

linkml/dev/shacl/sdt.shacl.ttl View →

JSON-LD

JSON-LD Context

JSON-LD @context mappings and schemas to seamlessly bridge raw JSON payloads into Linked Data and Semantic Web namespaces.

linkml/dev/jsonld/ View →

OWL

OWL Ontology

Web Ontology Language mapping of the schema structure, providing description logic axioms for reasoning engines.

linkml/dev/owl/sdt.owl.ttl View →

Generating Assets Locally

You can recompile all dev artifacts locally from the root folder if you modify the schema layout file:

uv run hatch run linkml:generate

LinkML Schema Explorer

Semantic Data Type Schema

SemanticDataType

ConceptReference

StorageType

ClassificationSystem

ValidationRule

CodeSnippet

GenerationRule

AgentInstruction

AgentSkill

ScopeContext

GeospatialCoverage

TemporalCoverage

DisplayFormat

Example

Resource

class SemanticDataType

Attributes & Slots

class ConceptReference

Attributes & Slots

class StorageType

Attributes & Slots

class ClassificationSystem

Attributes & Slots

class ValidationRule

Attributes & Slots

class CodeSnippet

Attributes & Slots

class GenerationRule

Attributes & Slots

class AgentInstruction

Attributes & Slots

class AgentSkill

Attributes & Slots

class ScopeContext

Attributes & Slots

class GeospatialCoverage

Attributes & Slots

class TemporalCoverage

Attributes & Slots

class DisplayFormat

Attributes & Slots

class Example

Attributes & Slots

class Resource

Attributes & Slots

TargetEnvironmentEnum

enum TargetEnvironmentEnum

Permissible Values

Pre-compiled Source Schemas Browse Directory →

Pydantic Models

TS Interfaces

Rust Structs

PlantUML Spec

JSON Schema

Java POJOs

RDF Turtle Graph

SHACL Shapes

JSON-LD Context

OWL Ontology

Generating Assets Locally