shinestacker 0.3.4__tar.gz → 0.3.5__tar.gz

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

@@ -4,6 +4,17 @@ This page reports the main releases only and the main changes therein.
 
 ---
 
+## [v0.3.5] - 2025-08-17
+**Bug fixes**
+
+### Changes
+
+* fixed a bug that prevented to add sub-actoins
+* vignetting constrains model parameter in order to prevent searching for dark areas at the center of the image instead of at periphery
+* updated sample images and documentation
+
+---
+
 ## [v0.3.4] - 2025-08-16
 **Code consolidation and fixes**
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 0.3.4
+Version: 0.3.5
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -37,10 +37,11 @@ Dynamic: license-file
 [![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)
-
+<!--
+[![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
+-->
 
 
 <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">
@@ -83,9 +84,14 @@ The main pyramid stack algorithm was initially inspired by the [Laplacian pyrami
 * [Pyramid Methods in Image Processing](https://www.researchgate.net/publication/246727904_Pyramid_Methods_in_Image_Processing), E. H. Adelson, C. H. Anderson,  J. R. Bergen, P. J. Burt, J. M. Ogden, RCA Engineer, 29-6, Nov/Dec 1984
 Pyramid methods in image processing
 * [A Multi-focus Image Fusion Method Based on Laplacian Pyramid](http://www.jcomputers.us/vol6/jcp0612-07.pdf), Wencheng Wang, Faliang Chang, Journal of Computers 6 (12), 2559, December 2011
-* Another [original implementation on GitHub](https://github.com/bznick98/Focus_Stacking) by Zongnan Bao
 
 # License
 
 The software is provided as is under the [GNU Lesser General Public License v3.0](https://choosealicense.com/licenses/lgpl-3.0/).
 
+# Attribution request
+📸 If you publish images created with Shine Stacker, please consider adding a note such as:
+
+*Created with Shine Stacker – https://github.com/lucalista/shinestacker*
+
+This is not mandatory, but highly appreciated.

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

@@ -6,10 +6,11 @@
 [![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)
-
+<!--
+[![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
+-->
 
 
 <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">
@@ -52,9 +53,14 @@ The main pyramid stack algorithm was initially inspired by the [Laplacian pyrami
 * [Pyramid Methods in Image Processing](https://www.researchgate.net/publication/246727904_Pyramid_Methods_in_Image_Processing), E. H. Adelson, C. H. Anderson,  J. R. Bergen, P. J. Burt, J. M. Ogden, RCA Engineer, 29-6, Nov/Dec 1984
 Pyramid methods in image processing
 * [A Multi-focus Image Fusion Method Based on Laplacian Pyramid](http://www.jcomputers.us/vol6/jcp0612-07.pdf), Wencheng Wang, Faliang Chang, Journal of Computers 6 (12), 2559, December 2011
-* Another [original implementation on GitHub](https://github.com/bznick98/Focus_Stacking) by Zongnan Bao
 
 # License
 
 The software is provided as is under the [GNU Lesser General Public License v3.0](https://choosealicense.com/licenses/lgpl-3.0/).
 
+# Attribution request
+📸 If you publish images created with Shine Stacker, please consider adding a note such as:
+
+*Created with Shine Stacker – https://github.com/lucalista/shinestacker*
+
+This is not mandatory, but highly appreciated.

shinestacker-0.3.5/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,80 @@
+THIRD-PARTY LICENSES
+====================
+
+This application bundles several third-party Python packages.  
+Each package is copyrighted by its respective authors and distributed under the following licenses.  
+Full license texts are reproduced below when required.
+
+-------------------------------------------------------------------------------
+matplotlib
+License: PSF license + BSD style
+https://matplotlib.org/stable/users/project/license.html
+
+-------------------------------------------------------------------------------
+imagecodecs
+License: BSD-3-Clause
+https://pypi.org/project/imagecodecs/
+
+-------------------------------------------------------------------------------
+jsonpickle
+License: BSD-3-Clause
+https://github.com/jsonpickle/jsonpickle
+
+-------------------------------------------------------------------------------
+numpy
+License: BSD-3-Clause
+https://numpy.org/
+
+-------------------------------------------------------------------------------
+opencv-python
+License: Apache License 2.0
+https://github.com/opencv/opencv-python
+
+-------------------------------------------------------------------------------
+pillow
+License: Historical PIL Software License (similar to MIT)
+https://python-pillow.org
+
+-------------------------------------------------------------------------------
+psdtags
+License: MIT
+https://pypi.org/project/psdtags/
+
+-------------------------------------------------------------------------------
+PySide6
+License: GNU Lesser General Public License v3.0 (LGPL-3.0)  
+or commercial license from The Qt Company
+https://doc.qt.io/qtforpython/
+
+Full license text follows:
+
+--- BEGIN LGPL-3.0 LICENSE ---
+<qui incolla il testo completo della LGPL-3.0>
+--- END LGPL-3.0 LICENSE ---
+
+-------------------------------------------------------------------------------
+scipy
+License: BSD-3-Clause
+https://scipy.org/
+
+-------------------------------------------------------------------------------
+tifffile
+License: BSD-3-Clause
+https://www.lfd.uci.edu/~gohlke/
+
+-------------------------------------------------------------------------------
+tqdm
+License: Mozilla Public License 2.0 (MPL-2.0)
+https://github.com/tqdm/tqdm
+
+Full license text follows:
+
+--- BEGIN MPL-2.0 LICENSE ---
+<qui incolla il testo completo della MPL-2.0>
+--- END MPL-2.0 LICENSE ---
+
+-------------------------------------------------------------------------------
+
+NOTE:
+This file is provided for license compliance and attribution purposes.  
+Your application code is licensed separately under the GNU Lesser General Public License v3.0.

shinestacker-0.3.5/src/shinestacker/_version.py

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

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/algorithms/base_stack_algo.py

@@ -1,6 +1,5 @@
 # pylint: disable=C0114, C0115, C0116, E0602, R0903
 import numpy as np
-from .. core.colors import color_str
 from .. core.exceptions import InvalidOptionError, ImageLoadError
 from .. config.constants import constants
 from .utils import read_img, get_img_metadata, validate_image
@@ -28,7 +27,7 @@ class BaseStackAlgo:
         return self._steps_per_frame
 
     def print_message(self, msg):
-        self.process.sub_message_r(color_str(msg, "light_blue"))
+        self.process.sub_message_r(msg)
 
     def read_image_and_update_metadata(self, img_path, metadata):
         img = read_img(img_path)

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/algorithms/noise_detection.py

@@ -162,9 +162,6 @@ class MaskNoise(SubAction):
         else:
             raise ImageLoadError(path, "file not found.")
 
-    def end(self):
-        pass
-
     def run_frame(self, _idx, _ref_idx, image):
         self.process.sub_message_r(': mask noisy pixels')
         if len(image.shape) == 3:

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/algorithms/stack.py

@@ -2,7 +2,6 @@
 import os
 import numpy as np
 from .. config.constants import constants
-from .. core.colors import color_str
 from .. core.framework import JobBase
 from .. core.exceptions import InvalidOptionError
 from .utils import write_img
@@ -92,7 +91,7 @@ class FocusStackBunch(ActionList, FocusStackBase):
         ActionList.end(self)
 
     def run_step(self):
-        self.print_message_r(color_str(f"fusing bunch: {self.count}", "blue"))
+        self.print_message_r(f"fusing bunch: {self.count}")
         self.focus_stack(self._chunks[self.count - 1])
         self.callback('after_step', self.id, self.name, self.count)
 

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/algorithms/stack_framework.py

@@ -237,6 +237,12 @@ class SubAction:
     def __init__(self, enabled=True):
         self.enabled = enabled
 
+    def begin(self, process):
+        pass
+
+    def end(self):
+        pass
+
 
 class CombinedActions(FramesRefActions):
     def __init__(self, name, actions=[], enabled=True, **kwargs):
@@ -255,10 +261,10 @@ class CombinedActions(FramesRefActions):
         filename = self.filenames[idx]
         img = read_img((self.output_dir
                         if self.step_process else self.input_full_path) + f"/{filename}")
-        self.dtype = img.dtype
-        self.shape = img.shape
         if img is None:
             raise RuntimeError(f"Invalid file: {self.input_full_path}/{filename}")
+        self.dtype = img.dtype
+        self.shape = img.shape
         return img
 
     def run_frame(self, idx, ref_idx):

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/algorithms/vignetting.py

@@ -59,7 +59,8 @@ class Vignetting(SubAction):
         i_valid, r_valid = intensities[valid_mask], radii[valid_mask]
         try:
             res = curve_fit(Vignetting.sigmoid, r_valid, i_valid,
-                            p0=[np.max(i_valid), 0.01, np.median(r_valid)])[0]
+                            p0=[np.max(i_valid), 0.01, np.median(r_valid)],
+                            bounds=([0, 0, 0], ['inf', 'inf', 'inf']))[0]
         except Exception:
             self.process.sub_message(
                 color_str(": could not find vignetting model", "red"),
@@ -83,7 +84,7 @@ class Vignetting(SubAction):
                        if image.dtype == np.uint8 else 65535).astype(image.dtype)
 
     def run_frame(self, idx, _ref_idx, img_0):
-        self.process.sub_message_r(color_str(": compute vignetting", "light_blue"))
+        self.process.sub_message_r(": compute vignetting")
         img = cv2.cvtColor(img_8bit(img_0), cv2.COLOR_BGR2GRAY)
         radii, intensities = self.radial_mean_intensity(img)
         pars = self.fit_sigmoid(radii, intensities)
@@ -92,7 +93,7 @@ class Vignetting(SubAction):
         self.v0 = Vignetting.sigmoid(0, *pars)
         i0_fit, k_fit, r0_fit = pars
         self.process.sub_message(
-            f": fit parameters: i0={i0_fit:.4f}, k={k_fit:.4f}, r0={r0_fit:.4f}",
+            f": vignetting model parameters: i0={i0_fit:.4f}, k={k_fit:.4f}, r0={r0_fit:.4f}",
             level=logging.DEBUG)
         if self.plot_correction:
             plt.figure(figsize=(10, 5))
@@ -116,7 +117,7 @@ class Vignetting(SubAction):
             self.corrections[i][idx] = fsolve(lambda x: Vignetting.sigmoid(x, *pars) /
                                               self.v0 - p, r0_fit)[0]
         if self.apply_correction:
-            self.process.sub_message_r(color_str(": correct vignetting", "light_blue"))
+            self.process.sub_message_r(": correct vignetting")
             return self.correct_vignetting(img_0, pars)
         return img_0
 

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/app/help_menu.py

@@ -14,4 +14,4 @@ def add_help_action(app):
 
 
 def browse_website():
-    webbrowser.open("https://github.com/lucalista/shinestacker/blob/main/README.md")
+    webbrowser.open("https://github.com/lucalista/shinestacker/blob/main/docs/gui.md")

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/gui/actions_window.py

@@ -8,7 +8,6 @@ from PySide6.QtWidgets import QMessageBox, QFileDialog, QDialog
 from .. core.core_utils import get_app_base_path
 from .. config.constants import constants
 from .project_model import ActionConfig
-from .action_config import ActionConfigDialog
 from .project_editor import ProjectEditor
 from .new_project import NewProjectDialog
 from .project_model import Project
@@ -17,9 +16,6 @@ from .project_model import Project
 class ActionsWindow(ProjectEditor):
     def __init__(self):
         super().__init__()
-        self._current_file = None
-        self._current_file_wd = ''
-        self._modified_project = False
         self.update_title()
 
     def update_title(self):
@@ -197,6 +193,7 @@ class ActionsWindow(ProjectEditor):
             self._current_file = file_path
             self._modified_project = False
             self.update_title()
+            os.chdir(os.path.dirname(file_path))
 
     def do_save(self, file_path):
         try:
@@ -229,7 +226,7 @@ class ActionsWindow(ProjectEditor):
         index = self.job_list.row(item)
         if 0 <= index < len(self.project.jobs):
             job = self.project.jobs[index]
-            dialog = ActionConfigDialog(job, self._current_file_wd, self)
+            dialog = self.action_config_dialog(job)
             if dialog.exec() == QDialog.Accepted:
                 current_row = self.job_list.currentRow()
                 if current_row >= 0:
@@ -262,7 +259,7 @@ class ActionsWindow(ProjectEditor):
                 if not is_sub_action:
                     self.set_enabled_sub_actions_gui(
                         current_action.type_name == constants.ACTION_COMBO)
-                dialog = ActionConfigDialog(current_action, self._current_file_wd, self)
+                dialog = self.action_config_dialog(current_action)
                 if dialog.exec() == QDialog.Accepted:
                     self.on_job_selected(job_index)
                     self.refresh_ui()
@@ -284,7 +281,7 @@ class ActionsWindow(ProjectEditor):
             self.edit_action(current_action)
 
     def edit_action(self, action):
-        dialog = ActionConfigDialog(action, self._current_file_wd, self)
+        dialog = self.action_config_dialog(action)
         if dialog.exec() == QDialog.Accepted:
             self.on_job_selected(self.job_list.currentRow())
             self.mark_as_modified()

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker/gui/project_editor.py

@@ -89,6 +89,9 @@ class ProjectEditor(QMainWindow):
         self.expert_options = False
         self.script_dir = os.path.dirname(__file__)
         self.dialog = None
+        self._current_file = None
+        self._current_file_wd = ''
+        self._modified_project = False
 
     def set_project(self, project):
         self.project = project
@@ -300,9 +303,12 @@ class ProjectEditor(QMainWindow):
             self.delete_element_action.setEnabled(True)
         return element
 
+    def action_config_dialog(self, action):
+        return ActionConfigDialog(action, self._current_file_wd, self)
+
     def add_job(self):
         job_action = ActionConfig("Job")
-        self.dialog = ActionConfigDialog(job_action, self)
+        self.dialog = self.action_config_dialog(job_action)
         if self.dialog.exec() == QDialog.Accepted:
             self.mark_as_modified()
             self.project.jobs.append(job_action)
@@ -323,7 +329,7 @@ class ProjectEditor(QMainWindow):
             type_name = self.action_selector.currentText()
         action = ActionConfig(type_name)
         action.parent = self.get_current_job()
-        self.dialog = ActionConfigDialog(action, self)
+        self.dialog = self.action_config_dialog(action)
         if self.dialog.exec() == QDialog.Accepted:
             self.mark_as_modified()
             self.project.jobs[current_index].add_sub_action(action)
@@ -365,7 +371,7 @@ class ProjectEditor(QMainWindow):
         if type_name is False:
             type_name = self.sub_action_selector.currentText()
         sub_action = ActionConfig(type_name)
-        self.dialog = ActionConfigDialog(sub_action, self)
+        self.dialog = self.action_config_dialog(sub_action)
         if self.dialog.exec() == QDialog.Accepted:
             self.mark_as_modified()
             action.add_sub_action(sub_action)

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 0.3.4
+Version: 0.3.5
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -37,10 +37,11 @@ Dynamic: license-file
 [![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)
-
+<!--
+[![codecov](https://codecov.io/github/lucalista/shinestacker/graph/badge.svg?token=Y5NKW6VH5G)](https://codecov.io/github/lucalista/shinestacker)
+-->
 
 
 <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">
@@ -83,9 +84,14 @@ The main pyramid stack algorithm was initially inspired by the [Laplacian pyrami
 * [Pyramid Methods in Image Processing](https://www.researchgate.net/publication/246727904_Pyramid_Methods_in_Image_Processing), E. H. Adelson, C. H. Anderson,  J. R. Bergen, P. J. Burt, J. M. Ogden, RCA Engineer, 29-6, Nov/Dec 1984
 Pyramid methods in image processing
 * [A Multi-focus Image Fusion Method Based on Laplacian Pyramid](http://www.jcomputers.us/vol6/jcp0612-07.pdf), Wencheng Wang, Faliang Chang, Journal of Computers 6 (12), 2559, December 2011
-* Another [original implementation on GitHub](https://github.com/bznick98/Focus_Stacking) by Zongnan Bao
 
 # License
 
 The software is provided as is under the [GNU Lesser General Public License v3.0](https://choosealicense.com/licenses/lgpl-3.0/).
 
+# Attribution request
+📸 If you publish images created with Shine Stacker, please consider adding a note such as:
+
+*Created with Shine Stacker – https://github.com/lucalista/shinestacker*
+
+This is not mandatory, but highly appreciated.

{shinestacker-0.3.4 → shinestacker-0.3.5}/src/shinestacker.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ CHANGELOG.md
 LICENSE
 MANIFEST.in
 README.md
+THIRD_PARTY_LICENSES.txt
 pyproject.toml
 requirements.txt
 .github/workflows/ci-multiplatform.yml

shinestacker-0.3.4/src/shinestacker/_version.py

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