webmorphR (version 0.1.1)

auto_delin: Auto-Delineation

Description

Automatically delineate faces using Face++ (an external service). Since each delineation counts against a daily limit, you need to set up your own Face++ account (see details below).

Usage

auto_delin(stimuli, model = c("fpp106", "fpp83"), replace = FALSE, face = 1)

Arguments

stimuli

list of stimuli

model

Which model (fpp106, fpp83)

replace

logical; whether to replace original templates - if FALSE, only gets templates for images with no template

face

which face to delineate in each image if there is more than 1

Value

list of stimuli with templates

Details

To use Face++ auto-delineation, you need to get your own free API key from https://www.faceplusplus.com. After signing up for an account, go to https://console.faceplusplus.com/app/apikey/list and request a free API key. Add the key and secret to your .Renviron file as follows:

FACEPLUSPLUS_KEY="1234567890abcdefghijk"

FACEPLUSPLUS_SECRET="1234567890abcdefghijk"

See Also

Template functions average_tem(), centroid(), change_lines(), delin(), draw_tem(), features(), get_point(), remove_tem(), require_tems(), same_tems(), squash_tem(), subset_tem(), tem_def(), viz_tem_def()

Examples

# NOT RUN {
# requires an API key in .Renviron
auto_fpp106 <- demo_stim() |>
  auto_delin(model = "fpp106", replace = TRUE)
# }