org.anchoranalysis.plugin.io.bean.stack.reader

Class ReadVoxelExtentXml

Object

AnchorBean<StackReader>

StackReader

ReadVoxelExtentXml

public class ReadVoxelExtentXml
extends StackReader

Reads Resolution from an XML file associated an image.

Any existing Resolution is replaced.

The XML file is expected at the file path of the image, with .xml appended. e.g. someImage.tif would have metadata at someImage.tif.xml

The format of the XML is described in ResolutionAsXml.

Author:

Owen Feehan

Constructor Summary

Constructors

Constructor and Description
ReadVoxelExtentXml()

Method Summary

Modifier and Type	Method and Description
StackReader	getStackReader() Reads an image before a resolution is imposed.
boolean	isAcceptNoResolution() If false, an exception is thrown if the resolution file is missing for a particular image.
OpenedImageFile	openFile(Path path) Opens a file containing one or more images but does not read an image.
static Optional<Resolution>	readMetadata(Path filePath, boolean acceptNoResolution) Looks for a metadata file describing the resolution
void	setAcceptNoResolution(boolean acceptNoResolution) If false, an exception is thrown if the resolution file is missing for a particular image.
void	setStackReader(StackReader stackReader) Reads an image before a resolution is imposed.

Methods inherited from class StackReader

readStack

Methods inherited from class AnchorBean

checkMisconfigured, describeBean, describeChildren, duplicateBean, fields, findFieldsOfClass, getBeanName, getLocalPath, localise, toString

Methods inherited from class Object

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

Constructor Detail

ReadVoxelExtentXml

public ReadVoxelExtentXml()

Method Detail

readMetadata

public static Optional<Resolution> readMetadata(Path filePath,
                                                boolean acceptNoResolution)
                                         throws ImageIOException

Looks for a metadata file describing the resolution

Given an existing image filepath, the filePath.xml is checked e.g. given /somePath/stackReader.tif it will look for /somePath/RasterRader.tif.xml

Parameters:

filePath - the filepath of the image

acceptNoResolution - if false, an exception is thrown if the resolution file is missing for a particular image.

Returns:

the scene res if the metadata file exists and was parsed. null otherwise.

Throws:

ImageIOException

openFile

public OpenedImageFile openFile(Path path)
                         throws ImageIOException

Description copied from class: StackReader

Opens a file containing one or more images but does not read an image.

Specified by:

openFile in class StackReader

Parameters:

path - where the file is located

Returns:

an interface to the opened file that should be closed when no longer in use.

Throws:

ImageIOException - if the file cannot be read.

getStackReader

public StackReader getStackReader()

Reads an image before a resolution is imposed.

setStackReader

public void setStackReader(StackReader stackReader)

Reads an image before a resolution is imposed.

isAcceptNoResolution

public boolean isAcceptNoResolution()

If false, an exception is thrown if the resolution file is missing for a particular image.

setAcceptNoResolution

public void setAcceptNoResolution(boolean acceptNoResolution)

If false, an exception is thrown if the resolution file is missing for a particular image.