Glymur 0.13.3__py3-none-any.whl → 0.13.5__py3-none-any.whl

{Glymur-0.13.3.dist-info → Glymur-0.13.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Glymur
-Version: 0.13.3
+Version: 0.13.5
 Home-page: https://github.com/quintusdias/glymur
 Author: 'John Evans'
 Author-email: "John Evans" <jevans667cc@proton.me>

{Glymur-0.13.3.dist-info → Glymur-0.13.5.dist-info}/RECORD

@@ -1,15 +1,15 @@
 glymur/__init__.py,sha256=k14IfdaYuTWXSpAIDR3LVDtXt9XKjr-ZSNXCyu8pQko,586
 glymur/_iccprofile.py,sha256=_WfQsT-BqEWQzQVTtuY7tSXqPjOtwvWGW36rKxlLv1s,4148
-glymur/codestream.py,sha256=qZbCCJGrsIy4Q9zzeITNN_bP90HtCHFOcbZdInDfAAY,60011
+glymur/codestream.py,sha256=nctHzG_bQKhln_gGAmoaxDhH3ndEbsiVVKy3dPqh4JM,62290
 glymur/command_line.py,sha256=jm-6dD2jcU_G7mJAJ0U5sanfG9kRy-j0-G3eSN_Ieek,7476
 glymur/config.py,sha256=ceGulS8TN2OYiTPtq3mAdhXrCCRlxjuLmvN_UG0009Y,4139
 glymur/core.py,sha256=IDkk8FESyukQTB10LHBZ4VQM36NwKE4CXCcuJ407Kzg,3638
-glymur/jp2box.py,sha256=-fprGcnwgm4HC9D8jxWmvsMZbDdum6C1Zc4cCJWNIZM,112390
-glymur/jp2k.py,sha256=QS1bIi013b0AWRPvc90kwdVXMwblbJXU8MvP9zigy3g,54455
-glymur/jp2kr.py,sha256=hUxFRXaJI9qmnZ7wNPr_4N-c-JEP7YiM_ea4FpmWD_w,32358
+glymur/jp2box.py,sha256=qh1xUGKoGgVrUHq48yRcJAk7miJ__Udua8QHPTxpfQY,112434
+glymur/jp2k.py,sha256=PYrjzhNPsmG2H_tyRUlIheQ-Gx7sXzH7igNAWdVyMXA,53489
+glymur/jp2kr.py,sha256=Qf7ZsSoMkPDvOb0SCP60MARH4ZmkukFiS8oP4T1iYK8,32991
 glymur/options.py,sha256=Y777g4wpxPqRAF8s963goeAIogfLqIe_Dyd9f77MfmU,4428
 glymur/tiff.py,sha256=2uoKfyoyPQWAsdPWB0IxW_npqpP4O10qVADQZf10jXs,41115
-glymur/version.py,sha256=dGkLU9MNyK0Ikb9XIC4M4aoDNPJQDZ0zq1OTF7zgtiU,981
+glymur/version.py,sha256=Vi8F-2IJL1ETkBrqwEl0xkfDD4yMzTwL08eNmQeLwyI,981
 glymur/data/__init__.py,sha256=n2KZrHV15it7Wu4YCaBLXui1ZleQ30dnZ92dyP6q05k,955
 glymur/data/goodstuff.j2k,sha256=xKQG68KMu33gYjRUDTQvam1Cue2tdio85rNp5J-rYZE,115220
 glymur/data/heliov.jpx,sha256=KXnYdBZgl25jcGLu-m-QfhuP9pqUXV0Hp9HHEdJqr34,1399071
@@ -17,9 +17,9 @@ glymur/data/nemo.jp2,sha256=yJ1NkTEwU0B_gBtAiA1c5hxtGYSJtJgq6cHC2IHpj70,1132373
 glymur/lib/__init__.py,sha256=JnM9oPfcZhBDLKo7_yLS-lIRQ1wXb1N9hKKQ-G7vYVk,127
 glymur/lib/openjp2.py,sha256=VHCy_TnBSDqQ8YlIQHkyFqUXOQ2E5C3jxJoziG73s0I,45052
 glymur/lib/tiff.py,sha256=2o29IzYTsprVR_C6VDNHOzqk_U7aUdCoLQ2fjiyyoaI,50777
-Glymur-0.13.3.dist-info/LICENSE.txt,sha256=G9pvBgkJdPTtZqQmoRyIgAydtic1ZwWtOWBea9VMW7I,1077
-Glymur-0.13.3.dist-info/METADATA,sha256=dCBeH__9F8mkVEsr9w8_5KpWn92be25pGQY7IAlqGy0,1020
-Glymur-0.13.3.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
-Glymur-0.13.3.dist-info/entry_points.txt,sha256=inzxpDbDDfIxtdXpCncAHdAdwJfjtXt3xKvIOsuZsG8,93
-Glymur-0.13.3.dist-info/top_level.txt,sha256=D0SvtBUoPxOs40OTRW3l-kjGFHM6VrXS8yZPK5Fx2wY,7
-Glymur-0.13.3.dist-info/RECORD,,
+Glymur-0.13.5.dist-info/LICENSE.txt,sha256=G9pvBgkJdPTtZqQmoRyIgAydtic1ZwWtOWBea9VMW7I,1077
+Glymur-0.13.5.dist-info/METADATA,sha256=0fKfzYxRaif1ffjxR_sMXbvThtXWtF3q0IcHDUzbBSc,1020
+Glymur-0.13.5.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
+Glymur-0.13.5.dist-info/entry_points.txt,sha256=inzxpDbDDfIxtdXpCncAHdAdwJfjtXt3xKvIOsuZsG8,93
+Glymur-0.13.5.dist-info/top_level.txt,sha256=D0SvtBUoPxOs40OTRW3l-kjGFHM6VrXS8yZPK5Fx2wY,7
+Glymur-0.13.5.dist-info/RECORD,,

{Glymur-0.13.3.dist-info → Glymur-0.13.5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.1.1)
+Generator: setuptools (71.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

glymur/codestream.py

@@ -189,7 +189,7 @@ class Codestream(object):
             0xff3f: self._parse_reserved_marker,
 
             # 0xff4f:  SOC (already encountered by the time we get here)
-            0xff50: self._parse_reserved_segment,
+            0xff50: self._parse_cap_segment,
             0xff51: self._parse_siz_segment,
             0xff52: self._parse_cod_segment,
             0xff53: self._parse_coc_segment,
@@ -713,6 +713,37 @@ class Codestream(object):
 
         return RGNsegment(crgn, srgn, sprgn, length, offset)
 
+    @classmethod
+    def _parse_cap_segment(cls, fptr):
+        """Parse the SIZ segment.
+
+        Parameters
+        ----------
+        fptr : file
+            Open file object.
+
+        Returns
+        -------
+        SIZSegment
+            The current SIZ segment.
+        """
+        offset = fptr.tell() - 2
+
+        read_buffer = fptr.read(2)
+        length, = struct.unpack('>H', read_buffer)
+        read_buffer = fptr.read(length - 2)
+
+        pcap, = struct.unpack('>I', read_buffer[:4])
+
+        n = (length - 6) // 2
+        ccap = struct.unpack('>' + 'H' * n, read_buffer[4:])
+
+        segment = CAPsegment(
+            pcap=pcap, ccap=ccap, length=length, offset=offset,
+        )
+
+        return segment
+
     @classmethod
     def _parse_siz_segment(cls, fptr):
         """Parse the SIZ segment.
@@ -736,7 +767,9 @@ class Codestream(object):
         data = struct.unpack_from('>HIIIIIIIIH', read_buffer)
 
         rsiz = data[0]
-        if rsiz not in _KNOWN_PROFILES:
+
+        # Bit 14 (16384) signifies HTJ2K (JPH)
+        if rsiz not in _KNOWN_PROFILES and not np.bitwise_and(rsiz, 16384):
             msg = f"Invalid profile: (Rsiz={rsiz})."
             warnings.warn(msg, UserWarning)
 
@@ -932,6 +965,49 @@ class Segment(object):
         return msg
 
 
+class CAPsegment(Segment):
+    """CAP (Extended Capabilities) segment information.
+
+    Attributes
+    ----------
+    marker_id : str
+        Identifier for the segment.
+    offset : int
+        Offset of marker segment in bytes from beginning of file.
+    length : int
+        Length of marker segment in bytes.  This number does not include the
+        two bytes constituting the marker.
+    pcap : 32-bit unsigned int
+        bitmask where the kth 1 represents use of capabilities in Part k of
+        ISO/IEC 15444-k.
+    ccap : 16-bit unsigned int
+        The precise meaning depends on the related parts of ISO/IEC 15444-k.
+    """
+    def __init__(self, pcap, ccap, length, offset):
+        super().__init__(marker_id='CAP')
+        self.pcap = pcap
+        self.ccap = ccap
+        self.length = length
+        self.offset = offset
+
+    def __str__(self):
+        msg = Segment.__str__(self)
+
+        msg += '\n'
+
+        # have to cast to uint64 because, you know, stupid windows
+        parts = [
+            k for k in range(32)
+            if np.bitwise_and(np.uint64(self.pcap), np.uint64(1 << (32 - k)))
+        ]
+
+        for b in parts:
+            msg += f'    Pcap:  Part {b} (ISO/IEC 15444-{b})\n'
+        msg += f'    Ccap:  {self.ccap}'
+
+        return msg
+
+
 class COCsegment(Segment):
     """COC (Coding style Component) segment information.
 
@@ -1666,7 +1742,12 @@ class SIZsegment(Segment):
         try:
             profile = _CAPABILITIES_DISPLAY[self.rsiz]
         except KeyError:
-            profile = f'{self.rsiz} (invalid)'
+            if np.bitwise_and(self.rsiz, 16384):
+                # HTJ2K profile that is uninterpreted
+                profile = f'{self.rsiz}'
+            else:
+                # profile unknown
+                profile = f'{self.rsiz} (invalid)'
         msg = msg.format(
             profile=profile,
             height=self.ysiz, width=self.xsiz,

glymur/jp2box.py

@@ -1259,7 +1259,7 @@ class FileTypeBox(Jp2kBox):
     """
     box_id = 'ftyp'
     longname = 'File Type'
-    _valid_cls = ['jp2 ', 'jpx ', 'jpxb']
+    _valid_cls = ['jp2 ', 'jph ', 'jpx ', 'jpxb']
 
     def __init__(
         self, brand='jp2 ', minor_version=0, compatibility_list=None,
@@ -1304,16 +1304,19 @@ class FileTypeBox(Jp2kBox):
         return text
 
     def _validate(self, writing=False):
-        """Validate the box before writing to file."""
-        if self.brand not in ['jp2 ', 'jpx ']:
+        """
+        Validate the box before writing to file.
+        """
+        if self.brand not in ['jp2 ', 'jpx ', 'jph ']:
             msg = (
                 f"The file type brand was '{self.brand}'.  "
-                f"It should be either 'jp2 ' or 'jpx '."
+                f"It should be either 'jp2 ', 'jpx ', or 'jph '."
             )
             if writing:
                 raise InvalidJp2kError(msg)
             else:
                 warnings.warn(msg, UserWarning)
+
         for item in self.compatibility_list:
             if item not in self._valid_cls:
                 msg = (

glymur/jp2k.py

@@ -34,13 +34,12 @@ from .lib import openjp2 as opj2
 
 
 class Jp2k(Jp2kr):
-    """Write JPEG 2000 files.
+    """Write JPEG 2000 files (and optionally read them as well).
 
     Parameters
     ----------
     filename : str or path
-        The path to JPEG 2000 file.  If you are only reading JPEG 2000 files,
-        this is the only argument you need to supply.
+        The path to JPEG 2000 file.
     data : np.ndarray, optional
         Image data to be written to file.
     shape : Tuple[int, int, ...], optional
@@ -105,35 +104,6 @@ class Jp2k(Jp2kr):
     verbose : bool, optional
         Print informational messages produced by the OpenJPEG library.
 
-    Examples
-    --------
-    >>> jfile = glymur.data.nemo()
-    >>> jp2 = glymur.Jp2k(jfile)
-    >>> jp2.shape
-    (1456, 2592, 3)
-    >>> image = jp2[:]
-    >>> image.shape
-    (1456, 2592, 3)
-
-    Read a lower resolution thumbnail.
-
-    >>> thumbnail = jp2[::2, ::2]
-    >>> thumbnail.shape
-    (728, 1296, 3)
-
-    Make use of OpenJPEG's thread support
-
-    >>> import time
-    >>> if glymur.version.openjpeg_version >= '2.2.0':
-    ...     jp2file = glymur.data.nemo()
-    ...     jp2 = glymur.Jp2k(jp2file)
-    ...     t0 = time.time(); data = jp2[:]; t1 = time.time()
-    ...     t1 - t0 #doctest: +SKIP
-    0.9024193286895752
-    ...     glymur.set_options('lib.num_threads', 4)
-    ...     t0 = time.time(); data = jp2[:]; t1 = time.time()
-    ...     t1 - t0 #doctest: +SKIP
-    0.4060473537445068
     """
 
     def __init__(
@@ -206,13 +176,13 @@ class Jp2k(Jp2kr):
             # Must be determined when writing.
             self._shape = None
 
-        # If there already was a shape attribute, then don't mess with it,
-        # it was set by the reader superclass.
-
-        if self.filename[-4:].endswith(('.jp2', '.JP2', '.jpx', 'JPX')):
-            self._codec_format = opj2.CODEC_JP2
-        else:
-            self._codec_format = opj2.CODEC_J2K
+        if not hasattr(self, '_codec_format'):
+            # Only set codec format if the superclass has not done so, i.e.
+            # we are writing instead of reading.
+            if self.filename[-4:].endswith(('.jp2', '.JP2', '.jpx', 'JPX')):
+                self._codec_format = opj2.CODEC_JP2
+            else:
+                self._codec_format = opj2.CODEC_J2K
 
         self._validate_kwargs()
 
@@ -800,12 +770,6 @@ class Jp2k(Jp2kr):
         -------
         Jp2k
             Newly wrapped Jp2k object.
-
-        Examples
-        --------
-        >>> jfile = glymur.data.goodstuff()
-        >>> j2k = glymur.Jp2k(jfile)
-        >>> jp2 = j2k.wrap('jp2_from_j2k.jp2')
         """
         if boxes is None:
             boxes = self._get_default_jp2_boxes()

glymur/jp2kr.py

@@ -55,6 +55,19 @@ class Jp2kr(Jp2kBox):
     >>> thumbnail = jp2[::2, ::2]
     >>> thumbnail.shape
     (728, 1296, 3)
+
+    Make use of OpenJPEG's thread support
+
+    >>> import time
+    >>> jp2file = glymur.data.nemo()
+    >>> jp2 = glymur.Jp2k(jp2file)
+    >>> t0 = time.time(); data = jp2[:]; t1 = time.time()
+    >>> t1 - t0 #doctest: +SKIP
+    0.9024193286895752
+    >>> glymur.set_option('lib.num_threads', 4)
+    >>> t0 = time.time(); data = jp2[:]; t1 = time.time()
+    >>> t1 - t0 #doctest: +SKIP
+    0.4060473537445068
     """
 
     def __init__(
@@ -233,7 +246,7 @@ class Jp2kr(Jp2kBox):
 
     @property
     def codestream(self):
-        """Metadata for JP2 or J2K codestream (header only)."""
+        """Metadata for JP2 or J2K codestream header."""
         if self._codestream is None:
             self._codestream = self.get_codestream(header_only=True)
         return self._codestream
@@ -523,6 +536,9 @@ class Jp2kr(Jp2kBox):
     def read(self, **kwargs):
         """Read a JPEG 2000 image.
 
+        .. deprecated:: 0.13.5
+           Use numpy-style slicing instead.
+
         Returns
         -------
         img_array : ndarray
@@ -724,7 +740,7 @@ class Jp2kr(Jp2kBox):
                    verbose=False, ignore_pclr_cmap_cdef=False):
         """Read a JPEG 2000 image.
 
-        The only time you should use this method is when the image has
+        The only time you should ever use this method is when the image has
         different subsampling factors across components.  Otherwise you should
         use the read method.
 
@@ -870,6 +886,10 @@ class Jp2kr(Jp2kBox):
     def get_codestream(self, header_only=True):
         """Retrieve codestream.
 
+	    This differs from the codestream property in that segment
+    	metadata that lies past the end of the codestream header
+    	can be retrieved.
+
         Parameters
         ----------
         header_only : bool, optional

glymur/version.py

@@ -20,7 +20,7 @@ from .lib import tiff
 
 # Do not change the format of this next line!  Doing so risks breaking
 # setup.py
-version = "0.13.3"
+version = "0.13.5"
 
 version_tuple = parse(version).release