SemResults

Provides methods to fetch and read the Sem measurement results.

class nirfmxwcdma.sem_results.SemResults(signal_obj)[source]

Bases: object

Provides methods to fetch and read the Sem measurement results.

fetch_carrier_measurement(selector_string, timeout)[source]

Fetches the absolute integrated power and the relative integrated power of the carrier for the SEM measurement. The relative power is relative to the total carrier power.

Use “carrier<n>” as the selector string to read results from this method.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name, and carrier number.

Example:

”carrier0”

”result::r1/carrier0”

You can use the build_carrier_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):: This parameter returns the carrier power. The carrier power is the integrated power of the RRC-filtered signal. The RRC filter uses a bandwidth of 3.84 MHz with a roll-off factor of 0.22. The carrier is centered at a frequency determined by the CENTER_FREQUENCY and CARRIER_FREQUENCY attributes. This value is expressed in dBm.
relative_integrated_power (float):: This parameter returns the carrier power relative to the total carrier power attribute. This value is expressed in dB.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, error_code)

fetch_carrier_measurement_array(selector_string, timeout)[source]

Fetches an array of absolute integrated powers and an array of the relative integrated powers of the carriers for the SEM measurement. The relative powers are relative to the total carrier power.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):: This parameter returns an array of carrier power values relative to the total carrier power of all enabled carriers. This value is expressed in dB.
relative_integrated_power (float):: This parameter returns an array of carrier power values relative to the total carrier power of all enabled carriers. This value is expressed in dB.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, error_code)

fetch_lower_offset_margin(selector_string, timeout)[source]

Fetches the measurement status, margin, frequency at the margin, and the absolute and relative powers at the margin frequency for lower offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Use “offset<n>” as the selector string to read results from this method.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name, and offset number.

Example:

”offset0”

”result::r1/offset0”

You can use the build_offset_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

measurement_status (enums.SemLowerOffsetMeasurementStatus):

This parameter indicates the measurement status based on the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.

margin (float):

This parameter returns the margin of the lower offset segment. This value is expressed in dB.

In a single carrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the lower offset segment is measured. The maximum of the relative spectrum trace with reference to the standard-defined relative mask limit in the lower offset segment is also measured. The higher value is the margin.

In a multicarrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the lower offset segment is the margin.

margin_frequency (float):

This parameter returns the frequency at which the margin occurred in the lower, or negative, offset segment. This value is expressed in Hz.

margin_absolute_power (float):

This parameter returns the power at which the margin occurred in the lower, or negative, offset segment.

This value is expressed in dBm.

margin_relative_power (float):

This parameter returns the power at which the margin occurred in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (measurement_status, margin, margin_frequency, margin_absolute_power, margin_relative_power, error_code)

fetch_lower_offset_margin_array(selector_string, timeout)[source]

Fetches an array of measurement status values, an array of margins, an array of frequencies at the margins, an array of the absolute powers, and an array of the relative powers at the margin frequencies for lower offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

measurement_status (enums.SemLowerOffsetMeasurementStatus):

This parameter indicates an array of measurement status values based on the values of the SEM Results Lower Offset Margin attribute corresponding to each lower offset segment.

margin (float):

This parameter returns an array of margins of the lower offset segments. This value is expressed in dB.

In a single carrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the lower offset segment is measured. The maximum of the relative spectrum trace with reference to the standard-defined relative mask limit, in the lower offset segment is also measured. The higher value is the margin.

In a multicarrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the lower offset segment is the margin.

margin_frequency (float):

This parameter returns an array of frequencies at which the margins occurred in the lower, or negative, offset segments This value is expressed in Hz.

margin_absolute_power (float):

This parameter returns an array of powers at which the margins occurred in the lower, or negative, offset segment.

This value is expressed in dBm.

margin_relative_power (float):

This parameter returns an array of powers at which the margins occurred in the lower, or negative, offset segments relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (measurement_status, margin, margin_frequency, margin_absolute_power, margin_relative_power, error_code)

fetch_lower_offset_power(selector_string, timeout)[source]

Fetches the integrated absolute and relative powers, absolute and relative peak powers, and the frequency at the absolute peak power of the lower offset segment for the SEM measurement. All relative powers are relative to the total carrier power.

Use “offset<n>” as the selector string to read results from this method.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name, and offset number.

Example:

”offset0”

”result::r1/offset0”

You can use the build_offset_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):

This parameter returns the power measured in the lower, or negative, offset segment. This value is expressed in dBm.

relative_integrated_power (float):

This parameter returns the power measured in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

absolute_peak_power (float):

This parameter returns the peak power measured in the lower, or negative, offset segment. This value is expressed in dBm.

peak_frequency (float):

This parameter returns the frequency corresponding to the lower offset segment peak power. This value is expressed in Hz.

relative_peak_power (float):

This parameter returns the peak power measured in the lower, or negative, offset segment relative to the SEM Results Total Carrier Pwr attribute. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, absolute_peak_power, peak_frequency, relative_peak_power, error_code)

fetch_lower_offset_power_array(selector_string, timeout)[source]

Fetches an array of the absolute integrated powers, the relative integrated powers, the absolute peak powers, the relative peak powers, and frequencies at absolute peak powers of lower offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):: This parameter returns an array of the powers measured in the lower, or negative, offset segments. This value is expressed in dBm.
relative_integrated_power (float):: This parameter returns an array of powers measured in the lower, or negative, offset segments relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.
absolute_peak_power (float):: This parameter returns an array of peak power values measured in the lower, or negative, offset segments. This value is expressed in dBm.
peak_frequency (float):: This parameter returns an array of frequencies corresponding to the lower offset segment peak power values. This value is expressed in Hz.
relative_peak_power (float):: This parameter returns an array of peak power values measured in the lower, or negative, offset segments relative to the SEM Results Total Carrier Pwr attribute. This value is expressed in dB.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, absolute_peak_power, peak_frequency, relative_peak_power, error_code)

fetch_measurement_status(selector_string, timeout)[source]

Fetches the overall SEM measurement status based on the measurement limits and failure criteria for each offset segment, as defined in sections 5.9 , 5.9A, 5.9B, 5.9C, and 5.9D of the 3GPP TS 34.121-1 specification, version 11.5.0, release 11.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

measurement_status (enums.SemMeasurementStatus):

This parameter indicates the overall SEM measurement status based on the SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS and the SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS attributes.

Name (Value)	Description
Fail (0)	The measurement status of at least one offset segment has failed.
Pass (1)	The measurement status of all offset segments have passed.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (measurement_status, error_code)

fetch_spectrum(selector_string, timeout, spectrum, relative_mask, absolute_mask)[source]

Fetches the spectrum used for the SEM measurement.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.
spectrum (numpy.float32) – This parameter returns an array of averaged powers measured at each frequency bin. The value is expressed in dBm.
relative_mask (numpy.float32) – This parameter returns an array of averaged powers measured at each frequency bin. The value is expressed in dBm.
absolute_mask (numpy.float32) – This parameter returns an array of averaged powers measured at each frequency bin. The value is expressed in dBm.

Returns:

x0 (float):: This parameter returns the start frequency. This value is expressed in Hz.
dx (float):: This parameter returns the frequency bin spacing. This value is expressed in Hz.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_total_carrier_power(selector_string, timeout)[source]

Fetches the total carrier power for the SEM measurement.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

total_carrier_power (float):: This parameter returns the sum of all active carrier powers, where each carrier power corresponds to the value of the SEM_RESULTS_CARRIER_ABSOLUTE_INTEGRATED_POWER attribute. This value is expressed in dBm. For a single-carrier measurement, total carrier power is the same as carrier absolute power.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (total_carrier_power, error_code)

fetch_upper_offset_margin(selector_string, timeout)[source]

Fetches the measurement status, margin, frequency at the margin, and the absolute and relative powers at the margin frequency for upper offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Use “offset<n>” as the selector string to read results from this method.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name, and offset number.

Example:

”offset0”

”result::r1/offset0”

You can use the build_offset_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

measurement_status (enums.SemUpperOffsetMeasurementStatus):

This parameter indicates the measurement status based on the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute.

margin (float):

This parameter returns the margin of the upper offset segment.

In a single carrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the upper offset segment is measured. The maximum of the relative spectrum trace with reference to the standard-defined relative mask limit in the upper offset segment is also measured. The higher value is the margin.

In a multicarrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the upper offset segment is the margin.

This value is expressed in dB.

margin_frequency (float):

This parameter returns the frequency at which the margin occurred in the upper, or positive, segment. This value is expressed in Hz.

margin_absolute_power (float):

This parameter returns the power at which the margin occurred in the upper, or positive, offset segment

This value is expressed in dBm.

margin_relative_power (float):

This parameter returns the power at which the margin occurred in the upper, or positive, offset segment relative to the SEM Results Total Carrier Pwr attribute.

This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (measurement_status, margin, margin_frequency, margin_absolute_power, margin_relative_power, error_code)

fetch_upper_offset_margin_array(selector_string, timeout)[source]

Fetches an array of measurement status values, an array of margin values, an array of frequencies at the margins, an array of the absolute power values, and an array of the relative power values at the margin frequencies for upper offset segments for the SEM measurement. The relative power is relative to the total carrier power.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

measurement_status (enums.SemUpperOffsetMeasurementStatus):

This parameter returns an array of measurement status values based on the values of the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute corresponding to each upper offset segment.

margin (float):

This parameter returns an array of margins of the upper offset segments.

In a single carrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the upper offset segment is measured. The maximum of the relative spectrum trace with reference to the standard-defined relative mask limit, in the upper offset segment, is also measured. The higher value is the margin.

In a multicarrier SEM, the maximum of the absolute spectrum trace with reference to the standard-defined absolute mask limit in the upper offset segment is the margin.

This value is expressed in dB.

margin_frequency (float):

This parameter returns an array of frequencies corresponding to the SEM Results Upper Offset Margin attribute. This value is expressed in Hz.

margin_absolute_power (float):

This parameter returns an array of powers at the frequency corresponding to the SEM Results Upper Offset Margin attribute. This value is expressed in dBm.

margin_relative_power (float):

This parameter returns an array of powers at the frequency corresponding to the SEM Results Upper Offset Margin attribute, relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (measurement_status, margin, margin_frequency, margin_absolute_power, margin_relative_power, error_code)

fetch_upper_offset_power(selector_string, timeout)[source]

Fetches the integrated absolute and relative powers, absolute and relative peak powers, and the frequency at the absolute peak power of the upper offset segment for the SEM measurement. The relative power is relative to the total carrier power.

Use “offset<n>” as the selector string to read results from this method.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name, and offset number.

Example:

”offset0”

”result::r1/offset0”

You can use the build_offset_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):: This parameter returns the power measured in the upper, or positive, offset segment. This value is expressed in dBm.
relative_integrated_power (float):: This parameter returns the power measured in the upper, or positive, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.
absolute_peak_power (float):: This parameter returns an array of peak power values measured in the lower, or negative, offset segments This value is expressed in dBm.
peak_frequency (float):: This parameter returns the frequency corresponding to the upper offset segment peak power. This value is expressed in Hz.
relative_peak_power (float):: This parameter returns the peak power measured in the upper, or positive, offset segment relative to the SEM Results Total Carrier Pwr attribute. This value is expressed in dB.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, absolute_peak_power, peak_frequency, relative_peak_power, error_code)

fetch_upper_offset_power_array(selector_string, timeout)[source]

Returns an array of the absolute integrated powers and an array of the relative integrated powers, an array of the absolute peak powers and an array of the relative peak powers, and an array of the frequencies corresponding to peak absolute powers for upper offset segments for the SEM measurement. All relative powers are relative to the total carrier power.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of result name.

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the time for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

absolute_integrated_power (float):

This parameter returns an array of the powers measured in the upper, or positive, offset segments. This value is expressed in dBm.

relative_integrated_power (float):

This parameter returns an array of powers measured in the upper, or positive, offset segments relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.

absolute_peak_power (float):

This parameter returns an array of peak power values measured in the upper, or positive, offset segments. This value is expressed in dBm.

peak_frequency (float):

This parameter returns an array of frequencies at which the peak power is observed in the upper, or positive, offset segments. This value is expressed in Hz.

relative_peak_power (float):

This parameter returns an array of peak power values measured in the upper, or positive, offset segments relative to the SEM Results Total Carrier Pwr attribute.

This value is expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (absolute_integrated_power, relative_integrated_power, absolute_peak_power, peak_frequency, relative_peak_power, error_code)

get_carrier_absolute_integrated_power(selector_string)[source]

Gets the carrier power.

This value is expressed in dBm.

The carrier power is the integrated power of the RRC-filtered signal. The RRC filter uses a bandwidth of 3.84 MHz with a roll-off factor of 0.22. The carrier is centered at a frequency determined by the value of the CENTER_FREQUENCY and the CARRIER_FREQUENCY attributes.

Use “carrier<k>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the carrier power.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_carrier_absolute_peak_power(selector_string)[source]

Gets the peak power in the carrier channel.

This value is expressed in dBm.

Use “carrier<k>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the peak power in the carrier channel.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_carrier_peak_frequency(selector_string)[source]

Gets the frequency at which the peak power is observed in the carrier channel.

This value is expressed in Hz.

Use “carrier<k>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the frequency at which the peak power is observed in the carrier channel.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_carrier_relative_integrated_power(selector_string)[source]

Gets the carrier power relative to the SEM_RESULTS_TOTAL_CARRIER_POWER.

This value is expressed in dB.

Use “carrier<k>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the carrier power relative to the SEM_RESULTS_TOTAL_CARRIER_POWER.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_absolute_integrated_power(selector_string)[source]

Gets the power measured in the lower, or negative, offset segment.

This value is expressed in dBm.

Use “offset<n>” as the selector string to configure or read this attribute.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power measured in the lower, or negative, offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_absolute_peak_power(selector_string)[source]

Gets the peak power measured in the lower, or negative, offset segment.

This value is expressed in dBm.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the peak power measured in the lower, or negative, offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_margin(selector_string)[source]

Gets the margin of the lower offset segment.

This value is expressed in dB.

In a single carrier SEM, the maximum value of the absolute spectrum trace with reference to the standard-defined absolute mask limit of the lower offset segment is measured. The maximum relative spectrum trace with reference to the standard-defined relative mask limit of the lower offset segment is also measured. The minimum of these two values is the margin.

In a multicarrier SEM, the maximum value of the absolute spectrum trace with reference to the standard-defined absolute mask limit of the lower offset segment is the margin.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the margin of the lower offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_margin_absolute_power(selector_string)[source]

Gets the power at the frequency corresponding to the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.

This value is expressed in dBm.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power at the frequency corresponding to the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_margin_frequency(selector_string)[source]

Gets the frequency corresponding to the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.

This value is expressed in Hz.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the frequency corresponding to the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_margin_relative_power(selector_string)[source]

Gets the power at the frequency corresponding to the value of the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute and relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power at the frequency corresponding to the value of the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute and relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_measurement_status(selector_string)[source]

Indicates the measurement status based on the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.

Use “offset<n>” as the selector string to read this result.

Name (Value)	Description
Fail (0)	Indicates that the value of the SEM Results Lower Offset Margin attribute is positive.
Pass (1)	Indicates that the value of the SEM Results Lower Offset Margin attribute is zero or negative.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.SemLowerOffsetMeasurementStatus):: Indicates the measurement status based on the SEM_RESULTS_LOWER_OFFSET_MARGIN attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_peak_frequency(selector_string)[source]

Gets the frequency at which the peak power is observed in the lower offset segment.

This value is expressed in Hz.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the frequency at which the peak power is observed in the lower offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_relative_integrated_power(selector_string)[source]

Gets the power measured in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power measured in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_lower_offset_relative_peak_power(selector_string)[source]

Gets the peak power measured in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the peak power measured in the lower, or negative, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_measurement_status(selector_string)[source]

Indicates the overall SEM measurement status, based on the value of the SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS and the SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS attributes.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Name (Value)	Description
Fail (0)	The measurement status of at least one offset segment has failed.
Pass (1)	The measurement status of all offset segments have passed.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.SemMeasurementStatus):: Indicates the overall SEM measurement status, based on the value of the SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS and the SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS attributes.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_total_carrier_power(selector_string)[source]

Gets the sum of all active carrier powers, where each carrier power corresponds to the value of the SEM_RESULTS_CARRIER_ABSOLUTE_INTEGRATED_POWER attribute. For a single-carrier measurement, total carrier power is the same as carrier absolute power.

This value is expressed in dBm.

You do not need to use a selector string to read this result for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals and named results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the sum of all active carrier powers, where each carrier power corresponds to the value of the SEM_RESULTS_CARRIER_ABSOLUTE_INTEGRATED_POWER attribute. For a single-carrier measurement, total carrier power is the same as carrier absolute power.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_absolute_integrated_power(selector_string)[source]

Gets the power measured in the upper, or positive, offset segment.

This value is expressed in dBm.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power measured in the upper, or positive, offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_absolute_peak_power(selector_string)[source]

Gets the peak power measured in the upper, or positive, offset segment.

This value is expressed in dBm.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the peak power measured in the upper, or positive, offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_margin(selector_string)[source]

Gets the margin of the upper offset segment.

This value is expressed in dB.

In a single-carrier SEM, the maximum value of the absolute spectrum trace with reference to the standard-defined absolute mask limit of the upper offset segment is measured. The maximum relative spectrum trace with reference to the standard-defined relative mask limit of the upper offset segment is also measured. The minimum of these two values is the margin.

In a multicarrier SEM, the maximum value of the absolute spectrum trace with reference to the standard-defined absolute mask limit of the upper offset segment is the margin.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the margin of the upper offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_margin_absolute_power(selector_string)[source]

Gets the power at the frequency corresponding to the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute.

This value is expressed in dBm.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power at the frequency corresponding to the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_margin_frequency(selector_string)[source]

Gets the frequency corresponding to the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute. This value is expressed in Hz.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the frequency corresponding to the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute. This value is expressed in Hz.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_margin_relative_power(selector_string)[source]

Gets the power at the frequency corresponding to the value of the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute relative to the value of the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power at the frequency corresponding to the value of the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute relative to the value of the SEM_RESULTS_TOTAL_CARRIER_POWER attribute. This value is expressed in dB.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_measurement_status(selector_string)[source]

Indicates the measurement status based on the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute.

Use “offset<n>” as the selector string to read this result.

Name (Value)	Description
Fail (0)	The value of the SEM Results Upper Offset Margin attribute is positive.
Pass (1)	The value of the SEM Results Upper Offset Margin attribute is zero or negative.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.SemUpperOffsetMeasurementStatus):: Indicates the measurement status based on the SEM_RESULTS_UPPER_OFFSET_MARGIN attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_peak_frequency(selector_string)[source]

Gets the frequency at which the peak power is observed in the upper offset segment.

This value is expressed in Hz.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the frequency at which the peak power is observed in the upper offset segment.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_relative_integrated_power(selector_string)[source]

Gets the power measured in the upper, or positive, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the power measured in the upper, or positive, offset segment relative to the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_upper_offset_relative_peak_power(selector_string)[source]

Gets the peak power measured in the upper, or positive, offset segment relative to the value of the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.

This value is expressed in dB.

Use “offset<n>” as the selector string to read this result.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Returns the peak power measured in the upper, or positive, offset segment relative to the value of the SEM_RESULTS_TOTAL_CARRIER_POWER attribute.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)