add FilePath property

Author: dlegland

src/@Image/Image.m

@@ -50,6 +50,11 @@
     % Image name, empty by default.
     Name            = '';
 
+    % The path to the file containing the image, if relevant.
+    % This property is set for images read from a file. It is usually not
+    % kept in images resulting from operators.
+    FilePath        = '';
+    
     % Boolean flag indicating whether the image is calibrated or not.
     Calibrated      = false;
 
@@ -252,6 +257,7 @@ function copyFields(obj, that)
         % Does not copy the data buffer.
 
         obj.Name   = that.Name;
+        % The "FileName" property is intentionnally not copied.
 
         if isCompatibleType(obj, that.Type)
             obj.Type   = that.Type;

src/@Image/read.m

@@ -121,4 +121,6 @@
     img = Image(data);
 end
 
-img.Name = [name ext];
+% populate additional meta-data
+img.Name = name;
+img.FilePath = fileName;

src/@Image/readSeries.m

@@ -1,5 +1,5 @@
 function img = readSeries(fileName, varargin)
-% Reads a series of 2D images as a 3D image.
+% Read a series of 2D images as a 3D image.
 %
 %   Syntax:
 %   IMG = Image.readSeries(FILEPATH);
@@ -95,3 +95,7 @@
 end
 
 img = Image('data', data, 'parent', img0);
+
+% populate additional meta-data
+img.Name = name;
+img.FilePath = fileName;