README.md

In YunyiShen/CamelotXMP: Write Camelot metadata to JPEG files as XMP metadata

CamelotXMP

This package is part of the Van Deelen/Drake lab camera trap data management infrastructure at UW-Madison. The main goal is to write metadata from Camelot into the XMP metadata of the photo files and vice versa. To install, use

devtools::install_github("YunyiShen/CamelotXMP")

Dependencies

This package used exifr to read/write metadata which relies on the Perl version of exiftool, see the documentation of exifr for how to config the required rool chain. Package jsonlite us also required to convert metadata in JSON format.

Main functions

There are 3 main functions, namely bridge2camelot, camelot2xmp and xmp2camelot.

bridge2camelot

Function bridge2camelot will convert metadata (usually generated by Adobe Bridge) stored in xmp-dc:Subject tag (i.e. the one appears in 'property -> tags' when opening it) by comparing it with species list and island/site list and save it into Camelot flavored data.frame, the header of such data.frame can be found in CamelotXMP::camelotheader. For the place that saves the tag, see this. An error log will be written if there is any error.

camelot2xmp

Function camelot2xmp will read a Camelot data.frame with at least "Absolute.Path" as a column and access each file stored with path in "Absolute.Path", then write all the metadata (as JSON string) in xmp-dc:Subject tag of the photo. For the place to save the tag, see this. An error log will be written if there is any error.

xmp2camelot

Function xmp2camelot will read a path and find all photos in it, extract the metadata in xmp-dc:Subject tag and write it in a Camelot flavored data.frame. An error log will be written if there is any error.

YunyiShen/CamelotXMP documentation built on Dec. 18, 2021, 8:22 p.m.