R/read_tier.R

In langdoc/FRelan: Parse and analyze ELAN files

#' read_tier Function read individual tiers from single ELAN files.
#'
#' This function reads just an individual tier of one ELAN file
#' @param eaf_file This is a path to the file.
#' @param tier This is the linguistic type of the tier
#' @keywords ELAN
#' @export
#' @examples
#' read_tier(path = "corpora/kpv/", tier = "wordT")

read_tier <- function(eaf_file, linguistic_type = "wordT", read_file = T, xml_object = F){

                `%>%` <- dplyr::`%>%`

                if (read_file == F){

                        file = xml_object

                        } else {

                file <- xml2::read_xml(eaf_file)

                }

                participants_in_file <- file %>% xml2::xml_find_all(paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "']")) %>%
                        xml2::xml_attr("PARTICIPANT")

                coerce_data_frame <- function(current_participant){
                        dplyr::data_frame(
                                content = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*/ANNOTATION_VALUE")) %>%
                                        xml2::xml_text(),
                                annot_id = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*/ANNOTATION_VALUE/..")) %>%
                                        xml2::xml_attr("ANNOTATION_ID"),
                                ref_id = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*/ANNOTATION_VALUE/..")) %>%
                                        xml2::xml_attr("ANNOTATION_REF"),
                                speaker = current_participant,
                                tier_id = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*/ANNOTATION_VALUE/../../..")) %>%
                                        xml2::xml_attr("TIER_ID"),
                                type = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*/ANNOTATION_VALUE/../../..")) %>%
                                        xml2::xml_attr("LINGUISTIC_TYPE_REF"),
                                time_slot_1 = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*")) %>%
                                        xml2::xml_attr("TIME_SLOT_REF1"),
                                time_slot_2 = file %>%
                                        xml2::xml_find_all(
                                                paste0("//TIER[@LINGUISTIC_TYPE_REF='", linguistic_type, "' and @PARTICIPANT='", current_participant,"']/ANNOTATION/*")) %>%
                                        xml2::xml_attr("TIME_SLOT_REF2"))
                }

                if (length(participants_in_file) != 0){

                        plyr::ldply(participants_in_file, coerce_data_frame) %>% dplyr::tbl_df() %>% dplyr::rename(participant = speaker)

                } else {

                        all_participants <- file %>% xml2::xml_find_all("//TIER") %>%
                                xml2::xml_attr("PARTICIPANT") %>% unique()
                        tibble(content = NA,
                               annot_id = '',
                               ref_id = '',
                               participant = all_participants,
                               tier_id = '',
                               type = linguistic_type,
                               time_slot_1 = NA,
                               time_slot_2 = NA)

                }


        }