Create a semantic claim — claim • betwixt

Creates a single semantic claim as a one-row claim_df. A claim consists of four elements:

Usage

claim(scope, subject, predicate, value)

Arguments

scope: Scope of the claim.
subject: Subject within the scope.
predicate: Predicate of the claim.
value: Claimed value.

Value

A one-row claim_df.

Details

scope: the context in which the claim is made;
subject: the entity or class of entities under consideration;
predicate: the asserted property;
value: the asserted value.

The meaning of a claim derives from its scope. A scope may represent a statistical observation, an archival record set, a filesystem folder, a namespace, or any other well-defined context.

Examples

# Statistical example:
#
# A claim about the GDP of Andorra in a given year.
#
ad_gdp <- claim(
  scope = "country=AD;year=2023",
  subject = "Andorra",
  predicate = "GDP",
  value = "3.73 billion EUR"
)

ad_gdp
#> <claim_df>
#> Claims: 1
#> Scopes: 1
#> Scope: country=AD;year=2023
#> 
#> # A tibble: 1 × 4
#>   scope                subject predicate value           
#>   <chr>                <chr>   <chr>     <chr>           
#> 1 country=AD;year=2023 Andorra GDP       3.73 billion EUR
dim(ad_gdp)
#> [1] 1 4

# Archival example:
#
# A folder contains six JPG files that are digital surrogates
# of two historical letters:
#
# box45/
#   letterA_p1r.jpg
#   letterA_p1v.jpg
#   letterB_p1r.jpg
#   letterB_p1v.jpg
#   letterB_p2r.jpg
#   letterB_p2v.jpg
#
# Instead of creating six separate claims, the claim is made
# at the scope of the box represented by the folder.
#
latin_box <- claim(
  scope = "box45",
  subject = "page",
  predicate = "language",
  value = "Latin"
)

latin_box
#> <claim_df>
#> Claims: 1
#> Scopes: 1
#> Scope: box45
#> 
#> # A tibble: 1 × 4
#>   scope subject predicate value
#>   <chr> <chr>   <chr>     <chr>
#> 1 box45 page    language  Latin
dim(latin_box)
#> [1] 1 4