Newport Power Meters

Driver module for Newport power meters. Supports:

  • 1830-C
class instrumental.drivers.powermeters.newport.Newport_1830_C(inst)

A Newport 1830-C power meter

Methods

attenuator_enabled() Whether the attenuator is enabled
disable_attenuator() Disable the power meter attenuator
disable_auto_range() Disable auto-range
disable_hold() Disable hold mode
disable_zero() Disable the zero function
enable_attenuator([enabled]) Enable the power meter attenuator
enable_auto_range() Enable auto-range
enable_hold([enable]) Enable hold mode
enable_zero([enable]) Enable the zero function
get_filter() Get the current setting for the averaging filter
get_power() Get the current power measurement
get_range() Return the current range setting as an int
get_status_byte() Query the status byte register and return it as an int
get_units() Get the units used for displaying power measurements
get_wavelength() Get the input wavelength setting
hold_enabled() Whether hold mode is enabled
is_measurement_valid() Whether the current measurement is valid
set_medium_filter() Set the averaging filter to medium mode
set_no_filter() Set the averaging filter to fast mode, i.e.
set_range(range_num) Set the range for power measurements
set_slow_filter() Set the averaging filter to slow mode
set_units(units) Set the units for displaying power measurements
set_wavelength(wavelength) Set the input signal wavelength setting
store_reference() Store the current power input as a reference
zero_enabled() Whether the zero function is enabled
__init__(inst)
attenuator_enabled()

Whether the attenuator is enabled

Returns:

enabled : bool

whether the attenuator is enabled

disable_attenuator()

Disable the power meter attenuator

disable_auto_range()

Disable auto-range

Leaves the signal range at its current position.

disable_hold()

Disable hold mode

disable_zero()

Disable the zero function

enable_attenuator(enabled=True)

Enable the power meter attenuator

enable_auto_range()

Enable auto-range

enable_hold(enable=True)

Enable hold mode

enable_zero(enable=True)

Enable the zero function

When enabled, the next power reading is stored as a background value and is subtracted off of all subsequent power readings.

get_filter()

Get the current setting for the averaging filter

Returns:

SLOW_FILTER, MEDIUM_FILTER, NO_FILTER

the current averaging filter

get_power()

Get the current power measurement

Returns:

power : Quantity

Power in units of watts, regardless of the power meter’s current ‘units’ setting.

get_range()

Return the current range setting as an int

1 corresponds to the lowest range, while 8 is the highest range (least amplifier gain).

Note that this does not query the status of auto-range.

Returns:

range : int

the current range setting. Possible values are from 1-8.

get_status_byte()

Query the status byte register and return it as an int

get_units()

Get the units used for displaying power measurements

Returns:

units : str

‘watts’, ‘db’, ‘dbm’, or ‘rel’

get_wavelength()

Get the input wavelength setting

hold_enabled()

Whether hold mode is enabled

Returns:

enabled : bool

True if in hold mode, False if in run mode

is_measurement_valid()

Whether the current measurement is valid

The measurement is considered invalid if the power meter is saturated, over-range or busy.

set_medium_filter()

Set the averaging filter to medium mode

The medium filter uses a 4-measurement running average.

set_no_filter()

Set the averaging filter to fast mode, i.e. no averaging

set_range(range_num)

Set the range for power measurements

range_num = 0 for auto-range range_num = 1 to 8 for manual signal range (1 is lowest, and 8 is highest)

Parameters:

n : int

Sets the signal range for the input signal.

set_slow_filter()

Set the averaging filter to slow mode

The slow filter uses a 16-measurement running average.

set_units(units)

Set the units for displaying power measurements

The different unit modes are watts, dB, dBm, and REL. Each displays the power in a different way.

‘watts’ displays absolute power in watts

‘dBm’ displays power in dBm (i.e. dBm = 10 * log(P / 1mW))

‘dB’ displays power in dB relative to the current reference power (i.e. dB = 10 * log(P / Pref). At power-up, the reference power is set to 1mW.

‘REL’ displays power relative to the current reference power (i.e. REL = P / Pref)

The current reference power can be set using `store_reference`().

Parameters:

units : ‘watts’, ‘dBm’, ‘dB’, or ‘REL’

Case-insensitive str indicating which units mode to enter.

set_wavelength(wavelength)

Set the input signal wavelength setting

Parameters:

wavelength : Quantity

wavelength of the input signal, in units of [length]

store_reference()

Store the current power input as a reference

Sets the current power measurement as the reference power for future dB or relative measurements.

zero_enabled()

Whether the zero function is enabled

MEDIUM_FILTER = 2
NO_FILTER = 3
SLOW_FILTER = 1