Skip to main content

a package to stack images for many purposes

Project description

kzstack

kzstack is a package to stack images for many purposes.

There are many use cases, but it is especially important in long-exposure photography and astrophotography.

PyPI Downloads PyPI version

Author: Kevin Zhu

Features

  • ability to stack images
  • gamma correction accounted for
  • custom quality / denoising functions
  • image showing / saving
  • bias usage

Installation

To install kzstack, use pip: pip install kzstack.

However, many prefer to use a virtual environment.

macOS / Linux:

# make your desired directory
mkdir /path/to/your/directory
cd /path/to/your/directory

# setup the .venv (or whatever you want to name it)
pip install virtualenv
python3 -m venv .venv

# install kzstack
source .venv/bin/activate
pip install kzstack

deactivate # when you are completely done

Windows CMD:

# make your desired directory
mkdir C:path\to\your\directory
cd C:path\to\your\directory

# setup the .venv (or whatever you want to name it)
pip install virtualenv
python3 -m venv .venv

# install kzstack
.venv\Scripts\activate
pip install kzstack

deactivate # when you are completely done

Usage

PLEASE HAVE ALIGNED IMAGES!! STACKING WILL NOT TURN OUT GOOD OTHERWISE

First, import KZStack and all its functions (for denoising / quality).

Follow the provided stack_accumualte.ipynb for your data (change the path).

After, you may choose to use the average or input your own denoising / quality control functions.

These must be in the format of def func(image), without additional parameters. Other parameters (like a threshold) should not be args to the function.

License

The License is an MIT License found in the LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kzstack-1.0.2.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kzstack-1.0.2-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file kzstack-1.0.2.tar.gz.

File metadata

  • Download URL: kzstack-1.0.2.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.0

File hashes

Hashes for kzstack-1.0.2.tar.gz
Algorithm Hash digest
SHA256 e8721915bcc4f9b75183cb2681a6d44e9df6dfc5b64cb993eef0af08299b4349
MD5 1698e8701ffbb7c7eccdf681763ba09e
BLAKE2b-256 208d5a705c500c652b0c81687498807851106a2dce99b6a98c2cf1dbe7b3beac

See more details on using hashes here.

File details

Details for the file kzstack-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: kzstack-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.0

File hashes

Hashes for kzstack-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 434e56b873c2a81fe690e0606c71ef8198d92552a02dfb74479986b07295c9aa
MD5 411ba744856cc8150d5e2f4d49b574ae
BLAKE2b-256 7f1b36a45a5015965845fd552d8665946982bc159393ef922ef1d4c83631f3bb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page