com.luciad.fusion.tilestore.metadata

LuciadLightspeedClass ALfnCoverageMetadata

java.lang.Object

com.luciad.fusion.tilestore.metadata.ALfnResourceMetadata

com.luciad.fusion.tilestore.metadata.ALfnCoverageMetadata

All Implemented Interfaces:

ILcdBounded

Direct Known Subclasses:

TLfnCoverageMetadata, TLfnRasterCoverageMetadata, TLfnVectorCoverageMetadata

public abstract class ALfnCoverageMetadata
extends ALfnResourceMetadata
implements ILcdBounded

A representation of a coverage. It provides the following parameters in addition to those defined in the superclass:

• type: the data type of a coverage, one of ELfnDataType. If not set or set to null, an auto-default value will be used based on the assets' types.
• bounding box: the 2D bounding box of a coverage. If not set or set to null, an auto-default value will be used based on the union of the bounding boxes of the assets.
• geographic reference: the geographic reference of the bounding box. If not nset or set to null, an auto-default value will be used based on the common geographic references of the assets, or EPSG:4326 if the assets don't have a common geographic reference.
• format: the format of the tile data provided by this coverage. If not set or set to null, an auto-default value will be used based on the assets' types.
• level 0 row count: the # rows at level 0, which is the least detailed level. If not set or set to a negative value, an auto-default value will be used such that the tiles are square as much as possible.
• level 0 column count: the # columns at level 0. If not set or set to a negative value, an auto-default value will be used such that the tiles are square as much as possible.
• assets: the assets which contributed to the coverage. If not set or set to null, this defaults to the empty list.
• scale denominators: the scale denominators identifying the scales at which this coverage is best used. If not set or set to null, this defaults to the empty list.

Instances of this class are immutable, thus thread-safe.

Asset info status

The asset info status tells if an asset has already been completely fused in a coverage or not. Initially, the status is ALfnCoverageMetadata.AssetInfo.STATUS_INCOMPLETE. While fusion is ongoing, the status remains STATUS_COMPLETE. Once fusion is done, the fusion engine sets the statuses of all assets in a coverage to ALfnCoverageMetadata.AssetInfo.STATUS_COMPLETE, hereby bumping the coverage metadata's update sequence.

When adding a new asset to a coverage, its status should always be STATUS_INCOMPLETE. You should never 'choose' to change the status to STATUS_COMPLETE, that is the responsibility of the fusion engine.

Resource metadata resolvers

In order to compute auto-defaults for its properties, an ALfnCoverageMetadata.Builder needs access to the asset metadata. An ILfnResourceMetadataResolver allows a builder to gain access to the asset metadata using an asset ID.

You need a resolver if both the following conditions are true:

1. You need the builder to compute auto-defaults from the asset metadata.
2. You haven't passed the asset metadata directly to the builder using ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String).

You do not need a resolver if one of the following conditions is true:

You don't need auto-defaults, for example because you set all properties explicitly, or because the static defaults suffice. You've passed all asset metadata explicitly to the builder using ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String).

Examples

Use specific values for a coverage's geographic reference and bounding box, leave everything else to the auto-defaults:

 ALfnAssetMetadata assetMetadata1;
 ALfnAssetMetadata assetMetadata2;
 TLcdGeodeticReference epsg4326 = new TLcdGeodeticReference();
 ILcdBounds world = new TLcdLonLatBounds(-180, -90, 360, 180);
 ALfnCoverageMetadata coverageMetadata = TLfnRasterCoverageMetadata
     .newBuilder()
     .assetInfo(assetMetadata1)
     .assetInfo(assetMetadata2)
     .geoReference(epsg4326)
     .boundingBox(world)
     .build();
 

Given a coverage, create a new coverage and reset its geographic reference and bounding box to the auto-defaults. We have to us a resource resolver so that the builder can resolve asset IDs to asset metadata:

 List<ALfnAssetMetadata> assetMetadatas = Arrays.asList(assetMetadata1, assetMetadata2);
 ILfnResourceMetadataResolver resolver = new TLfnCollectionResourceMetadataResolver(assetMetadatas);
 ALfnCoverageMetadata newCoverageMetadata = coverageMetadata
     .asBuilder(resolver)
     .geoReference(null)
     .boundingBox(null)
     .build();
 

Since:

10.0