Inference draws conclusions: statements that follow from what you wrote without being written. Folio applies each rule under Standard inference and Folio inference across every file in the workspace, and each family there shows one kind of conclusion with an example. Not inferred lists the conclusions Folio does not draw. A query and Problems use every conclusion; Seeing inferred values covers forms and graph views.
Standard inference
RDFS and OWL define these rules.
Subclasses (rdfs9)
An instance of a class is concluded to be an instance of its superclasses by rdfs:subClassOf.
@prefix dct: <http://purl.org/dc/terms/> . @prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A power plant: a facility that generates electricity for the grid. plants:PowerPlant a rdfs:Class ; rdfs:label "Power plant"@en ; rdfs:comment "A facility that generates electricity for the grid."@en . # A solar installation is one kind of power plant. plants:SolarInstallation a rdfs:Class ; rdfs:label "Solar installation"@en ; rdfs:comment "A photovoltaic power plant connected to the grid."@en ; rdfs:subClassOf plants:PowerPlant . # Dry Lake Solar is written only as a solar installation. fleet:dry-lake-solar a plants:SolarInstallation .
Folio concludes:
@prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . fleet:dry-lake-solar a plants:PowerPlant .
Subproperties (rdfs7)
A statement made with a property is concluded to hold for its superproperties by rdfs:subPropertyOf.
@prefix dct: <http://purl.org/dc/terms/> . @prefix films: <https://example.org/my-semantic-package/films#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # The territories a license lets its holder distribute a film in. films:licensedTerritory a rdf:Property ; rdfs:label "Licensed territory"@en ; rdfs:comment "A territory where the licensee may distribute the film."@en . # An exclusive territory is a licensed territory no other licensee shares. films:exclusiveTerritory a rdf:Property ; rdfs:label "Exclusive territory"@en ; rdfs:comment "A territory where no other licensee may distribute the film."@en ; rdfs:subPropertyOf films:licensedTerritory . # The Long Harvest's streaming license holds Canada exclusively. films:long-harvest-streaming films:exclusiveTerritory films:canada .
Folio concludes:
@prefix films: <https://example.org/my-semantic-package/films#> . films:long-harvest-streaming films:licensedTerritory films:canada .
Datatypes (rdfs1/rdfs13)
Every XSD datatype Folio recognizes is concluded to be a subclass of rdfs:Literal.
@prefix dct: <http://purl.org/dc/terms/> . @prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A power plant's nameplate capacity. plants:capacityMW a rdf:Property ; rdfs:label "capacity (MW)"@en ; rdfs:comment "Nameplate capacity in megawatts."@en . # Riverbend Station can generate 1,100 megawatts. fleet:riverbend-station plants:capacityMW "1100.0"^^xsd:decimal .
Folio concludes:
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . xsd:decimal rdfs:subClassOf rdfs:Literal .
Domain and range (rdfs2/rdfs3)
The subject of a property is concluded to be an instance of the property's rdfs:domain, and its value an instance of the property's rdfs:range.
@prefix dct: <http://purl.org/dc/terms/> . @prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A power plant: a facility that generates electricity for the grid. plants:PowerPlant a rdfs:Class ; rdfs:label "Power plant"@en ; rdfs:comment "A facility that generates electricity for the grid."@en . # A company: a business that owns or operates power plants. plants:Company a rdfs:Class ; rdfs:label "Company"@en ; rdfs:comment "A business that owns or operates power plants."@en . # Only a power plant has an operator, and the operator is a company. plants:operator a rdf:Property ; rdfs:label "operator"@en ; rdfs:comment "The company that runs the plant day to day."@en ; rdfs:domain plants:PowerPlant ; rdfs:range plants:Company . # Desert Ridge is run by Helios Energy. fleet:desert-ridge plants:operator fleet:helios-energy .
Folio concludes:
@prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . fleet:desert-ridge a plants:PowerPlant . fleet:helios-energy a plants:Company .
Equivalent classes (scm-eqc1)
An instance of either class in an owl:equivalentClass statement is concluded to be an instance of the other.
@prefix dct: <http://purl.org/dc/terms/> . @prefix films: <https://example.org/my-semantic-package/films#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix schema: <https://schema.org/> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A film the studio licenses: what schema.org calls a Movie. films:Film a rdfs:Class ; rdfs:label "Film"@en ; rdfs:comment "A feature film whose rights the studio licenses to distributors."@en ; owl:equivalentClass schema:Movie . # The Long Harvest, written as a schema.org Movie. films:the-long-harvest a schema:Movie .
Folio concludes:
@prefix films: <https://example.org/my-semantic-package/films#> . films:the-long-harvest a films:Film .
Equivalent properties (scm-eqp1)
A statement made with either property in an owl:equivalentProperty statement is concluded to hold for the other.
@prefix dct: <http://purl.org/dc/terms/> . @prefix films: <https://example.org/my-semantic-package/films#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix schema: <https://schema.org/> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A film's director: what schema.org calls director. films:directedBy a rdf:Property ; rdfs:label "Directed by"@en ; rdfs:comment "The person credited with directing a film."@en ; owl:equivalentProperty schema:director . # The Long Harvest's director, written with schema.org's property. films:the-long-harvest schema:director films:anna-voss .
Folio concludes:
@prefix films: <https://example.org/my-semantic-package/films#> . films:the-long-harvest films:directedBy films:anna-voss .
Inverse properties (prp-inv)
A statement made with one property in an owl:inverseOf statement is concluded, with subject and value swapped, for the other.
@prefix dct: <http://purl.org/dc/terms/> . @prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/rdfs> . # A subsidiary points at its parent; the parent points back. plants:subsidiaryOf a rdf:Property ; rdfs:label "subsidiary of"@en ; rdfs:comment "Links a company to the company that holds a controlling stake."@en ; owl:inverseOf plants:parentCompanyOf . # A parent company points at each company it controls. plants:parentCompanyOf a rdf:Property ; rdfs:label "parent company of"@en ; rdfs:comment "Links a company to a company it holds a controlling stake in."@en . # Helios Energy is a subsidiary of Helios Holdings. fleet:helios-energy plants:subsidiaryOf fleet:helios-holdings .
Folio concludes:
@prefix fleet: <https://example.org/my-semantic-package/fleet#> . @prefix plants: <https://example.org/my-semantic-package/plants#> . fleet:helios-holdings plants:parentCompanyOf fleet:helios-energy .
Folio inference
Folio draws these conclusions from SHACL shapes and Semvia's dataset vocabulary; no standard defines them as inference.
Inherited properties
A class is concluded to inherit every sh:property block of its superclasses by rdfs:subClassOf, of the shapes it reaches by sh:node, and of the shapes that name it in sh:targetClass.
@prefix dct: <http://purl.org/dc/terms/> . @prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix sh: <http://www.w3.org/ns/shacl#> . @prefix svs: <https://pkg.semvia.io/semvia/core/meta-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/class-schema> . # A power plant: a facility that generates electricity for the grid. # Every power plant records its capacity. plants:PowerPlant a svs:ClassSchema ; rdfs:label "Power plant"@en ; rdfs:comment "A facility that generates electricity for the grid."@en ; sh:property plants:PowerPlant.capacity . # A plant's nameplate capacity, in megawatts. plants:PowerPlant.capacity a sh:PropertyShape ; sh:path plants:capacityMW ; sh:name "capacity (MW)"@en ; sh:description "Nameplate capacity in megawatts."@en ; sh:datatype xsd:decimal . # A nuclear plant is one kind of power plant. plants:NuclearPlant a svs:ClassSchema ; rdfs:label "Nuclear plant"@en ; rdfs:comment "A power plant that makes electricity by nuclear fission."@en ; rdfs:subClassOf plants:PowerPlant .
Folio concludes:
@prefix plants: <https://example.org/my-semantic-package/plants#> . @prefix sh: <http://www.w3.org/ns/shacl#> . plants:NuclearPlant sh:property plants:PowerPlant.capacity .
Dataset membership
A dataset with an svds:memberSpace is concluded to have, by dct:hasPart, every document it holds. A document is held by the nearest dataset whose space its IRI starts with: the longest space wins, and two datasets claiming the same space both hold it. A dataset nested inside another holds its own files, and the outer dataset reaches them only through a join written in a dataset file: dct:hasPart in the outer dataset or dct:isPartOf in the nested one. A concluded dct:hasPart doesn't join them. licenses/index.ttl claims its folder:
@prefix dct: <http://purl.org/dc/terms/> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix svds: <https://pkg.semvia.io/semvia/core/dataset#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/dataset-and-package> . # The licenses dataset: every file in this folder. <> a svds:Dataset ; rdfs:label "Licenses" ; svds:memberSpace <./> .
With licenses/canada.ttl in the same folder, Folio concludes:
@prefix dct: <http://purl.org/dc/terms/> . <> dct:hasPart <./canada> .
Default values
A resource with no value for a property is concluded to have the sh:defaultValue its class's sh:property block declares.
@prefix dct: <http://purl.org/dc/terms/> . @prefix films: <https://example.org/my-semantic-package/films#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix sh: <http://www.w3.org/ns/shacl#> . @prefix svs: <https://pkg.semvia.io/semvia/core/meta-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . <> dct:conformsTo <https://pkg.semvia.io/semvia/core/profiles/class-schema> . # A streaming license: the right to stream a film in one territory. # A license is not exclusive unless it says so. films:StreamingLicense a svs:ClassSchema ; rdfs:label "Streaming license"@en ; rdfs:comment "A right to stream a film in one territory for a fixed term."@en ; sh:property [ sh:path films:exclusive ; sh:name "Exclusive"@en ; sh:description "Whether no other licensee may stream the film there."@en ; sh:datatype xsd:boolean ; sh:defaultValue false ] . # The Long Harvest's Canadian license says nothing about exclusivity. films:long-harvest-canada a films:StreamingLicense .
Folio concludes:
@prefix films: <https://example.org/my-semantic-package/films#> . films:long-harvest-canada films:exclusive false .
Not inferred
Folio does not draw these conclusions or flag these contradictions. A file can still state any conclusion below, and a query matches what the file states.
- Transitive properties
- A chain of two statements made with an
owl:TransitivePropertyis not concluded to give a third (prp-trp). Withplants:subsidiaryOftransitive,fleet:helios-energy plants:subsidiaryOf fleet:helios-holdingsandfleet:helios-holdings plants:subsidiaryOf fleet:helios-groupdo not concludefleet:helios-energy plants:subsidiaryOf fleet:helios-group. In a SPARQL query, the property pathplants:subsidiaryOf+follows the chain. - SKOS transitive hierarchy
- SKOS defines
skos:broaderTransitiveas a transitive superproperty ofskos:broader, andskos:narrowerTransitiveofskos:narrower. The SKOS vocabulary Folio loads does not state those links, so subproperties concludes neither fromskos:broaderorskos:narrowerstatements. A file that states a link gets the one step it licenses, never the chain. Without one,?concept skos:broaderTransitive ex:electronicsmatches only the statements a file writes;?concept skos:broader+ ex:electronicsfollows the chain, as in Taxonomies. - Same individuals
- Two IRIs joined by
owl:sameAsare not concluded to share their statements (eq-rep-s, eq-rep-p, eq-rep-o). Withfleet:helios-energy owl:sameAs crm:account4471,fleet:desert-ridge plants:operator fleet:helios-energydoes not concludefleet:desert-ridge plants:operator crm:account4471. Nor isowl:sameAsconcluded from anowl:FunctionalProperty(prp-fp) or anowl:InverseFunctionalProperty(prp-ifp). - Symmetric properties
- A statement made with an
owl:SymmetricPropertyis not concluded in the other direction (prp-symp). Withplants:jointVenturePartnersymmetric,fleet:helios-energy plants:jointVenturePartner fleet:cascade-powerdoes not concludefleet:cascade-power plants:jointVenturePartner fleet:helios-energy. In a query, the property pathplants:jointVenturePartner|^plants:jointVenturePartnermatches both directions. - Property chains
- A property declared by an
owl:propertyChainAxiomis not concluded from the chain it names (prp-spo2). Withfilms:distributedBythe chain offilms:hasLicensethenfilms:licensee, a film's licensee is not concluded as its distributor. In a query, the property pathfilms:hasLicense/films:licenseefollows the chain. - Restrictions and cardinality
- An
owl:Restrictionconcludes nothing: no type or value fromowl:someValuesFromorowl:hasValue(cls-svf1, cls-hv1, cls-hv2), no value type fromowl:allValuesFrom(cls-avf), and noowl:sameAsfromowl:maxCardinalityorowl:maxQualifiedCardinality(cls-maxc2, cls-maxqc3). A restriction onplants:operatorwithowl:allValuesFrom plants:Companydoes not conclude that a plant's operator is a company. Anrdfs:rangeconcludes that type. As validation, not inference, a SHACLsh:classchecks a value's type, andsh:minCountorsh:maxCountchecks how many values a property has. - Class expressions
- An entity in every class an
owl:intersectionOfcombines is not concluded to be in the intersection, and a member of the intersection is not concluded to be in each class (cls-int1, cls-int2). A member of one class anowl:unionOfcombines is not concluded to be in the union (cls-uni). An individual anowl:oneOflists is not concluded to be a member (cls-oo). Nor is an intersection concluded to be a subclass of each class it combines, or each class of a union a subclass of the union (scm-int, scm-uni). Withplants:RegulatedOperatorthe intersection ofplants:Companyandplants:LicensedOperator, an entity typed as both is not concluded to be aplants:RegulatedOperator, andplants:RegulatedOperator rdfs:subClassOf plants:Companyis not concluded. - Disjoint classes
- A resource typed in two classes declared disjoint by
owl:disjointWithorowl:AllDisjointClasses, or in a class and itsowl:complementOf, is not flagged as a contradiction (cax-dw, cax-adc, cls-com). Withplants:SolarInstallation owl:disjointWith plants:NuclearPlant, a site typed as both is not flagged. A SHACLsh:notshape checks it as validation, not inference. - The rdfs:Resource type
- A resource is not concluded to be an
rdfs:Resource(rdfs4a, rdfs4b), and a class is not concluded to be a subclass ofrdfs:Resource(rdfs8).fleet:riverbend-station a rdfs:Resourceis not concluded.
Seeing inferred values
A SPARQL query and Problems use every conclusion Folio draws, with nothing turned on.
Forms and graph views show only the values your files state until Show inferred values is on. It is under Editor in Folio's settings, off by default, and takes effect when the next form or graph view opens.
The one exception is the properties a class inherits. Class cards list them while the Inherited properties toggle in a graph view's Display flyout is on, as it is by default, independent of Show inferred values.
The Inferred values toggle in the same flyout overrides Show inferred values for that panel only.
An inferred value is marked. On the graph canvas its edge is dotted. In a form or card its row is muted, with a lock whose hover reads "This value isn't written in any document you can edit here, so there's nothing to change."
From an agent
A connected agent asks Folio about inference over MCP. describe_inference lists every rule Folio knows and whether Folio runs it. explain_inference shows, for one SPARQL query, which rules fired on each pattern and which were skipped.