# Agilent 8257D Signal Generator

class pymeasure.instruments.agilent.Agilent8257D(adapter, name='Agilent 8257D RF Signal Generator', **kwargs)

  Bases: `SCPIUnknownMixin`, `Instrument`

  Represents the Agilent 8257D Signal Generator and provides a high-level interface for interacting with the instrument.

      generator = Agilent8257D("GPIB::1")

      generator.power = 0                     # Sets the output power to 0 dBm
      generator.frequency = 5                 # Sets the output frequency to 5 GHz
      generator.enable()                      # Enables the output

  property amplitude_depth

    A floating point property that controls the amplitude modulation in percent, which can take values from 0 to 100 %.

  property amplitude_source

    A string property that controls the source of the amplitude modulation signal, which can take the values: ‘internal’, ‘internal 2’, ‘external’, and ‘external 2’.

  property center_frequency

    A floating point property that represents the center frequency in Hz. This property can be set.

  config_amplitude_modulation(frequency=1000.0, depth=100.0, shape='sine')

    Configures the amplitude modulation of the output signal.

    Parameters:

      - frequency – A modulation frequency for the internal oscillator

      - depth – A linear depth percentage

      - shape – A string that describes the shape for the internal oscillator

  config_low_freq_out(source='internal', amplitude=3)

    Configures the low-frequency output signal.

    Parameters:

      - source – The source for the low-frequency output signal.

      - amplitude – Amplitude of the low-frequency output

  config_pulse_modulation(frequency=1000.0, input='square')

    Configures the pulse modulation of the output signal.

    Parameters:

      - frequency – A pulse rate frequency in Hertz

      - input – A string that describes the internal pulse input

  config_step_sweep()

    Configures a step sweep through frequency

  disable()

    Disables the output of the signal.

  disable_amplitude_modulation()

    Disables amplitude modulation of the output signal.

  disable_low_freq_out()

    Disables low frequency output

  disable_modulation()

    Disables the signal modulation.

  disable_pulse_modulation()

    Disables pulse modulation of the output signal.

  property dwell_time

    A floating point property that represents the settling time in seconds at the current frequency or power setting. This property can be set.

  enable()

    Enables the output of the signal.

  enable_amplitude_modulation()

    Enables amplitude modulation of the output signal.

  enable_low_freq_out()

    Enables low frequency output

  enable_pulse_modulation()

    Enables pulse modulation of the output signal.

  property frequency

    A floating point property that represents the output frequency in Hz. This property can be set.

  property has_amplitude_modulation

    Reads a boolean value that is True if the amplitude modulation is enabled.

  property has_modulation

    Reads a boolean value that is True if the modulation is enabled.

  property has_pulse_modulation

    Reads a boolean value that is True if the pulse modulation is enabled.

  property internal_frequency

    A floating point property that controls the frequency of the internal oscillator in Hertz, which can take values from 0.5 Hz to 1 MHz.

  property internal_shape

    A string property that controls the shape of the internal oscillations, which can take the values: ‘sine’, ‘triangle’, ‘square’, ‘ramp’, ‘noise’, ‘dual-sine’, and ‘swept-sine’.

  property is_enabled

    Reads a boolean value that is True if the output is on.

  property low_freq_out_amplitude

    A floating point property that controls the peak voltage (amplitude) of the low frequency output in volts, which can take values from 0-3.5V

  property low_freq_out_source

    A string property which controls the source of the low frequency output, which can take the values ‘internal [2]’ for the internal source, or ‘function [2]’ for an internal function generator which can be configured.

  property power

    A floating point property that represents the output power in dBm. This property can be set.

  property pulse_frequency

    A floating point property that controls the pulse rate frequency in Hertz, which can take values from 0.1 Hz to 10 MHz.

  property pulse_input

    A string property that controls the internally generated modulation input for the pulse modulation, which can take the values: ‘square’, ‘free-run’, ‘triggered’, ‘doublet’, and ‘gated’.

  property pulse_source

    A string property that controls the source of the pulse modulation signal, which can take the values: ‘internal’, ‘external’, and ‘scalar’.

  shutdown()

    Shuts down the instrument by disabling any modulation and the output signal.

  property start_frequency

    A floating point property that represents the start frequency in Hz. This property can be set.

  property start_power

    A floating point property that represents the start power in dBm. This property can be set.

  start_step_sweep()

    Starts a step sweep.

  property step_points

    An integer number of points in a step sweep. This property can be set.

  property stop_frequency

    A floating point property that represents the stop frequency in Hz. This property can be set.

  property stop_power

    A floating point property that represents the stop power in dBm. This property can be set.

  stop_step_sweep()

    Stops a step sweep.