Package {arkg}


Title: Access to the ArKG Chile Archaeological Dating Knowledge Graph
Version: 0.1.0
Description: Client for the Archaeology Knowledge Graph of Chile (ArKG, https://arkg.cl), providing access to Chilean archaeological dates (radiocarbon and thermoluminescence) via its SPARQL endpoint powered by 'MillenniumDB'.
License: CC BY-SA 4.0
Encoding: UTF-8
RoxygenNote: 7.3.3
URL: https://arkg.cl, https://github.com/ArKG-Data/arkg-r
BugReports: https://github.com/ArKG-Data/arkg-r/issues
Depends: R (≥ 4.1.0)
Imports: httr2, jsonlite, tibble
Suggests: testthat (≥ 3.0.0), withr
Config/testthat/edition: 3
NeedsCompilation: no
Packaged: 2026-07-13 20:40:31 UTC; Victor
Author: Victor Mendez [aut, cre]
Maintainer: Victor Mendez <victor.mendez@uc.cl>
Repository: CRAN
Date/Publication: 2026-07-22 07:10:30 UTC

Limpiar URIs de ArKG

Description

Quita el prefijo ⁠https://arkg.cl/⁠, reemplaza guiones bajos por espacios y decodifica caracteres URL-encoded.

Usage

arkg_clean(x)

Arguments

x

Vector de caracteres a limpiar.

Value

Vector de caracteres limpio.


Obtener las dataciones arqueologicas (Fechado) de ArKG

Description

Recupera los fechados arqueologicos (radiocarbono y termoluminiscencia) del grafo ArKG. Las consultas usan OPTIONAL y el post-procesado es defensivo: si la ontologia cambia y algun predicado desaparece, la columna correspondiente se devuelve vacia en lugar de producir un error.

Usage

arkg_dates(limit = 100)

Arguments

limit

Numero maximo de filas a devolver (NULL = todas).

Value

Un tibble con las dataciones. Columnas: fechado, label, site, material, method, c14_age, c14_type, sd, source, id.

Examples

## Not run: 
arkg_dates(limit = 100)

## End(Not run)

Endpoint SPARQL de ArKG

Description

Devuelve la URL del endpoint SPARQL de ArKG. Se puede sobrescribir con la variable de entorno ARKG_SPARQL_ENDPOINT.

Usage

arkg_endpoint()

Value

Cadena de caracteres con la URL del endpoint.

Examples

arkg_endpoint()

Construir una peticion httr2 base para ArKG

Description

Crea una peticion con user-agent, reintentos, timeout y manejo de errores centralizado. Funcion interna reutilizada por las demas.

Usage

arkg_request(url = arkg_endpoint())

Arguments

url

URL de destino (por defecto el endpoint de ArKG).

Value

Un objeto request de httr2.


Listar sitios arqueologicos (ArchSite) de ArKG

Description

Recupera los sitios arqueologicos del grafo ArKG con sus coordenadas. El post-procesado es defensivo ante cambios de la ontologia.

Usage

arkg_sites(limit = 100)

Arguments

limit

Numero maximo de filas a devolver (NULL = todas).

Value

Un tibble con los sitios. Columnas: site, label, x, y, id.

Examples

## Not run: 
arkg_sites()

## End(Not run)

Ejecutar una consulta SPARQL en ArKG

Description

Envia una consulta SPARQL al endpoint de ArKG (MillenniumDB) mediante POST y devuelve los resultados como tibble (para SELECT) o logico (ASK).

Usage

arkg_sparql(query, endpoint = arkg_endpoint())

Arguments

query

Cadena de texto con la consulta SPARQL.

endpoint

URL del endpoint (por defecto arkg_endpoint())..

Value

Un tibble para consultas SELECT, o logical para ASK.

Examples

## Not run: 
arkg_sparql("SELECT * WHERE { ?s ?p ?o } LIMIT 5")

## End(Not run)

User-agent del paquete arkg

Description

User-agent del paquete arkg

Usage

arkg_user_agent()

Value

Cadena de caracteres para la cabecera User-Agent.


Convertir SPARQL Results JSON a tibble

Description

Implementa el formato "SPARQL 1.1 Query Results JSON".

Usage

sparql_to_tibble(parsed)

Arguments

parsed

Lista resultante de parsear el JSON de respuesta.

Value

Un tibble (SELECT) o logical (ASK).