flirsettings: Extracts meta tag information from a FLIR JPG image

Description Usage Arguments Details Value Note Author(s) References Examples

View source: R/flirsettings.R

Description

Extracts meta tag information from a FLIR JPG image using system installed Exiftool application. Use this to obtain thermal image calibration values, date/time stamps, object distance, and other parameters saved in FLIR image or video files.

Usage

1
flirsettings(imagefile, exiftoolpath = "installed", camvals = NULL)

Arguments

imagefile

Name of the FLIR JPG file to read from, as captured by the thermal camera. A character string.

exiftoolpath

A character string that determines whether Exiftool has been "installed" (http://www.sno.phy.queensu.ca/~phil/exiftool/) or not. If Exiftool has been installed in a specific location, use to direct to the folder location.

camvals

A list of arguments to be passed to Exiftool as described in Exiftool documentation. A character string. Default value (recommended) is "", which will pass all possible arguments to Exiftool.

Details

The imagefile should be the original captured FLIR JPG file, not a modified JPG. This also works with FLIR video files (.seq and .fcf).

Exiftool should install on most operating systems. Consult with http://www.sno.phy.queensu.ca/~phil/exiftool/ for information on installing Exiftool. If trouble installing, download Exiftool perl scripts and set exiftoolpath to the custom folder locationto access the perl scripts that are attached with this package.

For camvals, provide a character string as described in Exiftool documentation. Set camvals="-*Emissivity", to simply return the Emissivity value. Set camvals="-*Planck*" for camera calibration constants.

Note: the Emissivity value is simply that which is stored in the file. It typically is the default value the camera is set to (0.95), but this does not mean that the true Emissivity of the surface is what is stored in the file. Similar caution is advised regarding the environmental parameters returned from the meta tags. User knowledge is required.

Value

Returns a list of camera meta tags for use in thermal imaging calculations.

Info is the basic list of camera settings.

Dates will be the date values associated with the image creation, modification etc.

Note

Requires Exiftool be installed. see http://www.sno.phy.queensu.ca/~phil/exiftool/

Author(s)

Glenn J Tattersall

References

1. http://www.sno.phy.queensu.ca/~phil/exiftool/ 2. http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/FLIR.html

Examples

1
2
# Example Use
# See https://github.com/gtatters/FLIRJPGConvert/blob/master/Examples.R

Thermimage documentation built on Nov. 30, 2017, 9:01 a.m.