Create a SemsqlConn connection — semsql

Opens a connection to a SemanticSQL SQLite database, either by supplying a direct file path or by referencing a short ontology name that is retrieved and cached via BiocFileCache.

Usage

semsql_connect(
  db_path = NULL,
  ontology_prefix = NULL,
  ontology = NULL,
  cache = BiocFileCache::BiocFileCache(),
  ...
)

Arguments

db_path: character(1) or NULL. Path to an existing SQLite database file. Either db_path or ontology must be supplied.
ontology_prefix: character(1) or NULL. Primary CURIE prefix for the ontology (e.g. "CL"). If NULL and ontology is supplied, defaults to toupper(ontology); otherwise auto-detected from the database.
ontology: character(1) or NULL. Short name of an INCAtools ontology (e.g. "cl", "go"). If supplied, retrieve_semsql_conn is called to locate or download the cached database.
cache: a BiocFileCache instance used when ontology is supplied. Defaults to BiocFileCache::BiocFileCache().
...: passed to retrieve_semsql_conn and ultimately to download.file.

Value

A SemsqlConn object.

Examples

# by ontology short name (downloads if not cached)
goref <- semsql_connect(ontology = "go")
#> Connected to SemanticSQL database: /home/vincent/.cache/R/BiocFileCache/b24227f056f7_go.db
#> Primary ontology prefix: GO
goref
#> <SemsqlConn>  prefix: GO  | labeled terms: 88,356 
disconnect(goref)
#> Disconnected from 'b24227f056f7_go.db'