Add progress bar keywords

package/AUTHORS

@@ -212,6 +212,7 @@ Chronological list of authors
   - Domenico Marson
   - Ahmed Salah Ghoneim
   - Alexander Schlaich
+  - Egor Marin
 
 External code
 -------------

package/CHANGELOG

@@ -45,6 +45,7 @@ Enhancements
   * AuxReaders are now pickle-able and copy-able (Issue #1785, PR #3887)
   * Add pickling support for Atom, Residue, Segment, ResidueGroup 
     and SegmentGroup. (PR #3953)
+  * Add `progressbar_kwargs` parameter to `AnalysisBase.run` method, allowing to modify description, position etc of tqdm progressbars.
 
 Changes
   * As per NEP29 the minimum supported NumPy version has been raised to 1.21

package/MDAnalysis/analysis/base.py

@@ -390,7 +390,7 @@ def _conclude(self):
         pass  # pylint: disable=unnecessary-pass
 
     def run(self, start=None, stop=None, step=None, frames=None,
-            verbose=None):
+            verbose=None, *, progressbar_kwargs={}):
         """Perform the calculation
 
         Parameters
@@ -411,12 +411,19 @@ def run(self, start=None, stop=None, step=None, frames=None,
 
         verbose : bool, optional
             Turn on verbosity
+
+        progressbar_kwargs : dict, optional
+            ProgressBar keywords with custom parameters regarding progress bar position, etc; 
+            see :class:`MDAnalysis.lib.log.ProgressBar` for full list.
 
 
         .. versionchanged:: 2.2.0
             Added ability to analyze arbitrary frames by passing a list of
             frame indices in the `frames` keyword argument.
 
+        .. versionchanged:: 2.5.0
+            Add `progressbar_kwargs` parameter, 
+            allowing to modify description, position etc of tqdm progressbars
         """
         logger.info("Choosing frames to analyze")
         # if verbose unchanged, use class default
@@ -429,9 +436,11 @@ def run(self, start=None, stop=None, step=None, frames=None,
         self._prepare()
         logger.info("Starting analysis loop over %d trajectory frames",
                     self.n_frames)
+
         for i, ts in enumerate(ProgressBar(
                 self._sliced_trajectory,
-                verbose=verbose)):
+                verbose=verbose,
+                **progressbar_kwargs)):
             self._frame_index = i
             self._ts = ts
             self.frames[i] = ts.frame

testsuite/MDAnalysisTests/analysis/test_base.py

@@ -274,6 +274,12 @@ def test_verbose_progressbar_run(u, capsys):
     actual = err.strip().split('\r')[-1]
     assert actual[:24] == expected[:24]
 
+def test_verbose_progressbar_run_with_kwargs(u, capsys):
+    an = FrameAnalysis(u.trajectory).run(verbose=True, progressbar_kwargs={'desc':'custom'})
+    out, err = capsys.readouterr()
+    expected = u'custom: 100%|██████████| 98/98 [00:00<00:00, 8799.49it/s]'
+    actual = err.strip().split('\r')[-1]
+    assert actual[:30] == expected[:30]
 
 def test_incomplete_defined_analysis(u):
     with pytest.raises(NotImplementedError):