3%> containing the content(s) of the ParaMonte simulation output progress
4%> file(s) whose path(s) match the specified input ``pattern`` or the
5%> simulation specification ``sampler.spec.outputFileName``.<br>
8%> This method is to be only used
for post-processing of the output
9%> progress file(s) of an already finished simulation. Although possible,
10%>
this method is NOT meant to be called by all processes
13%> \param[in] self : The input parent
object of
class [pm.sampling.Sampler](@ref
Sampler)
14%>
which is **implicitly** passed to
this dynamic method (not by the user).<br>
15%> \param[in] pattern : The input scalar MATLAB
string containing the pattern matching
16%> the desired progress file(s) whose contents is to be read.<br>
17%> The specified ``pattern`` only needs to partially identify
18%> the
name of the simulation to
which the progress file belongs.<br>
19%> For example, specifying ``
"./mydir/mysim"`` as input will
20%> lead to a search
for file(s) beginning with
"mysim" and
21%> ending with ``
"_progress.txt"`` inside the directory ``
"./mydir/"``.<br>
22%> If there are multiple files matching in the input ``pattern``,
23%> then all such files will be read and returned as elements of a
list.<br>
24%> If the specified pattern is a valid existing URL, the file will be
25%> downloaded as a temporary file to the local system, its contents
26%> shall be parsed and the file will be subsequently removed.<br>
27%> If the input ``pattern`` is empty, then the method will search
28%>
for any possible candidate files with the appropriate suffix
29%> in the current working directory.<br>
30%> (**optional**,
default = ``sampler.spec.outputFileName`` or ``
"./"``)
31%> \param[in] sep : The input MATLAB
string containing the field separator used in the file(s).<br>
32%> (**optional**,
default = ``sampler.spec.outputSeparator`` or automatically inferred.)
35%> ``progressList`` : The output MATLAB cell array of objects
37%> each of
which corresponds to the contents
38%> of a unique progress file.<br>
43%> sampler = pm.sampling.Sampler();
44%> progressList = sampler.readProgress();
45%> progressList = sampler.readProgress([]);
46%> progressList = sampler.readProgress([], []);
47%> progressList = sampler.readProgress(pattern);
48%> progressList = sampler.readProgress([], sep);
49%> progressList = sampler.readProgress(pattern, sep);
54%> See the documentation of the subclasses of [pm.sampling.Sampler](@ref
Sampler)
55%> (e.g., [pm.sampling.Paradram](@ref
Paradram))
for example usage in action.<br>
60%> sampler.readProgress(
"./out/test_run_");
62%> sampler.spec.outputFileName =
"./out/test_run_";
63%> sampler.readProgress();
65%> sampler.readProgress(
"./out/test_run_",
",");
67%> sampler.spec.outputSeparator =
",";
68%> sampler.readProgress(
"./out/test_run_");
70%> sampler.spec.outputFileName =
"./out/test_run_";
71%> sampler.spec.outputSeparator =
",";
72%> sampler.readProgress();
79%> \JoshuaOsborne, May 21 2024, 12:25 AM, University of Texas at Arlington<br>
80%> \FatemehBagheri, May 20 2024, 1:25 PM, NASA Goddard Space Flight Center (GSFC), Washington, D.C.<br>
81%> \AmirShahmoradi, May 16 2016, 9:03 AM, Oden Institute
for Computational Engineering and Sciences (ICES), UT Austin<br>
92 progressList = pm.sampling.readProgress(self, pattern, sep);
function name(in vendor)
Return the MPI library name as used in naming the ParaMonte MATLAB shared library directories.
function list()
Return a list of MATLAB strings containing the names of OS platforms supported by the ParaMonte MATLA...
This is the base class for generating objects that contain the contents of a progress file generated ...
This is the ParaDRAM class for generating instances of serial and parallel Delayed-Rejection Adaptive...
This is the base class for the ParaMonte sampler routines.
function parallel()
Return a scalar MATLAB logical that is true if and only if the current installation of MATLAB contain...
function readProgress(in sampler, in pattern, in sep)
Return a list of objects of superclass pm.sampling.FileContentsProgress containing the contents of a ...
function which(in vendor)
Return the a MATLAB string containing the path to the first mpiexec executable binary found in system...