SAL Module

https://w3id.org/sal/salmodule#

This is the SAL Module vocabulary for implementing the SAL Module specification in containerized application logic orchestrated within SAL projects

version0.0.2
creatorsAndrew Padilla

Namespaces

iPrefixes used as shorthand for full URIs throughout this document.
dcthttp://purl.org/dc/terms/
owlhttp://www.w3.org/2002/07/owl#
rdfhttp://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfshttp://www.w3.org/2000/01/rdf-schema#
salmodulehttps://w3id.org/sal/salmodule#
shhttp://www.w3.org/ns/shacl#
skoshttp://www.w3.org/2004/02/skos/core#

Classes

iTypes of things this vocabulary defines.

Command salmodule:Command

https://w3id.org/sal/salmodule#Command

A class representing a command that can be executed within a SAL Module containerized application as part of the SAL Module command line specification.

see also
Task

Environment Variable salmodule:EnvironmentVariable

https://w3id.org/sal/salmodule#EnvironmentVariable

A class representing an environment variable that is part of the SAL Module specification.

Error salmodule:Error

https://w3id.org/sal/salmodule#Error

A class representing an error condition within a salmodule:Task at runtime.

Instances of salmodule:Error represent error conditions that occur during the execution of a salmodule:Task within a SAL Module containerized application.

A task reports an instance as one newline delimited JSON node on stderr, never on stdout, which carries only data; it carries both an rdfs:label naming the error and an rdfs:comment describing it, which together are the message the SAL Project reports the failure with.

Node Consumer salmodule:NodeConsumer

https://w3id.org/sal/salmodule#NodeConsumer

An inferred class representing an entity that consumes JSON(-LD) newline delimited JSON node stream from stdin within a SAL Module containerized application. Do NOT use this class directly to subclass your task. Used salmodule:Task instead. Intended for OWL Reasoner.

Node Processor salmodule:NodeProcessor

https://w3id.org/sal/salmodule#NodeProcessor

An inferred class representing an entity that processes newline delimited JSON node streams via stdin/stdout within a SAL Module containerized application. Do NOT use this class directly to subclass your task. Used salmodule:Task instead. Intended for OWL Reasoner.

Node Producer salmodule:NodeProducer

https://w3id.org/sal/salmodule#NodeProducer

An inferred class representing an entity that produces a newline delimited JSON node stream to stdout within a SAL Module containerized application. Do NOT use this class directly to subclass your task. Used salmodule:Task instead. Intended for OWL Reasoner.

Task salmodule:Task

https://w3id.org/sal/salmodule#Task

A class representing an operational task within a SAL Module containerized application.

SAL Module implementers create subclasses of salmodule:Task to define specific operational tasks within the containerized application.

Object Properties

iRelationships that link one resource to another resource.

has subcommand salmodule:hasSubCommand

https://w3id.org/sal/salmodule#hasSubCommand

Relates a salmodule:Command instance to its subcommand(s) that can be executed by a SAL Module containerized application.

domain
Command
range
Command

is subcommand of salmodule:isSubCommandOf

https://w3id.org/sal/salmodule#isSubCommandOf

Relates a salmodule:Command instance to its parent command instance that can be executed by a SAL Module containerized application.

domain
Command
range
Command

Annotation Properties

iMetadata properties used to describe other terms.

JSON(-LD) Node stderr SHACL Shape salmodule:stderrShape

https://w3id.org/sal/salmodule#stderrShape

An annotation property representing the required SHACL sh:NodeShape(s) of the newline delimited JSON node error stream to stderr from a salmodule:Task subclass instance within a SAL Module containerized application.

The error stream must produce newline delimited JSON nodes that conform to the specified sh:NodeShape(s) when injected with the JSON-LD @context object defined within the salmodule's ontology.

range
NodeShape

JSON(-LD) Node stdin SHACL Shape salmodule:stdinShape

https://w3id.org/sal/salmodule#stdinShape

An annotation property representing the required SHACL sh:NodeShape(s) of the newline delimited JSON node input stream from stdin to a salmodule:Task within a SAL Module containerized application.

It is the responsibility of the salmodule:Task subclass implementation to inject its ontology's JSON-LD @context into the JSON input node to resolve to its vocabulary.

The input stream accepts newline delimited JSON objects (not JSON-LD).

range
NodeShape

JSON(-LD) Node stdout SHACL Shape salmodule:stdoutShape

https://w3id.org/sal/salmodule#stdoutShape

An annotation property representing the required SHACL sh:NodeShape(s) of the newline delimited JSON node output stream to stdout from a salmodule:Task subclass instance within a SAL Module containerized application.

The output stream must produce newline delimited JSON nodes that conform to the specified sh:NodeShape(s) when injected with the JSON-LD @context object defined within the salmodule's ontology.

range
NodeShape

JSON(-LD) Node Task SHACL Shape salmodule:taskShape

https://w3id.org/sal/salmodule#taskShape

An annotation property representing the required shape of the salmodule:Task subclass instance itself.

range
NodeShape

Protocol Scheme salmodule:protocolScheme

https://w3id.org/sal/salmodule#protocolScheme

The protocol scheme used to identify SAL Module resources.

Dereferencing an ontology with a SAL Module protocol scheme involves using 1) the github based protocol to clone the remote git repository 2) build the container image using the Dockerfile located in the base repository directory and 3) run the container using the salmodule:OntologyCommand.

see also
ontology , run