shinestacker 1.2.1__tar.gz → 1.3.1__tar.gz

{shinestacker-1.2.1 → shinestacker-1.3.1}/CHANGELOG.md

@@ -2,8 +2,46 @@
 
 This page reports the main releases only and the main changes therein.
 
-## [v1.2.1] - 2025-09-01
+## [v1.3.1] - 2025-09-08
+
+## Fixed
+- fixed input folder widget in job configuration
+- better management of patological alignments
+
+### Changed
+- improved automatic parameters for parallel alignment
+- improved pyramid performances by combining two input steps
+- improved performances of ORB and SURF feature extraction with key points caching
+- improved configuration GUI using tabs and other minor GUI improvements
+- code clean up and some fixes
+
+---
+
+## [v1.3.0] - 2025-09-06
+**Parallel processing and input flexibility**
+
+### Added
+- Parallel processing in alignment feature extraction
+- Parallel processing of combined actions
+- Job input can now specify a list of files (not only a folder)
+- CPU and memory usage monitor widget for running jobs
+
+### Fixed
+- Path in example project
+- Bug fix in config dialog
+
+### Changed
+- Changes some default parameters for better performances
+- Some GUI restyling
+- Code cleanup
+
+---
+
+## [v1.2.1] - 2025-09-02
 **Bug fixes and minor improvements**
+
+### Changes
+
 * alignment is more tolerant in case of failures: frames are skipped and the running job is not stopped
 * fixed the -x (--expert) option
 * more safety checks prevent crashes for abnormal conditions
@@ -16,6 +54,8 @@ This page reports the main releases only and the main changes therein.
 ## [v1.2.0] - 2025-08-31
 **Parallel processing and more improvements**
 
+### Changes
+
 * Implemented parallel processing for pyramid stacking algorithm
 * optimized pyramid algorithm: selects automatically the best within the given memory budget to avoid memory issues in case many pictures are selected. Explicit configuration is also possible for specific needs.
 * Implemented automatic subsample option for alignment, balancing and vignetting, now default

{shinestacker-1.2.1/src/shinestacker.egg-info → shinestacker-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 1.2.1
+Version: 1.3.1
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -20,6 +20,7 @@ Requires-Dist: numpy
 Requires-Dist: opencv_python
 Requires-Dist: pillow
 Requires-Dist: psdtags
+Requires-Dist: psutil
 Requires-Dist: PySide6
 Requires-Dist: scipy
 Requires-Dist: tifffile
@@ -69,6 +70,10 @@ 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">
 
+# Resources
+
+ 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
+
 # Note for macOS users
 
 **The following note is only relevant if you download the application as compressed archive from the [release page](https://github.com/lucalista/shinestacker/releases).**
@@ -88,11 +93,6 @@ xattr -cr ~/Downloads/shinestacker/shinestacker.app
 
 macOS adds a quarantine flag to all files downloaded from the internet. The above command removes that flag while preserving all other application functionality.
 
-# Resources
-
- 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
-
-
 # Credits
 
 The first version of the core focus stack algorithm was initially inspired by the [Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation by Sami Jawhar that was used under permission of the author. The implementation in the latest releases was rewritten from the original code.

{shinestacker-1.2.1 → shinestacker-1.3.1}/README.md

@@ -38,6 +38,10 @@ 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">
 
+# Resources
+
+ 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
+
 # Note for macOS users
 
 **The following note is only relevant if you download the application as compressed archive from the [release page](https://github.com/lucalista/shinestacker/releases).**
@@ -57,11 +61,6 @@ xattr -cr ~/Downloads/shinestacker/shinestacker.app
 
 macOS adds a quarantine flag to all files downloaded from the internet. The above command removes that flag while preserving all other application functionality.
 
-# Resources
-
- 🌍 [Website on WordPress](https://shinestacker.wordpress.com) • 📖 [Main documentation](https://shinestacker.readthedocs.io) • 📝 [Changelog](https://github.com/lucalista/shinestacker/blob/main/CHANGELOG.md) 
-
-
 # Credits
 
 The first version of the core focus stack algorithm was initially inspired by the [Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation by Sami Jawhar that was used under permission of the author. The implementation in the latest releases was rewritten from the original code.

{shinestacker-1.2.1 → shinestacker-1.3.1}/THIRD_PARTY_LICENSES.txt

@@ -40,18 +40,17 @@ psdtags
 License: MIT
 https://pypi.org/project/psdtags/
 
+-------------------------------------------------------------------------------
+psutil
+License: BSD-3-Clause
+https://pypi.org/project/psutil/
+
 -------------------------------------------------------------------------------
 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
@@ -67,14 +66,8 @@ 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.
+Shine Stacker code is licensed separately under the GNU Lesser General Public License v3.0.

{shinestacker-1.2.1 → shinestacker-1.3.1}/docs/alignment.md

@@ -93,6 +93,14 @@ alignment_config = {
 * ```plot_matches```  (optional, default: ```False```): if ```True```, for each image matches with reference frame are drawn. May be useful for inspection and debugging.
 * ```enabled``` (optional, default: ```True```): allows to switch on and off this module.
 
+## Parallel processing
+
+A class ```AlignFramesParallel``` implements alignment using parallel processing.
+This class has extra parameters, in addition to the above ones:
+
+* ```max_threads``` (optional, default: ```2```): number of parallel processes allowed. The number of actual threads will not be greater than the number of available CPU cores.
+* ```chunk_submit``` (optional, default: ```True```): submit at most ```max_threads``` parallel processes. If ```chunk_submit``` is greater than ```max_threads``` a moderate performance gain is achieved at the cost of a possibly large memory occupancy.
+* ```bw_matching``` (optional, default: ```False```): perform matches on black and white version of the images in order to save memory. Preliminary tests indicate that the gain with this option is marginal, and this option may be dropped in the future. 
 
 ## Allowed configurations
 
@@ -119,3 +127,10 @@ give raise to an exception.
 | 0.2887   |  AKAZE   | BRISK      | NORM_HAMMING |
 | 0.4075   |  AKAZE   | SIFT       | KNN          |
 | 0.4397   |  SIFT    | SIFT       | KNN          |
+
+## References
+
+For a detailed review of the various image registration methods, see the publication below:
+*  [A Review of Keypoints’ Detection and Feature Description in Image Registration](https://onlinelibrary.wiley.com/doi/10.1155/2021/8509164), Scientific Programming 2021, 8509164, doi:10.1155/2021/8509164
+
+

{shinestacker-1.2.1 → shinestacker-1.3.1}/docs/focus_stacking.md

@@ -48,6 +48,7 @@ Arguments for the constructor are, in addition to the ones for ```PyramidStack``
    * ```tile_size``` (optional, default: 512): size of a time
    * ```n_tiled_layers``` (optional, default: 2): number of layers that are tiled. Usually the last one or two are the ones that take more memory.
    * ```max_threads``` (optional, default: number of cores, up to a maximum of 8): maximum number of thread used for parallel processing. The actual number of threads does not exceed the number of available cores. 
+* ```chunk_submit``` (optional, default: ```True```): submit at most ```max_threads``` parallel processes. If ```chunk_submit``` is greater than ```max_threads``` a moderate performance gain is achieved at the cost of a possibly large memory occupancy.
 
 
 ```PyramidAutoStack```, pyramid algorithn with capability to automatically switch from all-in-memory to I/O buffered tiled.

{shinestacker-1.2.1 → shinestacker-1.3.1}/docs/job.md

@@ -44,3 +44,5 @@ Arguments for the constructor of ```CombinedActions``` are for the :
 * ```reference_index``` (optional, default: 0): the index of the image used as reference. Images are numbered starting from one to N. -1 is interpreted as the last image, 0 as the median index.
 * ```step_process``` (optional): if equal to ```True``` (default), each image is processed with respect to the previous or next image, depending if its file is placed in alphabetic order after or befor the reference image.
 * ```enabled``` (optional, default: ```True```): allows to switch on and off this module. 
+* ```max_threads``` (optional, default: ```2```): number of parallel processes allowed. The number of actual threads will not be greater than the number of available CPU cores.
+* ```chunk_submit``` (optional, default: ```True```): submit at most ```max_threads``` parallel processes. If ```chunk_submit``` is greater than ```max_threads``` a moderate performance gain is achieved at the cost of a possibly large memory occupancy.

{shinestacker-1.2.1 → shinestacker-1.3.1}/docs/main.md

@@ -87,7 +87,7 @@ job.run()
 
 ### Core processing
 ```bash
-pip install imagecodecs matplotlib numpy opencv-python pillow psdtags scipy setuptools-scm tifffile tqdm
+pip install imagecodecs matplotlib numpy opencv-python pillow psdtags psutil scipy setuptools-scm tifffile tqdm
 ```
 ## GUI support
 ```bash

shinestacker-1.3.1/index.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Shine Stacker</title>
+  <meta name="description" content="Shine Stacker – Open source focus stacking framework with GUI for macro and micro photography.">
+    
+    <!-- Open Graph / Facebook -->
+    <meta property="og:type" content="website">
+    <meta property="og:title" content="Shine Stacker">
+    <meta property="og:description" content="Open source focus stacking framework with GUI for macro and micro photography.">
+    <meta property="og:image" content="https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png">
+    <meta property="og:url" content="https://lucalista.github.io/shinestacker/">
+    
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:title" content="Shine Stacker">
+    <meta name="twitter:description" content="Open source focus stacking framework with GUI for macro and micro photography.">
+    <meta name="twitter:image" content="https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png">
+  <style>
+    body { font-family: sans-serif; margin: 40px; line-height: 1.6; background: #f7f7f7; color: #333; }
+    h1 { color: #2c3e50; font-size: 48px}
+    a { color: #2980b9; text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    .container { max-width: 800px; margin: auto; background: #fff; padding: 30px; border-radius: 10px; box-shadow: 0 4px 10px rgba(0,0,0,0.1);}
+    .logo { width: 150px; }
+    ul { text-align: left; }
+    .footer { color: #A0A0A0; }
+  </style>
+</head>
+<body>
+  <div class="container" style="text-align:center;">
+  <h1>Shine Stacker</h1>
+    <img src="https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png" alt="Shine Stacker Logo" class="logo">  <p>Open source framework and GUI for focus stacking macro and micro photography.</p>
+  <h2><a href="https://lucalista.github.io/shinestacker/docs/main.html">Go to GitHub website</h2>
+  <ul>
+  <li><a href="https://shinestacker.wordpress.com/">Shine Stacker on Wordpress</a></li>
+  <li><a href="https://shinestacker.readthedocs.io/">Complete documentation</a></li>
+  <li><a href="https://github.com/lucalista/shinestacker">Source code and releases on GitHub</a></li>
+</ul>
+<hr style="color: #f0f0ff;">
+<p class="footer">Shine Stacker, &copy; 2025, <a href="https://github.com/lucalista" alt="Luca Lista">Luca Lista</a> (LGPL-3.0).<br>
+Logo © <a href="https://linktr.ee/alelista" alt="Alessandro Lista">Alessandro Lista</a> — All rights reserved.
+</div>
+</body>
+</html>

{shinestacker-1.2.1 → shinestacker-1.3.1}/pyproject.toml

@@ -26,6 +26,7 @@ dependencies = [
     "opencv_python",
     "pillow",
     "psdtags",
+    "psutil",
     "PySide6",
     "scipy",
     "tifffile",

{shinestacker-1.2.1 → shinestacker-1.3.1}/requirements.txt

@@ -6,6 +6,7 @@ numpy
 opencv_python
 pillow
 psdtags
+psutil
 PySide6
 scipy
 tifffile

shinestacker-1.3.1/src/shinestacker/_version.py

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