boofcv.alg.denoise.wavelet.SubbandShrink Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of boofcv-ip Show documentation

BoofCV is an open source Java library for real-time computer vision and robotics applications.

The newest version!

/*
 * Copyright (c) 2020, Peter Abeles. All Rights Reserved.
 *
 * This file is part of BoofCV (http://boofcv.org).
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package boofcv.alg.denoise.wavelet;

import boofcv.alg.denoise.DenoiseWavelet;
import boofcv.alg.denoise.ShrinkThresholdRule;
import boofcv.struct.image.ImageGray;

/**
 * Performs an adaptive threshold based wavelet shrinkage across each of the wavelet subbands in each
 * layer of the transformed image.
 *
 * @author Peter Abeles
 */
public abstract class SubbandShrink> implements DenoiseWavelet {

	// specifies how the threshold is applied to each pixel in the image
	protected ShrinkThresholdRule rule;

	protected SubbandShrink( ShrinkThresholdRule rule ) {
		this.rule = rule;
	}

	/**
	 * Compute the threshold for the specified subband.
	 *
	 * @param subband Subband whose threshold is being computed.
	 */
	protected abstract Number computeThreshold( I subband );

	/**
	 * Performs wavelet shrinking using the specified rule and by computing a threshold
	 * for each subband.
	 *
	 * @param transform The image being transformed.
	 * @param numLevels Number of levels in the transform.
	 */
	protected void performShrinkage( I transform, int numLevels ) {

		// step through each layer in the pyramid.
		for (int i = 0; i < numLevels; i++) {
			int w = transform.width;
			int h = transform.height;
			int ww = w/2;
			int hh = h/2;
			Number threshold;
			I subband;

			// HL
			subband = transform.subimage(ww, 0, w, hh, null);
			threshold = computeThreshold(subband);
			rule.process(subband, threshold);

//			System.out.print("HL = "+threshold);

			// LH
			subband = transform.subimage(0, hh, ww, h, null);
			threshold = computeThreshold(subband);
			rule.process(subband, threshold);

//			System.out.print("  LH = "+threshold);

			// HH
			subband = transform.subimage(ww, hh, w, h, null);
			threshold = computeThreshold(subband);
			rule.process(subband, threshold);

//			System.out.println("  HH = "+threshold);

			transform = transform.subimage(0, 0, ww, hh, null);
		}
	}
}