Skip to contents

Runs species prediction on one or more images.

Usage

predict_species(
  model,
  image_paths,
  country = NULL,
  admin1_region = NULL,
  latitude = NULL,
  longitude = NULL,
  batch_size = 50,
  show_progress = TRUE,
  output_file = NULL
)

Arguments

model

A loaded SpeciesNet model object from load_speciesnet.

image_paths

Character vector of image file paths.

country

Optional: 3-letter ISO country code for geofencing.

admin1_region

Optional: First-level administrative division (e.g., US state code).

latitude

Optional: Latitude where images were taken.

longitude

Optional: Longitude where images were taken.

batch_size

Number of images to process in one batch (default: 50).

show_progress

Whether to show a progress bar (default: TRUE).

output_file

Optional: Path to a JSONL file to stream results to. If provided, results are not returned in memory.

Value

A list containing predictions for each image, or the output file path if output_file is specified.