Package: Thermimage 4.1.3

Thermimage: Thermal Image Analysis

A collection of functions and routines for inputting thermal image video files, plotting and converting binary raw data into estimates of temperature. First published 2015-03-26. Written primarily for research purposes in biological applications of thermal images. v1 included the base calculations for converting thermal image binary values to temperatures. v2 included additional equations for providing heat transfer calculations and an import function for thermal image files (v2.2.3 fixed error importing thermal image to windows OS). v3. Added numerous functions for converting thermal image, videos, rewriting and exporting. v3.1. Added new functions to convert files. v3.2. Fixed the various functions related to finding frame times. v4.0. fixed an error in atmospheric attenuation constants, affecting raw2temp and temp2raw functions. Recommend update for use with long distance calculations. v.4.1.3. changed to frameLocates to reflect change to as.character() to format().

Authors:Glenn J. Tattersall

Thermimage_4.1.3.tar.gz
Thermimage_4.1.3.zip(r-4.5)Thermimage_4.1.3.zip(r-4.4)Thermimage_4.1.3.zip(r-4.3)
Thermimage_4.1.3.tgz(r-4.4-any)Thermimage_4.1.3.tgz(r-4.3-any)
Thermimage_4.1.3.tar.gz(r-4.5-noble)Thermimage_4.1.3.tar.gz(r-4.4-noble)
Thermimage_4.1.3.tgz(r-4.4-emscripten)Thermimage_4.1.3.tgz(r-4.3-emscripten)
Thermimage.pdf |Thermimage.html✨
Thermimage/json (API)

# Install 'Thermimage' in R:
install.packages('Thermimage', repos = c('https://gtatters.r-universe.dev', 'https://cloud.r-project.org'))

Peer review:

Bug tracker:https://github.com/gtatters/thermimage/issues

Datasets:
  • flirpal - Colour palette extracted from FLIR thermal camera files
  • glowbowpal - Colour palette extracted from FLIR thermal camera files
  • grey10pal - Colour palette extracted from FLIR thermal camera files
  • grey120pal - Colour palette extracted from FLIR thermal camera files
  • greyredpal - Colour palette extracted from FLIR thermal camera files
  • hotironpal - Colour palette extracted from FLIR thermal camera files
  • ironbowpal - Colour palette extracted from FLIR thermal camera files
  • medicalpal - Colour palette extracted from FLIR thermal camera files
  • midgreenpal - Colour palette extracted from FLIR thermal camera files
  • midgreypal - Colour palette extracted from FLIR thermal camera files
  • mikronprismpal - Colour palette extracted from Mikron thermal camera files
  • mikroscanpal - Colour palette extracted from FLIR thermal camera files
  • rainbow1234pal - Colour palette extracted from FLIR thermal camera files
  • rainbowpal - Colour palette extracted from FLIR thermal camera files
  • samp.image - A sample thermal image to demonstrate thermal colour palette use.
  • yellowpal - Colour palette extracted from FLIR thermal camera files

On CRAN:

animal-physiologyheat-exchangeheat-fluximage-framestemperaturethermal-biologythermal-images

53 exports 164 stars 5.01 score 2 dependencies 1 mentions 85 scripts 387 downloads

Last updated 3 years agofrom:7bd5a9afcd. Checks:OK: 1 NOTE: 6. Indexed: yes.

TargetResultDate
Doc / VignettesOKAug 28 2024
R-4.5-winNOTEAug 28 2024
R-4.5-linuxNOTEAug 28 2024
R-4.4-winNOTEAug 28 2024
R-4.4-macNOTEAug 28 2024
R-4.3-winNOTEAug 28 2024
R-4.3-macNOTEAug 28 2024

Exports:airdensityairspecificheatairtconductivityairviscosityareaconeareacylinderareasphereconvertflirJPGconvertflirVIDcumulDiffdiffFrameffmpegcallflip.matrixflirsettingsforcedparametersframeLocatesfreeparametersgetFramesgetTimesGrashofhconvLdlocate.fidLuLwmeanEveryNmirror.matrixnameleadzeroNusseltforcedNusseltfreepalette.chooseplotThermPrandtlqabsqcondqconvqradraw2tempreadflirJPGReynoldsrotate180.matrixrotate270.matrixrotate90.matrixslopebypointslopeEveryNStephBoltzTetemp2rawTeqTgroundthermsumthermsumcentwriteFlirBin

Dependencies:pngtiff

Readme and manuals

Help Manual

Help pageTopics
Handles thermal image data input and conversion to temperature using established physical equations.Thermimage-package Thermimage
Returns the density of air for a given air temperature.airdensity
Specific heat capacity of airairspecificheat
Thermal conductivity of air.airtconductivity
Returns air viscosity for a given air temperature.airviscosity
Provides the surface are of a coneareacone
Provides the surface area of a cylinder.areacylinder
Provides the surface area of a sphere.areasphere
Convert FLIR jpg into 16 bit grayscale file using shell commands.convertflirJPG
Convert FLIR CSQ or SEQ into PNG or AVI, using shell commands.convertflirVID
Cumulative difference sum function for use with frame by frame difference dataframecumulDiff
A frame difference function for subtracting adjacent frames from an imported thermal image sequence.diffFrame
A simplified wrapper function calling ffmpegffmpegcall
Flips a matrix 'left-right'. Used in re-arranging image data for plotting properly in R.flip.matrix
Colour palette extracted from FLIR thermal camera filesflirpal
Extracts meta tag information from a FLIR JPG imageflirsettings
Parameters required for forced convection equation.forcedparameters
Find the frame read start positions in a FLIR SEQ video file.frameLocates
Parameters required for free convection equation.freeparameters
Extract raw binary thermal from thermal image file.getFrames
Extracts time values from binary imported thermal video filegetTimes
Colour palette extracted from FLIR thermal camera filesglowbowpal
Determines the Grashof number for an objectGrashof
Colour palette extracted from FLIR thermal camera filesgrey10pal
Colour palette extracted from FLIR thermal camera filesgrey120pal
Colour palette extracted from FLIR thermal camera filesgreyredpal
Convective heat coefficient (W/m2/oC)hconv
Colour palette extracted from FLIR thermal camera fileshotironpal
Colour palette extracted from FLIR thermal camera filesironbowpal
Estimates downward facing longwave radiation (W/m2)Ld
Returns the index locations that match vector fid within data vector.locate.fid
Estimates upward facing ground radiation (W/m2)Lu
Estimates downward facing longwave radiation (W/m2)Lw
Calculate the mean every nth data point.meanEveryN
Colour palette extracted from FLIR thermal camera filesmedicalpal
Colour palette extracted from FLIR thermal camera filesmidgreenpal
Colour palette extracted from FLIR thermal camera filesmidgreypal
Colour palette extracted from Mikron thermal camera filesmikronprismpal
Colour palette extracted from FLIR thermal camera filesmikroscanpal
Mirrors a matrix upside-down. Used in re-arranging image data for plotting properly in R.mirror.matrix
Add leading zeros to character for easy sequential naming of filenames.nameleadzero
Nusselt number for forced convection.Nusseltforced
Nusselt number for free convection.Nusseltfree
Choose a colour palette for gradient filling thermal image files.palette.choose
Plot thermal image data for visualisation purposes.plotTherm
Returns the Prandtl numberPrandtl
Estimates the absorbed solar and infrared radiation (W/m2)qabs
Estimates the area specific heat transfer by conduction (W/m2)qcond
Estimates the area specific heat transfer by convection (W/m2)qconv
Estimates the area specific heat transfer by radiation (W/m2)qrad
Colour palette extracted from FLIR thermal camera filesrainbow1234pal
Colour palette extracted from FLIR thermal camera filesrainbowpal
Converts raw thermal data into temperature (oC)raw2temp
Reads an image from a FLIR JPG file into an integer array.readflirJPG
Calculates the Reynolds number.Reynolds
Rotate a matrix by 180 degrees. Used for adjusting image plotting in R.rotate180.matrix
Rotate a matrix by 270 degrees counterclockwise (or 90 degree clockwise). Used for adjusting image plotting in R.rotate270.matrix
Rotate a matrix by 90 degrees counterclockwise (270 degrees clockwise). Used for adjusting image plotting in R.rotate90.matrix
A sample thermal image to demonstrate thermal colour palette use.samp.image
Returns the slope from linear regression with x values as equally spaced 1:lengthslopebypoint
Calculate the slope every nth data point.slopeEveryN
The Stephan Boltzman constant.StephBoltz
Operative temperature estimate.Te
Converts temperature (oC) to raw thermal datatemp2raw
Estimates equivalent temperature.Teq
Estimates ground temperature from ambient temperature and solar radiation.Tground
Return summary of thermal image data.thermsum
Summary thermal calculations on a centrally located region of interest from a thermal image datasetthermsumcent
Saves thermal image data to a binary filewriteFlirBin
Colour palette extracted from FLIR thermal camera filesyellowpal