DIQ_DimensionGroupRevision

Last updated 28/02/2026

Purpose

The

DIQ_DimensionGroupRevision

type represents a calculated and configured revision of a dimension group within a project in DimensionIQ.

It defines both:

• The configuration metadata that controls how a group of dimensions behaves and appears
• The aggregated measurement results calculated from the dimensions within that group

A

DIQ_DimensionGroupRevision

enables:

• Group-level measurement configuration (display, measurement mode, defaults)
• Automatic aggregation of measurement totals
• Visual styling control (positive/negative colors)
• Structured association with a revision and folder
• Consistent reporting of quantities such as length, area, volume, and weight
• Persisted measurement summaries for a specific revision

This is commonly used when:

• Calculating totals for a grouped set of dimensions
• Displaying summarized measurement data in the UI
• Generating reports or exports
• Applying consistent measurement rules across a group

By standardizing this structure, DimensionIQ ensures predictable aggregation, consistent rendering, and reliable revision tracking.

Why This Type Exists

In measurement workflows, individual dimensions are often grouped into logical collections such as:

• Wall types
• Trade-specific scopes
• Area-based breakdowns
• Cost code groupings
• BOQ line items

Each group must:

• Maintain consistent measurement behavior
• Store aggregated totals
• Be tied to a specific revision
• Retain configuration even when dimensions change

The

DIQ_DimensionGroupRevision

exists to:

• Provide a revision-scoped container for grouped dimensions
• Capture aggregated measurement results
• Store measurement configuration rules
• Maintain separation between individual dimension data and group-level totals
• Ensure reproducible results across revisions

Because revisions represents snapshots in time, group totals and configuration must also be revision-specific. This type provides that contract.

Properties

Properties	Type	Required	Description
key	string	Yes	Unique identifier for the dimension group revision
folderKey	string	No	References the folder that organizes the group
revisionKey	string	Yes	Identifies the revision this group belongs to
name	string	Yes	Display name of the dimension group
displayType	string	Yes	Controls how measurements are visually displayed in the UI
measurementMode	string	Yes	Defines how dimensions are measured and aggregated
positiveColor	string	Yes	Color used for positive measurement values
negativeColor	string	Yes	Color used for negative measurement values
defaultHeight	number	No	Default height applied to dimensions within the group
defaultOffset	number	No	Default offset applied to dimensions within the group
count	number	Yes	Total number of dimensions in the group
length	number	No	Aggregated horizontal length
elevatedLength	number	No	Aggregated elevated or sloped length
area	number	No	Total calculated surface area
verticalArea	number	No	Total vertical surface area
volume	number	No	Total calculated volume
weight	number	No	Total calculated weight
notes	string	No	Optional descriptive noted for the group revision

Behavioral Expectations

Identity and Association

• key
  must be unique and stable within the system
• revisionKey
  must reference a valid revision
• A dimension group revision cannot exist outside the context of a revision
• Deleting a revision invalidates associated dimension group revisions

Measurement Configuration Behavior

• measureMode
  determines how dimension data is interpreted (eg, linear, area-based, volumetric)
• Changing configuration values may trigger recalculation of totals
• Display settings do not alter raw dimension geometry, only interpretation and rendering

Aggregation Behavior

The following fields represent calculated totals derived from dimensions assigned to the group:

• count
• length
• elevatedLength
• area
• verticalArea
• volume
• weight

These values:

• Are system-calculated
• Should not be manually overridden
• Reflect the state of the group at the time of the revision
• May update when dimensions are added, modified, or removed

Display Behavior

• name
  is the primary user-facing label
• displayType
  controls UI rendering style
• positiveColor
  and
  negativeColor
  affect visual feedback
• notes
  may appear in metadata panels, exports, or reports
• Folder structure influences where the group appears in the UI hierarchy

Revision Behavior

• Each revision maintains its own version of the group
• Aggregated totals are revision-specific
• Editing a group in a new revision does not retroactively modify previous revisions
• The type represents a snapshot of configuration and totals at a specific point in time

Summary

DIQ_DimensionGroupRevision

defines the revision-scoped container for grouped dimension data in DimensionIQ.

It combines:

• Organizational linkage (folder and revision)
• Measurement configuration rules
• Aggregated quantitative results
• Visual display settings

By separating individual dimension geometry from group-level configuration and totals, DimensionIQ ensures scalable measurement workflows, accurate revision tracking, consistent reporting across complex projects.