Skip to main content

PlanetarySystemStacker (PSS)

Produce a sharp image of a planetary system object (moon, sun, planets) from many seeing-affected frames using the "lucky imaging" technique.

The program is mainly targeted at extended objects (moon, sun), but it works as well for planets. Results obtained in many tests show at least the same image quality as with the established software AutoStakkert!3.

The software is written in Python 3. The program uses array operations (OpenCV, numpy) wherever possible to speed up execution. A modern graphical user interface (implemented using the QT5 toolkit) and good usability were high priorities in designing the software. PSS is platform-independent and can be used where Python 3 is available. The software has been tested successfully on Windows, various Linux distributions, and macOS. Starting with version 0.8.0, PSS can be used either in GUI mode or from the command line, e.g. as part of a large automatic workflow.

Input to the program can be either video files or directories containing still images. The following algorithmic steps are performed:

  • First, all frames are ranked by their overall image quality.
  • On the best frame, a rectangular patch with the most pronounced structure in x and y is identified automatically. (Alternatively, the user can select the patch manually as well.)
  • Using this patch, all frames are aligned globally with each other.
  • A mean image is computed by averaging the best frames.
  • An alignment point mesh covering the object is constructed automatically. Points, where the image is too dim, or has too little contrast or structure, are discarded. The user can modify the alignment points, or set them all by hand as well.
  • For each alignment point, all frames are ranked by their local contrast in a surrounding image patch.
  • The best frames up to a given number are selected for stacking. Note that this list can be different for different points.
  • For all frames, local shifts are computed at all alignment points.
  • Using those shifts, the alignment point patches of all contributing frames are stacked into a single average image patch.
  • Finally, all stacked patches are blended into a global image, using the background image in places without alignment points.
  • After stacking is completed, the stacked image can be postprocessed (sharpened) either in a final step of the stacking workflow, or in a separate postprocessing job.

Program execution is most efficient if the image data and all intermediate results can be kept in memory. This, however, requires much RAM space. Therefore, the level of buffering can be selected in the configuration dialog, ranging from 0 (no buffering) to 4 (maximum buffering).

There are three ways to install the program:

  • For Windows users there is an self-contained installer. It installs the complete software and creates a starter on the user's desktop.
  • The user installs Python 3 (including pip3), and then calls pip3 to install PSS with all its dependencies automatically. This is the preferred way to install PSS in a platform-independent way. Details can be found in the User Guide.
  • Experienced users can install the Python 3 environment and all packets needed by PSS manually, and then clone the PSS source code from Github. Again, the details are found in the Appendix of the User Guide document.

The way to start the program depends on how it was installed:

  • If the Windows installer was used, the program is started via the desktop icon.
  • If PSS was installed with PIP, it can be started from the command line by entering "PlanetarySystemStacker".
  • The program can be started in the Python 3 interpreter by executing the main program in the module "planetary_system_stacker.py" .

A discussion platform for all issues concerning this software project has been created in the context of the German amateur astronomy forum Astronomie.de. Currently, this forum is in German language only, but an English branch is in preparation. Additionally, an extensive discussion on the subject can be found on the Cloudy Nights forum.

Metadata

Release files for planetary-system-stacker 0.9.8.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for planetary-system-stacker 0.9.8.3
File Interpreter ABI Platform
planetary_system_stacker-0.9.8.3-py3-none-macosx_10_6_intel.whl Python 3 none macOS 10.6+ Intel (x86-64, i386) Details

Release files / planetary_system_stacker-0.9.8.3-py3-none-macosx_10_6_intel.whl

Download URL planetary_system_stacker-0.9.8.3-py3-none-macosx_10_6_intel.whl
Size 232.4 kB
Tags Python 3 macOS 10.6+ Intel (x86-64, i386)
SHA-256 checksum
How to use checksums
020e550ebc2c5ee56e5be2239ef09fd57b551eeefaf1fc811fa6bcf0cf7ebff0
BLAKE2b-256 checksum
How to use checksums
c7446dff349efdbc8071790c93a5d42b0f030f50bcb93b6771a75bd964544e15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.5.4

Release history Release notifications | RSS feed

This release

0.9.8.3 This release

1 release file

0.9.8.2

1 release file

0.9.8.1

1 release file

0.9.6.3

1 release file

0.9.6.2

1 release file

0.9.6.1

1 release file

0.9.5.3

1 release file

0.9.5.2

1 release file

0.9.5.1

1 release file

0.9.4.3

1 release file

0.9.4.2

1 release file

0.9.4.1

1 release file

0.9.3.3

1 release file

0.9.3.2

1 release file

0.9.3.1

1 release file

0.9.1.3

1 release file

0.9.1.2

1 release file

0.9.1.1

1 release file

0.9.0.3

1 release file

0.9.0.2

1 release file

0.9.0.1

1 release file

0.8.29

3 release files

0.8.27

3 release files

0.8.26

3 release files

0.8.21

3 release files

0.8.20

3 release files

0.8.19

3 release files

0.8.17

3 release files

0.8.16

3 release files

0.8.14

3 release files

0.8.13

4 release files

0.8.12

4 release files

0.8.11

3 release files

0.8.10

3 release files

0.8.9

3 release files

0.8.8

3 release files

0.8.7

3 release files

0.8.6

3 release files

0.8.5

3 release files

0.8.4

3 release files

0.8.3

3 release files

0.8.2

3 release files

0.8.1

3 release files

0.8.0

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page