7.5 Asset schema

The display name of the asset, such as 'Car Model A' or 'Urban Scene 1'.

Type: string
Required: Yes

A concise summary of the asset’s purpose or features (2-3 sentences).

Type: string
Required: No

Universally unique identifier for the asset in 8-4-4-4-12 format, see en.wikipedia.org/wiki/Universally_unique_identifier. The uuid stays the same, even if version is updated.

Type: string
Pattern: \\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\\b$
Required: Yes

The version number of the asset, following semantic versioning (e.g., '1.0.0').

Type: string
Pattern: ^\\d+\\.\\d+\\.\\d+$
Required: Yes

The version of the OpenMATERIAL 3D specification used, adhering to semantic versioning (e.g., '1.0.0').

Type: string
Pattern: ^\\d+\\.\\d+\\.\\d+$
Required: Yes

Indicates copyright details, including the year and copyright holder (e.g., '© 2024 ACME Inc.').

Type: string
Required: Yes

Describes the license for asset distribution. Use an SPDX identifier for open-source licenses (e.g., 'MIT'), or provide a URL or filename for proprietary licenses.

Type: string
Required: Yes

Lists the author(s) of the asset as a name, email, or company. Multiple authors should be comma-separated.

Type: string
Required: Yes

Specifies the software or tool (and version) used to create the 3D model (e.g., 'Blender 3.5').

Type: string
Required: No

The date and time of asset creation, formatted as YYYYMMDDTHHMMSSZ according to ISO 8601 (e.g., '20240703T101728Z').

Type: string
Pattern: ^\\d{8}T\\d{6}Z$
Required: No

Indicates how the model was created, e.g., '3D scan', 'photo-based modeling', or 'freehand design'.

Type: string
Required: No

Details the validation process used to compare the model geometry with real-world objects.

Type: string
Required: No

Specifies whether the asset represents an individual object ('object') or a collection of objects ('scene').

Type: string
Enum: ['object', 'scene']
Required: Yes

Classifies the object type when 'assetType' is 'object', i.e., 'vehicle', 'human', 'environment', 'other'.

Type: string
Enum: ['vehicle', 'human', 'environment', 'other']
Required: Yes

Vehicle specific data. This SHALL be filled if 'objectClass' is 'vehicle' based on the OpenSCENARIO vehicle definition.

Type: object
Required: No

Human specific data. This SHALL be filled if 'objectClass' is 'human' based on the OpenSCENARIO pedestrian definition.

Type: object
Required: No

Indicates whether the 3D model contains keyframe animations.

Type: boolean
Required: Yes

Indicates the usage of a Physically Based Rendering (PBR) material workflow as 'metallic', 'specular' or 'none'. This only applies to the internal materials of the 3D model file, not to mapped OpenMATERIAL 3D property files.

Type: string
Enum: ['metallic', 'specular', 'none']
Required: Yes

The total number of triangles in the model. A quad polygon counts as two triangles.

Type: integer
Required: Yes

The total number of meshes in the 3D geometry. A model geometry typically consists of several sub-meshes.

Type: integer
Required: Yes

Lists all the used texture resolutions in the 3D model i.e. albedo, normal or displacement textures. Possible values are '1K', '2K', '4K'. If no textures are used in the model, add empty element ''

Type: array
Required: Yes

Items enum: ['1K', '2K', '4K', '']

Specifies whether the 3D model utilizes normal maps as textures. If so, their format should be either 'DirectX' or 'OpenGL'.

Type: string
Enum: ['DirectX', 'OpenGL', 'none']
Required: Yes

Defines the Axis-Aligned Bounding Box (AABB) which defines the spatial boundaries of an asset in a 3D space. Example: "boundingBox": { "x": [-2.5, 2.5], "y": [-1.1, 1.1],"z": [0, 1.8]}

Type: object
Required: Yes