odkc_svs_sve_as_wastd_surveys: Reconstruct WAStD Surveys from ODKC Site Visit Start/End

View source: R/odkc_svs_sve_as_wastd_surveys.R

odkc_svs_sve_as_wastd_surveysR Documentation

Reconstruct WAStD Surveys from ODKC Site Visit Start/End

Description

Reconstruct WAStD Surveys from ODKC Site Visit Start/End

Usage

odkc_svs_sve_as_wastd_surveys(svs, sve, user_mapping)

Arguments

svs

ODKC Site Visit Start, e.g. data("odkc_data"); odkc_data$svs

sve

ODKC Site Visit End, e.g. data("odkc_data"); odkc_data$sve

Details

Surveys are reconstructed from Site Visit Start records. Survey end details are populated from Site Visit End records, where matching by device_id, calendar_date_awst, and site_id.

Sources of error:

  • SVS forgotten to record

  • SVE forgotten to record

  • SVS recorded outside known site boundaries (WAStD Area), site_id mismatch, svs$site_id empty

  • SVE recorded outside known site boundaries (WAStD Area), site_id mismatch, sve$site_id empty

  • Changed devices mid survey (device_id mismatch, likely reporter mismatch, see end_comments)

Things to provide as QA reports outside this function:

  • Stray SVE without matching SVS

  • SVS joined to SVE only by device_id and calendar_date_awst minus "good" surveys (location out of bounds)

  • SVS joined to SVE only by calendar_date_awst and site_id minus "good" surveys (device swapped?)

Value

A tibble in the correct format to upload as WAStD Surveys

Examples

## Not run: 
wastdr::wastdr_setup(
  api_url = Sys.getenv("WASTDR_API_DEV_URL"),
  api_token = Sys.getenv("WASTDR_API_DEV_TOKEN")
)
drake::loadd(odkc_ex)
drake::loadd(user_mapping)
x <- odkc_svs_sve_as_wastd_surveys(odkc_ex$svs, odkc_ex$sve, user_mapping)

## End(Not run)

dbca-wa/etlTurtleNesting documentation built on Nov. 18, 2022, 8:03 a.m.