Open Know How (OKH) ontology

IRI:
https://w3id.org/oseg/ont/okh
Version IRI:
https://w3id.org/oseg/ont/1.1.0/okh
Current version :
1.1.0
Authors :
Martin Häuer <martin.haeuer@ose-germany.de>
Robin Vobruba <hoijui.quaero@gmail.com>
https://orcid.org/0000-0002-1611-7129
https://orcid.org/0009-0004-3559-6542
Publisher :
Robin Vobruba (Open Source Ecology Germany e.V.) <hoijui.quaero@gmail.com>
Other visualisation :
Ontology source - WebVowl

Table of Content

  1. Classes
  2. Object Properties
  3. Data Properties
  4. Named Individuals
  5. Annotation Properties
  6. Namespace Declarations

Classes

auxiliary file (neither source nor export)c back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#AuxiliaryFile

has super-classes
Filec

Bill of Materialsc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#BoM

has super-classes
Filec

Componentc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Component

Either a module (MOSH) or Part (POSH); more component types may be added in the future
has sub-classes
Modulec, Partc, Softwarec

Component Referencec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#ComponentReference

others shall be able to identify/procure this component only by the given reference(s), MOSH → URL to corresponding release POSH → URL to containing folder STD → standard designation (preferably naming the _latest_ standard) BUY → unambiguous reference
has super-classes
unambiguous referencec
has sub-classes
permanent URL to filec

Contribution Guidec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#ContributionGuide

has super-classes
Filec

exported source filec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#ExportFile

has super-classes
Filec

Filec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#File

A file that forms part of the project, specified/located either by a URL (okh:url) or a repo-/project-relative path (okh:relativePath).
has sub-classes
Bill of Materialsc, Contribution Guidec, Imagec, Manufacturing Instructionsc, Readmec, User Manualc, auxiliary file (neither source nor export)c, exported source filec, manifest filec, source filec

Imagec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Image

has super-classes
Filec

manifest filec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#ManifestFile

file holding the metadata
has super-classes
Filec

Manufacturing Instructionsc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#ManufacturingInstructions

has super-classes
Filec

massc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Mass

…of a module or a part

Modulec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Module

Module of Open Source Hardware (MOSH)
has super-classes
Componentc

outer dimensionsc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#OuterDimensions

…of a module or a part

Partc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Part

Piece of Open Source Hardware (POSH)
has super-classes
Componentc

permanent URL to filec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#FileUrl

has super-classes
u r lc
Component Referencec

Readmec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Readme

has super-classes
Filec

Scientific Publicationc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Publication

_scientific_ (that is: peer reviewed) publication that _contains_ the design files
has super-classes
publicationc

Softwarec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Software

Software (including firmware) needed to run & use the OSH
has super-classes
Componentc

source filec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#SourceFile

has super-classes
Filec

Technical Standardc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Standard

official standard used in the _design_ (not e.g. DIN SPEC 3105-1)

unambiguous referencec back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#Reference

has sub-classes
Component Referencec, Website URLc

User Manualc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#UserManual

has super-classes
Filec

Website URLc back to ToC or Class ToC

IRI: https://w3id.org/oseg/ont/okh#WebsiteUrl

has super-classes
u r lc
unambiguous referencec

Object Properties

attestationop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#attestation

permanent URL to evidence of compliance (OSHWA, FSF, DIN SPEC 3105)

complies with a technical standardop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#compliesWith

Documentation Readiness Level (DLR)op back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#documentationReadinessLevel

…using the ODRL definitions

exported source fileop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#export

URL to a (generated) exported source file

file formatop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#fileFormat

has super-properties
encoding formatop

fork ofop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#forkOf

has super-properties
is based onop

has auxiliary fileop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#auxiliary

reference to an auxiliary file

has Bill of Materialsop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasBoM

links to the corresponding Bill of Materials

has Componentop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasComponent

Links to sub-components of the Module. In the case of that sub-component being an external Module, it has to refer to a snapshot of the RDF object representing that OKH Module. Each sub-component should also appear in the BoM.

has Contribution Guideop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasContributionGuide

links to the corresponding Contribution Guide

has imageop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasImage

links to the corresponding Image
has super-properties
imageop

has manifest fileop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasManifestFile

has Manufacturing Instructionsop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasManufacturingInstructions

has Publicationop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasPublication

design files of this OSH modules have been peer reviewed in a scientific publication
has super-properties
has publicationop

has Readmeop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasReadme

links to the corresponding Readme

has Softwareop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasSoftware

has User Manualop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasUserManual

licensorop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#licensor

organization/individual behind the hardware design (holder of intellectual property)
has super-properties
copyright holderop

non-SPDX licenseop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#alternativeLicense

URL to legal code of a license without SPDX identifier, hence OSHWA-compliance is to be checked manually

organizationop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#organization

organization representing (most) contributors of this project

Patent Classop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#cpcPatentClass

International Patent Classification (IPC)
has super-properties
classification i p c inventiveop

Permanent file URL - It was not 'permanent', but rather 'frozen in time', and it was alsoThis was used in the karwler, but badly. Things simply should not be done that way, but rather with a separate manifest file, where either everything is frozen, or nothing is, and the manifest file (internally) itsself being marked accordingly.op back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#permaURL

repositoryop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#repo

URL to the place where development happens (typically the repository)" ; following this link people shall be able to contribute to the development (reporting issues, suggesting changes, connecting to the team etc.)"
has super-properties
code repositoryop
has sub-properties
respository snapshotop

respository snapshotop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#repoSnapshot

Repoistory snapshot (=specific version) URL
has super-properties
repositoryop

source fileop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#source

relative link to a source file

SPDX license identifierop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#spdxLicense

view complete list under https://spdx.org/licenses/

Technology Readiness Level (TRL)op back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#technologyReadinessLevel

…using the OTRL definitions

timestampop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#timestamp

following ISO 8601; see: <https://www.w3.org/TR/xmlschema11-2/#dateTimeStamp>

version ofop back to ToC or Object Property ToC

IRI: https://w3id.org/oseg/ont/okh#versionOf

connects specific versions of Modules with their versionless superclass

Data Properties

Document identifier for the technical standarddp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#standardID

documentation languagedp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#documentationLanguage

IETF language tag following the BCP 47 standard e.g. en-GB denotes the language of the documentation for the component subject
has super-properties
in languagedp

DOIdp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#doi

this publication has a digital object identifier (DOI)
has super-properties
doidp

file URLop back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#fileUrl

has super-properties
urldp
is also defined as
object property

file URLop back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#url

has super-properties
urldp
is also defined as
object property

functional descriptiondp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#function

functional description, e.g. what it actually does, what problem it solves, for whom, under which conditions etc. so if you wish that someone finds & uses your okh specifically e.g. for COVID-19-crisis response, include relevant keywords in this field optional: description of input, output and interfaces
has super-properties
b f o 0000016dp

functionality metadatadp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#functionalMetadata

Metadata addressing functionality, such as dimensions, material, weight, RPM,… (not standardized)
has super-properties
valuedp

Installation Guidedp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#installationGuide

manufacturing processdp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#manufacturingProcess

has super-properties
production metadatadp

mass of the componentop back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasMass

has super-properties
production metadatadp
is also defined as
object property

materialdp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#material

has super-properties
production metadatadp

Metadata Sourcedp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#dataSource

platform, where the crawler found the metadata (e.g. GitHub, Wikifactory)
has super-properties
urldp

OKH versiondp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#okhv

version of OKH specification the metadata is following (different version → different data fields)
has super-properties
versiondp

outer dimensions using OpenSCAD primitivesop back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#hasOuterDimensions

has super-properties
production metadatadp
is also defined as
object property

production metadatadp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#productionMetadata

production-relevant metadata, such as material, manufacturing technology, outer dimensions, smallest tolerance, finest surface roughness
has super-properties
valuedp
has sub-properties
manufacturing processdp, mass of the componentop, materialdp, outer dimensions using OpenSCAD primitivesop, smallest tolerance class (following ISO 286)op

Project-/Repo-relative file path, directly starting with the first path element, *NOT* with '/' or './'op back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#relativePath

has super-properties
urldp
is also defined as
object property

releasedp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#release

URL to release

Repository Hostdp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#repoHost

platform where the OSH documentation is located (e.g. GitLab, Wikifactory or any self-hosted website or wiki)
has super-properties
urldp

smallest tolerance class (following ISO 286)op back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#smallestToleranceClass

has super-properties
production metadatadp
is also defined as
object property

unitdp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#unit

mm, cm, m, g, kg

Upload Methoddp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#uploadMethod

e.g. auto (fully integrated platforms) or manifest file (for connected platforms)

valuedp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#value

versiondp back to ToC or Data Property ToC

IRI: https://w3id.org/oseg/ont/okh#version

version of this Component, preferably in the semantic versioning scheme (semver.org)
has super-properties
versiondp

Named Individuals

open scadni back to ToC or Named Individual ToC

IRI: https://w3id.org/oseg/ont/okh#openScad

is same as
OpenSCAD code defining a shape

OpenSCAD code defining a shapeni back to ToC or Named Individual ToC

IRI: https://w3id.org/oseg/ont/okh#openSCAD

is same as
open scad
is also defined as
data property

related tsdcni back to ToC or Named Individual ToC

IRI: https://w3id.org/oseg/ont/okh#relatedTsdc

is same as
TsDC

Annotation Properties

cardinalityap back to ToC or Annotation Property ToC

IRI: http://www.w3.org/2002/07/owl#cardinality

deprecated onap back to ToC or Annotation Property ToC

IRI: http://creativecommons.org/ns#deprecatedOn

domain includesap back to ToC or Annotation Property ToC

IRI: http://schema.org/domainIncludes

range includesap back to ToC or Annotation Property ToC

IRI: http://schema.org/rangeIncludes

superseded byap back to ToC or Annotation Property ToC

IRI: http://schema.org/supersededBy

term statusap back to ToC or Annotation Property ToC

IRI: http://www.w3.org/2003/06/sw-vocab-status/ns#term_status

Namespace Declarations back to ToC

default namespace
https://w3id.org/oseg/ont/okh#
1-1-0
https://w3id.org/oseg/ont/1.1.0/
core
https://w3id.org/oseg/ont/tsdc/core#
dc
http://purl.org/dc/elements/1.1/
iso639-1
http://id.loc.gov/vocabulary/iso639-1/
licenses
https://www.gnu.org/licenses/
ns
http://creativecommons.org/ns#
ns2
http://www.w3.org/2003/06/sw-vocab-status/ns#
obo
http://purl.obolibrary.org/obo/
ont
https://w3id.org/oseg/ont/
orcid-org
https://orcid.org/
otrl
https://w3id.org/oseg/ont/otrl#
owl
http://www.w3.org/2002/07/owl#
patent
http://data.epo.org/linked-data/def/patent/
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
schema
http://schema.org/
terms
http://purl.org/dc/terms/
terms1
http://spdx.org/rdf/terms#
vann
http://purl.org/vocab/vann/
xsd
http://www.w3.org/2001/XMLSchema#

This HTML document was obtained by processing the OWL ontology source code through LODE, Live OWL Documentation Environment, developed by Silvio Peroni .