SEQ_Move: ReVuePro: SEQ_Move

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

Description

A function used to assess the amount of movement observed across a FLIR thermal image, captured in .SEQ format.

Usage

SEQ_Move(
  input_video,
  sample_output = getwd(),
  temp_cut = 1,
  move_cut = 0.01,
  iwidth = 640,
  iheight = 480,
  gapsize = 1424,
  P_R1 = 20939.062,
  voffset = 1372,
  fps = (1/15),
  P_R2 = 0.012890106,
  P_B = 1498.6,
  P_F = 1,
  P_O = -7658,
  emiss = 0.98,
  OD = 1,
  AT,
  transmit = 1,
  hum = 40,
  parallel = TRUE,
  summarise = TRUE
)

Arguments

input_video	A path to the SEQ file within which motion is to be assessed. There is no default input.
sample_output	The path to a folder where a sample FITS file of a thermal image frame will be saved. Default is your current working directory.
temp_cut	A cutoff value that is used to assess whether movement has occurred at a given pixel. If a change in temperature at a given pixel exceeds this value, movement at this pixel is assumed. This value is expressed in degrees Celsius and has a default of 1.0.
move_cut	Another cutoff value that is used to assess whether movement has occurred at a given pixel. If the total proportion of pixels in a given frame that have changed temperature exceeds this value, movement is assumed. Default is 0.01.
iwidth	The width, in pixels, of the thermal image. Default is 640.
iheight	The height, in pixels, of the thermal image Default is 480.
gapsize	The number of bytes between each image frame, within the SEQ stack. Default is 1424.
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 20939.062.
voffset	The number of byted between the start of the SEQ, and the beginning of the fist image frame. Default is 1372.
fps	The frames per second of the TIFF stack. Default is 1/15.
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.012890106.
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 1498.6.
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 -7658.
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	Ambient temperature during capture of SEQ file. There is no default value.
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. Default is 40.
parallel	A binary 'TRUE/FALSE' parameter dictating whether conversions will be completed with parallel processing or not. Default is TRUE.
summarise	A binary 'TRUE/FALSE' parameter dictating whether movement data is to be summarised across the video length or provided in raw format (per frame). Default is TRUE.

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"
SEQ_Move(input_video = source, sample_output = destination, temp_cut = 0.5, move_cut = 0.1, fps = 10, AT = 22, hum = 30)

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