Skip to content

Commit

Permalink
Merge pull request #350 from asam-ev/Glossary-and-Terms-and-Definitions
Browse files Browse the repository at this point in the history
Update Glossary and Terms and Definitions
  • Loading branch information
ClemensLinnhoff authored Feb 3, 2025
2 parents 9c2d91d + e6c8958 commit 26d60e9
Show file tree
Hide file tree
Showing 4 changed files with 24 additions and 9 deletions.
6 changes: 6 additions & 0 deletions content/general-docs/abbreviations.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,12 @@ Automated Driving/Automated Driving Assistance Systems
BRDF::
Bidirectional Reflectance Distribution Function

BSDF::
Bidrectional Scattering Distribution Function

BTDF::
Bidirectional Transmittance Distribution Function

CAD::
Computer-Aided Design

Expand Down
8 changes: 4 additions & 4 deletions content/general-docs/introduction.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -55,18 +55,18 @@ The first interaction with an {THIS_STANDARD}-compliant _3D model_ is through th

The *asset file* is a JSON file with the file extension .xoma ({THIS_STANDARD} Asset).
A detailed definition of the https://github.com/asam-ev/OpenMATERIAL-3D/blob/main/schemas/asset_schema.json[asset file JSON schema] is given in xref:geometry/asset-schema.adoc[].
The asset file shall have the same name as a corresponding 3D data file in glTF, FBX, or USD format.
The asset file shall have the same name as a corresponding _3D data file_ in glTF, FBX, or USD format.
To facilitate instancing, multiple asset file may be linked to a single _3D model_ file by adding an index separated by a dot (.) as a suffix to the asset file name.
It contains metadata, such as description, unique identifier, version information, copyright details, and so on.
It also includes a _material_ texture assignment table, allowing dedicated _material_ mapping textures to be assigned to materials within 3D data files.
It also includes a _material_ texture assignment table, allowing dedicated _material_ mapping textures to be assigned to materials within _3D data files_.
This enables comprehensive _material properties_ to be mapped to the geometry at a texture level.
Each texel of the texture contains a 32 Bit code (8 Bit values in the rgba channels) which is mapped to a _material property_ file in a separate _material_ mapping file, linked in the asset file with a URI.
For the mapping currently only the rba channels are used (first 24 Bit).
The last channel is reserved for future use.
An https://github.com/asam-ev/OpenMATERIAL-3D/tree/main/examples/example_asset.xoma[example asset] is provided in the examples folder of the repository.

The *3D data file* is a standard _3D model_ file in glTF, FBX, or USD format.
Multiple formats can exist in parallel, so one asset file can have multiple 3D data files with different formats with the same name as the asset file.
The *_3D data file_* is a standard _3D model_ file in glTF, FBX, or USD format.
Multiple formats can exist in parallel, so one asset file can have multiple _3D data files_ with different formats with the same name as the asset file.
However, to be compliant with {THIS_STANDARD}, a simulation environment must support at least one of the named 3D data formats.
More information about the file formats is given in in xref:geometry/file-format-support.adoc[].
An https://github.com/asam-ev/OpenMATERIAL-3D/tree/main/examples/example_asset.gltf[example model] is provided in the examples folder of the repository.
Expand Down
2 changes: 1 addition & 1 deletion content/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ include::{root-path}_config.adoc[]
.Disclaimer
====
This document is the copyrighted property of ASAM e.V.
In alteration to the regular https://www.asam.net/license[license terms], ASAM allows unrestricted distribution of this standard. §2 (1) of ASAM's regular https://www.asam.net/license[license terms] is therefore substituted by the following clause: "The licensor grants everyone a basic, non-exclusive and unlimited license to use the standard {THIS_STANDARD}".
In alteration to the regular https://www.asam.net/license[license terms], ASAM allows unrestricted distribution of this standard. §2 (1) of ASAM's regular https://www.asam.net/license[license terms] is therefore substituted by the following clause: "The licensor grants everyone a basic, non-exclusive, and unlimited license to use the standard {THIS_STANDARD}".
====
ASAM OpenMATERIAL is a registered trademark of ASAM e.V.
Expand Down
17 changes: 13 additions & 4 deletions content/terms-and-definitions/terms-and-definitions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,28 @@ endif::[]
The combination of an object's 3D geometry, assigned material properties, and
specific metadata.

[[sec-3D-model]] 3D model::
A mathematical coordinate-based representation of an object's geometrical
surface. Material properties used for rendering purposes can be part of the 3D model. This excludes physical material properties. For a combination of 3D
geometry and physical material properties, see 3D asset.
[[sec-3D-data-file]] 3D data file::
A standard 3D model file in glTF, FBX, or USD format.

[[sec-3D-environment]] 3D environment::
A 3D representation of a simulated sensor's surroundings. It can consist of
multiple 3D assets.

[[sec-3D-model]] 3D model::
A mathematical coordinate-based representation of an object's geometrical
surface. Material properties used for rendering purposes can be part of the 3D model. This excludes physical material properties. For a combination of 3D
geometry and physical material properties, see 3D asset.

[[sec-Co-simulation]] Co-simulation::
Simulation of multiple independent models connected with interfaces. A
co-simulation platform handles the timing, synchronization, and data transfer between the
individual models.

[[sec-Electromagnetic-property]] Electromagnetic property::
Denotes a characteristic of an object or material when interacting with electric and magnetic fields.
+
Examples: conduction, magnetization, polarization.

[[sec-Ground-truth]] Ground truth::
Defines true static and dynamic states of objects. The true states are either
determined by the content creator or defined by an omniscient observer, for
Expand Down Expand Up @@ -78,6 +86,7 @@ described by the same properties, but has individual property values.

[[sec-Physical-property]] Physical property::
Denotes a characteristic of an object or material that can be measured.
+
Examples: permittivity, density, index of refraction.

[[sec-Post-rendering-effect]] Post rendering effect::
Expand Down

0 comments on commit 26d60e9

Please sign in to comment.