SensorCamera

class ansys.speos.core.sensor.SensorCamera(project, name, description='', metadata=None, sensor_instance=None, default_values=True)

Bases: BaseSensor

Sensor feature: Camera.

By default, regarding inherent characteristics, a camera with mode photometric is chosen. By default, regarding properties, an axis system is selected to position the sensor, and no layer separation is chosen.

Parameters:

projectansys.speos.core.project.Project

Project that will own the feature.

namestr

Name of the feature.

descriptionstr

Description of the feature. By default, "".

metadataOptional[Mapping[str, str]]

Metadata of the feature. By default, {}.

sensor_instanceansys.api.speos.scene.v2.scene_pb2.Scene.SensorInstance, optional

Sensor instance to provide if the feature does not has to be created from scratch By default, None, means that the feature is created from scratch by default.

default_valuesbool

Uses default values when True. By default, True.

Parameters:

• project (SensorCamera.__init__.project)

• name (str)

• description (str)

• metadata (Optional[Mapping[str, str]])

• sensor_instance (Optional[ansys.speos.core.kernel.scene.ProtoScene.SensorInstance])

• default_values (bool)

Overview

Methods

set_focal_length	Set the focal length.
set_imager_distance	Set the imager distance.
set_f_number	Set the f number.
set_distortion_file_uri	Set the distortion file.
set_horz_pixel	Set the horizontal pixels number corresponding to the camera resolution.
set_vert_pixel	Set the vertical pixels number corresponding to the camera resolution.
set_width	Set the width of the sensor.
set_height	Set the height of the sensor.
set_mode_geometric	Set mode geometric for the camera sensor.
set_mode_photometric	Set mode photometric for the camera sensor.
set_axis_system	Set the position of the sensor.
commit	Save feature: send the local data to the speos server database.

Properties

visual_data	Property containing camera sensor visualization data.
photometric	Property containing the instance of SensorCamera.Photometric used to build the sensor.

Import detail

from ansys.speos.core.sensor import SensorCamera

Property detail

property SensorCamera.visual_data: ansys.speos.core.generic.visualization_methods._VisualData

Property containing camera sensor visualization data.

Returns:

BaseSensor.VisualData

Instance of VisualData Class for pyvista.PolyData of feature faces, coordinate_systems.

property SensorCamera.photometric: SensorCamera | None

Property containing the instance of SensorCamera.Photometric used to build the sensor.

Returns:

Union[ansys.speos.core.sensor.SensorCamera.Photometric, None]

Photometric class instance if it exists

Method detail

SensorCamera.set_focal_length(value=5.0)

Set the focal length.

Parameters:

valuefloat

Distance between the center of the optical system and the focus. (mm) By default, 5.0.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_imager_distance(value=10)

Set the imager distance.

Parameters:

valuefloat

Imager distance (mm). The imager is located at the focal point. The Imager distance has no impact on the result. By default, 10.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_f_number(value=20)

Set the f number.

Parameters:

valuefloat

F-number represents the aperture of the front lens. F number has no impact on the result. By default, 20.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_distortion_file_uri(uri)

Set the distortion file.

Parameters:

uristr

Optical aberration that deforms and bends straight lines. The distortion is expressed in a .OPTDistortion file.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_horz_pixel(value=640)

Set the horizontal pixels number corresponding to the camera resolution.

Parameters:

valueint

The horizontal pixels number corresponding to the camera resolution. By default, 640.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_vert_pixel(value=480)

Set the vertical pixels number corresponding to the camera resolution.

Parameters:

valueint

The vertical pixels number corresponding to the camera resolution. By default, 480.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_width(value=5.0)

Set the width of the sensor.

Parameters:

valuefloat

Sensor’s width (mm). By default, 5.0.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_height(value=5.0)

Set the height of the sensor.

Parameters:

valuefloat

Sensor’s height (mm). By default, 5.0.

Returns:

ansys.speos.core.sensor.SensorCamera

Camera feature

SensorCamera.set_mode_geometric()

Set mode geometric for the camera sensor.

This is a simplified version of the Camera Sensor.

Returns:

ansys.speos.core.sensor.SensorCamera

Geometric Camera feature

SensorCamera.set_mode_photometric()

Set mode photometric for the camera sensor.

This allows setting every Camera Sensor parameter, including the photometric definition parameters.

Returns:

ansys.speos.core.sensor.SensorCamera.Photometric

Photometric Camera Sensor feature

SensorCamera.set_axis_system(axis_system=None)

Set the position of the sensor.

Parameters:

axis_systemOptional[List[float]]

Position of the sensor [Ox Oy Oz Xx Xy Xz Yx Yy Yz Zx Zy Zz]. By default, [0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1].

Returns:

ansys.speos.core.sensor.SensorCamera

Camera Sensor feature

SensorCamera.commit()

Save feature: send the local data to the speos server database.

Returns:

ansys.speos.core.sensor.SensorCamera

Sensor feature.

Classes

Photometric

Mode of camera sensor : Photometric.