# Agilent 8257D Signal Generator

class `pymeasure.instruments.agilent.``Agilent8257D`(adapter, delay=0.02, **kwargs)

  Bases: `pymeasure.instruments.instrument.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

  `amplitude_depth`

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

  `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’.

  `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 precentage
    - shape – A string that describes the shape for the internal oscillator

  `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_modulation`()

    Disables the signal modulation.

  `disable_pulse_modulation`()

    Disables pulse modulation of the output signal.

  `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_pulse_modulation`()

    Enables pulse modulation of the output signal.

  `frequency`

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

  `has_amplitude_modulation`

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

  `has_modulation`

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

  `has_pulse_modulation`

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

  `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.

  `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’.

  `is_enabled`

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

  `power`

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

  `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.

  `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’.

  `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.

  `start_frequency`

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

  `start_power`

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

  `start_step_sweep`()

    Starts a step sweep.

  `step_points`

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

  `stop_frequency`

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

  `stop_step_sweep`()

    Stops a step sweep.