-
-
-
-
-
-
The PyPrind (Python Progress Indicator) module provides a progress bar and a percentage indicator object that let you track the progress of a loop structure or other iterative computation.
-Typical applications include the processing of large data sets to provide an intuitive estimate
-at runtime about the progress of the computation.
-
-
-
-
The most convenient way to install PyPrind is via tools like pip or easy_install:
pip install pyprind
easy_install pyprind
PyPrind comes without any dependencies except for the optional psutil to monitor CPU and memory usages. You can install psutil via pip install pyprind or install it automatically with PyPrind:
- pip install pyprind -r requirements.txt
Alternatively, you can install PyPrind the classic way: Download the package from the Python Package Index https://pypi.python.org/pypi/PyPrind, unzip it, navigate into the unzipped directory, and use the command
- -python setup.py install
-
-
PyPrind consists of two class objects that can visualize the progress of a computation on the output screen.
-Progress bars are available via ProgBar, and percentage indicators can be used via a ProgPercent.
n = 10000000
-bar = pyprind.ProgBar(n) # 1) initialization with number of iterations
-for i in range(n):
- # do some computation
- bar.update() # 2) update the progress visualization
-Alternatively, the progress can be tracked via the equivalent generator functions prog_bar and prog_percent:
for i in pyprind.prog_bar(range(n)):
- # do something
- pass
-class ProgBar(Prog):
- """
- Initializes a progress bar object that allows visuzalization
- of an iterational computation in the standard output screen.
-
- Parameters
- ----------
- iterations : `int`
- Number of iterations for the iterative computation.
-
- track_time : `bool` (default = `True`)
- Prints elapsed time when loop has finished.
-
- width : `int` (default = 30)
- Sets the progress bar width in characters.
-
- stream : `int` (default = 2).
- Setting the output stream.
- Takes `1` for stdout, `2` for stderr, or a custom stream object
-
- title : `str` (default = `''`).
- Setting a title for the progress bar.
-
- monitor : `bool` (default = False)
- Monitors CPU and memory usage if `True` (requires `psutil` package).
-
- """
-class ProgPercent(Prog):
- """
- Initializes a progress bar object that allows visuzalization
- of an iterational computation in the standard output screen.
-
- Parameters
- ----------
- iterations : `int`
- Number of iterations for the iterative computation.
-
- track_time : `bool` (default = `True`)
- Prints elapsed time when loop has finished.
-
- stream : `int` (default = 2).
- Setting the output stream.
- Takes `1` for stdout, `2` for stderr, or a custom stream object
-
- title : `str` (default = `''`).
- Setting a title for the percentage indicator.
-
- monitor : `bool` (default = False)
- Monitors CPU and memory usage if `True` (requires `psutil` package).
-
- """
-
-
-
Examples for using the progress bar and percentage indicator objects can be found in the IPython Demo Notebook.
- - - - -
-
-
If you have any questions or comments about PyPrind, please feel free to contact me via
-eMail: se.raschka@gmail.com
-or Twitter: @rasbt
The pyprind module is available on GitHub at https://github.com/rasbt/pyprind.