BioThermR (version 0.1.0)

read_thermal_flir: Read FLIR Radiometric JPG File

Description

Reads a FLIR radiometric JPG file, parses the embedded metadata (emissivity, distance, Planck constants, atmospheric parameters), converts the raw sensor data to temperature (Celsius), and constructs a 'BioThermR' object.

Usage

read_thermal_flir(file_path, exiftoolpath = "installed")

Value

A list object of class "BioThermR" containing:

raw

The calculated temperature matrix in degrees Celsius.

processed

A copy of the raw matrix, intended for subsequent ROI filtering or masking.

meta

A list containing metadata: filename, fullpath, and dims.

Arguments

file_path

String. The full path to the FLIR radiometric .jpg file.

exiftoolpath

String. Path to the ExifTool executable. Default is "installed" (assumes it is available in the system PATH).

Details

This function relies on the 'Thermimage' package and the external tool 'ExifTool'. It automatically extracts calibration constants (Planck R1, B, F, O, R2) and environmental parameters to ensure accurate physical temperature conversion. Please ensure 'ExifTool' is installed and added to your system PATH.

Examples

# \donttest{
# Example using a flir thermal file
img_obj <- system.file("extdata", "IR_2412.jpg", package = "Thermimage")
img <- read_thermal_flir(img_obj)
# }