docs: def resistor_max_actuation_readings(control_board, frequencies,
                                      oscope_reading_func):
      '''
      For each resistor in the high-voltage feedback resistor bank, read the
      board measured voltage and the oscilloscope measured voltage for an
      actuation voltage that nearly saturates the feedback resistor.
  
      By searching for an actuation voltage near saturation, the signal-to-noise
      ratio is minimized.
      '''
      # Set board amplifier gain to 1.
      # __NB__ This is likely _far_ lower than the actual gain _(which may be a
      # factor of several hundred)_..
      control_board.set_waveform_voltage(0)
      control_board.auto_adjust_amplifier_gain = False
      control_board.amplifier_gain = 1.
  
      # Set waveform voltage to a low value and obtain the corresponding
      # oscilloscope reading to calculate an approximate gain of the amplifier.
      target_voltage = 0.1
      control_board.set_waveform_voltage(target_voltage)
      oscope_rms = oscope_reading_func()
      estimated_amplifier_gain = oscope_rms / target_voltage
  
      # Based on the maximum amplified RMS voltage, define a set of actuation
      # voltages to search when performing calibration.
      max_post_gain_V = 0.8 * control_board.max_waveform_voltage
      max_actuation_V = max_post_gain_V / estimated_amplifier_gain
      actuation_steps = np.linspace(0.005, max_actuation_V, num=50)
  
      resistor_count = len(control_board.a0_series_resistance)
  
      # Define frequency/resistor index pairs to take measurements at.
      conditions = pd.DataFrame([[r, f] for r in range(resistor_count - 1, -1, -1)
                                 for f in frequencies],
                                columns=['resistor index', 'frequency'])
  
      # Define function to process each frequency/resistor index pair.
      def max_actuation_reading(x):
          '''
          Measure maximum board RMS voltage using specified feedback resistor, at
          the specified frequency.
  
          Request corresponding oscilloscope RMS voltage reading.
          '''
          r = x['resistor index'].values[0]
          f = x['frequency'].values[0]
          control_board.set_waveform_frequency(f)
  
          actuation_index, data = find_good(control_board, actuation_steps, r, 0,
                                            len(actuation_steps) - 1)
          board_measured_rms = data.loc[data['divider resistor index'] >= 0,
                                        'board measured V'].mean()
          oscope_rms = oscope_reading_func()
          print 'R=%s, f=%s' % (r, f)
          return pd.DataFrame([[r, f, actuation_index, board_measured_rms,
                                oscope_rms]],
                              columns=['resistor index', 'frequency',
                                       'actuation index', 'board measured V',
                                       'oscope measured V'])
  
      # Return board-measured RMS voltage and oscilloscope-measured RMS voltage
      # for each frequency/feedback resistor pair.
      return (conditions.groupby(['resistor index', 'frequency'])
              .apply(max_actuation_reading).reset_index(drop=True))