This is the interface control document for the material bundle HDF document. The material bundle supports a subset of the materials that may be found in a scene data model. The supported materials are the ones that could reasonably be considered to be reusable and independent of the scene. The supported types of optical properties are:

  • Diffuse reflectance and transmission

  • Delta reflectance and transmission

  • Ward reflectance and transmission

  • Spherical data reflectance and transmission

The supported types of temperature models are:

  • Data-driven temperature

  • THERM

  • Classic and iterative Balfour

Mapped properties are not supported at this time due them normally being specific to the scene. However, maps may be supported in the future to support reusable texturing.

/Info

Type

Group

Required

Yes

Contains the standard datasets described in DIRSIG HDF Standard Info Section. This document is for version 1 of the data model.

/Properties

Type

Group

Required

Yes

Contains information about the bundled materials.

/Properties/ClassicBalfourTable

Type

Dataset

Data Type

ClassicBalfourRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for the classic Balfour mode. Each row contains the coefficients for the Balfour model.

/Properties/DataDrivenTempDataTable

Type

Dataset

Data Type

DataDrivenTempRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This table holds time-temperature samples that form time series for the data-driven temperature model. The bounds of the time series are given in the rows of DataDrivenTempIndexTable.

/Properties/DataDrivenTempIndexTable

Type

Dataset

Data Type

RangeEndInclusive

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for the data-driven temperature model. Each row in this table is an index range into DataDrivenTempDataTable that define a time series of temperature samples.

/Properties/IterativeBalfourTable

Type

Dataset

Data Type

IterativeBalfourRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for the iterative Balfour mode. Each row contains the coefficients for the Balfour model.

/Properties/OpticalPropertiesNames

Type

Dataset

Data Type

H5T_STRING

Dataspace Type

Simple

Dimensions

N

Required

Yes

This dataset contains the name of each optical property in the bundle. Rows in this table correspond to rows in OpticalPropertiesTable.

/Properties/OpticalPropertiesTable

Type

Dataset

Data Type

OpticalPropertiesRecord

Dataspace Type

Simple

Dimensions

N

Required

Yes

This is the top-level index table for optical properties. Each contains a property type (combination of reflectance and transmission property), as well as type-specific indices for the reflectance and transmission properties.

The type-specific tables in this file are:

Type Type-specific Table

Diffuse Reflectance

SpectralCurvesTable

Diffuse Transmission

SpectralCurvesTable

Delta Reflectance

SpectralCurvesTable

Delta Transmission

SpectralCurvesTable

Ward Reflectance

WardDataTable

Ward Transmission

WardDataTable

Spherical Data Reflectance

SphericalData/DataIndexTable

Spherical Data Transmission

SphericalData/DataIndexTable

/Properties/SpectralSamplesTable

Type

Dataset

Data Type

NATIVE_FLOAT

Dataspace Type

Simple

Dimensions

1 x M

Required

Yes

Contains the wavelength samples for the spectral curves in /Properties/SpectralCurvesTable. Each column is a wavelength in microns.

/Properties/SpectralCurvesTable

Type

Dataset

Data Type

NATIVE_FLOAT

Dataspace Type

Simple

Dimensions

N x M

Required

Yes

Contains a library of spectral curves, one per row. The sample in column M correspond to the wavelength in column M in /Properties/SpectralSamplesTable.

/Properties/SphericalData

Type

Group

Required

No

Contains all of the data for spherical data (SQT) optical properties.

/Properties/SphericalData/DataBufferTable

Type

Dataset

Data Type

NATIVE_CHAR

Dataspace Type

Simple

Dimensions

N

Required

No

Contains the spherical (SQT) data for all materials in the bundle. The bounds of the data for each material are found in DataIndexTable.

/Properties/SphericalData/DataIndexTable

Type

Dataset

Data Type

SphericalDataRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for spherical data optical properties. Each row has an index of a DHR curve and the index range in DataBufferTable of the SQT data.

/Properties/TempModelTable

Type

Dataset

Data Type

TemperatureModelRecord

Dataspace Type

Simple

Dimensions

N

Required

Yes

This is the top-level index for temperature models in the bundle. Each row has a temperature model type and a type-specific index. The type-specific tables in this file are:

Type Type-specific Table

DataDriven

DataDrivenTempIndexTable

Therm

ThermDataTable

ClassicBalfour

ClassicBalfourTable

IterativeBalfour

IterativeBalfourTable

/Properties/ThermDataTable

Type

Dataset

Data Type

ThermRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for THERM. Each row contains the thermal input parameters for a THERM model.

/Properties/WardDataTable

Type

Dataset

Data Type

WardRecord

Dataspace Type

Simple

Dimensions

N

Required

No

This serves as the type-specific table for the Ward optical properties. Each row contains the curve indices in SpectralCurvesTable.