iRfcb (version 0.5.1)

ifcb_convert_filenames: Convert IFCB Filenames to Timestamps

Description

This function converts IFCB filenames to a data frame with separate columns for the sample name, full timestamp, year, month, day, time, and IFCB number. ROI numbers are included if available.

Usage

ifcb_convert_filenames(filenames, tz = "UTC")

Value

A tibble with the following columns:

• sample: The extracted sample name (character).

• full_timestamp: The full timestamp in "YYYY-MM-DD HH:MM:SS" format (POSIXct).

• year: The year extracted from the timestamp (integer).

• month: The month extracted from the timestamp (integer).

• day: The day extracted from the timestamp (integer).

• time: The extracted time in "HH:MM:SS" format (character).

• ifcb_number: The IFCB instrument number (character).

• roi: The extracted ROI number if available (integer or NA).

If the roi column is empty (all NA), it will be excluded from the output.

Arguments

filenames

A character vector of IFCB filenames in the format "DYYYYMMDDTHHMMSS_IFCBxxx" or "IFCBxxx_YYYY_DDD_HHMMSS". Filenames can optionally include an ROI number, which will be extracted if present.

tz

Character. Time zone to assign to the extracted timestamps. Defaults to "UTC". Set this to a different time zone if needed.

Examples

filenames <- c("D20230314T001205_IFCB134", "D20230615T123045_IFCB135")
timestamps <- ifcb_convert_filenames(filenames)
print(timestamps)