Wipe Module Use

Notes from users, documentation addendums.

Wipe Module Use

Postby Guy » Wed Nov 16, 2016 2:26 am


I have been compiling notes for myself regarding using the modules in StarTools, adding to it as I get more experience. I guess other people are doing the same. I thought that it might be useful to try and distil in one place any advice that people have found useful.

I have started with the notes I have - much of it compiled from Ivo's words of wisdom here in this forum. I've posted here notes on the Wipe Module. I will edit this as and when additions and corrections are reported.

Please let me know if anyone sees any errors, has any additional advice, or finds this useful.
To easily access similar notes on the other StarTools modules see StarTools Main Window Use.


Wipe Module

The description below is intended to help in getting good results. Please feel free to experiment - and provide feed back.

  • To remove background colour casts and gradients such as unwanted light (light pollution, moon, street lights), vignetting, amp glow and colour casts.
For a general overview see Wipe: Light Pollution, Vignetting and Gradient Removal.
Wipe flattens the field and removes gradients, Wipe also calibrates the background and removes bias in the colour channels. Note that this does not necessarily mean that the background becomes a nice neutral grey. Rather it makes sure that the background is luminance bias-free across all colour channels. Subsequent colour calibration will modify and neutralize the chrominance (colour) information.

Useful Sources
There is a good general description of the Wipe module in Wipe Usage.
The Unofficial guide is also a good source of help. It relates to version 1.3.5 so there may have been some changes. The notes below relate to StarTools version 1.4.
The processing tutorial video M8 in Color with modest data describes the Wipe module between 1m45s and 3m40s.
The video StarTools: Removing vignetting and complex gradients describes a more complicated use of the Wipe module.
The Hangout discussion of StarTools with Ivo discusses the Wipe module between about 0h20m and 0h32m.

When to use:
  • After using Initial AutoDev, Lens, Crop and Bin as needed.
  • Only use Wipe once - although you can use 'Undo' on main screen to immediately go back and redo the Wipe Module if you aren't happy with the results.
Example Workflow:
AutoDev-{Band/Lens}-Bin-Crop-Wipe-AutoDev(or Develop)-{Decon/Sharp/Contrast/HDR/Flux/Life}-Color-{Filter}-Denoise-{Layer/Magic/Heal/Repair/Synth}
Key: {...} optional modules

This is a way of using the module which should give good results in most cases:
  1. When doing the Initial AutoDev (initial global stretch):
    • Look at the image and see what sort of gradients you have. If the brightness drops away at the corners you have vignetting, If there is a general lightness in the background choose 'Gradient' If there is an intensity in a particular area - especially at the edge - you have 'Amp glow'.
    • Look for any stacking artefacts which need to be cropped out before using the Wipe module.
    • Look for any dust specks, dead pixels, trees, mountains etc. which will need to be masked out.
  2. After using the Crop module to remove any stacking artefacts, load the Wipe module.
  3. Set the mask to exclude the target, dust specks and other dark anomalies as described below:
    Mask - Clear - Lassoo around Dark Anomalies and Target as needed - Invert - Keep.
    KurtM_M8_WipeMask_qs.jpg (22.84 KiB) Viewed 2297 times
  4. Adjust the Dark Anomaly Filter to mask the effect of small Dark Anomalies (see below).
  5. Choose a preset which best describes what you are trying to achieve (see below). If there are multiple issues choose the most aggressive (i.e. Vignetting > Gradient > Color Cast).
  6. If the image isn't already stretched (or where doing the Wipe has made the image dark) you can use Temporary AutoDev (or Develop or AutoDev modules) to look for issues.
  7. Default values often work fine. Press 'Do'.
  8. If the result is not right, ensure the subject, dust specks, dead pixels, trees etc. are not included in the analysis by using a combination of Mask and Dark Anomaly Filter controls as described below.
  9. Adjust the 'Corner Aggressiveness' and 'Drop Off Point' only when there is Vignetting.
KurtM_M8_WipeResult_qs.jpg (33.07 KiB) Viewed 2297 times

What result to look for:
  • After applying Wipe the stretched image should have a uniform and dark background.
  • There should be no remaining background hue or colour cast. If there is check the masking and redo, and try increasing the Aggressiveness.
  • Look at the stretched image background for halos and other casts - this may be due to dark features such as dead pixels, dust, trees etc. which have not been removed. These can be removed using the Mask or Dark Anomaly Filter as described below.
  • If some detail has been wiped reduce the Aggressiveness.
  • If casts exist try increasing the Aggressiveness.
After use:
  • The Wipe module should make the background darker. It is important to redo the global stretch (using Develop or AutoDev) to take advantage of the extra dynamic range made available.
Ways of getting better results:
  • Use Flats when stacking so that the Vignetting, dust specks, etc. will have already been accurately compensated for. This will simplify the Wipe to work specifically on light gradients.
  • If Wipe does not reduce the colour cast well it may be that the image has a lot of noise. In this case, increasing the Dark Anomaly filter can make a difference.
Special Techniques:

Masking out flaws (e.g. dust or artefacts) that were hidden before running Wipe
See the full description in the topic Wipe module - editing mask.
  • Use the Wipe module as normal and 'Keep' the flawed result.
  • Use the 'Mask' button on the main screen to edit the mask to exclude the newly highlighted flaws.
  • Crop any remaining stacking artifacts.
  • Use the 'Restore' button on the main screen - select 'Original' - this reverts to the Original (Linear, Binned & Cropped) image.
  • Use the Wipe module as normal - which now uses the updated mask.
Description of Controls:
The following buttons pre-set the control settings to values most suited to the intended purpose:
  • Gradient - gradual changes in background light level across the image - e.g. from light pollution or the moon.
  • Vignetting - for removing any background light level that falls away at the corners - use flats instead if you can.
  • Color Cast - for removing any tint of a particular colour affecting the whole image evenly.
  • Amp Glow - a brightness normally at one edge of the image due to an uneven heating effect from the camera electronics.
For general instructions on using masks see Mask.
  • Mask out (make non-green) the main subject and any dust specks, mountains, trees etc, using the 'Lassoo' Brush Mode.
    This will stop Wipe trying to use them in analysing how to wipe the image - the whole image will still be wiped.
  • If using the 'Amp Glow' preset - select (make green) the pixels that are affected by amp glow.
  • You must use Develop or AutoDev to bring out the image details before using Wipe if you want to see them in the Mask. Temporary AutoDev does not affect the Mask.
This specifies the kind of gradients removed by Wipe:
  • Correct Color and Brightness - use for dealing with Vignetting, Gradient and Amp glow.
  • Correct Color Only - select if only interested in removing uniform colour casts.
  • Correct Brightness Only - can be used if color absolutely needs to be retained. This can be useful when processing narrowband data, or data that was not acquired on earth.
  • Default is 'Correct Color and Brightness'.
Temporary AutoDev
This does a temporary stretch to show approximately what the (Auto)Developed image will look like.
  • This is helpful if the image isn't already stretched, or where doing the Wipe has made the image dark.
Sets how aggressive Wipe should be:
  • Wipe searches for a constant background level of brightness around each pixel in the image - the search area is governed by the 'Aggressiveness' setting - the higher the value the smaller the area searched to establish the background level. See the description in the topic Wipe feature - when to use Mask.
  • Default is 75% for Gradient and Vignetting preset, 0% for Color Cast, and 98% for Amp Glow presets.
  • Change if gradients remain - up to 95% in extreme cases. Reduce from the default if detail is being wiped.
Corner Aggressiveness
Sets how much to increase gradient removal aggressiveness in the corners.
  • Range is 0% to 100%.
  • Defaults to 100% - comes into effect When 'Drop off Point' is less than 100% - i.e. use for removing vignetting.
  • Normally the default (100%) is fine. Change from default (100%) if the background level in the corners is different from that in the centre. Should need only to reduce it by 1 or 2%.
Drop Off Point:
Defines the point from the centre at which the 'Corner Aggressiveness' factor comes into effect.
  • Range is 0% to 100%.
  • Defaults is 100% unless using the 'Vignetting' preset when the default is 0%.
  • Change from default (0% when removing vignetting) if the background levels show uneven rings about the centre.
  • Leave at 100% except when removing vignetting - Reduce from 100% (to 0% or thereabouts) to allow the 'Corner Aggressiveness' setting to apply as you move out to the corners.
Defines the image 'resolution' that Wipe uses when analysing the image prior to wiping.
  • Range is 128x128, 256x256, 512x512, 1024x1024 or 2048x2048.
  • Default is 256x256 pixels for Gradient and Vignetting presets, 128x128 for Color Cast and 512x512 for Amp Glow.
  • Change from the default to a larger number if the image has rapidly changing gradients and some background gradient has not been compensated for.
Dark Anomaly Filter:
Use this to stop dark spots in the image (such as dead pixels, small dust specks and small scratches) affecting the Wipe.
  • Default is 1 pixel. Range is 'Off'(0) to 30 pixels.
  • Set to the size of the dark area. Larger dark areas (including larger dust specks) should be deselected using the mask instead.
  • Try Increasing to 2-10 pixels - look at the effect - continue until no further benefit.

Background Notes

Dark Anomalies
Every night sky image that is still linear has a minimum background light level caused by the sky glow.
This is represented by a certain pixel value. If there are pixels with values below this then they don't represent something in the sky.
These values are either caused by hot or stuck pixels, dust or scratches, noise, or something terrestrial like a tree or mountain.
StarTools calls these Dark Anomalies.

Dark Anomaly Filter and Mask
Wipe tries to find this background level so as to identify the minimum and maximum pixel values that represent light from the sky.
Dark Anomalies are dips below the minimum level which would cause Wipe to set an artificially low background level.
In order for StarTools to find the correct background level it uses two methods to identify and ignore Dark Anomalies
  • Mask - Larger Dark Anomalies, such as mountains or trees, as well as dust bunnies can be identified using a Mask.
  • Dark Anomaly Filter - The Dark Anomaly Filter lets Wipe automatically ignore small clusters of pixels with very low values when deciding the background level. The value of the Dark Anomaly Filter sets the maximum pixel cluster size that will be ignored. Set to 1 pixel to ignore single pixels such as cold or stuck pixels. Set higher to ignore clusters caused by noise or small dust specks or scratches.
Posts: 93
Joined: Thu Feb 19, 2015 8:35 am

Return to User Notes

Who is online

Users browsing this forum: No registered users and 1 guest