README.md

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

ReVuePro

ReVuePro is a small R package designed to decrypt radiometric JPGs (or, "rJPGs"), captured with a Vue Pro camera (produced by FLIR TM). By decrypting rJPGs, thermal imagers will be free to convert raw infrared radiation -- captured in rJPGs -- to temperature in degrees Celcius using the freely available and open-source software, "ImageJ", and macros uploaded in another repository.

This package can be downloaded using devtools with the following code:

install.packages('devtools')
devtools::install_github("joshuakrobertson/ReVuePro")

Description:

The FLIR Vue Pro offers a relatively inexpensive, durable, and remarkably portable mean to capture thermal images with raw radiance data stored per pixel. Unfortunately, manufactorer supplied software allowing one to extract, interpret, and store such radiance data is expensive and cumbersome. Furthermore, images captured with the VuePro are encrypted and cannot be opened efficiently in ImageJ without prior decryption. Before installing this package, we request that users first install 'EBImage' from 'Bioconducter' according to: https://www.bioconductor.org/packages/release/bioc/html/EBImage.html.

This R package (created in v 3.6.1) will enable one to:

1) Efficiently decrypt images and rewrite them to RAW files, to be analysed in ImageJ, 2) Harvest 'Date/Time' signatures from parent rJPGS, and assign them to progeny RAW files, so you, as the thermal imager, will not lose critical information about when your image was capture. 3) Clean and organize external, ambient temperature data collected using Thermochron iButtonsTM, and to be used for thermal image calibration. 4) Easily calculate dry heat transfer from an object imaged thermographically. 5) Detect and quantify motion from digital images by calling ffmpeg (although not entirely necessary for thermography, this feature may be helpful when aligning thermographic and digital images). Note that ffmpeg must be installed for this feature to be operational.

Once files have been decrypted, date/time stamps have been preserved, and ambient temperature data has been organized, output files will be ready to be analysed in ImageJ! Most time-demanding functions are equipped with options for parallel processing, to ensure that analyses may be conducted semi-rapidly.

As a disclaimer, the package currently requires one to have "Microsoft Powershell" installed, and is therefore limited to Microsoft users only, for the moment. Some functions have been updated to call bash in place of powershell (if an Apple of Linux operating system is in use), but this feature has not yet been extended to all functions. My apologies for the unfortunate discrimination.

Good luck thermal imagers!

Joshua K Robertson

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