F2FET: ReVuePro: F2FET

In joshuakrobertson/R-Package_ReVuePro: ReVuePro: Enabling analysis of thermal images captured by FLIRs VuePro R

Description

A culmination function to decrypt radiometric JPGs (rJPGs) captured using a FLIR Vue Pro R camera, convert units of infrared radiation (kW/m2) to units of temperature (degrees Celsius), and construct a FITS file using IEEE754, single point format to encode temperature information. This function is similar to function FLIR2Fits_ET but permits use of parallel processing.

Usage

F2FET(
  source,
  destination,
  pwidth = 336,
  pheight = 256,
  P_R1 = 17096.453125,
  P_R2 = 0.04351538,
  P_B = 1428,
  P_F = 1,
  P_O = -55,
  emiss = 0.98,
  OD = 1,
  AT_Path,
  transmit = 1,
  hum,
  parallel = "TRUE",
  battery_check = "FALSE"
)

Arguments

source	A path to the folder containing radiometric JPGs (rJPGs) to be rewritten. There is no default input.
destination	The path to a folder at wish you would like to save your rewritten, Vue Pro radiometric JPG (rJPG).
pwidth	The width, in pixels, of the thermal image. Default is 336.
pheight	The height, in pixels, of the thermal image Default is 256.
P_R1	Planck_R1 from function "Rad_Temp" in package "ReVuePro". A callibration constant, specific per FLIR camera. This can be determined using 'exiftool.exe', produced by Phil Harvey. Default is 17096.453125.
P_R2	Planck_R2 from function "Rad_Temp" in package "ReVuePro". A callibration constant, specific per FLIR camera. This can be determined using 'exiftool.exe', produced by Phil Harvey. Default is 0.04351538.
P_B	Planck_B from function "Rad_Temp" in package "ReVuePro". A callibration constant, specific per FLIR camera. This can be determined using 'exiftool.exe', produced by Phil Harvey. Default is 1428.0.
P_F	Planck_F from function "Rad_Temp" in package "ReVuePro". A callibration constant, specific per FLIR camera. This can be determined using 'exiftool.exe', produced by Phil Harvey. Default is 1.0.
P_O	Planck_O from function "Rad_Temp" in package "ReVuePro". A callibration constant, specific per FLIR camera. This can be determined using 'exiftool.exe', produced by Phil Harvey. Default is -55.0.
emiss	Emmissivity from function "Rad_Temp" in package "ReVuePro". The relative energy that is emitted (or radiated) from the surface of the object in the image, compared to that emitted from a blackbody in equivalent conditions. This value must lay between 0 and 1. Default is 0.98.
OD	obj_distance from function "Rad_Temp" in package "ReVuePro". The distance between the thermal imaging camera and object to be measured within the image. This value is expressed in metres. Default is 1.0 metres.
AT_Path	A path to an XLSX or CSV file containing ambient temperature and time at which ambient temperature was collected. Currently, this package supports formatting produced by WeeButton(TM) software, or outputs from the "CButtonFile", or "CButtonDate" functions (from the ReVuePro package).
transmit	wind_transmittance from function "Rad_Temp" in package "ReVuePro". The relative amount of light transmitted though a window between the thermal imaging camera and object in question. This value must lay between 0 and 1, with a default value of 1.
hum	humidity from function "Rad_Temp" in package "ReVuePro". Relative, atmospheric humidity at the time if image character. This value is expressed as a percentage, and therefore should lay between 0 and 100.
parallel	A binary "TRUE/FALSE" variable that determines whether internal operations will be run by parallel processing. If "TRUE", function will call upon the "doParallel" package. Default is "TRUE".
battery_check	If "TRUE", assess battery level of computer every ten loops. If batter power is below 5 percent, unprocessed images will be shuffled to a new folder entitled "JPGs2Do", within the parent directory. After files are shuffled, the R session will quit. Default is "FALSE".

Details

Note that FITS files will be written such that their creation date matches that of the parent JPG. Furthermore, this function calls upon Microsoft Powershell in Windows, and Bash in Linux, and is therefore currently limited to Windows and Linux users alone.

Examples

source = "C:/MyJPGs"
destination = "C:/MyFITS"
tempdata = "C:/Temperature_Data/ExperimentTemp.xlsx"
F2FET(source = source, destination = destination, pwidth = 336, pheight = 256, P_R1 = 17096.453125, P_R2 = 0.04351538, P_B = 1428.0, P_F = 1, P_O = -55.0, emiss = 0.98, OD = 1.0, AT_Path = tempdata, hum = 30, battery_check="TRUE") 

joshuakrobertson/R-Package_ReVuePro documentation built on June 2, 2020, 8:23 p.m.