feat: add thermal facade and FLIR postprocess app

Author: Pluze

+labkit/+contract/checkRequirements.m

@@ -8,7 +8,8 @@
 % Inputs:
 %   req - struct returned by labkit.contract.requirements.
 %   versions - optional struct array of facade version structs. When omitted,
-%       current labkit.ui/dta/rhs/biosignal/image version APIs are queried.
+%       current labkit.ui/dta/rhs/biosignal/image/thermal version APIs are
+%       queried.
 %
 % Outputs:
 %   report - struct with ok, failures, and message fields. ok is true only
@@ -65,7 +66,8 @@
         labkit.dta.version()
         labkit.rhs.version()
         labkit.biosignal.version()
-        labkit.image.version()];
+        labkit.image.version()
+        labkit.thermal.version()];
 end
 
 function entries = normalizeRequirements(req)

+labkit/+thermal/fileDialogFilter.m

@@ -0,0 +1,37 @@
+function filterSpec = fileDialogFilter(varargin)
+%FILEDIALOGFILTER Return a file-chooser-compatible thermal image filter.
+%
+% App-facing contract:
+%   filterSpec = labkit.thermal.fileDialogFilter()
+%   filterSpec = labkit.thermal.fileDialogFilter("IncludeAll", true)
+%
+% Inputs:
+%   IncludeAll - optional logical scalar, default false. When true, append an
+%       "All files (*.*)" row after the thermal-file row.
+%
+% Outputs:
+%   filterSpec - cell array accepted by filePanel filters and MATLAB
+%       file-chooser filter specs.
+
+    opts = parseOptions(varargin{:});
+    thermalRow = {'*.jpg;*.jpeg;*.rjpg', ...
+        'FLIR radiometric JPEG (*.jpg, *.jpeg, *.rjpg)'};
+    if opts.IncludeAll
+        filterSpec = [thermalRow; {'*.*', 'All files (*.*)'}];
+    else
+        filterSpec = thermalRow;
+    end
+end
+
+function opts = parseOptions(varargin)
+    p = inputParser;
+    p.FunctionName = "labkit.thermal.fileDialogFilter";
+    p.addParameter("IncludeAll", false, @isLogicalScalar);
+    p.parse(varargin{:});
+    opts = p.Results;
+    opts.IncludeAll = logical(opts.IncludeAll);
+end
+
+function tf = isLogicalScalar(value)
+    tf = (islogical(value) || isnumeric(value)) && isscalar(value);
+end

+labkit/+thermal/inspectFile.m

@@ -0,0 +1,47 @@
+function info = inspectFile(path, opts)
+%INSPECTFILE Report whether one file contains readable thermal data.
+%
+% App-facing contract:
+%   info = labkit.thermal.inspectFile(path)
+%   info = labkit.thermal.inspectFile(path, opts)
+%
+% Inputs:
+%   path - scalar char/string path.
+%   opts - optional scalar struct with fields accepted by
+%       labkit.thermal.readFile.
+%
+% Outputs:
+%   info - scalar struct with path, name, supportedExtension, isThermal,
+%       format, identifier, and message fields. This function catches reader
+%       failures and never throws for unsupported or non-radiometric image
+%       content.
+
+    if nargin < 2 || isempty(opts)
+        opts = struct();
+    end
+    [~, base, ext] = fileparts(char(string(path)));
+    info = struct( ...
+        'path', string(path), ...
+        'name', string([base ext]), ...
+        'supportedExtension', labkit.thermal.isSupportedPath(path), ...
+        'isThermal', false, ...
+        'format', "", ...
+        'identifier', "", ...
+        'message', "");
+
+    if ~info.supportedExtension
+        info.identifier = "labkit:thermal:UnsupportedFile";
+        info.message = "Unsupported thermal image file extension.";
+        return;
+    end
+
+    try
+        record = labkit.thermal.readFile(path, opts);
+        info.isThermal = true;
+        info.format = record.format;
+        info.message = record.message;
+    catch ME
+        info.identifier = string(ME.identifier);
+        info.message = string(ME.message);
+    end
+end

+labkit/+thermal/isSupportedPath.m

@@ -0,0 +1,16 @@
+function tf = isSupportedPath(path)
+%ISSUPPORTEDPATH Return true for supported thermal source paths.
+%
+% App-facing contract:
+%   tf = labkit.thermal.isSupportedPath(path)
+%
+% Inputs:
+%   path - char, string, or scalar path-like value.
+%
+% Outputs:
+%   tf - logical scalar. True when the extension is supported by the current
+%       thermal facade reader set.
+
+    [~, ~, ext] = fileparts(char(string(path)));
+    tf = any(lower(string(ext)) == labkit.thermal.supportedExtensions());
+end