pixelflow 0.5.0__tar.gz → 0.7.0__tar.gz

{pixelflow-0.5.0 → pixelflow-0.7.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 datamarkin
+Copyright (c) 2025 Emrah NAZIF
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{pixelflow-0.5.0 → pixelflow-0.7.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: pixelflow
-Version: 0.5.0
+Version: 0.7.0
 Summary: Computer vision processing library for visualizing and analyzing detection results from ML models
-Author-email: Emrah Nazif <emrah@datamarkin.com>, Datamarkin <support@datamarkin.com>
+Author-email: Emrah Nazif <emrah@datamarkin.com>
 License: MIT
-Project-URL: Homepage, https://github.com/datamarkin/pixelflow
-Project-URL: Repository, https://github.com/datamarkin/pixelflow
-Project-URL: Issues, https://github.com/datamarkin/pixelflow/issues
-Project-URL: Documentation, https://pixelflow.datamarkin.com
+Project-URL: Homepage, https://github.com/emrahnazif/pixelflow
+Project-URL: Repository, https://github.com/emrahnazif/pixelflow
+Project-URL: Issues, https://github.com/emrahnazif/pixelflow/issues
+Project-URL: Documentation, https://emrah.fr/pixelflow/
 Keywords: computer-vision,visualization,annotation,post-processing,tracking,opencv,yolo,detectron2,mayaku,ml-results
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -15,14 +15,13 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Scientific/Engineering :: Image Recognition
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: shapely>=2.0.0
@@ -39,8 +38,8 @@ Dynamic: license-file
 # PixelFlow
 
 [![PyPI version](https://badge.fury.io/py/pixelflow.svg)](https://badge.fury.io/py/pixelflow)
-[![CI](https://github.com/datamarkin/pixelflow/actions/workflows/ci.yml/badge.svg)](https://github.com/datamarkin/pixelflow/actions/workflows/ci.yml)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/emrahnazif/pixelflow/actions/workflows/ci.yml/badge.svg)](https://github.com/emrahnazif/pixelflow/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **The computer vision library that gets out of your way.**
@@ -132,6 +131,17 @@ detections = pf.from_easyocr(reader.readtext("sign.jpg"))
 detections = pf.from_arrays(boxes, scores, class_ids, labels=model.class_names)
 ```
 
+Segmentation models answer with raster masks. One call turns them into polygons,
+whichever model they came from:
+
+```python
+detections = pf.from_arrays(boxes, scores, masks=masks)   # boolean (N, H, W)
+detections.masks_to_segments()                            # fills det.segments
+detections.masks_to_segments(keep_masks=False)            # ...and drops the rasters
+
+polygon = pf.mask_to_polygon(mask)                        # or one mask at a time
+```
+
 ### Classifications - When the Model Only Names
 
 A classifier localises nothing, so its result carries no geometry at all:
@@ -146,7 +156,7 @@ result = pf.from_ultralytics_classification(model.predict("dog.jpg"))
 
 result.top1.class_name              # 'golden retriever'
 result.top_k(5)                     # -> Classifications, best first
-result.to_json()
+result.to_json()                    # pf.Classifications.from_json() reads it back
 
 # Plain scores - CLIP zero-shot, a vendored ResNet, anything with a score vector
 prompts = ["a photo of a cat", "a photo of a dog"]
@@ -435,6 +445,10 @@ df = pd.DataFrame(data)
 
 # With metrics
 report = detections.to_json_with_metrics()
+
+# And back - masks decoded, keypoints rebuilt, every field restored
+detections = pf.Detections.from_json(json_str)
+detections = pf.Detections.from_dict(data)
 ```
 
 ## Supported Frameworks
@@ -457,7 +471,7 @@ report = detections.to_json_with_metrics()
 
 ## Documentation
 
-Full documentation available at [https://datamarkin.com/docs/pixelflow/](https://datamarkin.com/docs/pixelflow/)
+Full documentation available at [https://emrah.fr/pixelflow/](https://emrah.fr/pixelflow/)
 
 ## Contributing
 
@@ -469,4 +483,4 @@ MIT License - see LICENSE file for details.
 
 ---
 
-Built with love by [Datamarkin](https://datamarkin.com)
+Built with love by [Emrah Nazif](https://emrah.fr)

{pixelflow-0.5.0 → pixelflow-0.7.0}/README.md

@@ -1,8 +1,8 @@
 # PixelFlow
 
 [![PyPI version](https://badge.fury.io/py/pixelflow.svg)](https://badge.fury.io/py/pixelflow)
-[![CI](https://github.com/datamarkin/pixelflow/actions/workflows/ci.yml/badge.svg)](https://github.com/datamarkin/pixelflow/actions/workflows/ci.yml)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/emrahnazif/pixelflow/actions/workflows/ci.yml/badge.svg)](https://github.com/emrahnazif/pixelflow/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **The computer vision library that gets out of your way.**
@@ -94,6 +94,17 @@ detections = pf.from_easyocr(reader.readtext("sign.jpg"))
 detections = pf.from_arrays(boxes, scores, class_ids, labels=model.class_names)
 ```
 
+Segmentation models answer with raster masks. One call turns them into polygons,
+whichever model they came from:
+
+```python
+detections = pf.from_arrays(boxes, scores, masks=masks)   # boolean (N, H, W)
+detections.masks_to_segments()                            # fills det.segments
+detections.masks_to_segments(keep_masks=False)            # ...and drops the rasters
+
+polygon = pf.mask_to_polygon(mask)                        # or one mask at a time
+```
+
 ### Classifications - When the Model Only Names
 
 A classifier localises nothing, so its result carries no geometry at all:
@@ -108,7 +119,7 @@ result = pf.from_ultralytics_classification(model.predict("dog.jpg"))
 
 result.top1.class_name              # 'golden retriever'
 result.top_k(5)                     # -> Classifications, best first
-result.to_json()
+result.to_json()                    # pf.Classifications.from_json() reads it back
 
 # Plain scores - CLIP zero-shot, a vendored ResNet, anything with a score vector
 prompts = ["a photo of a cat", "a photo of a dog"]
@@ -397,6 +408,10 @@ df = pd.DataFrame(data)
 
 # With metrics
 report = detections.to_json_with_metrics()
+
+# And back - masks decoded, keypoints rebuilt, every field restored
+detections = pf.Detections.from_json(json_str)
+detections = pf.Detections.from_dict(data)
 ```
 
 ## Supported Frameworks
@@ -419,7 +434,7 @@ report = detections.to_json_with_metrics()
 
 ## Documentation
 
-Full documentation available at [https://datamarkin.com/docs/pixelflow/](https://datamarkin.com/docs/pixelflow/)
+Full documentation available at [https://emrah.fr/pixelflow/](https://emrah.fr/pixelflow/)
 
 ## Contributing
 
@@ -431,4 +446,4 @@ MIT License - see LICENSE file for details.
 
 ---
 
-Built with love by [Datamarkin](https://datamarkin.com)
+Built with love by [Emrah Nazif](https://emrah.fr)

{pixelflow-0.5.0 → pixelflow-0.7.0}/pixelflow/__init__.py

@@ -1,5 +1,5 @@
-__version__ = "0.5.0"
-__author__ = "Datamarkin"
+__version__ = "0.7.0"
+__author__ = "Emrah NAZIF"
 
 # Import core modules
 from . import media
@@ -29,6 +29,7 @@ from .media import (
     read_image, read_video, encode_image, display_video, display_image, save_image,
     close_display, to_pil, from_pil,
 )
+from .masks import mask_to_polygon
 from .zones import Zones
 from .crossings import Crossings
 from .slicer import SlicedInference, auto_slice_size
@@ -95,6 +96,9 @@ __all__ = [
     "to_pil",
     "from_pil",
 
+    # Mask geometry
+    "mask_to_polygon",
+
     # Spatial analysis
     "zones",
     "Zones",

{pixelflow-0.5.0 → pixelflow-0.7.0}/pixelflow/classifications/classifications.py

@@ -11,6 +11,7 @@ localisation that never happened.
 import copy as copy_module
 import json
 
+from pixelflow.serialization import constructor_fields, own
 from pixelflow.validators import round_to_decimal
 from typing import Any, Dict, Iterator, List, Optional, Union
 
@@ -94,6 +95,10 @@ class Classification:
             >>> import pixelflow as pf
             >>> pf.Classification(207, "golden retriever", 0.94).to_dict()
             {'class_id': 207, 'class_name': 'golden retriever', 'confidence': 0.94, 'metadata': None}
+
+        Notes:
+            - `metadata` is the classification's own dictionary, not a copy. Treat
+              the result as read-only, or rebuild with `from_dict()`, which copies it
         """
         return {
             "class_id": self.class_id,
@@ -102,6 +107,29 @@ class Classification:
             "metadata": self.metadata,
         }
 
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Classification":
+        """
+        Rebuild a Classification from the dictionary `to_dict()` produces.
+
+        Args:
+            data (Dict[str, Any]): A classification dictionary. Unknown keys are
+                ignored and missing keys take the constructor's defaults, so
+                dictionaries written by other pixelflow versions still read.
+
+        Returns:
+            Classification: A new classification with its own metadata.
+
+        Example:
+            >>> import pixelflow as pf
+            >>> row = pf.Classification(class_id=207, class_name="golden retriever", confidence=0.94)
+            >>> pf.Classification.from_dict(row.to_dict()).to_dict() == row.to_dict()
+            True
+            >>> pf.Classification.from_dict({"class_name": "cat"}).confidence is None
+            True
+        """
+        return cls(**own(constructor_fields(cls, data)))
+
     def __repr__(self) -> str:
         return (f"Classification(class_id={self.class_id!r}, "
                 f"class_name={self.class_name!r}, confidence={self.confidence!r})")
@@ -310,5 +338,53 @@ class Classifications:
         """
         return json.dumps(self.to_dict(), indent=4)
 
+    @classmethod
+    def from_dict(cls, items: List[Dict[str, Any]]) -> "Classifications":
+        """
+        Rebuild a Classifications collection from the list `to_dict()` produces.
+
+        Args:
+            items (List[Dict[str, Any]]): Classification dictionaries, each read
+                with `Classification.from_dict`.
+
+        Returns:
+            Classifications: A new collection holding the rows in the order given.
+
+        Example:
+            >>> import pixelflow as pf
+            >>> result = pf.from_scores([0.1, 0.9], labels=["cat", "dog"])
+            >>> restored = pf.Classifications.from_dict(result.to_dict())
+            >>> restored.top1.class_name
+            'dog'
+
+        Notes:
+            - `to_dict()` writes the rows only. The collection's own `inference_id`
+              and `metadata` are not part of it, so they come back as None; set
+              them on the result if you stored them yourself.
+        """
+        return cls([Classification.from_dict(item) for item in items])
+
+    @classmethod
+    def from_json(cls, text: Union[str, bytes]) -> "Classifications":
+        """
+        Rebuild a Classifications collection from the JSON string `to_json()` produces.
+
+        Args:
+            text (Union[str, bytes]): JSON array of classification dictionaries.
+
+        Returns:
+            Classifications: A new collection holding the rows in the order given.
+
+        Raises:
+            json.JSONDecodeError: If `text` is not valid JSON.
+
+        Example:
+            >>> import pixelflow as pf
+            >>> result = pf.from_scores([0.1, 0.9], labels=["cat", "dog"])
+            >>> pf.Classifications.from_json(result.to_json()).top1.class_name
+            'dog'
+        """
+        return cls.from_dict(json.loads(text))
+
     def __repr__(self) -> str:
         return f"Classifications({len(self.classifications)} rows)"