acquifer.ij

Class BatchDialog

Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

ij.gui.GenericDialog

fiji.util.gui.GenericDialogPlus

acquifer.ij.BatchDialog

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.event.AdjustmentListener, java.awt.event.FocusListener, java.awt.event.ItemListener, java.awt.event.KeyListener, java.awt.event.TextListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, Serializable, EventListener, javax.accessibility.Accessible

Direct Known Subclasses:

BatchConverter, BatchCopy, BatchDialog, BatchDialog, BatchMacro, BatchScript, BioformatConverter, Hyperstack_Maker, PlateMontageMaker

public class BatchDialog
extends fiji.util.gui.GenericDialogPlus

Class defining custom dialog for batch-processing with IM images.
A default panel occupies the left side of the GUI with image directory input, well and dimensions selection.
Adding GUI elements will be added to a second panel on the right.
The plate layout can be set using the plugin Acquifer>Settings>Set plate layout (jython) or by setting the ImageJ Prefs variable "plate.layout" to one of the Plate enum names (ex: "Wells48").
Plugins using this dialog class are macro-recordable, as long as the getNext** methods are used as for GenericDialog.
For the default parameters composing the left panel, the inputs should be recovered by calling once getDefaultInputs() and then calling the getImageDirectory()...

The class is compatible with headless execution of script/macro calling the plugin via the command
ImageJ-win64.exe --ij2 --console --run pathToScript with or without the --headless tag.
It is not compatible with
ImageJ-win64.exe --console -macro myMacro.ijm
at least without the --headless tag, an error related to the GUI is triggered.
Descendant classes should take care not to call GUI-related function in headless mode such as displaying images. The protected attribute headless can be used to test if(headless).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Dialog

java.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType

Nested classes/interfaces inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected acquifer.core.im.FilenameFilter	filenameFilter
protected boolean	headless True only when called in console with tag --headless.
protected String	imageDirectory
java.awt.Label	labelChannels
java.awt.Label	labelSubposition
java.awt.Label	labelTimepoint
java.awt.Label	labelZ
protected Set<Integer>	listChannels
protected Set<Integer>	listSubPositions
protected Set<Integer>	listTimepoints
protected Set<acquifer.core.Well>	listWells
protected Set<Integer>	listZslices
protected int	nColumns Number of plate columns.
protected int	nGroupCheckboxes
protected int	nRows Number of plate rows.
protected acquifer.core.Plate	plate
protected List<java.awt.Checkbox>	rowSelectionCheckboxes

Fields inherited from class fiji.util.gui.GenericDialogPlus

windowIDs, windowTitles

Fields inherited from class ij.gui.GenericDialog

checkbox, choice, defaultChoiceIndexes, defaultStrings, defaultText, defaultValues, numberField, radioButtonGroups, slider, stringField, textArea1, textArea2, theLabel

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
BatchDialog(String title, acquifer.core.im.FilenameFilter filenameFilter) Default constructor defining the fixed left panel of the GUI.

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent event) Handle buttons clicks in the GUI.
void	addDefaultDirectoryInput() Add directory input to the GUI for the "default" directory.
void	addMessageBold(String message) Add a message with default font in bold to the GUI.
static Set<Integer>	convertToIntegerSet(String stringInput) Parse the selected dimensions (string input) to a list of integer.
void	createAndSetDefaultDirectory(String directoryPath, String defaultSubDirectory) Set the "default" directory to the provided directory path.
boolean	escapePressed() If escape was pressed, display a message in ImageJ status bar, reset the progress bar and returns true.
java.awt.Font	getBoldFont() Return the default Font but bold, or null if it is in headless or if the plugin's GUI is not shown.
Set<Integer>	getChannels() Return selected channels, this function should be called after calling getDefaultInputs().
List<java.awt.Checkbox>	getCheckboxesForColumn(int column) Return the list of checkboxes for wells of a given plate column.
List<java.awt.Checkbox>	getCheckboxGroup() Return a list containing all the checkboxes composing the checkbox group.
String	getCurrentImageDirectory() Return path currently in the GUI, if it corresponds to a valid directory, otherwise return null.
void	getDefaultInputs() Read all the default user-inputs (using the getNext*** methods, to be macro-recordable).
java.awt.Font	getFont() Return the default Font of the GUI when displayed, or null when the plugin call is through the command line.
List<java.awt.Checkbox>	getHeaderCheckboxes() Return a reference to the header checkboxes.
String	getImageDirectory() Return image directory, this function should be called after calling getDefaultInputs().
acquifer.core.Dataset	getMatchingDataset() Return a Dataset representing the data matching the selected dimensions.
acquifer.core.Dataset	getMatchingDataset(boolean showErrorWindow) Return a Dataset representing the data matching the selected dimensions.
acquifer.core.Dataset	getMatchingDataset(Comparator<acquifer.core.im.ImagePlane> sortOrder, boolean showErrorWindow) Return a Dataset representing the data matching the selected dimensions.
Set<Integer>	getNextStringAsIntegers() Parse a string of comma-separated integers from the next string input field of the dialog in a macro-recordable way.
boolean[]	getSavedWellCheckboxState(acquifer.core.Plate plate) Recover from persistence the state of the checkboxes for the full checkbox group as an array of boolean.
Set<Integer>	getSubpositions() Return selected subpositions, this function should be called after calling getDefaultInputs().
Set<Integer>	getTimepoints() Return selected timepoints, this function should be called after calling getDefaultInputs().
List<java.awt.Checkbox>	getWellCheckboxes() Return a list containing the checkboxes for the wells selection.
Set<acquifer.core.Well>	getWells() Return the set of wells selected, this function should be called after calling getDefaultInputs().
Set<Integer>	getZslice() Return selected Z-slice, this function should be called after calling getDefaultInputs().
void	itemStateChanged(java.awt.event.ItemEvent event) Define what happens when checkboxes or dropdown menus are changed.
static String	readMacroContent(String macroFilePath) Check that the input path corresponds to a macro file (.ijm or .txt) and return the content as a String.
void	saveDefaultParameters() This function save the default GUI parameters, expected in this order - Input directory - Channel selector - Z-slice selector - Timepoint selector - well subposition - well selections It also saves the last visited/default directory for the OpenDialog.
void	saveWellCheckboxState() Save the checkboxes states in persistence for the full checkbox group as a string "True, True, False..."
void	setOKLabel(String label) This method does not do anything on purpose. The OK label should not be renamed, otherwise the parameters persistence wont work. See actionPerformed(ActionEvent)
void	showDialog() Reorganise the GUI layout with left/right panels.
void	textValueChanged(java.awt.event.TextEvent event) This method react to change in text fields.
boolean	validateInputs() Check values entered in the dialog, to make sure they make sense (no negative...).

Methods inherited from class fiji.util.gui.GenericDialogPlus

addButton, addComponent, addComponent, addDirectoryField, addDirectoryField, addDirectoryOrFileField, addDirectoryOrFileField, addFileField, addFileField, addImage, addImage, addImage, addImageChoice, addStringField, createImageIcon, getConstraints, getNextImage, keyPressed, keyReleased, keyTyped

Methods inherited from class ij.gui.GenericDialog

addCheckbox, addCheckboxGroup, addCheckboxGroup, addChoice, addDialogListener, addEnumChoice, addHelp, addImage, addMessage, addMessage, addMessage, addNumericField, addNumericField, addNumericField, addPanel, addPanel, addPreviewCheckbox, addPreviewCheckbox, addRadioButtonGroup, addSlider, addSlider, addStringField, addTextAreas, addToSameRow, adjustmentValueChanged, centerDialog, dispose, enableYesNoCancel, enableYesNoCancel, focusGained, focusLost, getButtons, getCheckboxes, getChoices, getErrorMessage, getInsets, getInstance, getLabel, getMessage, getNextBoolean, getNextChoice, getNextChoiceIndex, getNextEnumChoice, getNextNumber, getNextRadioButton, getNextString, getNextText, getNumericFields, getPreviewCheckbox, getRadioButtonGroups, getSliders, getStringFields, getTextArea1, getTextArea2, getValue, hideCancelButton, invalidNumber, isMacro, isPreviewActive, paint, parseDouble, previewRunning, repaint, setCancelLabel, setDefaultString, setEchoChar, setFont, setHelpLabel, setInsets, setLocation, setSmartRecording, setup, wasCanceled, wasOKed, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class java.awt.Dialog

addNotify, getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, paramString, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

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

Field Detail

headless

protected boolean headless

True only when called in console with tag --headless.
WARNING: without it, Fiji GUI is shown but not the plugin GUI, which can be an issue for functions relying on AWT/GUI.

imageDirectory

protected String imageDirectory

listChannels

protected Set<Integer> listChannels

listZslices

protected Set<Integer> listZslices

listTimepoints

protected Set<Integer> listTimepoints

listSubPositions

protected Set<Integer> listSubPositions

listWells

protected Set<acquifer.core.Well> listWells

plate

protected acquifer.core.Plate plate

nRows

protected int nRows

Number of plate rows. The GUI has one more row of checkboxes (the 1st one) for full-column selections.

nColumns

protected int nColumns

Number of plate columns. The GUI has one more column of checkboxes (the 1st one) for full-row selections.

nGroupCheckboxes

protected int nGroupCheckboxes

rowSelectionCheckboxes

protected List<java.awt.Checkbox> rowSelectionCheckboxes

filenameFilter

protected final acquifer.core.im.FilenameFilter filenameFilter

labelSubposition

public java.awt.Label labelSubposition

labelChannels

public java.awt.Label labelChannels

labelZ

public java.awt.Label labelZ

labelTimepoint

public java.awt.Label labelTimepoint

Constructor Detail

BatchDialog

public BatchDialog(String title,
                   acquifer.core.im.FilenameFilter filenameFilter)

Default constructor defining the fixed left panel of the GUI.
This panels contains:
- Input directory
- well selection (96 well array)
- well subposition
- Channel selection
- Z-slice selection
- Timepoint selection

Method Detail

getFont

public java.awt.Font getFont()

Return the default Font of the GUI when displayed, or null when the plugin call is through the command line.
! WARNING make sure to handle the case when null is returned, otherwise command call will break !

Specified by:

getFont in interface java.awt.MenuContainer

Overrides:

getFont in class java.awt.Component

getBoldFont

public java.awt.Font getBoldFont()

Return the default Font but bold, or null if it is in headless or if the plugin's GUI is not shown.
By returning null, the default font is used by addMessageBold(String) which prevent issues.

addMessageBold

public void addMessageBold(String message)

Add a message with default font in bold to the GUI.

escapePressed

public boolean escapePressed()

If escape was pressed, display a message in ImageJ status bar, reset the progress bar and returns true.
Otherwise returns false.

showDialog

public void showDialog()

Reorganise the GUI layout with left/right panels.
Default components (well and dimension selection) are on the left, while the plugin-specific components are on the right.
Then display the GUI.
showDialog from GenericDialog blocks further code execution until OK/Cancel is pressed, except for NonBlockingGenericDialog ! for which code is further executed, and OK press would be handle as an event..

Overrides:

showDialog in class ij.gui.GenericDialog

addDefaultDirectoryInput

public void addDefaultDirectoryInput()

Add directory input to the GUI for the "default" directory.
The default directory is the one recovered by the command getDirectory("default") in the macro-language. This method also add a documentation string in the GUI, above the directory input field.

createAndSetDefaultDirectory

public void createAndSetDefaultDirectory(String directoryPath,
                                         String defaultSubDirectory)

Set the "default" directory to the provided directory path.
If the directory does not exist it is created.
If directoryPath is "", the directory will be set to the defaultSubDirectory in the image directory.
This function should be called after calling getDefaultInputs(), otherwise imageDirectory is not defined.

Parameters:

directoryPath - full path to custom directory to create, or "" to use the default subdirectory

defaultSubDirectory - if directoryPath="", default subdirectory to create within the IM experiment directory.

readMacroContent

public static String readMacroContent(String macroFilePath)
                               throws IllegalArgumentException,
                                      IOException

Check that the input path corresponds to a macro file (.ijm or .txt) and return the content as a String.

Parameters:

macroFilePath - must be a .ijm or .txt file.

Returns:

the content of the macro as a string

Throws:

IllegalArgumentException - if the file is not a .txt or .ijm or is not existing.

IOException - if the file cannot be read.

getWellCheckboxes

public List<java.awt.Checkbox> getWellCheckboxes()

Return a list containing the checkboxes for the wells selection.
This list does NOT include the select all/None, header and row selection checkboxes.

getCheckboxGroup

public List<java.awt.Checkbox> getCheckboxGroup()

Return a list containing all the checkboxes composing the checkbox group.
In addition to the well checkboxes, it includes the Select All/None checkbox, the header checkboxes and row selection checkboxes.

getHeaderCheckboxes

public List<java.awt.Checkbox> getHeaderCheckboxes()

Return a reference to the header checkboxes.
Does not return a copy. Changes directly impact the GUI.

getCheckboxesForColumn

public List<java.awt.Checkbox> getCheckboxesForColumn(int column)

Return the list of checkboxes for wells of a given plate column.
This does not return the header checkboxes.

saveWellCheckboxState

public void saveWellCheckboxState()

Save the checkboxes states in persistence for the full checkbox group as a string "True, True, False..."

saveDefaultParameters

public void saveDefaultParameters()

This function save the default GUI parameters, expected in this order - Input directory - Channel selector - Z-slice selector - Timepoint selector - well subposition - well selections
It also saves the last visited/default directory for the OpenDialog.

getSavedWellCheckboxState

public boolean[] getSavedWellCheckboxState(acquifer.core.Plate plate)

Recover from persistence the state of the checkboxes for the full checkbox group as an array of boolean.

setOKLabel

public void setOKLabel(String label)

This method does not do anything on purpose.
The OK label should not be renamed, otherwise the parameters persistence wont work.
See actionPerformed(ActionEvent)

Overrides:

setOKLabel in class ij.gui.GenericDialog

textValueChanged

public void textValueChanged(java.awt.event.TextEvent event)

This method react to change in text fields.
here the directory field and the dimensions selectors.
The default implementation updates the current dataset, and dimension labels when a new directory is inputed.

Specified by:

textValueChanged in interface java.awt.event.TextListener

Overrides:

textValueChanged in class ij.gui.GenericDialog

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent event)

Handle buttons clicks in the GUI.
Buttons are recognised based on the button label, therefore don't rename the OK button with setOKLabel("something").

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Overrides:

actionPerformed in class ij.gui.GenericDialog

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent event)

Define what happens when checkboxes or dropdown menus are changed.
It is used in this GUI for the Select All/None, row and column selection checkboxes.
This method is automatically called for any checkbox or dropdown of the GUI, no need to set additional listeners.

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

Overrides:

itemStateChanged in class ij.gui.GenericDialog

convertToIntegerSet

public static Set<Integer> convertToIntegerSet(String stringInput)

Parse the selected dimensions (string input) to a list of integer.

getDefaultInputs

public void getDefaultInputs()

Read all the default user-inputs (using the getNext*** methods, to be macro-recordable).
This method should be called only once, after the GUI is OKed.
The inputs are stored as instance attributes, which can be recovered with getImageDirectory()...

validateInputs

public boolean validateInputs()

Check values entered in the dialog, to make sure they make sense (no negative...).
This method should be called after the dialog is OKed, as in plugins run() method.

Returns:

true if all inputs are valid, false otherwise.

getNextStringAsIntegers

public Set<Integer> getNextStringAsIntegers()

Parse a string of comma-separated integers from the next string input field of the dialog in a macro-recordable way.

getCurrentImageDirectory

public String getCurrentImageDirectory()

Return path currently in the GUI, if it corresponds to a valid directory, otherwise return null.

getImageDirectory

public String getImageDirectory()

Return image directory, this function should be called after calling getDefaultInputs().
The directory returned by this function is guaranteed to point to an existing directory.
To get the currently inputed directory use getCurrentImageDirectory()

getChannels

public Set<Integer> getChannels()

Return selected channels, this function should be called after calling getDefaultInputs().

getZslice

public Set<Integer> getZslice()

Return selected Z-slice, this function should be called after calling getDefaultInputs().

getTimepoints

public Set<Integer> getTimepoints()

Return selected timepoints, this function should be called after calling getDefaultInputs().

getSubpositions

public Set<Integer> getSubpositions()

Return selected subpositions, this function should be called after calling getDefaultInputs().

getWells

public Set<acquifer.core.Well> getWells()

Return the set of wells selected, this function should be called after calling getDefaultInputs(). The returned set is a copy of the instance attribute to prevent modifications.

getMatchingDataset

public acquifer.core.Dataset getMatchingDataset(Comparator<acquifer.core.im.ImagePlane> sortOrder,
                                                boolean showErrorWindow)
                                         throws InstantiationException

Return a Dataset representing the data matching the selected dimensions.

Parameters:

sortOrder - optional order to sort the list of images in the dataset, can be null.

showErrorWindow - if true, an ImageJ error window is shown if an error occurs, in addition to the stack trace.

Throws:

IllegalArgumentException - when no images match the dimensions filters.

InstantiationException

getMatchingDataset

public acquifer.core.Dataset getMatchingDataset(boolean showErrorWindow)
                                         throws InstantiationException

Return a Dataset representing the data matching the selected dimensions.

Parameters:

showErrorWindow - if true, an ImageJ error window is shown if an error occurs, in addition to the stack trace.

Throws:

IllegalArgumentException - when no images match the dimensions filters.

InstantiationException

getMatchingDataset

public acquifer.core.Dataset getMatchingDataset()
                                         throws InstantiationException

Return a Dataset representing the data matching the selected dimensions. This version does not show an ImageJ error window if the Dataset creation fails, the caller thus has a chance to continue code execution.

Throws:

IllegalArgumentException - when no images match the dimensions filters.

InstantiationException