sdsanalysis is the backbone of the sdsbrowser webapp. To learn more about it's role for this webapp please check the For developers section in the README over there.
Beyond that sdsanalysis can be employed to analyse SDS stone artefact data in R. It offers two major functionalities for this purpose:
?sdsdownload
sdsanalysis offers functions to access openly available SDS datasets. It contains a reference table with information about data mostly collected by students and researchers at the Institute of Pre- and Protohistoric Archaeology at Kiel University. That data can be downloaded directly into R with sdsanalysis.
get_available_datasets
: Get a list of datasets that can be directly downloaded with sdsanalysisget_type_options
: Get the types of data that are available for one/multiple datasets (single - Einzelaufnahme, multi - Sammelaufnahme)get_single_artefact_data
/ get_multi_artefact_data
: Download one/multiple datasets as a dataframe/a list of dataframesget_description
: Download description text of one/multiple datasetsget_site
: Get site names of one/multiple datasetsget_coords
: Get site coordinates of one/multiple datasetsget_dating
: Get period information of one/multiple datasetsget_creator
: Get author of one/multiple datasets?sdsdecoding
SDS traditionally provides a set of predefined values for each variable. That's not just convenience: It theoretically also allows for a high degree of comparability between different datasets. This predefined values/categories are encoded with a simple and minimalistic alphanumerical scheme. That's a technological rudiment both from the time when the systems that served SDS as an inspiration were created and when most stone tool analysis was made without a computer in reach.
The encoding has the big disadvantage that it's not immediately human readable. If you try to understand a SDS dataset you're forced to constantly look up new variables in the SDS publications. That makes it very difficult to get a fast overview.
sdsanalysis offers functions to quickly decode the cryptic codes in the SDS tables and replace them with human readable descriptions. This is implemented with hash tables to enable high-speed transformation even for datasets with thousands of artefacts. The hash tables are compiled from two reference tables for variables and variable values.
lookup_everything
: Wizard function. Enter a SDS data.frame and receive a decoded version. This function employs the ones below and some more helpers to make the decoding process as simple as possiblelookup_vars
: lookup_var_complete_names
: lookup_var_types
: apply_var_types
: lookup_attrs
: lookup_attr_types
: apply_attr_types
: lookup_IGerM_category
: Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.