Skip to contents

JSON-LD construction

Build JSON-LD documents that express a framework in the two-tier cybed schema.

build_jsonld_context() stable
Build a standard JSON-LD @context block
build_multi_framework_context() stable
Build a JSON-LD @context block covering multiple frameworks
build_framework_node() stable
Construct a cybed:Framework top-level node
build_organizing_unit_node() stable
Construct a cybed:OrganizingUnit node
build_role_node() stable
Construct a cybed:Role node (workforce frameworks)
build_role_element_node() stable
Construct a cybed:RoleElement node
build_related_unit_metadata() experimental
Build cybed:relatedUnit metadata for an organizing unit
build_unit_relation_node() experimental
Construct a cybed:UnitRelation node
assemble_framework_document() stable
Assemble a framework-level @graph document

Sub-point and example parsing

Lift prose-encoded enumerations and pedagogical-scaffolding content out of parent element text and promote each fragment to a first-class graph element. Framework-as-specified enumerations (“such as” lists, “including” patterns) become cybed:Subpoint instances with cybed:elaborates back-pointers. “Clarification statement:” pedagogical scaffolding becomes cybed:Example instances reachable only via the parent’s cybed:hasExample predicate. See vignette cross-framework-analysis for the encoding-strategy finding this enables.

parse_subpoints() stable
Parse subpoints out of a parent element's text
build_subpoint_node() stable
Construct a cybed:Subpoint node
build_example_node() stable
Construct a cybed:Example node
expand_with_subpoints() stable
Expand parent element nodes with sub-point and example child nodes
extend_role_element_ids() stable
Append Subpoint IDs to a role's child-element id list

File I/O

read_jsonld_document() stable
Read a JSON-LD document from file
write_jsonld_document() stable
Write a JSON-LD document to file

RDF graph loading

Load assembled JSON-LD or N-Triples into rdflib for SPARQL querying.

load_single_framework_graph() stable
Load a single framework's JSON-LD into a new rdflib graph
load_unified_rdf_graph() experimental
Load every framework's JSON-LD into a unified rdflib graph
load_combined_rdf_graph() stable
Load the pre-assembled combined multi-framework JSON-LD into an rdflib graph
load_combined_ntriples_graph() stable
Load the pre-combined N-Triples file into an rdflib graph
make_demo_graph() stable
Build a small in-memory demo RDF graph

Data loading (public release)

Download and hash-verify the public per-framework data release into the user cache, and load it into an rdf graph. The names and shape match the Python package’s cybed_fetch()/load_graph() (0.4.0 API parity, see inst/conformance/).

cybed_fetch() experimental
Download and hash-verify per-framework release files into the user cache
load_graph() experimental
Load a graph from the cached release files, fetching first if needed

SPARQL helpers

Single-BGP query primitives and domain-level helpers. The package’s query discipline is one triple-pattern match per SPARQL call, with joins and aggregation done in R via dplyr; see vignette cross-framework-analysis for worked examples.

sparql_pairs() stable
Run a single-BGP SPARQL select returning subject-object pairs
sparql_subjects() stable
Run a single-BGP SPARQL select with fixed predicate and object
framework_metadata() stable
Domain helper: tibble of framework metadata
organizing_unit_framework_bindings() stable
Domain helper: organizing-unit-to-framework bindings with framework name attached
role_framework_bindings() stable
Domain helper: role-to-framework bindings with framework name attached
element_framework_bindings() stable
Domain helper: element-to-framework bindings with framework name attached
subpoint_framework_bindings() stable
Domain helper: subpoint-to-framework bindings with framework name attached
example_framework_bindings() stable
Domain helper: example-to-framework bindings with framework name attached
unit_element_bindings() stable
Domain helper: organizing-unit-to-element bindings
role_element_bindings() deprecated
Deprecated alias for unit_element_bindings()
unit_relation_bindings() experimental
Domain helper: unit-to-unit relation bindings
element_text() stable
Domain helper: statement text keyed by element

Similarity

Cross-framework unit-text similarity. The tokenizer, Jaccard scorer and stopword list are internal; framework_similarity() is the one exported entry point.

framework_similarity() experimental
Cross-framework unit-text similarity, top-n matches per unit

Validation

validate_jsonld_node() stable
Validate a JSON-LD node's minimum required structure

Graph invariants

Checks that only an assembled graph can answer: that no IRI stands for both an organizing unit and a statement, that no cybed:hasElement link points at its own subject, and that the assembled counts sit inside the bands docs/framework-invariants.yml declares. Run as a pipeline stage between the N-Triples export and the data release, and re-run by the release export itself.

graph_identity_violations() stable
Find organizing units that are also statements, and self-referential links
assert_graph_identity() stable
Stop the build when an assembled graph fuses a unit with a statement
graph_invariant_counts() stable
Measure the counts that graph_invariants declares
assert_graph_invariants() stable
Check an assembled graph against the declared graph_invariants bands

Licensing

Licence facts for the package code and every framework, with one owner.

cybed_license() experimental
Look up the licence terms for the package or one framework

Datasets

Pre-computed summary tibbles shipped with the package.

framework_summary
Framework summary tibble
framework_licenses experimental
Licence facts for the package code and every framework