Skip to main content

Material Property

Overview

The MaterialProperty entity represents properties associated with materials, specifically for a given MaterialClass. Each property includes details such as data type, description, and value limits, allowing materials within the same class to have standardized attributes while still allowing specific customization.

Table Structure

The following table outlines the SQL columns for the material_properties table, providing a brief description of each, along with sample data where applicable.

ColumnTypeDescriptionExample
idString (ULID)Unique identifier for the entity.01JAP8RJBN-8ZTPXSGY-J9GSDPE1
enabledBooleanIf the entity is enabled or not.true
created_dateDateTimeDate the entity was created.2024-12-31T19:48:44Z
created_byStringPerson who created the entity.TamakiMES
modified_dateDateTimeDate the entity was modified. Value is null upon creation, and gets initially populated upon the first edit.2024-12-31T19:48:44Z
modified_byStringLast person to modify the entity. Value is null upon creation, and gets initially populated upon the first edit.TamakiMES
notesStringNotes about the entity.This entity has these extra notes
spare1StringThe first spare column that can be used for additional context on the entity.some extra context 1
spare2StringThe second spare column that can be used for additional context on the entity.some extra context 2
spare3StringThe third spare column that can be used for additional context on the entity.some extra context 3
data_typeString (Enum)Specifies the data type of the property, such as INTEGER or STRING.Float
default_blob_valueBlobDefault binary value for the property if data_type is binary-compatible.N/A
default_date_valueDatetimeDefault date value for the property, if applicable.2024-05-01 00:00:00
default_float_valueDoubleDefault floating-point value, if applicable.10.5
default_int_valueBigIntDefault integer value for the property, if applicable.100
default_string_valueStringDefault string value for the property, if applicable.Default Value
nameStringName of the material property, unique within the material class.Density
descriptionStringDetailed description of the material property.Defines the density of the material
high_limitDoubleUpper limit for the property value, if applicable.10.0
low_limitDoubleLower limit for the property value, if applicable.0.1
formatStringFormatting string for the property, useful for display or input parsing.0.00
nullableBooleanIndicates if the property value can be null.false
optionsStringAdditional options or constraints for the property, if any.Option1, Option2
unit_of_measure_idString (ULID)References the unit of measure for the property. See unit_of_measure.01JAP8RJBN-4VYZUKE1-LY2QHV8X
material_class_idString (ULID)References the material class to which this property belongs. See material_classes.01JAP8R5RT-3FPXQABY-7KQZT6VF

Field Details

data_type

Specifies the data type of the property value, allowing properties to be typed as String, Integer, Float, and more, based on the material’s requirements.

default_*_value

The default value fields (default_blob_value, default_date_value, default_float_value, default_int_value, default_string_value) specify initial values for the property based on its data_type.

name

The name field is a descriptive identifier for the material property, such as "Density" or "Color."

description

An optional, detailed description of the property that provides additional context or usage information.

high_limit and low_limit

  • high_limit: The maximum allowable value for the property, if applicable.
  • low_limit: The minimum allowable value for the property, if applicable.

These fields are particularly useful for numeric properties, ensuring that values remain within an acceptable range.

format

An optional field for defining how the property should be displayed or input, such as a numeric format string.

nullable

Indicates if the property value is required or can be left empty (null).

unit_of_measure_id

References the unit of measure applicable to this property, such as kilograms or liters, supporting context for values as well as conversions. See unit_of_measure for details.

material_class_id

References the MaterialClass entity associated with this property, ensuring that each material within the class can share common properties.
See material_classes for details.