TIFF2FitsET: ReVuePro: TIFF2FitsET

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

Description

A culmination function to decrypt radiometric TIFF stacks (videos) 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. Highly similar to function FLIR2Fits_ET, however, input variable must be a TIFF stack, rather than a radiometric JPG image.

Usage

TIFF2FitsET(
  input_video,
  destination,
  iwidth = 336,
  iheight = 256,
  gapsize = 4596,
  P_R1 = 17096.453125,
  voffset = 8,
  fps = 5,
  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
)

Arguments

destination	The path to a folder at wish you would like to save your rewritten, Vue Pro radiometric TIFF stack.
iwidth	The width, in pixels, of the thermal image. Default is 336.
iheight	The height, in pixels, of the thermal image Default is 256.
gapsize	The number of bytes between each image frame, within the TIFF stack. Default is 4596.
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.
voffset	The number of byted between the start of the TIFF file, and the beginning of the fist image frame. Default is 8.
fps	The frames per second of the TIFF stack. Default is 5.
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' parameter dictating whether conversions will be completed with parallel processing or not. Default is TRUE.
source	A path to the folder containing TIFF stack to be rewritten. There is no default input.

Details

This function partitions TIFF stacks into FITS videos, of one second length. These FITS files contain temperature values (in degrees Celcius), knitten to each pixel. Note that FITS files will be written such that their creation date matches that of capture time (so long as the creation date of the parent TIFF has not been modified since capture). Furthermore, this function calls upon Microsoft Powershell, and is therefore currently limited to Windows users.

Examples

source = "C:/MyJPGs"
destination = "C:/MyFITS"
tempdata = "C:/Temperature_Data/ExperimentTemp.xlsx"
TIFF2FitsET(source = source, destination = destination, fps = 10, AT_Path = tempdata, hum = 30)

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