bdv.img.catmaid

Class CatmaidVolatileIntArrayLoader

java.lang.Object

bdv.img.catmaid.CatmaidVolatileIntArrayLoader

All Implemented Interfaces:

CacheArrayLoader<VolatileIntArray>

public class CatmaidVolatileIntArrayLoader
extends Object
implements CacheArrayLoader<VolatileIntArray>

Constructor Summary

Constructors

Constructor and Description
CatmaidVolatileIntArrayLoader(String urlFormat, int tileWidth, int tileHeight, int[] zScales) Create a CacheArrayLoader for a CATMAID source.

Method Summary

Modifier and Type	Method and Description
int	getBytesPerElement() How many bytes does one element (voxel) occupy? This is used only for statistics, i.e., estimating I/O bandwidth.
VolatileIntArray	loadArray(int timepoint, int setup, int level, int[] dimensions, long[] min) Load cell data into memory.

Methods inherited from class java.lang.Object

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

Methods inherited from interface bdv.img.cache.CacheArrayLoader

getEmptyArrayCreator

Constructor Detail

CatmaidVolatileIntArrayLoader

public CatmaidVolatileIntArrayLoader(String urlFormat,
                                     int tileWidth,
                                     int tileHeight,
                                     int[] zScales)

Create a CacheArrayLoader for a CATMAID source. Tiles are addressed, in this order, by their

• scale level,
• scale,
• x,
• y,
• z,
• tile width,
• tile height,
• tile row, and
• tile column.

urlFormat specifies how these parameters are used to generate a URL referencing the tile. Examples:

"http://catmaid.org/my-data/xy/%5$d/%8$d_%9$d_%1$d.jpg"

CATMAID DefaultTileSource (type 1)

"http://catmaid.org/my-data/xy/?x=%3$d&y=%4$d&width=%6d&height=%7$d&row=%8$d&col=%9$d&scale=%2$f&z=%4$d"

CATMAID RequestTileSource (type 2)

"http://catmaid.org/my-data/xy/%1$d/%5$d/%8$d/%9$d.jpg"

CATMAID LargeDataTileSource (type 5)

Parameters:

urlFormat -

tileWidth -

tileHeight -

Method Detail

getBytesPerElement

public int getBytesPerElement()

Description copied from interface: CacheArrayLoader

How many bytes does one element (voxel) occupy? This is used only for statistics, i.e., estimating I/O bandwidth. Implementing classes can return an estimate if element size is varying or unknown.

Specified by:

getBytesPerElement in interface CacheArrayLoader<VolatileIntArray>

Returns:

number of bytes required to store one element.

loadArray

public VolatileIntArray loadArray(int timepoint,
                                  int setup,
                                  int level,
                                  int[] dimensions,
                                  long[] min)
                           throws InterruptedException

Description copied from interface: CacheArrayLoader

Load cell data into memory. This method blocks until data is successfully loaded. If it completes normally, the returned data is always valid. If anything goes wrong, an InterruptedException is thrown.

Parameters specify the image within the data set and the location of the cell within the image: timepoint, setup, and level define the stack, where setup is a combination of angle, channel, etc., and level is the resolution level (for multi-resolution data). dimensions is the size of the block to load (in voxels). min is the starting coordinate of the block in the stack (in voxels).

Usually, the CacheArrayLoader interface is implemented in conjunction with implementing a ViewerImgLoader for a BDV data back-end. You do not need to be able to load blocks of arbitrary sizes and offsets here -- just the ones that you will use from the images returned by your ViewerImgLoader. For an example, look at CatmaidImageLoader. There, the blockDimensions are defined in the constructor, according to the tile size of the data set. These blockDimensions are then used for every image that the CatmaidImageLoader provides. Therefore, all calls to CacheArrayLoader.loadArray(int, int, int, int[], long[]) will have predictable dimensions (corresponding to tile size of the data set) and min offsets (multiples of the tile size).

The only exception to this rule is at the (max) border of the stack. The boundary cells may have a truncated shape. For example, if your image size is 20x20x1 and your cell size is 16x16x1, you will have cell sizes
(16x16x1), (4x16x1)
(16x4x1), (4x4x1)

Specified by:

loadArray in interface CacheArrayLoader<VolatileIntArray>

Parameters:

timepoint - the timepoint of the stack.

setup - the setup of the stack.

level - the resolution level of the stack (0 for full resolution).

dimensions - the size of the block to load (in voxels).

min - the min coordinate of the block in the stack (in voxels).

Returns:

loaded cell data.

Throws:

InterruptedException