Skip to main content

ApertureSynth is a command line tool for registering and combining multiple photographs to form a single photograph with better properties. It can be used to:

  1. Reduce noise by averaging, even in handheld photos.

  2. Simulate a longer exposure than would otherwise be possible using a handheld camera.

  3. Control the location of the focal plane, including tilt shift effects (though further optimisation is needed to handle this nicely.)

Note that aperturesynth is currently experimental and is definitely to be used at your own risk.

Usage

  1. Take a series of photos in burst mode.

  2. If shooting in raw format, convert the raw files into a format handled by PIL, such as png, tiff or jpeg. Note that it’s best to avoid noise reduction and sharpening at this point. You might have a series of photos 1.png, 2.png, 3.png.

  3. Run the command line application on the series of photographs

    aperturesynth combine --out fused.tiff 1.png 2.png 3.png

    This will fuse the three png images and save the result to fused.tiff. The file 1.png will be the baseline image used to register 2.png and 3.png.

  4. The baseline image (1.png) will appear in a window. Indicate the in focus regions by selecting the top left and bottom right of each rectangular focal patch. Consecutive pairs of points define each rectangular window, the last point of an odd number of points will be ignored. You can right click to undo a selection.

  5. Press enter when done to begin the fusion process.

For additional help and to see all the options run:

aperturesynth --help

Installation

This software is written in Python, and currently requires a working Python implementation to run. If you have a working Python installation you should be able to install aperturesynth by running:

pip install aperturesynth

Alternatively you can install from source. First clone the project from the website using fossil ` <https://hames.id.au/software/aperturesynth>`__, then run the setup.py in the root directory to install the file.

fossil clone https://hames.id.au/software/aperturesynth aperturesynth.fossil
mkdir aperturesynth; cd aperturesynth
fossil open ../aperturesynth.fossil
python setup.py install

Either of these options should result in the installation of a commandline tool called aperturesynth.

Changes

0.0.2

  • The type of transform is now chosen based on the number of focal regions specified. This allows registration of only one or two points, instead of always requiring three or more.

  • The commandline syntax has changed to allow multiple subcommands, including a new way of saving and loading the focal region locations to/from a file.

0.0.1

  • Initial proof of concept.

Release files for aperturesynth 0.0.2

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

Source distribution (sdist)

Source distribution for aperturesynth 0.0.2
File Size Uploaded
aperturesynth-0.0.2.tar.gz 6.7 kB Details

Release files / aperturesynth-0.0.2.tar.gz

Download URL aperturesynth-0.0.2.tar.gz
Size 6.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4dd63a3ff38ed30c1b0bd6d5e76645ef12ee0c5221d01144f4ec623eb90be66b
BLAKE2b-256 checksum
How to use checksums
c63716503737594cb5a1f7a7b8e4e879e24d72049dba5b6dd5b849b652511dce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.2 This release

1 release file

0.0.1

1 release file

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