SizeMappingComponent

A reusable component for point-cloud rendering that controls how per-point data influences rendered point size. It is intended for datasets where point size should convey meaning instead of remaining visually uniform.

When enabled, the component selects one data parameter from the loaded dataset and uses that value as a multiplicative size input for each point. This makes it possible to encode attributes such as physical size, intensity, uncertainty, or any other scalar quantity directly into the visual scale of the point cloud.

The component is structured as a configurable property owner, so it can be embedded into larger point-cloud renderables. Rather than defining the available parameters itself, it works with a provided list of size-capable dataset columns and lets one of them be chosen as the active mapping source.

It also handles unit conversion for size values. Dataset values can be interpreted in a known distance unit or through an explicit numeric conversion factor, allowing the same logic to work across sources that express size in different scales. This is important when point sizes represent physical quantities that need to remain meaningful in the scene.

In addition, the component supports interpreting incoming values as either radius or diameter. This allows it to adapt to differing dataset conventions without requiring the source data to be reformatted.

Members

Name	Documentation	Type	Description	Optional
Enabled	If this value is set to ‘true’ and at least one column was loaded as an option for size mapping, the chosen data column will be used to scale the size of the points. The first option in the list is selected per default.	Boolean	Value of type ‘Boolean’	Yes
IsRadius	If true, the size value in the data is interpreted as the radius of the points. Otherwise, it is interpreted as the diameter.	Boolean	Value of type ‘Boolean’	Yes
Parameter	This value determines which parameter is used for scaling of the point. The parameter value will be used as a multiplicative factor to scale the size of the points. Note that they may however still be scaled by max size adjustment effects.	String	Value of type ‘String’	Yes
ParameterOptions	A list specifying all parameters that may be used for size mapping, i.e. scaling the points based on the provided data columns.	Table	Table parameters	Yes
ScaleFactor	The scale used for the size values in the dataset, given as either a string representing a specific unit or a value to multiply all the datapoints with to convert the value to meter. The resulting value will be applied as a multiplicative factor. For example, if the size data is given in is in kilometers then specify either ScaleFactor = ‘Kilometer’ or ScaleFactor = 1000.0.	String, or Double	In list { Nanometer, Micrometer, Millimeter, Centimeter, Decimeter, Meter, Kilometer, AU, Lighthour, Lightday, Lightmonth, Lightyear, Parsec, Kiloparsec, Megaparsec, Gigaparsec, Gigalightyear }, or Value of type ‘Double’	Yes

Table parameters for ParameterOptions

A list specifying all parameters that may be used for size mapping, i.e. scaling the points based on the provided data columns.

• Optional: Yes

Name	Documentation	Type	Description	Optional
*		String	Value of type ‘String’	Yes