org.micromanager

Class PositionList

java.lang.Object

org.micromanager.PositionList

All Implemented Interfaces:

java.lang.Iterable<MultiStagePosition>

public class PositionList
extends java.lang.Object
implements java.lang.Iterable<MultiStagePosition>

Navigation list of positions for the Stages. Used for multi site acquisition support.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PositionList.PosListIterator Provides an iterator for a PositionList.

Constructor Summary

Constructors

Constructor and Description
PositionList() Constructor of navigation list of positions for the Stages.

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(javax.swing.event.ChangeListener listener) Adds a changeListener to this PositionList
void	addPosition(int in0, MultiStagePosition pos) Insert a position into the list.
void	addPosition(MultiStagePosition pos) Adds a new position to the list.
void	clearAllPositions() Empties the list.
java.lang.String	generateLabel() Helper method to generate unique label when inserting a new position.
java.lang.String	generateLabel(java.lang.String proposal) Generates a label for a new Position
int	getNumberOfPositions() Returns the number of positions contained within the list
MultiStagePosition	getPosition(int idx) Returns multi-stage position associated with the position index.
MultiStagePosition	getPositionCopy(int idx) Returns a copy of the multi-stage position associated with the position index.
int	getPositionIndex(java.lang.String posLabel) Returns position index associated with the position name.
MultiStagePosition[]	getPositions() Returns an array of positions contained in the list.
boolean	isLabelUnique(java.lang.String label) Verify that the new label is unique
java.util.Iterator<MultiStagePosition>	iterator()
void	load(java.io.File file) Load position list from a file.
void	load(java.lang.String path) Load position list from a file.
static PositionList	newInstance(PositionList aPl) This looks like a static copy constructor
void	notifyChangeListeners() Notifies all changeListeners to the list that something changed
void	removeChangeListener(javax.swing.event.ChangeListener listener) Removes the given listener Nothing will happen if listener was not added first
void	removePosition(int idx) Removes a specific position based on the index
void	replacePosition(int index, MultiStagePosition pos) Replaces position in the list with the new position
void	replaceWithPropertyMap(PropertyMap map) replaces the content of this PositionList with the content of the given PropertyMap
void	save(java.io.File file) Save list to a file.
void	save(java.lang.String path) Save list to a file.
void	setLabel(int idx, java.lang.String label) Assigns a label to the position index
void	setPositions(MultiStagePosition[] posArray) Initialize the entire array by passing an array of multi-stage positions
PropertyMap	toPropertyMap() Creates a PropertyMap from this PositionList

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

PositionList

public PositionList()

Constructor of navigation list of positions for the Stages.

Method Detail

newInstance

public static PositionList newInstance(PositionList aPl)

This looks like a static copy constructor

Parameters:

aPl - input positionlist

Returns:

new instance of a PositionList with identical positions to the input

addChangeListener

public void addChangeListener(javax.swing.event.ChangeListener listener)

Adds a changeListener to this PositionList

Parameters:

listener - Will fire when the list changes

removeChangeListener

public void removeChangeListener(javax.swing.event.ChangeListener listener)

Removes the given listener Nothing will happen if listener was not added first

Parameters:

listener -

notifyChangeListeners

public void notifyChangeListeners()

Notifies all changeListeners to the list that something changed

getPosition

public MultiStagePosition getPosition(int idx)

Returns multi-stage position associated with the position index.

Parameters:

idx - - position index

Returns:

multi-stage position

getPositionCopy

public MultiStagePosition getPositionCopy(int idx)

Returns a copy of the multi-stage position associated with the position index.

Parameters:

idx - - position index

Returns:

multi-stage position

getPositionIndex

public int getPositionIndex(java.lang.String posLabel)

Returns position index associated with the position name.

Parameters:

posLabel - - label (name) of the position

Returns:

index, or -1 when the name was not found

addPosition

public void addPosition(MultiStagePosition pos)

Adds a new position to the list.

Parameters:

pos - - multi-stage position

addPosition

public void addPosition(int in0,
                        MultiStagePosition pos)

Insert a position into the list.

Parameters:

in0 - - place in the list where the position should be inserted

pos - - multi-stage position

replacePosition

public void replacePosition(int index,
                            MultiStagePosition pos)

Replaces position in the list with the new position

Parameters:

index - index of the position to be replaced

pos - - multi-stage position

getNumberOfPositions

public int getNumberOfPositions()

Returns the number of positions contained within the list

Returns:

number of positions contained in the position list

clearAllPositions

public void clearAllPositions()

Empties the list.

removePosition

public void removePosition(int idx)

Removes a specific position based on the index

Parameters:

idx - - position index

setPositions

public void setPositions(MultiStagePosition[] posArray)

Initialize the entire array by passing an array of multi-stage positions

Parameters:

posArray - - array of multi-stage positions

getPositions

public MultiStagePosition[] getPositions()

Returns an array of positions contained in the list.

Returns:

position array

setLabel

public void setLabel(int idx,
                     java.lang.String label)

Assigns a label to the position index

Parameters:

idx - - position index

label - - new label (name)

toPropertyMap

public PropertyMap toPropertyMap()

Creates a PropertyMap from this PositionList

Returns:

PropertyMap representing this PositionList

replaceWithPropertyMap

public void replaceWithPropertyMap(PropertyMap map)
                            throws java.io.IOException

replaces the content of this PositionList with the content of the given PropertyMap

Parameters:

map - PropertyMap whose content will replace this PositionList

Throws:

java.io.IOException

generateLabel

public java.lang.String generateLabel()

Helper method to generate unique label when inserting a new position. Not recommended for use - planned to become obsolete.

Returns:

Unique label

generateLabel

public java.lang.String generateLabel(java.lang.String proposal)

Generates a label for a new Position

Parameters:

proposal - user-supplied suggestion

Returns:

new, unique label that will be accepted by this list

isLabelUnique

public boolean isLabelUnique(java.lang.String label)

Verify that the new label is unique

Parameters:

label - - proposed label

Returns:

true if label does not exist

save

public void save(java.io.File file)
          throws java.io.IOException

Save list to a file.

Parameters:

file - destination; recommended suffix is ".json".

Throws:

java.io.IOException

save

public void save(java.lang.String path)
          throws java.io.IOException

Save list to a file.

Parameters:

path - destination; recommended suffix is ".json".

Throws:

java.io.IOException

load

public void load(java.io.File file)
          throws java.io.IOException

Load position list from a file.

Parameters:

file - source JSON file, usually ".txt" or ".json".

Throws:

java.io.IOException

load

public void load(java.lang.String path)
          throws java.io.IOException

Load position list from a file.

Parameters:

path - source JSON file, usually ".txt" or ".json".

Throws:

java.io.IOException

iterator

public java.util.Iterator<MultiStagePosition> iterator()

Specified by:

iterator in interface java.lang.Iterable<MultiStagePosition>