## On this page

  

 

 # SensorCommonBuilder Class Reference

 Last update: 16.07.2025 

A base class for all Sensor Builders. [More...](#details)

Inheritance diagram for SensorCommonBuilder:

 ![](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/class_speos_n_x__2412_1_1_sensor_common_builder.png)



## <a id="pub-methods" name="pub-methods"></a>Public Member Functions

 'bool' [IsTemplateFileValid](#a9903334ee3f31502bf70eb52e9f9dadb) (self) Checks whether the template file is valid.   
 ![-](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/closed.png) Public Member Functions inherited from [FeatureBuilder](class_speos_n_x__2412_1_1_feature_builder.xhtml) 'None' **ShowResult** (self) Updates the feature to reflect the result of an edit to the feature for all builders that support showing results.   
 ![-](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/closed.png) Public Member Functions inherited from [Builder](class_speos_n_x__2412_1_1_builder.xhtml) 'None' [Commit](class_speos_n_x__2412_1_1_builder.xhtml#a77581800008ea3179049e650e9d1787b) (self) Commits any edits that have been applied to the builder.   
 ## <a id="pub-static-attribs" name="pub-static-attribs"></a>Static Public Attributes

str [AxisSystem](#af0a012d49a5b59a4f43bb342b8c725c2) = property(fget=\_\_GetAxisSystem) Gets the Axis System of the Sensor.   
 str [DimensionFromFile](#a0133c03caa27c4a2c2eec6f56ac87d45) = property(fget=\_\_GetDimensionFromFile, fset=\_\_SetDimensionFromFile) Gets or sets the property to enable the use of dimensions that come from File.   
 str [DisplayPropertiesFromFile](#aa9f06ab58588bea04699f00b412161c6) = property(fget=\_\_GetDisplayPropertiesFromFile, fset=\_\_SetDisplayPropertiesFromFile) Gets or sets the property to enable the use of display properties that come from File.   
 str [GridOriginX](#a3e462caa50357a9788b8735930dc8af0) = property(fget=\_\_GetGridOriginX, fset=\_\_SetGridOriginX) Gets or sets the grid X origin.   
 str [GridOriginY](#a7c3aa08faef640884a10d6766ce36efe) = property(fget=\_\_GetGridOriginY, fset=\_\_SetGridOriginY) Gets or sets the grid Y origin.   
 str [GridStepX](#a03d8d2fd56c4163a396dc0fd8a90f963) = property(fget=\_\_GetGridStepX, fset=\_\_SetGridStepX) Gets or sets the grid X step.   
 str [GridStepY](#a2528f56fb7db94f6d20bbed9d51bde14) = property(fget=\_\_GetGridStepY, fset=\_\_SetGridStepY) Gets or sets the grid Y step.   
 str [SensorFilter](#a187957a21db7d300e5dec39e3762d6fa) = property(fget=\_\_GetSensorFilter) Gets the sensor filter.   
 str [ShowGrid](#a7472c93e10d87ea740d116838e5f5f50) = property(fget=\_\_GetShowGrid, fset=\_\_SetShowGrid) Gets or sets the property to enable grid preview.   
 str [TemplateFilePath](#a2fead9d4fee3c7c05710d79edf5d4bf5) = property(fget=\_\_GetTemplateFilePath, fset=\_\_SetTemplateFilePath) Gets or sets the template file's path.   
 str [TemplateType](#a7d7e05d22f3cf6511873f0e5d5150dbc) = property(fget=\_\_GetTemplateType) Gets or sets the template type.   
 str [Type](#a71656f4f93df1e4a4f6dfe758863b287) = property(fget=\_\_GetType, fset=\_\_SetType) Gets or sets the type of the sensor.   
 str [UseTemplateFile](#a529d5c46dc317113823a9225751d711a) = property(fget=\_\_GetUseTemplateFile, fset=\_\_SetUseTemplateFile) Gets or sets the property to enable the use of template file.   
 str [WavelengthEnd](#a1d3af865fff16f6eb31305404623a867) = property(fget=\_\_GetWavelengthEnd, fset=\_\_SetWavelengthEnd) Gets or sets the wavelength ending border.   
 str [WavelengthResolution](#a4d829d8a46f0614c7c32b78ae1602fd9) = property(fget=\_\_GetWavelengthResolution, fset=\_\_SetWavelengthResolution) Gets or sets the Wavelength resolution.   
 str [WavelengthSampling](#a1a2c2043920b4b7bb6308cb22e73ec13) = property(fget=\_\_GetWavelengthSampling, fset=\_\_SetWavelengthSampling) Gets or sets the wavelength sampling.   
 str [WavelengthStart](#a93c3bc11064cbd8e5885016a97877d3e) = property(fget=\_\_GetWavelengthStart, fset=\_\_SetWavelengthStart) Gets or sets the wavelength starting border.   
 str [XEnd](#a26309a89380b2756527ec19cffef2b6c) = property(fget=\_\_GetXEnd, fset=\_\_SetXEnd) Gets or sets the Sensor X end dimension value.   
 str [XMirroredExtent](#ae7c2faf5c62ec2baf03149375fadd672) = property(fget=\_\_GetXMirroredExtent, fset=\_\_SetXMirroredExtent) Gets the Sensor X dimension mirrored extent value.   
 str [XResolution](#af339e4c5181343e4c3e38d92c9c05c47) = property(fget=\_\_GetXResolution, fset=\_\_SetXResolution) Gets or sets the Sensor X dimension resolution value.   
 str [XSampling](#a9694a3d43cce188431740d9b8c364ac2) = property(fget=\_\_GetXSampling, fset=\_\_SetXSampling) Gets or sets the Sensor X dimension sampling value.   
 str [XStart](#abcbac58872bdd9d694ee7177d1ef7973) = property(fget=\_\_GetXStart, fset=\_\_SetXStart) Gets or sets the Sensor X start dimension value.   
 str [YEnd](#a3106ba653a070cd30ef2357bddd2cf60) = property(fget=\_\_GetYEnd, fset=\_\_SetYEnd) Gets or sets the Sensor Y end dimension value.   
 str [YMirroredExtent](#a1a4644fb780cae70d397e455eac08e13) = property(fget=\_\_GetYMirroredExtent, fset=\_\_SetYMirroredExtent) Gets the Sensor Y dimension mirrored extent value.   
 str [YResolution](#a213abc811c0466065f36593a1520259b) = property(fget=\_\_GetYResolution, fset=\_\_SetYResolution) Gets or sets the Sensor Y dimension resolution value.   
 str [YSampling](#a223ff92346c9c64903238723f549419b) = property(fget=\_\_GetYSampling, fset=\_\_SetYSampling) Gets or sets the Sensor Y dimension sampling value.   
 str [YStart](#accbaddec059ec07b1ca7f3a94b4574d2) = property(fget=\_\_GetYStart, fset=\_\_SetYStart) Gets or sets the Sensor Y start dimension value.   
 ![-](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/closed.png) Static Public Attributes inherited from [FeatureBuilder](class_speos_n_x__2412_1_1_feature_builder.xhtml)str [Feature](class_speos_n_x__2412_1_1_feature_builder.xhtml#af5dac7005c95ef44c2b66d7270709d0b) = property(fget=\_\_GetFeature) Returns the feature being edited, or the created feature if the builder is being used in creation mode.   
 str [FullName](class_speos_n_x__2412_1_1_feature_builder.xhtml#a6aac8aea55e1f962045d07a12b6569ea) = property(fget=\_\_GetFullName) Gets the full name of the feature being edited.   
 str [Name](class_speos_n_x__2412_1_1_feature_builder.xhtml#a19218d0239b929ca8aecfa629d0185d0) = property(fget=\_\_GetName, fset=\_\_SetName) Gets or sets the name of the feature being edited.   
 str [NameWithContext](class_speos_n_x__2412_1_1_feature_builder.xhtml#a89ee075a30b71ff6e3192d6bd6dd5515) = property(fget=\_\_GetNameWithContext) Gets the name with context of the feature being edited.   
 str [Status](class_speos_n_x__2412_1_1_feature_builder.xhtml#abfd5ba295bea008a0edf2f1a85bc6368) = property(fget=\_\_GetStatus) Returns the status of the feature being edited.   
 ## <a id="properties" name="properties"></a>Properties

<a id="a50e9fbdd6a13e9e50cfba34656086bb6" name="a50e9fbdd6a13e9e50cfba34656086bb6"></a> **thisown** = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') ![-](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/closed.png) Properties inherited from [FeatureBuilder](class_speos_n_x__2412_1_1_feature_builder.xhtml) **thisown** = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') ![-](/sites/default/files/migrate-content/speos_nx_library_2025_r2_1/closed.png) Properties inherited from [Builder](class_speos_n_x__2412_1_1_builder.xhtml) **thisown** = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') <a id="details" name="details"></a>## Detailed Description

A base class for all Sensor Builders.

A Builder is an object that is used to create and edit Features.

This is an abstract class that provides the basic functionality common to all builders. See the Builder subclasses for details of application-specific builders.

This is an abstract class, and cannot be instantiated.



## Member Function Documentation

<a id="a9903334ee3f31502bf70eb52e9f9dadb" name="a9903334ee3f31502bf70eb52e9f9dadb"></a>## [◆ ](#a9903334ee3f31502bf70eb52e9f9dadb)IsTemplateFileValid()

  'bool' IsTemplateFileValid  (  *self*) 

Checks whether the template file is valid.

ReturnsTrue: The template file is valid.  
 False: The template file is not valid. 



## Member Data Documentation

<a id="af0a012d49a5b59a4f43bb342b8c725c2" name="af0a012d49a5b59a4f43bb342b8c725c2"></a>## [◆ ](#af0a012d49a5b59a4f43bb342b8c725c2)AxisSystem

 str [AxisSystem](class_speos_n_x__2412_1_1_axis_system.xhtml) = property(fget=\_\_GetAxisSystem)  static 

Gets the Axis System of the Sensor.

**Value type**: AxisSystem object.





<a id="a0133c03caa27c4a2c2eec6f56ac87d45" name="a0133c03caa27c4a2c2eec6f56ac87d45"></a>## [◆ ](#a0133c03caa27c4a2c2eec6f56ac87d45)DimensionFromFile

 str DimensionFromFile = property(fget=\_\_GetDimensionFromFile, fset=\_\_SetDimensionFromFile)  static 

Gets or sets the property to enable the use of dimensions that come from File.

True: Uses the following values from the XMP template: type, X and Y size, Wavelength values.  
 False: Does not use the dimension from file.

**Value type**: Boolean.

The default value is False.





<a id="aa9f06ab58588bea04699f00b412161c6" name="aa9f06ab58588bea04699f00b412161c6"></a>## [◆ ](#aa9f06ab58588bea04699f00b412161c6)DisplayPropertiesFromFile

 str DisplayPropertiesFromFile = property(fget=\_\_GetDisplayPropertiesFromFile, fset=\_\_SetDisplayPropertiesFromFile)  static 

Gets or sets the property to enable the use of display properties that come from File.

True: Uses all the grid related values from the .xml file.  
 False: Does not use the Display properties from file.

**Value type**: Boolean.

The default value is False.





<a id="a3e462caa50357a9788b8735930dc8af0" name="a3e462caa50357a9788b8735930dc8af0"></a>## [◆ ](#a3e462caa50357a9788b8735930dc8af0)GridOriginX

 str GridOriginX = property(fget=\_\_GetGridOriginX, fset=\_\_SetGridOriginX)  static 

Gets or sets the grid X origin.

**Value type**: Double.

The default value is 0.0.





<a id="a7c3aa08faef640884a10d6766ce36efe" name="a7c3aa08faef640884a10d6766ce36efe"></a>## [◆ ](#a7c3aa08faef640884a10d6766ce36efe)GridOriginY

 str GridOriginY = property(fget=\_\_GetGridOriginY, fset=\_\_SetGridOriginY)  static 

Gets or sets the grid Y origin.

**Value type**: Double.

The default value is 0.0.





<a id="a03d8d2fd56c4163a396dc0fd8a90f963" name="a03d8d2fd56c4163a396dc0fd8a90f963"></a>## [◆ ](#a03d8d2fd56c4163a396dc0fd8a90f963)GridStepX

 str GridStepX = property(fget=\_\_GetGridStepX, fset=\_\_SetGridStepX)  static 

Gets or sets the grid X step.

**Value type**: Double.  
**Range**: The value must be superior to 0.

The default value is 10.0.





<a id="a2528f56fb7db94f6d20bbed9d51bde14" name="a2528f56fb7db94f6d20bbed9d51bde14"></a>## [◆ ](#a2528f56fb7db94f6d20bbed9d51bde14)GridStepY

 str GridStepY = property(fget=\_\_GetGridStepY, fset=\_\_SetGridStepY)  static 

Gets or sets the grid Y step.

**Value type**: Double.  
**Range**: The value must be superior to 0.

The default value is 10.0.





<a id="a187957a21db7d300e5dec39e3762d6fa" name="a187957a21db7d300e5dec39e3762d6fa"></a>## [◆ ](#a187957a21db7d300e5dec39e3762d6fa)SensorFilter

 str [SensorFilter](class_speos_n_x__2412_1_1_sensor_filter.xhtml) = property(fget=\_\_GetSensorFilter)  static 

Gets the sensor filter.

**Value type**: SensorFilter object.





<a id="a7472c93e10d87ea740d116838e5f5f50" name="a7472c93e10d87ea740d116838e5f5f50"></a>## [◆ ](#a7472c93e10d87ea740d116838e5f5f50)ShowGrid

 str ShowGrid = property(fget=\_\_GetShowGrid, fset=\_\_SetShowGrid)  static 

Gets or sets the property to enable grid preview.

True: Displays a grid on the sensor.  
 False: Does not display a grid on the sensor.

**Value type**: Boolean.

The default value is True.





<a id="a2fead9d4fee3c7c05710d79edf5d4bf5" name="a2fead9d4fee3c7c05710d79edf5d4bf5"></a>## [◆ ](#a2fead9d4fee3c7c05710d79edf5d4bf5)TemplateFilePath

 str TemplateFilePath = property(fget=\_\_GetTemplateFilePath, fset=\_\_SetTemplateFilePath)  static 

Gets or sets the template file's path.

**Value type**: String.

The default value is an empty string.





<a id="a7d7e05d22f3cf6511873f0e5d5150dbc" name="a7d7e05d22f3cf6511873f0e5d5150dbc"></a>## [◆ ](#a7d7e05d22f3cf6511873f0e5d5150dbc)TemplateType

 str TemplateType = property(fget=\_\_GetTemplateType)  static 

Gets or sets the template type.

The values are:  
 0 - None  
 1 - Measure  
 2 - Template

**Value type**: Integer.

The default value is 0.





<a id="a71656f4f93df1e4a4f6dfe758863b287" name="a71656f4f93df1e4a4f6dfe758863b287"></a>## [◆ ](#a71656f4f93df1e4a4f6dfe758863b287)Type

 str Type = property(fget=\_\_GetType, fset=\_\_SetType)  static 

Gets or sets the type of the sensor.

The values are:  
 0 - Photometric, results in cd.  
 1 - Colorimetric, color results in cd or W/sr.  
 2 - Radiometric, results in W/sr.  
 3 - Spectral, results in cd or W/sr.

**Value type**: Integer.

The default value is 0.





<a id="a529d5c46dc317113823a9225751d711a" name="a529d5c46dc317113823a9225751d711a"></a>## [◆ ](#a529d5c46dc317113823a9225751d711a)UseTemplateFile

 str UseTemplateFile = property(fget=\_\_GetUseTemplateFile, fset=\_\_SetUseTemplateFile)  static 

Gets or sets the property to enable the use of template file.

True: Enables Template File.   
 False: Disables Template File.

**Value type**: Boolean.





<a id="a1d3af865fff16f6eb31305404623a867" name="a1d3af865fff16f6eb31305404623a867"></a>## [◆ ](#a1d3af865fff16f6eb31305404623a867)WavelengthEnd

 str WavelengthEnd = property(fget=\_\_GetWavelengthEnd, fset=\_\_SetWavelengthEnd)  static 

Gets or sets the wavelength ending border.

**Prerequisite**: The Type property must be 1 or 3.

The sensor does not take account wavelengths beyond the borders that you define.

**Value type**: Double (in nm).

The default value is 700.0 nm.





<a id="a4d829d8a46f0614c7c32b78ae1602fd9" name="a4d829d8a46f0614c7c32b78ae1602fd9"></a>## [◆ ](#a4d829d8a46f0614c7c32b78ae1602fd9)WavelengthResolution

 str WavelengthResolution = property(fget=\_\_GetWavelengthResolution, fset=\_\_SetWavelengthResolution)  static 

Gets or sets the Wavelength resolution.

**Prerequisite**: The Type property must be 1 or 3.

**Value type**: Double.





<a id="a1a2c2043920b4b7bb6308cb22e73ec13" name="a1a2c2043920b4b7bb6308cb22e73ec13"></a>## [◆ ](#a1a2c2043920b4b7bb6308cb22e73ec13)WavelengthSampling

 str WavelengthSampling = property(fget=\_\_GetWavelengthSampling, fset=\_\_SetWavelengthSampling)  static 

Gets or sets the wavelength sampling.

**Prerequisite**: The Type property must be 1 or 3.

**Value type**: Integer.  
**Range**: The value must be superior to 0.

The default value is 13.





<a id="a93c3bc11064cbd8e5885016a97877d3e" name="a93c3bc11064cbd8e5885016a97877d3e"></a>## [◆ ](#a93c3bc11064cbd8e5885016a97877d3e)WavelengthStart

 str WavelengthStart = property(fget=\_\_GetWavelengthStart, fset=\_\_SetWavelengthStart)  static 

Gets or sets the wavelength starting border.

**Prerequisite**: The Type property must be 1 or 3.

The sensor does not take account wavelengths beyond the borders that you define.

**Value type**: Double (in nm).

The default value is 400.0 nm.





<a id="a26309a89380b2756527ec19cffef2b6c" name="a26309a89380b2756527ec19cffef2b6c"></a>## [◆ ](#a26309a89380b2756527ec19cffef2b6c)XEnd

 str XEnd = property(fget=\_\_GetXEnd, fset=\_\_SetXEnd)  static 

Gets or sets the Sensor X end dimension value.

**Value type**: Double (in mm).

The default value is 50.0 mm.





<a id="ae7c2faf5c62ec2baf03149375fadd672" name="ae7c2faf5c62ec2baf03149375fadd672"></a>## [◆ ](#ae7c2faf5c62ec2baf03149375fadd672)XMirroredExtent

 str XMirroredExtent = property(fget=\_\_GetXMirroredExtent, fset=\_\_SetXMirroredExtent)  static 

Gets the Sensor X dimension mirrored extent value.

True: XStart == -XEnd, you can only change the XEnd value.  
 False: XStart and XEnd can have different value.

**Value type**: Boolean.

The default value is False.





<a id="af339e4c5181343e4c3e38d92c9c05c47" name="af339e4c5181343e4c3e38d92c9c05c47"></a>## [◆ ](#af339e4c5181343e4c3e38d92c9c05c47)XResolution

 str XResolution = property(fget=\_\_GetXResolution, fset=\_\_SetXResolution)  static 

Gets or sets the Sensor X dimension resolution value.

**Value type**: Double.





<a id="a9694a3d43cce188431740d9b8c364ac2" name="a9694a3d43cce188431740d9b8c364ac2"></a>## [◆ ](#a9694a3d43cce188431740d9b8c364ac2)XSampling

 str XSampling = property(fget=\_\_GetXSampling, fset=\_\_SetXSampling)  static 

Gets or sets the Sensor X dimension sampling value.

**Value type**: Integer.

The default value is 100.





<a id="abcbac58872bdd9d694ee7177d1ef7973" name="abcbac58872bdd9d694ee7177d1ef7973"></a>## [◆ ](#abcbac58872bdd9d694ee7177d1ef7973)XStart

 str XStart = property(fget=\_\_GetXStart, fset=\_\_SetXStart)  static 

Gets or sets the Sensor X start dimension value.

**Value type**: Double (in mm).

The default value is -50.0 mm.





<a id="a3106ba653a070cd30ef2357bddd2cf60" name="a3106ba653a070cd30ef2357bddd2cf60"></a>## [◆ ](#a3106ba653a070cd30ef2357bddd2cf60)YEnd

 str YEnd = property(fget=\_\_GetYEnd, fset=\_\_SetYEnd)  static 

Gets or sets the Sensor Y end dimension value.

**Value type**: Double (in mm).

The default value is 50.0 mm.





<a id="a1a4644fb780cae70d397e455eac08e13" name="a1a4644fb780cae70d397e455eac08e13"></a>## [◆ ](#a1a4644fb780cae70d397e455eac08e13)YMirroredExtent

 str YMirroredExtent = property(fget=\_\_GetYMirroredExtent, fset=\_\_SetYMirroredExtent)  static 

Gets the Sensor Y dimension mirrored extent value.

True: YStart == -YEnd, you can only change the YEnd value.  
 False: YStart and YEnd can have different value.

**Value type**: Boolean.

The default value is False.





<a id="a213abc811c0466065f36593a1520259b" name="a213abc811c0466065f36593a1520259b"></a>## [◆ ](#a213abc811c0466065f36593a1520259b)YResolution

 str YResolution = property(fget=\_\_GetYResolution, fset=\_\_SetYResolution)  static 

Gets or sets the Sensor Y dimension resolution value.

**Value type**: Double.





<a id="a223ff92346c9c64903238723f549419b" name="a223ff92346c9c64903238723f549419b"></a>## [◆ ](#a223ff92346c9c64903238723f549419b)YSampling

 str YSampling = property(fget=\_\_GetYSampling, fset=\_\_SetYSampling)  static 

Gets or sets the Sensor Y dimension sampling value.

**Value type**: Integer.

The default value is 100.





<a id="accbaddec059ec07b1ca7f3a94b4574d2" name="accbaddec059ec07b1ca7f3a94b4574d2"></a>## [◆ ](#accbaddec059ec07b1ca7f3a94b4574d2)YStart

 str YStart = property(fget=\_\_GetYStart, fset=\_\_SetYStart)  static 

Gets or sets the Sensor Y start dimension value.

**Value type**: Double (in mm).

The default value is -50.0 mm.





---

The documentation for this class was generated from the following file:- **SpeosNX\_2412.py**