Receiver#

class ansys.stk.core.stkobjects.Receiver#

Bases: ISTKObject, ILifetimeInformation, IDisplayTime

Class defining the receiver object.

Overview#

Methods

is_refraction_type_supported

Get a value indicating whether the specified type can be used.

Properties

`chain_analysis_options`	Get the receiver’s chain analysis options.
`graphics`	Get the 2D Graphics properties for the receiver.
`graphics_3d`	Get the 3D Graphics properties for the receiver.
`laser_environment`	Get the object laser environment settings.
`model_component_linking`	Get the link/embed controller for managing the receiver model component.
`refraction`	Refraction method, a member of the SensorRefractionType enumeration.
`refraction_model`	Get a refraction model.
`refraction_supported_types`	Return an array of valid choices.
`rf_environment`	Get the object RF environment settings.
`use_refraction_in_access`	Flag controls whether refraction is applied when computing relative position in Access.

Examples#

Receiver additional Gain

# Receiver receiver: Receiver object
recModel = receiver.model_component_linking.component
gain = recModel.pre_receive_gains_losses.add(5)  # dB
gain.identifier = "Example Gain"

Modify Receiver Filter Properties

# Receiver receiver: Receiver object
recModel = receiver.model_component_linking.component
recModel.enable_filter = True
recModel.filter_component_linking.set_component("Bessel")
recFilter = recModel.filter_component_linking.component
recFilter.lower_bandwidth_limit = -20
recFilter.upper_bandwidth_limit = 20
recFilter.cut_off_frequency = 10

Modify Receiver Demodulator Properties

# Receiver receiver: Receiver object
recModel = receiver.model_component_linking.component
recModel.select_demodulator_automatically = False
recModel.set_demodulator("16PSK")

Modify Receiver System Noise Temperature

# Receiver receiver: Receiver object
receiver.model_component_linking.set_component("Complex Receiver Model")
recModel = receiver.model_component_linking.component
recModel.system_noise_temperature.constant_noise_temperature = 280  # K

Modify Orientation of the Receiver Antenna

# Complex receivers Only
# Receiver receiver: Receiver object
receiver.model_component_linking.set_component("Complex Receiver Model")
recModel = receiver.model_component_linking.component
antennaControl = recModel.antenna_control
antOrientation = antennaControl.embedded_model_orientation
antOrientation.assign_az_el(45, 85, AzElAboutBoresight.ROTATE)
antOrientation.position_offset.x = 0.5  # m
antOrientation.position_offset.y = 0.75  # m
antOrientation.position_offset.z = 1  # m

Modify Receiver Polarization Properties

# Receiver receiver: Receiver object
recModel = receiver.model_component_linking.component
recModel.enable_polarization = True
recModel.set_polarization_type(PolarizationType.LINEAR)
polarization = recModel.polarization
polarization.reference_axis = PolarizationReferenceAxis.Z
polarization.cross_polarization_leakage = -60  # dB

Modify Receiver Embedded Antenna

# Receiver receiver: Receiver object
receiver.model_component_linking.set_component("Complex Receiver Model")
recModel = receiver.model_component_linking.component
antennaControl = recModel.antenna_control
antennaControl.embedded_model_component_linking.set_component("Hemispherical")
antennaControl.embedded_model_component_linking.component.efficiency = 85  # Percent

Modify Receiver Model Type

# Receiver receiver: Receiver object
receiver.model_component_linking.set_component("Complex Receiver Model")
recModel = receiver.model_component_linking.component
recModel.track_frequency_automatically = False
recModel.frequency = 11.81

Create a New Receiver Object

# ISTKObject satellite: STK object
receiver = satellite.children.new(STKObjectType.RECEIVER, "MyReceiver")

Import detail#

from ansys.stk.core.stkobjects import Receiver

Property detail#

property Receiver.chain_analysis_options: ChainAnalysisOptions#: Get the receiver’s chain analysis options.

property Receiver.graphics: ReceiverGraphics#: Get the 2D Graphics properties for the receiver.

property Receiver.graphics_3d: ReceiverGraphics3D#: Get the 3D Graphics properties for the receiver.

property Receiver.laser_environment: ObjectLaserEnvironment#: Get the object laser environment settings.

property Receiver.model_component_linking: IComponentLinkEmbedControl#: Get the link/embed controller for managing the receiver model component.

property Receiver.refraction: SensorRefractionType#: Refraction method, a member of the SensorRefractionType enumeration.

property Receiver.refraction_model: IRefractionModelBase#: Get a refraction model.

property Receiver.refraction_supported_types: list#: Return an array of valid choices.

property Receiver.rf_environment: ObjectRFEnvironment#: Get the object RF environment settings.

property Receiver.use_refraction_in_access: bool#: Flag controls whether refraction is applied when computing relative position in Access.

Method detail#

Receiver.is_refraction_type_supported(self, model: SensorRefractionType) → bool#

Get a value indicating whether the specified type can be used.

Parameters:: model : SensorRefractionType
Returns:: bool