loci.formats.in

Class GatanReader

java.lang.Object

loci.formats.FormatHandler

loci.formats.FormatReader

loci.formats.in.GatanReader

All Implemented Interfaces:

Closeable, AutoCloseable, IFormatHandler, IFormatReader, IMetadataConfigurable

public class GatanReader
extends FormatReader

GatanReader is the file format reader for Gatan files.

Author:

Melissa Linkert melissa at glencoesoftware.com

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	adjustEndianness
private static int	ARRAY Data types.
private static int	BYTE
private int	bytesPerPixel
private static int	CHAR
static int	DM3_MAGIC_BYTES
static int	DM4_MAGIC_BYTES
private static int	DOUBLE
private static int	FLOAT
private double	gamma
private static int	GROUP Tag types.
private String	info
private static int	INT
private double	mag
private int	numPixelBytes
private int	pixelDataNum
private long	pixelOffset Offset to pixel data.
private List<Double>	pixelSizes List of pixel sizes.
private Length	posX
private Length	posY
private Length	posZ
private double	sampleTime
private static int	SHORT
private boolean	signed
private long	timestamp
private static int	UBYTE
private static int	UINT
private List<String>	units
private static int	UNKNOWN
private static int	UNKNOWN2
private static int	USHORT
private static int	VALUE
private int	version
private double	voltage

Fields inherited from class loci.formats.FormatReader

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

Fields inherited from class loci.formats.FormatHandler

COMPRESSION_SUFFIXES, currentId, format, LOGGER, suffixes

Fields inherited from interface loci.formats.IFormatReader

CAN_GROUP, CANNOT_GROUP, MUST_GROUP

Constructor Summary

Constructors

Constructor and Description
GatanReader() Constructs a new Gatan reader.

Method Summary

Methods

Modifier and Type	Method and Description
void	close(boolean fileOnly) Closes the currently open file.
private Double	correctForUnits(Double value, String units)
private int	getNumBytes(int type)
protected void	initFile(String id) Initializes the given file (parsing header information, etc.).
boolean	isThisType(RandomAccessInputStream stream) Checks if the given stream is a valid stream for this file format.
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 void	parseTags(int numTags, String parent, String indent) Parses Gatan DM3 tags.
private double	readValue(int type)
private void	skipPadding()

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, coreIndexToSeries, fileGroupOption, 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, getLineCap, getMarker, getMedium, getMetadataOptions, getMetadataStore, getMetadataStoreRoot, getMetadataValue, getMicrobeamManipulationType, getMicroscopeType, getModuloC, getModuloT, getModuloZ, getNamingConvention, getOptimalTileHeight, getOptimalTileWidth, getPixelType, getPixelType, getPossibleDomains, getPulse, getRequiredDirectories, getResolution, getResolutionCount, getRGBChannelCount, getRotationTransform, getSeries, getSeriesCount, getSeriesMeta, getSeriesMetadata, getSeriesMetadataValue, getSeriesUsedFiles, getSeriesUsedFiles, getSizeC, getSizeT, getSizeX, getSizeY, getSizeZ, getSupportedMetadataLevels, getThumbSizeX, getThumbSizeY, getUnderlyingReaders, getUsedFiles, getUsedFiles, getZCTCoords, getZCTModuloCoords, hasCompanionFiles, hasFlattenedResolutions, isFalseColor, isGroupFiles, isIndexed, isInterleaved, isInterleaved, isLittleEndian, isMetadataComplete, isMetadataFiltered, isNormalized, isOrderCertain, isOriginalMetadataPopulated, isRGB, isSingleFile, isThisType, isThisType, isThisType, isThumbnailSeries, isUsedFile, makeFilterMetadata, openBytes, openBytes, openBytes, openPlane, openThumbBytes, readPlane, readPlane, reopenFile, seriesToCoreIndex, setCoreIndex, setFlattenedResolutions, setGroupFiles, setId, setMetadataFiltered, setMetadataOptions, setMetadataStore, setNormalized, setOriginalMetadataPopulated, setResolution, setSeries

Methods inherited from class loci.formats.FormatHandler

checkSuffix, checkSuffix, getFormat, getNativeDataType, getSuffixes

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

Field Detail

DM3_MAGIC_BYTES

public static final int DM3_MAGIC_BYTES

See Also:

Constant Field Values

DM4_MAGIC_BYTES

public static final int DM4_MAGIC_BYTES

See Also:

Constant Field Values

GROUP

private static final int GROUP

Tag types.

See Also:

Constant Field Values

VALUE

private static final int VALUE

See Also:

Constant Field Values

ARRAY

private static final int ARRAY

Data types.

See Also:

Constant Field Values

SHORT

private static final int SHORT

See Also:

Constant Field Values

USHORT

private static final int USHORT

See Also:

Constant Field Values

INT

private static final int INT

See Also:

Constant Field Values

UINT

private static final int UINT

See Also:

Constant Field Values

FLOAT

private static final int FLOAT

See Also:

Constant Field Values

DOUBLE

private static final int DOUBLE

See Also:

Constant Field Values

BYTE

private static final int BYTE

See Also:

Constant Field Values

UBYTE

private static final int UBYTE

See Also:

Constant Field Values

CHAR

private static final int CHAR

See Also:

Constant Field Values

UNKNOWN

private static final int UNKNOWN

See Also:

Constant Field Values

UNKNOWN2

private static final int UNKNOWN2

See Also:

Constant Field Values

pixelOffset

private long pixelOffset

Offset to pixel data.

pixelSizes

private List<Double> pixelSizes

List of pixel sizes.

units

private List<String> units

bytesPerPixel

private int bytesPerPixel

pixelDataNum

private int pixelDataNum

numPixelBytes

private int numPixelBytes

signed

private boolean signed

timestamp

private long timestamp

gamma

private double gamma

mag

private double mag

voltage

private double voltage

info

private String info

posX

private Length posX

posY

private Length posY

posZ

private Length posZ

sampleTime

private double sampleTime

adjustEndianness

private boolean adjustEndianness

version

private int version

Constructor Detail

GatanReader

public GatanReader()

Constructs a new Gatan reader.

Method Detail

isThisType

public boolean isThisType(RandomAccessInputStream stream)
                   throws IOException

Description copied from interface: IFormatReader

Checks if the given stream is a valid stream for this file format.

Specified by:

isThisType in interface IFormatReader

Overrides:

isThisType in class FormatReader

Throws:

IOException

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.

See Also:

IFormatReader.openBytes(int, byte[], int, int, int, int)

close

public void close(boolean fileOnly)
           throws IOException

Description copied from interface: IFormatReader

Closes the currently open file. If the flag is set, this is all that happens; if unset, it is equivalent to calling Closeable.close().

Specified by:

close in interface IFormatReader

Overrides:

close in class FormatReader

Throws:

IOException

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

parseTags

private void parseTags(int numTags,
             String parent,
             String indent)
                throws FormatException,
                       IOException,
                       ParseException

Parses Gatan DM3 tags. Information on the DM3 structure found at: http://rsb.info.nih.gov/ij/plugins/DM3Format.gj.html and http://www-hrem.msm.cam.ac.uk/~cbb/info/dmformat/ The basic structure is this: the file is comprised of a list of tags. Each tag is either a data tag or a group tag. Group tags are simply containers for more group and data tags, where data tags contain actual metadata. Each data tag is comprised of a type (byte, short, etc.), a label, and a value.

Throws:

FormatException

IOException

ParseException

readValue

private double readValue(int type)
                  throws IOException

Throws:

IOException

getNumBytes

private int getNumBytes(int type)

skipPadding

private void skipPadding()
                  throws IOException

Throws:

IOException

correctForUnits

private Double correctForUnits(Double value,
                     String units)