Object Archive Region

The ObjectArchiveRegionBuilder class extracts regions from objects stored in an ObjectArchive. It provides a way to extract a bounded region around a Martian object by analyzing all peak shapes across time points for further processing or visualization.

Constructor

ObjectArchiveRegionBuilder(Context context, ObjectArchive objectArchive)

Creates a new builder for extracting object regions.

Parameters:

context: The SciJava context
objectArchive: The archive containing the objects

Methods

Setting the Object

Method	Description
`setObject(MartianObject martianObject)`	Set the object to use for region extraction. Returns: This builder for method chaining
`setObject(String UID)`	Set the object to use by its UID. Parameters: `UID` - The unique identifier of the object Returns: This builder for method chaining

Setting Border Size

Method	Description
`setBorderWidth(int width)`	Set the border width around the object in pixels. Parameters: `width` - Border width in pixels Returns: This builder for method chaining
`setBorderHeight(int height)`	Set the border height around the object in pixels. Parameters: `height` - Border height in pixels Returns: This builder for method chaining

Building the Region

Method	Description
`build()`	Extracts the region around the object. The region is defined by analyzing all peak shapes across time points to find the bounding box that encompasses all shape coordinates, with added borders. Returns: An `ImgPlus<?>` containing the extracted region
`getImage()`	Get the built image (same as returned by `build()`). Returns: The `ImgPlus<?>` containing the extracted region

Example Usage

// Create the builder
ObjectArchiveRegionBuilder regionBuilder = 
    new ObjectArchiveRegionBuilder(context, objectArchive);

// Configure and build
ImgPlus<?> imgPlus = regionBuilder
    .setObject("objectUID")
    .setBorderWidth(10)
    .setBorderHeight(10)
    .build();

Implementation Details

The class uses the MarsIntervalExporter to export an interval from the archive that contains the object. The interval is computed by:

Iterating through all time points where the object has shape data
Examining all coordinates from the peak shapes (x and y arrays)
Finding the minimum and maximum X and Y coordinates across all shapes and time points
Adding the specified borders to create the final extraction interval

This ensures that the extracted region encompasses the entire object trajectory across time while maintaining a consistent field of view suitable for montage creation or further analysis.