loci.formats.in

Class CellVoyagerReader

java.lang.Object

loci.formats.FormatHandler

loci.formats.FormatReader

loci.formats.in.CellVoyagerReader

All Implemented Interfaces:

Closeable, AutoCloseable, IFormatHandler, IFormatReader, IMetadataConfigurable

public class CellVoyagerReader
extends FormatReader

A bioformat reader for the Yokagawa Cellvoyager CV1000 automated microscope ( http://www.yokogawa.com/scanner/products/cv1000e.htm).

This reader opens the dataset generated by the Yokagawa Cellvoyager automated microscope. The user should point the reader to the file named MeasurementResult.xml in the dataset folder.

The file format itself consists of several nested folder containing a lot of - sometimes redundant - information. This specific reader exploits the following files:

• MeasurementResult.xml that contains high level information about image geometry, well (if any) organization, fields arrangement, etc..
• MeasurementResult.ome.xml is a malformed OME xml file that contains information on one of the numerous TIF files that compose the pixel data. It is used to easily extract common metadata.
• All the TIF files in the Image folder: They contain the pixel data itself. Each well (if any) can have several Areas (fields in the HCS vocable), in turn composed of several tiles that are to be stitched border to border, without the possibility of a more subtle stitching process.

This reader stitches each area on the fly upon loading. It yields one series per well x area. If there is 20 wells each made of 2 areas, 40 series will be available.

This reader version was derived from reverse-engineering data files generated on a system hosted by the imaging facility of the Institut Pasteur, Paris (Imagopole / PFID). It spits file versioned 1.0. The file format contains several obvious typos, notably in some XML tags, and as mentionned above, the ome.xml is malformed. It is likely that that subsequent versions of the CellVoyager format will fix these problems, alas incapacitating this reader. Should it happen, mail the author to help them update this reader.

Author:

Jean-Yves Tinevez Oct-Nov 2013, Melissa Linkert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	CellVoyagerReader.AreaInfo
private static class	CellVoyagerReader.ChannelInfo
private static class	CellVoyagerReader.FieldInfo
private static class	CellVoyagerReader.WellInfo

Field Summary

Fields

Modifier and Type	Field and Description
private List<CellVoyagerReader.ChannelInfo>	channelInfos
private loci.common.Location	imageFolder
private loci.common.Location	measurementFolder
private loci.common.Location	measurementResultFile
private loci.common.Location	omeMeasurementFile
private static String	SINGLE_TIFF_PATH_BUILDER
private List<Integer>	timePoints
private List<CellVoyagerReader.WellInfo>	wells

Fields inherited from class loci.formats.FormatReader

core, coreIndex, datasetDescription, domains, filterMetadata, flattenedResolutions, group, hasCompanionFiles, in, indexedAsRGB, metadata, metadataStore, normalizeData, resolution, saveOriginalMetadata, series, suffixNecessary, suffixSufficient, THUMBNAIL_DIMENSION

Fields inherited from class loci.formats.FormatHandler

COMPRESSION_SUFFIXES, currentId, format, LOGGER, metadataOptions, suffixes

Fields inherited from interface loci.formats.IFormatReader

CAN_GROUP, CANNOT_GROUP, MUST_GROUP

Constructor Summary

Constructors

Constructor and Description
CellVoyagerReader()

Method Summary

Modifier and Type	Method and Description
int	fileGroupOption(String id) Returns an int indicating that we cannot, must, or might group the files in a given dataset.
private static Element	getChild(Element parent, String childName)
private static Element	getChild(Element parent, String[] path)
private static List<Element>	getChildren(Element parent, String name)
private static String	getChildText(Element parent, String childName)
private static String	getChildText(Element parent, String[] path)
int	getRequiredDirectories(String[] files) Returns the number of parent directories that are important when processing the given list of files.
String[]	getSeriesUsedFiles(boolean noPixels) Returns an array of filenames needed to open the current series.
protected void	initFile(String id) Initializes the given file (parsing header information, etc.).
boolean	isSingleFile(String id) Returns true if this is a single-file format.
boolean	isThisType(String name, boolean open) Checks if a file matches the type of this format reader.
byte[]	openBytes(int no, byte[] buf, int x, int y, int w, int h) Obtains a sub-image of the specified image plane into a pre-allocated byte array.
private CellVoyagerReader.AreaInfo	readArea(Element areaEl, int startingFieldIndex, double pixelWidth, double pixelHeight, int tileWidth, int tileHeight)
private CellVoyagerReader.ChannelInfo	readChannel(Element channelEl)
private CellVoyagerReader.FieldInfo	readField(Element fieldEl)
private double	readFrameInterval(Document document)
private void	readInfo(Document msDocument, Document omeDocument)
private List<Integer>	readTimePoints(Document document)
private CellVoyagerReader.WellInfo	readWellInfo(Element wellEl, double pixelWidth, double pixelHeight, int tileWidth, int tileHeight)
private int[]	seriesToWellArea(int series) Returns the well index (in the field wells) and the area index (in the field CellVoyagerReader.WellInfo.areas corresponding to the specified series.

Methods inherited from class loci.formats.FormatReader

addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMeta, addGlobalMetaList, addMeta, addMetaList, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMeta, addSeriesMetaList, close, close, coreIndexToSeries, flattenHashtables, get16BitLookupTable, get8BitLookupTable, getAcquisitionMode, getAdvancedSeriesUsedFiles, getAdvancedUsedFiles, getArcType, getBinning, getBitsPerPixel, getCompression, getContrastMethod, getCoreIndex, getCoreMetadataList, getCorrection, getCurrentFile, getDatasetStructureDescription, getDetectorType, getDimensionOrder, getDimensionOrder, getDomains, getEffectiveSizeC, getExperimentType, getFilamentType, getFillRule, getFilterType, getFontFamily, getFontStyle, getGlobalMeta, getGlobalMetadata, getIlluminationType, getImageCount, getImmersion, getIndex, getIndex, getLaserMedium, getLaserType, getMarker, getMedium, getMetadataStore, getMetadataStoreRoot, getMetadataValue, getMicrobeamManipulationType, getMicroscopeType, getModuloC, getModuloT, getModuloZ, getNamingConvention, getOptimalTileHeight, getOptimalTileWidth, getPixelType, getPixelType, getPossibleDomains, getPulse, getResolution, getResolutionCount, getRGBChannelCount, getRotationTransform, getSeries, getSeriesCount, getSeriesMeta, getSeriesMetadata, getSeriesMetadataValue, getSeriesUsedFiles, getSizeC, getSizeT, getSizeX, getSizeY, getSizeZ, getThumbSizeX, getThumbSizeY, getUnderlyingReaders, getUsedFiles, getUsedFiles, getZCTCoords, getZCTModuloCoords, hasCompanionFiles, hasFlattenedResolutions, isFalseColor, isGroupFiles, isIndexed, isInterleaved, isInterleaved, isLittleEndian, isMetadataComplete, isMetadataFiltered, isNormalized, isOrderCertain, isOriginalMetadataPopulated, isRGB, isThisType, isThisType, isThisType, isThumbnailSeries, isUsedFile, makeFilterMetadata, openBytes, openBytes, openBytes, openPlane, openThumbBytes, readPlane, readPlane, reopenFile, seriesToCoreIndex, setCoreIndex, setFlattenedResolutions, setGroupFiles, setId, setMetadataFiltered, setMetadataStore, setNormalized, setOriginalMetadataPopulated, setResolution, setSeries

Methods inherited from class loci.formats.FormatHandler

checkSuffix, checkSuffix, getFormat, getMetadataOptions, getNativeDataType, getSuffixes, getSupportedMetadataLevels, setMetadataOptions

Methods inherited from class java.lang.Object

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

Methods inherited from interface loci.formats.IFormatHandler

getFormat, getNativeDataType, getSuffixes

Methods inherited from interface loci.formats.IMetadataConfigurable

getMetadataOptions, getSupportedMetadataLevels, setMetadataOptions

Field Detail

SINGLE_TIFF_PATH_BUILDER

private static final String SINGLE_TIFF_PATH_BUILDER

See Also:

Constant Field Values

measurementFolder

private loci.common.Location measurementFolder

imageFolder

private loci.common.Location imageFolder

channelInfos

private List<CellVoyagerReader.ChannelInfo> channelInfos

wells

private List<CellVoyagerReader.WellInfo> wells

timePoints

private List<Integer> timePoints

measurementResultFile

private loci.common.Location measurementResultFile

omeMeasurementFile

private loci.common.Location omeMeasurementFile

Constructor Detail

CellVoyagerReader

public CellVoyagerReader()

Method Detail

openBytes

public byte[] openBytes(int no,
                        byte[] buf,
                        int x,
                        int y,
                        int w,
                        int h)
                 throws FormatException,
                        IOException

Description copied from interface: IFormatReader

Obtains a sub-image of the specified image plane into a pre-allocated byte array.

Specified by:

openBytes in interface IFormatReader

Specified by:

openBytes in class FormatReader

Parameters:

no - the image index within the file.

buf - a pre-allocated buffer.

x - X coordinate of the upper-left corner of the sub-image

y - Y coordinate of the upper-left corner of the sub-image

w - width of the sub-image

h - height of the sub-image

Returns:

the pre-allocated buffer buf for convenience.

Throws:

FormatException - if there was a problem parsing the metadata of the file.

IOException - if there was a problem reading the file.

fileGroupOption

public int fileGroupOption(String id)
                    throws FormatException,
                           IOException

Description copied from interface: IFormatReader

Returns an int indicating that we cannot, must, or might group the files in a given dataset.

Specified by:

fileGroupOption in interface IFormatReader

Overrides:

fileGroupOption in class FormatReader

Throws:

FormatException

IOException

getRequiredDirectories

public int getRequiredDirectories(String[] files)
                           throws FormatException,
                                  IOException

Description copied from interface: IFormatReader

Returns the number of parent directories that are important when processing the given list of files. The number of directories is relative to the common parent. For example, given a list with these two files: /path/to/file/foo /path/to/file/that/is/related A return value of 0 indicates that "/path/to/file/" is irrelevant. A return value of 1 indicates that "/path/to/" is irrelevant. Return values less than 0 are invalid. All listed files are assumed to belong to datasets of the same format.

Specified by:

getRequiredDirectories in interface IFormatReader

Overrides:

getRequiredDirectories in class FormatReader

Throws:

FormatException

IOException

isSingleFile

public boolean isSingleFile(String id)
                     throws FormatException,
                            IOException

Description copied from interface: IFormatReader

Returns true if this is a single-file format.

Specified by:

isSingleFile in interface IFormatReader

Overrides:

isSingleFile in class FormatReader

Throws:

FormatException

IOException

isThisType

public boolean isThisType(String name,
                          boolean open)

Description copied from class: FormatReader

Checks if a file matches the type of this format reader. Checks filename suffixes against those known for this format. If the suffix check is inconclusive and the open parameter is true, the file is opened and tested with FormatReader.isThisType(RandomAccessInputStream).

Specified by:

isThisType in interface IFormatReader

Overrides:

isThisType in class FormatReader

open - If true, and the file extension is insufficient to determine the file type, the (existing) file is opened for further analysis.

initFile

protected void initFile(String id)
                 throws FormatException,
                        IOException

Description copied from class: FormatReader

Initializes the given file (parsing header information, etc.). Most subclasses should override this method to perform initialization operations such as parsing metadata.

Overrides:

initFile in class FormatReader

Throws:

FormatException - if a parsing error occurs processing the file.

IOException - if an I/O error occurs processing the file

getSeriesUsedFiles

public String[] getSeriesUsedFiles(boolean noPixels)

Description copied from interface: IFormatReader

Returns an array of filenames needed to open the current series. If the 'noPixels' flag is set, then only files that do not contain pixel data will be returned.

Specified by:

getSeriesUsedFiles in interface IFormatReader

Overrides:

getSeriesUsedFiles in class FormatReader

seriesToWellArea

private int[] seriesToWellArea(int series)

Returns the well index (in the field wells) and the area index (in the field CellVoyagerReader.WellInfo.areas corresponding to the specified series.

Parameters:

series - the desired series.

Returns:

the corresponding well index and area index, as a 2-element array of int[] { well, area }.

readInfo

private void readInfo(Document msDocument,
                      Document omeDocument)
               throws FormatException

Throws:

FormatException

readChannel

private CellVoyagerReader.ChannelInfo readChannel(Element channelEl)

readWellInfo

private CellVoyagerReader.WellInfo readWellInfo(Element wellEl,
                                                double pixelWidth,
                                                double pixelHeight,
                                                int tileWidth,
                                                int tileHeight)

readArea

private CellVoyagerReader.AreaInfo readArea(Element areaEl,
                                            int startingFieldIndex,
                                            double pixelWidth,
                                            double pixelHeight,
                                            int tileWidth,
                                            int tileHeight)

readField

private CellVoyagerReader.FieldInfo readField(Element fieldEl)

readTimePoints

private List<Integer> readTimePoints(Document document)

readFrameInterval

private double readFrameInterval(Document document)

getChild

private static final Element getChild(Element parent,
                                      String childName)

getChild

private static final Element getChild(Element parent,
                                      String[] path)

getChildren

private static final List<Element> getChildren(Element parent,
                                               String name)

getChildText

private static final String getChildText(Element parent,
                                         String[] path)

getChildText

private static final String getChildText(Element parent,
                                         String childName)