Python binding library for Microsoft PICT (Pairwise Independent Combinatorial Tool).
- Microsoft PICT
- Python 2.7, 3.4, 3.5 or 3.6
Wheels (binary distribution) are available for Linux. PICT shared library and command are included in wheels.
$ pip install pypict
On other platforms, you need to build from source.
PICT source tree is registered as a submodule of this repository.
python setup.py build_pict
will run make
command to build PICT shared library inside the tree.
You need to manually install the shared library and command, or set path of the tree to the appropriate environment variables (PATH
, LD_LIBRARY_PATH
, etc.)
$ git clone https://github.com/kmaehashi/pypict.git $ cd pypict $ git submodule init $ git submodule update $ python setup.py build_pict $ pip install -U . $ export PATH=${PWD}/pict:${PATH} $ export LD_LIBRARY_PATH=${PWD}/pict:${LD_LIBRARY_PATH}
There are four different APIs provided in this library.
Generally, you only need to use Tools API (pypict.tools
).
- Low-level API (
pypict.capi
) provides Python functions that map to each PICT C API function. - High-level API (
pypict.api
) wraps the low-level API to provide automatic memory management. - Tools API (
pypict.tools
) wraps the high-level API to provide convenient features. - Command API (
pypict.cmd
) is a thin wrapper forpict
command. This API uses PICT command directly instead of PICT shared library.
Here is an example usage of Tools API to generate pair-wise patterns from parameter set.
import pypict.tools
params = {
"Type": ["Single", "Span", "Stripe", "Mirror", "RAID-5"],
"Size": ["10", "100", "500", "1000", "5000", "10000", "40000"],
"Format method": ["Quick", "Slow"],
"File system": ["FAT", "FAT32", "NTFS"],
"Cluster size": ["512", "1024", "2048", "4096", "8192", "16384", "32768", "65536"],
"Compression": ["On", "Off"],
}
for case in pypict.tools.from_dict(params):
print(case)