From bfaec3bb596c2f541bae6364aa620a6082b43d15 Mon Sep 17 00:00:00 2001
From: "Juhil Dungrani (dungranij)" <dungranij@coventry.ac.uk>
Date: Mon, 5 Jul 2021 16:35:52 +0100
Subject: [PATCH] Add files via upload

---
 ParforProgMon.m  | 157 +++++++++++++++++++++++++++++++++++++++++++++++
 Readme.md        |  31 ++++++++++
 license.txt      |  29 +++++++++
 progress_bar.png | Bin 0 -> 15976 bytes
 4 files changed, 217 insertions(+)
 create mode 100644 ParforProgMon.m
 create mode 100644 Readme.md
 create mode 100644 license.txt
 create mode 100644 progress_bar.png

diff --git a/ParforProgMon.m b/ParforProgMon.m
new file mode 100644
index 0000000..4a0d0f6
--- /dev/null
+++ b/ParforProgMon.m
@@ -0,0 +1,157 @@
+% <strong>ParforProgMon</strong> - CLASS Progress monitor for `parfor` loops
+%
+% <strong>Usage</strong>
+% Begin by creating a parallel pool.
+%
+% Then construct a <a href="matlab:help ParforProgMon">ParforProgMon</a> object:
+% ppm = <a href="matlab:help ParforProgMon">ParforProgMon</a>(strWindowTitle, nNumIterations <, nProgressStepSize, nWidth, nHeight, nMinIterations>);
+%
+% 'strWindowTitle' is a string containing the title of the progress bar
+% window. 'nNumIterations' is an integer with the total number of
+% iterations in the loop.
+%
+% <strong>Optional arguments</strong> 'nProgressStepSize' specifies how
+% many loop iterations should correspond to a single call to 'increment()'.
+% 'nWidth' and 'nHeight' specify the size of the progress window.
+%
+% <strong>Within the parfor loop</strong>
+% parfor (nIndex = 1:nNumIterations)
+%    if (mod(nIndex, nProgressStepSize) == 0)
+%       ppm.increment();
+%    end
+% end
+%
+% Modified from <a href="https://www.mathworks.com/matlabcentral/fileexchange/31673-parfor-progress-monitor-v2">ParforProgMonv2</a>.
+
+classdef ParforProgMon < handle
+   
+   properties ( GetAccess = private, SetAccess = private )
+      Port
+      HostName
+      strAttachedFilesFolder
+   end
+   
+   properties (Transient, GetAccess = private, SetAccess = private)
+      JavaBit
+   end
+   
+   methods ( Static )
+      function o = loadobj( X )
+         % loadobj - METHOD REconstruct a ParforProgMon object
+         
+         % Once we've been loaded, we need to reconstruct ourselves correctly as a
+         % worker-side object.
+         % fprintf('Worker: Starting with {%s, %f, %s}\n', X.HostName, X.Port, X.strAttachedFilesFolder);
+         o = ParforProgMon( {X.HostName, X.Port, X.strAttachedFilesFolder} );
+      end
+   end
+   
+   methods
+      function o = ParforProgMon(strWindowTitle, nNumIterations, nProgressStepSize, nWidth, nHeight, nMinIterations)
+         % ParforProgMon - CONSTRUCTOR Create a ParforProgMon object
+         % 
+         % Usage: ppm = ParforProgMon(strWindowTitle, nNumIterations <, nProgressStepSize, nWidth, nHeight>)
+         % 
+         % 'strWindowTitle' is a string containing the title of the
+         % progress bar window. 'nNumIterations' is an integer with the
+         % total number of iterations in the loop. 'nProgressStepSize'
+         % indicates that one update (call to 'increment') corresponds to
+         % this many iterations. 'nWidth' indicates the width of the
+         % progress window. 'nHeight' indicates the width of the progress
+         % window.
+         
+         if (~exist('nMinIterations', 'var') || isempty(nMinIterations))
+            nMinIterations = 0;
+         end
+         
+         % - Are we a worker or a server?
+         if ((nargin == 1) && iscell(strWindowTitle))
+            % - Worker constructor
+            % Get attached files
+            o.strAttachedFilesFolder = getAttachedFilesFolder(strWindowTitle{3});
+            % fprintf('Worker: Attached files folder on worker is [%s]\n', o.strAttachedFilesFolder);
+                        
+            % Add to java path
+            w = warning('off', 'MATLAB:Java:DuplicateClass');
+            javaaddpath(o.strAttachedFilesFolder);
+            warning(w);
+            
+            % "Private" constructor used on the workers
+            o.JavaBit   = ParforProgressMonitor.createWorker(strWindowTitle{1}, strWindowTitle{2});
+            o.Port      = [];
+            
+         elseif (nargin > 1) && (nNumIterations >= nMinIterations)
+            % - Server constructor
+            % Check arguments
+            if (~exist('nProgressStepSize', 'var') || isempty(nProgressStepSize))
+               nProgressStepSize = 1;
+            end
+            
+            if (~exist('nWidth', 'var') || ~exist('nHeight', 'var') || isempty(nHeight) || isempty(nWidth))
+               nWidth = 400;
+               nHeight = 80;
+            end               
+            
+            % Check for an existing pool
+            pPool = gcp('nocreate');
+            if (isempty(pPool))
+               error('ParforProgMon:NeedPool', ...
+                     '*** ParforProgMon: You must construct a pool before creating a ParforProgMon object.');
+            end
+            
+            % Amend java path
+            strPath = fileparts(which('ParforProgMon'));
+            o.strAttachedFilesFolder = fullfile(strPath, 'java');
+            % fprintf('Server: JAVA class folder is [%s]\n', o.strAttachedFilesFolder);
+            w = warning('off', 'MATLAB:Java:DuplicateClass');
+            javaaddpath(o.strAttachedFilesFolder);
+            warning(w);
+            
+            % Distribute class to pool
+            if (ismember(pPool.AttachedFiles, o.strAttachedFilesFolder))
+               pPool.updateAttachedFiles();
+            else
+               pPool.addAttachedFiles(o.strAttachedFilesFolder);
+            end
+            
+            % Normal construction
+            o.JavaBit   = ParforProgressMonitor.createServer( strWindowTitle, nNumIterations, nProgressStepSize, nWidth, nHeight );
+            o.Port      = double( o.JavaBit.getPort() );
+            % Get the client host name from pctconfig
+            cfg         = pctconfig;
+            o.HostName  = cfg.hostname;
+         end
+      end
+      
+      function X = saveobj( o )
+         % saveobj - METHOD Save a ParforProgMon object for serialisations
+         
+         % Only keep the Port, HostName and strAttachedFilesFolder
+         X.Port     = o.Port;
+         X.HostName = o.HostName;
+         X.strAttachedFilesFolder = o.strAttachedFilesFolder;
+      end
+      
+      function increment( o )
+         % increment - METHOD Indicate that a single loop execution has finished
+         
+         % Update the UI
+         if (~isempty(o.JavaBit))
+            o.JavaBit.increment();
+         end
+      end
+      
+      function delete( o )
+         % delete - METHOD Delete a ParforProgMon object
+         
+         % - Make sure that any other threads that may have closed 
+         %   the UI down have a chance to do it first
+         pause(.01);
+         
+         % Close the UI
+         if (~isempty(o.JavaBit))
+            o.JavaBit.done();
+         end
+      end
+   end
+end
diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..4c37ee0
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,31 @@
+# Parfor progress monitor
+<img align="right" src="https://github.com/DylanMuir/ParforProgMon/raw/master/progress_bar.png" />
+
+## A Java-based `Matlab` class for progress monitoring during a `parfor` loop
+
+### Usage
+Begin by creating a parallel pool.
+ 
+Then construct a ParforProgMon object:
+
+    ppm = ParforProgMon(strWindowTitle, nNumIterations <, nProgressStepSize, nWidth, nHeight>);
+ 
+ `strWindowTitle` is a string containing the title of the progress bar
+  window. `nNumIterations` is an integer with the total number of
+  iterations in the loop.
+ 
+#### Optional arguments
+  `nProgressStepSize` specifies to update the progress bar every time this
+  number of steps passes. `nWidth` and `nHeight` specify the size of the
+  progress window.
+ 
+Within the `parfor` loop:
+
+    parfor (nIndex = 1:nNumIterations)
+       ppm.increment();
+    end
+
+### Credits
+[Parfor Progress monitor](https://www.mathworks.com/matlabcentral/fileexchange/24594-parfor-progress-monitor)
+
+[Parfor Progress monitor v2](https://www.mathworks.com/matlabcentral/fileexchange/31673-parfor-progress-monitor-v2)
diff --git a/license.txt b/license.txt
new file mode 100644
index 0000000..68eb73a
--- /dev/null
+++ b/license.txt
@@ -0,0 +1,29 @@
+Copyright (c) 2016, Dylan Muir
+Copyright (c) 2011, Willem-Jan de Goeij
+Copyright (c) 2009, The MathWorks, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in
+      the documentation and/or other materials provided with the distribution
+    * Neither the name of the The MathWorks, Inc. nor the names
+      of its contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
diff --git a/progress_bar.png b/progress_bar.png
new file mode 100644
index 0000000000000000000000000000000000000000..8fc476c492b4ef203aabdd0c63372b700b98f661
GIT binary patch
literal 15976
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

literal 0
HcmV?d00001