shinestacker 0.3.3__tar.gz → 0.3.4__tar.gz

shinestacker-0.3.4/.flake8

@@ -0,0 +1,8 @@
+[flake8]
+exclude =
+	*/.ipynb_checkpoints/*
+	src/shinestacker/_version.py
+	.venv
+	dist/*
+max-line-length = 100
+ignore = E402, W503, W504

shinestacker-0.3.4/.github/workflows/pylint.yml

@@ -0,0 +1,28 @@
+name: Pylint Check
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  pylint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: Silleellie/pylint-github-action@v2.1
+      with:
+        lint-path: src
+        python-version: 3.9
+        requirements-path: requirements.txt
+        readme-path: README.md
+        pylintrc-path: .pylintrc
+        badge-text: PyLint
+        color-bad-score: red
+        color-ok-score: orange
+        color-good-score: yellow
+        color-perfect-score: brightgreen

shinestacker-0.3.4/.pylintrc

@@ -0,0 +1,6 @@
+[MASTER]
+ignore-patterns = 
+    _version\.py,
+ignore-paths = 
+    .*\.ipynb_checkpoints,
+    .*\/\.ipynb_checkpoints  

{shinestacker-0.3.3 → shinestacker-0.3.4}/CHANGELOG.md

@@ -4,6 +4,29 @@ This page reports the main releases only and the main changes therein.
 
 ---
 
+## [v0.3.4] - 2025-08-16
+**Code consolidation and fixes**
+
+### Changes
+
+* code consolidation with support of pylint code checking
+* some bug fixes
+* new project dialog shows the number of bunches, if selected
+* updated sample images, examples and documentation
+
+---
+
+## [v0.3.3] - 2025-08-13
+**Fixed PyPI distribution**
+
+This release is equivalent to v0.3.2, but resolves a problem for PyPI distribution.
+
+### Changes
+
+* examples and tests removed from PyPI distribution in order to fix file size limit
+
+---
+
 ## [v0.3.2] - 2025-08-13
 **Fixes and code refactoring**
 

{shinestacker-0.3.3 → shinestacker-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 0.3.3
+Version: 0.3.4
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -36,11 +36,17 @@ Dynamic: license-file
 [![CI multiplatform](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml/badge.svg)](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml)
 [![PyPI version](https://img.shields.io/pypi/v/shinestacker?color=success)](https://pypi.org/project/shinestacker/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/shinestacker)](https://pypi.org/project/shinestacker/)
+[![Qt Versions](https://img.shields.io/badge/Qt-6-blue.svg?&logo=Qt&logoWidth=18&logoColor=white)](https://www.qt.io/qt-for-python)
 [![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
+[![pylint](https://img.shields.io/badge/PyLint-9.98-yellow?logo=python&logoColor=white)](https://github.com/lucalista/shinestacker/blob/main/.github/workflows/pylint.yml)
 [![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
 
+
+
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies_stack.jpg' width="400" referrerpolicy="no-referrer">
 
+<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee_stack.jpg' width="400" referrerpolicy="no-referrer">
+
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins_stack.jpg' width="400" referrerpolicy="no-referrer">
 > **Focus stacking** for microscopy, macro photography, and computational imaging
 
@@ -48,7 +54,7 @@ Dynamic: license-file
 - 🚀 **Batch Processing**: Align, balance, and stack hundreds of images
 - 🎨 **Hybrid Workflows**: Combine Python scripting with GUI refinement
 - 🧩 **Modular Architecture**: Mix-and-match processing modules
-- 🖌️ **Non-Destructive Editing**: Save multilayer TIFFs for retouching
+- 🖌️ **Retouch Editing**: Final interactive retouch of stacked image from individual frames
 - 📊 **Jupyter Integration**: Reproducible research notebooks
 
 ## Interactive GUI
@@ -63,9 +69,9 @@ The GUI has two main working areas:
 
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-retouch.png' width="600" referrerpolicy="no-referrer">
 
-# Documentation
+# Resources
 
-📖 [Main documentation](https://github.com/lucalista/shinestacker/blob/main/docs/main.md) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md)
+ 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
 
 
 # Credits

{shinestacker-0.3.3 → shinestacker-0.3.4}/README.md

@@ -5,11 +5,17 @@
 [![CI multiplatform](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml/badge.svg)](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml)
 [![PyPI version](https://img.shields.io/pypi/v/shinestacker?color=success)](https://pypi.org/project/shinestacker/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/shinestacker)](https://pypi.org/project/shinestacker/)
+[![Qt Versions](https://img.shields.io/badge/Qt-6-blue.svg?&logo=Qt&logoWidth=18&logoColor=white)](https://www.qt.io/qt-for-python)
 [![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
+[![pylint](https://img.shields.io/badge/PyLint-9.98-yellow?logo=python&logoColor=white)](https://github.com/lucalista/shinestacker/blob/main/.github/workflows/pylint.yml)
 [![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
 
+
+
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies_stack.jpg' width="400" referrerpolicy="no-referrer">
 
+<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee_stack.jpg' width="400" referrerpolicy="no-referrer">
+
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins_stack.jpg' width="400" referrerpolicy="no-referrer">
 > **Focus stacking** for microscopy, macro photography, and computational imaging
 
@@ -17,7 +23,7 @@
 - 🚀 **Batch Processing**: Align, balance, and stack hundreds of images
 - 🎨 **Hybrid Workflows**: Combine Python scripting with GUI refinement
 - 🧩 **Modular Architecture**: Mix-and-match processing modules
-- 🖌️ **Non-Destructive Editing**: Save multilayer TIFFs for retouching
+- 🖌️ **Retouch Editing**: Final interactive retouch of stacked image from individual frames
 - 📊 **Jupyter Integration**: Reproducible research notebooks
 
 ## Interactive GUI
@@ -32,9 +38,9 @@ The GUI has two main working areas:
 
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-retouch.png' width="600" referrerpolicy="no-referrer">
 
-# Documentation
+# Resources
 
-📖 [Main documentation](https://github.com/lucalista/shinestacker/blob/main/docs/main.md) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md)
+ 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
 
 
 # Credits

{shinestacker-0.3.3 → shinestacker-0.3.4}/docs/focus_stacking.md

@@ -10,7 +10,7 @@ Arguments for the constructor of ```FocusStack``` are:
 * ```output_path``` (optional): the subdirectory within ```working_path``` where aligned images are written. If not specified,  it is equal to  ```name```.
 * ```working_path```: the directory that contains input and output image subdirectories. If not specified, it is the same as ```job.working_path```.
 * ```exif_path``` (optional): if specified, EXIF data are copied to the output file from file in the specified directory. If not specified, it is the source directory used as input for the first action. If set equal to ```''``` no EXIF data is saved.
-* ```denoise``` (optoinal): if specified, a denois algorithm is applied. A value of 0.75 to 1.00 does not reduce details in an appreciable way, and is suitable for modest noise reduction. denoise may be useful for 8-bit images, or for images taken at large ISO. 16-bits images at low ISO usually don't require denoise. See [Image Denoising](https://docs.opencv.org/3.4/d5/d69/tutorial_py_non_local_means.html) for more details.
+* ```denoise_amount``` (optoinal): if specified, a denois algorithm is applied. A value of 0.75 to 1.00 does not reduce details in an appreciable way, and is suitable for modest noise reduction. denoise may be useful for 8-bit images, or for images taken at large ISO. 16-bits images at low ISO usually don't require denoise. See [Image Denoising](https://docs.opencv.org/3.4/d5/d69/tutorial_py_non_local_means.html) for more details.
 * ```prefix``` (optional): if specified, the specified string is pre-pended to the file name. May be useful if more algorithms are ran, and different file names are used for the output of different algorithms.
 * ```enabled``` (optional, default: ``True```): allows to switch on and off this module.
 
@@ -28,7 +28,7 @@ Arguments for the constructor of ```FocusStackBunch``` are:
 * ```exif_path``` (optional): if specified, EXIF data are copied to the output file from file in the specified directory. If not specified, it is the source directory used as * ```frames``` (optional, default: 10): the number of frames in each bunch that are stacked together.
 * ```frames``` (optional, default: 10): the number of frames that are fused together. 
 * ```overlap``` (optional, default: 0): the number of overlapping frames between a bunch and the following one. 
-* ```denoise``` (optoinal): if specified, a denois algorithm is applied. A value of 0.75 to 1.00 does not reduce details in an appreciable way, and is suitable for modest noise reduction. denoise may be useful for 8-bit images, or for images taken at large ISO. 16-bits images at low ISO usually don't require denoise. See [Image Denoising](https://docs.opencv.org/3.4/d5/d69/tutorial_py_non_local_means.html) for more details.
+* ```denoise_amount``` (optoinal): if specified, a denois algorithm is applied. A value of 0.75 to 1.00 does not reduce details in an appreciable way, and is suitable for modest noise reduction. denoise may be useful for 8-bit images, or for images taken at large ISO. 16-bits images at low ISO usually don't require denoise. See [Image Denoising](https://docs.opencv.org/3.4/d5/d69/tutorial_py_non_local_means.html) for more details.
 * ```prefix``` (optional): if specified, the specified string is pre-pended to the file name. May be useful if more algorithms are ran, and different file names are used for the output of different algorithms.
 * ```enabled``` (optional, default: ```True```): allows to switch on and off this module.
 

shinestacker-0.3.4/docs/index.md

@@ -0,0 +1,17 @@
+# Shine Stacker
+
+## Focus Stacking Processing Framework and GUI
+
+```{toctree}
+:maxdepth: 2
+:caption: Content
+
+main.md
+gui.md
+job.md
+alignment.md
+balancing.md
+focus_stacking.md
+multilayer.md
+noise.md
+vignetting.md

{shinestacker-0.3.3 → shinestacker-0.3.4}/docs/job.md

@@ -5,20 +5,13 @@ Create a job, then schedule the desired actions in a job, then run the job.
 Quick start example:
 
 ```python
-from focus_stack import *
+from shinestacker import *
 
-job = StackJob("job", "E:/Focus stacking/My image directory/", input_path="src")
-job.add_action(NoiseDetection())
-job.run()
-
-job = StackJob("job", "E:/Focus stacking/My image directory/", input_path="src")
-job.add_action(Actions("align", actions=[MaskNoise(),
-                                         AlignFrames(),
-                                         BalanceFrames(mask_size=0.9, i_min=150, i_max=65385)]))
-job.add_action(FocusStackBunch("batches", PyramidStack(), frames=10, overlap=2, denoise=0.8))
-job.add_action(FocusStack("stack", PyramidStack(), postfix='_py', denoise=0.8))
-job.add_action(FocusStack("stack", DepthMapStack(), input_path='batches', postfix='_dm', denoise=0.8))
-job.add_action(MultiLayer("multilayer", input_path=['batches', 'stack']))
+job = StackJob("job", "E:/focus_stacking/project_directory/", input_path="tiff_images")
+job.add_action(CombinedActions("align", actions=[AlignFrames(), BalanceFrames()]))
+job.add_action(FocusStackBunch("batches", PyramidStack(), frames=12, overlap=2))
+job.add_action(FocusStack("stack", PyramidStack(), prefix='pyram_'))
+job.add_action(FocusStack("stack", DepthMapStack(), prefix='dmap_'))
 job.run()
 ```
 

{shinestacker-0.3.3 → shinestacker-0.3.4}/docs/main.md

@@ -2,14 +2,10 @@
 
 ## Focus Stacking Processing Framework and GUI
 
-[![CI multiplatform](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml/badge.svg)](https://github.com/lucalista/shinestacker/actions/workflows/ci-multiplatform.yml)
-[![PyPI version](https://img.shields.io/pypi/v/shinestacker?color=success)](https://pypi.org/project/shinestacker/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/shinestacker)](https://pypi.org/project/shinestacker/)
-[![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
-[![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
-
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/flies_stack.jpg' width="400" referrerpolicy="no-referrer">
 
+<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coffee_stack.jpg' width="400" referrerpolicy="no-referrer">
+
 <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins.gif' width="400" referrerpolicy="no-referrer">  <img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/coins_stack.jpg' width="400" referrerpolicy="no-referrer">
 
 > **Focus stacking** for microscopy, macro photography, and computational imaging
@@ -38,8 +34,8 @@ job.run()
 Clone the pagkage from GitHub:
 
 ```bash
-git clone https://github.com/lucalista/focusstack.git
-cd focusstack
+git clone https://github.com/lucalista/shinestacker.git
+cd shinestacker
 pip install -e .
 ```
 
@@ -47,7 +43,7 @@ pip install -e .
 Launch GUI
 
 ```bash
-focusstack
+shinestacker
 ```
 
 Follow [GUI guide](gui.md) for batch processing and retouching.
@@ -56,21 +52,13 @@ Follow [GUI guide](gui.md) for batch processing and retouching.
 ## Advanced Processing Pipeline
 
 ```python
-from shinestacker.algorithms import *
-
-job = StackJob("job", "E:/Focus stacking/My image directory/", input_path="src")
-job.add_action(NoiseDetection())
-job.run()
+from shinestacker import *
 
-job = StackJob("job", "E:/Focus stacking/My image directory/", input_path="src")
-job.add_action(CombinedActions("align",
-			       [MaskNoise(),Vignetting(), AlignFrames(),
-                                BalanceFrames(mask_size=0.9,
-                                              intensity_interval={'min': 150, 'max': 65385})]))
-job.add_action(FocusStackBunch("bunches", PyramidStack(), frames=10, overlap=2, denoise=0.8))
-job.add_action(FocusStack("stack", PyramidStack(), prefix='pyramid_', denoise=0.8))
-job.add_action(FocusStack("stack", DepthMapStack(), input_path='batches', prefix='depthmap_', denoise=0.8))
-job.add_action(MultiLayer("multilayer", input_path=['batches', 'stack']))
+job = StackJob("job", "E:/focus_stacking/project_directory/", input_path="tiff_images")
+job.add_action(CombinedActions("align", actions=[AlignFrames(), BalanceFrames()]))
+job.add_action(FocusStackBunch("batches", PyramidStack(), frames=12, overlap=2))
+job.add_action(FocusStack("stack", PyramidStack(), prefix='pyram_'))
+job.add_action(FocusStack("stack", DepthMapStack(), prefix='dmap_'))
 job.run()
 ```
 

shinestacker-0.3.4/requirements.txt

@@ -0,0 +1,13 @@
+matplotlib
+matplotlib
+imagecodecs
+jsonpickle
+numpy
+opencv_python
+pillow
+psdtags
+PySide6
+scipy
+tifffile
+tqdm
+setuptools-scm

{shinestacker-0.3.3 → shinestacker-0.3.4}/src/shinestacker/__init__.py

@@ -1,4 +1,5 @@
 # flake8: noqa F401 F403
+# pylint: disable=C0114, E0401
 from ._version import __version__
 from . import config
 from . import core
@@ -13,4 +14,4 @@ from .algorithms import *
 __all__ = ['__version__']
 __all__ += config_all
 __all__ += core_all
-__all__ += algorithms_all
+__all__ += algorithms_all

shinestacker-0.3.4/src/shinestacker/_version.py

@@ -0,0 +1 @@
+__version__ = '0.3.4'

{shinestacker-0.3.3 → shinestacker-0.3.4}/src/shinestacker/algorithms/__init__.py

@@ -1,4 +1,6 @@
 # flake8: noqa F401
+# pylint: disable=C0114
+import logging
 from .. config.constants import constants
 from .stack_framework import StackJob, CombinedActions
 from .align import AlignFrames
@@ -9,11 +11,10 @@ from .pyramid import PyramidStack
 from .multilayer import MultiLayer
 from .noise_detection import NoiseDetection, MaskNoise
 from .vignetting import Vignetting
-import logging
 logger = logging.getLogger(__name__)
 logger.addHandler(logging.NullHandler())
 
 __all__ = [
 	'StackJob', 'CombinedActions', 'AlignFrames', 'BalanceFrames', 'FocusStackBunch', 'FocusStack',
 	'DepthMapStack', 'PyramidStack', 'MultiLayer', 'NoiseDetection', 'MaskNoise', 'Vignetting'
-]
+]