Joblib is a set of tools to provide lightweight pipelining in Python. In particular, joblib offers:
transparent disk-caching of the output values and lazy re-evaluation (memoize pattern)
easy simple parallel computing
logging and tracing of the execution
Joblib is optimized to be fast and robust in particular on large data and has specific optimizations for numpy arrays. It is BSD-licensed.
User documentation:
Download packages:
Source code:
Report issues:
Vision
The vision is to provide tools to easily achieve better performance and reproducibility when working with long running jobs.
Avoid computing twice the same thing: code is rerun over an over, for instance when prototyping computational-heavy jobs (as in scientific development), but hand-crafted solution to alleviate this issue is error-prone and often leads to unreproducible results
Persist to disk transparently: persisting in an efficient way arbitrary objects containing large data is hard. Using joblib’s caching mechanism avoids hand-written persistence and implicitly links the file on disk to the execution context of the original Python object. As a result, joblib’s persistence is good for resuming an application status or computational job, eg after a crash.
Joblib strives to address these problems while leaving your code and your flow control as unmodified as possible (no framework, no new paradigms).
Main features
Transparent and fast disk-caching of output value: a memoize or make-like functionality for Python functions that works well for arbitrary Python objects, including very large numpy arrays. Separate persistence and flow-execution logic from domain logic or algorithmic code by writing the operations as a set of steps with well-defined inputs and outputs: Python functions. Joblib can save their computation to disk and rerun it only if necessary:
>>> from joblib import Memory >>> mem = Memory(cachedir='/tmp/joblib') >>> import numpy as np >>> a = np.vander(np.arange(3)).astype(np.float) >>> square = mem.cache(np.square) >>> b = square(a) # doctest: +ELLIPSIS ________________________________________________________________________________ [Memory] Calling square... square(array([[ 0., 0., 1.], [ 1., 1., 1.], [ 4., 2., 1.]])) ___________________________________________________________square - 0...s, 0.0min >>> c = square(a) >>> # The above call did not trigger an evaluationEmbarrassingly parallel helper: to make is easy to write readable parallel code and debug it quickly:
>>> from joblib import Parallel, delayed >>> from math import sqrt >>> Parallel(n_jobs=1)(delayed(sqrt)(i**2) for i in range(10)) [0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0]
Logging/tracing: The different functionalities will progressively acquire better logging mechanism to help track what has been ran, and capture I/O easily. In addition, Joblib will provide a few I/O primitives, to easily define define logging and display streams, and provide a way of compiling a report. We want to be able to quickly inspect what has been run.
Fast compressed Persistence: a replacement for pickle to work efficiently on Python objects containing large data ( joblib.dump & joblib.load ).
4 maintainers
Release files for joblib 0.9.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| joblib-0.9.1.tar.gz | 428.6 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| joblib-0.9.1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
| joblib-0.9.1-py2.7.egg | Legacy Egg format | - | - | Details |
Total release size: 720.1 kB
Release files / joblib-0.9.1.tar.gz
| Download URL | joblib-0.9.1.tar.gz |
|---|---|
| Size | 428.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
432116024e98610b424e9d6cbb696e240bec8ed7842473493524736ff2f9e7b6
|
|
BLAKE2b-256 checksum How to use checksums |
2ca4549efb965474997dd76cbf7442672e0a5ae5c0fffdb96cbc5805b3e110c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / joblib-0.9.1-py2.py3-none-any.whl
| Download URL | joblib-0.9.1-py2.py3-none-any.whl |
|---|---|
| Size | 98.5 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
f45a6c409b6240248b73bf0d3bce3d4853a4872d6da5712c1d448de7b5ed9879
|
|
BLAKE2b-256 checksum How to use checksums |
c804efbb248e86d1da46985264e60f165eb6b77890bf27ebd80564e0774f0bbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / joblib-0.9.1-py2.7.egg
| Download URL | joblib-0.9.1-py2.7.egg |
|---|---|
| Size | 193.0 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
e52d59c49606048278623968d282281a4c9b9df69b553ebeee8cc6859aed0263
|
|
BLAKE2b-256 checksum How to use checksums |
8e39f2544aac8a5a11bcd9f8738c1ff9dbefd3ec08923317b3bb97537bddb37f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
