Source code for numcodecs.lzma
_lzma = None
try:
import lzma as _lzma
except ImportError: # pragma: no cover
try:
from backports import lzma as _lzma
except ImportError:
pass
if _lzma:
from .abc import Codec
from .compat import ndarray_copy, ensure_contiguous_ndarray
# noinspection PyShadowingBuiltins
[docs]
class LZMA(Codec):
"""Codec providing compression using lzma via the Python standard
library.
Parameters
----------
format : integer, optional
One of the lzma format codes, e.g., ``lzma.FORMAT_XZ``.
check : integer, optional
One of the lzma check codes, e.g., ``lzma.CHECK_NONE``.
preset : integer, optional
An integer between 0 and 9 inclusive, specifying the compression
level.
filters : list, optional
A list of dictionaries specifying compression filters. If
filters are provided, 'preset' must be None.
"""
codec_id = 'lzma'
def __init__(self, format=1, check=-1, preset=None, filters=None):
self.format = format
self.check = check
self.preset = preset
self.filters = filters
[docs]
def encode(self, buf):
# normalise inputs
buf = ensure_contiguous_ndarray(buf)
# do compression
return _lzma.compress(
buf,
format=self.format,
check=self.check,
preset=self.preset,
filters=self.filters,
)
[docs]
def decode(self, buf, out=None):
# normalise inputs
buf = ensure_contiguous_ndarray(buf)
if out is not None:
out = ensure_contiguous_ndarray(out)
# do decompression
dec = _lzma.decompress(buf, format=self.format, filters=self.filters)
# handle destination
return ndarray_copy(dec, out)
def __repr__(self):
r = '%s(format=%r, check=%r, preset=%r, filters=%r)' % (
type(self).__name__,
self.format,
self.check,
self.preset,
self.filters,
)
return r