rs3.results.BoltResults module#

class rs3.results.BoltResults.BoltNodeResult(grpcNodalResult)#

Bases: object

property NodeID#
property XCoordinate#
property YCoordinate#
property ZCoordinate#
property EntityName#
property EntityID#
property BoltIndex: int#

Get the bolt index for this node.

The boltIndex is an integer index that identifies which bolt or bolt pattern instance this node belongs to. The indexing starts at 1 (1-based).

  • For a single bolt: The boltIndex is a sequential index (1, 2, 3, …) that uniquely identifies each individual bolt in the model.

  • For a bolt pattern: The boltIndex represents the index of the bolt instance within the pattern. All nodes belonging to the same bolt instance in a pattern will have the same boltIndex value.

Returns:

The bolt index for this node, starting from 1.

Return type:

int

class rs3.results.BoltResults.BoltElementResults(grpcElementResults)#

Bases: object

property ElementID#
property EntityName#
property EntityID#
property NodeIDs#
getNodeResult(dataType: BoltDataType) → List[float]#
getResultsInNodeDataTuple(dataType: BoltDataType) → List[Tuple[int, float]]#
property BoltIndex: int#

Get the bolt index for this element.

The boltIndex is an integer index that identifies which bolt or bolt pattern instance this element belongs to. The indexing starts at 1 (1-based).

  • For a single bolt: The boltIndex is a sequential index (1, 2, 3, …) that uniquely identifies each individual bolt in the model.

  • For a bolt pattern: The boltIndex represents the index of the bolt instance within the pattern. All elements belonging to the same bolt instance in a pattern will have the same boltIndex value.

Returns:

The bolt index for this element, starting from 1.

Return type:

int

property YieldedElement#
class rs3.results.BoltResults.BoltResults(client: Client, projectId: str, stageNumber: int, srfResultIndex: int)#

Bases: _ResultsQueryBase

Entry point to query bolt nodal results for a given stage and SRF.

Parameters:

  • stageNumber (int) – 1-based stage index.

  • srfResultIndex (int) – 0-based SRF value index. 0 is to query SRF-None values.

Notes

  • entityName is trimmed; empty strings are ignored.

  • region=None leaves the proto field unset (service returns all).

  • Exceptions from the underlying service are propagated as-is by the client.

Examples

See Bolt Result Script Example.

getBoltNodeResults(entityName: str | None = None, region: Cube | Cylinder | Sphere | None = None, includeIntersecting: bool = True) → list[BoltNodeResult]#

Query bolt nodal results at a specific stage and SRF value. :param entityName: Optional[str]: If provided, only nodes belonging to the specified entity are queried. :param region: Optional[Union[Cube, Cylinder, Sphere]]: Sample region filter. When None, the field is not set in the request (proto3 unset), and the service returns all nodes. :param includeIntersecting: bool: If True, nodes that intersect the sample region are included. When False, only nodes fully contained are included. Ignored when region is None.

Raises:

Exception if –

  • stageNumber is less than 1 - stageNumber is greater than the number of stages in the project - _srfResultIndex is less than 0 - _srfResultIndex is greater than the number of SRF values in the project

Returns:

A list of bolt nodal results wrappers for the requested stage and SRF value.

Return type:

list[BoltNodeResult]

getBoltElementResults(entityName: str | None = None, region: Cube | Cylinder | Sphere | None = None, includeIntersecting: bool = True) → list[BoltElementResults]#

Query bolt element results at a specific stage and SRF value. :param entityName: Optional[str]: If provided, only elements belonging to the specified entity are queried. :param region: Optional[Union[Cube, Cylinder, Sphere]]: Sample region filter. When None, the field is not set in the request (proto3 unset), and the service returns all elements. :param includeIntersecting: bool: If True, elements that intersect the sample region are included. When False, only elements fully contained are included. Ignored when region is None.

Raises:

Exception if –

  • stageNumber is less than 1 - stageNumber is greater than the number of stages in the project - _srfResultIndex is less than 0 - _srfResultIndex is greater than the number of SRF values in the project

Returns:

A list of bolt element results wrappers for the requested stage and SRF value.

Return type:

list[BoltElementResults]