org.anchoranalysis.plugin.annotation.bean.comparison

Class CompareAnnotations<T extends Assignment<ObjectMask>>

Object

AnchorBean<Task<T,S>>

Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T>>

CompareAnnotations<T>

Type Parameters:

T - assignment-type.

public class CompareAnnotations<T extends Assignment<ObjectMask>>
extends Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T>>

Task to compare a set of annotations to a segmentation or another set of annotations.

The following outputs are produced:

Output Name	Default?	Description
	yes	a single CSV file showing summary statistics of matching for all images.
	yes	a single CSV file showing summary statistics of matching for all groups group of images.
	yes	a file per image showing a colored representation of which annotations matched (or didn't) for each image.
outputs from the AnnotationComparisonAssigner in assign
	outputs from Task

Author:

Owen Feehan

Field Summary

Fields

Modifier and Type	Field and Description
static String	OUTPUT_BY_GROUP

Constructor Summary

Constructors

Constructor and Description
CompareAnnotations()

Method Summary

Modifier and Type	Method and Description
void	afterAllJobsAreExecuted(ComparisonSharedState<T> sharedState, InputOutputContext context) Called once after all calls to Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>).
ComparisonSharedState<T>	beforeAnyJobIsExecuted(Outputter outputter, ConcurrencyPlan concurrencyPlan, List<AnnotationComparisonInput<ProvidesStackInput>> inputs, ParametersExperiment parameters) Called once before all calls to Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>).
OutputEnabledMutable	defaultOutputs() If specified, default rules for determine which outputs are enabled or not.
void	doJobOnInput(InputBound<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T>> input) Performs the task on a particular input.
AnnotationComparisonAssigner<T>	getAssigner()
String	getBackground() The name of the stack to use as background to the annotations.
ColorScheme	getColorsUnpaired()
StackDisplayer	getDisplayer() How to convert an image to be displayed to the user.
int	getMaxSplitGroups()
int	getNumberLevelsGrouping()
int	getOutlineWidth() How many pixels should the outline be around objects.
String	getSplitIdentifierRegex() If non-empty, the string (a regular-expression) is used to split the file's identifier into groups.
boolean	hasVeryQuickPerInputExecution() Is the execution-time of the task per-input expected to be very quick to execute?
InputTypesExpected	inputTypesExpected() Highest class(es) that will function as a valid input.
boolean	isFlatten() If true, a maximum-intensity-projection is first applied to any 3D objects into a 2D plane, before comparison.
boolean	isReplaceMatchesWithSolids()
void	setAssigner(AnnotationComparisonAssigner<T> assigner)
void	setBackground(String background) The name of the stack to use as background to the annotations.
void	setColorsUnpaired(ColorScheme colorsUnpaired)
void	setDisplayer(StackDisplayer displayer) How to convert an image to be displayed to the user.
void	setFlatten(boolean flatten) If true, a maximum-intensity-projection is first applied to any 3D objects into a 2D plane, before comparison.
void	setMaxSplitGroups(int maxSplitGroups)
void	setNumberLevelsGrouping(int numberLevelsGrouping)
void	setOutlineWidth(int outlineWidth) How many pixels should the outline be around objects.
void	setReplaceMatchesWithSolids(boolean replaceMatchesWithSolids)
void	setSplitIdentifierRegex(String splitIdentifierRegex) If non-empty, the string (a regular-expression) is used to split the file's identifier into groups.

Methods inherited from class Task

executeJob, isInputCompatibleWith

Methods inherited from class AnchorBean

checkMisconfigured, describeBean, describeChildren, duplicateBean, fields, findFieldsOfClass, getBeanName, getLocalPath, localise, toString

Methods inherited from class Object

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

Field Detail

OUTPUT_BY_GROUP

public static final String OUTPUT_BY_GROUP

See Also:

Constant Field Values

Constructor Detail

CompareAnnotations

public CompareAnnotations()

Method Detail

beforeAnyJobIsExecuted

public ComparisonSharedState<T> beforeAnyJobIsExecuted(Outputter outputter,
                                                       ConcurrencyPlan concurrencyPlan,
                                                       List<AnnotationComparisonInput<ProvidesStackInput>> inputs,
                                                       ParametersExperiment parameters)
                                                throws ExperimentExecutionException

Description copied from class: Task

Called once before all calls to Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>).

Specified by:

beforeAnyJobIsExecuted in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Parameters:

outputter - the output-manager for the experiment (not for an individual job)

concurrencyPlan - available numbers of processors that can call Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>)

inputs - a list of inputs, each will result in at least one call to Task.executeJob(ParametersUnbound).

parameters - the experiment-parameters.

Returns:

the shared-state that is passed to each call to Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>) and to Task.afterAllJobsAreExecuted(S, org.anchoranalysis.io.output.outputter.InputOutputContext).

Throws:

ExperimentExecutionException - if a fatal error occurs executing this step of the experiment.

doJobOnInput

public void doJobOnInput(InputBound<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T>> input)
                  throws JobExecutionException

Description copied from class: Task

Performs the task on a particular input.

Specified by:

doJobOnInput in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Parameters:

input - the input for the job.

Throws:

JobExecutionException - if an error occurs executing a particular job, that is not otherwise suppressed.

inputTypesExpected

public InputTypesExpected inputTypesExpected()

Description copied from class: Task

Highest class(es) that will function as a valid input.

This is usually the class of T (or sometimes the absolute base class InputFromManager).

Specified by:

inputTypesExpected in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Returns:

the input-types that a task expects.

afterAllJobsAreExecuted

public void afterAllJobsAreExecuted(ComparisonSharedState<T> sharedState,
                                    InputOutputContext context)
                             throws ExperimentExecutionException

Description copied from class: Task

Called once after all calls to Task.executeJob(org.anchoranalysis.experiment.task.ParametersUnbound<T, S>).

Specified by:

afterAllJobsAreExecuted in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Parameters:

sharedState - the shared-state

context - IO-context for experiment (not for an individual job)

Throws:

ExperimentExecutionException - if a fatal error occurs executing this step of the experiment.

hasVeryQuickPerInputExecution

public boolean hasVeryQuickPerInputExecution()

Description copied from class: Task

Is the execution-time of the task per-input expected to be very quick to execute?

Specified by:

hasVeryQuickPerInputExecution in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Returns:

true iff the execution is expected to be very quick, false otherwise.

defaultOutputs

public OutputEnabledMutable defaultOutputs()

Description copied from class: Task

If specified, default rules for determine which outputs are enabled or not.

Overrides:

defaultOutputs in class Task<AnnotationComparisonInput<ProvidesStackInput>,ComparisonSharedState<T extends Assignment<ObjectMask>>>

Returns:

the default rules if they exist.

getBackground

public String getBackground()

The name of the stack to use as background to the annotations.

setBackground

public void setBackground(String background)

The name of the stack to use as background to the annotations.

getSplitIdentifierRegex

public String getSplitIdentifierRegex()

If non-empty, the string (a regular-expression) is used to split the file's identifier into groups.

setSplitIdentifierRegex

public void setSplitIdentifierRegex(String splitIdentifierRegex)

If non-empty, the string (a regular-expression) is used to split the file's identifier into groups.

getMaxSplitGroups

public int getMaxSplitGroups()

setMaxSplitGroups

public void setMaxSplitGroups(int maxSplitGroups)

getNumberLevelsGrouping

public int getNumberLevelsGrouping()

setNumberLevelsGrouping

public void setNumberLevelsGrouping(int numberLevelsGrouping)

isFlatten

public boolean isFlatten()

If true, a maximum-intensity-projection is first applied to any 3D objects into a 2D plane, before comparison.

setFlatten

public void setFlatten(boolean flatten)

If true, a maximum-intensity-projection is first applied to any 3D objects into a 2D plane, before comparison.

getOutlineWidth

public int getOutlineWidth()

How many pixels should the outline be around objects.

setOutlineWidth

public void setOutlineWidth(int outlineWidth)

How many pixels should the outline be around objects.

getAssigner

public AnnotationComparisonAssigner<T> getAssigner()

setAssigner

public void setAssigner(AnnotationComparisonAssigner<T> assigner)

isReplaceMatchesWithSolids

public boolean isReplaceMatchesWithSolids()

setReplaceMatchesWithSolids

public void setReplaceMatchesWithSolids(boolean replaceMatchesWithSolids)

getColorsUnpaired

public ColorScheme getColorsUnpaired()

setColorsUnpaired

public void setColorsUnpaired(ColorScheme colorsUnpaired)

getDisplayer

public StackDisplayer getDisplayer()

How to convert an image to be displayed to the user.

setDisplayer

public void setDisplayer(StackDisplayer displayer)

How to convert an image to be displayed to the user.