What is the best way to install ImageM?

[ctrueden]

I tried several ways of installing ImageM, running into many problems before finding a solution that worked:

• Installed MATLAB R2021a with Image Processing and Statistics and Machine Learning toolboxes.

• Installed ImageM via the Add-On Manager. Then:

  >> ImageM
  Starting the ImageM application...
  Unable to resolve the name uix.VBox.
  
  Error in imagem.gui.PlanarImageViewer/PlanarImageViewer/setupLayout (line 91)
      mainPanel = uix.VBox('Parent', hf, ...
  
  Error in imagem.gui.PlanarImageViewer (line 59)
      setupLayout(fig);
  
  Error in imagem.gui.ImagemGUI/createImageFrame (line 97)
      frame = imagem.gui.PlanarImageViewer(obj, doc);
  
  Error in ImageM (line 64)
      viewer = createImageFrame(gui, img);
  
  >> 
  

• Installed ImageM and GUI Layout Toolbox via the Add-On Manager. Then:

  >> ImageM
  Starting the ImageM application...
  create a new image
  Unable to resolve the name Image.create.
  
  Error in imagem.actions.file.CreateImage/run (line 70)
      img = Image.create([dimX dimY], dataType);
  
  Error in imagem.gui.FrameMenuBuilder>@(src,evt)action.run(obj.Frame) (line 475)
      'Callback', @(src, evt) action.run(obj.Frame));
  
  Error while evaluating Menu Callback.
  

• Searched Add-On Explorer for "mattools". Installed geom2D and geom3D and MatStats and MatImage. Then:

  >> ImageM
  Starting the ImageM application...
  create a new image
  (same error as before)
  

• Tried running installMatImage.m:

  >> installMatImage
  Installing MatImage Library
  Adding module: util                Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/Toolboxes/MatImage/matImage/util 
  > In path (line 109)
  In addpath (line 86)
  In installMatImage (line 44) 
   (done)
  Adding module: imFilters            (done)
  Adding module: imMeasures           (done)
  Adding module: imMinkowski          (done)
  Adding module: imGeodesics          (done)
  Adding module: imGranulometry       (done)
  Adding module: imShapes             (done)
  Adding module: imStacks             (done)
  
  >> ImageM
  create a new image
  (same error as before)
  

• Downloaded ImageM-1.3.2.1-full.mlappinstall and opened it in MATLAB. This added ImageM as an app.

• From APPS tab, clicked ImageM toolbar button to launch.

  Received errors:
  
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matGeom\geom2d 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 36)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matGeom\polygons2d 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 37)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matGeom\geom3d 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 38)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matGeom\meshes3d 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 39)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matGeom\utils 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 40)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\matStats 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 43)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  Warning: Name is nonexistent or not a directory: /home/curtis/MATLAB Add-Ons/libs\imageClass 
  > In path (line 109)
  In addpath (line 86)
  In ImageM (line 46)
  In ImageMApp/startApp (line 86)
  In ImageMApp (line 48)
  In appinstall.internal.runapp>execute (line 116)
  In appinstall.internal.runapp>runapp13a (line 95)
  In appinstall.internal.runapp>preamble18b (line 60)
  In appinstall.internal.runapp (line 13)
  In matlab.apputil.run (line 45) 
  create a new image
  Open new Image 
  >>
  

• Edited MATLAB Add-Ons/Apps/ImageM/D__/dlegland/dev/matlab/image/ImageM/package/full/ImageM/ImageM.m to fix the slashes.

• Launched ImageM app again. Same error.

• Restarted MATLAB. Launched ImageM app again. Same error.

• But, despite these errors, the application seems to function.

It would be great to have better documentation in the README about how to install ImageM properly. Thanks!