Skip to content

Latest commit

 

History

History
65 lines (44 loc) · 4.3 KB

README.md

File metadata and controls

65 lines (44 loc) · 4.3 KB

Butterfly Registrator

Animated screencapture of the Butterfly Registrator showing a control point of a moving image being moved to match that of a reference image, the registration being applied, and the sliding overlay preview being moved to compare the registered image with the reference image.
Registering an XRF element map to a color image¹

Animated screencapture of the Butterfly Registrator showing an XRF map dragged into the alphascale converter, the color picker selector being changed, and the save alphascale shown in the Butterfly Viewer.
Alphascale conversion of grayscale XRF element maps¹, then shown in Butterfly Viewer

Butterfly Registrator is a preprocessing app for aligning images using pairs of control points you click and drag. It helps you align (or register) images to a given reference such that their heights and widths match and the features within those images line up, making it easy to later overlay and compare them without the hassle of manually zooming, stretching, and cropping them beforehand.

The Registrator also creates alphascale images. You can convert individual grayscale images using a color picker and also merge multiple alphascale images into a single image.

The Registrator runs as an installable Windows executable or directly on its Python source code.

Most types of PNG, JPEG, and TIFF can be loaded into the Registrator. It can likewise save registered image files to PNG, JPEG, and TIFF.

With Butterfly Viewer you can rapidly compare your registered images with sliding overlays and synchronized side-by-side pan and zoom. The Viewer is handy for visually inspecting painting research data such as high-res and raking-light photos, X-rays, and element maps from XRF and RIS — especially with element maps converted to alphascale.

¹Small Pear Tree in Blossom by Vincent van Gogh (Van Gogh Museum, Amsterdam)

Key features

  • Side-by-side image previews to rapidly check the accuracy of registration and make adjustments before saving a copy.

  • Batch mode to apply the same registration to multiple images of the same capture/perspective, which is useful for registering element maps from scanning X-ray fluorescence (XRF) and reflectance imaging spectroscopy (RIS) to a ground truth like a color photograph.

  • Save registration control points to CSV to easily document and trace the images you register, and import later if you want to reproduce or adjust a registration.

How-to's

Our Butterfly Registrator page documents how to install and use the Registrator, as well how contribute to it as a developer.

Run on Python

Tutorial of main features

Help with common questions

Or see the source markdown file in the docs branch under docs/DEVELOPERS.md.