Package loci.formats.in

Class CellVoyagerReader

java.lang.Object

loci.formats.FormatHandler

loci.formats.FormatReader

loci.formats.in.CellVoyagerReader

All Implemented Interfaces:

Closeable, AutoCloseable, ICompressedTileReader, IFormatHandler, IFormatReader, IMetadataConfigurable, IPyramidHandler

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.

Field Summary

Fields inherited from class loci.formats.FormatReader

core, coreIndex, datasetDescription, domains, fillColor, 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	Description
CellVoyagerReader()

Method Summary

Modifier and Type	Method	Description
int	fileGroupOption(String id)
int	getRequiredDirectories(String[] files)
String[]	getSeriesUsedFiles(boolean noPixels)
protected void	initFile(String id)
boolean	isSingleFile(String id)
boolean	isThisType(String name, boolean open)
byte[]	openBytes(int no, byte[] buf, int x, int y, int w, int h)

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, getAvailableOptions, getBinning, getBitsPerPixel, getCompression, getContrastMethod, getCoreIndex, getCoreMetadataList, getCorrection, getCurrentCore, getCurrentFile, getDatasetStructureDescription, getDetectorType, getDimensionOrder, getDimensionOrder, getDomains, getEffectiveSizeC, getExperimentType, getFilamentType, getFillColor, 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, getTileColumns, getTileRows, 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, readPlane, reopenFile, seriesToCoreIndex, setCoreIndex, setFillColor, setFlattenedResolutions, setGroupFiles, setId, setMetadataFiltered, setMetadataStore, setNormalized, setOriginalMetadataPopulated, setResolution, setSeries, updateMetadataLists

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.ICompressedTileReader

getTileCodec, getTileCodecOptions, openCompressedBytes, openCompressedBytes

Methods inherited from interface loci.formats.IFormatHandler

getFormat, getNativeDataType, getSuffixes

Methods inherited from interface loci.formats.IMetadataConfigurable

getMetadataOptions, getSupportedMetadataLevels, setMetadataOptions

Constructor Details

CellVoyagerReader

public CellVoyagerReader()

Method Details

openBytes

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

Specified by:

openBytes in interface IFormatReader

Specified by:

openBytes in class FormatReader

Throws:

FormatException

IOException

fileGroupOption

public int fileGroupOption(String id)
                    throws FormatException,
IOException

Specified by:

fileGroupOption in interface IFormatReader

Overrides:

fileGroupOption in class FormatReader

Throws:

FormatException

IOException

getRequiredDirectories

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

Specified by:

getRequiredDirectories in interface IFormatReader

Overrides:

getRequiredDirectories in class FormatReader

Throws:

FormatException

IOException

isSingleFile

public boolean isSingleFile(String id)
                     throws FormatException,
IOException

Specified by:

isSingleFile in interface IFormatReader

Overrides:

isSingleFile in class FormatReader

Throws:

FormatException

IOException

isThisType

public boolean isThisType(String name,
 boolean open)

Specified by:

isThisType in interface IFormatReader

Overrides:

isThisType in class FormatReader

initFile

protected void initFile(String id)
                 throws FormatException,
IOException

Overrides:

initFile in class FormatReader

Throws:

FormatException

IOException

getSeriesUsedFiles

public String[] getSeriesUsedFiles(boolean noPixels)

Specified by:

getSeriesUsedFiles in interface IFormatReader

Overrides:

getSeriesUsedFiles in class FormatReader