Package org.anchoranalysis.mpp.feature.energy.scheme

Class EnergyScheme

Object

EnergyScheme

public class EnergyScheme
extends Object

The energy for a feature-list as factorized into different cliques.

elemInd: individual terms of clique-size==1 f_1(x) elemPair: pairwise terms of clique-size==2 f_2(x,y) elemAll: terms that include every item in the set f_all(x_1,x_2,....x_n) for all n

Author:

Owen Feehan

Constructor Summary

Constructors

Constructor	Description
EnergyScheme(FeatureList<FeatureInputSingleMemo> individual, FeatureList<FeatureInputPairMemo> pair, FeatureList<FeatureInputAllMemo> all, RegionMap regionMap, AddCriteriaPair pairAddCriteria)	Creates an energy scheme with the specified features and region map.
EnergyScheme(FeatureList<FeatureInputSingleMemo> individual, FeatureList<FeatureInputPairMemo> pair, FeatureList<FeatureInputAllMemo> all, RegionMap regionMap, AddCriteriaPair pairAddCriteria, Optional<DictionaryProvider> dictionary, List<NamedBean<Feature<FeatureInputStack>>> listImageFeatures)	Creates an energy scheme with the specified features, region map, and additional options.

Method Summary

Modifier and Type	Method	Description
Dictionary	createDictionary()	Creates and returns the associated Dictionary or an empty dictionary if none is associated.
FeatureList<FeatureInputAllMemo>	getAll()	Features for all elements together.
<T extends FeatureInput> FeatureList<T>	getElemByCliqueSize(int cliqueSize)	Gets the feature list for a specific clique size.
FeatureList<FeatureInputSingleMemo>	getIndividual()	Features for individual elements (clique-size==1).
List<NamedBean<Feature<FeatureInputStack>>>	getListImageFeatures()	A list of features of the image that are calculated first, and exposed to the other features as parameters.
FeatureList<FeatureInputPairMemo>	getPair()	Features for pairs of elements (clique-size==2).
AddCriteriaPair	getPairAddCriteria()	Criteria for adding pairs to the energy calculation.
RegionMap	getRegionMap()	The region map used in the energy scheme.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

EnergyScheme

public EnergyScheme(FeatureList<FeatureInputSingleMemo> individual,
 FeatureList<FeatureInputPairMemo> pair,
 FeatureList<FeatureInputAllMemo> all,
 RegionMap regionMap,
 AddCriteriaPair pairAddCriteria)
             throws CreateException

Creates an energy scheme with the specified features and region map.

Parameters:

individual - features for individual elements

pair - features for pairs of elements

all - features for all elements together

regionMap - the region map to use

pairAddCriteria - criteria for adding pairs

Throws:

CreateException - if the energy scheme cannot be created

EnergyScheme

public EnergyScheme(FeatureList<FeatureInputSingleMemo> individual,
 FeatureList<FeatureInputPairMemo> pair,
 FeatureList<FeatureInputAllMemo> all,
 RegionMap regionMap,
 AddCriteriaPair pairAddCriteria,
 Optional<DictionaryProvider> dictionary,
 List<NamedBean<Feature<FeatureInputStack>>> listImageFeatures)
             throws CreateException

Creates an energy scheme with the specified features, region map, and additional options.

Parameters:

individual - features for individual elements

pair - features for pairs of elements

all - features for all elements together

regionMap - the region map to use

pairAddCriteria - criteria for adding pairs

dictionary - optional dictionary provider

listImageFeatures - list of image features to be calculated first

Throws:

CreateException - if the energy scheme cannot be created

Method Details

createDictionary

public Dictionary createDictionary()
                            throws CreateException

Creates and returns the associated Dictionary or an empty dictionary if none is associated.

Returns:

the created Dictionary

Throws:

CreateException - if the dictionary cannot be created

getElemByCliqueSize

public <T extends FeatureInput> FeatureList<T> getElemByCliqueSize(int cliqueSize)

Gets the feature list for a specific clique size.

Type Parameters:

T - the type of FeatureInput

Parameters:

cliqueSize - 1 for pairwise, 0 for unary, -1 for all

Returns:

the FeatureList for the specified clique size

Throws:

AnchorImpossibleSituationException - if an invalid clique size is provided

getIndividual

public FeatureList<FeatureInputSingleMemo> getIndividual()

Features for individual elements (clique-size==1).

getPair

public FeatureList<FeatureInputPairMemo> getPair()

Features for pairs of elements (clique-size==2).

getAll

public FeatureList<FeatureInputAllMemo> getAll()

Features for all elements together.

getRegionMap

public RegionMap getRegionMap()

The region map used in the energy scheme.

getListImageFeatures

public List<NamedBean<Feature<FeatureInputStack>>> getListImageFeatures()

A list of features of the image that are calculated first, and exposed to the other features as parameters.

getPairAddCriteria

public AddCriteriaPair getPairAddCriteria()

Criteria for adding pairs to the energy calculation.