digitalsreeni-image-annotator 0.1.3__tar.gz

digitalsreeni-image-annotator-0.1.3/LICENSE

@@ -0,0 +1,41 @@
+MIT License
+
+Copyright (c) 2024 Dr. Sreenivas Bhattiprolu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+CITATION REQUEST:
+
+If you use this software in your research, please cite it as follows:
+
+Bhattiprolu, S. (2024). Image Annotator [Computer software]. 
+https://github.com/bnsreenu/digitalsreeni-image-annotator
+
+BibTeX:
+@software{image_annotator,
+  author = {Bhattiprolu, Sreenivas},
+  title = {Image Annotator},
+  year = {2024},
+  url = {https://github.com/bnsreenu/digitalsreeni-image-annotator}
+}
+
+While not required by the license, citation is appreciated and helps support the 
+continued development and maintenance of this software.

digitalsreeni-image-annotator-0.1.3/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.1
+Name: digitalsreeni-image-annotator
+Version: 0.1.3
+Summary: A tool for annotating images with polygons and rectangles
+Home-page: https://github.com/bnsreenu/digitalsreeni-image-annotator
+Author: Dr. Sreenivas Bhattiprolu
+Author-email: digitalsreeni@gmail.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.9
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt5>=5.15.7
+
+# DigitalSreeni Image Annotator
+
+![Python Version](https://img.shields.io/badge/python-3.9%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![PyPI version](https://badge.fury.io/py/digitalsreeni-image-annotator.svg)
+
+A powerful and user-friendly tool for annotating images with polygons and rectangles, built with PyQt5.
+
+@DigitalSreeni
+Dr. Sreenivas Bhattiprolu
+
+## Features
+
+- Load and annotate images with polygons and rectangles
+- Save annotations in COCO-compatible JSON format
+- Edit existing annotations
+- Zoom and pan functionality for detailed annotations
+- Support for multiple classes with customizable colors
+- Import and export annotations
+- User-friendly interface with intuitive controls
+
+## Installation
+
+You can install the DigitalSreeni Image Annotator directly from PyPI:
+
+```bash
+pip install digitalsreeni-image-annotator
+```
+
+## Usage
+
+1. Run the DigitalSreeni Image Annotator application:
+   ```bash
+   digitalsreeni-image-annotator
+   ```
+   or
+   ```bash
+   python -m digitalsreeni_image_annotator.main
+   ```
+
+2. Using the application:
+   - Click "Open New Image Set" to load a new set of images from your computer.
+   - Use "Add More Images" to append images to the current set.
+   - Add classes using the "Add Class" button.
+   - Select a class and use the Polygon or Rectangle tool to create annotations.
+   - Edit existing annotations by double-clicking on them.
+   - Save your annotations using the "Save Annotations" button.
+   - Use "Import Saved Annotations" to load previously created annotations.
+   - Access the help documentation by clicking the "Help" button.
+
+3. Keyboard shortcuts:
+   - Use the mouse wheel or trackpad to zoom in/out
+   - Hold Ctrl and drag to pan the image
+   - Press 'Esc' to cancel the current annotation
+   - Press 'Enter' to finish the current polygon annotation
+
+## Development
+
+For development purposes, you can clone the repository and install it in editable mode:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/bnsreenu/digitalsreeni-image-annotator.git
+   cd digitalsreeni-image-annotator
+   ```
+
+2. Create a virtual environment (optional but recommended):
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
+   ```
+
+3. Install the package and its dependencies in editable mode:
+   ```bash
+   pip install -e .
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Thanks to all contributors who have helped shape this project
+- Inspired by the need for efficient image annotation in computer vision tasks
+
+## Contact
+
+Dr. Sreenivas Bhattiprolu - [@DigitalSreeni](https://twitter.com/DigitalSreeni)
+
+Project Link: [https://github.com/bnsreenu/digitalsreeni-image-annotator](https://github.com/bnsreenu/digitalsreeni-image-annotator)
+
+## Citing
+
+If you use this software in your research, please cite it as follows:
+
+Bhattiprolu, S. (2024). DigitalSreeni Image Annotator [Computer software]. 
+https://github.com/bnsreenu/digitalsreeni-image-annotator
+
+```bibtex
+@software{digitalsreeni_image_annotator,
+  author = {Bhattiprolu, Sreenivas},
+  title = {DigitalSreeni Image Annotator},
+  year = {2024},
+  url = {https://github.com/bnsreenu/digitalsreeni-image-annotator}
+}
+```

digitalsreeni-image-annotator-0.1.3/README.md

@@ -0,0 +1,117 @@
+# DigitalSreeni Image Annotator
+
+![Python Version](https://img.shields.io/badge/python-3.9%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![PyPI version](https://badge.fury.io/py/digitalsreeni-image-annotator.svg)
+
+A powerful and user-friendly tool for annotating images with polygons and rectangles, built with PyQt5.
+
+@DigitalSreeni
+Dr. Sreenivas Bhattiprolu
+
+## Features
+
+- Load and annotate images with polygons and rectangles
+- Save annotations in COCO-compatible JSON format
+- Edit existing annotations
+- Zoom and pan functionality for detailed annotations
+- Support for multiple classes with customizable colors
+- Import and export annotations
+- User-friendly interface with intuitive controls
+
+## Installation
+
+You can install the DigitalSreeni Image Annotator directly from PyPI:
+
+```bash
+pip install digitalsreeni-image-annotator
+```
+
+## Usage
+
+1. Run the DigitalSreeni Image Annotator application:
+   ```bash
+   digitalsreeni-image-annotator
+   ```
+   or
+   ```bash
+   python -m digitalsreeni_image_annotator.main
+   ```
+
+2. Using the application:
+   - Click "Open New Image Set" to load a new set of images from your computer.
+   - Use "Add More Images" to append images to the current set.
+   - Add classes using the "Add Class" button.
+   - Select a class and use the Polygon or Rectangle tool to create annotations.
+   - Edit existing annotations by double-clicking on them.
+   - Save your annotations using the "Save Annotations" button.
+   - Use "Import Saved Annotations" to load previously created annotations.
+   - Access the help documentation by clicking the "Help" button.
+
+3. Keyboard shortcuts:
+   - Use the mouse wheel or trackpad to zoom in/out
+   - Hold Ctrl and drag to pan the image
+   - Press 'Esc' to cancel the current annotation
+   - Press 'Enter' to finish the current polygon annotation
+
+## Development
+
+For development purposes, you can clone the repository and install it in editable mode:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/bnsreenu/digitalsreeni-image-annotator.git
+   cd digitalsreeni-image-annotator
+   ```
+
+2. Create a virtual environment (optional but recommended):
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
+   ```
+
+3. Install the package and its dependencies in editable mode:
+   ```bash
+   pip install -e .
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Thanks to all contributors who have helped shape this project
+- Inspired by the need for efficient image annotation in computer vision tasks
+
+## Contact
+
+Dr. Sreenivas Bhattiprolu - [@DigitalSreeni](https://twitter.com/DigitalSreeni)
+
+Project Link: [https://github.com/bnsreenu/digitalsreeni-image-annotator](https://github.com/bnsreenu/digitalsreeni-image-annotator)
+
+## Citing
+
+If you use this software in your research, please cite it as follows:
+
+Bhattiprolu, S. (2024). DigitalSreeni Image Annotator [Computer software]. 
+https://github.com/bnsreenu/digitalsreeni-image-annotator
+
+```bibtex
+@software{digitalsreeni_image_annotator,
+  author = {Bhattiprolu, Sreenivas},
+  title = {DigitalSreeni Image Annotator},
+  year = {2024},
+  url = {https://github.com/bnsreenu/digitalsreeni-image-annotator}
+}
+```

digitalsreeni-image-annotator-0.1.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

digitalsreeni-image-annotator-0.1.3/setup.py

@@ -0,0 +1,40 @@
+"""
+Setup file for the DigitalSreeni Image Annotator package.
+
+@DigitalSreeni
+Dr. Sreenivas Bhattiprolu
+"""
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="digitalsreeni-image-annotator",
+    version="0.1.3",  # version number
+    author="Dr. Sreenivas Bhattiprolu",
+    author_email="digitalsreeni@gmail.com",
+    description="A tool for annotating images with polygons and rectangles",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/bnsreenu/digitalsreeni-image-annotator",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Science/Research",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3.9",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "PyQt5>=5.15.7",
+    ],
+    entry_points={
+        "console_scripts": [
+            "digitalsreeni-image-annotator=digitalsreeni_image_annotator.main:main",
+        ],
+    },
+)

digitalsreeni-image-annotator-0.1.3/src/digitalsreeni_image_annotator/__init__.py

@@ -0,0 +1,21 @@
+"""
+Image Annotator
+===============
+
+A tool for annotating images with polygons and rectangles.
+
+This package provides a GUI application for image annotation,
+supporting polygon and rectangle annotations in a COCO-compatible format.
+
+@DigitalSreeni
+Dr. Sreenivas Bhattiprolu
+"""
+
+__version__ = "0.1.0"
+__author__ = "Dr. Sreenivas Bhattiprolu"
+
+from .annotator_window import ImageAnnotator
+from .image_label import ImageLabel
+from .utils import calculate_area, calculate_bbox
+
+__all__ = ['ImageAnnotator', 'ImageLabel', 'calculate_area', 'calculate_bbox']