shinestacker 1.7.0__tar.gz → 1.8.1__tar.gz

{shinestacker-1.7.0 → shinestacker-1.8.1}/.github/workflows/release.yml

@@ -40,9 +40,8 @@ jobs:
           pip install -e .[dev]
 
       - name: Build and package release
-        working-directory: scripts
         run: |
-          python build_release.py
+          python scripts/build_release.py
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
@@ -52,7 +51,6 @@ jobs:
             ${{ matrix.os == 'windows-latest' && 'dist/shinestacker-release.zip' || '' }}
             ${{ matrix.os == 'windows-latest' && 'dist/*.exe' || '' }}
             ${{ matrix.os == 'ubuntu-latest' && 'dist/shinestacker-release.tar.gz' || '' }}
-            ${{ matrix.os == 'macos-latest' && 'dist/shinestacker-release.tar.gz' || '' }}
             ${{ matrix.os == 'macos-latest' && 'dist/shinestacker-release.dmg' || '' }}
           if-no-files-found: ignore
 
@@ -70,8 +68,7 @@ jobs:
           mkdir -p release_assets
           # Linux
           cp artifacts/shinestacker-ubuntu-latest/shinestacker-release.tar.gz release_assets/shinestacker-ubuntu.tar.gz
-          # macOS - include both formats
-          cp artifacts/shinestacker-macos-latest/shinestacker-release.tar.gz release_assets/shinestacker-macos.tar.gz
+          # macOS
           cp artifacts/shinestacker-macos-latest/shinestacker-release.dmg release_assets/shinestacker-macos.dmg
           # Windows
           cp artifacts/shinestacker-windows-latest/shinestacker-release.zip release_assets/shinestacker-windows.zip
@@ -86,7 +83,6 @@ jobs:
           draft: true
           files: |
             release_assets/shinestacker-ubuntu.tar.gz
-            release_assets/shinestacker-macos.tar.gz
             release_assets/shinestacker-macos.dmg
             release_assets/shinestacker-windows.zip
             release_assets/shinestacker-setup.exe

{shinestacker-1.7.0 → shinestacker-1.8.1}/CHANGELOG.md

@@ -2,8 +2,51 @@
 
 This page reports the main releases only and the main changes therein.
 
+## [v1.8.1] - 2025-10-16
+** Alignment stability and performance improvements **
+
+### Added
+- optional alignment algorithm based on phase correlation as fallback when no feature match is found
+- retry limits in parallel alignment, determined by new configurable parameter delta_max
+- new configurable parameters in persistent default settings
+
+### Fixed
+- reference frame indexing if sequential processing is applied as fallback from multithread run
+- job configuration dialog failure if input is aready selected
+- preview thumbnail failure for very large images
+- minor inaccuracies in logger messages
+- minor GUI issues
+- computations for vignetting summary plot
+
+### Changed
+- improved robustness of alignment strategy for poorly focused images
+- better tuning of parallel frame alignment
+- consistent handling of noise map output folders
+- improved naming scheme for wizard-generated projects
+- more reliable default settings persistency
+- code refactoring and cleanup
+
+-----
+
+## [v1.8.0] - 2025-10-08
+** Minor improvements and accessibility fix **
+
+### Added
+- temporary disk space can be cleaned up with a new option to scratch output files at the end of a job 
+
+### Fixed
+- new project dialog displays well also with dark background settings
+
+### Changed
+- icons now adapt automatically to light or dark desktop theme
+- additional alignment parameters added to default settings
+- minor GUI stability fix
+- redundant macOS .tar.gz installer removed, replaced by .dmg image
+
+-----
+
 ## [v1.7.0] - 2025-10-04
-** New image adjustment actions and macOS dmg installer **
+** New image adjustment actions and macOS dmg image installer **
 
 ### Added
 - luminosity and contrast adjustment action

{shinestacker-1.7.0/src/shinestacker.egg-info → shinestacker-1.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shinestacker
-Version: 1.7.0
+Version: 1.8.1
 Summary: ShineStacker
 Author-email: Luca Lista <luka.lista@gmail.com>
 License-Expression: LGPL-3.0
@@ -30,11 +30,9 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Dynamic: license-file
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
-
 # Shine Stacker
 
-## Focus Stacking Processing Framework and GUI
+Focus Stacking Processing Framework and GUI designed for macro photographers, microscopists, and researchers who need precise control and reproducible stacking results.
 
 [![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/)
@@ -45,60 +43,55 @@ Dynamic: license-file
 [![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
  [![License: LGPL v3](https://img.shields.io/badge/License-LGPL_v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)
 [![PyPI Downloads](https://static.pepy.tech/badge/shinestacker)](https://pepy.tech/projects/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">
-
-<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">
-
-> **Focus stacking** for microscopy, macro photography, and computational imaging
+<center><img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo"></center>
 
 ## Key Features
-- 🚀 **Batch Processing**: Align, balance, and stack hundreds of images
-- 🧩 **Modular Architecture**: Mix-and-match processing modules
-- 🖌️ **Retouch Editing**: Final interactive retouch of stacked image from individual frames
-- 📊 **Jupyter Integration**: Image processing python notebooks
+- 🪟 **Cross-Platform GUI**: Native app built with Qt6, available for Windows, macOS, and Linux.
+- 🚀 **Batch Processing**: Automatically align, balance, and stack hundreds of images — perfect for macro or microscopy datasets.
+- 🧩 **Modular Architecture**: Combine configurable modules for alignment, normalization, and blending to build custom workflows.
+- 🖌️ **Retouch Editor**: Interactively refine your stacked image by painting in details from individual frames.
+- 📊 **Jupyter & Python Integration**: Use Shine Stacker as a library inside your Python or Jupyter workflows.
+
+<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">
 
 ## Interactive GUI
 
-The GUI has two main working areas: 
+The graphical interface makes complex stacking tasks simple:
+- **Project View** – Configure, preview, and run stacking workflows with optional intermediate results.
+- **Retouch View** – Manually refine the final image by blending details from selected frames and applying filters.
 
-* *Project*: manage and run focus stacking workflows in a flexible and configurable way, with optional intermediate batch stacking.
+Ideal for users who want the power of scripting and the comfort of a modern UI.
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-project-run.png' width="600" 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">
 
-* *Retouch*: select interactively details from individual frames and apply final filters to the blended image.
+## Get Started
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-retouch.png' width="600" referrerpolicy="no-referrer">
+- 📦 [Install via PyPI](https://pypi.org/project/shinestacker/)
+- 💻 [Run the GUI app](https://shinestacker.readthedocs.io/en/latest/gui.html)
+- 🧠 [Reference](https://shinestacker.readthedocs.io/en/)
+- 🐛 [Report an issue](https://github.com/lucalista/shinestacker/issues)
 
 ## 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).**
+## Installation
 
-The macOS system security protection prevent to run applications downloaded from the web that come from developers that don't hold an Apple Developer Certificate. 
+See the [main documentation](https://github.com/lucalista/shinestacker/blob/main/docs/main.md) for detailed installation instructions.
 
-In order to prevent this, follow the instructions below:
+**Platform notes:**
+- **Windows:** If you download the installer or ZIP archive, you may need to whitelist the app in your antivirus software.
+- **macOS:** See the [installation note for macOS users](https://github.com/lucalista/shinestacker/blob/main/docs/macos-install.md).
 
-1. Download the compressed archive ```shinestacker-macos.tar.gz``` in your ```Download``` folder.
-2. Double-click the archive to uncompress it. You will find a new folder ```shinestacker```.
-3. Open a terminal (*Applications > Utilities > Terminal*)
-4. Type the folliwng command on the terminal (assuming you have expanded the ```tar.gz``` under ```Downloads```):
-```bash
-xattr -cr ~/Downloads/shinestacker/shinestacker.app
-```
-5. Now you can double-click the Sine Stacker icon app in the ```shiestacker``` folder and it should run.
 
-macOS adds a quarantine flag to all files downloaded from the internet. The above command removes that flag while preserving all other application functionality.
+## Acknowledgements & References
 
-## 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.
-
-## Resources
+The first version of the core focus stack algorithm was inspired by the 
+[Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation 
+by Sami Jawhar, used under permission. The implementation in the latest releases 
+was rewritten from the original code.
 
+Key references:
 * [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
@@ -108,7 +101,6 @@ Pyramid methods in image processing
 <img src="https://www.gnu.org/graphics/lgplv3-147x51.png" alt="LGPL 3 logo">
 
 - **Code**: The software is provided as is under the [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.en.html). See [LICENSE](https://github.com/lucalista/shinestacker/blob/main/LICENSE) for details.
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
 
 - **Logo**: The Shine Stacker logo was designed by [Alessandro Lista](https://linktr.ee/alelista). Copyright © Alessandro Lista. All rights reserved. The logo is not covered by the LGPL-3.0 license of this project.
 
@@ -118,3 +110,7 @@ Pyramid methods in image processing
 *Created with Shine Stacker – https://github.com/lucalista/shinestacker*
 
 This is not mandatory, but highly appreciated.
+---
+> Developed and maintained by [Luca Lista](https://github.com/lucalista).
+> 💡 Contributions, feedback, and feature suggestions are warmly welcome.
+> If you enjoy Shine Stacker, consider giving it a ⭐️ on GitHub — it really helps visibility!

{shinestacker-1.7.0 → shinestacker-1.8.1}/README.md

@@ -1,8 +1,6 @@
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
-
 # Shine Stacker
 
-## Focus Stacking Processing Framework and GUI
+Focus Stacking Processing Framework and GUI designed for macro photographers, microscopists, and researchers who need precise control and reproducible stacking results.
 
 [![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/)
@@ -13,60 +11,55 @@
 [![Documentation Status](https://readthedocs.org/projects/shinestacker/badge/?version=latest)](https://shinestacker.readthedocs.io/en/latest/?badge=latest)
  [![License: LGPL v3](https://img.shields.io/badge/License-LGPL_v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)
 [![PyPI Downloads](https://static.pepy.tech/badge/shinestacker)](https://pepy.tech/projects/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">
-
-<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">
-
-> **Focus stacking** for microscopy, macro photography, and computational imaging
+<center><img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo"></center>
 
 ## Key Features
-- 🚀 **Batch Processing**: Align, balance, and stack hundreds of images
-- 🧩 **Modular Architecture**: Mix-and-match processing modules
-- 🖌️ **Retouch Editing**: Final interactive retouch of stacked image from individual frames
-- 📊 **Jupyter Integration**: Image processing python notebooks
+- 🪟 **Cross-Platform GUI**: Native app built with Qt6, available for Windows, macOS, and Linux.
+- 🚀 **Batch Processing**: Automatically align, balance, and stack hundreds of images — perfect for macro or microscopy datasets.
+- 🧩 **Modular Architecture**: Combine configurable modules for alignment, normalization, and blending to build custom workflows.
+- 🖌️ **Retouch Editor**: Interactively refine your stacked image by painting in details from individual frames.
+- 📊 **Jupyter & Python Integration**: Use Shine Stacker as a library inside your Python or Jupyter workflows.
+
+<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">
 
 ## Interactive GUI
 
-The GUI has two main working areas: 
+The graphical interface makes complex stacking tasks simple:
+- **Project View** – Configure, preview, and run stacking workflows with optional intermediate results.
+- **Retouch View** – Manually refine the final image by blending details from selected frames and applying filters.
 
-* *Project*: manage and run focus stacking workflows in a flexible and configurable way, with optional intermediate batch stacking.
+Ideal for users who want the power of scripting and the comfort of a modern UI.
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-project-run.png' width="600" 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">
 
-* *Retouch*: select interactively details from individual frames and apply final filters to the blended image.
+## Get Started
 
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/img/gui-retouch.png' width="600" referrerpolicy="no-referrer">
+- 📦 [Install via PyPI](https://pypi.org/project/shinestacker/)
+- 💻 [Run the GUI app](https://shinestacker.readthedocs.io/en/latest/gui.html)
+- 🧠 [Reference](https://shinestacker.readthedocs.io/en/)
+- 🐛 [Report an issue](https://github.com/lucalista/shinestacker/issues)
 
 ## 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).**
+## Installation
 
-The macOS system security protection prevent to run applications downloaded from the web that come from developers that don't hold an Apple Developer Certificate. 
+See the [main documentation](https://github.com/lucalista/shinestacker/blob/main/docs/main.md) for detailed installation instructions.
 
-In order to prevent this, follow the instructions below:
+**Platform notes:**
+- **Windows:** If you download the installer or ZIP archive, you may need to whitelist the app in your antivirus software.
+- **macOS:** See the [installation note for macOS users](https://github.com/lucalista/shinestacker/blob/main/docs/macos-install.md).
 
-1. Download the compressed archive ```shinestacker-macos.tar.gz``` in your ```Download``` folder.
-2. Double-click the archive to uncompress it. You will find a new folder ```shinestacker```.
-3. Open a terminal (*Applications > Utilities > Terminal*)
-4. Type the folliwng command on the terminal (assuming you have expanded the ```tar.gz``` under ```Downloads```):
-```bash
-xattr -cr ~/Downloads/shinestacker/shinestacker.app
-```
-5. Now you can double-click the Sine Stacker icon app in the ```shiestacker``` folder and it should run.
 
-macOS adds a quarantine flag to all files downloaded from the internet. The above command removes that flag while preserving all other application functionality.
+## Acknowledgements & References
 
-## 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.
-
-## Resources
+The first version of the core focus stack algorithm was inspired by the 
+[Laplacian pyramids method](https://github.com/sjawhar/focus-stacking) implementation 
+by Sami Jawhar, used under permission. The implementation in the latest releases 
+was rewritten from the original code.
 
+Key references:
 * [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
@@ -76,7 +69,6 @@ Pyramid methods in image processing
 <img src="https://www.gnu.org/graphics/lgplv3-147x51.png" alt="LGPL 3 logo">
 
 - **Code**: The software is provided as is under the [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.en.html). See [LICENSE](https://github.com/lucalista/shinestacker/blob/main/LICENSE) for details.
-<img src='https://raw.githubusercontent.com/lucalista/shinestacker/main/src/shinestacker/gui/ico/shinestacker.png' width="150" referrerpolicy="no-referrer" alt="Shine Stacker Logo">
 
 - **Logo**: The Shine Stacker logo was designed by [Alessandro Lista](https://linktr.ee/alelista). Copyright © Alessandro Lista. All rights reserved. The logo is not covered by the LGPL-3.0 license of this project.
 
@@ -86,3 +78,7 @@ Pyramid methods in image processing
 *Created with Shine Stacker – https://github.com/lucalista/shinestacker*
 
 This is not mandatory, but highly appreciated.
+---
+> Developed and maintained by [Luca Lista](https://github.com/lucalista).
+> 💡 Contributions, feedback, and feature suggestions are warmly welcome.
+> If you enjoy Shine Stacker, consider giving it a ⭐️ on GitHub — it really helps visibility!

{shinestacker-1.7.0 → shinestacker-1.8.1}/docs/alignment.md

@@ -67,7 +67,9 @@ alignment_config = {
     'border_blur': 50,
     'subsample': 0,
     'fast_subsampling': False,
-    'min_good_matches': 100
+    'min_good_matches': 100,
+    'phase_corr_fallback': False,
+    'abort_abnormal': False
 }
 ```
 * ```transform``` (optional, default: ```ALIGN_RIGID```): the transformation applied to register images. Possible values are:
@@ -83,6 +85,8 @@ alignment_config = {
 * ```subsample``` (optional, default: 0=automatic): subsample image for faster alignment. Faster, but alignment could be less accurate if only a small portion of the image is focused. It can save time, in particular for large images.
 * ```fast_subsampling``` (optional, default: ```False```): perform fast image subsampling without interpolation. Used if ```subsample``` is set to ```True```.
 * ```min_good_matches``` (optional, default: 100): if ```subsample```>1 and the number of good matches is below ```min_good_matches```, the alignment is retried without subsampling. This improbes robustness in case a too large subsampling factor is specified. 
+* ```phase_corr_fallback``` (optional, default: ```False```): use phase correlation alignment in case the number of matches is too low to allow to estimate the transformation. This algorithm is not very precise, and may help only in case of blurred images.
+* ```abort_abnormal``` (optional, default: ```False```): abort in case of anormal tansformation. By default, frames where abnormal transformation is found are skipped, and processing continunes to next frame.
 * ```border_mode``` (optional, default: ```BORDER_REPLICATE_BLUR```): border mode. See [Adding borders to your images](https://docs.opencv.org/3.4/dc/da3/tutorial_copyMakeBorder.html) for more details.  Possible values are:
   * ```BORDER_CONSTANT```: pad the image with a constant value. The border value is specified with the parameter ```border_value```.
   * ```BORDER_REPLICATE```: the rows and columns at the very edge of the original are replicated to the extra border.
@@ -101,6 +105,7 @@ 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.
+* ```delta_max``` (optional, defaut: 2): maximum consecutive frames skipped in case of too few matches found.
 
 ## Automatic selection of processing strategy
 

{shinestacker-1.7.0 → shinestacker-1.8.1}/docs/focus_stacking.md

@@ -13,6 +13,8 @@ Arguments for the constructor of ```FocusStack``` are:
 * ```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.
+* ```scratch_output_dir``` (optional, default: ```True```): scratch output directory before processing. This avoids that existing files pollute the output.
+* ```delete_output_at_end``` (optional, default: ```False```): delete output after processing. This cleans disk space in case of processing an intermediate step that is not part of the final output.
 
 ## Focus Stacking in bunches of frames
 
@@ -31,6 +33,8 @@ Arguments for the constructor of ```FocusStackBunch``` are:
 * ```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.
+* ```scratch_output_dir``` (optional, default: ```True```): scratch output directory before processing. This avoids that existing files pollute the output.
+* ```delete_output_at_end``` (optional, default: ```False```): delete output after processing. This cleans disk space in case of processing an intermediate step that is not part of the final output.
 
 ## Stack algorithms
 

{shinestacker-1.7.0 → shinestacker-1.8.1}/docs/job.md

@@ -43,6 +43,8 @@ Arguments for the constructor of ```CombinedActions``` are for the :
 * ```resample``` (optional, default: 1): take every *n*<sup>th</sup> frame in the selected directory. Default: take all frames.
 * ```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. 
+* ```enabled``` (optional, default: ```True```): allows to switch on and off this module.
+* ```scratch_output_dir``` (optional, default: ```True```): scratch output directory before processing. This avoids that existing files pollute the output.
+* ```delete_output_at_end``` (optional, default: ```False```): delete output after processing. This cleans disk space in case of processing an intermediate step that is not part of the final output.
 * ```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.8.1/docs/macos-install.md

@@ -0,0 +1,19 @@
+# Installation Note for macOS Users
+
+**This note applies only if you downloaded Shine Stacker as a compressed archive from the [release page](https://github.com/lucalista/shinestacker/releases).**
+
+macOS system security (Gatekeeper) may prevent applications from running if they were downloaded from the Internet and are not signed with an official Apple Developer Certificate.
+
+To allow Shine Stacker to run safely, please follow these steps:
+
+1. Download the disk image file ```shinestacker-macos.dmg```.
+2. Double-click the ```.dmg``` file and drag the **Shine Stacker** app into your **Application** folder.
+3. Open the **Terminal** (found in *Applications > Utilities > Terminal*).
+4. Run the following command to remove the quarantine attribute:
+```bash
+xattr -cr /Applications/shinestacker/shinestacker.app
+```
+5. You can now launch Shine Stacker normally from your Applications folder.
+
+> 💡 Tip: macOS might still show a security warning the first time you open the app.
+> If that happens, right-click the app and choose Open, then confirm.

{shinestacker-1.7.0 → shinestacker-1.8.1}/docs/noise.md

@@ -13,14 +13,14 @@ Usually, this job should be run first, enabling the option ```plot_histograms```
 Arguments for the constructor of ```NoiseDetection``` are:
 * ```name``` (optional, default: ```noise-map```): name of the action and default name of the subdirectory within ```working_path``` where aligned noise map is written. 
 * ```input_path``` (optional): one or more subdirectory within ```working_path``` that contains input images to be combined. If not specified, the last output path is used, or, if this is the first action, the ```input_path``` specified with the ```StackJob``` construction is used. If the ```StackJob``` specifies no ```input_path```, at least the first action must specify an  ```input_path```.
-* ```output_path``` (optional): unused
+* ```output_path``` (optional): the subdirectory within ```working_path``` where noise map is written. If not specified,  it is equal to  ```name```.
 * ```working_path``` (optional): the directory that contains input and output image subdirectories. If not specified, it is the same as ```job.working_path```.
 * ```max_frames``` (optional): if provided, at most ```max_frames``` images are analyzed to extract noisy pixel mask.
 * ```plot_path``` (optional, default: ```plots```): the directory within ```working_path``` that contains plots produced by the different actions
 * ```plot_histograms```  (optional, default: ```False```): if ```True```, plot a summary of the number of hot pixel by channel as a function of the applied threshold. It may be useful to set the optimal threshold values.
 * ```channel_thresholds``` (optional, default: ```(13, 13, 13)```): threshold values for noisy pixel detections in the color channels R, G, B, respectively.
 * ```blur_size``` (optional, default: 5): image blur amount for pixel detection.
-* ```file_name``` (optional, default: ```hot```): noise map filename. The noisy pixel map is stored bydefault in the file ```hot-rgb.png```. Noisy pixel maps individyally for the R, G and B channels are also stored in  ```hot-r.png```,  ```hot-g.png``` and  ```hot-b.png```, respectively.
+* ```file_name``` (optional, default: ```hot_pixels.png```): noise map filename.
 * ```plot_range``` (optiona, default: (5, 30)): range of the horizontal axis of the plot showing the number of hot pixel as a function of the intensity threshold.
 * ```enabled``` (optional, default: ```True```): allows to switch on and off this module. 
 
@@ -41,7 +41,7 @@ job.add_action(Actions("align", [MaskNoise(),
 Note that if the number of pixels contained in the mask file (```noise_mask``` option) is greater than 1000, the job is aborted.
 
 Arguments for the constructor of ```NoiseDetection``` are:
-* ```noise_mask``` (optional, default: ```noise-map/hot-rgb.png```): filename of the noise mask
+* ```noise_mask``` (optional, default: ```hot-rgb.png```): filename of the noise mask
 *  ```kernel_size``` (optional, default: 3): blur size use to extract noisy pixels
 *  ```method``` (optional, default: ```INTERPOLATE_MEAN```): possible values: ```INTERPOLATE_MEAN```, ```INTERPOLATE_MEDIAN```. Interpolate using mean or median of neighborhood pixels to replace a noisy pixel.
 * ```enabled``` (optional, default: ```True```): allows to switch on and off this module. 

{shinestacker-1.7.0 → shinestacker-1.8.1}/scripts/build_release.py

@@ -7,7 +7,6 @@ import platform
 
 
 def setup_environment():
-    os.chdir("../")
     project_root = Path(__file__).resolve().parent.parent
     dist_dir = project_root / "dist"
     project_name = "shinestacker"
@@ -119,10 +118,6 @@ def package_macos(dist_dir, app_name, project_root):
         except subprocess.CalledProcessError as e:
             print(f"Could not set custom icon: {e}")
     shutil.rmtree(dmg_temp_dir)
-    archive_path = dist_dir / "shinestacker-release.tar.gz"
-    with tarfile.open(archive_path, "w:gz") as tar:
-        tar.add(app_bundle, arcname=app_bundle.name, recursive=True)
-    print(f"Created tar.gz: {archive_path.name}")
 
 
 def package_linux(dist_dir, app_name):

shinestacker-1.8.1/src/shinestacker/_version.py

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