Package net.algart.matrices.morphology

Enum Class RankPrecision

java.lang.Object

java.lang.Enum<RankPrecision>

net.algart.matrices.morphology.RankPrecision

All Implemented Interfaces:

Serializable, Comparable<RankPrecision>, Constable, CustomRankPrecision

public enum RankPrecision
extends Enum<RankPrecision>
implements CustomRankPrecision

Some predefined precision characteristics of rank operations, described in RankMorphology interface.

Note: for every bit levels array, represented by this enum, there are both instances of this class with interpolated()==false and with interpolated()==true.

This class is immutable and thread-safe: there are no ways to modify settings of the created instance.

Author:

Daniel Alievsky

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
BITS_1	Here bitLevels()={1}, interpolated()=false.
BITS_1_INTERPOLATED	Here bitLevels()={1}, interpolated()=true.
BITS_10	Here bitLevels()={10}, interpolated()=false.
BITS_10_INTERPOLATED	Here bitLevels()={10}, interpolated()=true.
BITS_10_PER_5	Here bitLevels()={5, 10}, interpolated()=false.
BITS_10_PER_5_INTERPOLATED	Here bitLevels()={5, 10}, interpolated()=true.
BITS_11	Here bitLevels()={11}, interpolated()=false.
BITS_11_INTERPOLATED	Here bitLevels()={11}, interpolated()=true.
BITS_11_PER_5	Here bitLevels()={5, 11}, interpolated()=false.
BITS_11_PER_5_INTERPOLATED	Here bitLevels()={5, 11}, interpolated()=true.
BITS_12	Here bitLevels()={12}, interpolated()=false.
BITS_12_INTERPOLATED	Here bitLevels()={12}, interpolated()=true.
BITS_12_PER_4	Here bitLevels()={4, 8, 12}, interpolated()=false.
BITS_12_PER_4_INTERPOLATED	Here bitLevels()={4, 8, 12}, interpolated()=true.
BITS_12_PER_6	Here bitLevels()={6, 12}, interpolated()=false.
BITS_12_PER_6_INTERPOLATED	Here bitLevels()={6, 12}, interpolated()=true.
BITS_13	Here bitLevels()={13}, interpolated()=false.
BITS_13_INTERPOLATED	Here bitLevels()={13}, interpolated()=true.
BITS_13_PER_6	Here bitLevels()={6, 13}, interpolated()=false.
BITS_13_PER_6_INTERPOLATED	Here bitLevels()={6, 13}, interpolated()=true.
BITS_14	Here bitLevels()={14}, interpolated()=false.
BITS_14_INTERPOLATED	Here bitLevels()={14}, interpolated()=true.
BITS_14_PER_7	Here bitLevels()={7, 14}, interpolated()=false.
BITS_14_PER_7_INTERPOLATED	Here bitLevels()={7, 14}, interpolated()=true.
BITS_15	Here bitLevels()={15}, interpolated()=false.
BITS_15_INTERPOLATED	Here bitLevels()={15}, interpolated()=true.
BITS_15_PER_5	Here bitLevels()={5, 10, 15}, interpolated()=false.
BITS_15_PER_5_INTERPOLATED	Here bitLevels()={5, 10, 15}, interpolated()=true.
BITS_15_PER_7	Here bitLevels()={7, 15}, interpolated()=false.
BITS_15_PER_7_INTERPOLATED	Here bitLevels()={7, 15}, interpolated()=true.
BITS_16	Here bitLevels()={16}, interpolated()=false.
BITS_16_INTERPOLATED	Here bitLevels()={16}, interpolated()=true.
BITS_16_PER_5	Here bitLevels()={5, 10, 16}, interpolated()=false.
BITS_16_PER_5_INTERPOLATED	Here bitLevels()={5, 10, 16}, interpolated()=true.
BITS_16_PER_8	Here bitLevels()={8, 16}, interpolated()=false.
BITS_16_PER_8_INTERPOLATED	Here bitLevels()={8, 16}, interpolated()=true.
BITS_2	Here bitLevels()={2}, interpolated()=false.
BITS_2_INTERPOLATED	Here bitLevels()={2}, interpolated()=true.
BITS_20	Here bitLevels()={20}, interpolated()=false.
BITS_20_INTERPOLATED	Here bitLevels()={20}, interpolated()=true.
BITS_20_PER_10	Here bitLevels()={10, 20}, interpolated()=false.
BITS_20_PER_10_INTERPOLATED	Here bitLevels()={10, 20}, interpolated()=true.
BITS_20_PER_5	Here bitLevels()={5, 10, 15, 20}, interpolated()=false.
BITS_20_PER_5_INTERPOLATED	Here bitLevels()={5, 10, 15, 20}, interpolated()=true.
BITS_20_PER_7	Here bitLevels()={6, 13, 20}, interpolated()=false.
BITS_20_PER_7_INTERPOLATED	Here bitLevels()={6, 13, 20}, interpolated()=true.
BITS_22	Here bitLevels()={22}, interpolated()=false.
BITS_22_INTERPOLATED	Here bitLevels()={22}, interpolated()=true.
BITS_22_PER_11	Here bitLevels()={11, 22}, interpolated()=false.
BITS_22_PER_11_INTERPOLATED	Here bitLevels()={11, 22}, interpolated()=true.
BITS_22_PER_5	Here bitLevels()={5, 10, 15, 22}, interpolated()=false.
BITS_22_PER_5_INTERPOLATED	Here bitLevels()={5, 10, 15, 22}, interpolated()=true.
BITS_22_PER_7	Here bitLevels()={7, 14, 22}, interpolated()=false.
BITS_22_PER_7_INTERPOLATED	Here bitLevels()={7, 14, 22}, interpolated()=true.
BITS_24	Here bitLevels()={24}, interpolated()=false.
BITS_24_INTERPOLATED	Here bitLevels()={24}, interpolated()=true.
BITS_24_PER_12	Here bitLevels()={12, 24}, interpolated()=false.
BITS_24_PER_12_INTERPOLATED	Here bitLevels()={12, 24}, interpolated()=true.
BITS_24_PER_4	Here bitLevels()={4, 8, 12, 16, 20, 24}, interpolated()=false.
BITS_24_PER_4_INTERPOLATED	Here bitLevels()={4, 8, 12, 16, 20, 24}, interpolated()=true.
BITS_24_PER_6	Here bitLevels()={6, 12, 18, 24}, interpolated()=false.
BITS_24_PER_6_INTERPOLATED	Here bitLevels()={6, 12, 18, 24}, interpolated()=true.
BITS_24_PER_8	Here bitLevels()={8, 16, 24}, interpolated()=false.
BITS_24_PER_8_INTERPOLATED	Here bitLevels()={8, 16, 24}, interpolated()=true.
BITS_26	Here bitLevels()={26}, interpolated()=false.
BITS_26_INTERPOLATED	Here bitLevels()={26}, interpolated()=true.
BITS_26_PER_13	Here bitLevels()={13, 26}, interpolated()=false.
BITS_26_PER_13_INTERPOLATED	Here bitLevels()={13, 26}, interpolated()=true.
BITS_26_PER_6	Here bitLevels()={6, 12, 18, 26}, interpolated()=false.
BITS_26_PER_6_INTERPOLATED	Here bitLevels()={6, 12, 18, 26}, interpolated()=true.
BITS_26_PER_8	Here bitLevels()={8, 16, 26}, interpolated()=false.
BITS_26_PER_8_INTERPOLATED	Here bitLevels()={8, 16, 26}, interpolated()=true.
BITS_3	Here bitLevels()={3}, interpolated()=false.
BITS_3_INTERPOLATED	Here bitLevels()={3}, interpolated()=true.
BITS_4	Here bitLevels()={4}, interpolated()=false.
BITS_4_INTERPOLATED	Here bitLevels()={4}, interpolated()=true.
BITS_5	Here bitLevels()={5}, interpolated()=false.
BITS_5_INTERPOLATED	Here bitLevels()={5}, interpolated()=true.
BITS_6	Here bitLevels()={6}, interpolated()=false.
BITS_6_INTERPOLATED	Here bitLevels()={6}, interpolated()=true.
BITS_7	Here bitLevels()={7}, interpolated()=false.
BITS_7_INTERPOLATED	Here bitLevels()={7}, interpolated()=true.
BITS_8	Here bitLevels()={8}, interpolated()=false.
BITS_8_INTERPOLATED	Here bitLevels()={8}, interpolated()=true.
BITS_8_PER_4	Here bitLevels()={4, 8}, interpolated()=false.
BITS_8_PER_4_INTERPOLATED	Here bitLevels()={4, 8}, interpolated()=true.
BITS_9	Here bitLevels()={9}, interpolated()=false.
BITS_9_INTERPOLATED	Here bitLevels()={9}, interpolated()=true.

Field Summary

Fields inherited from interface net.algart.matrices.morphology.CustomRankPrecision

MAX_NUMBER_OF_ANALYZED_BITS

Method Summary

Modifier and Type	Method	Description
int[]	bitLevels()	The bit levels.
boolean	interpolated()	Selects the histogram model used while calculating rank characteristics: true means the precise histogram model, false means the simple histogram model.
int	numberOfAnalyzedBits()	Returns the last element of the CustomRankPrecision.bitLevels() array.
RankPrecision	otherInterpolation(boolean interpolated)	Returns the enum instance with the same bit levels and with the specified "interpolated" flag.
static RankPrecision	valueOf(String name)	Returns the enum constant of this class with the specified name.
static RankPrecision[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

BITS_1

public static final RankPrecision BITS_1

Here bitLevels()={1}, interpolated()=false.

BITS_1_INTERPOLATED

public static final RankPrecision BITS_1_INTERPOLATED

Here bitLevels()={1}, interpolated()=true.

BITS_2

public static final RankPrecision BITS_2

Here bitLevels()={2}, interpolated()=false.

BITS_2_INTERPOLATED

public static final RankPrecision BITS_2_INTERPOLATED

Here bitLevels()={2}, interpolated()=true.

BITS_3

public static final RankPrecision BITS_3

Here bitLevels()={3}, interpolated()=false.

BITS_3_INTERPOLATED

public static final RankPrecision BITS_3_INTERPOLATED

Here bitLevels()={3}, interpolated()=true.

BITS_4

public static final RankPrecision BITS_4

Here bitLevels()={4}, interpolated()=false.

BITS_4_INTERPOLATED

public static final RankPrecision BITS_4_INTERPOLATED

Here bitLevels()={4}, interpolated()=true.

BITS_5

public static final RankPrecision BITS_5

Here bitLevels()={5}, interpolated()=false.

BITS_5_INTERPOLATED

public static final RankPrecision BITS_5_INTERPOLATED

Here bitLevels()={5}, interpolated()=true.

BITS_6

public static final RankPrecision BITS_6

Here bitLevels()={6}, interpolated()=false.

BITS_6_INTERPOLATED

public static final RankPrecision BITS_6_INTERPOLATED

Here bitLevels()={6}, interpolated()=true.

BITS_7

public static final RankPrecision BITS_7

Here bitLevels()={7}, interpolated()=false.

BITS_7_INTERPOLATED

public static final RankPrecision BITS_7_INTERPOLATED

Here bitLevels()={7}, interpolated()=true.

BITS_8

public static final RankPrecision BITS_8

Here bitLevels()={8}, interpolated()=false.

BITS_8_INTERPOLATED

public static final RankPrecision BITS_8_INTERPOLATED

Here bitLevels()={8}, interpolated()=true.

BITS_8_PER_4

public static final RankPrecision BITS_8_PER_4

Here bitLevels()={4, 8}, interpolated()=false.

BITS_8_PER_4_INTERPOLATED

public static final RankPrecision BITS_8_PER_4_INTERPOLATED

Here bitLevels()={4, 8}, interpolated()=true.

BITS_9

public static final RankPrecision BITS_9

Here bitLevels()={9}, interpolated()=false.

BITS_9_INTERPOLATED

public static final RankPrecision BITS_9_INTERPOLATED

Here bitLevels()={9}, interpolated()=true.

BITS_10

public static final RankPrecision BITS_10

Here bitLevels()={10}, interpolated()=false.

BITS_10_INTERPOLATED

public static final RankPrecision BITS_10_INTERPOLATED

Here bitLevels()={10}, interpolated()=true.

BITS_10_PER_5

public static final RankPrecision BITS_10_PER_5

Here bitLevels()={5, 10}, interpolated()=false.

BITS_10_PER_5_INTERPOLATED

public static final RankPrecision BITS_10_PER_5_INTERPOLATED

Here bitLevels()={5, 10}, interpolated()=true.

BITS_11

public static final RankPrecision BITS_11

Here bitLevels()={11}, interpolated()=false.

BITS_11_INTERPOLATED

public static final RankPrecision BITS_11_INTERPOLATED

Here bitLevels()={11}, interpolated()=true.

BITS_11_PER_5

public static final RankPrecision BITS_11_PER_5

Here bitLevels()={5, 11}, interpolated()=false.

BITS_11_PER_5_INTERPOLATED

public static final RankPrecision BITS_11_PER_5_INTERPOLATED

Here bitLevels()={5, 11}, interpolated()=true.

BITS_12

public static final RankPrecision BITS_12

Here bitLevels()={12}, interpolated()=false.

BITS_12_INTERPOLATED

public static final RankPrecision BITS_12_INTERPOLATED

Here bitLevels()={12}, interpolated()=true.

BITS_12_PER_6

public static final RankPrecision BITS_12_PER_6

Here bitLevels()={6, 12}, interpolated()=false.

BITS_12_PER_6_INTERPOLATED

public static final RankPrecision BITS_12_PER_6_INTERPOLATED

Here bitLevels()={6, 12}, interpolated()=true.

BITS_12_PER_4

public static final RankPrecision BITS_12_PER_4

Here bitLevels()={4, 8, 12}, interpolated()=false.

BITS_12_PER_4_INTERPOLATED

public static final RankPrecision BITS_12_PER_4_INTERPOLATED

Here bitLevels()={4, 8, 12}, interpolated()=true.

BITS_13

public static final RankPrecision BITS_13

Here bitLevels()={13}, interpolated()=false.

BITS_13_INTERPOLATED

public static final RankPrecision BITS_13_INTERPOLATED

Here bitLevels()={13}, interpolated()=true.

BITS_13_PER_6

public static final RankPrecision BITS_13_PER_6

Here bitLevels()={6, 13}, interpolated()=false.

BITS_13_PER_6_INTERPOLATED

public static final RankPrecision BITS_13_PER_6_INTERPOLATED

Here bitLevels()={6, 13}, interpolated()=true.

BITS_14

public static final RankPrecision BITS_14

Here bitLevels()={14}, interpolated()=false.

BITS_14_INTERPOLATED

public static final RankPrecision BITS_14_INTERPOLATED

Here bitLevels()={14}, interpolated()=true.

BITS_14_PER_7

public static final RankPrecision BITS_14_PER_7

Here bitLevels()={7, 14}, interpolated()=false.

BITS_14_PER_7_INTERPOLATED

public static final RankPrecision BITS_14_PER_7_INTERPOLATED

Here bitLevels()={7, 14}, interpolated()=true.

BITS_15

public static final RankPrecision BITS_15

Here bitLevels()={15}, interpolated()=false.

BITS_15_INTERPOLATED

public static final RankPrecision BITS_15_INTERPOLATED

Here bitLevels()={15}, interpolated()=true.

BITS_15_PER_7

public static final RankPrecision BITS_15_PER_7

Here bitLevels()={7, 15}, interpolated()=false.

BITS_15_PER_7_INTERPOLATED

public static final RankPrecision BITS_15_PER_7_INTERPOLATED

Here bitLevels()={7, 15}, interpolated()=true.

BITS_15_PER_5

public static final RankPrecision BITS_15_PER_5

Here bitLevels()={5, 10, 15}, interpolated()=false.

BITS_15_PER_5_INTERPOLATED

public static final RankPrecision BITS_15_PER_5_INTERPOLATED

Here bitLevels()={5, 10, 15}, interpolated()=true.

BITS_16

public static final RankPrecision BITS_16

Here bitLevels()={16}, interpolated()=false.

BITS_16_INTERPOLATED

public static final RankPrecision BITS_16_INTERPOLATED

Here bitLevels()={16}, interpolated()=true.

BITS_16_PER_8

public static final RankPrecision BITS_16_PER_8

Here bitLevels()={8, 16}, interpolated()=false.

BITS_16_PER_8_INTERPOLATED

public static final RankPrecision BITS_16_PER_8_INTERPOLATED

Here bitLevels()={8, 16}, interpolated()=true.

BITS_16_PER_5

public static final RankPrecision BITS_16_PER_5

Here bitLevels()={5, 10, 16}, interpolated()=false.

BITS_16_PER_5_INTERPOLATED

public static final RankPrecision BITS_16_PER_5_INTERPOLATED

Here bitLevels()={5, 10, 16}, interpolated()=true.

BITS_20

public static final RankPrecision BITS_20

Here bitLevels()={20}, interpolated()=false.

BITS_20_INTERPOLATED

public static final RankPrecision BITS_20_INTERPOLATED

Here bitLevels()={20}, interpolated()=true.

BITS_20_PER_10

public static final RankPrecision BITS_20_PER_10

Here bitLevels()={10, 20}, interpolated()=false.

BITS_20_PER_10_INTERPOLATED

public static final RankPrecision BITS_20_PER_10_INTERPOLATED

Here bitLevels()={10, 20}, interpolated()=true.

BITS_20_PER_7

public static final RankPrecision BITS_20_PER_7

Here bitLevels()={6, 13, 20}, interpolated()=false.

BITS_20_PER_7_INTERPOLATED

public static final RankPrecision BITS_20_PER_7_INTERPOLATED

Here bitLevels()={6, 13, 20}, interpolated()=true.

BITS_20_PER_5

public static final RankPrecision BITS_20_PER_5

Here bitLevels()={5, 10, 15, 20}, interpolated()=false.

BITS_20_PER_5_INTERPOLATED

public static final RankPrecision BITS_20_PER_5_INTERPOLATED

Here bitLevels()={5, 10, 15, 20}, interpolated()=true.

BITS_22

public static final RankPrecision BITS_22

Here bitLevels()={22}, interpolated()=false.

BITS_22_INTERPOLATED

public static final RankPrecision BITS_22_INTERPOLATED

Here bitLevels()={22}, interpolated()=true.

BITS_22_PER_11

public static final RankPrecision BITS_22_PER_11

Here bitLevels()={11, 22}, interpolated()=false.

BITS_22_PER_11_INTERPOLATED

public static final RankPrecision BITS_22_PER_11_INTERPOLATED

Here bitLevels()={11, 22}, interpolated()=true.

BITS_22_PER_7

public static final RankPrecision BITS_22_PER_7

Here bitLevels()={7, 14, 22}, interpolated()=false.

BITS_22_PER_7_INTERPOLATED

public static final RankPrecision BITS_22_PER_7_INTERPOLATED

Here bitLevels()={7, 14, 22}, interpolated()=true.

BITS_22_PER_5

public static final RankPrecision BITS_22_PER_5

Here bitLevels()={5, 10, 15, 22}, interpolated()=false.

BITS_22_PER_5_INTERPOLATED

public static final RankPrecision BITS_22_PER_5_INTERPOLATED

Here bitLevels()={5, 10, 15, 22}, interpolated()=true.

BITS_24

public static final RankPrecision BITS_24

Here bitLevels()={24}, interpolated()=false.

BITS_24_INTERPOLATED

public static final RankPrecision BITS_24_INTERPOLATED

Here bitLevels()={24}, interpolated()=true.

BITS_24_PER_12

public static final RankPrecision BITS_24_PER_12

Here bitLevels()={12, 24}, interpolated()=false.

BITS_24_PER_12_INTERPOLATED

public static final RankPrecision BITS_24_PER_12_INTERPOLATED

Here bitLevels()={12, 24}, interpolated()=true.

BITS_24_PER_8

public static final RankPrecision BITS_24_PER_8

Here bitLevels()={8, 16, 24}, interpolated()=false.

BITS_24_PER_8_INTERPOLATED

public static final RankPrecision BITS_24_PER_8_INTERPOLATED

Here bitLevels()={8, 16, 24}, interpolated()=true.

BITS_24_PER_6

public static final RankPrecision BITS_24_PER_6

Here bitLevels()={6, 12, 18, 24}, interpolated()=false.

BITS_24_PER_6_INTERPOLATED

public static final RankPrecision BITS_24_PER_6_INTERPOLATED

Here bitLevels()={6, 12, 18, 24}, interpolated()=true.

BITS_24_PER_4

public static final RankPrecision BITS_24_PER_4

Here bitLevels()={4, 8, 12, 16, 20, 24}, interpolated()=false.

BITS_24_PER_4_INTERPOLATED

public static final RankPrecision BITS_24_PER_4_INTERPOLATED

Here bitLevels()={4, 8, 12, 16, 20, 24}, interpolated()=true.

BITS_26

public static final RankPrecision BITS_26

Here bitLevels()={26}, interpolated()=false.

BITS_26_INTERPOLATED

public static final RankPrecision BITS_26_INTERPOLATED

Here bitLevels()={26}, interpolated()=true.

BITS_26_PER_13

public static final RankPrecision BITS_26_PER_13

Here bitLevels()={13, 26}, interpolated()=false.

BITS_26_PER_13_INTERPOLATED

public static final RankPrecision BITS_26_PER_13_INTERPOLATED

Here bitLevels()={13, 26}, interpolated()=true.

BITS_26_PER_8

public static final RankPrecision BITS_26_PER_8

Here bitLevels()={8, 16, 26}, interpolated()=false.

BITS_26_PER_8_INTERPOLATED

public static final RankPrecision BITS_26_PER_8_INTERPOLATED

Here bitLevels()={8, 16, 26}, interpolated()=true.

BITS_26_PER_6

public static final RankPrecision BITS_26_PER_6

Here bitLevels()={6, 12, 18, 26}, interpolated()=false.

BITS_26_PER_6_INTERPOLATED

public static final RankPrecision BITS_26_PER_6_INTERPOLATED

Here bitLevels()={6, 12, 18, 26}, interpolated()=true.

Method Details

values

public static RankPrecision[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static RankPrecision valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

bitLevels

public int[] bitLevels()

Description copied from interface: CustomRankPrecision

The bit levels. (Here and below we shall designate this array as bitLevels.)

The last element of this array bitLevels[bitLevels.length-1] is named the number of analysed bits and specifies the logarithm of the length of the histogram, used while calculating rank characteristics. More precisely, the length of the histogram is M=2^μ, where μ = bitLevels[bitLevels.length-1] for floating-point matrix elements or μ = min(bitLevels[bitLevels.length-1], β) for fixed-point matrix elements, β = M.array().bitsPerElement(). See more details in comments to RankMorphology interface, section 3.

First bitLevels.length-1 elements of this array, i.e. JArrays.copyOfRange(bitLevels,0,bitLevels.length-1), are passed as bitLevelsOfPyramid argument of Histogram.newIntHistogram or SummingHistogram.newSummingIntHistogram methods, when they are called for creating objects, which really calculate the rank characteristics, described in RankMorphology interface. In other words, first bitLevels.length-1 elements describe the levels of the pyramid of histograms: it is necessary for efficient processing large histograms, consisting of thousands or millions bars.

This array must not be empty and must not contain more than 31 elements, and all its elements must be sorted in strictly increasing order: bitLevels[k]<bitLevels[k+1] for all k. The elements of this array must not exceed CustomRankPrecision.MAX_NUMBER_OF_ANALYZED_BITS limit.

Below are possible examples of the array, returned by this method:

• {8} — the rank operations will be performed with a simple histogram, consisting of 256 bars; this precision is enough for byte matrices, but usually too low for short, int or floating-point matrices;
• {6, 12} — the rank operations will be performed with a two-level pyramid of histograms, consisting of 4096 bars (or min(4096,2^β)=256 for byte matrices), which will be grouped by 64 bars into "wide" bars of the 2nd level; such a precision is enough for many application;
• {8, 16, 24} — the rank operations will be performed with a three-level pyramid of histograms, consisting of 2²⁴=16777216 bars (or min(2²⁴,2^β)=256 or 65636 for byte or short/char matrices), which will be grouped by 256 bars into "wide" bars of the 2nd level and by 65536 bars into "wide" bars of the 3rd levels; this precision is good for most applications;
• {12, 24} — the rank operations will be performed with a two-level pyramid of histograms, consisting of 2²⁴=16777216 bars (or min(2²⁴,2^β)=256 or 65636 for byte or short/char matrices), which will be grouped by 4096 bars into "wide" bars of the 2nd level; this precision is equivalent to the previous example, but usually provides better performance.

Note that the situation, when some or even all elements of this array are greater than 2^β, is not an error — it just will lead to unjustified slowing down of calculations, because some levels of the pyramid of histograms will contain only 1 "wide" bar.

Specified by:

bitLevels in interface CustomRankPrecision

Returns:

bit levels of the pyramid of histograms (all elements excepting the last one) and the maximal possible total number of analyzed bits μ=log₂(histogram length) (the last element of this array).

See Also:

• CustomRankPrecision.numberOfAnalyzedBits()

numberOfAnalyzedBits

public int numberOfAnalyzedBits()

Description copied from interface: CustomRankPrecision

Returns the last element of the CustomRankPrecision.bitLevels() array.

Specified by:

numberOfAnalyzedBits in interface CustomRankPrecision

Returns:

the maximal possible total number of analyzed bits μ=log₂(histogram length).

interpolated

public boolean interpolated()

Description copied from interface: CustomRankPrecision

Selects the histogram model used while calculating rank characteristics: true means the precise histogram model, false means the simple histogram model. See comments to Histogram and SummingHistogram classes about these models.

Specified by:

interpolated in interface CustomRankPrecision

Returns:

whether the rank operations should be performed in the precise histogram model.

otherInterpolation

public RankPrecision otherInterpolation(boolean interpolated)

Returns the enum instance with the same bit levels and with the specified "interpolated" flag.

If the argument is equal to the current result of interpolated() method, returns the reference to this instance.

Parameters:

interpolated - new "interpolated" flag.

Returns:

the instance of this enum with the same bit levels and the specified "interpolated" flag.