function dipole_sample_test ( )

%*****************************************************************************80
%
%% DIPOLE_SAMPLE_TEST() tests DIPOLE_SAMPLE().
%
%  Licensing:
%
%    This code is distributed under the MIT license.
%
%  Modified:
%
%    15 April 2009
%
%  Author:
%
%    John Burkardt
%
  nsample = 1000;
  ntest = 3;

  fprintf ( 1, '\n' );
  fprintf ( 1, 'DIPOLE_SAMPLE_TEST():\n' );
  fprintf ( 1, '  DIPOLE_SAMPLE() samples the Dipole distribution.\n' );

  atest(1:3) = [ 0.0, pi / 4.0, pi / 2.0 ];
  btest(1:3) = [ 1.0, 0.5, 0.0 ];

  for itest = 1 : ntest

    a = atest(itest);
    b = btest(itest);

    check = dipole_check ( a, b );

    if ( ~check );
      fprintf ( 1, '\n' );
      fprintf ( 1, 'DIPOLE_SAMPLE_TEST - Fatal error!\n' );
      fprintf ( 1, '  The parameters are not legal.\n' );
      return
    end

    fprintf ( 1, '\n' );
    fprintf ( 1, '  PDF parameter A = %14g\n', a );
    fprintf ( 1, '  PDF parameter B = %14g\n', b );
  
    for i = 1 : nsample
      x(i) = dipole_sample ( a, b );
    end

    xmean = mean ( x );
    xvar = var ( x );
    xmax = max ( x );
    xmin = min ( x );

    fprintf ( 1, '\n' );
    fprintf ( 1, '  Sample size =     %6d\n', nsample );
    fprintf ( 1, '  Sample mean =     %14g\n', xmean );
    fprintf ( 1, '  Sample variance = %14g\n', xvar );
    fprintf ( 1, '  Sample maximum =  %14g\n', xmax );
    fprintf ( 1, '  Sample minimum =  %14g\n', xmin );

  end

  return
end
