Skip to content
Simon Gillings edited this page Aug 11, 2021 · 1 revision

Welcome to the BTOTools wiki!

Process for updating internal species dictionary

BTOTools includes a global species dictionary based on BTO's implementation of the IOC bird list. IOC update this list every c6 months, which triggers an update of BTO systems and the need to update the data held in BTOTools. For reference (mostly for the benefit of those maintaining the package) the following steps are needed to update the data in the package:

  • As soon as a new IOC release is announced, contact IS (currently Steve Pritchard) and request a new set of files once Oracle has been updated. This should consist of:
    • global_species_lookup_IOC###.csv (# = version number)
    • sci_name_synonyms_IOC###.csv
    • species_map_IOC72_to_IOC###.csv
  • copy these files to BTOTools/data-raw
  • open R code BTOTools/data-raw/make_included_datafiles. Update filenames in three places to point to the three new csv files. Run. Commit changed R code and new *.rda files in BTOTools/data. Rebuild the package and push to Github
  • Update the readme